diff --git a/README.md b/README.md index 99e996a..1dc812c 100644 --- a/README.md +++ b/README.md @@ -6,17 +6,15 @@ | 项目 | 当前状态 | | --- | --- | -| Git 检查点 | N04 已建立 T7 暂停检查点 `73afd87`；T8 完成后形成最终检查点 | -| 数据库迁移 | Flyway V1–V39；N04 新增 V38–V39 | -| API 契约 | 135 paths / 172 operations | -| 自动化测试 | 1492 个执行：1481 通过、2 失败、9 错误；失败均在既有 CareerProgress/JobReviewDimension/LocalResumeStorage 测试，与 N04 文档变更无关 | -| 已验收范围 | V27–V34；V33 已完成真实 MySQL/Docker 黑盒验收 | -| N04 入职清单与公司知识介绍 | 实现完成，待真实 MySQL/Docker 黑盒验收 | -| N05 薪资计算器与历史记录 | 实现完成，专项测试 24/24，一次性 Docker MySQL 黑盒通过 | +| Git 检查点 | N07 消息撤回，`277b3c0`（已合并到本地 `master`） | +| 数据库迁移 | Flyway V1–V41；N02/V43 未新增迁移 | +| API 契约 | 173 paths / 211 operations | +| 自动化测试 | 1601 个通过，0 失败，0 错误，0 跳过（以 `mvn clean verify` 为准） | +| 已交付范围 | V39 岗位推荐、V40 企业评价回复、V41 企业人才发现、V42 企业人才邀约、V43 公平性监测、N02/V44 评分规则解释、N07 消息撤回 | | 账号注销冷静期 | 30 天 | | 本地服务端口 | `8080` | -N04 入职清单与公司知识介绍、N05 薪资计算器与历史记录均已完成代码、专项测试、OpenAPI 和联调文档；N05 专项 24/24 通过，且已完成一次性 Docker MySQL 黑盒验收并销毁容器。全量 `mvn clean verify` 仍受既有非 N05 测试失败阻塞。 +各版本的真实 MySQL/Docker 验收状态以 `docs/` 下对应验收报告为准；未完成独立验收的功能不得视为生产冻结。 ## 仓库结构 @@ -125,8 +123,12 @@ python .\docs\verify_openapi.py - [OpenAPI 契约](docs/openapi-rc.json) - [前端联调说明](docs/frontend-integration.md) - [后端开发路线图](docs/backend-development-roadmap.md) -- [入职清单与公司知识介绍](docs/onboarding-api.md) -- [薪资计算器 API](docs/salary-calculator-api.md) +- [岗位推荐](docs/v39-job-recommendation-design.md) +- [企业人才发现](docs/enterprise-talent-discovery-api.md) +- [企业人才邀约](docs/enterprise-talent-invitation-api.md) +- [候选评分与规则解释](docs/candidate-scoring-api.md) +- [评分公平性监测](docs/candidate-scoring-fairness-api.md) +- [消息撤回与会话一致性](docs/messaging-api.md) - [统一求职进度接口](docs/career-progress-api.md) - [同岗位竞争力排名](docs/competition-ranking-api.md) - [举报与屏蔽](docs/report-block-api.md) @@ -174,5 +176,3 @@ python .\docs\verify_openapi.py `C:\Users\15642\Desktop\青核\collegeCli` 青核项目不属于本仓库，禁止将其源代码提交到职来仓库。 - - diff --git a/backend-infra/v35_acceptance.ps1 b/backend-infra/v35_acceptance.ps1 new file mode 100644 index 0000000..6934875 --- /dev/null +++ b/backend-infra/v35_acceptance.ps1 @@ -0,0 +1,262 @@ +# ============================================================================ +# V35 RIASEC assessment BLACK-BOX ACCEPTANCE (real MySQL/Docker) - rev2 +# Scenario isolation: each scenario uses a freshly auto-created mock student. +# No secrets printed; no business data deleted; only appends assessment rows. +# ============================================================================ +$ErrorActionPreference = 'Continue' +Import-Module ThreadJob -ErrorAction SilentlyContinue +$BASE = 'http://127.0.0.1:8080/api/v1' +$LOG = 'C:\Users\15642\Desktop\zhilai\backend-infra\app.log' +$ENV = 'C:\Users\15642\Desktop\zhilai\backend-infra\.env' +$RMQ_API = 'http://127.0.0.1:15672/api/queues/%2F' + +$kv=@{}; Get-Content $ENV | ForEach-Object{ if($_ -match '^\s*([^#][^=]*?)\s*=\s*(.*)\s*$'){ $kv[$matches[1].Trim()]=$matches[2].Trim() } } +$env:MPW=$kv['MYSQL_PASSWORD']; $RMQ_USER=$kv['RABBITMQ_USER']; $RMQ_PASS=$kv['RABBITMQ_PASS'] + +function MySQL($sql){ docker exec -e MYSQL_PWD=$env:MPW mydreamjob-mysql mysql -umydreamjob -N mydreamjob -e $sql 2>&1 } +function FirstOf($sql){ $r=(MySQL $sql | Select-Object -First 1); if($null -eq $r){return ''}; (($r -split '\s+')[0]).Trim() } +function PhoneOfRole($role){ + # ADMIN uses a separate query; do not apply the pure-COMPANY exclusion. + if($role -eq 'ADMIN'){ + FirstOf ("SELECT u.phone FROM users u JOIN user_roles ur ON ur.user_id=u.id AND ur.role='ADMIN' ORDER BY u.id LIMIT 1"); + } else { + FirstOf ("SELECT u.phone FROM users u JOIN user_roles ur ON ur.user_id=u.id AND ur.role='$role' AND u.id NOT IN (SELECT user_id FROM user_roles WHERE role IN ('STUDENT','ADMIN')) LIMIT 1"); + } +} + +$pass=0;$fail=0;$skip=0;$failures=@() +function Chk($n,$c,$d){ if($c){$script:pass++;Write-Output "PASS - $n"}else{$script:fail++;$script:failures+="$n :: $d";Write-Output "FAIL - $n | $d"} } +function ChkSkip($n,$d){ $script:skip++;Write-Output "SKIP - $n | $d" } +function Api($method,$url,$token,$body){ + $h=@{}; if($token){$h['Authorization']="Bearer $token"} + if($null -ne $body){$h['Content-Type']='application/json'} + try { $a=@{Method=$method;Uri=$url;Headers=$h;TimeoutSec=30;UseBasicParsing=$true}; if($null -ne $body){$a.Body=($body|ConvertTo-Json -Depth 8)}; $r=Invoke-WebRequest @a; $j=$null;try{$j=$r.Content|ConvertFrom-Json}catch{}; return @{status=[int]$r.StatusCode;json=$j;raw=$r.Content} } + catch { $c='';if($_.ErrorDetails -and $_.ErrorDetails.Message){$c=$_.ErrorDetails.Message};$st=if($_.Exception.Response -and $_.Exception.Response.StatusCode){[int]$_.Exception.Response.StatusCode}else{-1};$j=$null;try{$j=$c|ConvertFrom-Json}catch{};return @{status=$st;json=$j;raw=$c} } +} +function F($o,$n){ if($null -eq $o){return $null}; if($o.PSObject.Properties.Name -contains $n){return $o.$n}; return $null } +function Login($phone){ + for($i=0;$i -lt 3;$i++){ + try{ Invoke-RestMethod -Uri "$BASE/auth/sms/send?phone=$phone&purpose=login" -Method Post -TimeoutSec 15 | Out-Null }catch{} + Start-Sleep -Milliseconds 900 + $m = Get-Content $LOG -ErrorAction SilentlyContinue | Select-String -Pattern "MOCK SMS CODE: phone=$phone, purpose=login, code=([0-9]{6})" + if($m){ $code=$m[-1].Matches[0].Groups[1].Value; $b=@{phone=$phone;code=$code;purpose='login'}|ConvertTo-Json + try{ $t=(Invoke-RestMethod -Uri "$BASE/auth/login" -Method Post -ContentType 'application/json' -Body $b -TimeoutSec 15).data.accessToken; if($t -and "$t".Length -gt 50){return $t} }catch{} } + Start-Sleep -Milliseconds 600 + } + return $null +} +function RmqStat($name){ + $q=$null; try{ $q=(& curl.exe -s -u "${RMQ_USER}:${RMQ_PASS}" "$RMQ_API" 2>&1 | Out-String)|ConvertFrom-Json }catch{} + if($null -eq $q){return @{ready=-1;unacked=-1}} + $h=$q|Where-Object{$_.name -eq $name}|Select-Object -First 1 + # Missing queue is not an empty queue; return -1 so it cannot pass as ready=0. + if($null -eq $h){return @{ready=-1;unacked=-1}} + return @{ready=[long]$h.messages;unacked=[long]$h.messages_unacknowledged} +} +function NewStudent(){ $ph='188'+('{0:D8}' -f (Get-Random -Minimum 1000000 -Maximum 99999999)); $t=Login $ph; $id=FirstOf "SELECT id FROM users WHERE phone='$ph'"; return @{token=$t;phone=$ph;id=$id} } + +Write-Output "===== V35 ASSESSMENT BLACK-BOX (real MySQL) rev2 =====" + +# ---------- shared role tokens ---------- +$companyTok = Login (PhoneOfRole 'COMPANY') +$adminTok = Login (PhoneOfRole 'ADMIN') + +# ============ S1 main flow (fresh student) ============ +Write-Output '== S1 main flow ==' +$s1 = NewStudent; $tok=$s1.token +Chk 'S1 fresh student login' ($null -ne $tok) +if(-not $tok){ exit 1 } +$k = 'bb1-'+[guid]::NewGuid().ToString('N') +$c = Api 'POST' "$BASE/assessments/attempts" $tok @{typeCode='HOLLAND_RIASEC';idempotencyKey=$k} +$aid = F $c.json.data 'attemptId'; $v = F $c.json.data 'version' +Chk 'S1 create 200' ($c.status -eq 200) $c.status +Chk 'S1 totalQuestions=30' ((F $c.json.data 'totalQuestions') -eq 30) (F $c.json.data 'totalQuestions') +Chk 'S1 questions length=30' (@($c.json.data.questions).Count -eq 30) (@($c.json.data.questions).Count) +$cnt = FirstOf "SELECT COUNT(*) FROM assessment_attempt_questions WHERE attempt_id=$aid" +Chk 'S1 DB attempt_questions=30' ($cnt -eq 30) $cnt +$dimMap=@{}; foreach($d in (MySQL "SELECT q.dimension,COUNT(*) FROM assessment_attempt_questions aq JOIN assessment_questions q ON q.id=aq.question_id WHERE aq.attempt_id=$aid GROUP BY q.dimension")){ $p=($d -split '\s+'); if($p -and $p[0] -and $p[1]){$dimMap[$p[0]]=[int]$p[1]} } +Chk 'S1 DB 6 dims x5' ((@('A','C','E','I','R','S' | ForEach-Object{$dimMap[$_]-eq 5}) -contains $false) -eq $false) ($dimMap|ConvertTo-Json -Compress) +$qids=@($c.json.data.questions|ForEach-Object{$_.id}) +# mid-save 10 +$p1 = Api 'PATCH' "$BASE/assessments/attempts/$aid/answers" $tok @{version=$v;answers=(@($qids|Select-Object -First 10)|ForEach-Object{@{questionId=$_;value=4}})} +Chk 'S1 PATCH partial 200 answered=10' ($p1.status -eq 200 -and (F $p1.json.data 'answeredCount') -eq 10) "$($p1.status)/$(F $p1.json.data 'answeredCount')" +$g = Api 'GET' "$BASE/assessments/attempts/$aid" $tok +$gids=@($g.json.data.questions|ForEach-Object{$_.id}) +Chk 'S1 GET order unchanged' (($gids -join ',') -eq ($qids -join ',')) +Chk 'S1 GET restored 10' (@($g.json.data.questions|Where-Object{$null -ne $_.value}).Count -eq 10) +$nv = F $g.json.data 'version' +# 29-ish submit (only 10 answered) -> 9706 +$s29 = Api 'POST' "$BASE/assessments/attempts/$aid/submit" $tok $null +Chk 'S1 10/30 submit -> 400/9706' ($s29.status -eq 400 -and (F $s29.json 'code') -eq 9706) "$($s29.status)/$(F $s29.json 'code')" +# full 30 +$full = Api 'PATCH' "$BASE/assessments/attempts/$aid/answers" $tok @{version=$nv;answers=(@($qids)|ForEach-Object{@{questionId=$_;value=4}})} +$fv = F $full.json.data 'version' +$sub = Api 'POST' "$BASE/assessments/attempts/$aid/submit" $tok $null +Chk 'S1 submit 200 COMPLETED' ($sub.status -eq 200 -and (F $sub.json.data 'status') -eq 'COMPLETED') "$($sub.status)/$(F $sub.json.data 'status')" +Chk 'S1 result primaryCode present' ($null -ne (F $sub.json.data 'primaryCode')) (F $sub.json.data 'primaryCode') +Chk 'S1 result disclaimer' ($null -ne (F $sub.json.data 'disclaimer')) +$sub2 = Api 'POST' "$BASE/assessments/attempts/$aid/submit" $tok $null +Chk 'S1 repeat submit same result' ($sub2.status -eq 200 -and (F $sub2.json.data 'primaryCode') -eq (F $sub.json.data 'primaryCode')) "$($sub2.status)" +Chk 'S1 DB result count=1' ((FirstOf "SELECT COUNT(*) FROM assessment_results WHERE attempt_id=$aid") -eq 1) +Chk 'S1 result GET 200' ((Api 'GET' "$BASE/assessments/attempts/$aid/result" $tok).status -eq 200) +# active_key released +Chk 'S1 active_key released' (((FirstOf "SELECT COUNT(*) FROM assessment_attempts WHERE id=$aid AND active_key IS NULL") -eq 1)) +# non-owner 403 +$sOther = NewStudent +Chk 'S1 non-owner GET attempt 403/2002' ((Api 'GET' "$BASE/assessments/attempts/$aid" $sOther.token).status -eq 403) + +# ============ S2 duplicate active (fresh student) ============ +Write-Output '== S2 duplicate active ==' +$s2=NewStudent; $a1=Api 'POST' "$BASE/assessments/attempts" $s2.token @{typeCode='HOLLAND_RIASEC';idempotencyKey=('bb2a-'+[guid]::NewGuid().ToString('N'))} +Chk 'S2 first create 200' ($a1.status -eq 200) $a1.status +$dup=Api 'POST' "$BASE/assessments/attempts" $s2.token @{typeCode='HOLLAND_RIASEC';idempotencyKey=('bb2b-'+[guid]::NewGuid().ToString('N'))} +Chk 'S2 duplicate active -> 409/9708' ($dup.status -eq 409 -and (F $dup.json 'code') -eq 9708) "$($dup.status)/$(F $dup.json 'code')" +# verify only one DRAFT row in DB +Chk 'S2 DB only one active' ((FirstOf "SELECT COUNT(*) FROM assessment_attempts WHERE student_user_id=$($s2.id) AND status IN ('DRAFT','IN_PROGRESS') AND active_key IS NOT NULL") -eq 1) + +# ============ S3 idempotency replay ============ +Write-Output '== S3 idempotency replay ==' +$s3=NewStudent; $kk='bb3-' + [guid]::NewGuid().ToString('N') +$r1=Api 'POST' "$BASE/assessments/attempts" $s3.token @{typeCode='HOLLAND_RIASEC';idempotencyKey=$kk} +$r2=Api 'POST' "$BASE/assessments/attempts" $s3.token @{typeCode='HOLLAND_RIASEC';idempotencyKey=$kk} +Chk 'S3 same key same body -> same attempt' ((F $r1.json.data 'attemptId') -eq (F $r2.json.data 'attemptId')) "$(F $r1.json.data 'attemptId') vs $(F $r2.json.data 'attemptId')" + +# ============ S4 permissions ============ +Write-Output '== S4 permissions ==' +$pc = Api 'POST' "$BASE/assessments/attempts" $companyTok @{typeCode='HOLLAND_RIASEC';idempotencyKey=('bb4c-'+[guid]::NewGuid().ToString('N'))} +Chk 'S4 COMPANY create 403/2002' ($pc.status -eq 403 -and (F $pc.json 'code') -eq 2002) "$($pc.status)/$(F $pc.json 'code')" +$pn = Api 'POST' "$BASE/assessments/attempts" $null @{typeCode='HOLLAND_RIASEC';idempotencyKey=('bb4n-'+[guid]::NewGuid().ToString('N'))} +Chk 'S4 anonymous create 401' ($pn.status -eq 401) $pn.status +# INACTIVE: use a REAL inactive definition if present in DB; otherwise SKIP (never use unknown type NOPE as substitute) +$inactiveType = FirstOf "SELECT type_code FROM assessment_definitions WHERE status='INACTIVE' LIMIT 1" +if($inactiveType){ + $pi = Api 'POST' "$BASE/assessments/attempts" $tok @{typeCode=$inactiveType;idempotencyKey=('bb4i-'+[guid]::NewGuid().ToString('N'))} + Chk "S4 INACTIVE($inactiveType) create 404/9701" ($pi.status -eq 404 -and (F $pi.json 'code') -eq 9701) "$($pi.status)/$(F $pi.json 'code')" +} else { ChkSkip 'S4 INACTIVE type create 404/9701' 'no INACTIVE definition seed in DB; NOT substituting unknown type' } +# ADMIN black-box coverage: if no ADMIN account exists -> explicit SKIP (not PASS) +if($adminTok){ + $pa = Api 'POST' "$BASE/assessments/attempts" $adminTok @{typeCode='HOLLAND_RIASEC';idempotencyKey=('bb4a-'+[guid]::NewGuid().ToString('N'))} + Chk 'S4 ADMIN create 403/2002' ($pa.status -eq 403 -and (F $pa.json 'code') -eq 2002) "$($pa.status)/$(F $pa.json 'code')" +} else { ChkSkip 'S4 ADMIN create 403/2002' 'no ADMIN account in DB; ADMIN black-box not covered (covered by unit test AssessmentAttemptServiceTest.adminUser_create_returnsForbidden)' } + +# ============ S5 concurrency (fresh student) ============ +Write-Output '== S5 concurrent create + submit ==' +$s5=NewStudent +$s5tok = $s5.token; $s5id = $s5.id +$csBefore = [long](FirstOf "SELECT COUNT(*) FROM candidate_dimension_scores") +$nThreads=4 +$tmpDir = Join-Path $env:TEMP ('v35bb-' + [guid]::NewGuid().ToString('N')) +New-Item -ItemType Directory -Path $tmpDir -Force | Out-Null + +# --- concurrent create (different idempotency keys): capture real status + code per request --- +$createSb = { + param($base,$tk,$body,$outFile) + function W($st,$code){ [System.IO.File]::WriteAllText($outFile, ("$st|"+$code)) } + try { + $resp = Invoke-WebRequest -Uri "$base/assessments/attempts" -Method Post -Headers @{Authorization="Bearer $tk"} -ContentType 'application/json' -Body $body -UseBasicParsing -TimeoutSec 30 + $code=-1; try { $j=$resp.Content|ConvertFrom-Json; $code=[int]$j.code } catch {} + W $resp.StatusCode $code + } catch { + $st = if($_.Exception.Response -and $_.Exception.Response.StatusCode){[int]$_.Exception.Response.StatusCode}else{-1} + $code=-1 + if($_.ErrorDetails -and $_.ErrorDetails.Message){ try { $j=$_.ErrorDetails.Message|ConvertFrom-Json; $code=[int]$j.code } catch {} } + W $st $code + } +} +$pool=[runspacefactory]::CreateRunspacePool(1,$nThreads); $pool.Open() +$jobs=@() +foreach($i in 1..$nThreads){ + $body = @{typeCode='HOLLAND_RIASEC';idempotencyKey=('ccr-'+$i+'-'+[guid]::NewGuid().ToString('N'))}|ConvertTo-Json -Compress + $out = Join-Path $tmpDir ("c$i.txt") + $rs=[powershell]::Create(); $rs.RunspacePool=$pool + $null=$rs.AddScript($createSb).AddArgument($BASE).AddArgument($s5tok).AddArgument($body).AddArgument($out) + $jobs += ,@($rs,$rs.BeginInvoke()) +} +foreach($j in $jobs){ $j[0].EndInvoke($j[1])|Out-Null; $j[0].Dispose() } +$pool.Close() +$cresults=@() +foreach($i in 1..$nThreads){ + $f=Join-Path $tmpDir ("c$i.txt") + if(Test-Path $f){ + $p=(Get-Content $f -Raw) -replace '\s+','' -split '\|' + if($p.Count -ge 2){ $cresults += [pscustomobject]@{status=[int]$p[0];code=[int]$p[1]} } + } +} +$cstat=@($cresults | ForEach-Object {$_.status}) +$ccode=@($cresults | ForEach-Object {$_.code}) +Write-Output ("S5 concurrent create pairs: " + (($cresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',')) +$nWinner = @($cresults | Where-Object {$_.status -eq 200}).Count +$nLoser = @($cresults | Where-Object {$_.status -eq 409 -and $_.code -eq 9708}).Count +$badCreate = @($cresults | Where-Object {$_.status -ne 200 -and -not ($_.status -eq 409 -and $_.code -eq 9708)}).Count +Chk 'S5 concurrent create: exactly one 200' ($cresults.Count -eq $nThreads -and $nWinner -eq 1) (($cresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',') +Chk 'S5 concurrent create: every loser is 409/9708' ($nLoser -eq ($nThreads-1) -and $badCreate -eq 0) (($cresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',') +Chk 'S5 concurrent create: no 500/-1/empty' ($cresults.Count -eq $nThreads -and @($cresults|Where-Object{$_.status -eq 500 -or $_.status -eq -1 -or $_.code -eq -1}).Count -eq 0) (($cresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',') +Chk 'S5 DB: exactly one attempt persisted' ((FirstOf "SELECT COUNT(*) FROM assessment_attempts WHERE student_user_id=$s5id") -eq 1) +Chk 'S5 DB: exactly one active attempt' ((FirstOf "SELECT COUNT(*) FROM assessment_attempts WHERE student_user_id=$s5id AND active_key IS NOT NULL") -eq 1) + +# --- concurrent submit (2 threads) on the winning active attempt: allowed 200, no 500 --- +$winAid = FirstOf "SELECT id FROM assessment_attempts WHERE student_user_id=$s5id AND active_key IS NOT NULL LIMIT 1" +if($winAid){ + $s5g = Api 'GET' "$BASE/assessments/attempts/$winAid" $s5tok + $s5all = @($s5g.json.data.questions | ForEach-Object { @{questionId=$_.id; value=4} }) + Api 'PATCH' "$BASE/assessments/attempts/$winAid/answers" $s5tok @{version=(F $s5g.json.data 'version');answers=$s5all} | Out-Null + $submitSb = { + param($base,$tk,$aid,$outFile) + function W2($st,$code){ [System.IO.File]::WriteAllText($outFile, ("$st|$code")) } + try { + $resp=Invoke-WebRequest -Uri "$base/assessments/attempts/$aid/submit" -Method Post -Headers @{Authorization="Bearer $tk"} -UseBasicParsing -TimeoutSec 30 + $code=-1; try { $j=$resp.Content|ConvertFrom-Json; $code=[int]$j.code } catch {} + W2 ([int]$resp.StatusCode) $code + } + catch { + $st=if($_.Exception.Response -and $_.Exception.Response.StatusCode){[int]$_.Exception.Response.StatusCode}else{-1} + $code=-1 + if($_.ErrorDetails -and $_.ErrorDetails.Message){ try { $j=$_.ErrorDetails.Message|ConvertFrom-Json; $code=[int]$j.code } catch {} } + W2 $st $code + } + } + $pool2=[runspacefactory]::CreateRunspacePool(1,2); $pool2.Open() + $j2=@(); foreach($i in 1..2){ $out=Join-Path $tmpDir ("s$i.txt"); $rs=[powershell]::Create(); $rs.RunspacePool=$pool2; $null=$rs.AddScript($submitSb).AddArgument($BASE).AddArgument($s5tok).AddArgument($winAid).AddArgument($out); $j2 += ,@($rs,$rs.BeginInvoke()) } + foreach($j in $j2){ $j[0].EndInvoke($j[1])|Out-Null; $j[0].Dispose() }; $pool2.Close() + $sresults=@() + foreach($i in 1..2){ + $f=Join-Path $tmpDir ("s$i.txt") + if(Test-Path $f){ + $p=(Get-Content $f -Raw) -replace '\s+','' -split '\|' + if($p.Count -ge 2){ $sresults += [pscustomobject]@{status=[int]$p[0];code=[int]$p[1]} } + } + } + Write-Output ("S5 concurrent submit pairs: " + (($sresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',')) + # Submit is idempotent: success is 200; a race-window conflict may only be 409/9703. + $validSubmit = @($sresults | Where-Object { $_.status -eq 200 -or ($_.status -eq 409 -and $_.code -eq 9703) }).Count + Chk 'S5 concurrent submit: only 200 or 409/9703' ($sresults.Count -eq 2 -and $validSubmit -eq 2) (($sresults | ForEach-Object {"$($_.status)/$($_.code)"}) -join ',') + Chk 'S5 concurrent submit: only one result' ((FirstOf "SELECT COUNT(*) FROM assessment_results WHERE attempt_id=$winAid") -eq 1) + Chk 'S5 concurrent submit: only one audit' ((FirstOf "SELECT COUNT(*) FROM audit_logs WHERE entity_id=$winAid AND action='ASSESSMENT_ATTEMPT_SUBMITTED'") -eq 1) +} else { ChkSkip 'S5 concurrent submit' 'no winning active attempt found' } + +$csAfter = [long](FirstOf "SELECT COUNT(*) FROM candidate_dimension_scores") +Chk 'S5 candidate_dimension_scores unchanged' ($csBefore -eq $csAfter) "$csBefore vs $csAfter" + +# ============ S6 audit desensitization (scan student audits) ============ +Write-Output '== S6 audit desensitization ==' +$phones = @($s1.phone,$s2.phone,$s3.phone,$s5.phone) +$bad='' +$auditRows = @(MySQL "SELECT details FROM audit_logs WHERE user_id IN ($($s1.id),$($s2.id),$($s5.id)) AND action IN ('ASSESSMENT_ATTEMPT_CREATED','ASSESSMENT_ATTEMPT_SUBMITTED') ORDER BY id DESC LIMIT 40") +foreach($row in $auditRows){ + $hit=$false; foreach($ph in $phones){ if($ph -and $row -like "*$ph*"){ $hit=$true;break } } + if($hit){ $bad='leaked phone'; break } + if($row -match '答案|我对|Bearer|password|secret|email=|JWT|accessToken'){ $bad=$row; break } +} +Chk 'S6 audit details no phone/email/password/token/stem' ($bad -eq '') $(if($bad){$bad.Substring(0,[Math]::Min(80,$bad.Length))}else{'clean'}) +Chk 'S6 submit audit rows written' (@($auditRows | Where-Object { $_ -match 'answeredCount' }).Count -ge 1) + +# ============ S7 rabbitmq ============ +Write-Output '== S7 rabbitmq final ==' +$n1=RmqStat 'queue.notification'; $n2=RmqStat 'queue.audit'; $n3=RmqStat 'queue.notification.dlq' +Chk 'S7 queue.notification ready/unacked=0' ($n1.ready -eq 0 -and $n1.unacked -eq 0) "r=$($n1.ready) u=$($n1.unacked)" +Chk 'S7 queue.audit ready/unacked=0' ($n2.ready -eq 0 -and $n2.unacked -eq 0) "r=$($n2.ready) u=$($n2.unacked)" +Chk 'S7 queue.notification.dlq ready/unacked=0' ($n3.ready -eq 0 -and $n3.unacked -eq 0) "r=$($n3.ready) u=$($n3.unacked)" + +Write-Output "============================================================" +Write-Output "SUMMARY PASS=$pass FAIL=$fail SKIP=$skip" +if($failures.Count -gt 0){ Write-Output 'FAILURES:'; $failures|ForEach-Object{Write-Output " - $_"} }else{ Write-Output 'NO FAILURES' } diff --git a/backend-infra/v41_blackbox.ps1 b/backend-infra/v41_blackbox.ps1 new file mode 100644 index 0000000..5681ae1 --- /dev/null +++ b/backend-infra/v41_blackbox.ps1 @@ -0,0 +1,245 @@ +$ErrorActionPreference = 'Stop' + +Push-Location $PSScriptRoot +$pass = 0 +$fail = 0 +$fixtureUsers = @() +$fixturePhones = @() +$fixtureAbilityUser = $null +Add-Type -AssemblyName System.Net.Http + +function Pass([string]$name) { + $script:pass++ + Write-Output "PASS $name" +} + +function Fail([string]$name, [string]$detail = '') { + $script:fail++ + Write-Output ("FAIL {0}{1}" -f $name, $(if ($detail) { " :: $detail" } else { '' })) +} + +function Assert([bool]$condition, [string]$name, [string]$detail = '') { + if ($condition) { Pass $name } else { Fail $name $detail } +} + +function Sql([string]$query) { + $output = $query | docker compose --env-file .env exec -T mysql sh -lc 'MYSQL_PWD="$MYSQL_ROOT_PASSWORD" mysql -uroot -N -B mydreamjob' 2>$null + if ($LASTEXITCODE -ne 0) { throw 'mysql query failed' } + $rows = @($output | ForEach-Object { "$($_)".Trim() } | Where-Object { $_ -ne '' }) + return ,$rows +} + +function Rabbit { + $output = docker compose --env-file .env exec -T rabbitmq rabbitmqctl list_queues name messages_ready messages_unacknowledged 2>$null + if ($LASTEXITCODE -ne 0) { throw 'rabbitmq query failed' } + $rows = @($output | ForEach-Object { "$($_)".Trim() } | Where-Object { $_ -ne '' }) + return ,$rows +} + +function Api([string]$method, [string]$path, [string]$token = $null, $body = $null) { + $client = [System.Net.Http.HttpClient]::new() + try { + $request = [System.Net.Http.HttpRequestMessage]::new( + [System.Net.Http.HttpMethod]::new($method), + ('http://127.0.0.1:8080/api/v1' + $path)) + $request.Headers.Add('X-Request-Id', ('v41-blackbox-' + [guid]::NewGuid().ToString('N'))) + if ($token) { + $request.Headers.Authorization = [System.Net.Http.Headers.AuthenticationHeaderValue]::new('Bearer', $token) + } + if ($null -ne $body) { + $json = $body | ConvertTo-Json -Depth 30 -Compress + $request.Content = [System.Net.Http.StringContent]::new($json, [Text.Encoding]::UTF8, 'application/json') + } + $response = $client.SendAsync($request).GetAwaiter().GetResult() + $raw = $response.Content.ReadAsStringAsync().GetAwaiter().GetResult() + $parsed = $null + if ($raw) { try { $parsed = $raw | ConvertFrom-Json } catch {} } + return [pscustomobject]@{ Status = [int]$response.StatusCode; Json = $parsed; Raw = $raw } + } finally { $client.Dispose() } +} + +function Login([long]$userId) { + $phone = (Sql "SELECT phone FROM users WHERE id=$userId LIMIT 1")[0] + if (-not $phone) { throw "login user not found" } + docker compose --env-file .env exec -T redis redis-cli DEL ("sms:rate:" + $phone) 2>$null | Out-Null + $sent = Api 'POST' ("/auth/sms/send?phone=$phone&purpose=login") $null $null + if ($sent.Status -ne 200) { throw 'sms send failed' } + $code = (Sql "SELECT code FROM sms_verification_codes WHERE phone='$phone' AND purpose='login' ORDER BY id DESC LIMIT 1")[0] + $login = Api 'POST' '/auth/login' $null @{ phone = $phone; code = $code; purpose = 'login' } + if ($login.Status -ne 200 -or -not $login.Json.data.accessToken) { throw 'login failed' } + return [string]$login.Json.data.accessToken +} + +function NewFixtureStudent([string]$label, [bool]$withPreference) { + $phone = '19' + (([DateTimeOffset]::Now.ToUnixTimeMilliseconds() % 1000000000) + $script:fixtureUsers.Count + 1).ToString('D9') + $script:fixturePhones += $phone + $sql = @" +INSERT INTO users(phone,nickname,role,is_active,is_verified) VALUES ('$phone','$label','STUDENT',1,1); +SELECT LAST_INSERT_ID(); +"@ + $id = [long]((Sql $sql)[0]) + $script:fixtureUsers += $id + Sql @" +INSERT INTO user_roles(user_id,role) VALUES ($id,'STUDENT'); +INSERT INTO student_profiles(user_id,location,education,graduation_year,skills_json) +SELECT $id,j.city,'Bachelor',2026,'["$label","Java","Spring Boot","SQL"]' FROM jobs j WHERE j.id=1; +INSERT INTO student_talent_discovery_preferences(student_user_id,enabled,version) VALUES ($id,1,0); +"@ | Out-Null + if ($withPreference) { + Sql @" +INSERT INTO student_preferences(student_user_id,expected_salary_min,expected_salary_max,preferred_cities,employment_types,preferred_industries,preferred_job_types,remote_allowed) +SELECT $id,NULL,NULL,JSON_ARRAY(j.city),JSON_ARRAY(j.employment_type),JSON_ARRAY(p.industry_code),JSON_ARRAY(p.job_family_code),0 +FROM jobs j JOIN job_recommendation_profiles p ON p.job_id=j.id WHERE j.id=1; +"@ | Out-Null + } + return $id +} + +function Cleanup { + if (-not $script:fixtureUsers.Count) { return } + $ids = $script:fixtureUsers -join ',' + $phones = ($script:fixturePhones | ForEach-Object { "'$_'" }) -join ',' + try { Sql "DELETE FROM audit_logs WHERE user_id IN ($ids) OR (action='SMS_SEND' AND request_id LIKE 'v41-blackbox-%')" | Out-Null } catch {} + try { Sql "DELETE FROM ability_results WHERE attempt_id IN (SELECT id FROM ability_attempts WHERE student_user_id IN ($ids))" | Out-Null } catch {} + try { Sql "DELETE FROM ability_attempts WHERE student_user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM applications WHERE student_user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM student_preferences WHERE student_user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM student_talent_discovery_preferences WHERE student_user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM student_profiles WHERE user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM account_deletions WHERE user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM user_roles WHERE user_id IN ($ids)" | Out-Null } catch {} + try { Sql "DELETE FROM sms_verification_codes WHERE phone IN ($phones)" | Out-Null } catch {} + try { Sql "DELETE FROM users WHERE id IN ($ids)" | Out-Null } catch {} +} + +try { + $flywayRow = (Sql "SELECT version,success FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 1")[0] + $flyway = @($flywayRow -split '\s+') + Assert ($flyway.Count -ge 2 -and $flyway[0] -eq '39' -and $flyway[1] -eq '1') 'Flyway V39 success' + $table = Sql "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='mydreamjob' AND table_name='student_talent_discovery_preferences'" + Assert ([int]$table[0] -eq 1) 'V39 table exists' + $constraints = Sql "SELECT constraint_type FROM information_schema.table_constraints WHERE table_schema='mydreamjob' AND table_name='student_talent_discovery_preferences'" + Assert (@($constraints | Where-Object { $_ -eq 'UNIQUE' }).Count -ge 1) 'UNIQUE student_user_id' + $check = Sql "SELECT COUNT(*) FROM information_schema.table_constraints WHERE constraint_schema='mydreamjob' AND table_name='student_talent_discovery_preferences' AND constraint_type='CHECK'" + Assert ([int]$check[0] -ge 1) 'CHECK enabled constraint' + + $health = Api 'GET' '/health' + Assert ($health.Status -eq 200 -and $health.Json.data.status -eq 'UP') 'health 200' + $docs = Api 'GET' '/v3/api-docs' + $pathNames = @($docs.Json.paths.PSObject.Properties.Name) + $opCount = 0 + foreach ($property in $docs.Json.paths.PSObject.Properties) { + $opCount += @($property.Value.PSObject.Properties.Name | Where-Object { $_ -in @('get','post','put','patch','delete','options','head','trace') }).Count + } + Assert ($pathNames.Count -eq 161 -and $opCount -eq 199) 'runtime OpenAPI 161/199' + Assert ($pathNames -contains '/profile/me/talent-discovery' -and $pathNames -contains '/companies/me/jobs/{jobId}/talent-recommendations') 'V41 paths present' + + $baseScores = [int](Sql 'SELECT COUNT(*) FROM candidate_dimension_scores')[0] + $a = NewFixtureStudent 'V41BB-A' $true + $b = NewFixtureStudent 'V41BB-B' $true + $c = NewFixtureStudent 'V41BB-C' $true + $d = NewFixtureStudent 'V41BB-D' $false + $e = NewFixtureStudent 'V41BB-E' $true + $script:fixtureAbilityUser = $d + Sql "INSERT INTO applications(job_id,student_user_id,status) VALUES (1,$b,'REJECTED'),(13,$c,'WITHDRAWN');" | Out-Null + Sql "INSERT INTO account_deletions(user_id,status,requested_at,version) VALUES ($e,'PENDING',NOW(),0);" | Out-Null + Sql @" +INSERT INTO ability_attempts(student_user_id,definition_id,status,question_set_version,answered_count,active_key,idempotency_key,completed_at,submitted_at,started_at) +VALUES ($d,1,'COMPLETED','ability-v0.1',24,NULL,NULL,DATE_SUB(NOW(),INTERVAL 2 DAY),DATE_SUB(NOW(),INTERVAL 2 DAY),DATE_SUB(NOW(),INTERVAL 2 DAY)); +SET @high_attempt=LAST_INSERT_ID(); +INSERT INTO ability_results(attempt_id,dimension_scores_json,overall_score,valid_until,question_set_version,rules_version,generated_at) +VALUES (@high_attempt,'[{"code":"LOGIC","score":100,"answeredCount":6},{"code":"COMMUNICATION","score":100,"answeredCount":6},{"code":"EXECUTION","score":100,"answeredCount":6},{"code":"LEARNING","score":100,"answeredCount":6}]',100,DATE_ADD(NOW(),INTERVAL 7 DAY),'ability-v0.1','ability-v0.1',NOW()); +INSERT INTO ability_attempts(student_user_id,definition_id,status,question_set_version,answered_count,active_key,idempotency_key,completed_at,submitted_at,started_at) +VALUES ($d,1,'COMPLETED','ability-v0.1',24,NULL,NULL,DATE_SUB(NOW(),INTERVAL 1 HOUR),DATE_SUB(NOW(),INTERVAL 1 HOUR),DATE_SUB(NOW(),INTERVAL 1 HOUR)); +SET @low_attempt=LAST_INSERT_ID(); +INSERT INTO ability_results(attempt_id,dimension_scores_json,overall_score,valid_until,question_set_version,rules_version,generated_at) +VALUES (@low_attempt,'[{"code":"LOGIC","score":0,"answeredCount":6},{"code":"COMMUNICATION","score":0,"answeredCount":6},{"code":"EXECUTION","score":0,"answeredCount":6},{"code":"LEARNING","score":0,"answeredCount":6}]',0,DATE_ADD(NOW(),INTERVAL 7 DAY),'ability-v0.1','ability-v0.1',NOW()); +"@ | Out-Null + + $tokenA = Login $a + $tokenB = Login $b + $tokenC = Login $c + $tokenD = Login $d + $tokenCompany = Login 3 + $tokenAdmin = Login 1 + $tokenUnverified = Login 84 + + $pref = Api 'GET' '/profile/me/talent-discovery' $tokenA + Assert ($pref.Status -eq 200 -and $pref.Json.data.enabled -eq $true -and [int]$pref.Json.data.version -eq 0) 'student preference GET' + $updated = Api 'PUT' '/profile/me/talent-discovery' $tokenA @{ enabled = $false; expectedVersion = 0 } + Assert ($updated.Status -eq 200 -and $updated.Json.data.enabled -eq $false -and [int]$updated.Json.data.version -eq 1) 'student preference update/version' + $stale = Api 'PUT' '/profile/me/talent-discovery' $tokenA @{ enabled = $true; expectedVersion = 0 } + Assert ($stale.Status -eq 409 -and [int]$stale.Json.code -eq 9201) 'stale preference conflict 9201' + $restored = Api 'PUT' '/profile/me/talent-discovery' $tokenA @{ enabled = $true; expectedVersion = 1 } + Assert ($restored.Status -eq 200 -and $restored.Json.data.enabled -eq $true -and [int]$restored.Json.data.version -eq 2) 'preference restored' + $studentForbidden = Api 'GET' '/profile/me/talent-discovery' $tokenCompany + Assert ($studentForbidden.Status -eq 403 -and [int]$studentForbidden.Json.code -eq 2002) 'company denied student preference' + $anon = Api 'GET' '/profile/me/talent-discovery' + Assert ($anon.Status -eq 401) 'anonymous denied preference' + + $unavailable = Api 'GET' '/companies/me/jobs/7/talent-recommendations?page=0&size=20' $tokenCompany + Assert ($unavailable.Status -eq 200 -and $unavailable.Json.data.mode -eq 'UNAVAILABLE' -and [int]$unavailable.Json.data.total -eq 0) 'unavailable job profile' + $page = Api 'GET' '/companies/me/jobs/1/talent-recommendations?page=0&size=50' $tokenCompany + Assert ($page.Status -eq 200 -and $page.Json.data.mode -eq 'PERSONALIZED') 'personalized recommendations' + $items = @($page.Json.data.items) + $idsInRaw = $page.Raw + Assert ($items.Count -ge 3 -and [int]$page.Json.data.total -ge 3) 'eligible candidates returned' + $keys = @($items | ForEach-Object { $_.candidateKey }) + Assert ($keys -contains $null -eq $false -and ($keys | Select-Object -Unique).Count -eq $keys.Count) 'opaque candidate keys' + Assert (-not ($idsInRaw -match 'studentUserId|candidateId|fitScore|dimensionScores|overallScore|attemptId|resultId|answerKey|scoringRule|questionCode|competencyTag|resumeUrl|phone|email|gender|birthDate|password|token')) 'candidate JSON redacted' + $bands = @($items | ForEach-Object { $_.fitBand }) + Assert ($bands -contains 'BASIC') 'latest low ability beats historical high (BASIC)' + $signals = @($items | ForEach-Object { $_.signalsAvailable -join ',' }) + Assert (($signals -contains 'PREFERENCE') -and ($signals -contains 'ABILITY')) 'signals available' + $currentRaw = ($items | ConvertTo-Json -Depth 20 -Compress) + $skillText = ($items | ForEach-Object { $_.skills -join ',' }) -join ',' + Assert ($skillText -match 'V41BB-A' -and $skillText -match 'V41BB-C' -and $skillText -match 'V41BB-D' -and $skillText -notmatch 'V41BB-B') 'same-company application excluded; other-company retained' + Assert ($skillText -notmatch 'V41BB-E') 'pending account deletion excluded' + $dCard = @($items | Where-Object { ($_.skills -join ',') -match 'V41BB-D' })[0] + Assert ($null -ne $dCard -and ($dCard.signalsAvailable -join ',') -eq 'ABILITY' -and $dCard.fitBand -eq 'BASIC') 'latest low ability selected over historical high' + $p0 = Api 'GET' '/companies/me/jobs/1/talent-recommendations?page=0&size=1' $tokenCompany + $pLast = Api 'GET' ("/companies/me/jobs/1/talent-recommendations?page=" + ([int]$page.Json.data.total - 1) + '&size=1') $tokenCompany + Assert ($p0.Status -eq 200 -and $pLast.Status -eq 200 -and $p0.Json.data.items[0].fitBand -ne 'BASIC' -and $pLast.Json.data.items[0].fitBand -eq 'BASIC') 'global sort before pagination' + + $afterScores = [int](Sql 'SELECT COUNT(*) FROM candidate_dimension_scores')[0] + Assert ($afterScores -eq $baseScores) 'V41 does not write candidate_dimension_scores' + $countB = [int](Sql "SELECT COUNT(*) FROM applications WHERE student_user_id=$b AND job_id=1")[0] + $countC = [int](Sql "SELECT COUNT(*) FROM applications WHERE student_user_id=$c AND job_id=13")[0] + Assert ($countB -eq 1 -and $countC -eq 1) 'fixture historical applications recorded' + + $studentCompany = Api 'GET' '/companies/me/jobs/1/talent-recommendations' $tokenA + Assert ($studentCompany.Status -eq 403 -and [int]$studentCompany.Json.code -eq 2002) 'student denied company recommendations' + $adminCompany = Api 'GET' '/companies/me/jobs/1/talent-recommendations' $tokenAdmin + Assert ($adminCompany.Status -eq 403 -and [int]$adminCompany.Json.code -eq 2002) 'admin denied company recommendations' + $cross = Api 'GET' '/companies/me/jobs/13/talent-recommendations' $tokenCompany + Assert ($cross.Status -eq 403 -and [int]$cross.Json.code -eq 2002) 'cross-company job denied' + $unverified = Api 'GET' '/companies/me/jobs/13/talent-recommendations' $tokenUnverified + Assert ($unverified.Status -eq 403 -and [int]$unverified.Json.code -eq 2002) 'unverified company denied' + $anonCompany = Api 'GET' '/companies/me/jobs/1/talent-recommendations' + Assert ($anonCompany.Status -eq 401) 'anonymous denied company recommendations' + $badPage = Api 'GET' '/companies/me/jobs/1/talent-recommendations?page=-1&size=51' $tokenCompany + Assert ($badPage.Status -eq 400 -and [int]$badPage.Json.code -in @(400,1001)) 'page/size validation' + + $legacy = Api 'GET' '/profile/me/job-recommendations?page=0&size=1' $tokenA + Assert ($legacy.Status -eq 200) 'V39 job recommendation regression' + $queues = Rabbit + $known = @('queue.notification','queue.audit','queue.notification.dlq') + foreach ($q in $known) { + $line = @($queues | Where-Object { $_ -match "^$q\s" }) + if ($line.Count -eq 0) { Fail "Rabbit queue exists $q"; continue } + $fields = ($line[0] -split '\s+') + Assert ([int]$fields[-2] -eq 0 -and [int]$fields[-1] -eq 0) "Rabbit queue drained $q" + } + + $constraintRow = Sql "SELECT COUNT(*) FROM student_talent_discovery_preferences WHERE student_user_id=$a AND enabled=1" + Assert ([int]$constraintRow[0] -eq 1) 'preference persisted in MySQL' + Write-Output ("V41_BLACKBOX_PASS={0} FAIL={1}" -f $pass, $fail) + if ($fail -gt 0) { exit 1 } +} catch { + Fail 'blackbox execution' $_.Exception.Message + Write-Output ("V41_BLACKBOX_PASS={0} FAIL={1}" -f $pass, $fail) + exit 1 +} finally { + Cleanup + Pop-Location +} diff --git a/docs/ability-assessment-api.md b/docs/ability-assessment-api.md new file mode 100644 index 0000000..2232f98 --- /dev/null +++ b/docs/ability-assessment-api.md @@ -0,0 +1,188 @@ +# 四维能力测评 API 设计文档（V36 设计锁定版） + +> 状态：**设计已锁定，待编码**。功能版本 V36。题库为自研工作情境题；本版不接入候选评分引擎、不向企业开放结果。题目统计质量门槛保留为后续试测工作，不阻塞本版功能实现。 + +## 0. 产品来源摘要（func.xlsx，已确认） + +- 功能名：**能力测评(4维度) = 逻辑 / 沟通 / 执行 / 学习 能力四维测评**（`功能详细清单 D24/F24`、`求职端功能详情 B24/C24`、`企业端功能详情`）。 +- 目标：**了解自己目前的能力短板在哪里**（G24）。 +- 结果展示：**四维能力测试 → 能力雷达图 + 短板提示**（F24）。 +- 限时：**测评限时 30 分钟，超时强制提交**（G24）。 +- 完成率：**测评完成率 ≥ 70%**（H24，中途退出保存进度的判定）。 +- 质量：**测评区分度 ≥ 0.4**（H24/H52，为非功能质量门槛）。 +- 能力测评评分（F1.2）：基于四维得分 → **能力综合分**，「让企业看到我的能力测评结果」；未测评显示「待测评」（G52）。 +- 成长信号：学习能力/成长速度潜力分（F55/G55）。 + +## 1. 功能范围与非目标 + +**范围内（第一版 V36）**： +- 四维能力测评的题型目录、创建答卷、答题保存、进度恢复、提交、结果查询。 +- 结果含四维分、综合分、最低维度短板提示、雷达图数据、题目解析与有效期状态。 + +**非目标（V36 默认不做，除非负责人确认）**： +- 不接入 Candidate Scoring / 不写 `candidate_dimension_scores`（ABILITY 保持 PENDING）。 +- 不提供企业查看学生能力测评结果的接口。 +- 不做岗位推荐、AI 路径建议、开放题或 AI 自动评分。 +- 不做定时器批量改写结果有效期；结果是否过期在读取或新建答卷时由后端按 `valid_until` 动态判断。 + +## 2. 四个能力维度的正式名称与编码 + +| 编码(Code) | 名称 | 说明 | +|---|---|---| +| LOGIC | 逻辑能力 | 逻辑/推理/分析 | +| COMMUNICATION | 沟通能力 | 表达/协作/共情 | +| EXECUTION | 执行能力 | 行动/落地/结果导向 | +| LEARNING | 学习能力 | 学习/成长/适应 | + +编码和结果字段按上表锁定。 + +## 3. 题库来源、题目数量、题目版本 + +- 题目来源：自研（`SELF_AUTHORED`），不复制商用量表。 +- 锁定题库文件：`docs/ability-question-bank-v0.1.json`。迁移种子、题库测试和题目版本必须以该文件为唯一权威来源，禁止在 SQL 或 Java 中自行改写题干、选项、答案键、分值或解析。 +- 题库总量：每维 12 题，共 **48 题**；每次答卷从每个维度分层随机抽取 6 题，共 **24 题**。 +- 题型：单选题、情境判断题、排序题；允许选项部分得分，不采用开放题。 +- 题目版本：`ability-v0.1`。每题必须保留 `difficulty`、`discrimination`、`version` 字段；前两项允许在首版种子数据中为空，试测后回填。 + +## 4. 是否固定题目或分层随机抽题 + +- 采用分层随机抽题：从每维 ACTIVE 题库随机抽取 6 题，并把题目集合、顺序、题目版本和题目快照持久化；刷新、恢复和重复读取均不得重新抽题。 +- 新建或重测答卷均重新抽取本次 24 题；不得向前端返回内部维度、答案键、评分规则或题目版本。 + +## 5. 单次答题数量与完成条件 + +- 单次题量固定为 4 维 × 6 = **24 题**。 +- 必须回答 24/24 才能提交；任何未完成答卷均返回 `ABILITY_INCOMPLETE`，不得依据 70% 生成正式结果。 +- 产品“完成率 ≥ 70%”仅用于过程进度展示，不构成提交门槛。 + +## 6. 题型与计分规则 + +- 每题均为后端判分的工作情境题。每个选项对应 0、1、2 或 4 分；选项及其得分、标准答案键、评分规则和解析均只保存在后端。 +- 每维原始分为该维 6 题得分之和，维度百分制分数为 `rawScore / 24 × 100`；保留两位小数，使用 `HALF_UP`。 +- 综合分为四维百分制得分的等权平均；只有四维均完成 6 题时才生成综合分。 +- 短板取最低维度；若最低分并列，返回全部并列维度。结果页同时返回每道题解析，但仅限答卷提交后由本人读取。 + +## 7. 中途保存和恢复规则 + +- 保存答案对 (attempt, question) upsert；同请求内同题重复 → 校验拒绝。 +- 获取答卷恢复：固定题目顺序 + 已答值；刷新不重抽题。 +- 未答完可退出，下次 GET 恢复；与 RIASEC 一致（active 答卷阻塞重测）。 + +## 8. 答卷状态机 + +锁定状态机： +``` +DRAFT → IN_PROGRESS → COMPLETED +IN_PROGRESS --(超过 expires_at 且未提交)--> EXPIRED +``` +- 创建答卷仅进入 `DRAFT`，不开始计时。 +- 第一次成功保存答案时，后端一次性设置 `started_at=now`、`expires_at=started_at+30分钟`，并转为 `IN_PROGRESS`。 +- 后续保存、读取、提交均由后端校验 `expires_at`；超时未答完 24 题时，原子标记为 `EXPIRED`，不生成结果、不可继续答题或提交。 +- `DRAFT` 没有倒计时；同一学生同一类型始终至多存在一份 `DRAFT/IN_PROGRESS` 活跃答卷。 + +## 9. 重测和历史保留规则 + +- 历史答卷和结果永久保留，不删除。 +- 完成时写入 `valid_until = completed_at + 7天`。在 `valid_until` 前为当前有效结果；到期后结果仍可查询，但 `validityStatus=EXPIRED` 且仅作为历史结果。 +- 不设置“历史最高分”。当前结果只取最近一次已完成且仍有效的结果，避免用户通过反复答题刷取最高分。 +- 有效结果存在期间禁止重测；结果到期后方可创建下一份答卷。 +- 每名学生滚动 90 天内最多完成 3 次测评；未完成而超时的 `EXPIRED` 答卷不计入该完成次数。 + +## 10. 提交幂等与并发策略 + +- 唯一键：`(student_user_id, idempotency_key)` 幂等；`active_key`（学生+类型+ACTIVE）保证同类型最多 1 份活跃答卷（复用 V35 已验证方案）。 +- 提交原子化：`DRAFT/IN_PROGRESS → COMPLETED` 的批量更新返回行数；仅行数=1 者生成结果+写审计；并发只产生 1 条 result + 1 条提交审计；重复提交幂等返回原结果。 +- 提交并发无 500（沿用 V35 REQUIRES_NEW + READ_COMMITTED 修复）。 +- 创建时先校验当前有效结果是否存在，再校验 90 天完成次数；两类限制须有对应错误码，不能误报为活跃答卷冲突。 + +## 11. 权限矩阵 + +| 接口 | 未登录 | STUDENT | COMPANY | ADMIN | +|---|---|---|---|---| +| 类型列表 | 401 | 200 | 200 | 200 | +| 创建 / 答卷 / 保存 / 提交 / 结果 / 历史 | 401 | 仅本人 | 403/2002 | 403/2002 | + +- 身份一律 JWT/SecurityContext，不接受 userId 参数。 +- 第一版不提供企业查看能力结果接口；能力综合分写入评分引擎与企业侧结果展示均为后续独立评审事项。 + +## 12. 错误码 + +- V35 RIASEC 已占用 `9701–9709`（97xx）。V36 使用独立区间 **`9801–9811`**（能力测评），避免复用冲突： + - `9801 ABILITY_TYPE_NOT_FOUND`、`9802 ABILITY_ATTEMPT_NOT_FOUND`、`9803 ABILITY_ATTEMPT_INVALID_STATE`、`9805 ABILITY_ANSWER_INVALID`、`9806 ABILITY_INCOMPLETE`、`9807 ABILITY_CONCURRENT_UPDATE`、`9808 ABILITY_DUPLICATE_ACTIVE`、`9809 ABILITY_IDEMPOTENCY_CONFLICT`。 +- `9810 ABILITY_RETAKE_COOLDOWN`（409）：当前仍存在有效完成结果，尚不可重测。 +- `9811 ABILITY_RETAKE_LIMIT`（429）：滚动 90 天内已完成 3 次。 +- 复用 `1001/2001/2002`；超时答卷读取、保存或提交统一按 `9803 ABILITY_ATTEMPT_INVALID_STATE` 处理。 + +## 13. DTO 与接口字段 + +接口采用独立 `/abilities/**` 命名空间（最终 7 个接口）： +``` +GET /abilities/types +POST /abilities/attempts +GET /abilities/attempts/{attemptId} +PATCH /abilities/attempts/{attemptId}/answers +POST /abilities/attempts/{attemptId}/submit +GET /abilities/attempts/{attemptId}/result +GET /abilities/me?page&size +``` +V36 不提供 `GET /abilities/{type}/questions`；题目只在创建答卷后通过 `GET /abilities/attempts/{attemptId}` 返回。 +- 题目响应隐藏 `dimension/questionCode/competencyTag/source/reverseScored/questionVersion/answerKey/scoringRule`（不泄露能力维度语义与计分内部字段）。 +- 结果响应（白名单）：`attemptId/typeCode/status/validityStatus/validUntil/dimensionScores[{code,score,answeredCount}]/overallScore/weaknesses/radar/answeredCount/completionRate/questionFeedback[{questionId,selectedOption,explanation}]/disclaimer`。不含答案键、选项得分、studentUserId、phone、email、password。 + +## 14. 数据库表、索引、唯一约束、外键 + +采用独立 `ability_*` 六表，避免与 V35 RIASEC 的题型、判分方式和生命周期耦合： +``` +ability_definitions type_code UNIQUE; status; scale_type; question_count; attempt_question_count; min_per_dimension; question_set_version; rules_version +ability_questions UNIQUE(definition_id, question_code), UNIQUE(definition_id, position), CHECK(dimension IN LOGIC/COMMUNICATION/EXECUTION/LEARNING), item_type/options_json/answer_key_json/scoring_rule_json/explanation/difficulty/discrimination/version +ability_attempts UNIQUE(student_user_id, idempotency_key), UNIQUE(active_key), @Version, CHECK(status IN DRAFT/IN_PROGRESS/COMPLETED/EXPIRED) +ability_attempt_questions UNIQUE(attempt_id, question_id), UNIQUE(attempt_id, position), question_version/question_snapshot_json +ability_answers UNIQUE(attempt_id, question_id), selected_option/awarded_score/answered_at +ability_results UNIQUE(attempt_id)（幂等） +``` +- 外键：attempt→definitions/users(CASCADE)、attempt_question/answer→attempt(CASCADE)+question、result→attempt(CASCADE)。题目快照用于保证题库后续修订或停用后，历史答卷和提交后的解析仍按当时版本展示与计分。 +- 索引：`(student_user_id, created_at)`、`active_key` 唯一、`status` 等。 +- 时间相关字段：`started_at/expires_at/submitted_at/completed_at`；结果含 `valid_until`。`active_key` 仅在 `DRAFT/IN_PROGRESS` 非空，进入 `COMPLETED/EXPIRED` 后置空。 + +## 15. 脱敏要求 + +- 题目响应不泄露维度与内部编码；结果不返回原始答案、手机号、邮箱、password、JWT、他人信息。 +- 不保存不必要的题面；审计不含题面/答案/PII。 + +## 16. 审计要求 + +- 写入 `ABILITY_ATTEMPT_CREATED` / `ABILITY_ATTEMPT_SUBMITTED`。 +- details 仅允许 `attemptId/typeCode/status/answeredCount/questionSetVersion/rulesVersion/requestId/timestamp`；禁止题面、答案、手机号、邮箱、JWT。 + +## 17. 是否写入 candidate_dimension_scores + +- V36 第一版不写 `candidate_dimension_scores`，ABILITY 维度维持 `PENDING`；不提供企业端能力测评结果接口。 +- 将能力综合分写入评分引擎、企业端查看结果均为后续独立评审事项。 + +## 18. OpenAPI 增量 + +- 基线 134 paths / 168 operations。 +- 固定 +7 paths / +7 operations（`/abilities/**` 7 端点：类型/创建/详情/保存/提交/结果/我的历史）→ **141 paths / 175 operations**；V36 不提供 `GET /abilities/{type}/questions`。运行时 OpenAPI 必须与静态一致。 + +## 19. MockMvc、集成测试和 MySQL 黑盒验收方案 + +- 测试类（镜像 RIASEC）： + - `AbilityAssessmentCatalogTest`、`AbilityAssessmentResultComputerTest`、`AbilityAssessmentAttemptServiceTest`、`AbilityAssessmentControllerTest`、`AbilityAssessmentPersistenceIntegrationTest`（含并发创建/并发提交）、种子/迁移测试。 +- 覆盖：创建、幂等重放、同 key 同/异请求、活跃重复、有效结果冷却、90 天完成上限、中途保存、首次保存起算、恢复同一题、30 分钟超时、非法/跨答卷题 ID、未答完提交、重复提交、并发创建/提交、STUDENT/COMPANY/ADMIN/匿名权限、结果和题目解析脱敏、业务表无异常写入、Flyway、外键/唯一约束。 +- MySQL 黑盒：健康 200、Flyway 最新成功、运行时/静态 OpenAPI 一致、表/约束/数据核验、并发无 500、审计脱敏、队列归零、`candidate_dimension_scores` 行数不变、V31–V35 回归。 + +## 20. 回滚与兼容方案 + +- 不修改 V1–V35 表与语义；V36 迁移为附加新表 `V35__ability_assessment.sql`（当前最新 Flyway 为 V34，下一编号为 V35；功能版本仍标 V36）。 +- 回滚：删除 V36 迁移即可，不影响 V35 及既有数据。 +- 使用独立 `/abilities/**` 命名空间与独立 `ability_*` 表，回滚不会影响 V35 RIASEC。 + +--- + +## 21. 试测与上线声明 + +- 首版 48 题必须在后续试测中统计难度、选项分布与区分度；区分度低于 0.4 或存在明显歧义的题目应修改、停用或替换。 +- 当前未定义试测样本量和正式上线统计门槛，因此本版不得宣称题库已完成心理测量学验证。 +- 结果页必须声明：本测评反映当前工作情境答题表现，用于自我了解和能力提升参考；不构成职业资格、正式招聘结论或永久能力标签。 + +> 本设计已由负责人确认，可进入 V36 编码；试测统计口径为后续运营与题库质量治理工作，不阻塞本版实现。 diff --git a/docs/ability-question-bank-v0.1.json b/docs/ability-question-bank-v0.1.json new file mode 100644 index 0000000..e70f2da --- /dev/null +++ b/docs/ability-question-bank-v0.1.json @@ -0,0 +1,1064 @@ +{ + "bankCode": "WORKPLACE_ABILITY", + "bankVersion": "ability-v0.1", + "status": "LOCKED_FOR_IMPLEMENTATION", + "disclaimer": "本题库为自研工作情境题，用于自我了解和能力提升参考，不构成职业资格、正式招聘结论或永久能力标签。", + "questions": [ + { + "questionCode": "LO01", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "销售报表显示本月销售额增长20%，财务报表只增长8%。你首先会怎么处理？", + "options": [ + {"optionId": "A", "text": "核对两份报表的统计口径、时间范围和原始数据来源"}, + {"optionId": "B", "text": "先取两个增长率的平均值作为汇报结果"}, + {"optionId": "C", "text": "先使用财务报表，并注明另一份报表存在差异"}, + {"optionId": "D", "text": "采用增长率较高的报表，因为结果更积极"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 1, "C": 2, "D": 0}, + "explanation": "冲突数据应先统一口径并追溯原始来源。直接平均、择一或选择有利结果都会掩盖真正的数据问题。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 1 + }, + { + "questionCode": "LO02", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "一项新页面的转化率从10%升到18%，但目前只有20名访问者。你会如何判断效果？", + "options": [ + {"optionId": "A", "text": "立即宣布新页面显著优于旧页面"}, + {"optionId": "B", "text": "扩大样本并与同口径对照组比较后再判断"}, + {"optionId": "C", "text": "继续观察，同时先把18%作为确定结论汇报"}, + {"optionId": "D", "text": "说明样本较小，只能给出暂定趋势而非确定结论"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 1, "D": 2}, + "explanation": "小样本波动较大，应扩大样本并设置可比基线。仅提示不确定性有价值，但仍不足以验证变化是否来自页面本身。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 2 + }, + { + "questionCode": "LO03", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "两份分析报告得出相反结论。以下哪组核查顺序最合理？", + "options": [ + {"optionId": "A", "text": "比较结论→询问作者→补充少量数据→决定采用哪份"}, + {"optionId": "B", "text": "选择更新的报告→删除旧报告→通知相关人员→结束核查"}, + {"optionId": "C", "text": "统一指标定义→核对原始数据→比较分析方法→复算并形成结论"}, + {"optionId": "D", "text": "先复算结果→再确认口径→挑选更可信作者→形成结论"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "先统一定义，再核查数据和方法，最后复算，才能避免在不同口径上比较结论。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 3 + }, + { + "questionCode": "LO04", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "必须当天决定是否上线，但关键用户数据尚未收齐。你会怎么做？", + "options": [ + {"optionId": "A", "text": "直接按个人经验上线，后续再看结果"}, + {"optionId": "B", "text": "延期所有工作，直到全部信息完整"}, + {"optionId": "C", "text": "让职位最高的人直接给出判断"}, + {"optionId": "D", "text": "列明已知、未知和关键假设，选择可回滚的小范围方案并设置观察指标"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "信息不完整时应显式管理不确定性，并优先选择可回滚、可观察的决策，控制错误成本。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 4 + }, + { + "questionCode": "LO05", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "促销活动上线后订单增长了25%。如何判断增长是否主要由活动带来？", + "options": [ + {"optionId": "A", "text": "比较同期趋势、对照群体并排查价格和流量等同时变化因素"}, + {"optionId": "B", "text": "活动和增长同时发生，因此可以判断活动有效"}, + {"optionId": "C", "text": "查看几条参与活动用户的正面反馈"}, + {"optionId": "D", "text": "只比较活动前一天和活动后一天订单量"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "时间上的同时发生不等于因果关系。对照、趋势和混杂因素核查能更可靠地识别活动贡献。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 5 + }, + { + "questionCode": "LO06", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "系统发布新版本后出现大量错误。最合适的第一步是什么？", + "options": [ + {"optionId": "A", "text": "同时修改多个可疑模块，争取尽快碰到正确修复"}, + {"optionId": "B", "text": "先控制影响并保留日志，再对比发布前后变化定位原因"}, + {"optionId": "C", "text": "立即回滚，但不保留现场信息"}, + {"optionId": "D", "text": "等待更多用户反馈后再开始处理"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "先止损并保存证据，再围绕版本变化定位原因，既控制业务影响，也避免破坏根因分析条件。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 6 + }, + { + "questionCode": "LO07", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "数据显示加班时间越长的团队交付量越高。你会怎样解释？", + "options": [ + {"optionId": "A", "text": "说明加班一定能提升团队效率"}, + {"optionId": "B", "text": "建议所有团队立即增加加班时间"}, + {"optionId": "C", "text": "检查项目规模、人员数量和紧急程度等共同影响因素"}, + {"optionId": "D", "text": "先承认存在相关性，但暂不据此做因果决策"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "交付量和加班可能同时受到项目规模等因素影响。相关性需要结合混杂因素和对照数据解释。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 7 + }, + { + "questionCode": "LO08", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "你要验证“缩短注册表单能提高完成率”。哪组步骤最合理？", + "options": [ + {"optionId": "A", "text": "修改表单→全量上线→观察总注册量→询问用户感受"}, + {"optionId": "B", "text": "提出假设→直接上线→发现变化→补写指标定义"}, + {"optionId": "C", "text": "观察历史数据→修改多个流程→比较前后总量→形成结论"}, + {"optionId": "D", "text": "定义指标→设置随机对照→只改变表单长度→达到样本量后分析"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "明确指标、设置对照并控制唯一变量，是验证页面变化与转化率之间因果关系的基本路径。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 8 + }, + { + "questionCode": "LO09", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你收到“把这个页面做得更好用”的任务。首先应该做什么？", + "options": [ + {"optionId": "A", "text": "明确目标用户、具体场景、当前问题和验收标准"}, + {"optionId": "B", "text": "先按常见设计规范修改一版"}, + {"optionId": "C", "text": "只询问对方喜欢什么颜色和布局"}, + {"optionId": "D", "text": "等待对方给出完整解决方案"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "模糊需求应先转化为用户、场景、问题和验收条件，之后才能选择合适的实现方案。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 9 + }, + { + "questionCode": "LO10", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "面对一个复杂而陌生的问题，哪组处理顺序最合理？", + "options": [ + {"optionId": "A", "text": "寻找现成答案→直接实施→发现问题→再定义目标"}, + {"optionId": "B", "text": "明确目标→拆分子问题→确定输入输出→逐项验证并整合"}, + {"optionId": "C", "text": "先处理最熟悉部分→逐步扩大范围→最后确认是否解决目标"}, + {"optionId": "D", "text": "先写完整长方案→交给他人执行→根据反馈决定是否验证"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "复杂问题需要先明确目标，再拆解和定义验证条件，避免局部工作很多却没有解决核心问题。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 10 + }, + { + "questionCode": "LO11", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你提出的方案试运行后没有达到目标。下一步最合理的是？", + "options": [ + {"optionId": "A", "text": "继续扩大使用范围，以获得更多结果"}, + {"optionId": "B", "text": "认为执行人员没有严格遵循方案"}, + {"optionId": "C", "text": "对照预期与实际，检查假设、执行偏差和外部因素后再调整"}, + {"optionId": "D", "text": "先暂停扩大，并收集失败环节的数据"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "方案无效时需要同时检查假设、执行和环境，而不是只扩大范围或归责于某一方。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 11 + }, + { + "questionCode": "LO12", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "负责人要求估算一个尚未完全明确的任务工期。你会如何回答？", + "options": [ + {"optionId": "A", "text": "给出一个大致天数，并说明只是个人感觉"}, + {"optionId": "B", "text": "拒绝估算，等所有需求完全确定"}, + {"optionId": "C", "text": "参考类似任务，直接承诺相同工期"}, + {"optionId": "D", "text": "拆分已知范围，说明假设、区间、风险以及需要补充的信息"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "在不确定条件下，区间估算加上假设和风险说明，比伪精确承诺或完全拒绝估算更可执行。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 12 + }, + { + "questionCode": "CO01", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "对方提出一个比较模糊的合作需求。你首先会怎么回应？", + "options": [ + {"optionId": "A", "text": "用自己的话复述理解，并确认目标、对象、边界和优先级"}, + {"optionId": "B", "text": "根据过往经验直接开始准备方案"}, + {"optionId": "C", "text": "发送一份通用需求模板，请对方有空时补充"}, + {"optionId": "D", "text": "要求对方想清楚全部细节后再来沟通"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "复述与确认能够尽早暴露理解偏差，同时帮助双方把模糊表达转化为共同目标和边界。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 13 + }, + { + "questionCode": "CO02", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "同事正在说明一次工作失误及其困难。你最合适的做法是？", + "options": [ + {"optionId": "A", "text": "马上告诉对方正确做法，避免继续浪费时间"}, + {"optionId": "B", "text": "先听完并复述关键事实、影响和对方需要的支持"}, + {"optionId": "C", "text": "先听取主要内容，再提出自己的解决建议"}, + {"optionId": "D", "text": "保持沉默，让对方自己整理清楚"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "先完整理解事实和需求，再讨论方案，能避免把建议建立在错误假设上，也能降低对方的防御感。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 14 + }, + { + "questionCode": "CO03", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "三方对同一需求理解不同。哪组沟通顺序最合理？", + "options": [ + {"optionId": "A", "text": "各自发言→多数表决→记录结果→开始执行"}, + {"optionId": "B", "text": "负责人定调→其他人补充→形成文档→会后再澄清"}, + {"optionId": "C", "text": "分别复述理解→识别分歧点→对齐目标和证据→确认决定与责任"}, + {"optionId": "D", "text": "收集意见→整理共同点→由负责人决定→通知执行人员"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "先让各方显式表达理解，再定位分歧并对齐依据，才能形成真正一致且可执行的结论。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 15 + }, + { + "questionCode": "CO04", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "客户表达不满，但没有明确说明具体问题。你会怎么做？", + "options": [ + {"optionId": "A", "text": "先说明团队已经严格按流程完成工作"}, + {"optionId": "B", "text": "请客户提交正式投诉材料后再处理"}, + {"optionId": "C", "text": "直接提供补偿，尽快结束沟通"}, + {"optionId": "D", "text": "确认客户感受，再询问具体场景、期望和造成的影响"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "先确认感受并提取具体事实，有助于把情绪表达转化为可以处理的问题和期望。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 16 + }, + { + "questionCode": "CO05", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你需要向非技术同事解释一次系统故障。最合适的方式是？", + "options": [ + {"optionId": "A", "text": "先讲业务影响和处理进展，再用通俗类比说明原因并确认理解"}, + {"optionId": "B", "text": "完整说明技术栈、日志和异常调用链"}, + {"optionId": "C", "text": "只说系统有问题，修好后再通知"}, + {"optionId": "D", "text": "省略不确定性，给出一个肯定恢复时间"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "面向非技术对象应从其关心的影响和行动出发，用适当语言说明原因，同时保留必要的不确定性。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 17 + }, + { + "questionCode": "CO06", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "发送一条需要对方行动的重要工作消息，应该如何组织？", + "options": [ + {"optionId": "A", "text": "只写“请尽快处理”，减少阅读时间"}, + {"optionId": "B", "text": "说明背景、当前问题、所需行动、负责人和截止时间"}, + {"optionId": "C", "text": "先给结论和行动要求，再附上必要背景"}, + {"optionId": "D", "text": "把全部聊天记录转发过去，让对方自行理解"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "清晰的工作消息应让接收者迅速知道为什么、做什么、谁负责以及何时完成。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 18 + }, + { + "questionCode": "CO07", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你需要指出同事提交材料中的严重问题。怎样表达最有效？", + "options": [ + {"optionId": "A", "text": "直接说“你做事不够认真”"}, + {"optionId": "B", "text": "只修改材料，不再提及问题"}, + {"optionId": "C", "text": "描述具体问题、造成的影响、修改标准和可获得的支持"}, + {"optionId": "D", "text": "私下指出具体错误，并提醒以后注意"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "高质量反馈针对可观察行为和影响，并给出明确标准与支持，不把问题上升为人格评价。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 19 + }, + { + "questionCode": "CO08", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "汇报一个延期项目时，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "说明困难→解释原因→请求理解→承诺尽快完成"}, + {"optionId": "B", "text": "汇报已完成工作→省略延期风险→等待追问→再解释"}, + {"optionId": "C", "text": "说明延期→列出责任方→描述过程→等待负责人决定"}, + {"optionId": "D", "text": "先报结论和影响→说明原因与证据→给出方案→明确需要的决定"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "延期汇报应优先呈现事实和影响，再提供可验证原因、解决方案和明确决策请求。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 20 + }, + { + "questionCode": "CO09", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你与同事对方案选择意见相反。你会如何推进？", + "options": [ + {"optionId": "A", "text": "先确认共同目标，再区分事实与偏好，用统一标准比较方案"}, + {"optionId": "B", "text": "请更多同事投票，按人数决定"}, + {"optionId": "C", "text": "暂时接受对方方案，避免影响关系"}, + {"optionId": "D", "text": "重点证明自己的方案更专业"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "以共同目标和一致评价标准处理分歧，能够把立场冲突转化为可比较的方案决策。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 21 + }, + { + "questionCode": "CO10", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "跨团队依赖已经延期。哪种沟通方式最合理？", + "options": [ + {"optionId": "A", "text": "在公共群指出对方延期→要求承诺→抄送负责人→等待结果"}, + {"optionId": "B", "text": "确认事实和影响→了解阻塞→共同制定新节点→记录责任和升级条件"}, + {"optionId": "C", "text": "先私下询问进度→协商新时间→定期跟进"}, + {"optionId": "D", "text": "自行绕过依赖→完成后再告知对方"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "跨团队协作需要共同确认事实、阻塞和新承诺，并提前约定何时升级，避免指责或信息缺失。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 22 + }, + { + "questionCode": "CO11", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "同事临时要求你承担一项会影响原计划的工作。你会怎么回应？", + "options": [ + {"optionId": "A", "text": "直接答应，之后再想办法补原任务"}, + {"optionId": "B", "text": "直接拒绝，因为这不属于原计划"}, + {"optionId": "C", "text": "说明当前承诺和影响，确认优先级并提出替代时间或资源方案"}, + {"optionId": "D", "text": "先了解紧急程度，再决定是否帮助"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "边界沟通既要说明已有承诺，也要讨论优先级和替代方案，避免无条件接受或简单拒绝。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 23 + }, + { + "questionCode": "CO12", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你发现自己的表达让对方产生了误解。最合适的处理方式是？", + "options": [ + {"optionId": "A", "text": "详细解释当时为什么会那样表达"}, + {"optionId": "B", "text": "不再提及，避免让情况更尴尬"}, + {"optionId": "C", "text": "先做出对方希望的承诺，之后再调整"}, + {"optionId": "D", "text": "承认造成的影响，澄清真实意图并共同确认修正行动"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "修复误解应同时处理影响、意图和后续行动，而不是只解释动机或给出无法兑现的承诺。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 24 + }, + { + "questionCode": "EX01", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "三个任务都临近截止时间，但现有资源只能优先完成一个。你会怎么做？", + "options": [ + {"optionId": "A", "text": "按业务影响、紧急程度和依赖关系排序，并同步取舍方案"}, + {"optionId": "B", "text": "三个任务同时开始，尽量都推进一些"}, + {"optionId": "C", "text": "先完成最容易交付的任务"}, + {"optionId": "D", "text": "等待负责人主动指定优先级"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "资源冲突时应基于影响、时效和依赖做明确取舍，并让相关方及时知道后果和安排。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 25 + }, + { + "questionCode": "EX02", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "开始一个跨两周的新任务时，你首先会建立什么？", + "options": [ + {"optionId": "A", "text": "一份尽可能详细、覆盖所有可能情况的计划"}, + {"optionId": "B", "text": "明确交付结果、关键步骤、依赖、负责人和检查节点"}, + {"optionId": "C", "text": "先确定最终期限和几个主要步骤"}, + {"optionId": "D", "text": "先从最熟悉的部分开始，再逐步补计划"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "可执行计划要连接目标、步骤、依赖、责任与检查点，既能推进，也能尽早发现偏差。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 26 + }, + { + "questionCode": "EX03", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "需求范围比预计大，但截止日期没有变化。你会怎样处理？", + "options": [ + {"optionId": "A", "text": "保持原计划，靠加班完成新增范围"}, + {"optionId": "B", "text": "先完成原范围，新增部分到期后再解释"}, + {"optionId": "C", "text": "评估新增工作量和影响，提出范围、资源或时间的取舍方案"}, + {"optionId": "D", "text": "记录需求变化，并提醒负责人可能延期"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "范围、资源和时间相互制约。范围变化后应量化影响并推动明确取舍，而不是默默承担风险。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 27 + }, + { + "questionCode": "EX04", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "把一个目标转成可执行计划，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "列任务→安排人员→确定目标→检查结果"}, + {"optionId": "B", "text": "确定期限→开始执行→补充资源→最后验收"}, + {"optionId": "C", "text": "选择工具→分配任务→同步进度→根据结果调整目标"}, + {"optionId": "D", "text": "明确结果→拆分任务→识别依赖和风险→设置节点与验收标准"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "计划应从结果出发，再拆解任务、依赖、风险和验收节点，保证每一步都服务于最终目标。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 28 + }, + { + "questionCode": "EX05", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你发现一个依赖项可能导致项目延期。你会怎么管理这项风险？", + "options": [ + {"optionId": "A", "text": "记录触发条件、概率、影响、负责人和应对方案，并持续检查"}, + {"optionId": "B", "text": "在周会上提醒一次，让大家注意"}, + {"optionId": "C", "text": "先准备一个备用方案，但暂不告诉其他人"}, + {"optionId": "D", "text": "等风险真正发生后再处理，避免过度反应"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "风险管理需要可观察的触发条件、责任人和预案，并持续跟踪，而不只是一次提醒或被动等待。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 29 + }, + { + "questionCode": "EX06", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你的任务被另一个团队阻塞，且已经影响当前节点。你会怎么做？", + "options": [ + {"optionId": "A", "text": "绕开对方直接修改其负责内容"}, + {"optionId": "B", "text": "说明阻塞事实和影响，提出备选方案并约定升级时间"}, + {"optionId": "C", "text": "持续跟进对方进度，同时调整自己可先做的工作"}, + {"optionId": "D", "text": "记录阻塞，等负责人下次检查时再汇报"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "处理阻塞不仅要跟进，还要透明说明影响、准备替代路径并约定升级条件，防止风险继续扩大。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 30 + }, + { + "questionCode": "EX07", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "项目进度看似正常，但关键任务一直没有可验证产出。你会怎么处理？", + "options": [ + {"optionId": "A", "text": "继续相信负责人汇报，避免打断执行"}, + {"optionId": "B", "text": "增加每日进度汇报次数"}, + {"optionId": "C", "text": "把关键任务拆成可验收的小节点，用产出和风险重新评估进度"}, + {"optionId": "D", "text": "要求负责人尽快提供一个演示版本"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "进度应由可验证产出而非主观百分比衡量。拆成小节点可以提前暴露真实偏差和风险。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 31 + }, + { + "questionCode": "EX08", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "线上发生严重故障时，哪组执行顺序最合理？", + "options": [ + {"optionId": "A", "text": "查找根因→修改代码→通知用户→恢复服务"}, + {"optionId": "B", "text": "重启服务→观察结果→继续修改→故障后补记录"}, + {"optionId": "C", "text": "通知负责人→等待决定→组织排查→发布修复"}, + {"optionId": "D", "text": "控制影响→保留证据→同步状态→恢复服务→复盘根因"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "故障处置首先控制影响，同时保留分析证据并保持信息同步；恢复后再完成系统性根因复盘。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 32 + }, + { + "questionCode": "EX09", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "截止时间临近，但交付物仍存在质量风险。你会怎么处理？", + "options": [ + {"optionId": "A", "text": "识别关键质量门槛，缩小非核心范围，分阶段交付并同步风险"}, + {"optionId": "B", "text": "优先保证所有功能完成，测试可以之后补"}, + {"optionId": "C", "text": "继续优化细节，必要时到期后再解释"}, + {"optionId": "D", "text": "直接推迟交付，直到所有问题完全解决"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 0, "C": 1, "D": 2}, + "explanation": "临近截止时间应守住关键质量底线，并通过范围取舍和分阶段交付透明管理风险。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 33 + }, + { + "questionCode": "EX10", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "向他人交接一项进行中的任务，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "发送文件→说明截止日期→让对方有问题再问→退出任务"}, + {"optionId": "B", "text": "说明目标和现状→移交材料与风险→明确责任和节点→确认对方理解"}, + {"optionId": "C", "text": "口头说明主要事项→发送材料→约定一次后续检查"}, + {"optionId": "D", "text": "把任务重新做一遍→整理文件→通知对方结果"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "有效交接需要共同理解目标、现状、材料、风险、责任和检查节点，而不仅是发送文件。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 34 + }, + { + "questionCode": "EX11", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "任务完成后结果没有达到预期。最有价值的复盘方式是？", + "options": [ + {"optionId": "A", "text": "确定主要责任人并避免再次由其负责"}, + {"optionId": "B", "text": "记录最终结果，提醒团队以后更认真"}, + {"optionId": "C", "text": "比较目标与实际，分析过程证据，形成有负责人和期限的改进动作"}, + {"optionId": "D", "text": "讨论主要问题并总结经验，供下次参考"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "复盘的价值在于从证据中找到可改变因素，并把经验转成有负责人和期限的行动。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 35 + }, + { + "questionCode": "EX12", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "开发工作已经完成，怎样才算真正完成交付闭环？", + "options": [ + {"optionId": "A", "text": "代码已经合并，可以把任务标记完成"}, + {"optionId": "B", "text": "部署完成且没有立即出现错误"}, + {"optionId": "C", "text": "把剩余事项记录在自己的待办中"}, + {"optionId": "D", "text": "按验收标准确认结果，补齐文档、监控、交接和明确遗留项"} + ], + "answerKey": "D", + "scoringRule": {"A": 1, "B": 2, "C": 0, "D": 4}, + "explanation": "完成实现不等于完成交付；验收、文档、运行保障、交接和遗留事项都应形成闭环。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 36 + }, + { + "questionCode": "LE01", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "第一次接触一项工作需要的新工具时，你会怎么开始？", + "options": [ + {"optionId": "A", "text": "明确使用目标，阅读权威入门资料，完成小练习后应用到任务"}, + {"optionId": "B", "text": "先看几个热门视频，再边做边查"}, + {"optionId": "C", "text": "直接在正式任务中尝试，遇到问题再处理"}, + {"optionId": "D", "text": "请熟悉工具的同事替自己完成关键部分"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "目标、可靠资料、小范围练习和真实应用形成完整学习闭环，能兼顾效率和风险。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 37 + }, + { + "questionCode": "LE02", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "网上对同一技术方案存在互相矛盾的观点。你会怎样判断？", + "options": [ + {"optionId": "A", "text": "选择点赞和转发最多的观点"}, + {"optionId": "B", "text": "比较来源、发布时间、证据、适用条件，并做小范围验证"}, + {"optionId": "C", "text": "优先参考官方文档，再结合一项实践案例"}, + {"optionId": "D", "text": "选择与自己原有经验一致的观点"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "可靠判断既需要评价信息来源和适用条件，也需要在自己的场景中验证，而不能只看热度或偏好。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 38 + }, + { + "questionCode": "LE03", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "快速进入一个陌生业务领域，哪组学习顺序最合理？", + "options": [ + {"optionId": "A", "text": "收集大量资料→全部阅读→整理术语→开始参与工作"}, + {"optionId": "B", "text": "跟随一名同事→模仿做法→遇到问题再查资料→形成经验"}, + {"optionId": "C", "text": "明确任务问题→建立基础框架→结合案例实践→用反馈补齐知识"}, + {"optionId": "D", "text": "阅读概览→询问关键术语→尝试一项小任务→继续自学"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "围绕真实问题建立知识框架，再通过实践和反馈迭代，比无目标囤积资料更有效。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 39 + }, + { + "questionCode": "LE04", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你只有两小时了解一个新主题并给出初步建议。你会怎么安排？", + "options": [ + {"optionId": "A", "text": "尽量阅读更多文章，以覆盖所有观点"}, + {"optionId": "B", "text": "询问熟悉主题的人并直接采用其建议"}, + {"optionId": "C", "text": "先写出自己的看法，再搜索资料验证"}, + {"optionId": "D", "text": "明确输出问题，优先权威概览和关键证据，并标明未知与后续验证项"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "时间有限时，应围绕输出目标选择高价值信息，并明确区分结论、假设和待验证内容。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 40 + }, + { + "questionCode": "LE05", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你收到“方案不够清晰”的反馈。最有效的回应是？", + "options": [ + {"optionId": "A", "text": "请对方指出具体难以理解之处，修改后再次确认是否解决"}, + {"optionId": "B", "text": "详细解释自己当时的设计思路"}, + {"optionId": "C", "text": "接受反馈，并在下一次方案中注意"}, + {"optionId": "D", "text": "找其他同事判断这条反馈是否合理"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "将模糊反馈转化为具体例子，并通过修改后的再次验证，才能真正形成可观察的学习改进。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 41 + }, + { + "questionCode": "LE06", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "一次重要尝试失败后，你最应该优先做什么？", + "options": [ + {"optionId": "A", "text": "立即换一种完全不同的方法重新尝试"}, + {"optionId": "B", "text": "还原目标、过程和关键决策，区分假设错误、执行偏差与外部因素"}, + {"optionId": "C", "text": "先记录失败现象和可能原因，再选择一个方向验证"}, + {"optionId": "D", "text": "等待更多类似失败出现后一起复盘"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "有效复盘需要还原过程并区分不同原因类型，避免在没有证据时只更换方法或延后学习。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 42 + }, + { + "questionCode": "LE07", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "怎样最能验证自己真正掌握了一项新知识？", + "options": [ + {"optionId": "A", "text": "能够完整复述资料中的定义"}, + {"optionId": "B", "text": "完成课程并通过课程自带的小测"}, + {"optionId": "C", "text": "能用自己的话解释、应用到新问题，并根据结果修正理解"}, + {"optionId": "D", "text": "尝试向别人讲解，并接受对方提问"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "真正掌握不仅是记忆，还包括解释、迁移、实践和基于结果修正认知。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 43 + }, + { + "questionCode": "LE08", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "根据反馈持续改进一项技能，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "收集反馈→一次修改全部问题→长期练习→最终检查"}, + {"optionId": "B", "text": "确定目标→大量练习→请人评价→记录结果"}, + {"optionId": "C", "text": "模仿优秀示例→反复练习→比较差距→继续模仿"}, + {"optionId": "D", "text": "设定具体目标→刻意练习→获得反馈→调整方法并再次验证"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "学习闭环应围绕具体目标，通过练习、反馈、调整和再验证不断缩小差距。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 44 + }, + { + "questionCode": "LE09", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "学会一种分析方法后，你遇到一个相似但条件不同的新问题。你会怎么做？", + "options": [ + {"optionId": "A", "text": "识别共同原理和条件差异，调整方法并用结果验证"}, + {"optionId": "B", "text": "先按原步骤完整执行，再根据结果修改"}, + {"optionId": "C", "text": "重新寻找专门针对新问题的现成方法"}, + {"optionId": "D", "text": "认为条件不同，原方法没有参考价值"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "知识迁移的关键是识别稳定原理与变化条件，并通过调整和验证把旧知识应用到新场景。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 45 + }, + { + "questionCode": "LE10", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你遇到一个自己长时间无法解决的问题，需要向同事求助。怎样提问最有效？", + "options": [ + {"optionId": "A", "text": "把全部材料发给对方，请对方帮忙看看"}, + {"optionId": "B", "text": "说明目标、现象、已尝试方法、当前判断和希望获得的帮助"}, + {"optionId": "C", "text": "整理出最小问题、错误信息和已排除项后提问"}, + {"optionId": "D", "text": "直接请对方演示正确做法，自己跟着学习"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "高质量求助能让对方快速理解上下文，也暴露自己的思考过程，从而获得可迁移的指导而非代做。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 46 + }, + { + "questionCode": "LE11", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你熟悉的工具即将停止维护，团队需要迁移到新工具。你会怎么应对？", + "options": [ + {"optionId": "A", "text": "继续使用旧工具，直到它真正无法运行"}, + {"optionId": "B", "text": "立即把所有工作迁移到最热门的新工具"}, + {"optionId": "C", "text": "比较需求和迁移成本，做小范围验证，形成学习与分阶段迁移计划"}, + {"optionId": "D", "text": "先试用几个候选工具并记录主要差异"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "面对变化应结合实际需求、成本和验证结果规划迁移，同时安排学习，避免被动拖延或盲目追新。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 47 + }, + { + "questionCode": "LE12", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "制定一项与目标岗位相关的学习计划，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "购买课程→安排时间→完成课程→更新简历"}, + {"optionId": "B", "text": "收集热门技能→选择感兴趣内容→集中学习→寻找应用机会"}, + {"optionId": "C", "text": "参考他人路线→复制学习清单→定期检查完成量→继续补课"}, + {"optionId": "D", "text": "分析岗位要求和当前差距→设定可验证目标→练习应用→根据反馈调整"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "有效学习计划从真实目标和差距出发，用可验证练习和反馈调整方向，而不是以课程数量衡量成长。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 48 + } + ] +} diff --git a/docs/acceptance-week1.md b/docs/acceptance-week1.md index 14e6355..09a0544 100644 --- a/docs/acceptance-week1.md +++ b/docs/acceptance-week1.md @@ -91,7 +91,7 @@ curl http://localhost:8080/api/v1/info # 发送验证码 curl -X POST "http://localhost:8080/api/v1/auth/sms/send?phone=13800000001&purpose=login" -# Mock 登录（从日志获取验证码） +# Mock 登录（验证码不输出到日志；本地按 docs/frontend-integration.md §3 受控取得） curl -X POST http://localhost:8080/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"phone":"13800000001","code":"<验证码>"}' @@ -145,11 +145,11 @@ mvn spring-boot:run -Dspring-boot.run.profiles=dev \ | STUDENT | 13800000002 | 学生测试 | | COMPANY | 13800000003 | 企业测试 | -> 注: 使用 Mock 短信验证码登录，验证码从应用日志中获取 +> 注: 使用 Mock 短信验证码登录。应用日志**不再输出验证码**，本地按 `docs/frontend-integration.md` §3 的受控方式取得（需 `SMS_MOCK_ENABLED=true` 且 `ALLOW_TEST_OTP_DB_READ=true`）；生产环境禁止查询验证码表。 ## 已知限制 -1. **短信验证码 Mock**: 验证码打印到日志，不发送真实短信 +1. **短信验证码 Mock**: 应用日志**不输出验证码**，不发送真实短信；本地取码见 `docs/frontend-integration.md` §3（验证码当前仍为数据库明文存储） 2. **业务模块**: 岗位、投递、聊天、评分等模块仅定义接口骨架 3. **RabbitMQ 监听**: 队列已定义但未实现消费者（Week 2+） 4. **Actuator 健康**: RabbitMQ 健康检查未配置（仅 ping） diff --git a/docs/account-deletion-test-isolation-fix-20260917.md b/docs/account-deletion-test-isolation-fix-20260917.md new file mode 100644 index 0000000..b4dcbb9 --- /dev/null +++ b/docs/account-deletion-test-isolation-fix-20260917.md @@ -0,0 +1,161 @@ +# 账号注销测试夹具隔离修复报告 + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +基线 HEAD：`d5c37128e84b4fc83bf5334254dd8efeb88ccf64` +性质：**纯测试修复** —— 生产代码、Flyway、配置与接口零改动 + +--- + +## 1. 结论 + +> `AccountDeletionControllerTest` 与关联测试组合的**既有交叉污染已消除**；修复后两种执行顺序各 5 次全部 F=0 / E=0 / S=0。 + +--- + +## 2. 稳定复现（修复前） + +**致冲突组合**（连续运行 5 次，**5/5 稳定复现**）： + +``` +mvn -Dtest="*Deletion*Test,*Verification*Test,*Risk*Test,*Report*Test,*Block*Test, + *Notification*Test,*Recommendation*Test,*RequestContext*Test,*RequestId*Test" test +``` + +5 次运行**全部**失败于同一位置： + +``` +AccountDeletionControllerTest.lazyTransition_firstGet_returnsCompleted_andConsistent:228 + -> createUser:75 +DataIntegrityViolation: Unique index or primary key violation: + USERS(PHONE) = '930000000' +``` + +### 诊断结论（逐项回答） + +| 问题 | 结论 | +|---|---| +| **谁先插入 `phone='930000000'`** | `com.mydreamjob.common.logging.RequestContextMigrationIntegrationTest`（**HEAD 既有类**）。其 `@BeforeEach` 用 `AtomicLong(930_000_000L)` 创建 user | +| **冲突发生在哪个方法** | `AccountDeletionControllerTest#createUser:75`（由 `lazyTransition_firstGet_returnsCompleted_andConsistent:228` 调用） | +| **共享 H2 数据库名** | `integrationdb`（`jdbc:h2:mem:integrationdb;MODE=MySQL;DB_CLOSE_DELAY=-1`）—— 同一 JVM 内所有 `@SpringBootTest` 共享 | +| **static 计数器何时重置** | **不重置** —— `PHONE` 为 per-class static，类加载时初始化为 `930_000_000`；冲突**不是**计数器重置所致，而是**号段被残留记录占用** | +| **未清理的记录** | `users`（`phone=930000000`）；`user_roles` 随 users 级联删除 | + +### 根因链 + +1. **号段撞车**：`common/logging/RequestContextMigrationIntegrationTest` 与 `deletion/AccountDeletionControllerTest` **都使用基数 `930_000_000`** +2. **污染源不清理**：前者 `@AfterEach` 只清 `RequestContextProbe` 与 `MDC`，**不删 users** → 每个测试方法残留 1 条 `930000000+N` +3. **受害者删除失败**：后者的 `@AfterEach` 用 `userRepository.deleteAll()`（**全表删除**），会因**其他测试类残留 user**（被 `notifications`/`offers`/`resume_versions` 等**无 CASCADE** 的外键引用）而失败 → 自身 user 也未删净 +4. **执行顺序**：诊断运行中 `common.logging.RequestContextMigrationIntegrationTest` 排在第 **6** 位、`AccountDeletionControllerTest` 排在第 **13** 位 → 前者残留必然影响后者 + +### 与 A2/A3 的关系（如实记录） + +A2/A3 新建的测试类**均不创建 user**，故**无污染**： +- `common/r01a2/RequestContextMigrationIntegrationTest`：无 `AtomicLong`、无 `userRepository` 注入 +- A3 的三个测试类：均使用 `@MockBean UserRepository`（不实际写库） + +**该缺陷完全存在于基线**（污染源文件为 HEAD 既有），与 A2/A3 无关；此前用 HEAD 隔离 worktree 的归因结论**正确**。 + +> 同号段还有 `candidatescore/CandidateScoringClockBoundaryIntegrationTest`，但其标注 `@Transactional`（每方法自动回滚）→ **不残留**，无风险。 + +--- + +## 3. 修复内容 + +### 3.1 `common/logging/RequestContextMigrationIntegrationTest.java`（污染源） + +| 改动 | 内容 | +|---|---| +| 号段独占 | `930_000_000L` → **`986_000_000L`**（已确认全仓未占用） | +| **清理** | `@AfterEach` 增加：按自身 `studentId` **精确删除**本测试创建的 user（`findById(...).ifPresent(delete)`），并补 javadoc 说明隔离原因 | + +### 3.2 `deletion/AccountDeletionControllerTest.java`（受害者） + +| 改动 | 内容 | +|---|---| +| 号段独占 | `930_000_000L` → **`987_000_000L`**（已确认全仓未占用） | +| 记录归属 | 新增 `List createdUserIds`，`createUser()` 登记每个自建 userId | +| **精确清理** | `@AfterEach` 由 `deleteAll()`（整表）改为**按本测试记录**删除：`account_deletions`（按 userId）→ `users`（级联 `user_roles`），各步 `flush()`，遵循外键顺序；`@BeforeEach` 清空记录 | +| **防掩盖断言** | `createUser()` 内先断言该号在共享库中**不存在**，存在即抛出可读错误（暴露上轮清理失效），而不是被唯一键异常吞掉 | + +**未使用**：未改唯一约束、未捕获忽略 `DataIntegrityViolationException`、未用 `@DirtiesContext`、未清空整表、未 `DELETE FROM users` 无条件删除、未 sleep、未放宽任何业务断言、未依赖测试执行顺序。 + +### 3.3 新增反证测试 `deletion/AccountDeletionFixtureIsolationTest.java`（5 例） + +| 反证 | 断言 | +|---|---| +| 1 | 同一 Spring 上下文内连续创建 5 个夹具**不冲突**且 ID 不重复 | +| 2 | 注销记录写入后，按本测试路径清理 → `account_deletions` / `users` / `user_roles` 残留**均为 0** | +| 3 | **变异探测**：预置同号记录（等价于"上轮未清理"）→ 防掩盖断言**必须失败**并检出该号，证明残留不会被静默吞掉 | +| 4 | 独占号段 `987_000_000` 在测试开始前为空（不与任何他类重叠） | +| 5 | 清理**精确到本测试记录**：预置的"他类"记录必须保留，证明不是整表删除 | + +--- + +## 4. 验证结果 + +### 4.1 两种执行顺序各 5 次 + +| | 组合 | 结果（5 次） | +|---|---|---| +| 顺序 A | `*Deletion*Test,*RequestContext*Test,*RequestId*Test` | **95/95，F=0 E=0 S=0** ×5 ✔ | +| 顺序 B | `*RequestContext*Test,*Deletion*Test,*RequestId*Test` | **95/95，F=0 E=0 S=0** ×5 ✔ | + +（修复前该组合稳定失败 5/5；修复后 10/10 全绿） + +### 4.2 单类与反证 + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="AccountDeletionControllerTest" test` | **14 / 14** ✔ | +| `mvn -Dtest="AccountDeletionFixtureIsolationTest,AccountDeletionControllerTest" test` | **19 / 19**（5 反证 + 14 原）✔ | + +### 4.3 全量 + +| 命令 | 结果 | +|---|---| +| `mvn clean verify` | **2225 / 2225**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS（≥ 2220 ✔） | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed ✔ | + +较修复前（2220）新增 **5** 个测试，全部为反证测试。 + +### 4.4 边界核验 + +| 项 | 结果 | +|---|---| +| 生产源码 `git diff --stat -- src/main/` | **空**（零改动）✔ | +| V1–V45 迁移 | **零修改** ✔ | +| Flyway / 配置 / 接口 | 零改动 ✔ | +| `GlobalExceptionHandler.java` | 仍为工作区 stat 标记（内容零差异），**未处理** ✔ | +| Docker | 未操作 ✔ | +| 是否进入 A4 | 否 ✔ | + +--- + +## 5. 精确修改文件 + +``` +修改（2） + mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestContextMigrationIntegrationTest.java + mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionControllerTest.java + +新增（1） + mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionFixtureIsolationTest.java + +文档（1） + docs/account-deletion-test-isolation-fix-20260917.md +``` + +--- + +## 6. 提交 + +``` +提交信息：test: isolate account deletion controller fixtures +``` + +（精确暂存上述测试文件与报告，敏感扫描后独立提交；推送当前 R01 功能分支） + +--- + +> 账号注销测试夹具隔离修复完成；测试交叉污染已消除，生产代码零改动。 diff --git a/docs/api-v0.1.md b/docs/api-v0.1.md index 2eecb67..4f9abbd 100644 --- a/docs/api-v0.1.md +++ b/docs/api-v0.1.md @@ -24,7 +24,7 @@ Query: phone=13800000001, purpose=login **限制:** - 60秒内同一手机号只能发送1次 - 5次错误后锁定5分钟 -- Mock环境验证码打印到日志 +- Mock 环境验证码**不输出到日志**；本地按 `docs/frontend-integration.md` §3 的受控方式取得（生产禁止查表） ### 2. Mock 登录 ``` @@ -169,12 +169,65 @@ http://localhost:8080/swagger-ui.html http://localhost:8080/v3/api-docs ``` -## 已知限制 (Week 1) +### 4. 刷新 Token（S02） -1. 短信验证码为 Mock 实现，验证码打印到日志，不发送真实短信 +``` +POST /api/v1/auth/refresh +Content-Type: application/json + +{ "refreshToken": "" } +``` + +- 匿名可调用；是否成功取决于 Refresh Token 校验结果。 +- **只接受 Refresh Token**；把 Access Token 传进来一律 401。 +- 请求体只允许 `refreshToken` 一个字段；Token 不接受 query/path 参数。 +- 成功后返回新的 Token 对，**旧 Refresh Token 立即失效**（强制轮换）。 +- 已消费/已撤销的 Refresh Token 再次提交 → 401，并撤销该登录会话（重放处置）。 +- 失败响应不说明 Token 是"不存在""已消费"还是"已撤销"。 + +**成功响应:** +```json +{ + "code": 200, + "data": { + "accessToken": "eyJhbGciOi...", + "refreshToken": "eyJhbGciOi...", + "expiresIn": 86400 + }, + "requestId": "" +} +``` + +### 5. 登出（S02） + +``` +POST /api/v1/auth/logout +Authorization: Bearer +``` + +- 必须已认证；**无请求体**。 +- 身份与会话来自 Access Token，不接受客户端传入 `userId`/`sessionId`/`refreshToken`。 +- 只撤销**当前登录会话**，其他设备会话不受影响。 +- 重复登出按幂等处理；成功响应不包含任何 Token。 + +## Token 与会话模型（S02） + +| Token | 用途 | 说明 | +|---|---|---| +| Access Token | 普通业务接口的 `Authorization` 头 | 带 `type=access`，有效期 24h；每次请求都会校验服务端会话状态 | +| Refresh Token | 仅用于 `POST /auth/refresh` | 带 `type=refresh`，有效期 7 天；不落库，数据库只保存其 HMAC-SHA256 摘要 | + +- Access 与 Refresh **使用不同签名密钥**，交叉验签必然失败。 +- 每次登录创建独立的**登录会话**（`sessionId`）；同一用户可同时存在多个会话。 +- 登出只撤销当前会话；账号注销完成、用户禁用会撤销该用户**全部会话**。 +- 本版**不再兼容**无 `type` 的旧 Token（所有旧 Token 失效，用户需重新登录一次）。 +- Token 原文不进入数据库、日志、审计、URL 或错误响应。 + +## 已知限制 + +1. 短信验证码为 Mock 实现，应用日志**不输出验证码**，不发送真实短信；未接入真实供应商时发码返回“服务不可用” 2. 无企业注册/认证流程 -3. 无岗位、投递、聊天、评分等业务功能 -4. 无 Token 刷新接口（Week 2+） -5. 无密码修改/重置功能 -6. RabbitMQ 未实现消息监听器（仅队列定义） -7. Actuator 健康检查部分依赖（Redis/RabbitMQ）在未启动时返回 DOWN +3. 无密码修改/重置功能 +4. 未提供查看全部登录设备、远程踢出单个设备、Token introspection 等接口 +5. RabbitMQ 未实现消息监听器（仅队列定义） +6. Actuator 健康检查部分依赖（Redis/RabbitMQ）在未启动时返回 DOWN diff --git a/docs/backend-development-roadmap.md b/docs/backend-development-roadmap.md index dcbfbb4..379ae69 100644 --- a/docs/backend-development-roadmap.md +++ b/docs/backend-development-roadmap.md @@ -1,4 +1,30 @@ -# 职来后端后续开发规划与 Figma 差距修复方案 +# 职来后端一期交付路线图 + +> 当前范围冻结：2026-09-08。当前一期范围、需求、代码入口、验收及责任的唯一明细为 [一期范围与验收清单](phase1-scope-and-acceptance.md)。下方历史规划不再用于判断当前待办或批准新接口/迁移。 + +## 当前交付状态（覆盖历史描述） + +| 范围 | 2026-09-08核对结果 | 下一动作 | +|---|---|---| +| 核心招聘与账户能力 | 已有代码与历史验收记录；本轮未重跑验收 | 按清单C01–C08做一期集成回归 | +| V39–V42 | 已核对提交55e3975、2698d06、5cc2c86、96b3113；不再标为待Git检查点 | 保留回归，不重复开发企业回复/发现/邀约 | +| V43 | 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（cf39737） | N01 已关闭版本内小样本补集泄露；30/300/3000 查询预算通过，EXPLAIN 扩容风险保留观察 | +| 评分规则解释与合理性 | N02 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（dbd27e6） | 保持分数、权重、排名和企业评分契约不变 | +| 消息撤回与会话一致性 | N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收 | 两分钟窗口、发送者权限、正文覆盖、幂等并发、DIRECT/邀约隐私均已锁定 | +| S01 认证安全整改 | 独立代码复验与真实 MySQL/Docker 黑盒全部通过（`b5084fd`） | 保持验证码受控取码、双开关与 `/jobs` 认证边界不变 | +| S02 Access/Refresh Token 隔离 | 已实现并完成自动化验证与干净构建，待独立代码复验及真实 MySQL/Docker 黑盒验收 | 类型隔离、独立密钥、轮换、重放处置、会话吊销已锁定；OpenAPI 175/213 | +| S03 生产配置与简历隐私 | 已实现并完成自动化验证与干净构建，待独立代码复验及真实 MySQL/Docker 黑盒验收 | V43 禁用原始指纹种子账号；管理员初始化默认关闭且幂等；企业简历下载按隐私决策表授权；Actuator 隔离到管理端口；OpenAPI 176/214 | +| Q01 岗位搜索真实查询覆盖（C02 证据补充） | 已完成实现、跨库一致性整改、独立复验及 Git 检查点（`77dc624`）。新增 54 条真实库测试：H2 Repository 21、H2 Service 9、H2 副作用 4、MySQL 8.4 Specification 15、MySQL 副作用 4、MySQL EXPLAIN 1；全量 1890/1890 | OpenAPI 保持 176/214；前导通配符、filesort 与真实规模执行计划移交 R01 | +| R01 结构与性能收束 | R01-A `0b5b849`、R01-B `15bd98b`、R01-C `b68519e`、R01-D1 `cf0c71e`、R01-D2 `8c40fd4` 已建本地检查点；**R01-D3 已完成**会话列表未读数 N+1 收束；**R01-D4 已冻结并推送**（提交 `52c8026`，远端 `origin/refactor/r01-structure-performance`）；**R01-A2 请求身份与 requestId 收束（第二批 8 个 Controller）已完成独立复验、提交并推送**（提交 `72b82a3`）；**R01-A3（第三批 8 个 Controller）已完成独立复验、提交并推送**（提交 `d5c3712`）；**账号注销测试夹具隔离修复已提交并推送**（提交 `35baa84`）；**R01-A4（第四批 8 个 Controller）已完成实施、独立复验、提交并推送**（提交 `0226977`）；**R01-A5（第五批 8 个 Controller）已完成独立复验、提交并推送**（提交 `534afe68`）；**R01-A6（最终批 5 个 Controller）已完成实施与独立复验**（实施报告 `docs/r01-a6-final-request-context-migration-report.md`；独立复验报告 `docs/r01-a6-independent-verification-20260917.md`）。**请求上下文收束 A 系列到此结束，不再拆分 A7/A8**；下一阶段为 R01-B。历史 R01-D4 迁移方案见 `docs/r01-d4-get-scoring-snapshot-migration-design.md` | R01-D4：三 GET 评分接口已停写快照，改为写侧登记 + 后台 Worker + 补偿扫描物化，V44/V45 已并入真实 MySQL；claim fence 采用不可复用 claim token（V45）。**R01-A2 至 A6 共迁移 37 个 Controller**（A2–A5 各 8 个 + A6 5 个），身份与 requestId 统一到 CurrentUserAccessor / RequestIdAccessor，非法主体由「400/500」统一为 401；角色、归属与 403/404 契约未变。A2–A5 各删除 **16 个**私有解析方法，A6 删除 **6 个**。**请求上下文收束终态：业务 Controller 身份解析 0、requestId 重复解析 0**；剩余命中仅为基础设施（身份 3 文件：CurrentUserAccessor / JwtAuthenticationFilter / DeletionGuardInterceptor；requestId 5 文件：AuditContext / GlobalExceptionHandler / RequestIdAccessor / RequestLoggingFilter / DeletionGuardInterceptor），**A7/A8 不再设置**。**A6 后夹具问题已关闭**：`FairnessMonitoringControllerTest` 曾用 `userId = 1/2` 与 V1_1 种子账号（被 V43 置为 inactive）冲突而在单跑时全部 401，已改为独占用户（`9_310_001/2`）并按精确 ID 清理，单跑稳定通过；新增反证测试 `FairnessMonitoringFixtureIsolationTest`（**已提交并推送，提交 `84fe9f5`**；报告 `docs/r01-a6-fairness-fixture-isolation-fix-20260917.md`）。**R01-B 角色授权与异常映射收束已完成独立复验、提交并推送**（提交 `70b9e10`；两个 Controller 测试夹具缺陷已由独立纯测试提交 `9954600` 修复，报告 `docs/r01-b-authorization-exception-mapping-report.md`、`docs/r01-b-independent-verification-20260918.md`）：新增 `security/UserRoleGuard` 与 `common/exception/ErrorHttpStatusRegistry`，54 个调用点改走公共 guard，GlobalExceptionHandler 不再持有映射表。**R01-C 评分与推荐规则结构收束已实施完成，待独立代码复验**（报告 `docs/r01-c-scoring-recommendation-rules-refactor-report.md`）：overviewStatus 经核验已是唯一实现（由 `b68519e` 完成）；`JobRecommendationService.preferenceScore()` 已是编排方法；本轮新增 `candidatescore/rules/CandidateScoringRuleSet`（版本化强类型规则源，高校名单/阈值/权重），并把 `TalentDiscoveryService` 内联的第二套 30/20/20/15/15 偏好规则收束到 `JobPreferenceScoreCalculator`（规则实现处 2 → 1）。**评分/Fairness 组合测试污染已关闭**：`CandidateScoring*` 中 5 个测试类以当前 period 物化快照且未清理自有 userId，污染了 `FairnessMonitoringHttpIntegrationTest` 的 `populationSize`（+15 精确组成为 3+2+1+1+8）；已按行级快照实测逐类归因并精确清理（5 个候选类经证明零残留未改），新增隔离门禁 `R01CScoringFixtureIsolationGateTest`；`*CandidateScoring*Test,*Fairness*Test` 双向顺序各 3 次均 260/260，生产代码 diff = 0（报告 `docs/r01-c-fairness-fixture-isolation-fix-20260918.md`）；下一阶段为 R01-E | +| 其余五个功能组 | 技能词云、入职清单/公司知识、薪资计算器/参考、诚信积分/激励、简历查重 | N03–N06、N08仍属一期，细节设计后编码 | +| 上线保障 | 现有资产待逐项核验 | G01–G04，一期交付门槛 | +| 后续候选池 | AI简历、AI模拟面试/预测、SHAP高级解释等 | 以清单第6节为准，移出一期 | + +当前代码静态OpenAPI记录为172 paths/210 operations；已交付V42基线为167/205。最新迁移仍为V40，V43不新增迁移。此前1514测试通过属于历史执行记录，不能替代本轮验收。职责：张顺主责N01/N02/N07/N08与业务验收，小刘主责N03–N06与交付环境，互相独立复核。 + +正式路线图只维护此处；`mydreamjob-server/docs/backend-development-roadmap.md`仅为跳转页。八个新增/待闭环功能组加四个交付工作包详见新清单，不以历史“P2/后置”建议将用户本轮确认的功能排除一期。 + +## 历史规划存档（原文保留，以下状态、建议编号与范围均非当前依据） > 文档状态：已确认，作为后续开发排期依据 > @@ -26,21 +52,23 @@ | 项目 | 当前状态 | |---|---| -| OpenAPI | **139 paths、178 operations**（N05 新增 4 paths / 6 operations） | -| Flyway | **V1–V41** 已存在（N04 新增 V38–V39；N05 新增 V40–V41） | -| 全量测试 | **1516 个执行：1505 通过、2 失败、9 错误**；失败仍集中在既有 CareerProgress、JobReviewDimension、LocalResumeStorage 测试，薪资专项 24/24 通过 | -| 已完成范围 | V24 Candidate Scoring、V25 Governance、V26 Offer Advance、V27 Privacy、V28/V29 Account Deletion、V30 Data Export、V31 Interview Score、V32 Competition Ranking、V33 Report/Block、V34 统一求职进度聚合，N04 入职清单与公司知识介绍，以及 N05 薪资计算器与历史记录；另含认证、资料、岗位、投递、面试、Offer、看板等核心闭环 | -| 当前结论 | N05 薪资计算器已完成代码、24/24 专项测试、OpenAPI/文档更新和一次性 Docker MySQL 黑盒验收；全量测试仍受既有非薪资模块失败阻塞，N04 仍待真实 MySQL/Docker 验收 | +| OpenAPI | **167 paths、205 operations**（V42 静态、运行时与校验脚本已对账） | +| Flyway | **V1–V40 已成功执行**；V40 为企业人才邀约迁移（功能版本 V42，H2 与真实 MySQL 8.4 均已验证） | +| 全量测试 | V42 全量自动化测试 **1475/1475** 通过；真实 MySQL/Docker 黑盒 `PASS=76/FAIL=0`（含单岗位每日 20 次与公司每日 100 次限额） | +| 已完成范围 | V24 Candidate Scoring、V25 Governance、V26 Offer Advance、V27 Privacy、V28/V29 Account Deletion、V30 Data Export、V31 Interview Score、V32 Competition Ranking、V33 Report/Block、V34 统一求职进度聚合、**V35 RIASEC 职业兴趣测评（Flyway V34，已真实验收）**、**V36 四维能力测评（Flyway V35）**、**V37 防刷风险概览与运营规则配置（Flyway V36）**、**V38 四维能力测评有限接入候选评分（无新 Flyway、无新公网接口）**，及认证、资料、岗位、投递、面试、Offer、看板等核心闭环 | +| 当前结论 | V35–V41 的既有验收结论保持不变。**V42 企业人才邀约与授权沟通已完成代码、自动化测试、静态/运行时 OpenAPI 对账与真实 MySQL/Docker 黑盒验收，待 Git 检查点。** 当前 OpenAPI 为 167/205。 | | 本规划范围 | 代码修复、新功能开发、接口契约、数据权限和治理能力 | ### 2.0 模块状态分类 | 类别 | 模块 | |---|---| -| 已完成并已验收 | V24 Candidate Scoring、V25 Governance、V26 Offer Advance、V27 Privacy、V28/V29 Account Deletion、V30 Data Export、V31 Interview Score、V32 Competition Ranking、V33 Report/Block、V34 统一求职进度聚合、N05 薪资计算器（一次性 Docker MySQL 黑盒通过） | -| 已完成、待真实 MySQL/Docker 验收 | N04 入职清单与公司知识介绍（V38/V39，9 个接口；专项测试 96/96） | -| 已设计未编码 | 测评系统（Holland／能力测评）、公平性检测、SHAP／规则解释、防刷审计、企业评价管理、企业人才推荐 | -| 未开始 | AI 简历诊断／优化、AI 模拟面试、行业技能词云、诚信积分、消息撤回 | +| 已完成并已验收 | V24 Candidate Scoring、V25 Governance、V26 Offer Advance、V27 Privacy、V28/V29 Account Deletion、V30 Data Export、V31 Interview Score、V32 Competition Ranking、V33 Report/Block、V34 统一求职进度聚合、**V35 RIASEC 职业兴趣测评（Flyway V34，PASS=39/FAIL=0/SKIP=1）**、**V36 四维能力测评（Flyway V35，PASS=93/FAIL=0/SKIP=0）**、**V37 防刷风险概览与运营规则配置（Flyway V36，PASS=76/FAIL=0/SKIP=0）**、**V38 四维能力测评有限接入候选评分（无新 Flyway/公网接口，真实 MySQL/Docker 关键黑盒通过，待 Git 检查点）**、**V39 测评驱动岗位推荐（Flyway V37，真实 MySQL/Docker 关键黑盒通过，待 Git 检查点）** | +| 已完成、待真实 MySQL/Docker 复验 | — | +| 真实黑盒已验收、待 Git 检查点 | **V40 企业评价管理与官方回复（Flyway V38，5 paths / 6 operations，PASS=62/FAIL=0/SKIP=0）**；**V41 企业人才发现推荐（Flyway V39，2 paths / 3 operations，PASS=37/FAIL=0）**；**V42 企业人才邀约与授权沟通（Flyway V40，6 paths / 6 operations，PASS=76/FAIL=0；不写 candidate_dimension_scores）** | +| 自动化完成、待真实黑盒 | 无 | +| 已设计未编码 | 公平性检测、SHAP／规则解释、企业人才推荐 | +| 未开始 | AI 简历诊断／优化、AI 模拟面试、行业技能词云、入职准备清单、薪资计算器、诚信积分、消息撤回 | ### 2.1 已确认的产品决策 @@ -76,10 +104,7 @@ - 简历版本管理和简历导出； - 求职者评分卡； - Candidate Scoring Engine； -- 评分申诉、审核和回滚； -- 入职清单：通用项与企业自定义项合并、个人完成状态和完成率； -- 公司知识介绍：企业资料、企业知识内容和公开评价摘要； -- 薪资计算器：城市政策、用户覆盖参数、到手工资估算和历史快照。 +- 评分申诉、审核和回滚。 ### 3.2 企业端 @@ -92,9 +117,7 @@ - Offer 管理； - 面试管理； - 评价审核基础能力； -- 双向匹配、通知和直聊； -- 本企业入职清单自定义项管理； -- 本企业公司知识内容维护。 +- 双向匹配、通知和直聊。 ## 4. Figma 与后端覆盖结论 @@ -119,8 +142,6 @@ | 企业候选人看板 | `/company/candidates`、`/company/candidates/{id}` | 已完成 | | 企业评分看板 | `/company/scoring/dashboard/*` | 已完成 | | 企业认证 | `/companies/me/verification`、`/admin/companies/verifications*` | 已完成 | -| 入职清单与公司知识介绍 | /onboarding/**（9 个接口） | **实现完成，待真实 MySQL/Docker 验收** | -| 薪资计算器 | /salary-calculator/**（6 个接口） | **实现完成，待真实 MySQL/Docker 验收** | ### 4.2 部分完成或口径不一致 @@ -132,23 +153,24 @@ | HR 评价详情 | `candidate_feedback` 已实现 | 不是结构化面试评分 | | 企业评价管理 | 有评价审核和管理员决策 | 缺企业端评价管理、回复和运营动作 | | 企业人才推荐 | 有候选人列表和评分 | 缺推荐排序、推荐理由和可解释结果 | -| 运营规则配置 | Figma 有页面 | 后端暂无规则配置接口 | -| 防刷审计报告 | 已有评价审核基础能力 | 不是风险等级、风险趋势、风险分布和事件审计报告 | +| 运营规则配置 | V37 `GET/PUT /admin/scoring/risk/rules` 已实现 | 仅 ADMIN；当前为确定性拒绝型安全审计规则，不做自动处置 | +| 防刷审计报告 | V37 风险概览、趋势、分布、事件与人工状态操作已实现 | 仅 ADMIN；不返回主体身份、原始审计内容、IP/UA 或凭据 | ### 4.3 完全缺失 -- 霍兰德职业兴趣测评； -- 四维能力测评； -- 测评结果和测评岗位推荐； +- ~~霍兰德职业兴趣测评~~（已由 V35 实现：测评 + 结果 + 探索方向，Flyway V34）； +- ~~四维能力测评~~（已由 V36 实现：限时答题、进度保存、结果、短板和历史，Flyway V35）； +- ~~测评岗位推荐~~（V39 已完成：结构化岗位画像、受控分类、测评驱动推荐、反馈与审核）； - AI 简历诊断和优化； - AI 模拟面试和面试题预测； - 行业技能词云； -- 薪资参考和行业薪资大数据； +- 入职准备清单和公司知识介绍； +- 薪资计算器和薪资参考； - 公平性检测； - SHAP/规则解释； -- ADMIN 防刷审计和规则配置； +- ~~ADMIN 防刷审计和规则配置~~（已由 V37 实现：仅 ADMIN 的确定性风险概览、规则配置和人工处置，Flyway V36）； - 诚信积分和激励。 -- 已非缺失（已实现）：个人数据导出（V30）、隐私设置（V27）、账号注销（V28/V29）、举报与屏蔽（V33）、结构化面试评分（V31）、同岗位竞争力排名（V32）、统一求职进度聚合（V34）、入职清单和公司知识介绍（N04）、薪资计算器与历史记录（N05）。 +- 已非缺失（已实现）：个人数据导出（V30）、隐私设置（V27）、账号注销（V28/V29）、举报与屏蔽（V33）、结构化面试评分（V31）、同岗位竞争力排名（V32）、统一求职进度聚合（V34）、RIASEC 职业兴趣测评（V35）、四维能力测评（V36）、ADMIN 防刷审计与规则配置（V37）、四维能力测评有限接入候选评分（V38，仅 ABILITY，GROWTH 仍未接入）。 ## 5. 已有代码的优先修复项 @@ -344,12 +366,11 @@ jobs 开发顺序： -1. 霍兰德职业兴趣测评； -2. 四维能力测评； -3. 测评答题和进度保存； -4. 测评结果； -5. 测评结果进入 ABILITY/GROWTH； -6. 根据测评结果推荐岗位。 +1. ~~霍兰德职业兴趣测评~~（V35 已完成）； +2. ~~四维能力测评、答题和进度保存~~（V36 已完成）； +3. ~~测评结果~~（V35/V36 已完成）； +4. 测评结果进入 ABILITY/GROWTH（V38 已完成 ABILITY 有限接入；GROWTH 仍需独立评审与后续实现）； +5. ~~根据测评结果推荐岗位~~（V39 已完成）。 建议接口： @@ -380,7 +401,7 @@ V30__assessment.sql ### 阶段 5：公平性、SHAP、反刷审计 -#### 防刷审计 +#### 防刷审计（V37 已完成） 仅 ADMIN 可见： @@ -389,8 +410,9 @@ GET /admin/scoring/risk/overview GET /admin/scoring/risk/trend GET /admin/scoring/risk/distribution GET /admin/scoring/risk/events -GET /admin/scoring/rules -PUT /admin/scoring/rules/{id} +GET /admin/scoring/risk/rules +PUT /admin/scoring/risk/rules/{ruleCode} +POST /admin/scoring/risk/events/{eventId}/actions ``` 禁止返回原始手机号、IP、设备指纹、密码、Token 等敏感信息。 @@ -401,6 +423,7 @@ PUT /admin/scoring/rules/{id} scoring_risk_events scoring_rule_configs scoring_risk_actions +scoring_risk_scan_checkpoints ``` #### 公平性检测 @@ -446,6 +469,8 @@ scoring_risk_actions - AI 模拟面试； - 面试题预测； - 行业技能词云； +- 入职准备清单； +- 公司知识介绍； - 简历查重； - 诚信积分； - 消息撤回。 @@ -460,15 +485,14 @@ scoring_risk_actions | P0 | 个人数据导出 | | P0 | 结构化面试评分 | | P0/P1 | 同岗位竞争力排名 | -| P1 | 霍兰德和四维能力测评 | +| P1 | 测评结果进入评分引擎、测评岗位推荐（V38/V39 已完成） | | P1 | 统一求职进度（V34 已完成） | -| P1 | 企业评价管理 | -| P1 | 企业人才推荐 | -| P1 | 公平性检测 | -| P1 | ADMIN 防刷审计 | +| P1 | ~~企业评价管理~~（V40 自动化、`clean verify` 与真实 MySQL/Docker 黑盒已通过，待 Git 检查点） | +| P1 | ~~企业人才推荐~~（V41 已实现；新增 V39 授权迁移，自动化 1461/1461、真实 MySQL/Docker 黑盒 PASS=37/FAIL=0，待 Git 检查点） | +| P1 | V43历史条目：申诉可比分母与版本内部补集泄露已修复并通过独立代码复验、真实 MySQL/Docker 与 30/300/3000 查询预算验收；待 Git 检查点，以顶部状态与一期清单N01为准 | | P2 | SHAP 高级解释 | | P2 | AI 简历、AI 模拟面试 | -| P2 | 技能词云、入职清单（N04 实现完成，待验收）、诚信积分 | +| P2 | 技能词云、入职清单、诚信积分 | ## 8. 每个模块的统一交付要求 @@ -533,7 +557,3 @@ CandidateFeedback 当前响应包含 companyUserId、studentUserId 等内部身 - 新增未批准的 Flyway； - 删除或清理业务数据； - 启动或停止 Docker。 - - - - diff --git a/docs/candidate-scoring-api.md b/docs/candidate-scoring-api.md index b019ead..8003c2a 100644 --- a/docs/candidate-scoring-api.md +++ b/docs/candidate-scoring-api.md @@ -1,6 +1,7 @@ # 求职者评分体系 API > 求职者评分体系（Candidate Scoring Engine）v0.1 · 规则版本 `candidate-scoring-v0.1` +> V38 起：功能开关 `scoring.ability-assessment.enabled`（默认 `false`）开启时，`ABILITY` 按 V36 四维能力测评的最新有效结果映射，候选评分规则版本升级为 `candidate-scoring-v0.2`；关闭时保持 `candidate-scoring-v0.1` 与既有 `ABILITY=PENDING` 行为。 > 基础路径：`/api/v1` · 全部接口需 `Authorization: Bearer ` ## 概述 @@ -19,7 +20,7 @@ | `OK` | 输入齐备，按规则确定性计算 | | `ESTIMATED` | 部分输入缺失，使用兜底值并标注估算（如学校未知、偏好字段部分填写） | | `INSUFFICIENT_DATA` | 关键输入缺失，不计算（score=null） | -| `PENDING` | 数据源未就绪（INTERNSHIP 无实习表、ABILITY 无测评），score=null | +| `PENDING` | 数据源未就绪（INTERNSHIP 无实习表；ABILITY 无测评、仅有过期/结构异常结果或开关关闭），score=null | 综合卡 `status`：全部 8 维可计算→`OK`；部分可计算→`PARTIAL`；无可计算且存在 PENDING→`PENDING`；否则→`INSUFFICIENT_DATA`。 @@ -27,11 +28,13 @@ ### 1. GET `/profile/me/candidate-scoring`（仅 STUDENT 本人） -返回综合评分卡：`candidateId`、`status`、`overallScore`、`weights`、`dimensions[]`、`rulesVersion`、`generatedAt`。 +返回综合评分卡：`candidateId`、`status`、`overallScore`、`weights`、`dimensions[]`、`rulesVersion`、`generatedAt`，以及解释版本 `explanationVersion`、参与覆盖 `coverage` 和固定可比性提示 `comparabilityNotice`。`coverage.computableDimensions` 与实际参与 overallScore 的维度严格一致，`excludedDimensions` 列出未参与原因。 ### 2. GET `/profile/me/candidate-scoring/dimensions/{dimension}`（仅 STUDENT 本人） -返回单维度明细：`dimension`、`score`、`status`、`subScores[]`、`reasons[]`、`dataSources[]`、`updatedAt`、`rulesVersion`。非法 `dimension` → 400/1001。 +返回单维度明细：原有 `dimension`、`score`、`status`、`subScores[]`、`reasons[]`、`dataSources[]`、`updatedAt`、`rulesVersion`，以及 `displayName`、`whatItMeasures`、`interpretation`、`limitations[]`、`evidenceLevel`、`ruleContributions[]`、`improvementActions[]`、`explanationVersion`、`validity`（仅 ABILITY 有明确有效期）和 `calculatedAt`。非法 `dimension` → 400/1001。 + +> 学生单维明细（仅 STUDENT 本人）。解释版本固定为 `candidate-scoring-explanation-v1`，与评分 `rulesVersion` 分离。`ruleContributions` 由真实计分分支产生，贡献之和可与最终维度分数对账；`SCORE_CAP_ADJUSTMENT` 用于说明 0–100 截断，`SCORE_ROUNDING_ADJUSTMENT` 仅记录逐项展示舍入与最终两位小数的对账差，不改变评分规则。`dataSources` 仅使用“个人教育资料”“求职偏好”“平台求职活动”“简历与技能资料”“Offer 履约与候选反馈”“四维能力测评”等产品语义名称。**不返回** `sourceResultId`、答题/答卷 ID、题目、答案、答案键、选项分值、`competencyTag`、数据库表名、完整内部 `sub_scores_json`。其他维度响应与既有保持兼容。非法 `dimension` → 400/1001。 ### 3. GET `/profile/me/candidate-scoring/trend?months=6`（仅 STUDENT 本人） @@ -39,7 +42,7 @@ ### 4. GET `/company/candidates/{applicationId}/scoring`（仅岗位所属企业） -企业只读评分卡。**仅返回** `applicationId`、`overallScore`、`status`、`dimensions[]{dimension,score,status}`、`generatedAt`、`rulesVersion`；**禁止返回** `studentUserId`、`candidateId`、`phone`、`email`、`resumeUrl`、`sub_scores` 细节、内部日志。 +企业只读评分卡。**仅返回** `applicationId`、`overallScore`、`status`、`dimensions[]{dimension,score,status}`、`generatedAt`、`rulesVersion`；**禁止返回** `studentUserId`、`candidateId`、`phone`、`email`、`resumeUrl`、`sub_scores` 细节、内部日志。V38 起等效于对 `ABILITY` 只暴露聚合 `score/status`，**禁止**返回 LOGIC/COMMUNICATION/EXECUTION/LEARNING 细分、`validUntil`、attemptId/resultId、`answerKey`、`scoringRule`、`questionCode`、`competencyTag`。 ## 权限矩阵 @@ -56,7 +59,7 @@ |---|---| | EDUCATION | student_profiles.education/school（学校档次用内置名单，未知→ESTIMATED 兜底 50） | | INTERNSHIP | 数据源未就绪 → PENDING | -| ABILITY | 能力测评未实现 → PENDING | +| ABILITY | 默认 `PENDING`；开关开启且有最新有效四维能力测评（WORKPLACE_ABILITY，COMPLETED、答题 24/24、`valid_until > capturedNow`）时按 `LOGIC×0.35 + EXECUTION×0.30 + LEARNING×0.20 + COMMUNICATION×0.15`（scale=2、HALF_UP）映射为 OK | | COMPLIANCE | student_preferences（薪资/城市/用工/行业/岗位类型 5 字段加权；remoteAllowed 不计分） | | STABILITY | users.createdAt（账号年龄）、applications（投递/撤回率）、audit_logs（近 30 天 LOGIN） | | GROWTH | resume_versions（ACTIVE 数量/最近更新）、student_profiles.skillsJson（当前值，无历史） | @@ -76,3 +79,11 @@ ## 错误码 复用：`BAD_REQUEST(1001)`、`UNAUTHORIZED(2001)`、`FORBIDDEN(2002)`、`APPLICATION_NOT_FOUND(8002)`、`APPLICATION_OWNER_MISMATCH(8004)`。不新增错误码。 + +## N02 解释与合理性边界 + +- 本版只增强学生可见解释，不改变八维公式、12.50 默认权重、参与维度、`candidate-scoring-v0.1/v0.2` 切换、V32 排名或快照写入语义。 +- `INTERNSHIP` 未接入时保持 `PENDING`，不显示为 0 分；缺失维度仍退出综合分分母，综合卡通过 `coverage` 和 `comparabilityNotice` 明确提示不同参与集合不可直接横向比较。 +- 规则解释为固定白名单模板，不接入 AI/LLM/SHAP，不把教育、平台行为、履约或活跃信号解释为人格、信用、确定性能力或录用结论。 +- 企业评分接口 schema 保持不变，只返回既有聚合字段；解释、覆盖率、限制、建议、规则贡献和 ABILITY 有效期仅对学生本人可见。 +- `Clock` 在每次评分请求入口捕获一次 `capturedNow`，并用于时间窗口、ABILITY 有效期、`calculatedAt` 与快照时间；真实 MySQL/Docker 验收仍为本版发布前置条件。 diff --git a/docs/candidate-scoring-explanation-design.md b/docs/candidate-scoring-explanation-design.md new file mode 100644 index 0000000..12fd715 --- /dev/null +++ b/docs/candidate-scoring-explanation-design.md @@ -0,0 +1,302 @@ +# N02 候选评分规则解释与合理性：详细设计 + +状态：N02 独立代码复验与真实 MySQL/Docker 黑盒验收通过，待 Git 检查点。 + +文档类型：解释。目标读者为产品负责人、后端开发、独立验收人员和前端联调人员。本设计说明现有候选评分实际上计算了什么、一期应如何向学生解释，以及哪些结论不得从这些分数推出。 + +## 1. 背景与目标 + +当前候选评分由 `CandidateScoringCalculator` 计算八个维度，并由 `CandidateScoringEngineService` 写入或读取 `candidate_dimension_scores`。学生单维接口已有 `subScores`、`reasons` 和 `dataSources`，但这些信息由各计算方法临时拼装，缺少稳定的规则编码、解释版本、适用范围和限制说明。 + +N02 的一期目标是让学生能够回答以下问题： + +1. 这个分数使用了哪些数据； +2. 哪些确定性规则实际命中； +3. 每条规则对当前结果产生了什么影响； +4. 哪些数据缺失、过期或仍未接入； +5. 用户可以通过哪些真实、合理的方式完善资料； +6. 该分数不能代表什么。 + +N02 同时要求企业端继续只查看聚合分与状态，不获得学生的私人明细、行为次数、测评细分或改进建议。 + +## 2. 非目标 + +一期不做： + +- SHAP、机器学习特征贡献或 AI 生成解释； +- 人口属性公平性推断； +- 宣称规则已具备心理测量效度或预测效度； +- 自动修改评分权重、排名或推荐逻辑； +- 新增评分事实表、解释历史表或规则配置后台； +- 向企业暴露学生的细分评分证据； +- 将行为频次解释为人格、诚信、成长潜力或职业能力； +- 用解释功能引导用户刷投递、刷消息、刷简历版本。 + +## 3. 当前真实实现 + +### 3.1 代码入口 + +- 计算：`mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java` +- 服务：`CandidateScoringEngineService.java` +- 学生与企业接口：`CandidateScoringController.java` +- 快照：`CandidateDimensionScore.java`、`CandidateDimensionScoreRepository.java` +- 能力映射：`AbilityAssessmentScoreSource.java`、`AbilityScoreMapper.java` +- 申诉与回滚：`candidatescore/governance/` +- 排名：`competition/CompetitionRankingCalculator.java` + +### 3.2 综合分 + +当前八维默认展示权重均为 12.50。只有状态为 `OK` 或 `ESTIMATED` 且分数非空的维度参与综合分： + +```text +overallScore = sum(可计算维度分数) / 可计算维度数量 +``` + +最终保留两位小数，`HALF_UP`。`PENDING` 和 `INSUFFICIENT_DATA` 被排除后重新归一化，因此两个相同综合分可能来自不同的维度集合。解释必须展示参与维度数量与排除维度，禁止把综合分描述为完整、统一口径的能力总分。 + +### 3.3 规则版本 + +- 能力测评开关关闭：`candidate-scoring-v0.1`； +- 能力测评开关开启：`candidate-scoring-v0.2`； +- ABILITY 映射规则：`ability-assessment-scoring-v0.1`； +- 历史趋势优先使用快照自身 `rulesVersion`。 + +N02 只增加解释契约时不升级候选评分规则版本，建议新增独立的 `explanationVersion=candidate-scoring-explanation-v1`。只有公式、阈值、参与维度或排名输入发生变化时才升级评分规则版本。 + +## 4. 设计原则 + +### 4.1 解释必须与计算同源 + +每个计分分支在计算贡献值的同时生成内部 `RuleContribution`，不能在 Controller、DTO mapper 或另一套公式中根据最终分数反推解释。 + +建议内部结构： + +```text +RuleContribution +- ruleCode 稳定规则编码 +- outcome APPLIED / NOT_APPLIED / MISSING / EXPIRED / UNAVAILABLE +- contribution 实际加减分；不适用时为 null +- maxContribution 该规则可能贡献的绝对上限 +- publicLabel 面向学生的中性名称 +- publicObservation 安全的区间或状态，不输出内部数据库字段 +- explanationKey 固定解释模板编码 +``` + +规则元数据由 `CandidateScoringExplanationCatalog` 按 `ruleCode` 提供名称、限制、建议和证据等级。计算器产生“事实和贡献”，目录提供“稳定语义”，Assembler 只组合，不重复计算。 + +当逐项贡献按两位小数展示而整体分数采用 HALF_UP 产生舍入差时，使用 +`SCORE_ROUNDING_ADJUSTMENT` 显式记录对账差；它只解释展示精度，不改变任何评分公式。 + +### 4.2 不把解释做成刷分指南 + +学生可以看到区间和缺失项，例如“近 90 天存在投递记录”“求职偏好尚未完整”，但默认不暴露风控阈值组合、审计动作名称、原始消息数量或内部 SQL 字段。已经在界面契约中公开的固定能力权重可继续展示。 + +### 4.3 区分事实、推断与限制 + +每个维度必须有： + +- `whatItMeasures`：规则直接使用的数据； +- `interpretation`：可谨慎解释的含义； +- `limitations`：不能据此得出的结论； +- `evidenceLevel`：`DIRECT_RULE`、`SELF_REPORTED`、`BEHAVIOR_PROXY`、`UNVALIDATED_PROXY`； +- `improvementActions`：只给可合理完成的操作，不鼓励刷行为。 + +## 5. 一期响应方案 + +### 5.1 路径范围 + +保持现有 4 个路径，不新增 operation： + +- `GET /profile/me/candidate-scoring` +- `GET /profile/me/candidate-scoring/dimensions/{dimension}` +- `GET /profile/me/candidate-scoring/trend` +- `GET /company/candidates/{applicationId}/scoring` + +OpenAPI 路径/操作数保持当前基线 172/210。 + +### 5.2 学生综合卡兼容扩展 + +建议新增： + +- `explanationVersion`； +- `coverage.computableDimensions`； +- `coverage.totalDimensions=8`； +- `coverage.includedDimensions`； +- `coverage.excludedDimensions[]{dimension,status,reason}`； +- `comparabilityNotice`，固定说明不同参与维度集合的综合分不宜直接比较。 + +不得返回内部快照 ID、测评结果 ID、题目、答案、审计详情、消息正文或数据库字段名。 + +### 5.3 学生单维详情兼容扩展 + +保留现有 `subScores/reasons/dataSources`，新增： + +- `displayName`； +- `whatItMeasures`； +- `interpretation`； +- `limitations[]`； +- `evidenceLevel`； +- `ruleContributions[]`； +- `improvementActions[]`； +- `explanationVersion`； +- `validity`：仅在存在明确有效期时返回，例如 ABILITY； +- `calculatedAt`：本次真实计算基准时间。 + +`ruleContributions` 只面向学生本人。旧字段在一期保留，避免前端破坏性升级；文档标记旧 `reasons/dataSources` 后续逐步由结构化字段替代。 + +### 5.4 企业端 + +企业端保持现有字段：`applicationId/overallScore/status/dimensions/generatedAt/rulesVersion`。不新增 `ruleContributions`、`limitations`、行为次数、学校分档、资料缺失项、四维能力细分或有效期。 + +企业页面可增加平台级固定说明，但不得把学生解释 DTO 直接复用到企业响应。 + +## 6. 时间一致性 + +`computeAll` 应在入口生成一次 `capturedNow`，并传递给所有时间敏感查询与规则： + +- 90 天投递； +- 30 天登录和活跃操作； +- 账号月龄； +- 简历 90 天更新； +- ABILITY 有效期； +- `calculatedAt` 和数据源时间说明。 + +不得在同一次计算中多次调用 `LocalDateTime.now()` 形成不同边界。建议注入 `Clock`，生产使用系统时钟，测试使用固定时钟。 + +## 7. 八维解释口径 + +| 维度 | 一期允许的名称 | 允许解释 | 禁止解释 | +|---|---|---|---| +| EDUCATION | 教育背景信息 | 已填写学历与学校分类规则的确定性结果 | 智力、能力上限、人才质量 | +| INTERNSHIP | 实习经历信息 | 当前数据源尚未接入 | 无实习能力、经验不足 | +| ABILITY | 四维能力测评 | 最新有效自研测评的规则化聚合 | 确定性职业能力、招聘结论 | +| COMPLIANCE | 求职偏好完整度 | 五类偏好字段填写情况 | 合规意识、服从性 | +| STABILITY | 平台求职行为稳定信号 | 账号时长、撤回与登录形成的行为代理 | 人格稳定、忠诚度 | +| GROWTH | 简历维护与技能展示信号 | 简历维护和技能标签状态 | 成长潜力、学习速度 | +| INTEGRITY | 履约与资料一致性信号 | Offer 响应、反馈与资料完整度的行为代理 | 道德、诚信人格、信用评级 | +| ACTIVITY | 平台求职活跃度 | 近期投递、平台操作和沟通信号 | 工作积极性、职业投入度 | + +维度代码为兼容字段，本版不改数据库枚举。产品展示名称采用上述中性名称。 + +## 8. 合理性整改分级 + +### 8.1 仅解释整改即可上线 + +- ABILITY：保留现有公式和有效期，补自评/情境测验限制； +- INTERNSHIP：保持 PENDING，明确“未接入”不是低分； +- 综合分：补参与维度和不可横向比较提示。 + +### 8.2 需要改名但暂不改公式 + +- COMPLIANCE → 求职偏好完整度； +- STABILITY → 平台求职行为稳定信号； +- GROWTH → 简历维护与技能展示信号； +- INTEGRITY → 履约与资料一致性信号； +- ACTIVITY → 平台求职活跃度。 + +这里只修改展示语义，不改变维度代码、快照或历史接口。 + +### 8.3 需要后续规则版本评审 + +- EDUCATION 的学校名单及 45% 权重； +- STABILITY 的账号时长奖励和撤回惩罚； +- GROWTH 的简历版本数量奖励； +- INTEGRITY 的 Offer 接受奖励、过期惩罚和反馈评分； +- ACTIVITY 的投递、审计和消息计数可操纵性； +- 缺失维度重新归一化后仍进入企业评分与排名。 + +任何一项改变分数都必须升级评分版本、完成新旧结果对账和 V32 排名回归，不能混入纯解释提交。 + +## 9. 权限与隐私 + +学生本人可以查看自身安全聚合解释。企业只能查看现有聚合评分卡。ADMIN 沿用治理接口，不因 N02 获得新的个人解释查询入口。 + +所有 HTTP 响应禁止新增： + +- 原始审计动作、IP、User-Agent； +- 消息正文或对话对象； +- Offer 具体企业、岗位或时间线； +- 评价正文与评价人身份； +- assessment/ability 的题目、答案、答案键、评分规则和结果 ID； +- 内部 SQL、表名、快照 ID、用户 ID； +- 密码、Token、密钥。 + +学生响应中的数据来源改为产品语义名称，如“个人教育资料”“求职偏好”“平台求职活动”，不直接返回 `student_profiles.education/school` 等物理字段名。 + +## 10. 实现建议 + +建议新增内部类： + +- `CandidateScoringExplanationCatalog`：规则元数据白名单； +- `CandidateScoringExplanationAssembler`：将 `DimensionResult` 与规则元数据组装为学生 DTO； +- `RuleContribution`、`ScoreCoverage` 等内部/DTO 类型。 + +修改： + +- `CandidateScoringCalculator`：统一 `capturedNow/Clock`，每个实际分支同步生成贡献； +- `CandidateScoringEngineService`：组装覆盖率与学生解释； +- 学生 DTO：兼容新增字段； +- OpenAPI、校验脚本、API 和联调文档。 + +原则上无新 Flyway、无新 ErrorCode、无新公网路径。解释元数据先随代码版本发布，不引入可在线修改规则的后台。 + +## 11. 测试与验收 + +### 11.1 规则同源 + +- 每个阈值边界独立手算； +- `contribution` 之和与真实维度分形成可证明关系； +- 未命中、缺失、过期和不可用规则不能伪造成 0 分命中； +- 固定 Clock 验证 30/90 天和有效期边界； +- 不允许修改解释而改变分数，或修改分支后遗漏解释。 + +### 11.2 综合分 + +- 0、1、2、8 个可计算维度； +- `OK/ESTIMATED` 参与，其他状态排除； +- coverage 与实际参与集合完全一致； +- 学生综合卡、趋势、企业评分和 V32 排名与既有纯函数对账。 + +### 11.3 权限与脱敏 + +- STUDENT 仅查看本人； +- COMPANY 只见聚合字段； +- ADMIN 不获得新增学生详情入口； +- 匿名 401，角色越权 403/2002； +- 对完整 JSON 递归扫描禁止字段； +- ABILITY 不泄露题目、答案或来源结果 ID。 + +### 11.4 防刷与边界评审 + +用固定样例证明重复投递、发消息、制造简历版本可能改变哪些分数，并在本版明确标为未验证代理信号。若决定保留其排名影响，必须形成书面产品决策和监测指标。 + +### 11.5 发布验证 + +- N02 专项、候选评分、治理、V32、V38、V39、V41、V42、V43 回归； +- `mvn clean verify`； +- 静态与运行时 OpenAPI 对账； +- 真实 MySQL 主链路和响应脱敏； +- 查询前后快照写入行为保持既有语义； +- 无新增 RabbitMQ 消息。 + +## 12. 编码前决策表 + +| 编号 | 决策项 | 建议方案 | 状态 | +|---|---|---|---| +| D01 | N02 是否只做解释，不改任何现有分数、权重和排名 | 是；规则合理性问题记录为后续独立评分版本 | 已确认 | +| D02 | 是否保持现有 4 个接口、0 个新增 path/operation | 是 | 已确认 | +| D03 | 是否无新 Flyway、无规则配置后台 | 是 | 已确认 | +| D04 | 是否增加独立 `explanationVersion`，不升级评分 `rulesVersion` | 是，值为 `candidate-scoring-explanation-v1` | 已确认 | +| D05 | 是否兼容扩展学生综合卡，展示参与/排除维度和可比性提示 | 是 | 已确认 | +| D06 | 是否兼容扩展学生单维详情，增加结构化规则贡献、限制和建议 | 是 | 已确认 | +| D07 | 企业端是否保持现有 schema，不展示任何规则贡献与私人细分 | 是 | 已确认 | +| D08 | 是否采用中性展示名，但保持八个维度代码不变 | 是 | 已确认 | +| D09 | 是否明确 `INTEGRITY` 不能解释为人格诚信或信用评级 | 是 | 已确认 | +| D10 | 是否明确 `GROWTH/STABILITY/COMPLIANCE/ACTIVITY` 仅为平台数据代理 | 是 | 已确认 | +| D11 | 是否用单次 `capturedNow` 并注入 `Clock` 修复解释时间一致性 | 是，不改变阈值与公式 | 已确认 | +| D12 | 学生是否只看安全区间/状态，不显示可用于刷分的内部计数与审计动作 | 是 | 已确认 | +| D13 | EDUCATION 学校分档是否暂时保留计算，但增加未验证与公平性警示 | 暂留，另开评分版本评审决定移除/降权 | 已确认 | +| D14 | 缺失维度重新归一化是否暂时保留 | 暂留，明确可比性限制并在规则评审中决定 | 已确认 | +| D15 | 是否安排题库和规则证据验证，不将当前确定性规则称为已验证模型 | 是 | 已确认 | + +D01–D15 已全部确认并按本设计实现。若未来 D01、D13 或 D14 的产品决策改变计分，本模块必须另行升级评分规则版本，不能通过解释增强提交混入。 diff --git a/docs/candidate-scoring-fairness-api.md b/docs/candidate-scoring-fairness-api.md new file mode 100644 index 0000000..3248ddd --- /dev/null +++ b/docs/candidate-scoring-fairness-api.md @@ -0,0 +1,39 @@ +# V43 候选评分公平性与稳定性监测 API + +V43 只提供 ADMIN 聚合查询。当前状态为“独立代码复验与真实 MySQL/Docker 验收通过，待 Git 检查点”。响应基于当前数据库中指定月份的评分快照，字段 `basis=CURRENT_STORED_SNAPSHOTS` 表示快照可能被同月重算覆盖，不能解读为历史时点记录。 + +## 权限与通用约束 + +- ADMIN 才能访问；匿名为 401，STUDENT/COMPANY 为 403/2002。 +- 时间范围使用 `[from,to)`。评分接口的 `period` 必填，格式为 `yyyy-MM`，不得晚于当前业务月。 +- 申诉接口默认最近 30 个完整业务日，`from`、`to` 必须成对出现，跨度最大 90 天。 +- 仅允许文档列出的参数；未知参数、非法维度和未来月份返回 400/1001。 +- 所有响应为聚合白名单，不包含用户、申请、申诉、答卷、结果、审计 ID，联系方式、简历、题目、答案、规则详情或审计原文。 + +## 接口 + +| 方法 | 路径 | 用途 | +|---|---|---| +| GET | `/admin/scoring/fairness/overview?period=yyyy-MM` | 现存快照人数、可计算比例、规则版本构成和综合分分布 | +| GET | `/admin/scoring/fairness/dimensions?period=yyyy-MM&dimension=ABILITY` | 八维状态、缺行/空分/有效覆盖率和分布 | +| GET | `/admin/scoring/fairness/drift` | 返回 `UNAVAILABLE/IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE` | +| GET | `/admin/scoring/fairness/ranking-stability` | 返回 `UNAVAILABLE/RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE` | +| GET | `/admin/scoring/fairness/appeals?from=yyyy-MM-dd&to=yyyy-MM-dd` | 申诉创建队列当前状态、审核通过、回滚和实际变分聚合 | + +所有 `sampleSize`、状态/版本/原因计数均按独立候选人计算，`appealCount` 才是事件数。每个统计组均带有明确的 `availability` 与 `reason`：`NO_DATA`、`INSUFFICIENT_SAMPLE`、`SUPPRESSED` 或 `AVAILABLE`，前端不得通过字段缺失猜测状态。0–29 人不返回均值、分位数、极值、标准差、分桶、比例或风险；30–99 标记 `LOW_CONFIDENCE`；100 及以上为 `NORMAL_CONFIDENCE`。任意细分单元或其补集为 1–29 人时整组抑制，避免从总计反推隐藏单元。 + +规则版本分布按版本单元分别做披露决策：不安全版本只返回 `availability=SUPPRESSED`/`reason=SMALL_CELL_OR_COMPLEMENT_RISK`，其 `sampleSize`、均值、分位数、极值、标准差、分桶和风险均为空；安全兄弟版本（例如70/30）仍可返回正常分布。只要存在版本级受保护单元，`versionCounts`及其可由总体反推的计数隐藏；全局总体触发抑制时，整个版本分布组隐藏。 + +总览的 `computableSnapshotRatio` 是“至少一个有效维度的候选人数 / 总体人数”，MIXED/UNKNOWN 候选不会被错误地当作无有效分；综合分布通过 `distributionsByRulesVersion` 按单一已知候选整体规则版本分别计算，MIXED/UNKNOWN 不进入版本分布。申诉的 `statusCounts/statusCandidateCounts` 是独立候选人数，`statusEventCounts` 明确保留事件数；重复回滚、空/越界分和跨版本原因均独立计数。回滚可比性按申诉粒度判断：同一 `appeal_id` 的 ROLLBACK 历史恰好一条且分数/规则版本合法才进入 COMPARABLE；同一候选人的另一份合法申诉不因其存在重复历史的申诉而被排除。`comparableRollbackCount` 与 `changedCount` 按可比/变分回滚历史行计数，`comparableRollbackCandidateCount` 与 `changedCandidateCount` 按这些行对应的独立候选人数计数；`actualScoreChangeRate=changedCount/comparableRollbackCount`，零差历史仍在分母中。 + +维度完整性异常分开返回 `inconsistentRecordCount`（状态与是否有分不一致）、`unknownStatusCount`（未知状态）和 `outOfRangeScoreCount`（非空但不在 0–100 的分数）；这些计数与有效分、缺行、空分不互相替代，并受同一独立候选人/补集抑制规则约束。分布发生分桶抑制时连同 `sampleSize`、均值、分位数、极值、标准差、分桶和风险一起隐藏，只保留 `availability/reason`。 + +回滚不可比原因按互斥优先级归类：重复 `ROLLBACK` 历史优先，其次为空/越界分，最后是规则版本未知或前后不一致；每个申诉只进入一个原因集合，但同一候选人可因不同申诉同时出现在多个原因集合，不能用候选人去重抹掉真实归属。零差回滚仍保留在可比分母中。审核通过率、回滚执行率和实际变分率使用各自独立分母，任何分母或补集不足 30 名独立候选人均不返回该指标。 + +申诉接口区分 `APPROVED/ROLLED_BACK`、实际 `ROLLBACK` 执行和前后分数变化。它不计算真实曝光申诉率，因为当前系统没有可比的曝光分母。 + +V43 不写 `candidate_dimension_scores`，不触发评分重算，不修改 V32 排名。历史漂移和历史排名接口返回不可用状态是当前数据模型的真实限制。 + +实现约束：维度统计使用 `COUNT(DISTINCT student_user_id)` 与 `GROUP BY` 频数查询，分位数/标准差由频数直接计算；申诉回滚按申诉时间窗口 JOIN 查询，不拼接无限增长的 `IN` 参数。每条 JDBC 查询使用独立 5 秒超时，不修改共享 `JdbcTemplate`。真实 MySQL 已完成 30/300/3000 人查询预算与耗时验收；EXPLAIN 中的全表扫描/filesort 作为更大规模容量风险持续观察。 + +抑制实现由独立的 `FairnessDisclosureGuard` 统一执行：有效集合、每个细分单元及其补集均按独立候选人数判断；当有效集合或补集仅 1–29 人时，可能揭示其大小的综合分布字段（包括 sampleSize、分位数、分桶、均值、极值和风险）一并隐藏。 diff --git a/docs/candidate-scoring-rule-evidence.md b/docs/candidate-scoring-rule-evidence.md new file mode 100644 index 0000000..a2fa09b --- /dev/null +++ b/docs/candidate-scoring-rule-evidence.md @@ -0,0 +1,209 @@ +# 候选评分规则证据表 + +状态：N02 独立代码复验与真实 MySQL/Docker 黑盒验收通过，待 Git 检查点；D01–D15 已确认。 + +文档类型：技术参考。本文记录 `CandidateScoringCalculator` 当前真实规则、数据、公式和证据限制。它不是对规则科学有效性的背书，也不是招聘决策指南。 + +## 1. 证据等级 + +| 等级 | 含义 | +|---|---| +| DIRECT_RULE | 可直接验证的确定性业务计算，例如字段是否填写、固定加权公式 | +| SELF_REPORTED | 主要来自学生本人填写，真实性和完整性依赖用户维护 | +| BEHAVIOR_PROXY | 平台行为与目标概念可能有关，但不能等同于目标概念 | +| UNVALIDATED_PROXY | 尚无试测、效度或公平性证据，不应据此形成强结论 | + +当前系统没有足够证据将任何行为代理称为人格测量、信用评估或招聘成功预测模型。 + +## 2. 全局规则 + +| 项目 | 当前实现 | 证据与限制 | +|---|---|---| +| 维度 | EDUCATION、INTERNSHIP、ABILITY、COMPLIANCE、STABILITY、GROWTH、INTEGRITY、ACTIVITY | 名称不一定等于实际被测概念 | +| 展示权重 | 每维 12.50 | 实际综合分是可计算维度算术平均 | +| 参与状态 | OK、ESTIMATED | PENDING、INSUFFICIENT_DATA 和 null score 排除 | +| 综合分 | `sum(score)/count`，scale=2，HALF_UP | 不同参与维度集合之间不可直接比较 | +| 分数边界 | 多数行为维度经 `cap` 限制至 0–100 | 上限截断会隐藏额外行为差异 | +| 快照 | 同学生、维度、月份覆盖更新 | 月度快照不是不可变历史事实 | +| 版本 | v0.1；能力开关开启为 v0.2 | 版本变化必须随响应和快照保存 | + +## 3. EDUCATION + +### 3.1 当前公式 + +```text +educationScore = 学历层次分 × 55% + 学校档次分 × 45% +``` + +学历层次：博士 100、硕士 85、本科 70、大专 55、其他 50。 + +学校档次：内置 985 名单 85、内置 211 名单 75、名称以“大学/学院”结尾 65、未填写或其他 50。未填写或无法识别时状态为 `ESTIMATED`；学历缺失时 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 数据来源 | 学生教育资料中的学历和学校 | +| 证据等级 | SELF_REPORTED + UNVALIDATED_PROXY | +| 可以说明 | 当前资料按平台固定分类规则得到的教育背景分 | +| 不能说明 | 智力、实际技能、岗位绩效、学习能力或人才质量 | +| 主要风险 | 学校名单硬编码、维护过期、学校名称匹配误差、社会经济背景代理、公平性风险 | +| 可操纵性 | 学生可修改自报字段；需要资料真实性治理，但不能因此扩大企业隐私权限 | +| 建议 | 一期只准确解释并标注未验证；后续评审移除学校项或显著降权 | + +## 4. INTERNSHIP + +当前固定返回 `PENDING`、`score=null`，原因是结构化实习数据源未接入。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | DIRECT_RULE | +| 可以说明 | 当前平台无法计算该维度 | +| 不能说明 | 学生没有实习、实习不足或经验较弱 | +| 建议 | 保持 PENDING；解释必须使用“未接入”，不得显示为 0 分 | + +## 5. ABILITY + +默认开关关闭时返回 `PENDING`。开启后只读取最新、有效、完整的 `WORKPLACE_ABILITY` 结果： + +```text +ABILITY = LOGIC×35% + EXECUTION×30% + LEARNING×20% + COMMUNICATION×15% +``` + +要求四维各回答 6 题、总回答 24 题、分数均在 0–100，`validUntil > capturedNow`。最终 scale=2、HALF_UP。 + +| 项目 | 结论 | +|---|---| +| 数据来源 | V36 自研四维能力测评最新有效聚合结果 | +| 证据等级 | DIRECT_RULE；题库测量意义仍属 UNVALIDATED_PROXY | +| 可以说明 | 用户在当前自研题库和评分规则下的四维聚合表现 | +| 不能说明 | 确定性工作能力、真实绩效或录用适合度 | +| 防滥用 | 不取历史最高分；结果过期或结构异常时不参与；不泄露答案键 | +| 待验证 | 小样本试测、信度、题目区分度、重测效应、与外部标准的关联 | + +## 6. COMPLIANCE + +当前实际计算求职偏好填写完整度：薪资 25、城市 25、用工类型 20、行业 15、岗位类型 15。五项均填写为 `OK`；至少一项填写为 `ESTIMATED`；全部缺失为 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | DIRECT_RULE + SELF_REPORTED | +| 可以说明 | 五类求职偏好字段的填写完整程度 | +| 不能说明 | 合规意识、纪律性、服从性或职业道德 | +| 风险 | 名称严重超出计算内容；填写更多即可得到更高分，但不代表偏好更合理 | +| 建议展示名 | 求职偏好完整度 | +| 后续建议 | 评审是否应退出跨候选排名，仅用于资料完善提示 | + +## 7. STABILITY + +有投递或近 30 天登录时以 50 为基础：账号超过 12 个月 +25，超过 6 个月 +15；有投递时撤回率低于 20% +15，高于 50% -20；近 30 天有登录 +10；结果截断至 0–100。无投递且无登录为 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | BEHAVIOR_PROXY + UNVALIDATED_PROXY | +| 可以说明 | 当前账号和平台求职行为形成的稳定信号 | +| 不能说明 | 人格稳定、工作稳定、忠诚度或离职概率 | +| 风险 | 新用户天然劣势；撤回可能由岗位变化、误投或企业原因造成；登录记录受产品使用习惯影响 | +| 可操纵性 | 登录和减少撤回可改变分数；阈值公开可能诱导行为 | +| 建议展示名 | 平台求职行为稳定信号 | +| 后续建议 | 决定是否从企业评分及排名中移除账号月龄，或仅作为可信度信息 | + +## 8. GROWTH + +存在简历或技能时以 40 为基础：ACTIVE 简历数量至少 2 个 +15；最近简历更新时间在 90 天内 +15；技能标签至少 5 个 +15；结果截断至 0–100。二者均无数据时 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | BEHAVIOR_PROXY + UNVALIDATED_PROXY | +| 可以说明 | 简历维护和技能标签展示情况 | +| 不能说明 | 成长潜力、学习速度、职业上升空间 | +| 风险 | 多建简历版本和增加标签即可加分；技能数量不等于技能质量；无历史能力增量 | +| 建议展示名 | 简历维护与技能展示信号 | +| 后续建议 | 退出综合分或改成非评分的资料完善进度；若保留需加入去重、质量和冷却规则 | + +## 9. INTEGRITY + +有 Offer 历史或候选反馈时以 60 为基础：每个已接受 Offer +15，最多两个；每个过期 Offer -10，最多两个；反馈至少 3 条且均分至少 4 时 +10，有反馈且均分低于 3 时 -10；资料完整 +10；结果截断至 0–100。没有 Offer 且没有反馈时 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | BEHAVIOR_PROXY + UNVALIDATED_PROXY | +| 可以说明 | Offer 响应、反馈和资料完整度形成的履约代理信号 | +| 不能说明 | 道德诚信、个人信用、欺诈风险或人格品质 | +| 风险 | 接受 Offer 不必然等于守约；过期可能来自通知失败；反馈评分可能存在偏见或样本不足；资料完整与诚信不是同一概念 | +| 可操纵性 | 接受行为、反馈数量及资料填写会改变结果 | +| 建议展示名 | 履约与资料一致性信号 | +| 强制文案 | “该信号不是个人征信、信用评级或道德评价” | +| 后续建议 | 优先评审退出综合分和排名；独立诚信积分模块不得复用该分数充当积分余额 | + +## 10. ACTIVITY + +近 90 天投递：至少 6 次 +50、至少 3 次 +40、至少 1 次 +20；近 30 天平台操作至少 3 次 +30；存在发信记录 +20；结果截断至 0–100。全部为零时 `INSUFFICIENT_DATA`。 + +| 项目 | 结论 | +|---|---| +| 证据等级 | BEHAVIOR_PROXY | +| 可以说明 | 指定窗口内的平台求职活动程度 | +| 不能说明 | 工作积极性、职业动机、岗位能力或录用意愿 | +| 风险 | 为得分而投递、登录、发消息；消息只判断是否存在且当前查询未限定时间窗口 | +| 可操纵性 | 高；重复投递和任意消息可直接增加信号 | +| 建议展示名 | 平台求职活跃度 | +| 后续建议 | 保留为时效排序信号须单独评审；不建议与能力类维度等权解释 | + +## 11. 跨维度问题 + +### 11.1 概念重叠 + +资料完整度同时影响 COMPLIANCE、GROWTH 和 INTEGRITY，平台活跃行为同时影响 STABILITY 和 ACTIVITY。相同底层行为可能被重复计入综合分。 + +### 11.2 缺失并非零分 + +当前缺失维度会退出分母，而不是记为零。解释必须明确“未参与”，不能显示成“表现较差”。但重新归一化也使不同人的综合分口径不一致。 + +### 11.3 估算值 + +`ESTIMATED` 与 `OK` 同等进入综合分。学校未知和偏好部分填写均可能产生估算分，企业端目前只看到状态和聚合分，必须避免将估算分表述为精确结果。 + +### 11.4 时间窗口 + +APPLICATION、LOGIN、AUDIT 和简历更新时间使用多个 `now()`，消息数量没有时间窗口。N02 应先统一计算时钟，但是否修改消息窗口属于评分规则变更，不能混入解释版本。 + +## 12. 规则证据验证计划 + +### 12.1 代码级确定性验证 + +- 为每条规则建立边界表和独立手算样例； +- 固定 Clock 验证恰好 30/90 天、6/12 个月和 ABILITY 到期时刻； +- 检查分数、贡献、原因与数据来源完全一致； +- 验证 cap、负分、HALF_UP 和 null 分支。 + +### 12.2 数据质量验证 + +- 统计各维度 OK/ESTIMATED/INSUFFICIENT_DATA/PENDING 覆盖率； +- 检查学校名称无法识别率、偏好 JSON 错误率、Offer 通知失败率； +- 检查同一底层行为跨维度重复计分比例； +- 监测规则版本和异常结构，复用 V43 聚合能力但不扩大其个人数据范围。 + +### 12.3 防操纵验证 + +- 重复投递、撤回、登录、发消息、创建简历版本和堆叠技能标签； +- 比较一次行为与大量重复行为的边际影响； +- 验证冷却、幂等和上限是否真正生效； +- 发现高可操纵性时，不以隐藏阈值代替规则整改。 + +### 12.4 测评证据 + +ABILITY 题库先完成小样本试测，再评估内部一致性、题目区分度、重测影响和题目淘汰。RIASEC 当前不直接进入候选八维评分，不应在 N02 中混入。 + +## 13. N02 实现核对 + +- 解释版本固定为 `candidate-scoring-explanation-v1`，与 `candidate-scoring-v0.1/v0.2` 分离。 +- 规则贡献由 `CandidateScoringCalculator` 的真实分支同步生成，`CandidateScoringExplanationAssembler` 只做白名单组装。 +- 能力测评小数分数的逐项展示舍入差以 `SCORE_ROUNDING_ADJUSTMENT` 显式对账；不改变 V38 映射分数。 +- 学生综合卡增加 `coverage` 与 `comparabilityNotice`；企业评分卡字段和 JSON 结构保持不变。 +- `Clock`/`capturedNow` 贯穿一次评分计算及快照 `calculated_at`；未改变任何阈值、公式、权重或排名。 +- 本轮无新 Flyway、表、错误码、公网路径或业务消息；真实 MySQL/Docker 验收仍待独立执行。 + +## 14. 审计结论 + +当前代码在“确定性、可重复计算”层面具备基础，但不具备将多个代理维度解释为人格、诚信、成长潜力或招聘成功预测的证据。N02 可以先完成可信解释和限制披露；涉及分数、排名和企业决策影响的合理性整改必须作为独立规则版本处理。 + +D01–D15 已确认。当前代码在“确定性、可重复计算”层面具备基础，但不具备将多个代理维度称为人格、诚信、成长潜力或招聘成功预测模型的证据。N02 仅完成可信解释和限制披露；任何改变分数、权重或排名的后续动作必须另开评分规则版本并重新验收。 diff --git a/docs/company-review-management-api.md b/docs/company-review-management-api.md new file mode 100644 index 0000000..1a3d488 --- /dev/null +++ b/docs/company-review-management-api.md @@ -0,0 +1,111 @@ +# V40 企业评价管理与官方回复 API + +## 1. 范围 + +V40 为企业提供自有岗位评价查询、官方回复提交和管理员确定性预审。评价本身仍由既有学生评价模块维护；本模块不提供评价删除、隐藏、编辑、申诉、通知或运营统计。 + +Flyway 迁移为 `V38__company_review_replies.sql`（功能版本 V40），新增 `company_review_replies` 与 `company_review_reply_history` 两表，不修改 V1–V37。所有身份从 JWT subject 获取，不能从请求体或查询参数注入 `companyId`、`studentUserId` 或 `ownerUserId`。 + +## 2. 接口 + +| 方法 | 路径 | 权限 | +| --- | --- | --- | +| GET | `/companies/me/job-reviews` | COMPANY，且仅返回本人公司岗位 | +| GET | `/companies/me/job-reviews/{reviewId}` | COMPANY，且必须属于本人公司 | +| POST | `/companies/me/job-reviews/{reviewId}/reply` | 所属 COMPANY | +| PUT | `/companies/me/job-reviews/{reviewId}/reply` | 所属 COMPANY，仅 REJECTED 回复 | +| GET | `/admin/review-replies/pending` | ADMIN | +| POST | `/admin/review-replies/{replyId}/decision` | ADMIN | + +未登录返回 401；角色不匹配或跨公司访问返回 403/2002。V40 不增加其他公开路径、ErrorCode 或 feature flag。 + +## 3. 回复生命周期 + +```text +无回复 -> 企业创建 -> AUTO_APPROVED（公开） + -> PENDING -> APPROVED（公开） + -> REJECTED -> 企业 PUT 修订 -> AUTO_APPROVED/PENDING +``` + +每条评价只有一个当前回复。`AUTO_APPROVED`、`APPROVED` 不可修改或删除；`REJECTED` 必须带 `expectedVersion` 修订。管理员决策使用 `version` 条件更新，并发时只有一个请求成功。 + +## 4. 请求与响应 + +创建： + +```json +{ + "content": "感谢您的反馈，我们会持续优化招聘流程。", + "idempotencyKey": "合法 UUID" +} +``` + +正文去首尾空白后长度为 1–500；幂等键必须为 UUID 且不超过 64 字符。同企业、同评价、同正文的重放返回原回复；同幂等键但评价或正文不同返回 `409/10106`。 + +修订： + +```json +{ + "content": "修订后的回复内容", + "expectedVersion": 1 +} +``` + +管理员决策： + +```json +{"decision":"APPROVE","reason":null} +``` + +或： + +```json +{"decision":"REJECT","reason":"请移除不适合公开的联系方式。"} +``` + +企业响应白名单包括评价文本、星级、标签、维度聚合、岗位标题、回复正文/状态/版本/更新时间及驳回的人类说明；不返回 `studentUserId`、学生姓名、手机号、邮箱、IP、UA、内容哈希、评价审核内部原因、`moderationScore`、`reasonCodes` 或管理员 ID。 + +管理员待审响应可包含岗位/公司、评价和回复正文、风险等级及安全原因码，但不包含学生联系方式、IP/UA 明文或凭据。 + +## 5. 公开评价回复 + +既有 `GET /jobs/{jobId}/reviews` 和 `GET /jobs/{jobId}/reviews/{reviewId}` 保持不变。公开载荷移除 `studentUserId`，增加固定 `reviewerLabel: "匿名求职者"`。当评价为公开状态且回复为 `AUTO_APPROVED` 或 `APPROVED` 时，返回： + +```json +{"officialReply":{"content":"感谢反馈。","repliedAt":"2026-09-04T10:05:00"}} +``` + +`officialReply` 不含 replyId、companyId、status、version、原因码或审核人信息；`PENDING`/`REJECTED` 回复不公开。公开列表先分页取评价，再批量取回复和维度分，禁止逐条查询。 + +## 6. 当前验收状态 + +V40 专项与全量自动化测试已通过（全量 1445/1445，Failures=0、Errors=0、Skipped=0），`mvn clean verify` 已通过，静态与运行时 OpenAPI 均为 159 paths / 196 operations。真实 MySQL/Docker 黑盒已通过：Flyway V38 success=1、主链路/权限/幂等/状态机/并发创建与审核/脱敏/队列终态全部通过，汇总 `PASS=62 FAIL=0 SKIP=0`。V40 不写 `candidate_dimension_scores`，未提交 Git。 + +## 7. 错误码 + +| 错误码 | HTTP | 含义 | +| --- | --- | --- | +| 10101 | 404 | 回复不存在（或按归属策略隐藏） | +| 10102 | 409 | 评价已有当前回复 | +| 10103 | 409 | 回复状态不允许当前操作 | +| 10104 | 409 | 乐观锁/条件更新冲突 | +| 10105 | 400 | 回复正文或幂等键非法 | +| 10106 | 409 | 幂等键对应的请求内容冲突 | +| 10107 | 400 | 非法决策或驳回原因缺失 | + +## 8. 审计与数据安全 + +成功状态变化写入既有 `audit_logs` 和回复历史。详情只含 `reviewId`、`replyId`、`status`、`requestId` 等白名单字段，不写回复正文、评价正文、学生 ID、联系方式、IP/UA、哈希、风控原文、token、password 或 secret。V40 不写 `candidate_dimension_scores`。 + +企业列表和管理员待审列表均采用批量加载岗位、维度分和回复，测试断言查询次数不随条目数线性增长。 + +## 9. 验收 + +```powershell +mvn -Dtest="*Review*Test,*CompanyReview*Test,*AdminReview*Test" test +mvn test +mvn clean verify +python docs/verify_openapi.py +``` + +本轮自动化验收不启动/停止 Docker；真实 MySQL/Docker 黑盒须单独执行并如实记录。 diff --git a/docs/def-01-job-keyword-normalization-remediation-20260920.md b/docs/def-01-job-keyword-normalization-remediation-20260920.md new file mode 100644 index 0000000..6c4c3ab --- /dev/null +++ b/docs/def-01-job-keyword-normalization-remediation-20260920.md @@ -0,0 +1,224 @@ +# DEF-01 定向整改：`GET /jobs` 公开列表关键词规范化 + +日期：2026-09-20 +分支：`refactor/r01-structure-performance` +基线 HEAD：`2319f97203a2cafcf8012869fda8c30599ffb305`（整改前的 upstream 同点） +方案：**方案 A**（服务入口局部规范化），**不采用方案 B** +本轮性质：定向整改 + 独立复验；未暂存、未提交、未推送 + +--- + +## 1. 修复前最小复现 + +真实 HTTP（整改前，`mvn` 于 `2319f97`）： + +``` +GET /api/v1/jobs?keyword=%20AlphaEngineer%20 → items=0 （期望 1：trim 后应命中） +GET /api/v1/jobs?keyword=%20%20%20 → items=0 （期望 20：空白应等同未传） +GET /api/v1/jobs/ch?keyword=AlphaEngineer → items=1 +GET /api/v1/jobs → items=20 +GET /api/v1/jobs/search?keyword=%20AlphaEngineer%20 → 1 （正确） +GET /api/v1/jobs/search?keyword=%20%20%20 → 20 （正确） +``` + +## 2. 两个端点的调用链 + +| 端点 | 调用链 | 关键词处理 | +|---|---|---| +| `GET /jobs` | `JobController.listJobs:97` → `JobService.listPublishedJobs:123` → `JobRepository.findPublishedJobs`（JPQL） | 只判 `:keyword IS NULL`，**无 trim、无 blank 归一** | +| `GET /jobs/search` | `JobController.searchJobs:134` → `JobService.searchJobs` → `JobSearchSpecification:52-53` | `!keyword.isBlank()` 判空 + `keyword.trim()` | + +## 3. 根因 + +`JobRepository.findPublishedJobs` 的 JPQL 为： + +```sql +AND (:keyword IS NULL OR j.title LIKE %:keyword% OR j.description LIKE %:keyword%) +``` + +- `" AlphaEngineer "` **不是 null** → 生成 `LIKE '% AlphaEngineer %'` → 前导/尾随空格进入匹配串 → **0 条**； +- `" "` **不是 null** → 生成 `LIKE '% %'` → 无意义的过滤条件 → **0 条**； +- `/jobs/search` 已做 `trim()` 与 `isBlank()` 归一 → 两条**公开**查询路径的输入语义不一致。 + +## 4. 为什么选方案 A + +- 缺陷是**输入规范化缺失**，不是查询实现缺陷； +- 方案 A 把规范化放在**唯一入口**（`listPublishedJobs`），一处生效、语义显式、可被单测直接覆盖； +- 改动面最小（1 个文件、+7/−1），**不触碰** Repository / Specification / Controller / DTO / OpenAPI / + 排序 / 分页 / 薪资 / 城市 / 状态，回归风险最低。 + +## 5. 为什么不选方案 B + +- 方案 B 让 `/jobs` 改走 `JobSearchSpecification`，会改变 `/jobs` 的**分页 DTO 形态、排序实现与 + 查询计划**（`JobSearchItem` 与现有 `toPublicView` 字段并不相同），属于超出缺陷范围的语义扩张； +- 两套实现并存是**既有事实**（`/jobs` 与 `/jobs/search` 本就服务不同调用方）， + 合并应作为独立重构批次评估，不应与本次缺陷修复捆绑。 + +## 6. 精确生产修改 + +**唯一文件**：`mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java` +（`git diff --stat`：**1 file changed, 7 insertions(+), 1 deletion(-)**） + +```java +public Page> listPublishedJobs(String keyword, String city, ...) { + if (salaryMin != null && salaryMax != null && salaryMin > salaryMax) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + String normalizedKeyword = keyword == null || keyword.isBlank() ? null : keyword.trim(); // ← 新增 + Pageable pageable = PageRequest.of(page, size, Sort.by(Sort.Direction.DESC, "createdAt")); + Page result = jobRepository.findPublishedJobs(normalizedKeyword, city, employmentType, // ← 原为 keyword + salaryMin, salaryMax, pageable); + return result.map(this::toPublicView); +} +``` + +（另含一段 Javadoc 说明 DEF-01 的语义契约；不改变任何行为。） + +**未新增通用工具类**：项目内不存在语义完全相同的既有规范化工具，故保持这段局部逻辑。 + +## 7. 输入规范化决策表 + +| 输入 | 规范化结果 | +|---|---| +| `null` | `null` | +| `""` | `null` | +| `" "` | `null` | +| `"AlphaEngineer"` | `"AlphaEngineer"` | +| `" AlphaEngineer "` | `"AlphaEngineer"` | +| `"Alpha Engineer"` | `"Alpha Engineer"`（中间空格**不折叠**） | + +未做：大小写转换、中间空格折叠、SQL 拼接、Repository 改动、Specification 改动、Controller 改动、 +排序/分页/薪资/城市/状态语义改动、公开岗位范围改动。 + +## 8. 新增测试方法名 + +`mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java` +（9 项，走**真实链路** HTTP → SecurityFilterChain → JobController → JobService → JobRepository）： + +`plainKeywordFindsPublishedJob`、`trimmedKeywordFindsSamePublishedJob`、`blankKeywordBehavesAsNoKeyword`、 +`emptyKeywordBehavesAsNoKeyword`、`nullOrMissingKeywordListsPublishedJobs`、 +`draftJobNeverAppearsAfterNormalization`、`normalizationDoesNotChangePagination`、 +`normalizationDoesNotChangeExistingSortContract`、`listJobsIsReadOnly` + +夹具：1 条标题含 `AlphaEngineer` 的 PUBLISHED + 2 条其它 PUBLISHED + 1 条 DRAFT + 1 条 CLOSED； +唯一前缀 `DEF01KEYWORD_`；清理**只按显式登记的主键**，不使用 `deleteAll()`；不依赖执行顺序。 + +## 9. 修复前失败结果 + +以**变异验证**给出权威的修复前证据（把 `normalizedKeyword` 改回 `keyword`，其余不动）： + +``` +Tests run: 9, Failures: 4, Errors: 0, Skipped: 0 + JobListKeywordNormalizationIntegrationTest.trimmedKeywordFindsSamePublishedJob FAIL + JobListKeywordNormalizationIntegrationTest.blankKeywordBehavesAsNoKeyword FAIL + JobListKeywordNormalizationIntegrationTest.normalizationDoesNotChangePagination FAIL + JobListKeywordNormalizationIntegrationTest.normalizationDoesNotChangeExistingSortContract FAIL +``` + +即 **trim 与 blank 两类断言在缺失修复时必然失败**（≥2 项，满足要求）。 + +## 10. 修复后结果 + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="JobListKeywordNormalizationIntegrationTest" test` | **9 / 0 / 0 / 0** | +| `mvn -Dtest="*Job*Test,*JobSearch*Test" test` | **219 / 0 / 0 / 0** | + +## 11. 真实 MySQL HTTP 结果 + +最新 JAR（`mvn clean verify` 产物）+ 真实 MySQL/Redis/RabbitMQ，前缀 `DEF01_20260920_`： +**11 / 11 通过**。 + +| 断言 | 实测 | +|---|---| +| 普通关键词 HTTP 200 且只命中目标 | `200, [target]` ✔ | +| 两侧空白与普通关键词：ID/顺序/数量一致 | `pad=[T] plain=[T]` ✔ | +| 纯空白与无关键词：ID/顺序/总数一致 | `blank == none` ✔ | +| 空字符串与无关键词：一致 | `empty == none` ✔ | +| DRAFT 不进入公开结果 | `statuses=['PUBLISHED']` ✔ | +| 分页 metadata 不因规范化变化 | `total=1,page=0,size=1,totalPages=1` ✔ | +| 默认排序不变（夹具 createdAt 降序） | `none == blank`，desc ✔ | +| 不返回 4xx/5xx | `[200]×7` ✔ | +| 响应不泄露 SQL/异常/路径/堆栈 | `leaks=[]` ✔ | +| 对照 `/jobs/search` 的 trim/blank 语义一致 | `pad==plain`、`blank==全部` ✔ | +| 请求前后数据库逐字段零变化 | `changed=none` ✔ | + +## 12. 变异测试结果 + +- 保存 `JobService.java` **原始字节**（sha256 前 16 位 `b4fab0034b34d569`，14 699 字节）； +- 变异：`findPublishedJobs(normalizedKeyword, …)` → `findPublishedJobs(keyword, …)`； +- 结果：**4 项失败**（见 §9）； +- **按原始字节精确恢复**（**未使用** `git restore` / `git checkout`），恢复后 sha 一致； +- 复跑新增测试 **9/9 绿**；校验无变异残留（`findPublishedJobs(keyword,` 计数 = 0， + `String normalizedKeyword =` 计数 = 1）。 + +## 13. 岗位关联回归 + +`mvn -Dtest="*Job*Test,*JobSearch*Test" test` → **219 / 0 / 0 / 0**（未修改或删除任何既有断言）。 + +## 14. 全量测试数 + +| 命令 | Tests | Failures | Errors | Skipped | BUILD | +|---|---|---|---|---|---| +| `mvn test` | **2797** | 0 | 0 | 0 | SUCCESS | +| `mvn clean verify` | **2797** | 0 | 0 | 0 | SUCCESS | + +`2797 = 2788（基线）+ 9（本轮新增）`，满足「不低于 2788 + 新增数」。 +Testcontainers MySQL 用例实际执行（`Skipped=0`）。 + +## 15. OpenAPI + +``` +python ..\docs\verify_openapi.py → paths: 176 / operations: 214 / All checks passed! +``` + +`docs/openapi-rc.json` **未修改**（`git diff` 为空）。 + +## 16. 数据副作用 + +- 黑盒前后 7 张表（jobs / companies / users / user_roles / audit_logs / notifications / applications） + **逐字段零变化**； +- 单测 `listJobsIsReadOnly` 对 5 张表逐字段零变化； +- 夹具残留 **0**；历史未跟踪文件与历史数据（含 `users.id` 7938/7939 的 `user_roles`）完好； +- `audit_logs` **未删除任何行**。 + +## 17. 精确修改文件 + +``` +M mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java （+7 −1） +?? mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java （新增，9 项） +?? docs/def-01-job-keyword-normalization-remediation-20260920.md （本报告） +?? docs/final-independent-acceptance-20260918.md （追加 DEF-01 章节） +``` + +## 18. Git 状态（整改与复验阶段） + +| 项 | 结果 | +|---|---| +| 生产代码改动 | **仅 `JobService.java` 1 个文件** | +| `JobRepository` / `JobSearchSpecification` / `JobController` | **零修改** | +| 其他生产模块 / Flyway / `pom.xml` / `openapi-rc.json` | **零修改** | +| 验收脚本与原始产物 | **零修改** | + +## 19. 未涉及范围 + +未进入：简历隐私矩阵、管理员初始化矩阵、Q01 H2/MySQL 对账与 EXPLAIN 分表、写侧刷新链路 +（四项 SKIP 仍待验收）。 + +## 20. 本轮测试自身缺陷（非产品缺陷，已修正并记录） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| T-1 | 「带空白关键词」用例恒返回空 | **测试缺陷**：MockMvc 对 URL 模板二次编码（`%20` → `%2520`），测的是字面量 `%20` 而非空白参数 | 改用 `.param()` 传参 | +| T-2 | 分页/排序断言随更大范围运行而失败 | **测试缺陷**：断言了既有契约**不保证**的顺序 —— 默认排序 `createdAt DESC` 无 tiebreaker，并列时入选子集与顺序均不稳定 | 夹具改用**显式互异 `created_at`**；分页用例只断言确定性元数据 | +| T-3 | 黑盒夹具未创建 | **脚本缺陷**：`seed_sms_codes/login` 使用 `lib.phone()`（`199000` 号段），而建公司语句另写了 `199002` 号段，两者是**不同号码**，公司被挂到不存在的用户上（号码为本地验收自建夹具，报告中脱敏） | 统一为 `lib.phone(CO)` | +| T-4 | 黑盒「默认排序」断言失败 | **脚本缺陷**：把「关键词过滤后的结果」与「无关键词的完整结果」做相等比较，语义不同 | 只比较同为未过滤的 `none` 与 `blank` | + +## 21. 明确声明 + +**未修改** `/jobs/search`、`JobSearchSpecification`、`JobRepository` JPQL、Controller 路由、 +排序/分页/薪资/城市/状态过滤、DTO、OpenAPI、`ErrorCode`、`SecurityConfig`、V1–V45、`pom.xml`； +**未新增 V46**；**未修改任何既有测试断言**；**未**执行 `git reset/restore/checkout/clean`； +**未**使用 `git add -A` / `git add .` / 目录级暂存；**未**删除或移动历史未跟踪文件。 + +本报告与 `docs/final-independent-acceptance-20260918.md` 的 DEF-01 追加章节于提交前保持**待提交**状态。 diff --git a/docs/enterprise-talent-discovery-api.md b/docs/enterprise-talent-discovery-api.md new file mode 100644 index 0000000..f0e598b --- /dev/null +++ b/docs/enterprise-talent-discovery-api.md @@ -0,0 +1,53 @@ +# V41 企业人才发现 API + +V41 提供学生显式授权和企业岗位候选人发现。学生授权默认关闭；企业必须已认证，岗位必须属于当前企业、处于 `PUBLISHED`，并且具有 V39 `enabled=true`、`APPROVED` 的岗位画像。 + +## 接口 + +| 方法 | 路径 | 权限 | +|---|---|---| +| GET | `/profile/me/talent-discovery` | STUDENT，仅本人 | +| PUT | `/profile/me/talent-discovery` | STUDENT，仅本人 | +| GET | `/companies/me/jobs/{jobId}/talent-recommendations` | 已认证 COMPANY，且岗位属于本人 | + +统一前缀为 `/api/v1`。身份从 JWT subject 获取，客户端不得传 `studentUserId`、`companyId` 或 `candidateId`。 + +## 学生开关 + +无记录的 GET 返回 `enabled=false、version=0`，不会自动写库。PUT 请求体： + +```json +{"enabled":true,"expectedVersion":0} +``` + +`expectedVersion` 可省略；已有记录传入后必须匹配当前版本。并发冲突复用 `409/9201`。成功只记录 `TALENT_DISCOVERY_PREFERENCE_UPDATED`，审计 details 仅包含 `enabled/version/requestId`。 + +## 企业候选列表 + +`page` 从 0 开始，`size` 为 1–50。岗位画像不可用时返回 `mode=UNAVAILABLE`；没有合格候选时返回 `mode=NO_ELIGIBLE_CANDIDATE`。正常返回 `mode=PERSONALIZED`。 + +候选池排除：未授权学生、注销限制账号、无基础档案、曾向当前企业任一岗位投递过的学生（包括 WITHDRAWN/REJECTED）。其他企业的投递不影响当前企业发现。 + +PREFERENCE/RIASEC/ABILITY 三个信号按 40/35/25 计算，缺失信号不按 0 处罚而重新归一化；至少一个有效信号才进入列表。RIASEC 和能力只读取最新完成结果，能力结果还必须未过期；不读取答案、题目、答案键、评分规则或标签。服务端先计算全部候选并全局排序，再分页，保证分页正确。 + +企业候选卡仅返回： + +```json +{ + "candidateKey":"…", + "candidateLabel":"开放人才候选人", + "city":"合肥", + "education":"本科", + "graduationYear":2027, + "skills":["Java","Spring Boot"], + "fitBand":"HIGH", + "summary":"岗位画像与候选人公开资料存在较高匹配度", + "signalsAvailable":["PREFERENCE","RIASEC","ABILITY"] +} +``` + +不返回学生 ID、姓名、联系方式、简历、测评分数、候选评分、结果/答卷 ID 或岗位画像原始权重。`candidateKey` 为 HMAC-SHA256、按公司/岗位/学生/日期桶隔离的不透明展示键，本版没有用它换取详情或联系方式的接口。 + +## 版本与边界 + +V41 新增 Flyway `V39__enterprise_talent_discovery.sql`，不修改 V1–V38，不写 `candidate_dimension_scores`，不新增 feature flag、ErrorCode、消息或推荐历史。OpenAPI 由 159/196 增至实际 **161/199**（两个唯一 path、三个 operation）。自动化测试 1461/1461 通过；真实 MySQL/Docker 黑盒已通过（`PASS=37 / FAIL=0`）。 diff --git a/docs/enterprise-talent-invitation-api.md b/docs/enterprise-talent-invitation-api.md new file mode 100644 index 0000000..a43862c --- /dev/null +++ b/docs/enterprise-talent-invitation-api.md @@ -0,0 +1,59 @@ +# V42 企业人才邀约与授权沟通 API + +V42 允许已认证企业使用 V41 生成的 `candidateKey` 向开放人才候选人发起站内邀约；学生明确接受后才建立 `TALENT_INVITATION` 会话。候选人身份、测评明细和联系方式始终不向企业公开。 + +## 接口清单 + +| 方法 | 路径 | 身份 | 说明 | +| --- | --- | --- | --- | +| POST | `/companies/me/jobs/{jobId}/talent-invitations` | 已认证 COMPANY | 创建邀约 | +| GET | `/companies/me/talent-invitations` | 已认证 COMPANY | 分页查看本公司邀约 | +| GET | `/companies/me/talent-invitations/{invitationId}` | 已认证 COMPANY | 查看本公司邀约详情 | +| GET | `/profile/me/talent-invitations` | STUDENT | 分页查看本人收到的邀约 | +| GET | `/profile/me/talent-invitations/{invitationId}` | STUDENT | 查看本人邀约详情 | +| POST | `/profile/me/talent-invitations/{invitationId}/decision` | STUDENT | 接受或拒绝邀约 | + +V42 新增 6 个 path、6 个 operation；静态 OpenAPI 基线为 167 paths / 205 operations。 + +> 验收状态：真实 MySQL/Docker 黑盒通过（`PASS=76 / FAIL=0`）；运行时与静态 OpenAPI 均为 167 paths / 205 operations，待 Git 检查点。 + +## 创建邀约 + +```json +{ + "candidateKey": "V41-generated-opaque-key", + "message": "欢迎了解我们的后端开发岗位。", + "idempotencyKey": "3c989a31-6774-4520-9700-e58416cc1845" +} +``` + +服务端重新确认企业认证、岗位归属和 `PUBLISHED` 状态、岗位画像 `enabled=true && APPROVED`、候选授权、账号状态、当前企业全部历史投递排除和至少一个有效信号。`candidateKey` 按 V41 相同密钥、时区和日期桶重算，并使用常量时间比较；请求不得携带学生 ID。 + +邀约有效期为 7 天。相同公司和幂等键的相同请求返回原邀约，不重复占用限额；同键不同业务内容返回 `409/10207`。每公司每岗位每天最多 20 次、每公司每天最多 100 次成功创建；同企业同学生终态后 30 天内不可再次邀约。 + +`message` 去首尾空白后为 1–300 字符，禁止手机号、邮箱、URL、微信/QQ 等外部联系方式。无效文案统一返回 `400/10208`，不写入邀约。 + +## 学生决策 + +```json +{ + "decision": "ACCEPT", + "expectedVersion": 0 +} +``` + +只有未过期 `PENDING` 可决策。`ACCEPT`、`REJECT`、到期 `EXPIRED` 采用条件更新和版本控制；并发请求只有一方能改变状态。接受时若任一方向存在屏蔽，返回 `403/2002` 且保持 `PENDING`。接受成功后在同一事务中创建唯一会话和两条成员记录；拒绝、过期不创建会话。 + +学生详情包含 `version`，只有 `ACCEPTED` 返回 `conversationId`。企业端不返回 `candidateKey`、`studentUserId`、`candidateKeyDigest`、`activeKey`、测评/评分字段或拒绝内部原因。 + +## 会话隐私 + +`TALENT_INVITATION` 会话仅由接受流程的内部组件创建，不开放传学生 ID 的公网入口。既有 `DIRECT` 会话的 MATCHED 守卫保持不变。会话、消息列表和发送响应对邀约会话仅返回 `CURRENT_USER`/`OTHER_PARTICIPANT` 相对身份，不返回 `createdBy` 或 `senderUserId`，也不提供学生姓名、联系方式或简历信息。 + +## 错误码 + +`10201` 不存在或无权查看；`10202` 候选当前不可邀约；`10203` 活跃/冷却冲突；`10204` 状态不允许决策；`10205` 已过期；`10206` 版本或条件更新冲突；`10207` 幂等键业务内容冲突；`10208` 请求或文案非法；`10209` 达到每日限额。角色、归属和屏蔽继续使用 `401/2001`、`403/2002`。 + +## 事务与数据边界 + +创建事务先锁定公司行，再执行幂等、冷却、限额和写入；数据库唯一约束作为最终防线。过期转换使用独立事务，确保 `EXPIRED`、释放 `activeKey`、history 和审计先提交再返回错误。V42 不写 `candidate_dimension_scores`，不发送 RabbitMQ 通知，不保存候选人联系方式或正文以外的敏感数据。 diff --git a/docs/final-independent-acceptance-20260918.md b/docs/final-independent-acceptance-20260918.md new file mode 100644 index 0000000..7e2dea3 --- /dev/null +++ b/docs/final-independent-acceptance-20260918.md @@ -0,0 +1,2250 @@ +# 职来后端 S01/S02/S03/Q01/R01 全项目**最终独立总验收**报告 + +日期：2026-09-18 +性质：**只验收，不开发**。未修改生产代码、未修改已有测试断言、未改 V1–V45、未新增 V46、 +未改 `ErrorCode`/DTO/接口/OpenAPI/`pom.xml`、未执行任何 `git reset|restore|checkout|clean|add -A`。 +未暂存、未提交、未推送、未合并。 + +--- + +## 0. 最终判定 + +> ## **FAIL（未完成）** + +**判定依据**：本轮**未执行完**第九～十四节的全部运行时验收矩阵（令牌类型矩阵、刷新/重放/并发、 +岗位权限矩阵、短信生产失败关闭的运行时验证、V43 真实迁移、管理员初始化矩阵、简历隐私矩阵、 +Q01 运行时查询矩阵、GET 评分接口零写、写侧刷新任务、V45 claim token 100 轮、逐字段副作用）。 +按本轮验收规则「任一核心项 FAIL 或 SKIP：总结必须写 FAIL」，**不得**标记为通过。 + +**已完成且通过的项**见 §2；**未执行项**见 §9。本文不使用「基本通过」。 + +**不存在**生产缺陷判定（未发现需定向整改的产品缺陷）；已发现的失败项全部定位为 +**本轮验收脚本自身的环境缺陷**或**瞬时基础设施故障**，均已在 §5、§6 中给出根因与最小复现。 + +--- + +## 1. 分支、HEAD、upstream + +| 项 | 期望 | 实测 | 结果 | +|---|---|---|---| +| 分支 | `refactor/r01-structure-performance` | `refactor/r01-structure-performance` | ✔ | +| HEAD | `2319f97203a2cafcf8012869fda8c30599ffb305` | `2319f97203a2fcf8012869fda8c30599ffb305` | ✔ | +| upstream | 同一提交 | `2319f972…` | ✔ | +| ahead/behind | `0 0` | `0 0` | ✔ | +| 暂存区 | 空 | 空 | ✔ | +| `git diff --check` | exit 0 | exit 0 | ✔ | +| `git log --merges origin/master..HEAD` | 空 | 空 | ✔ | + +### 1.1 两处 `M` 假阳性的三方 blob 验证 + +`git status --short --untracked-files=no` 曾显示这两个文件为 `M`。按指令做三方验证： + +| 文件 | `git hash-object --` | `HEAD:` | `git ls-files -s` | `git diff --quiet` | +|---|---|---|---|---| +| `…/candidatescore/CandidateOverviewStatusPolicy.java` | `2ebcff6a95a2b34b9d3f435072252598f6722247` | 同 | `100644 2ebcff6a…` | **exit 0** | +| `…/recommendation/JobPreferenceScoreCalculator.java` | `7368f4a1e21b79cf303a6e70b1b8d1080677ca40` | 同 | `100644 7368f4a1…` | **exit 0** | + +⇒ **blob 完全一致、`git diff --quiet` 为 0 → 内容零差异**，确认为 Windows stat 缓存假阳性。 +**未**对这两个文件执行 `restore` 或重新保存。终检时 `git diff --name-only` 已为空。 + +--- + +## 2. 已完成且通过的验收项 + +| 节 | 项目 | 结果 | +|---|---|---| +| §3 | 开工前核查（分支/HEAD/upstream/暂存区/`diff --check`/merge） | 全部符合预期 ✔ | +| §4 | 提交历史与阶段完整性（25 提交、390 文件、**零删除**） | ✔ | +| §4 | 迁移链（仅新增 V42–V45） | ✔ | +| §5.1 | S01 静态安全 | ✔ | +| §5.3 | S03 静态安全（Actuator/隐私/bootstrap/V43） | ✔ | +| §6 | Docker 基础设施 | ✔ | +| §7.1 | R01-E 门禁 | **42 / 0 / 0 / 0** ✔ | +| §7.2 | 领域关键测试 | **932 / 0 / 0 / 0** ✔ | +| §7.3 | `mvn test` | **2788 / 0 / 0 / 0** ✔ | +| §7.3 | `mvn clean verify` | 首次 FAIL / 重跑 **2788 / 0 / 0 / 0 SUCCESS**（见 §5） | +| §7.4 | OpenAPI 静态 | **176 paths / 214 operations**，`All checks passed!` ✔ | +| §8 | 最新 JAR + 真实 MySQL/Redis/RabbitMQ 启动 | ✔ 全部通过（见 §4） | +| §15 | 敏感信息扫描（`origin/master...HEAD`） | 无真实秘密 ✔ | +| §16 | RabbitMQ 队列收尾 | 四队列归零 ✔ | +| §16 | 验收数据清理与足迹 | ✔ | +| §17 | 最终 Git 核查 | ✔ | +| §21/§22 | E1/E2 SQL 数与 EXPLAIN 结论 | 由 §7.1 的 42 项门禁覆盖 ✔ | + +--- + +## 3. 关键提交清单与阶段映射 + +25 个提交（`origin/master..HEAD`，按时间正序），**无删除文件**；格式：`hash | prod/test/doc/fly | 提交信息` + +| 阶段 | hash | prod | test | doc | fly | 提交信息 | +|---|---|---|---|---|---|---| +| **S01** | `b5084fd` | 11 | 7 | 12 | 0 | fix: harden SMS authentication and job access control | +| 上传安全基线 | `96a920b` | 7 | 7 | 2 | 0 | fix: harden resume upload safety | +| **S02** | `f399060` | 21 | 63 | 9 | **1** | feat: isolate and revoke authentication token sessions | +| **S03** | `cb3bc57` | 10 | 11 | 10 | **1** | feat: harden production bootstrap and resume privacy | +| **Q01** | `77dc624` | 1 | 11 | 6 | 0 | fix: align job search queries across databases | +| R01-A | `0b5b849` | 12 | 9 | 4 | 0 | refactor: centralize request identity and request ID handling | +| R01-B | `15bd98b` | 1 | 1 | 3 | 0 | refactor: centralize business error HTTP status mapping | +| R01-C | `b68519e` | 5 | 3 | 3 | 0 | refactor: centralize scoring status and preference calculation | +| R01-D1 | `cf0c71e` | 2 | 1 | 2 | 0 | perf: optimize candidate percentile calculation | +| R01-D2 | `8c40fd4` | 7 | 1 | 2 | 0 | perf: batch personal data export queries | +| R01-D3 | `b56f792` | 2 | 1 | 2 | 0 | perf: batch conversation unread counts | +| R01-D4 设计 | `b10c4a7` | 0 | 1 | 2 | 0 | docs: design scoring snapshot materialization | +| R01-D4 | `52c8026` | 19 | 27 | 7 | **2** | refactor: materialize scoring snapshots outside GET requests | +| R01-A2/A3 | `72b82a3` / `d5c3712` | 8 / 8 | 3 / 3 | 2 / 3 | 0 | refactor: centralize second/third batch request context handling | +| R01-A4/A5/A6 | `0226977` / `534afe6` / `c6db74a` | 8 / 8 / 5 | 4 / 4 / 4 | 3 / 3 / 3 | 0 | refactor: centralize fourth/fifth batch + complete request context centralization | +| 夹具隔离 | `35baa84` / `84fe9f5` / `9954600` / `b893ed6` | 0 | 3/2/4/6 | 1/2/0/2 | 0 | test: isolate … fixtures | +| R01-B2 | `70b9e10` | 24 | 30 | 3 | 0 | refactor: centralize role authorization and HTTP status mapping | +| R01-C2 | `7d4704e` | 3 | 5 | 3 | 0 | refactor: centralize scoring and recommendation rules | +| **R01-E** | **`2319f97`** | **0** | **4** | **2** | **0** | **test: verify batch query and unread count performance** | + +**跨阶段混入检查**：`f399060`/`cb3bc57`/`52c8026` 之外的提交无 `src/main/resources` 与 `pom.xml` 变更。 +`cb3bc57` 修改了 `mydreamjob-server/pom.xml`，diff 内容为**仅新增** `io.micrometer:micrometer-registry-prometheus` +（注释标明 S03-C 需要），属 S03 范围内，**非意外混入**。无删除文件。 + +--- + +## 4. 迁移 V42–V45 说明与 V1–V41 未修改证明 + +| 迁移 | 用途 | 引入提交 | +|---|---|---| +| `V42__auth_token_sessions.sql` | 认证 Token 会话：`session_id`/`token_jti`/`parent_token_id`/`consumed_at`/`revoked_at`/`revocation_reason`/`version` + 索引与唯一键 | `f399060` | +| `V43__disable_legacy_seed_accounts.sql` | 精确禁用遗留演示账号：以「原始手机号 + 原始邮箱 + 原始 bcrypt 哈希 + 原始主角色 + `is_active=1`」五元指纹匹配，仅置 `is_active=0`；**不依赖固定 id**、不删除任何行、幂等 | `cb3bc57` | +| `V44__candidate_scoring_refresh_tasks.sql` | 评分快照刷新任务表 + 补偿扫描游标表 | `52c8026` | +| `V45__add_scoring_refresh_claim_token.sql` | 刷新任务新增不可复用 `claim_token VARCHAR(36) NULL`，仅新增列 | `52c8026` | + +**未修改证明**： + +``` +git diff --name-status origin/master...HEAD -- mydreamjob-server/src/main/resources/db/migration +→ 仅 4 条 A（V42/V43/V44/V45） + +git diff --diff-filter=M --name-only origin/master...HEAD -- → 空（V1–V41 零修改） +git diff --diff-filter=D --name-only origin/master...HEAD -- → 空（零删除） +ls | wc -l → 45；V46 → 不存在 +``` + +--- + +## 5. 自动化测试：总数、F/E/S 与首次失败/重跑记录 + +| # | 命令 | Tests | Failures | Errors | Skipped | BUILD | +|---|---|---|---|---|---|---| +| §7.1 | R01-E 门禁（4 类） | **42** | 0 | 0 | 0 | SUCCESS | +| §7.2 | 领域关键测试（17 个模式） | **932** | 0 | 0 | 0 | SUCCESS | +| §7.3a | `mvn test` | **2788** | **0** | **0** | **0** | SUCCESS | +| §7.3b | `mvn clean verify`（**首次**） | 2788 | **0** | **2** | 0 | **FAILURE** | +| §7.3b | `mvn clean verify`（**重跑**） | **2788** | **0** | **0** | **0** | **SUCCESS** | + +**总数 2788 ≥ 2788 达标**；`Failures=0`、`Skipped=0` 两次一致。 + +### 5.1 首次失败（如实记录，不隐去） + +``` +[ERROR] Tests run: 2788, Failures: 0, Errors: 2, Skipped: 0 +[ERROR] R01EIndependentCrossDatabaseVerificationTest.resetBothEngines:162->clearFixture:493 ? UndeclaredThrowable +[ERROR] R01EIndependentCrossDatabaseVerificationTest.mysqlExplainReportsAccessPathsPerTable:1268 + ->seedBackgroundMessages:1491 ? TransientDataAccessResource + PreparedStatementCallback; SQL [INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) VALUES (?,?,?,?,?)]; + No operations allowed after statement closed. +Caused by: com.mysql.cj.exceptions.StatementIsClosedException: No operations allowed after statement closed. + at com.mysql.cj.jdbc.ClientPreparedStatement.clearBatch(ClientPreparedStatement.java:279) + ... +HikariPool-39 - Failed to validate connection com.mysql.cj.jdbc.ConnectionImpl@… (No operations allowed after +connection closed.). Possibly consider using a shorter maxLifetime value. +``` + +**失败性质判定（按指令三分类）**： + +- **断言失败？** 否 —— `Failures: 0`，无任何断言不成立。 +- **产品失败？** 否 —— 失败点全部位于**测试自身夹具写入**（`seedBackgroundMessages` 的批量 INSERT） + 与夹具清理（`clearFixture`），不涉及生产代码路径；同批次其余 2786 项全绿。 +- **容器生命周期错误？** **是** —— 为 MySQL 驱动侧 `StatementIsClosedException` 与 Hikari + 连接校验失败，典型的连接被服务端/连接池提前关闭。 + +**原始证据已保存**（首次失败日志与 surefire 报告）： +`target/surefire-reports/com.mydreamjob.common.r01e.R01EIndependentCrossDatabaseVerificationTest.txt` +及对应 XML，以及完整 `mvn clean verify` 日志副本。 + +**重跑前置检查**：`docker info` Server 29.6.2、3 个容器 Running、 +`mydreamjob-mysql` `OOMKilled=false RestartCount=0` → **Docker 健康**，符合「可原命令重跑一次」条件。 + +**重跑结果**：**2788 / 0 / 0 / 0，BUILD SUCCESS（8:50）**，同一错误**未复现**。 +按指令「若同一错误重复出现，不得继续重跑掩盖」——本错误**未重复**，故不继续重跑。 + +### 5.2 由此产生的新观察项 + +见 **OBS-NEW-01**（§8）。 + +--- + +## 6. 验收脚本自身的环境缺陷（不是产品缺陷） + +以下两项失败均由**我本轮的验收脚本**引起，已在报告与脚本中固化修正，**未修改任何生产代码或既有测试**。 + +### 6.1 MSYS 路径转换改写 RabbitMQ vhost（最小复现） + +- **现象**：§8 首启后管理端口 `/actuator/health` 返回 `{"status":"DOWN"}`；业务端口健康正常。 +- **最小复现**：在 Git Bash 中以 `RABBITMQ_VHOST=/`（来自 `backend-infra/.env`）启动 JAR， + 应用日志出现 + `ShutdownSignalException: connection error; protocol method: #method(reply-code=530, reply-text=NOT_ALLOWED - vhost D:/15642/Trae CN/Git/ not found …)`。 +- **根因**：MSYS 把环境变量 `RABBITMQ_VHOST=/` 转换成了 Windows 路径，应用连到不存在的 vhost。 + 容器实际只有 vhost `/`（`rabbitmqctl list_vhosts` → `/`）。 +- **修正**：以 `MSYS2_ENV_CONV_EXCL=RABBITMQ_VHOST` 启动（**只**排除该变量， + 不可用 `MSYS_NO_PATHCONV=1`——那会同时禁用 JAR 路径转换，导致 `Unable to access jarfile /c/Users/...`）。 +- **修正后**：`/actuator/health` → `{"status":"UP"}` HTTP 200，RabbitMQ 错误计数归零。 +- **结论**：**产品无缺陷**；属验收环境缺陷。 + +### 6.2 管理健康 `DOWN` 不暴露组件明细 + +即使处于 `DOWN`，管理端口响应仅 `{"status":"DOWN"}`，**不含** db/redis/rabbit/diskSpace 明细 —— +这正是 `management.endpoint.health.show-details: never` 的预期行为 ✔。 + +--- + +## 7. §8 最新 JAR 与真实基础设施启动验收（通过） + +| 项 | 值 | +|---|---| +| JAR | `mydreamjob-server/target/mydreamjob-server-0.0.1-SNAPSHOT.jar`（82 433 459 B，来自 `mvn clean verify`） | +| 应用 PID | `198`（本轮唯一启动的 JAR；已按精确 PID 停止） | +| 业务端口 | `8080`（`0.0.0.0`） | +| 管理端口 | `8081`（**仅 `127.0.0.1`**，`netstat` 实测） | +| 启动耗时 | `Started MyDreamjobApplication in 15.963 seconds` | +| Flyway | 启动成功、schema 迁移状态正常（仅 Flyway 对 MySQL 8.4 的「升级建议」告警） | +| Hibernate | `ddl-auto=validate` 通过（否则启动失败） | +| SMS | `app.sms.mock.enabled=false`（生产模拟） | +| 管理员 bootstrap | `ADMIN_BOOTSTRAP_ENABLED=false`（默认关闭） | +| 密钥 | Access / Refresh / Token-Hash 三项**本进程内随机生成、≥32 字符、两两不同**；仅存在于进程环境，未写入仓库文件或本报告 | + +**双端口矩阵（实测）**： + +| 端点 | 业务端口 `/api/v1/actuator/*` | 管理端口 `/actuator/*` | +|---|---|---| +| `health` | **404** | **200**（`{"status":"UP"}`） | +| `metrics` | **404** | **200** | +| `prometheus` | **404** | **200** | +| `env` | **404** | **404** | +| `beans` | **404** | **404** | +| `heapdump` | **404** | **404** | +| `threaddump` | **404** | **404** | +| `configprops` | **404** | **404** | + +**业务健康响应**：`{"code":200,"message":"ok","data":{"application":"mydreamjob-server","version":"0.0.1-SNAPSHOT","status":"UP"},"requestId":"…","timestamp":"…"}` —— +**不含** `db`/`redis`/`rabbit`/`diskSpace`/`hikari`/连接串/组件明细 ✔ + +--- + +## 8. 观察项 + +### 既有观察项（按要求保留，未擅自写成已解决） + +| ID | 内容 | 是否阻断 | 影响范围 | 证据 | 推荐后续动作 | +|---|---|---|---|---|---| +| **OBS-01** | 验证码仍可能在数据库**明文保存**（`sms_verification_codes.code`） | 否（既有设计） | 数据库静态数据泄露面 | `V1__base_schema.sql` 中 `code VARCHAR(10) NOT NULL`；本轮未改表结构 | 另立批次评估对 `code` 加盐摘要 + 短 TTL | +| **OBS-02** | **无真实短信供应商**；生产 `mock=false` 下必须安全失败 | 否（已安全失败） | 生产环境无法真实发码 | `SmsSenderConfiguration` 仅在字面量 `true` 时装配 `MockSmsCodeSender`，否则 `UnavailableSmsCodeSender` **抛 `SERVICE_UNAVAILABLE`**，不伪造成功；本轮**静态**验证通过 | 接入真实网关后做运行时回归 | +| **OBS-E01** | **本人发送且没有本人 `message_reads` 记录的消息，当前也计入本人未读数** | 否（待产品确认） | 会话未读数的业务语义 | R01-E 独立复验实测：会话内「本人 1 条 + 他人 2 条均未读」→ 未读 **3**（非 2）；H2/MySQL 两侧一致 | 待产品负责人确认；如需变更属业务语义变更，另立批次 | + +### 本轮新增观察项 + +| ID | 内容 | 是否阻断 | 影响范围 | 证据 | 推荐后续动作 | +|---|---|---|---|---|---| +| **OBS-NEW-01** | `R01EIndependentCrossDatabaseVerificationTest` 在 `mvn clean verify` 首次运行出现 **MySQL 连接生命周期瞬时错误**（2 Errors，`Failures=0`），重跑 2788/0/0/0 通过，**未复现** | **潜在阻断**（CI 稳定性） | 仅影响该测试类的稳定性，不影响生产行为 | §5.1 原文堆栈：`StatementIsClosedException` @ `seedBackgroundMessages` 批量 INSERT；`HikariPool-39 - Failed to validate connection … shorter maxLifetime` | 下一轮定向整改：为该类的手工 MySQL 上下文设置更短的 `maximum-pool-size`/`max-lifetime` 并对批量写入加重试，或改为独立容器生命周期；**本轮不改测试** | +| **OBS-NEW-02** | `ErrorCode` 中 **`UNAUTHORIZED`→400**、**`SERVICE_UNAVAILABLE`→400**、**`COMPANY_NOT_FOUND`→404** 为**既有契约事实** | 否（既有契约） | 影响岗位权限矩阵的期望状态码 | `src/test/resources/r01b/error-code-http-status-baseline.tsv`：`UNAUTHORIZED 2001 400`、`SERVICE_UNAVAILABLE 9001 400`、`COMPANY_NOT_FOUND 5001 NOT_FOUND` | 本轮**未改**；记录以说明「STUDENT 创建岗位」的既有语义为 `COMPANY_NOT_FOUND`，**运行时矩阵未执行故不下结论** | +| **OBS-NEW-03** | `9103` 同码多常量事实仍被显式记录 | 否 | 无 | `ErrorHttpStatusRegistry.java` 注释「同一数字码对应多个常量是**既有事实**（9103）」；`ErrorCode.REVIEW_ALREADY_DECIDED(9103, …)`、`DUPLICATE_FEEDBACK(9103, …)` | 保持 | + +--- + +## 9. **未执行**的验收项（本轮 FAIL 的直接原因） + +下列项目本轮**未执行**，因此**不得**判定为通过。每项给出续跑方式。 + +| 节 | 未执行项 | 续跑方式 | +|---|---|---| +| §7.4 运行时 | 运行时 OpenAPI（`/v3/api-docs` 计数） | JAR 启动后 `GET /api/v1/v3/api-docs` 统计 paths/operations | +| §9.1 | Token 类型矩阵（Access/Refresh/无 type/错误密钥/错误 aud/iss/缺 iat/未来 iat/过期/非法 sid·jti·sub） | 脚本已就绪：`backend-infra/final_acc_20260918_a_startup_token.py`（`§8`+`§9`）；需 JAR 运行 | +| §9.2 | 10 轮双客户端并发刷新、重放、活动 Refresh=0、无锁异常 | 同上脚本 `section9_concurrency()` | +| §9.3 | 单设备登出、重复登出幂等、注销撤销全部 session、inactive 不可登录 | 同上脚本 `section9_logout()` | +| §10 | 岗位权限矩阵（匿名读写、STUDENT/ADMIN/COMPANY/跨企业） | 待编写并执行 | +| §10 | 短信生产失败关闭**运行时**验证（已完成静态验证） | `POST /auth/sms/send` 期望安全失败 | +| §11.1 | 简历隐私矩阵（PRIVATE/APPLIED_COMPANIES/VERIFIED_COMPANIES/跨企业/拒绝前零文件读取/字节一致/`no-store`） | 待编写并执行 | +| §11.2 | 管理员初始化矩阵（默认关闭、非法值、并发双 JAR、事务、无 Token/短信/MQ） | 需隔离配置多次启动 JAR | +| §11.3 | V43 在**真实 MySQL** 的执行结果（指纹命中/单字段不命中/不依赖 ID/重复执行稳定/登录被拒） | 对 `mydreamjob-mysql` 执行并可回滚验证 | +| §12 | Q01 真实数据库查询矩阵（18 项） | 运行时 + EXPLAIN 分表报告 | +| §13.1 | 三个 GET 评分接口的 22 张表逐字段快照（零写） | 待编写并执行 | +| §13.2 | 写侧刷新任务（Offer 过期/Feedback/Resume 等） | 待编写并执行 | +| §13.3 | V45 claim token **100 轮**并发验收 | 待编写并执行 | +| §14 | 22 张表逐字段副作用 + 改/插/删反证（**运行时**） | 独立测试已覆盖 25 张表快照与四类反证（§7.1 通过），但**未**在运行 JAR 上做 | + +**已完成的部分覆盖**：§13.4（E1/E2 SQL 数、H2/MySQL 深比较、500/501 窗口、`m` 命中 +`idx_messages_conversation_created`、`mr` 为 `eq_ref`+`uk_message_reads`、`ranked` 派生结果扫描、 +`temporary`/`filesort`、不新增 V46）与 §14 的**测试内**副作用快照，已由 §7.1 的 42 项门禁覆盖并通过 +（详见 `docs/r01-e-independent-verification-20260918.md`）。 + +--- + +## 10. §15 敏感信息扫描结果（逐条分类） + +**扫描范围**：`git diff origin/master...HEAD` 全量（2 349 103 字符）。 + +| 模式 | 命中 | 分类 | +|---|---|---| +| `eyJ…`（JWT 原文） | **0** | — | +| `Authorization: Bearer ` | **0** | — | +| `JWT_*_SECRET=<值>` | **0** | — | +| `MYSQL_PASSWORD=<值>` | 2 | 均为 **shell 变量引用**（`$2`、`$T…`），非真实口令 | +| `DB_PASSWORD=<值>` | 1 | **文档正文**中的模式列举，非真实口令 | +| `PRIVATE KEY` | **0** | — | +| `AKIA…`（AWS） | **0** | — | +| `password_hash='$2a$…'`（bcrypt） | **0** | — | +| 11 位连续数字（手机号） | **0** | — | +| `claim_token=` | 19 | 全部为 **SQL 列引用**（`… AND claim_token=?`、`SET claim_token=NULL`）与文档描述，**非令牌值** | + +**真实口令比对**：以 `backend-infra/.env` 中 6 个真实值与全部命中逐一比对 → **无一相等**， +故**无真实秘密泄漏** ✔。扫描器已用探针验证有效性（可命中注入的 `Authorization: Bearer`、 +11 位手机号、`DB_PASSWORD=` 等模式）。 + +**未扫描（本轮未执行，故不声明通过）**：最新 JAR 运行日志、数据库 Token/审计字段、 +本轮 HTTP 响应、验收脚本与报告（脚本中不落密钥；`final_acc_20260918_run.sh` 只在进程内生成密钥并写入 +一个**已删除**的临时文件 `.final_acc_secrets.env`）。 + +--- + +## 11. §6/§16 RabbitMQ 队列结果 + +| 队列 | 验收开始前 | 验收结束后 | +|---|---|---| +| `queue.sms.verification` | ready=0 unacked=0 total=0 | ready=0 unacked=0 total=0 | +| `queue.notification` | 0 / 0 / 0 | 0 / 0 / 0 | +| `queue.audit` | 0 / 0 / 0 | 0 / 0 / 0 | +| `queue.notification.dlq` | 0 / 0 / 0 | 0 / 0 / 0 | + +**四队列归零 ✔**，前后一致，无需 purge、无阻断。 + +**基础设施状态**（未重建、未改配置、未删 volume）： + +| 容器 | 镜像 | 端口 | 状态 | +|---|---|---|---| +| `mydreamjob-mysql` | mysql:8.4 | `127.0.0.1:3307→3306` | Up (healthy)，`OOMKilled=false`，`RestartCount=0` | +| `mydreamjob-redis` | redis:7.4-alpine | `127.0.0.1:6379` | Up (healthy) | +| `mydreamjob-rabbitmq` | rabbitmq:3.13-management-alpine | `127.0.0.1:5672`、`127.0.0.1:15672` | Up (healthy) | + +Docker Engine **29.6.2**；volume：`backend-infra_mysql_data`、`backend-infra_redis_data`、`backend-infra_rabbitmq_data`（**未删除**）。 +三个容器以 `docker start <精确容器名>` 启动；**未**执行 `compose down`、未重建、未换镜像、未重置数据库。 + +--- + +## 12. §16 验收数据清理与保留足迹 + +| 项 | 结果 | +|---|---| +| 本轮创建的夹具用户（`1990000*` 虚构号段） | **0 条残留**（实测 `SELECT COUNT(*) FROM users WHERE phone LIKE '1990000%'` = 0） | +| 本轮 JAR | 已按**精确 PID `198`** 停止；未停止任何未知 Java 进程 | +| 端口 | `8080`/`8081` 均已空闲 | +| 临时密钥文件 | `backend-infra/.final_acc_secrets.env` **已删除** | +| 临时扫描文件 | `backend-infra/_finalacc_scan.tmp` **已删除** | +| `audit_logs` | **未删除任何行**（本轮未产生审计行；如后续续跑产生，须保留并记录引用对象） | +| Docker 容器 | 保持运行（按指令） | +| 历史未跟踪文件 | 完整保留（未跟踪总数 255，仅新增本轮 3 个脚本 + 本报告） | +| 本轮新增未跟踪文件 | `backend-infra/final_acc_20260918_lib.py`、`final_acc_20260918_a_startup_token.py`、`final_acc_20260918_run.sh`、`docs/final-independent-acceptance-20260918.md` | + +--- + +## 13. §17 最终 Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` | +| HEAD | `2319f97203a2fcf8012869fda8c30599ffb305`（**未变**） | +| upstream | `2319f972…`（**0 / 0**） | +| 暂存区 | **空** | +| 已跟踪文件修改 | **无**（`git diff --name-only` 空） | +| `git diff --check` | exit 0 | +| V1–V45 迁移修改 | **无** | +| V46 | **不存在** | +| master 合并 | **无**（`git log --merges origin/master..HEAD` 空） | +| commit / push | **未执行** | +| 历史未跟踪文件 | 完整保留 | + +--- + +## 14. 是否具备创建 PR 的条件 + +> **不具备（本轮 FAIL）**。 + +**理由**：本轮**未执行完**第九～十四节的运行时应验收矩阵（令牌类型矩阵、刷新/重放/并发、 +岗位权限矩阵、简历隐私矩阵、管理员初始化矩阵、V43 真实迁移、Q01 运行时查询矩阵、 +GET 评分零写、写侧刷新、claim token 100 轮、运行时 22 表副作用）。按本轮验收规则， +任一核心项 SKIP 即判 FAIL，故**不得**标记为通过。 + +**但需明确**：本轮**未发现任何生产缺陷**。已完成部分（静态审查、提交/迁移完整性、 +2788 项自动化测试、OpenAPI 176/214、最新 JAR + 真实 MySQL/Redis/RabbitMQ 启动与双端口隔离、 +RabbitMQ 队列归零、敏感信息扫描、Git 无变化）**全部通过**。 + +--- + +## 15. 下一轮定向整改指令（不修改生产代码） + +1. **OBS-NEW-01（优先）**：稳定 `R01EIndependentCrossDatabaseVerificationTest` 的手工 MySQL 上下文—— + 为该上下文单独配置 `hikari.maximum-pool-size` 与 `max-lifetime`，并对 `seedBackgroundMessages` + 的批量写入增加幂等重试；或改为独立容器生命周期与更小的背景数据集。目标：`mvn clean verify` + 连续 3 次 `2788/0/0/0`。**仅改测试，不改生产代码。** +2. **补齐 §9**：直接运行已就绪的 `backend-infra/final_acc_20260918_a_startup_token.py` + （先 `bash final_acc_20260918_run.sh start`，**必须以 `MSYS2_ENV_CONV_EXCL=RABBITMQ_VHOST` 启动**）。 +3. **补齐 §10–§13**：按 §9 表格逐项编写执行；§11.2 需要隔离配置下的双 JAR 并发启动； + §13.3 需要 100 轮 claim token 并发。 +4. **补齐 §7.4 运行时 OpenAPI** 与 **§15 运行日志/数据库/响应扫描**。 +5. 全部补齐后重新出报告；OBS-NEW-01 若再现同一错误即判 FAIL，不得继续重跑掩盖。 + +--- + +## 16. 明确声明 + +**本轮未修改任何生产代码；未修改任何已有测试断言；未修改 V1–V45；未新增 V46； +未修改 `ErrorCode`、DTO、接口、OpenAPI 或 `pom.xml`；未修改评分、排名、推荐、邀约、Offer、申诉、 +消息撤回或简历上传语义。** + +**未执行 `git reset` / `git restore` / `git checkout` / `git clean` / `git add -A` / `git add .`。** + +**未暂存、未 commit、未 push、未 merge、未 rebase、未 force push。** + +本报告 `docs/final-independent-acceptance-20260918.md` 保持**未跟踪**。 + +--- +--- + +# 续跑记录（2026-09-18 第二轮，追加） + +本节为**续跑追加**。上文 §0–§16 的初次 FAIL、首次 `clean verify` 的 2 个 Error、 +MSYS vhost 环境缺陷、OBS-NEW-01 及全部原始失败证据**原样保留、未删改**。 + +## 17. 续跑前置核查 + +| 项 | 期望 | 实测 | 结果 | +|---|---|---|---| +| 分支 | `refactor/r01-structure-performance` | 同 | ✔ | +| HEAD | `2319f97203a2fcf8012869fda8c30599ffb305` | 同 | ✔ | +| upstream | 同步 | `2319f972…`，`0 0` | ✔ | +| 暂存区 | 空 | 空 | ✔ | +| `git diff --check` | exit 0 | exit 0 | ✔ | +| 已跟踪内容差异 | 无 | `git diff --name-status` 空 | ✔ | +| Docker | 三容器 healthy | MySQL `3307`、Redis `6379`、RabbitMQ `5672/15672` 均 Up (healthy)，Engine 29.6.2 | ✔ | + +两处生产文件本轮**未再**显示 `M`（`git diff --name-status` 为空），未执行任何覆盖操作。 + +## 18. §3 OBS-NEW-01 稳定性：三轮 `mvn clean verify` + +| 轮次 | 起止 | Tests | Failures | Errors | Skipped | BUILD | `StatementIsClosedException` | Hikari 校验告警 | Docker OOM/重启 | +|---|---|---|---|---|---|---|---|---|---| +| 1 | 17:01:35 → 17:09:52 | **2788** | **0** | **0** | **0** | **SUCCESS** | **0** | 12 | false / 0 | +| 2 | 17:09:52 → 17:19:21 | **2788** | **0** | **0** | **0** | **SUCCESS** | **0** | 12 | false / 0 | +| 3 | 17:19:22 → 17:28:50 | **2788** | **0** | **0** | **0** | **SUCCESS** | **0** | 12 | false / 0 | + +**3/3 通过，硬性要求全部满足。** + +**Testcontainers 真实执行证据**（maven 控制台不携带容器日志，改用「类耗时 + `Skipped=0`」判定； +两类均标注 `disabledWithoutDocker = true`，若 Docker 不可用会被 skip）： + +| 轮次 | `R01EMySqlQueryCountAndExplainTest` | `R01EIndependentCrossDatabaseVerificationTest` | +|---|---|---| +| 1 | 5 项 / **47.27 s** | 16 项 / **109.6 s** | +| 3 | 5 项 / **48.27 s** | 16 项 / **134.9 s** | + +**OBS-NEW-01 判定变更**： + +> **OBS-NEW-01 由「潜在阻断」降级为「非阻断 CI 稳定性观察项」。** + +**根因收敛（新证据）**：三轮中**每轮都出现 12 次** `HikariPool - Failed to validate connection … +No operations allowed after connection closed`，但 **`StatementIsClosedException = 0`** 且全部通过。 +说明该 Hikari 告警本身**不足以致败**；首次 FAIL 的致败因素是 `StatementIsClosedException` +（批量 INSERT 执行期语句被关闭）。三轮未能复现 → 判定为**瞬时连接生命周期抖动**。 +按指令「任一轮再次出现相同错误则升级为测试基础设施阻断项」——本错误**未再现**，故不升级。 +**未修改任何测试以获取通过。** + +## 19. §4 最新 JAR 与真实基础设施启动 + +| 项 | 值 | +|---|---| +| JAR | `mydreamjob-server-0.0.1-SNAPSHOT.jar`（82 433 459 B，来自本轮第 3 次 `clean verify`） | +| **PID** | **1419**（本轮唯一启动的 JAR，已按精确 PID 停止） | +| 业务端口 | `8080` | +| 管理端口 | `8081`（`netstat`：`127.0.0.1:8081 LISTENING`，**仅回环**） | +| 启动 | `Started MyDreamjobApplication in 16.538 seconds` | +| 启动方式 | `MSYS2_ENV_CONV_EXCL=RABBITMQ_VHOST`（**未**设置 `MSYS_NO_PATHCONV=1`） | +| `app.sms.mock.enabled` | `false` | +| `ddl-auto` | `validate`（启动成功即通过） | +| 管理员 bootstrap | 默认关闭 | +| 密钥 | Access / Refresh / Token-Hash 三项**进程内随机生成、≥32 字符、两两不同**；未落盘（临时文件已删）、未打印、未写入本报告 | + +**Flyway（真实 MySQL 查询 `flyway_schema_history`）**： + +| version | description | success | +|---|---|---| +| 45 | add scoring refresh claim token | **1** | +| 44 | candidate scoring refresh tasks | **1** | +| 43 | disable legacy seed accounts | **1** | +| 42 | auth token sessions | **1** | + +`SELECT COUNT(*) … WHERE success = 0` → **0**（**failed migration = 0 ✔**）。 + +**双端口矩阵（实测）**： + +| 端点 | 业务 `/api/v1/actuator/*` | 管理 `/actuator/*` | +|---|---|---| +| `health` | **404** | **200**（`{"status":"UP"}`） | +| `metrics` | **404** | **200** | +| `prometheus` | **404** | **200** | +| `env` / `beans` / `heapdump` / `threaddump` / `configprops` | **404** | **404** | + +业务健康响应仅含 `application` / `version` / `status`，**不含** db、redis、rabbit、diskSpace、 +hikari、连接串或任何组件明细 ✔ + +## 20. §5 运行时 OpenAPI 与静态文件**逐集合**比对 + +| 项 | 静态 `docs/openapi-rc.json` | 运行时 `/api/v1/v3/api-docs` | +|---|---|---| +| paths | **176** | **176** | +| operations | **214** | **214** | +| 路径集合是否完全一致 | — | **True**（`only_static=[]`、`only_runtime=[]`） | +| operation 集合是否完全一致 | — | **True**（`only_static=[]`、`only_runtime=[]`） | + +**RUNTIME_OPENAPI_RESULT = PASS**（**非**仅比较数量：逐路径、逐 `METHOD path` 做集合相等判定）。 +`docs/openapi-rc.json` **未修改**。 + +## 21. §6 Token 与会话矩阵（真实 HTTP） + +**结果：36 / 36 全部 PASS。** + +| 分段 | 项数 | 结果 | +|---|---|---| +| §8 端口与健康（复跑） | 15 | **15/15 PASS** | +| §9.1 Token 类型矩阵 | 13 | **13/13 PASS** | +| §9.2 并发刷新与重放 | 3 | **3/3 PASS** | +| §9.3 登出与会话注销 | 5 | **5/5 PASS** | + +### 21.1 类型矩阵（每格均为实测） + +| Token | 普通接口 `/auth/me` | 刷新接口 `/auth/refresh` | +|---|---|---| +| Access | **200** | **401** | +| Refresh | **401** | **200** | +| 无 `type` | 401 | 401 | +| 错误密钥 | 401 | 401 | +| 错误 `aud` | 401 | 401 | +| 错误 `iss` | 401 | 401 | +| 缺 `iat` | 401 | 401 | +| 未来 `iat` | 401 | 401 | +| 已过期 | 401 | 401 | +| 非法 `jti` | 401 | 401 | +| 非法 `sid` | 401 | 401 | +| 非法 `sub`（非正数） | 401 | 401 | + +**拒绝响应泄漏扫描**：Token 原文 / `principal` / `claim` / 异常类 / 堆栈 / SQL / 本地路径 +→ **全部 0 命中** ✔ + +### 21.2 并发刷新与重放（10 轮 × 2 独立客户端） + +| 断言 | 结果 | +|---|---| +| 每轮最多 1 个成功 | **10/10 轮** ✔ | +| 失败方只能 401，不得 500 | ✔ | +| 该 session 活动 Refresh **严格为 0** | `act=0`（每轮实测）✔ | +| 原 Access 失效 | `old=401`（每轮实测）✔ | +| 无锁异常 / 无 `could not take locks` | ✔ | +| 数据库不存 JWT 原文 | `auth_tokens` 中 `token_hash LIKE 'eyJ%'` → **0** ✔ | + +### 21.3 登出与会话 + +| 断言 | 结果 | +|---|---| +| 单设备登出 | 200 ✔ | +| 只撤销当前 session，其他设备保持有效 | `A=0 B=1`，B 的 `/auth/me` → 200 ✔ | +| 重复登出幂等 | 已撤销的 Access → 401 ✔ | +| inactive 用户不能登录 | 拒绝（HTTP 400，<500，非 500）✔ | + +### 21.4 本轮两项**脚本缺陷**（非产品缺陷，已修正） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| S-1 | 夹具手机号 `1990000`(7 位)+5 位 = **12 位**，登录被拒 `phone must contain exactly 11 digits` | **脚本缺陷**；产品校验**正确生效** | 前缀改为 `199000`(6 位)+5 位 = 11 位 | +| S-2 | 「业务健康不泄露组件明细」误报，`act=db` | **脚本缺陷**：对整段 JSON 做子串匹配，随机 `requestId` 十六进制串恰好含 `db` | 改为仅解析 `data` 对象的键并做集合判定 | +| S-3 | 控制台 GBK 无法输出 `⊆` | 脚本缺陷 | 改为 ASCII 文案 | + +## 22. §12 运行时敏感扫描 + +**扫描范围**：最新应用日志、本轮 HTTP 响应、`auth_tokens`、`audit_logs`、`notifications`、`messages`、验收脚本输出。 + +| 目标 | 模式 | 命中 | 分类 | +|---|---|---|---| +| 应用日志 | `eyJ…`（JWT 原文） | **0** | — | +| 应用日志 | `Bearer ` | **0** | — | +| 应用日志 | 11 位手机号 | **0** | — | +| 应用日志 | `authorization` | **0** | — | +| 应用日志 | `password` | 2 | Spring Boot 默认 `Using generated security password=`；`SecurityConfig` **未启用** `httpBasic`/`formLogin`/`UserDetailsService`，该用户**惰性**。见 OBS-NEW-05 | +| HTTP 响应 | Token/principal/claim/异常类/堆栈/SQL/本地路径 | **0** | 见 §21.1 | +| `auth_tokens` | JWT 原文 | **0** | 仅存摘要 ✔ | +| `audit_logs` | `eyJ…` | **0** | — | +| `notifications` / `messages` | `eyJ…` | **0 / 0** | — | +| `audit_logs` | 11 位数字 | **818** | 见 **OBS-NEW-04**（**历史遗留**） | +| `audit_logs` | `claim%` | **0** | — | + +**扫描器探针有效性**：以注入式探针（`Authorization: Bearer`、11 位手机号、`DB_PASSWORD=`）验证后清理； +`audit_logs` 的 818 命中即为扫描器**确实能命中**的实证。 + +## 23. 本轮**新增**观察项 + +| ID | 内容 | 是否阻断 | 影响范围 | 证据 | 推荐后续动作 | +|---|---|---|---|---|---| +| **OBS-NEW-04** | `audit_logs` 中 `action='SMS_SEND'` 的 **818 行** `details` 含**完整手机号**（文本形态 `Mock SMS sent to <11 位号码> for login`，全部匹配真实移动号段 `1[3-9]…`） | **否**（不阻断本分支） | 本地验收数据库**历史数据**；生产审计表的 PII 留存面 | 时间范围 **2026-08-06 17:21 → 2026-09-17 14:46**，**全部早于**本分支 S01 加固；**本轮贡献 0 行**（本轮 `mock=false`，不产生该链路）；`grep "Mock SMS sent to" src/main` → **当前代码已无该写入路径**（S01 已移除） | ① 属**数据留存**问题而非代码缺陷；② 生产侧需制定审计 PII 保留/脱敏策略；③ 如需清理须按数据治理流程单独执行，**本轮未删除任何 `audit_logs` 行** | +| **OBS-NEW-05** | 启动日志在 INFO 级输出 `Using generated security password=` | **否** | 日志噪声 + 潜在的惰性默认账号 | 应用日志第 21/23 行；`SecurityConfig` 中 `httpBasic`/`formLogin`/`UserDetailsService` **均无命中**，故无认证入口可到达该账号 | 排除 `UserDetailsServiceAutoConfiguration`（或在生产 profile 关闭）以消除该日志与默认账号 | + +## 24. §13 收尾：清理、保留足迹、RabbitMQ 终态 + +| 项 | 结果 | +|---|---| +| 本轮夹具用户（`199000%` 号段） | 清理前 **12** → 清理后 **0** ✔ | +| `sms_verification_codes`（`1990%`） | **0** ✔ | +| **`audit_logs`** | **未删除任何行**；验收开始前 **2868** 行 → 结束后 **2868** 行（**保留足迹，数量不变**）✔ | +| 应用 PID | 精确停止 **1419**；未停止任何未知 Java 进程 | +| `8080` / `8081` | 均已空闲 ✔ | +| 临时密钥文件 | `backend-infra/.final_acc_secrets.env` **已删除** | +| Docker 容器 | 保持运行（`mydreamjob-mysql`/`redis`/`rabbitmq`），未重建、未删 volume | +| 历史未跟踪文件 | 完整保留 | +| 本轮新增未跟踪文件 | 4 个验收脚本 + 3 个 JSON/日志产物 + 本报告 | + +**RabbitMQ 四队列终态**： + +| 队列 | ready | unacked | +|---|---|---| +| `queue.sms.verification` | **0** | **0** | +| `queue.notification` | **0** | **0** | +| `queue.audit` | **0** | **0** | +| `queue.notification.dlq` | **0** | **0** | + +**四队列归零 ✔**，与验收开始前一致；**未执行 purge**。 + +## 25. 续跑后的逐项状态（PASS / FAIL / SKIP） + +| 节 | 项目 | 状态 | +|---|---|---| +| §1 | 分支/HEAD/upstream/暂存区/两处 `M` 三方核验 | **PASS** | +| §2 | 提交历史与阶段完整性、迁移 V42–V45、V1–V41 未修改 | **PASS** | +| §2 | S01/S03 静态安全 | **PASS** | +| §3 | 三轮 `mvn clean verify` | **PASS**（3/3） | +| §4 | 最新 JAR + 真实 MySQL/Redis/RabbitMQ + 双端口 + Flyway V45 | **PASS** | +| §5 | 运行时 OpenAPI 逐集合比对 | **PASS** | +| §6 | Token 类型矩阵 | **PASS**（13/13） | +| §6 | 并发刷新与重放（10 轮） | **PASS**（3/3） | +| §6 | 登出与会话注销 | **PASS**（5/5） | +| §12 | 运行时敏感扫描（日志/响应/DB） | **PASS**，附 OBS-NEW-04/05 | +| §13 | 收尾清理与队列终态 | **PASS** | +| **§7** | **S01 岗位权限矩阵 + 短信失败关闭运行时** | **SKIP（未执行）** | +| **§8** | **S03 简历隐私矩阵** | **SKIP（未执行）** | +| **§8** | **管理员初始化矩阵** | **SKIP（未执行）** | +| **§8** | **V43 真实迁移验证** | **SKIP（未执行）** | +| **§9** | **Q01 真实数据库查询矩阵** | **SKIP（未执行）** | +| **§10** | **三个 GET 评分接口 22 表零写快照** | **SKIP（未执行）** | +| **§10** | **写侧刷新任务链路** | **SKIP（未执行）** | +| **§10** | **claim token 100 轮并发** | **SKIP（未执行）** | +| **§11** | **运行时 22 张表逐字段副作用 + 四类反证** | **SKIP（未执行）** | + +## 26. 续跑后最终 Git 状态 + +| 项 | 结果 | +|---|---| +| HEAD | `2319f97203a2fcf8012869fda8c30599ffb305`（**未变**） | +| upstream | `2319f972…`，ahead/behind **0 / 0** | +| 暂存区 | **空** | +| 已跟踪文件修改 | **无**（`git diff --name-status` 空） | +| `git diff --check` | exit 0 | +| V1–V45 迁移修改 | **无**；**无 V46** | +| master 合并 | **无** | +| commit / push / merge / rebase / force push | **均未执行** | + +## 27. 续跑后最终判定 + +> ## **FAIL（仍未通过）** + +**原因**：§25 中标为 **SKIP** 的 9 项（§7 岗位权限与短信、§8 简历隐私/管理员初始化/V43、 +§9 Q01 运行时、§10 评分零写/写侧刷新/claim token 100 轮、§11 运行时 22 表副作用）**本轮未执行**。 +按验收规则「任一核心项 FAIL 或 SKIP：总结必须写 FAIL」，**不得**标记为通过，**不得**使用「基本通过」。 + +**本轮新增的通过项**（均已在 §17–§24 给出实测证据）： +三轮 `clean verify` 2788/0/0/0 稳定、最新 JAR + 真实三中间件启动与双端口隔离、 +运行时 OpenAPI 逐集合一致、Token 类型矩阵与并发重放登出共 36/36、运行时敏感扫描、 +队列归零与夹具零残留。 + +**未发现任何产品缺陷**。本轮发现的 3 项脚本缺陷与 1 项历史数据观察（OBS-NEW-04）均已如实分类， +未现场修改任何生产代码或既有测试。 + +**下一轮定向整改指令（承接 §15，不修改生产代码）**： + +1. 补齐 §7 岗位权限矩阵与短信失败关闭运行时（注意 `COMPANY_NOT_FOUND`→404 的既有契约，见 OBS-NEW-02）。 +2. 补齐 §8 简历隐私矩阵（含拒绝路径 storage read = 0）、管理员初始化隔离矩阵、V43 真实迁移验证。 +3. 补齐 §9 Q01 真实数据库查询矩阵与 EXPLAIN 分表报告。 +4. 补齐 §10 三 GET 零写 22 表快照、写侧刷新链路、claim token 100 轮。 +5. 补齐 §11 运行时 22 表逐字段副作用与改/插/删/单列四类反证。 +6. 就 **OBS-NEW-04** 制定审计 PII 留存策略（数据治理，非代码改动）；就 **OBS-NEW-05** 排除默认安全用户自动配置。 + +--- +--- + +# 续跑记录（2026-09-18 第三轮，追加） + +上文全部内容（初次 FAIL、首次 `clean verify` 的 2 个 Error、MSYS vhost 缺陷、OBS-NEW-01、 +第二轮三轮构建结果与全部原始证据）**原样保留、未删改**。 + +> ### ⚠ 本轮发生一次**验收脚本误操作历史数据**事件，已复原并如实记录（见 §32）。 + +## 28. §7 S01 岗位权限矩阵（真实 HTTP）：**20/20 PASS** + +| 用例 | 期望 | 实测 | +|---|---|---| +| 匿名 GET `/jobs`（列表保持公开） | 200 | **200** ✔ | +| 匿名 GET `/jobs/public/{id}`（公开详情） | 200 | **200** ✔ | +| 匿名 GET `/jobs/{id}`（企业端详情） | 401 | **401** ✔ | +| 匿名 POST `/jobs` | 401 | **401** ✔ | +| 匿名 PUT `/jobs/{id}` | 401 | **401** ✔ | +| 匿名 PATCH `/jobs/{id}/status`（发布） | 401 | **401** ✔ | +| 匿名 DELETE `/jobs/{id}` | 401 | **401** ✔ | +| COMPANY 创建岗位 | 200/201 | **成功** ✔ | +| COMPANY 发布岗位 | 200 | **200** ✔ | +| STUDENT 创建岗位 | 拒绝且非 500 | **403 / code=2002** ✔ | +| ADMIN 创建岗位 | 拒绝且非 500 | **403 / code=2002** ✔ | +| 其他企业修改他人岗位 | 非 200 且非 500 | **400** ✔ | +| 失败请求不写入岗位表 | jobCount 不变 | **27 → 27** ✔ | +| 异常主体 `anonymousUser` | 401 | **401** ✔ | +| 异常主体 非数字 | 401 | **401** ✔ | +| 异常主体 20 位 Long 溢出 | 401 | **401** ✔ | +| 异常主体 零值 `sub` | 401 | **401** ✔ | +| 生产 `mock=false` 短信安全失败 | 非 200 且非 5xx | **400** ✔ | +| 不伪造发送成功 | 响应无成功文案 | **无** ✔ | +| 失败响应不含手机号/验证码/Token | 无泄漏 | **无** ✔ | + +**说明**：STUDENT/ADMIN 创建岗位返回 **403 / code=2002（FORBIDDEN）**，与指令期望一致； +该项在本轮**实测**，修正了第二轮基于静态基线的推断（见 OBS-NEW-02）。 + +## 29. §9 Q01 岗位搜索真实数据库矩阵：**13/15**，发现 **DEF-01** + +### 29.1 通过项（13） + +空条件返回结果、标题关键词、描述关键词、大小写不敏感、特殊字符（`Delta_100%`）、 +城市过滤（`city=上海` → 1）、最低薪资下限、最高薪资上限、边界相等、无结果、 +分页 `size=1`、非公开（DRAFT）岗位不进入公开搜索 —— 全部符合预期。 + +### 29.2 **DEF-01：`/jobs` 与 `/jobs/search` 关键词语义分歧（产品行为缺陷）** + +**最小复现（真实 HTTP，已保存）**： + +``` +GET /api/v1/jobs?keyword=%20AlphaEngineer%20 → items=0 （期望 1：应 trim 后命中） +GET /api/v1/jobs?keyword=%20%20%20 → items=0 （期望 20：空白应等同未传） +GET /api/v1/jobs/search?keyword=%20AlphaEngineer%20 → items=1 （正确） +GET /api/v1/jobs/search?keyword=%20%20%20 → items=20 （正确） +GET /api/v1/jobs → items=20 +GET /api/v1/jobs?keyword=AlphaEngineer → items=1 +``` + +**根因（静态定位，未修改代码）**： + +| 端点 | 调用链 | 关键词处理 | trim | 空白关键词 | +|---|---|---|---|---| +| `GET /jobs` | `JobController:97` → `JobService.listPublishedJobs` → `JobRepository:26`（JPQL `LIKE %:keyword%`） | 仅判 `:keyword IS NULL` | **无** | 空白串**非 NULL** → 谓词生效 → **0 条** | +| `GET /jobs/search` | `JobController:134` → `JobService.searchJobs` → `JobSearchSpecification:53` | `"%" + keyword.trim() + "%"` + `isBlank()` 判空 | **有** | 空白被 `isBlank()` 跳过 → **全部** | + +**判定**：指令 §12 明确列出 **trim** 与 **空白关键词** 两个验收用例。`/jobs` 端点两条均不满足 +（trim 未生效、空白关键词返回 0 而非全部），且与同一产品的另一公开端点 `/jobs/search` 行为不一致。 +按「产品缺陷直接 FAIL，不现场修复」→ **判定为 FAIL 项**，**未修改任何生产代码**。 + +**定向整改指令（下一轮，不属本轮范围）**： +统一 `GET /jobs` 与 `GET /jobs/search` 的关键词语义 —— 使 `listPublishedJobs` 路径同样对 +`keyword` 执行 `trim` + `isBlank` 判空（或将 `/jobs` 直接委托给 `JobSearchSpecification`）， +并补充「带前后空白的关键词」与「纯空白关键词」两条 HTTP 回归用例。注意 +`JobRepository:26` 与 `JobSearchSpecification` 是**两套并行实现**，整改时需评估是否合并。 + +### 29.3 本轮 Q01 未覆盖项 + +排序（`sort`）、H2/MySQL 逐项对账（ID 与顺序一致）、EXPLAIN 分表报告 —— **SKIP（未执行）**。 + +## 30. §7/§9 本轮脚本缺陷（非产品缺陷，已修正） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| S-4 | 匿名公开详情断言 401（期望 200） | **脚本缺陷**：调用了企业端 `/jobs/{id}`；公开端点是 `/jobs/public/{id}` | 改用正确端点，并**新增**一条「企业端详情匿名 401」断言 | +| S-5 | 中文城市与含空格关键词全部 0 条 | **脚本缺陷**：查询参数**未做 URL 编码** | 改用 `urllib.parse.quote` | +| S-6 | 清理时 `fk_jobs_company` 外键失败 | **脚本缺陷**：未按外键顺序删除 | 改为 applications → jobs → companies → users | + +## 31. 第三轮收尾 + +| 项 | 结果 | +|---|---| +| 本轮夹具残留（`199000%` 用户 / `FINALACC_20260918_%` 公司·岗位 / 短信码） | **全部 0** ✔ | +| **`audit_logs`** | **未删除任何行**；本轮开始前 **2868** → 第三轮开始前 **2888** → 结束后 **2888**（本轮 HTTP 产生的审计行**保留**，未删） | +| 应用 PID | 精确停止 **1438** | +| `8080` / `8081` | 均已空闲 ✔ | +| 临时密钥文件 | `.final_acc_secrets.env` **已删除** | +| RabbitMQ 四队列 | 全部 `ready=0 unacked=0` ✔，**未 purge** | +| Docker | 三容器保持运行，未重建、未删 volume | + +## 32. ⚠ 验收脚本误操作历史数据事件（已复原，如实记录） + +**经过**：第三轮首次运行 `final_acc_20260918_b_jobs_search.py` 时，夹具清理使用了**过宽谓词** +`phone LIKE '1990%'`（本意是匹配本轮 `199000 + 5 位` 夹具），导致两条**既有历史用户** +（`users.id = 7938 / 7939`，创建于 **2026-09-14 09:48**，非本轮产生）的 `user_roles` 行被删除。 + +**发现**：紧随其后的 `DELETE FROM users WHERE phone LIKE '1990%'` 因 +`fk_applications_student` 外键失败而中止，据此定位到该前缀下存在非本轮用户。 + +**影响面（已逐项核实）**： + +| 对象 | 状态 | +|---|---| +| `users` 7938 / 7939 | **未删除**（删除语句因外键失败，未生效）✔ | +| `user_roles` 7938 / 7939 | **被误删** ✗ → **已复原** | +| `applications`（学生 7938/7939，共 2 条） | **未受影响** ✔ | +| `auth_tokens`（7938/7939） | 原本为 0，未受影响 ✔ | +| 其它表 | 未触及 | + +**复原操作与依据**：`INSERT INTO user_roles (user_id, role) VALUES (7938,'STUDENT'),(7939,'STUDENT');` +依据：`users.role` 两行均为 `STUDENT`，且库内 **256** 条 STUDENT 用户的 `user_roles` **全部**为 +`('STUDENT')`（1:1 形态）。复原后已核验两行存在且角色正确。 + +**同类错误未再次发生**：脚本已改为精确前缀 `199000%` 并补全外键删除顺序；第三轮后续运行未再触碰历史行。 + +**教训与建议**：验收夹具前缀应避免使用过短的数字前缀（`1990` 会与既有测试号段冲突）， +建议改用更长且唯一的号段，并在任何 DELETE 前先 `SELECT COUNT(*)` 输出命中范围。 + +## 33. 第三轮后的逐项状态 + +| 节 | 项目 | 状态 | +|---|---|---| +| §7 S01 岗位权限矩阵（20 项） | 真实 HTTP 全量执行 | **PASS** | +| §7 S01 短信生产失败关闭 | 真实 HTTP | **PASS** | +| §9 Q01 搜索矩阵（15 项） | 真实 HTTP + MySQL | **13 PASS / 2 FAIL（DEF-01）** | +| §9 Q01 排序 / H2-MySQL 对账 / EXPLAIN | — | **SKIP** | +| §8 S03 简历隐私矩阵 | — | **SKIP** | +| §8 S03 管理员初始化矩阵 | — | **SKIP** | +| §8 S03 V43 真实迁移验证 | — | **SKIP** | +| §10 R01 三 GET 零写 22 表快照 | — | **SKIP** | +| §10 R01 写侧刷新链路 | — | **SKIP** | +| §10 R01 claim token 100 轮 | — | **SKIP** | +| §11 运行时 22 表逐字段副作用 + 四类反证 | — | **SKIP** | +| §12 运行时敏感扫描（日志/响应/DB） | 已在第二轮执行 | **PASS**（附 OBS-NEW-04/05） | + +## 34. 第三轮后最终 Git 状态 + +| 项 | 结果 | +|---|---| +| HEAD | `2319f97203a2cafcf8012869fda8c30599ffb305`（**未变**） | +| upstream | 同提交，ahead/behind **0 / 0** | +| 暂存区 | **空** | +| 已跟踪文件修改 | **无** | +| `git diff --check` | exit 0 | +| V1–V45 迁移修改 | **无**；**无 V46** | +| master 合并 / commit / push / merge / rebase / force push | **均未执行** | + +## 35. 第三轮后最终判定 + +> ## **FAIL（仍未通过）** + +**新增 FAIL 项：DEF-01**（`/jobs` 关键词 trim 与空白关键词行为不符合 Q01 验收判据， +与 `/jobs/search` 语义分歧）—— 属**产品行为缺陷**，已给出最小复现与定向整改指令，**未修改生产代码**。 + +**仍为 SKIP 的项**：§8 全部（简历隐私矩阵、管理员初始化矩阵、V43 真实迁移）、 +§9 排序与 H2/MySQL 对账与 EXPLAIN、§10 全部（三 GET 零写、写侧刷新、claim token 100 轮）、 +§11 运行时 22 表副作用与四类反证。 + +**第三轮新增通过项**：S01 岗位权限矩阵 20/20（真实 HTTP）、短信生产失败关闭、 +Q01 搜索矩阵 13/15（真实 HTTP + MySQL）、夹具零残留与审计保留足迹、队列归零。 + +**下一轮定向整改指令**： + +1. **DEF-01（优先，产品缺陷）**：统一 `GET /jobs` 与 `GET /jobs/search` 的关键词语义 + （`trim` + `isBlank` 判空），并补充 HTTP 回归用例；评估 `JobRepository:26` 与 + `JobSearchSpecification` 两套并行实现是否合并。 +2. 补齐 §8 简历隐私矩阵、管理员初始化隔离矩阵、V43 真实迁移验证。 +3. 补齐 §9 排序、H2/MySQL 逐项对账与 EXPLAIN 分表报告。 +4. 补齐 §10 三 GET 零写 22 表快照、写侧刷新链路、claim token 100 轮。 +5. 补齐 §11 运行时 22 表逐字段副作用与改/插/删/单列四类反证。 +6. 验收夹具改用更长唯一号段；任何 DELETE 前先输出命中范围（见 §32）。 + +--- +--- + +# 续跑记录（2026-09-18 第四轮，追加） + +上文全部内容（初次 FAIL、首次 2 个 Error、MSYS vhost 缺陷、OBS-NEW-01、第二/三轮结果、 +§32 历史数据误操作事件）**原样保留、未删改**。 + +## 36. §8 S03 —— V43 真实 MySQL 验证：**PASS** + +在 `mydreamjob-mysql`（真实 MySQL 8.4，V43 已随 Flyway 执行、`success=1`）上逐项验证： + +| 断言 | 期望 | 实测 | +|---|---|---| +| 完整五要素指纹命中并禁用 | 三个演示账号 `is_active=0` | `13800000001 ADMIN 0`、`13800000002 STUDENT 0`、`13800000003 COMPANY 0` ✔ | +| `users` / `user_roles` **保留**（不删除） | 3 / 3 | **3 / 3** ✔ | +| 重复执行稳定（幂等） | 重跑三段 UPDATE 受影响行数 = 0 | **0 / 0 / 0** ✔ | +| **任意单字段改变不命中** | 改 phone / email / password_hash / role 各自 0 行 | **0 / 0 / 0 / 0** ✔（证明五个合取项全部生效） | +| 不依赖固定 ID | V43 的 `WHERE` 无 `id =` 谓词 | 静态核对 V43 SQL：仅用 phone+email+password_hash+role+is_active 五元指纹 ✔ | +| 执行后演示账号未被误改 | 仍为禁用且字段不变 | 复核 `1/2/3` 三行 `is_active=0` ✔ | + +**未覆盖**：V43「原演示账号登录被拒绝」的**运行时**验证 —— **SKIP**（需构造 `sms_verification_codes` 并调用登录， +本轮未执行；其等价语义已由 S01 的「inactive 用户不能登录」HTTP 用例覆盖并通过，见 §21.3）。 + +## 37. §10 三个 GET 评分接口零写（24 张表逐字段快照）：**PASS（7/7）** + +| 断言 | 结果 | +|---|---| +| `GET /profile/me/candidate-scoring`（综合评分） | **200** ✔ | +| `GET /profile/me/candidate-scoring/dimensions/EDUCATION`（单维度） | **200** ✔ | +| `GET /company/candidates/{applicationId}/scoring`（企业评分） | **200** ✔ | +| **三个 GET 前后 24 张表逐字段零变化** | `changed=none` ✔ | +| GET 不新增 `candidate_scoring_refresh_tasks` | `0 -> 0` ✔ | +| `candidate_dimension_scores` 行数与 `version` 不推进 | `rows 1->1`、`ver 0->0` ✔ | +| 无快照学生请求后仍为 **0 行** | `0` ✔ | + +**快照覆盖的 24 张表**：users、user_roles、student_profiles、companies、jobs、applications、 +resume_versions、auth_tokens、audit_logs、notifications、messages、message_reads、conversations、 +conversation_members、candidate_dimension_scores、candidate_scoring_refresh_tasks、 +candidate_scoring_appeals、offers、interviews、candidate_feedback、talent_invitations、 +scoring_risk_events、scoring_risk_actions、personal_data_export_tasks。 +每张表**显式列出稳定字段**（含 `version` / `updated_at` 等），按主键排序，逐字段深比较 —— +**未**只比较 COUNT / SUM / CRC。 + +## 38. §11 副作用快照比较器的四类反证：**PASS（4/4）** + +每条反证都要求**变更真正命中 1 行**且**被比较器检出**（避免「没改到任何行」造成的假通过）： + +| 反证 | 变更语句 | 受影响行数 | 是否检出 | +|---|---|---|---| +| 改一行 | `UPDATE users SET nickname=…` | **1** | **True** ✔ | +| 插一行 | `INSERT INTO candidate_scoring_refresh_tasks …` | **1** | **True** ✔ | +| 改单列 | `UPDATE candidate_dimension_scores SET status='PENDING' …` | **1** | **True** ✔ | +| 删一行 | `DELETE FROM candidate_dimension_scores …` | **1** | **True** ✔ | + +⇒ 快照比较器**确实具备检出能力**，§37 的「零变化」不是「没在比」。 + +## 39. 第四轮脚本缺陷（非产品缺陷，已修正） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| S-7 | 反证「插一行 / 删一行 / 改单列」未检出 | **脚本缺陷**：变更语句**未命中任何行**（`scoring_risk_events` 无 `student_user_id` 列而静默失败；`candidate_feedback` 无对应行；`dimension_scores` 已被前序步骤删除） | 改用确定存在的行，并断言 `ROW_COUNT()=1` | +| S-8 | 快照列名错误 | **脚本缺陷**：`scoring_risk_events` 实际列为 `subject_user_id`，非 `student_user_id` | 按 `information_schema` 实测列名修正 | +| S-9 | 收尾清理报 `Unknown column` | 同 S-8 | 同上 | + +## 40. 第四轮收尾 + +| 项 | 结果 | +|---|---| +| 夹具残留（用户 / 公司 / 岗位 / 短信码 / refresh task） | **全部 0** ✔ | +| **`audit_logs`** | **未删除任何行**；本轮 HTTP 产生的审计行**保留**，第三轮结束 2888 → 本轮结束 **2900** | +| 历史用户 `7938 / 7939` | `users.role` 与 `user_roles.role` 均为 `STUDENT`，**完好** ✔ | +| 应用 PID | 精确停止 **1452** | +| `8080` / `8081` | 空闲 ✔ | +| 临时密钥文件 | 已删除 | +| RabbitMQ 四队列 | 全部 `ready=0 unacked=0` ✔，未 purge | +| Docker | 三容器保持运行，未重建、未删 volume | + +## 41. 第四轮后逐项状态 + +| 节 | 项目 | 状态 | +|---|---|---| +| §8 S03 V43 真实 MySQL 验证 | — | **PASS** | +| §10 三 GET 零写（24 表逐字段） | — | **PASS（7/7）** | +| §11 四类反证 | — | **PASS（4/4）** | +| §8 S03 简历隐私矩阵 | — | **SKIP** | +| §8 S03 管理员初始化矩阵 | — | **SKIP** | +| §8 S03 V43 登录拒绝（运行时） | — | **SKIP** | +| §9 Q01 排序 / H2-MySQL 对账 / EXPLAIN | — | **SKIP** | +| §10 写侧刷新链路 | — | **SKIP** | +| §10 claim token 100 轮 | — | **SKIP** | + +## 42. 第四轮后最终 Git 状态 + +| 项 | 结果 | +|---|---| +| HEAD | `2319f97203a2cafcf8012869fda8c30599ffb305`（**未变**） | +| upstream | 同提交，**0 / 0** | +| 暂存区 | **空** | +| 已跟踪文件修改 | **无** | +| V1–V45 修改 / V46 | **无 / 不存在** | +| master 合并 / commit / push / merge / rebase / force push | **均未执行** | + +## 43. 全轮次累计判定 + +> ## **FAIL（仍未通过）** + +**累计 FAIL 项**：**DEF-01**（`/jobs` 关键词 trim 与空白关键词不符合 Q01 判据，与 `/jobs/search` 语义分歧；产品缺陷，已给最小复现与整改指令，未修改生产代码）。 + +**累计 SKIP 项**：§8 简历隐私矩阵、管理员初始化矩阵、V43 运行时登录拒绝；§9 排序 / H2-MySQL 逐项对账 / EXPLAIN 分表报告；§10 写侧刷新链路、claim token 100 轮。 + +**累计 PASS 项**：开工核查与两处 `M` 三方核验、提交与迁移完整性、S01/S03 静态审查、 +三轮 `clean verify` 2788/0/0/0、最新 JAR + 真实三中间件 + 双端口 + Flyway V45、 +运行时 OpenAPI 逐集合一致、Token/会话矩阵 36/36、S01 岗位权限矩阵 20/20、 +S03 V43 真实 MySQL 验证、Q01 搜索矩阵 13/15、三 GET 零写 24 表快照 7/7、 +四类反证 4/4、运行时敏感扫描、夹具零残留与审计保留足迹、队列归零。 + +**最终 Git**：HEAD 未变、upstream 0/0、暂存区空、无已跟踪修改、未提交、未推送、未合并。 + +--- +--- + +# 续跑记录（2026-09-18 第五轮，追加） + +上文全部内容（初次 FAIL、首次 2 个 Error、MSYS vhost 缺陷、OBS-NEW-01、第二/三/四轮结果、 +§32 历史数据误操作事件）**原样保留、未删改**。 + +## 44. §8 S03 —— V43 运行时登录拒绝：**PASS（4/4）** + +对 V43 禁用的两个 Flyway 演示账号，注入合法验证码后走真实登录链路： + +| 断言 | 期望 | 实测 | +|---|---|---| +| 已禁用演示 **ADMIN**（`13800000001`）登录 | 非 200 且无 Token | **HTTP 400，无 `accessToken`** ✔ | +| 已禁用演示 **STUDENT**（`13800000002`）登录 | 非 200 且无 Token | **HTTP 400，无 `accessToken`** ✔ | +| 被拒登录未产生会话行 | `auth_tokens` = 0 | **0** ✔ | +| 演示账号行未被删除 | 2 行存在 | **2** ✔ | + +⇒ V43 的**目标语义**（禁用后无法取得会话）在真实运行实例上成立；结合 §36 的真实 MySQL 指纹验证， +V43 的静态 + 数据 + 运行时三层证据齐备。 + +## 45. §9 Q01 排序：**部分 PASS，排序语义 SKIP** + +| 用例 | 结果 | +|---|---| +| 白名单校验：未知 `sort` 值一律 400 | `salary_desc` / `salary_asc` / `salaryDesc` / `salaryAsc` → **400** ✔（**正确的白名单拒绝**） | +| `sort=latest` | **200** ✔ | +| `sort=salary` | **200** ✔（白名单内） | +| `sort` 省略 | **200** ✔ | +| **`sort=salary` 的升降序与 NULL 排序语义** | **SKIP** —— 未用夹具验证顺序 | +| **`sort=relevance` 的相关度语义** | **SKIP** | + +**白名单事实（静态）**：`JobService:201` `ALLOWED_SORTS = Set.of("latest", "salary", "relevance")`； +`JobService:216` 非白名单值抛 `BusinessException(BAD_REQUEST)` → 400。 +`JobService:207` 注释说明 `sort=salary` 用 CriteriaQuery 的 CASE 排序使 `salaryMax=NULL` 排在最后。 + +## 46. 第五轮脚本缺陷（非产品缺陷，已修正） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| S-10 | 排序用例 4 项 400 | **脚本缺陷**：使用了**不存在的** `sort` 值（`salary_desc`/`salaryAsc` 等）；产品白名单只有 `latest`/`salary`/`relevance`，返回 400 是**正确行为** | 记录真实白名单；顺序语义因缺夹具未验证，标记 SKIP | +| S-11 | 排序段 `TypeError: int() … NoneType` | **脚本缺陷**：只登录创建了 STUDENT 用户，未建公司夹具 | 补 SQL 公司夹具 | + +## 47. 第五轮收尾 + +| 项 | 结果 | +|---|---| +| 夹具残留（用户 / 公司 / 岗位 / 短信码） | **全部 0** ✔ | +| **`audit_logs`** | **未删除任何行**；第四轮 2900 → 本轮 **2904**（本轮产生的审计行保留） | +| Flyway 演示账号 | 仍为 `13800000001=0, 13800000002=0, 13800000003=0`（**禁用状态未被改动**）✔ | +| 历史用户 `7938 / 7939` 的 `user_roles` | **2 行存在**（§32 复原成果保持）✔ | +| 应用 PID | 精确停止 **1791** | +| `8080` / `8081` | 空闲 ✔ | +| 临时密钥文件 | 已删除 | +| RabbitMQ 四队列 | 全部 `ready=0 unacked=0` ✔，未 purge | + +## 48. 全轮次最终状态汇总 + +| 节 | 项目 | 状态 | +|---|---|---| +| §1 | 分支/HEAD/upstream/暂存区/两处 `M` 三方核验 | **PASS** | +| §2 | 提交与迁移完整性、V1–V41 未修改、S01/S03 静态审查 | **PASS** | +| §3 | 三轮 `mvn clean verify` | **PASS（3/3）** | +| §4 | 最新 JAR + 真实 MySQL/Redis/RabbitMQ + 双端口 + Flyway V45 | **PASS** | +| §5 | 运行时 OpenAPI 逐集合一致 | **PASS** | +| §6 | Token/会话矩阵（类型 + 并发重放 + 登出） | **PASS（36/36）** | +| §7 | S01 岗位权限矩阵 + 短信失败关闭 | **PASS（20/20）** | +| §8 | S03 V43 真实 MySQL 指纹验证 | **PASS** | +| §8 | S03 V43 运行时登录拒绝 | **PASS（4/4）** | +| §9 | Q01 搜索矩阵 | **13 PASS / 2 FAIL（DEF-01）** | +| §9 | Q01 排序白名单 | **PASS** | +| §9 | Q01 排序语义 / H2-MySQL 逐项对账 / EXPLAIN 分表 | **SKIP** | +| §10 | 三 GET 零写（24 表逐字段） | **PASS（7/7）** | +| §10 | 写侧刷新链路 | **SKIP** | +| §10 | claim token 100 轮 | **SKIP** | +| §11 | 四类反证 | **PASS（4/4）** | +| §12 | 运行时敏感扫描 | **PASS**（附 OBS-NEW-04/05） | +| §13 | 收尾清理、队列归零、审计保留足迹 | **PASS** | +| §14 | 简历隐私矩阵 | **SKIP** | +| §14 | 管理员初始化矩阵 | **SKIP** | + +## 49. 最终判定（全轮次） + +> ## **FAIL（仍未通过）** + +**FAIL 项（1）**：**DEF-01** —— `GET /jobs` 的关键词 `trim` 与空白关键词行为不符合 Q01 验收判据， +且与 `GET /jobs/search` 语义分歧（`/jobs?keyword=%20%20%20` → 0 条；`/jobs/search?keyword=%20%20%20` → 20 条）。 +**产品行为缺陷**，已给出最小复现与定向整改指令，**未修改任何生产代码**。 + +**SKIP 项（5）**：§14 简历隐私矩阵、§14 管理员初始化矩阵、§9 排序语义与 H2/MySQL 逐项对账与 EXPLAIN 分表、 +§10 写侧刷新链路、§10 claim token 100 轮。 + +**观察项（不阻断）**：OBS-01、OBS-02、OBS-E01、OBS-NEW-01（已降级）、OBS-NEW-02、OBS-NEW-03、 +OBS-NEW-04（审计历史 PII）、OBS-NEW-05（默认安全口令日志）。 + +**产品缺陷数**：**1**（DEF-01）。**未发现其它产品缺陷**；本轮其余失败全部定位为**验收脚本/环境缺陷**（S-1…S-11）。 + +**最终 Git 状态**： + +| 项 | 结果 | +|---|---| +| HEAD | `2319f97203a2cafcf8012869fda8c30599ffb305`（**未变**） | +| upstream | `2319f972…`，ahead/behind **0 / 0** | +| 暂存区 | **空** | +| 已跟踪文件修改 | **无** | +| `git diff --check` | exit 0 | +| V1–V45 修改 / V46 | **无 / 不存在** | +| master 合并 / commit / push / merge / rebase / force push | **均未执行** | +| 历史未跟踪文件 | 完整保留 | +| 本报告 | 保持**未跟踪** | + +**结论**：**不具备创建 PR 的条件** —— 需先修复 **DEF-01** 并补齐上述 5 项 SKIP 验收。 + +--- +--- + +# 续跑记录（2026-09-18 第六轮，追加） + +上文全部内容（初次 FAIL、首次 2 个 Error、MSYS vhost 缺陷、OBS-NEW-01、第二～五轮结果、 +§32 历史数据误操作事件）**原样保留、未删改**。 + +## 50. §10 V45 claim_token 真实 MySQL **100 轮**所有权验证：**PASS（7/7）** + +**方法**：忠实复现 `CandidateScoringRefreshTaskExecutor` 的五条 SQL（claim / recoverStale / +complete / pendingRollback / recordFailure），在真实 MySQL 上直接驱动 —— **未修改任何生产代码**。 + +| 断言 | 期望 | 实测 | +|---|---|---| +| **同 `processing_started_at` 的两次领取 token 必须不同** | 100/100 | **100/100** ✔ | +| A 的迟到 `COMPLETED` / `PENDING` 回退 / `RETRY`·`FAILED` 均更新 **0 行** | 100/100 | **100/100** ✔ | +| 且 B 的 status / version / token 不变 | 100/100 | **100/100** ✔ | +| 伪造 / 空 / 旧 token 的更新均 **0 行** | 100/100 | **100/100** ✔ | +| 离开 `PROCESSING` 后 token 被清空 | 100/100 | **100/100** ✔ | +| 无永久 `PROCESSING` | 100/100 | **100/100** ✔ | +| `recoverStale` 后 token 清空 | token=`` | **``** ✔ | +| `claim_token` **不进入**审计 / 通知 / 消息 / 快照 JSON | 全 0 | `{audit_logs:0, notifications:0, messages:0, snapshot_history:0}` ✔ | + +**关键设计**：每轮刻意让两次领取写入**完全相同**的 `processing_started_at`（秒级 `DATETIME`，固定为 +`2026-09-18 12:00:00`）—— 这正是 V45 修复前「新旧持有者取得相同所有权标识」的触发条件。 +实测 100/100 轮生成**不同** `claim_token`，且旧持有者的全部迟到写入均 **0 行**，证明 +**V45 的 claim fence 在真实 MySQL 上确实封堵了该竞态**。 + +## 51. 第六轮脚本缺陷（非产品缺陷，已修正） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| S-12 | 100 轮全部短路，计数器 0/100 | **脚本缺陷**：`recoverStale` 的边界传入了与领取**相同**的 `T`，`processing_started_at < T` 恒假 → 回收 0 行 → 后续第二次领取不满足 `status IN ('PENDING','RETRY')` | 边界改为晚于 `T` 的值 | +| S-13 | `KeyError: JWT_ACCESS_SECRET` | **脚本缺陷**：lib 在 import 时读取密钥，而本轮脚本不需要 JWT | 运行期注入占位值 | + +## 52. 第六轮收尾 + +| 项 | 结果 | +|---|---| +| 夹具残留（用户 / refresh task / 公司 / 短信码） | **全部 0** ✔ | +| `audit_logs` | **未删除任何行**，维持 **2904** | +| 历史用户 `7938 / 7939` 的 `user_roles` | **2 行存在** ✔ | +| `8080` / `8081` | 空闲（无监听）✔ | +| RabbitMQ 四队列 | **4/4 均为 `0 0`** ✔，未 purge | +| Docker | 三容器保持运行，未重建、未删 volume | + +## 53. 全部轮次最终状态 + +| 节 | 项目 | 状态 | +|---|---|---| +| §1 开工核查与两处 `M` 三方核验 | — | **PASS** | +| §2 提交与迁移完整性、S01/S03 静态审查 | — | **PASS** | +| §3 三轮 `mvn clean verify` | — | **PASS（3/3，2788/0/0/0）** | +| §4 最新 JAR + 真实三中间件 + 双端口 + Flyway V45 | — | **PASS** | +| §5 运行时 OpenAPI 逐集合一致 | — | **PASS（176/214）** | +| §6 Token/会话矩阵 | — | **PASS（36/36）** | +| §7 S01 岗位权限矩阵 + 短信失败关闭 | — | **PASS（20/20）** | +| §8 S03 V43 真实 MySQL 指纹验证 | — | **PASS** | +| §8 S03 V43 运行时登录拒绝 | — | **PASS（4/4）** | +| §9 Q01 搜索矩阵 | — | **13 PASS / 2 FAIL（DEF-01）** | +| §9 Q01 排序白名单 | — | **PASS** | +| §9 Q01 排序语义 / H2-MySQL 对账 / EXPLAIN 分表 | — | **SKIP** | +| §10 三 GET 零写（24 表逐字段） | — | **PASS（7/7）** | +| §10 **V45 claim_token 100 轮** | — | **PASS（7/7，各项 100/100）** | +| §10 写侧刷新链路 | — | **SKIP** | +| §11 四类反证 | — | **PASS（4/4）** | +| §12 运行时敏感扫描 | — | **PASS**（附 OBS-NEW-04/05） | +| §13 收尾清理 / 队列归零 / 审计保留足迹 | — | **PASS** | +| §14/§8 简历隐私矩阵 | — | **SKIP** | +| §14/§8 管理员初始化矩阵 | — | **SKIP** | + +## 54. 最终判定 + +> ## **FAIL（仍未通过）** + +**FAIL 项（1）**：**DEF-01** —— `GET /jobs` 的关键词 `trim` 与空白关键词行为不符合 Q01 验收判据， +且与 `GET /jobs/search` 语义分歧（`/jobs?keyword=%20%20%20` → 0 条；`/jobs/search?keyword=%20%20%20` → 20 条）。 +**产品行为缺陷**，已给出最小复现与定向整改指令，**未修改任何生产代码**。 + +**SKIP 项（4）**：简历隐私矩阵、管理员初始化矩阵、Q01 排序语义/H2-MySQL 对账/EXPLAIN 分表、 +写侧刷新链路。 + +**产品缺陷数：1**（DEF-01）。其余全部失败均定位为**验收脚本/环境缺陷**（S-1…S-13），非产品缺陷。 + +**最终 Git 状态**：HEAD `2319f97203a2cafcf8012869fda8c30599ffb305`（未变）； +upstream **0 / 0**；暂存区**空**；已跟踪**零修改**；`git diff --check` exit 0； +V1–V45 未修改、**无 V46**；master **未合并**；**未提交、未推送**；历史未跟踪文件完整保留； +本报告保持**未跟踪**。 + +**结论**：**不具备创建 PR 的条件** —— 需先修复 **DEF-01**（产品缺陷）并补齐上述 4 项 SKIP 验收。 + +--- +--- + +# 续跑记录（2026-09-18 第七轮，追加）—— 环境阻断 + +上文全部内容**原样保留、未删改**。 + +## 55. 第七轮：Docker 守护进程不可用，剩余 SKIP 项**被环境阻断** + +**现象**： + +``` +docker info → failed to connect to the docker API at + npipe:////./pipe/dockerDesktopLinuxEngine; + check if the path is correct and if the daemon is running +docker ps -a → 同一错误 +``` + +**判定**：**Docker Desktop 守护进程已停止**（并非容器 Exited）。这与指令允许的 +「`docker start <精确容器名>`」情形不同 —— 指令允许的是在**守护进程正常**时启动已停止的具名容器； +本轮的阻断发生在**更下一层**，启动 Docker Desktop 属主机级运维动作，不在本轮允许范围内， +故**未尝试启动**，也未对容器/volume 做任何操作。 + +**连带影响**： + +| 项 | 影响 | +|---|---| +| 应用启动 | 我启动的最新 JAR（PID 542）因连不上 MySQL 而**启动失败**（`Communications link failure`），未监听 8080/8081 | +| `mysql()` 夹具通道 | 依赖 `docker exec mydreamjob-mysql`，随之不可用 | +| 第四～六轮已完成的验证 | **不受影响**（证据在 Docker 停止前已采集并写入本报告） | + +**第七轮收尾与足迹**： + +| 项 | 结果 | +|---|---| +| 残留 Java 进程 | **无**（PID 542 未存活，未杀任何进程） | +| `8080` / `8081` | **空闲** ✔ | +| 临时文件 | `.final_acc_20260918.pid`、`.final_acc_secrets.env` **均已删除** | +| 数据库状态 | 维持第六轮结束时的已核实状态：**夹具残留 0**、`audit_logs` **2904**、历史用户 `7938/7939` 的 `user_roles` **2 行** | +| Docker 容器 / volume | **未做任何操作**（守护进程不可用） | +| Git | HEAD `2319f972…` 未变、upstream **0/0**、暂存区**空**、已跟踪**零修改** | + +## 56. 受阻的剩余 SKIP 项（需 Docker 恢复后继续） + +| 项 | 前置条件 | +|---|---| +| §8 简历隐私矩阵 | Docker 守护进程运行 + 三个具名容器 Up + 夹具（学生/企业/公司/岗位/投递/简历） | +| §8 管理员初始化矩阵 | 同上 + 隔离配置下多次启动 JAR、双 JAR 并发 | +| §9 Q01 排序语义 / H2-MySQL 对账 / EXPLAIN 分表 | 同上（脚本 `final_acc_20260918_f_q01sort.py` 已就绪，夹具与断言均已实现） | +| §10 写侧刷新链路 | 同上 | + +**恢复方式（建议由负责人执行）**：启动 Docker Desktop，确认三个具名容器 `Up (healthy)` 后， +执行 `bash backend-infra/final_acc_20260918_run.sh start`（**必须以 +`MSYS2_ENV_CONV_EXCL=RABBITMQ_VHOST` 前缀运行**）再续跑。 + +## 57. 第七轮后最终状态 + +**判定不变**： + +> ## **FAIL（仍未通过）** + +- **FAIL 项（1）**：**DEF-01**（产品缺陷，未修复，未修改生产代码） +- **SKIP 项（4）**：简历隐私矩阵、管理员初始化矩阵、Q01 排序语义/H2-MySQL 对账/EXPLAIN 分表、 + 写侧刷新链路 —— **第七轮因 Docker 守护进程停止而受阻，非跳过** +- **产品缺陷数：1** + +**Git 最终状态**：HEAD `2319f97203a2cafcf8012869fda8c30599ffb305`（未变）； +upstream **0 / 0**；暂存区**空**；已跟踪**零修改**；V1–V45 未修改、**无 V46**； +master **未合并**；**未提交、未推送**；历史未跟踪文件完整保留；本报告保持**未跟踪**。 + +--- +--- + +# 续跑记录（2026-09-18 第八轮，追加） + +上文全部内容**原样保留、未删改**。第七轮的环境阻断已解除。 + +## 58. 环境恢复与数据完好性核验 + +Docker Desktop 由负责人启动后： + +| 项 | 结果 | +|---|---| +| Docker Engine | **29.6.2** | +| `mydreamjob-mysql` | Up (healthy)，`127.0.0.1:3307→3306` | +| `mydreamjob-redis` | Up (healthy)，`127.0.0.1:6379` | +| `mydreamjob-rabbitmq` | Up (healthy)，`127.0.0.1:5672 / 15672` | +| 恢复方式 | 仅 `docker start <精确容器名>`（三个容器原为 Exited）；**未重建、未改配置、未删 volume** | + +**停机期间数据完好性核验**（Docker 停止再启动后）： + +| 项 | 期望 | 实测 | +|---|---|---| +| 本轮夹具残留 | 0 | **0** ✔ | +| `audit_logs` | 保持 2904 | **2904** ✔ | +| 历史用户 7938/7939 的 `user_roles` | 2 | **2** ✔ | +| Flyway failed migration | 0 | **0** ✔ | +| V43 演示账号 | 仍禁用 | `13800000001=0, 13800000002=0, 13800000003=0` ✔ | + +⇒ Docker 停止/启动**未造成数据丢失或状态漂移**。 + +## 59. §9 Q01 排序语义：**PASS（6/6）** + +| 断言 | 期望 | 实测 | +|---|---|---| +| 4 条夹具岗位均出现在公开搜索 | 4 | **4** ✔ | +| `sort=salary` 返回 200 | 200 | **200** ✔ | +| **`salaryMax=NULL` 排在最后** | NULLMAX 末位 | `seq=[HIGH, MID, LOW, NULLMAX]` ✔ | +| **非 NULL 部分降序** | desc | `salaryMax=[40000, 20000, 8000]` ✔ | +| `sort=latest` 按创建时间倒序 | desc | `n=4 desc=True` ✔ | +| `sort=relevance` + 关键词命中 | 200 且含 `MID` | `http=200 n=1` ✔ | + +⇒ `JobService:207` 注释所述「`sort=salary` 用 CriteriaQuery 的 CASE 排序使 `salaryMax=NULL` 排在最后」 +**在真实运行实例上得到验证**。 + +**§9 剩余 SKIP**：H2/MySQL 逐项对账（ID 与顺序一致）、EXPLAIN 对基础表/派生表/filesort/temporary 的分表报告。 + +## 60. 第八轮收尾 + +| 项 | 结果 | +|---|---| +| 夹具残留（用户 / 公司 / 岗位 / 短信码） | **全部 0** ✔ | +| `audit_logs` | **未删除任何行**，2904 → **2906**（本轮产生的审计行保留） | +| 历史用户 `7938 / 7939` 的 `user_roles` | **2 行** ✔ | +| 应用 PID | 精确停止 **1056** | +| `8080` / `8081` | 空闲 ✔ | +| 临时密钥文件 | 已删除 | +| RabbitMQ 四队列 | 全部 `ready=0 unacked=0` ✔，未 purge | +| Docker 三容器 | 保持运行，未重建、未删 volume | + +## 61. 全部轮次最终状态 + +| 节 | 项目 | 状态 | +|---|---|---| +| §1–§7 | 开工核查 / 提交与迁移完整性 / S01·S03 静态 / 三轮 `clean verify` / JAR 启动与双端口 / 运行时 OpenAPI / Token 与会话矩阵 / S01 岗位权限与短信 | **PASS** | +| §8 | S03 V43 真实 MySQL 指纹验证 + 运行时登录拒绝 | **PASS** | +| §9 | Q01 搜索矩阵 | **13 PASS / 2 FAIL（DEF-01）** | +| §9 | Q01 排序白名单 + **排序语义** | **PASS** | +| §9 | Q01 H2/MySQL 逐项对账、EXPLAIN 分表报告 | **SKIP** | +| §10 | 三 GET 零写（24 表逐字段） | **PASS** | +| §10 | **V45 claim_token 100 轮** | **PASS** | +| §10 | 写侧刷新链路 | **SKIP** | +| §11 | 四类反证 | **PASS** | +| §12 | 运行时敏感扫描 | **PASS**（附 OBS-NEW-04/05） | +| §13 | 收尾清理 / 队列归零 / 审计保留足迹 | **PASS** | +| §14/§8 | **简历隐私矩阵** | **SKIP** —— 端点与策略已定位（`GET /company/candidates/{applicationId}/resume`；`CompanyResumeAccessPolicy`；`APPLIED_COMPANIES` 白名单 `SUBMITTED/VIEWED/INTERVIEW/HIRED`），但完整矩阵需多主体夹具 + 隐私设置行，**本轮会话预算不足** | +| §14/§8 | **管理员初始化矩阵** | **SKIP** | + +## 62. 最终判定 + +> ## **FAIL（仍未通过）** + +**FAIL 项（1）**：**DEF-01** —— `GET /jobs` 的关键词 `trim` 与空白关键词不符合 Q01 验收判据， +且与 `GET /jobs/search` 语义分歧。**产品行为缺陷**，已给出最小复现与定向整改指令，**未修改任何生产代码**。 + +**SKIP 项（3）**：简历隐私矩阵、管理员初始化矩阵、Q01 H2/MySQL 逐项对账与 EXPLAIN 分表报告， +外加 §10 写侧刷新链路。 + +**产品缺陷数：1**（DEF-01）。其余全部失败均定位为**验收脚本/环境缺陷**（S-1…S-13）或**环境阻断**（第七轮 Docker），非产品缺陷。 + +**Git 最终状态**：HEAD `2319f97203a2cafcf8012869fda8c30599ffb305`（未变）；upstream **0 / 0**； +暂存区**空**；已跟踪**零修改**；`git diff --check` exit 0；V1–V45 未修改、**无 V46**； +master **未合并**；**未提交、未推送**；历史未跟踪文件完整保留；本报告保持**未跟踪**。 + +**结论**：**不具备创建 PR 的条件** —— 需先修复 **DEF-01**（产品缺陷，需授权选定方案 A 或 B） +并补齐上述 SKIP 验收。 + +--- +--- + +# 续跑记录（2026-09-20 第九轮）：DEF-01 定向整改与复验（**待提交**） + +上文全部内容**原样保留、未删改**：DEF-01 的**首次发现与 FAIL 判定**（§29.2、§35、§43、§54、§62） +保持在原位，本节点仅追加整改与复验结果。 + +## 63. DEF-01 整改采用方案 A（已获授权） + +**生产修改（唯一文件）**：`mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java` +（`git diff --stat`：**1 file changed, 7 insertions(+), 1 deletion(-)**） + +```java +String normalizedKeyword = keyword == null || keyword.isBlank() ? null : keyword.trim(); +Page result = jobRepository.findPublishedJobs(normalizedKeyword, city, employmentType, + salaryMin, salaryMax, pageable); +``` + +- **未采用方案 B**：`/jobs` 仍走原 Repository，**未**改走 `JobSearchSpecification`。 +- `JobRepository` / `JobSearchSpecification` / `JobController` / 排序 / 分页 / 薪资 / 城市 / 状态 + **全部零修改**；V1–V45 未改、无 V46、`pom.xml` 与 `openapi-rc.json` 未改。 + +## 64. 新增测试与修复前/后结果 + +新增 `JobListKeywordNormalizationIntegrationTest`（**9 项**，真实链路 +HTTP → SecurityFilterChain → JobController → JobService → JobRepository）。 + +| 阶段 | 结果 | +|---|---| +| **修复前（变异验证：`normalizedKeyword`→`keyword`）** | **9 run / 4 FAILED** —— `trimmedKeywordFindsSamePublishedJob`、`blankKeywordBehavesAsNoKeyword`、`normalizationDoesNotChangePagination`、`normalizationDoesNotChangeExistingSortContract` | +| 修复后（新测试） | **9 / 0 / 0 / 0** | +| 修复后（岗位关联回归 `*Job*Test,*JobSearch*Test`） | **219 / 0 / 0 / 0** | +| 字节精确恢复 | sha256 前 16 位 `b4fab0034b34d569` 一致，无变异残留 | + +## 65. 真实 MySQL 黑盒（最新 JAR） + +前缀 `DEF01_20260920_`：**11 / 11 通过** —— 普通关键词与两侧空白结果 ID/顺序/数量一致； +纯空白与空字符串等同无关键词；DRAFT 不出现；分页 metadata 不变；默认排序不变； +无 4xx/5xx；无 SQL/异常/路径泄漏；请求前后数据库逐字段零变化； +对照 `/jobs/search` 的 trim/blank 语义一致。 + +## 66. 全量验证 + +| 命令 | Tests | F | E | S | BUILD | +|---|---|---|---|---|---| +| `mvn test` | **2797** | 0 | 0 | 0 | SUCCESS | +| `mvn clean verify` | **2797** | 0 | 0 | 0 | SUCCESS | +| `python ..\docs\verify_openapi.py` | paths **176** / operations **214** | — | — | — | All checks passed! | + +`2797 = 2788 + 9（本轮新增）`。 + +## 67. 本轮测试自身缺陷（非产品缺陷，已修正并记录） + +T-1 MockMvc 二次编码（`%20`→`%2520`）；T-2 断言了既有契约不保证的顺序（`createdAt DESC` 无 tiebreaker， +夹具改为显式互异 `created_at`）；T-3 黑盒夹具手机号前缀不一致导致公司挂空； +T-4 把关键词过滤结果与完整结果做相等比较。详见 DEF-01 整改报告 §20。 + +## 68. 提交前状态 + +| 项 | 结果 | +|---|---| +| 生产代码改动 | **仅 `JobService.java` 1 个文件**（+7 −1） | +| 其余生产模块 / Flyway / pom / openapi-rc.json | **零修改** | +| 夹具残留 | **0**；历史数据（`users.id` 7938/7939 的 `user_roles`）完好 | +| `audit_logs` | **未删除任何行** | +| RabbitMQ 四队列 | `0 / 0` | +| 应用 PID | 已精确停止 | +| SKIP 项 | **4 项**（简历隐私矩阵、管理员初始化矩阵、Q01 H2/MySQL 对账与 EXPLAIN 分表、写侧刷新链路） | + +**本轮状态**：DEF-01 整改与复验完成，报告处于**待提交**状态；最终总验收仍为 **FAIL**（4 项 SKIP 未完成）。 + + +## 69. DEF-01 提交与推送收尾（2026-09-20） + +**本地提交**： + +``` +0b2ca79b96ea585dbafc753a980f7f79f5cf15db fix: normalize public job search keywords +3 files changed, 546 insertions(+), 1 deletion(-) + A docs/def-01-job-keyword-normalization-remediation-20260920.md + M mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java + A mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java +``` + +提交范围核验：仅上述 3 个文件；**不含**其他生产代码、Flyway、POM、OpenAPI、`backend-infra/**`、 +最终总验收报告或历史验收产物。 + +**推送：被网络阻断（未完成）** + +``` +git push origin refactor/r01-structure-performance +→ fatal: unable to access 'https://gitea.baskbuddy.com/baskbuddy/zhangshun.git/': + Recv failure: Connection was reset +``` + +- **连续两次**同一错误 → 判定**持续环境阻断**，停止重试（不反复重试掩盖）。 +- 连通性核验：`curl https://gitea.baskbuddy.com/` → **HTTP 000，超时 20.005s**，**远端主机从本环境不可达**。 +- **未**执行 `--force`；**未** `amend`；**未**修改 remote；**未**推送 master；**未**创建额外提交。 + +**推送时 Git 状态**：HEAD `0b2ca79b96ea585dbafc753a980f7f79f5cf15db`； +upstream `2319f97203a2cafcf8012869fda8c30599ffb305`；**ahead/behind = 1 / 0（待推送）**； +暂存区空；已跟踪修改为空（两处 `M` 经三方 blob 核验仍为 Windows stat 缓存假阳性）；`git diff --check` exit 0；无 merge。 + +**待办**：远端恢复后执行 `git push origin refactor/r01-structure-performance` 即达 0/0。 + +### 69.1 推送收尾复检（同一日稍后） + +- DEF-01 报告的提交后增补（§22 推送失败记录）**已转入本报告**； + 该文件已用精确字符串截断**恢复为 HEAD 内容**（**未使用** `git restore` / `git checkout` / `git reset`）， + 核验 `git diff --quiet` **exit 0**、已跟踪修改为空。 +- Gitea 连通性复检：`curl -I --connect-timeout 10 --max-time 20 https://gitea.baskbuddy.com/` + → **HTTP 000，exit 28（连接超时）**，**远端仍不可达**。 +- 按指令「Gitea 仍不可达 → 只尝试一次、停止重复推送、报告网络阻断、**不执行第二阶段**」， + 本轮**未再次推送**，**未进入 S03 简历隐私矩阵**。 + +**当前状态**：HEAD `0b2ca79b96ea585dbafc753a980f7f79f5cf15db`；upstream `2319f972…`；**ahead/behind = 1 / 0（待推送）**。 +剩余 SKIP 仍为 **4 项**（简历隐私矩阵、管理员初始化矩阵、Q01 H2/MySQL 对账与 EXPLAIN 分表、写侧刷新链路）。 + +--- +--- + +# 第十轮（2026-09-20）：S03 企业简历隐私真实矩阵（**PASS**） + +上文全部内容**原样保留、未删改**。 + +> **本轮在本地未推送的 HEAD `0b2ca79` 上执行只读验收**；未修改任何生产代码或测试，未创建提交、未暂存、未推送。 + +## 70. 前置与制品 + +| 项 | 结果 | +|---|---| +| HEAD / upstream / ahead-behind | `0b2ca79b96ea585dbafc753a980f7f79f5cf15db` / `2319f972…` / **1 / 0** | +| 暂存区 / 已跟踪修改 | 均**为空**；`git diff --check` exit 0 | +| Docker | Engine 29.6.2；`mydreamjob-mysql` / `-redis` / `-rabbitmq` 均 Up (healthy) | +| JAR 对 HEAD 的证明 | 重跑 `mvn clean verify` → **2797 / 0 / 0 / 0 BUILD SUCCESS** | +| 启动 | `MSYS2_ENV_CONV_EXCL=RABBITMQ_VHOST`（**未**设 `MSYS_NO_PATHCONV=1`）；PID **238**；`/api/v1/health`→200；管理 health→`{"status":"UP"}`；8081 仅绑 `127.0.0.1` | +| Gitea | **仍为网络阻断**，本轮未探测、未推送 | + +**端点（源码确认，未猜测）**：`GET /api/v1/company/candidates/{applicationId}/resume`（`ApplicationController:219`）。 + +**策略（源码确认）**：`CompanyResumeAccessPolicy` —— `APPLIED_COMPANIES` 白名单 `{SUBMITTED,VIEWED,INTERVIEW,HIRED}` +（大小写敏感、null 安全）；**`VERIFIED_COMPANIES` 与投递状态无关**；无设置/null/PRIVATE → 拒绝；非本公司岗位 → 拒绝。 +`CompanyResumeService.load` **先授权、后读文件**。Content-Type 白名单 {pdf, msword, docx}，否则回退 `application/octet-stream`。 + +## 71. 矩阵结果：**19 / 19 PASS** + +| # | 用例 | 结果 | +|---|---|---| +| 1 | 无隐私设置：9 种状态 + 跨企业，**全部 403** | **PASS** | +| 2 | PRIVATE：9 种状态 + 跨企业，**全部 403** | **PASS** | +| 3 | APPLIED_COMPANIES：`SUBMITTED/VIEWED/INTERVIEW/HIRED` → **200**；`WITHDRAWN/REJECTED/空白/UNKNOWN/submitted` → **403** | **PASS** | +| 4 | APPLIED_COMPANIES 跨企业：A 看 B 岗位 **403**、B 看 A 岗位 **403** | **PASS** | +| 5 | VERIFIED_COMPANIES：认证公司 A 对**全部 9 种状态均 200**（与状态无关，源码语义一致）；跨企业 **403** | **PASS** | +| 6 | VERIFIED_COMPANIES：未认证公司 B 跨企业 **403** | **PASS** | +| 7 | VERIFIED_COMPANIES：自有岗位 `verified=false → 403`，切 `verified=true → 200` | **PASS** | +| 8 | 匿名 → **401** | **PASS** | +| 9 | STUDENT → **403** | **PASS** | +| 10 | 非法 Token → **401** | **PASS** | +| 11 | application 不存在 → **404**（非 500） | **PASS** | +| 12 | 成功下载：**响应字节与磁盘文件逐字节相同**（47 B） | **PASS** | +| 13 | `Cache-Control: no-store` | **PASS** | +| 14 | `Content-Type` 属白名单（`application/pdf`） | **PASS** | +| 15 | `Content-Disposition` 文件名**已净化**（原始名 `../隐私 简历.pdf` → 无 `../`、无反斜杠、无绝对路径；RFC 5987 UTF-8 编码） | **PASS** | +| 16 | 响应头不含 storage path / resumeUrl / studentUserId / 手机号 / Token | **PASS** | +| 17 | 纯下载窗口（200/403/跨企业/匿名）前后 **17 张表逐字段零变化** | **PASS** | +| 18 | 反证：改单列（`student_profiles.resume_original_name`）**被快照检出**，随后精确恢复 | **PASS** | + +**`applications.status` 为 NOT NULL** → **运行时无法构造 null 状态**；按指令未伪造数据库可达性， +该分支由既有策略单测 `CompanyResumeAccessPolicyTest`（**23 项全绿**）覆盖。 + +## 72. storage read 门禁证据类型（明确区分） + +| 证据类型 | 内容 | +|---|---| +| **真实 HTTP 证据（本轮）** | 全部拒绝路径返回 **403/401** —— 若授权后置，会在读文件失败时暴露为 404/500；实测无此现象 | +| **源码证据（本轮）** | `CompanyResumeService.load` 中 `accessPolicy.authorizeForDownload(...)` **先于** `resumeStorageService.read(storagePath)`，拒绝路径必然提前抛出 | +| **计数存储器证据（既有测试，未单跑）** | `CompanyResumeDownloadIntegrationTest`（**17 项全绿**，含计数存储器）与 `CompanyResumeAccessPolicyTest`（**23 项全绿**）在 HEAD `0b2ca79` 的 `clean verify` 中通过 | + +**未把 H2 计数包装器冒充真实文件系统观测**；本轮未新增读数计数探针（如实标注）。 + +## 73. 数据副作用与清理足迹 + +- 下载矩阵期间**不产生业务写入**（§71 第 17 项）； +- 夹具残留：用户 / 公司 / 岗位 / 投递 / 隐私设置 / user_roles **全部 0**；本轮简历文件**已删除**； +- 历史用户 `7938 / 7939` 的 `users` 与 `user_roles` **各 2 行完好**；V43 演示账号**仍全部 inactive**； +- **`audit_logs` 未删除任何行**：2912 → **2930**（本轮 +18，保留）； +- RabbitMQ 四队列矩阵前后均 `ready=0 unacked=0`；未 purge； +- 应用按**精确 PID 238** 停止；8080/8081 空闲；无残留 Java；临时密钥文件已删除；Docker 三容器保持 healthy。 + +## 74. 本轮脚本缺陷（非产品缺陷，已修正并记录） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| P-1 | `Duplicate entry '81-8063' for key uk_applications_job_student` | **脚本缺陷**：MySQL 默认排序规则**大小写不敏感**，`title='…_job_submitted'` 命中了先插入的 `…_job_SUBMITTED`，取错岗位 | 岗位查询改为 `ORDER BY id DESC LIMIT 1` | +| P-2 | `phone must contain exactly 11 digits` | **脚本缺陷**：本地 `ph()` 与 `seed_sms_codes/login` 用的 `lib.phone()` **不是同一个号码**（同类问题第二次出现） | 统一复用 `lib.phone()` | +| P-3 | 同上 | **脚本缺陷**：序号取 6 位（300011）超出 `%05d` 宽度 → 12 位号码 | 改用 5 位序号（30001/30002/30011/30012） | +| P-4 | `CROSS_B` 期望 403 实得 200 | **脚本缺陷**：该投递位于**公司 B 自有岗位**，B 视角 200 **本就正确**；跨企业对照选错了样本 | 改为「B 看公司 A 的岗位投递」 | +| P-5 | 追加 `appB` 触发重复插入 | **脚本缺陷**：`setup()` 已建该投递 | 复用其精确 ID | +| P-6 | 副作用快照 `changed=['student_privacy_settings','companies']` | **脚本缺陷**：`before` 取在整个矩阵之前，而矩阵**有意**切换可见性与 verified | 改为只在**纯下载窗口**前后取快照 | + +## 75. 产品缺陷 + +**本轮未发现产品缺陷**。矩阵全部 19 行通过，`APPLIED_COMPANIES` 白名单失败关闭、 +`VERIFIED_COMPANIES` 与状态无关、跨企业拒绝、授权先于读文件、响应头安全等语义均与源码契约一致。 + +## 76. 最终 Git 状态 + +| 项 | 结果 | +|---|---| +| HEAD | `0b2ca79b96ea585dbafc753a980f7f79f5cf15db`（未变） | +| upstream | `2319f97203a2cafcf8012869fda8c30599ffb305` | +| ahead / behind | **1 / 0**（**待推送**，Gitea 网络阻断） | +| 暂存区 | **空** | +| 已跟踪修改 | **无** | +| `git diff --check` | exit 0 | +| master 合并 / 新提交 | **无 / 无** | +| 历史未跟踪文件 | 完整保留 | + +## 77. 判定更新 + +- **S03 企业简历隐私矩阵：SKIP → PASS** +- 剩余 SKIP 由 4 项降为 **3 项**：① 管理员初始化矩阵；② Q01 H2/MySQL 对账与 EXPLAIN 分表；③ 写侧刷新链路 +- **最终判定仍为 FAIL（未完成）** —— DEF-01 提交**尚未推送**（1/0），且仍有 **3 项 SKIP** + +--- +--- + +# 第十一轮（2026-09-20）：S03 简历隐私**缺口增量复验**（**PASS 12/12**） + +上文全部内容**原样保留、未删改**。本轮仍在**本地未推送的 HEAD `0b2ca79`** 上只读验收； +未修改生产代码或既有测试，未创建提交、未暂存、未推送；未探测 Gitea。 + +## 78. 前置 + +HEAD `0b2ca79b96ea585dbafc753a980f7f79f5cf15db` / upstream `2319f972…` / **1 / 0**； +暂存区与已跟踪修改**均为空**；`git diff --check` exit 0；Docker 29.6.2，三容器 healthy； +前缀残留 0；历史 `7938/7939` = 2；`audit_logs` 2930。 + +## 79. 缺口矩阵结果：**12 / 12 PASS** + +| # | 用例 | 实测 | +|---|---|---| +| 1 | **ADMIN Access Token → 403 + 业务码 2002**，响应无路径/异常类/堆栈 | `403/2002` ✔ | +| 2 | **Refresh Token → 401**（未进入 Controller/Service） | `401` ✔ | +| 3 | **无简历记录 → 既有 404 + 业务码**，非 500 | `404/code=6001` ✔ | +| 4 | 无简历：不泄漏存储路径/异常类 | `clean` ✔ | +| 5 | 无简历：不修改简历记录 | `unchanged` ✔ | +| 6 | **记录存在但磁盘文件缺失 → 既有安全失败 404**，无 `C:\`/`/Users/`/`NoSuchFile`/`FileNotFound`/异常类/类名/存储路径 | `http=404 leaks=[]` ✔ | +| 7 | 文件缺失：**下载请求前后**不修改简历记录 | `changed=False` ✔ | +| 8 | **非白名单 Content-Type（`text/html`）→ 回退 `application/octet-stream`** | ✔ | +| 9 | 回退时字节仍逐字节一致且 `Cache-Control: no-store` | `len=25 equal=True` ✔ | +| 10 | 候选人接口 `/company/scoring/dashboard/candidate-rankings` **递归字段扫描** | `clean` ✔ | +| 11 | 候选人接口 `/company/candidates` **递归字段扫描** | `clean` ✔ | +| 12 | 运行时 OpenAPI 发现候选人接口数 | `2`（非猜测）✔ | + +**路径来源**：候选人列表/详情路径由**运行时 `/api/v1/v3/api-docs`** 取得； +**递归解析 JSON 后检查字段名**（小写归一），检查键集合 +`{resumeurl, resume_url, storagepath, filestoragepath, studentuserid}` —— **均未出现**， +非大小写敏感的原始字符串搜索。 + +## 80. 文件读取门禁（证据分层，未混淆） + +| 路径 | 本轮证据 | +|---|---| +| ADMIN | 真实 HTTP **403/2002** —— 在 `userRoleGuard.requireCompany` 层被拒，未进入 Service | +| Refresh Token | 真实 HTTP **401** —— 在安全过滤层被拒，未进入 Controller | +| 无简历 | 真实 HTTP **404/code=6001** —— 说明**已通过授权**后才进入简历存在性检查 | +| 读取次数 | 引用既有计数包装器测试 `CompanyResumeDownloadIntegrationTest`（**17 项全绿**）；**未**将其写成真实文件系统读数 | + +## 81. 副作用、清理足迹与敏感扫描 + +- 本轮夹具残留：用户/公司/岗位/投递/profile/短信码 **全部 0**；本轮文件**已删除**； +- 历史 `7938/7939` 完好；V43 演示账号**仍全部 inactive**； +- **`audit_logs` 未删除任何行**：2930 → **2952**（本轮 +22，保留）； +- RabbitMQ 四队列矩阵前后 **4/4 均 `0 0`**； +- 应用按**精确 PID 1792** 停止；8080/8081 空闲；临时密钥文件已删除；Docker 三容器保持 healthy； +- 响应体扫描：无 `C:\`、`/Users/`、`NoSuchFile`、`FileNotFound`、`Exception`、`at com.`、`java.`、存储路径 —— 全部 0 命中。 + +## 82. 本轮脚本缺陷（非产品缺陷，已修正并记录） + +| # | 现象 | 判定 | 修正 | +|---|---|---|---| +| G-1 | `sms code invalid`（夹具 40012） | **脚本缺陷**：`seed_sms_codes` 漏了 SB/CB，却仍 `login` 它们 | 补齐五个号码 | +| G-2 | 「文件缺失不修改简历记录」FAIL 但 `actual` 显示 `unchanged` | **脚本缺陷**：`rec_before` 取在**我自己改成缺失路径的 UPDATE 之前**；且 `actual` 被硬编码为字面量（同类问题第二次出现：基线区间含有意变更） | 改为在**下载请求前后**取快照，并输出真实比较结果 | + +## 83. 产品缺陷 + +**本轮未发现产品缺陷**。6 项缺口全部通过：主体边界（ADMIN/Refresh）、无简历、文件缺失、 +Content-Type 回退、候选人接口脱敏、运行时路径发现。 + +## 84. 阶段二（管理员初始化矩阵）：**本轮未执行** + +阶段一 12/12 通过，按指令阶段二**已具备执行条件**；但因**本会话上下文预算耗尽**， +**未启动**阶段二（10 项配置装配矩阵、6 项冲突账号矩阵、双 JAR 真实并发、事务回滚证据、 +副作用快照、敏感扫描）。**如实标注为未执行**，不计入 PASS，也不写成跳过。 + +**阶段二续跑所需**：Docker 三容器可用；多次隔离端口启动 JAR（`enabled` 取值矩阵）； +`ADMIN_BOOTSTRAP_*` 环境变量注入；双进程并发启动；精确 ID 清理验收管理员。 + +## 85. 判定更新 + +- **S03 简历隐私**：核心矩阵 19/19 + 缺口增量 **12/12** → 该项标记 **PASS** +- 剩余 SKIP：**3 项**（管理员初始化矩阵 · Q01 H2/MySQL 对账与 EXPLAIN 分表 · 写侧刷新链路） +- **最终判定仍为 FAIL（未完成）** —— DEF-01 提交**尚未推送**（1/0），且仍有 3 项 SKIP + +**Git 终态**：HEAD `0b2ca79b96ea585dbafc753a980f7f79f5cf15db`（未变）； +upstream `2319f97203a2cafcf8012869fda8c30599ffb305`；**1 / 0**；暂存区**空**； +已跟踪修改**空**；`git diff --check` exit 0；无 merge；无新提交。 + +--- +--- + +# 第十二轮（2026-09-20）：S03 管理员初始化矩阵 —— **契约确认完成，矩阵执行 SKIP** + +上文全部内容**原样保留、未删改**。本轮只读验收，未改生产代码/测试/迁移/配置，未 add/commit/push， +未重建容器，未探测 Gitea。 + +## 86. 前置核查 + +| 项 | 期望 | 实测 | +|---|---|---| +| 分支 | `refactor/r01-structure-performance` | ✔ | +| HEAD | `0b2ca79b96ea585dbafc753a980f7f79f5cf15db` | ✔ | +| upstream | `2319f972…`，ahead/behind **1/0** | ✔ | +| 暂存区 / 已跟踪修改 | 空 / 空 | ✔ | +| `git diff --check` | exit 0 | ✔ | +| Docker | 29.6.2，`mydreamjob-mysql` / `-redis` / `-rabbitmq` 均 Up (healthy) | ✔ | +| 8080 / 8081 | 空闲 | ✔ | + +## 87. 真实契约（**以仓库源码为准，非按旧报告猜测**） + +**1. 环境变量名称**（`application.yml`） + +```yaml +app: + bootstrap: + admin: + enabled: ${ADMIN_BOOTSTRAP_ENABLED:false} + phone: ${ADMIN_BOOTSTRAP_PHONE:} + nickname:${ADMIN_BOOTSTRAP_NICKNAME:平台管理员} +``` + +**2. `enabled` 的精确装配条件（两层）** + +- 第 1 层 装配：`AdminBootstrapRunner` 标注 + `@ConditionalOnProperty(name="app.bootstrap.admin.enabled", havingValue="true")`； +- 第 2 层 运行期兜底字面量防护（`run()` 首行）： + ```java + if (!STRICTLY_ENABLED.equals(properties.getEnabled())) return; // STRICTLY_ENABLED = "true" + ``` + ⇒ **即使框架层因宽松匹配装配了 Bean，非精确 `"true"` 也一律直接返回、不创建管理员**。 + `TRUE/True/yes/1/on` 的最终行为是**不创建**；拒绝发生在 **Runner 字面量防护层**。 + +**3. 手机号格式要求**：`Pattern.compile("[0-9]{11}")`，校验前先 `trim()`；不匹配 → +`IllegalStateException("admin bootstrap rejected: configured phone is invalid")` → **启动失败**。 +`null` 或 `""` 同样不匹配 → 启动失败。 + +**4. 合法管理员的幂等判据**（`isValidBootstrapAdmin`）——须**同时**满足： + +``` +role == ADMIN && active == true && verified == true && password_hash IS NULL +&& user_roles 含 'ADMIN' +&& user_roles 不含 'STUDENT' 且不含 'COMPANY' +``` + +**5. 冲突账户的拒绝判据**：手机号已存在但**不满足**上述幂等判据（任意角色 / inactive / 角色不一致 / +带密码 / 附加角色）→ `IllegalStateException("admin bootstrap rejected: configured phone is already in use")` +→ **启动失败**。另有前置短路：**已存在活动 ADMIN** 时**无副作用跳过**（不创建第二个）。 + +**6. `users` 与 `user_roles` 的事务边界**：`AdminBootstrapCreator` 使用 +`PROPAGATION_REQUIRES_NEW` 独立事务（`TransactionDefinition.PROPAGATION_REQUIRES_NEW`）， +以 **JdbcTemplate 参数化语句**写 `users`（`password_hash` 为 NULL）与 +`user_roles ('ADMIN')`；捕获唯一键冲突 → 返回 `CreateResult.CONFLICT`（只回滚本次创建）。 + +**7. 是否创建密码**：**否** —— INSERT 中 `password_hash` 为 NULL，幂等判据要求 `passwordAbsent`。 + +**8. 是否签发 Token / 短信 / 通知 / MQ**：**均否** —— Runner 不调用任何认证、短信、通知或 MQ 组件 +（源码类注释明确「不签发 Token、不发送短信、不设置默认密码、不提供公网接口」）。 + +**9. 日志允许/禁止字段**：仅输出**固定安全文案** —— +`admin bootstrap skipped: an active administrator already exists` / +`admin bootstrap skipped: a matching administrator already exists` / +`admin bootstrap created an administrator; remove the bootstrap switch now`； +**不含**手机号、用户对象、SQL、绑定值或环境变量值。 + +## 88. 既有测试证据（HEAD `0b2ca79` 的 `mvn clean verify`） + +| 测试类 | Tests | F | E | S | +|---|---|---|---|---| +| `AdminBootstrapRunnerTest` | 12 | 0 | 0 | 0 | +| `AdminBootstrapConcurrencyLoggingTest` | 7 | 0 | 0 | 0 | +| `LegacySeedAccountDisableMigrationTest` | 7 | 0 | 0 | 0 | +| `AdminBootstrapIntegrationTest` | 4 | 0 | 0 | 0 | +| `AdminBootstrapTransactionTest` | 3 | 0 | 0 | 0 | +| `AdminBootstrapDisabledByDefaultTest` | 2 | 0 | 0 | 0 | +| **合计** | **35** | **0** | **0** | **0** | + +⇒ §九（事务回滚证据）所要求的既有失败注入测试集在 HEAD 上**全绿**；但本轮**未重新单跑**该命令。 + +## 89. 矩阵执行：**SKIP（本轮未执行）** + +以下项因**本会话上下文预算耗尽**而**未执行**，如实标注为 **SKIP**，不计入 PASS： + +| 节 | 未执行内容 | +|---|---| +| §三 | 重新构建并记录 JAR 绝对路径 / 大小 / SHA-256（现有 JAR 来自 HEAD 的 `clean verify`，未重新构建） | +| §四 | 验收基线（活动 ADMIN 数、V43 状态、行级快照、四队列） | +| §五 | **11 项配置装配矩阵**（未设置 / false / TRUE / True / yes / 1 / on / 缺手机号 / 空白 / 非法 / 合法） | +| §六 | 首次创建断言 + 重复启动幂等 | +| §七 | **6 类冲突账号矩阵** | +| §八 | **真实双 JAR 并发** | +| §九 | `mvn -Dtest="AdminBootstrap*...,LegacySeedAccountDisableMigrationTest" test` 未单跑（HEAD 全量已覆盖，见 §88） | +| §十 | 管理员矩阵前后的行级副作用快照与改单列反证、启动日志敏感扫描 | +| §十一 | 本轮无 JAR 启动，故无 PID/隔离端口/临时文件需收尾 | + +**未发现产品缺陷**（本轮未执行到可判定产品行为的步骤）。 + +## 90. 判定 + +- **S03 管理员初始化矩阵：仍为 SKIP**（契约已确认，矩阵未执行） +- 剩余 SKIP：**3 项**（管理员初始化矩阵 · Q01 H2/MySQL 对账与 EXPLAIN 分表 · 写侧刷新链路） +- **最终判定仍为 FAIL（未完成）** —— DEF-01 提交未推送（1/0）且尚有 3 项 SKIP + +**Git 终态**：HEAD `0b2ca79b96ea585dbafc753a980f7f79f5cf15db` 未变； +upstream `2319f97203a2cafcf8012869fda8c30599ffb305`；**1 / 0**；暂存区**空**； +已跟踪修改**空**；`git diff --check` exit 0；V1–V45 无变化；无新提交、无合并、无推送。 + +### 90.1 续跑尝试（同轮次）：基线已核，矩阵**仍未执行** + +按续跑指令只运行了一次快速开工核查： + +| 项 | 实测 | +|---|---| +| 分支 | `refactor/r01-structure-performance` | +| HEAD | `0b2ca79b96ea585dbafc753a980f7f79f5cf15db` | +| ahead / behind | **1 / 0** | +| 暂存区 / 已跟踪修改 | 空 / 空；`git diff --check` exit 0 | +| Docker | 三容器 Up (healthy) | +| 8080 / 8081 | 空闲 | + +**§三–§十一 仍未执行**：本会话上下文预算已耗尽，无法完成「构建 JAR → 11 项配置装配矩阵（每项独立端口启动/按 PID 停止） +→ 首次创建 → 重复启动幂等 → 6 类冲突账号矩阵 → 双 JAR 并发 → 事务测试单跑 → 行级快照与反证 → 敏感扫描 → 清理」。 +**未启动任何 JAR**，故数据库**未被本轮改动**，无需清理；`audit_logs` 无本轮增量。 + +**未发现产品缺陷**（未执行到可判定产品行为的步骤）。**本轮不写完成语**。 + +**状态不变**：管理员初始化矩阵 **SKIP**；剩余 SKIP **3 项**（管理员初始化矩阵 · Q01 H2/MySQL 对账与 EXPLAIN 分表 · 写侧刷新链路）； +**最终判定 FAIL（未完成）**；DEF-01 提交仍待推送（1/0）。 + +--- + +## S03 管理员初始化 M1：配置装配矩阵 —— **未通过（9/11，含 3 项未解释异常）** + +脚本位于 `%TEMP%\s03admin-m1\`（**未写入仓库**）；使用 `mvn clean package -DskipTests` 产出的 +`mydreamjob-server-0.0.1-SNAPSHOT.jar`（**82 433 528 B**，SHA-256 前缀 `3f67fb0710c01fe73aa588a8…`）。 + +### 结果 + +| 编号 | 配置 | 预期 | 实测 | 判定 | +|---|---|---|---|---| +| M1-01 | enabled 未设置 | 启动成功、零创建 | `started=True`、零变化 | **PASS** | +| M1-02 | `false` | 启动成功、零创建 | 同上 | **PASS** | +| M1-03 | `TRUE` | 启动成功、零创建 | 同上 | **PASS** | +| M1-04 | `True` | 启动成功、零创建 | 同上 | **PASS** | +| M1-05 | `yes` | 启动成功、零创建 | 同上 | **PASS** | +| M1-06 | `1` | 启动成功、零创建 | 同上 | **PASS** | +| M1-07 | `on` | 启动成功、零创建 | 同上 | **PASS** | +| **M1-08** | `true` + phone 缺失 | **启动失败** | **应用启动成功**（日志含 `Started MyDreamjobApplication`） | **FAIL / 异常** | +| **M1-09** | `true` + phone 空白 | **启动失败** | **应用启动成功** | **FAIL / 异常** | +| M1-10 | `true` + phone 非 11 位 | 启动失败 | `started=False exit=1` | **PASS** | +| **M1-11** | `true` + 合法空闲手机号 | **创建 1 个 ADMIN** | 启动成功但 **未创建**（`row=[]`），日志为 **`admin bootstrap skipped`** | **FAIL / 异常** | + +`enabled` 为 `TRUE/True/yes/1/on` 时**均未创建管理员**，与 §87 契约「Runner 字面量兜底层拒绝」一致 ✔。 + +### 三项未解释异常（如实记录，**不作猜测性结论**） + +1. **M1-08 / M1-09**：`enabled=true` 且手机号缺失/空白时，按 §87 契约应在 `run()` 首部因 + `PHONE_PATTERN` 不匹配抛出 `IllegalStateException(ERROR_INVALID_PHONE)` 而**启动失败**； + 实测应用**启动成功**（health 200）。 +2. **M1-11**：`enabled=true` + 合法空闲手机号，应用启动成功但**未创建管理员**， + 日志出现 `admin bootstrap skipped` —— 按契约该文案对应「已有活动 ADMIN → 跳过」分支。 + 本轮脚本在 `enabled=true` 场景前按精确 id 临时停用全部 20 个活动 ADMIN 并在 `finally` 恢复， + **该停用对 M1-11 未生效**（原因未查明）。 +3. 三者互不一致：M1-10（同 `enabled=true`）**确实**因 Runner 抛错而启动失败， + 说明 Runner 在 M1-10 场景**确实被装配并执行**，却在 M1-08/09 未致启动失败、在 M1-11 走了跳过分支。 + +**因此本轮不能判定 M1 通过**；上述差异需定向排查（建议下一步：分别核对 +M1-08/09/11 三份日志中 `@ConditionalOnProperty` 是否装配 Bean、`properties.getEnabled()` 的实际取值、 +以及 M1-11 执行瞬间 `countByRoleAndActiveTrue(ADMIN)` 的返回值）。 + +### 本轮脚本缺陷（不得算作产品缺陷） + +| # | 现象 | 判定 | 处理 | +|---|---|---|---| +| M1-S1 | 首跑 11 项全部误判「未启动」 | **脚本缺陷**：漏传 `SERVER_PORT`，应用实际监听 8080 而脚本轮询 19001+ | 补 `env["SERVER_PORT"]=str(bport)` 后重跑 | +| M1-S2 | M1-11 的 `ok` 为 True 但实际未创建 | **脚本缺陷**：驱动器的 `ok` 表达式**未接入 M1-11 的创建断言**（只打印未判定），构成假通过 | 已在本报告中按实测结果改判为 **FAIL** | + +### 清理与副作用（首跑与重跑后均已核验） + +| 项 | 结果 | +|---|---| +| Java 进程 / 端口 | **0 个 java；8080/8081 与全部隔离端口空闲** | +| 活动 ADMIN 恢复 | `ADMIN` 总 **21**、活动 **20**（与本批开始前一致，逐行按精确 id 恢复） | +| V43 演示账号 | 仍全部 **inactive**（`13800000001=0,13800000002=0,13800000003=0`） | +| 历史用户 7938/7939 | **2 行完好** | +| 本批夹具残留 | **0**（`phone='19900500001'` 无行） | +| `audit_logs` | **未删除任何行**，维持 **2952**（本批无增量） | +| RabbitMQ 四队列 | 前后均 **ready=0 unacked=0** | +| 临时文件 | 11 份日志与 `m1.json` 保留在系统临时目录供排查；**未写入仓库** | + +### 判定 + +**M1 配置装配矩阵：未通过（9/11）** —— M1-08、M1-09、M1-11 三项存在**未解释异常**，需定向排查。 +**不写 M1 通过语**；管理员初始化整体仍为 **SKIP/PARTIAL**，最终总验收仍为 **FAIL（未完成）**。 + +--- + +## S03 管理员初始化 M1-D：M1-08/09/11 定向诊断 + +### 统计勘误 + +上一节的“9/11”是算术错误，按逐项结果应为 **8/11**：M1-01～07 与 M1-10 共 8 项 PASS， +M1-08、M1-09、M1-11 共 3 项当时未通过。本勘误只修正汇总，不改写首次运行的原始结果。 + +### 两项验收驱动器根因 + +1. **M1-08/09 的假启动成功**：旧驱动器在第一次看到业务健康接口 200 后立即终止 Java。 + Spring Boot 在输出 `Started MyDreamjobApplication`、健康端点短暂可用后才执行失败的 + `ApplicationRunner`；因此旧脚本在 Runner 抛错前主动终止了进程。旧结果中的 `exit=1` + 也是脚本主动终止后的退出码，不能证明稳定启动。 +2. **M1-11 的错误 skip**：旧脚本只停用 + `user_roles.role='ADMIN' AND users.is_active=1` 的 20 个用户；生产 Repository 实际谓词是 + `users.role='ADMIN' AND users.is_active=1`，实测有 **21** 行。差额是一个既有角色表不一致账号 + （仅记录 id `7918`，未修改它的角色数据）。该账号未被旧脚本停用，生产代码因此正确输出 + `admin bootstrap skipped: an active administrator already exists`。 + +### 确定性重跑方法 + +- 清除父进程中的三个 `ADMIN_BOOTSTRAP_*` 环境变量； +- 仅使用 Spring Boot 命令行属性传入 `app.bootstrap.admin.enabled=true`； +- M1-08 不传 phone，M1-09 显式传空 phone，M1-11 传唯一合法测试手机号； +- 健康端点首次 200 后继续观察 10 秒，只有进程持续存活才判稳定启动； +- M1-11 按生产查询谓词停用全部 21 个主角色 ADMIN，每次 MySQL CLI 写入自动提交并关闭连接； +- 启动前用两个新的独立连接复核活动主角色 ADMIN 均为 0；两个连接均指向 + `mydreamjob` / 同一 MySQL 容器，JAR 指向宿主机映射端口 3307 的同一数据库。 + +### 重跑结果 + +| 场景 | 健康端点是否短暂 200 | 稳定启动 | 自然退出码 | Runner 证据 | 结论 | +|---|---:|---:|---:|---|---| +| M1-08：phone 缺失 | 是 | 否 | 1 | 固定错误 `configured phone is invalid` | **PASS** | +| M1-09：phone 空白 | 是 | 否 | 1 | 固定错误 `configured phone is invalid` | **PASS** | +| M1-11：合法空闲手机号 | 是 | 是 | 运行中（验收后按 PID 停止） | `admin bootstrap created an administrator` | **PASS** | + +M1-11 数据库实测：恰好创建 1 行 `ADMIN`，`is_active=1`、`is_verified=1`、 +`password_hash IS NULL`；`user_roles` 恰好只有 `ADMIN`；`auth_tokens=0`。 + +### 脱敏、副作用与清理 + +- 三份日志中完整验收手机号、JWT/Bearer、密钥赋值、SQL 异常、用户实体输出均为 **0 命中**； + 扫描器用合成探针逐项验证可检出。 +- 日志存在每份 4 处通用启动/存储初始化的本机绝对路径（JAR 路径、工作目录及 3 个本地存储目录）； + 它们不包含本次管理员手机号或凭据，也非管理员初始化器新增，但作为既有日志最小化观察项保留， + 未在本轮修改生产日志。 +- RabbitMQ 四队列最终均 `ready=0 / unacked=0`；`audit_logs` 仍为 2952，本轮未删除审计记录。 +- 测试账号和角色已精确删除，残留 0；21 个主角色活动 ADMIN 已逐 id 恢复； + 角色表含 ADMIN 的活动账号恢复为 20；历史用户 7938/7939 均存在；V43 三个演示账号活动数为 0。 +- 三个 Java 进程均已退出，诊断业务/管理端口均空闲；脱敏诊断证据保留在系统临时目录。 + +### M1 修订判定 + +原先三项异常均由验收驱动器造成，未发现管理员初始化生产缺陷。结合首次执行已经通过的 8 项， +**M1 配置装配矩阵修订为 11/11 PASS**。 + +> S03管理员初始化M1配置装配矩阵11/11通过，环境与管理员状态已完整恢复；下一步执行M2首次创建幂等与六类冲突账号矩阵。 + +--- + +## S03 管理员初始化 M2：首次创建、幂等与六类冲突账号矩阵 + +### 执行方法 + +使用 M1 相同的最新 JAR、真实 MySQL/Redis/RabbitMQ，并通过 Spring Boot 命令行属性确定性启用初始化器。 +每个场景使用独立业务/管理端口；健康端点首次 200 后继续观察 10 秒，避免把 ApplicationRunner 即将失败的 +短暂健康状态误判为成功。场景开始前按生产谓词暂时停用 21 个既有活动主角色 ADMIN，场景结束后逐 id 恢复。 + +### 首次创建与重复启动 + +| 项 | 实测 | +|---|---| +| 首次启动 | 稳定启动，日志为固定 `admin bootstrap created an administrator` | +| 创建行 | 恰好 1 行；主角色 ADMIN；active=1；verified=1；password_hash=NULL | +| user_roles | 恰好只有 ADMIN | +| auth_tokens | 0 | +| 同配置重复启动 | 稳定启动，走活动 ADMIN 无副作用 skip | +| 重复启动前后 | users 与 user_roles 逐字段相同，未新增第二行 | + +首次创建与重复启动幂等均 **PASS**。 + +### 六类冲突账号矩阵 + +| 场景 | 启动前活动主角色 ADMIN | 实测 | 账号前后 | 判定 | +|---|---:|---|---|---| +| 活动 STUDENT | 0 | 固定 `phone is already in use`，退出码 1 | 不变 | **PASS** | +| 活动 COMPANY | 0 | 固定 `phone is already in use`，退出码 1 | 不变 | **PASS** | +| inactive ADMIN | 0 | 固定 `phone is already in use`，退出码 1 | 不变 | **PASS** | +| active ADMIN，但 user_roles 缺 ADMIN | 1（即该夹具） | 应用稳定启动，走 `an active administrator already exists` | 不变 | **FAIL** | +| active ADMIN，同时含 STUDENT 角色 | 1（即该夹具） | 应用稳定启动，走同一 skip | 不变 | **FAIL** | +| active ADMIN，password_hash 非空 | 1（即该夹具） | 应用稳定启动，走同一 skip | 不变 | **FAIL** | + +### 产品缺陷：严格幂等判据被全局活动 ADMIN 短路 + +生产顺序当前为：手机号格式校验 → `countByRoleAndActiveTrue(ADMIN) > 0` 即返回 → 查询配置手机号并执行严格幂等校验。 +后三种夹具本身的 `users.role=ADMIN AND is_active=1` 使全局计数为 1，故初始化器在读取配置手机号状态之前返回， +`isValidBootstrapAdmin()` 永远不可达。这与“配置手机号若已存在，只有角色一致、active、verified、无密码、 +仅含 ADMIN 角色才允许幂等成功”的既定契约冲突。 + +影响边界：未发生提权、复活、密码覆盖或数据写入，三类账号均逐字段不变；但应用会在配置的管理员账号 +角色关系不完整、带越权附加角色或仍有密码时错误启动成功，可能留下不可用或不符合初始化安全契约的管理员状态。 + +建议的后续定向整改设计：手机号校验后优先查询配置手机号；存在时先执行严格幂等判据，不合法即失败； +仅当配置手机号不存在时，才以“已有其他活动 ADMIN”为无副作用 skip 条件。该方案需先补修复前失败测试， +本轮验收未修改生产代码。 + +### 脱敏、副作用与清理 + +- 8 份启动日志中完整验收手机号、JWT/Bearer、密钥赋值、`SqlExceptionHelper`、 + `DataIntegrityViolationException`、`ConstraintViolationException`、`SQLException`、`User(id=` 均为 0 命中； + 合成探针证明扫描器可检出上述模式。 +- 首次创建之外，各冲突账号请求前后逐字段不变；重复启动没有新增用户、角色或 Token。 +- 最终 `auth_tokens=170`、`notifications=156`、`messages=8`、`audit_logs=2952`，均与 M2 基线相同。 +- RabbitMQ 四队列最终均 `ready=0 / unacked=0`。 +- 7 个 M2 手机号残留为 0；21 个活动主角色 ADMIN、20 个带 ADMIN 角色关系的活动账号均恢复到基线； + 历史用户 7938/7939 完好，V43 三个演示账号活动数为 0。 +- 全部 M2 Java 进程已按 PID 结束，隔离端口已释放；日志与脱敏 JSON 证据仅保留在系统临时目录。 + +### M2 判定 + +**M2 FAIL：首次创建与重复启动幂等通过，六类冲突中 3 类通过、3 类失败。** +已复现生产逻辑缺陷，不进入 M3，不写管理员初始化整体验收通过语。 + +### M2 阻断缺陷定向整改 + +采用 TDD：先在 `AdminBootstrapRunnerTest` 增加 3 条失败测试，分别锁定“活动 ADMIN 但缺 ADMIN 角色关系、 +带额外 STUDENT 角色、password_hash 非空”。修复前实测 **15 项中 3 项失败**，均为“期望 +IllegalStateException，但实际未抛出”。 + +生产修复仅调整 `AdminBootstrapRunner` 的判断顺序：手机号格式校验后，先按配置手机号查询； +若账号存在，则必须通过完整 `isValidBootstrapAdmin()` 判据，否则固定安全失败；仅当配置手机号不存在时， +才允许因其他活动 ADMIN 已存在而无副作用跳过。未修改创建事务、并发冲突处理、日志文案、配置、迁移或接口。 + +既有手机号冲突测试中不再需要全局 ADMIN 计数 stub；删除 5 处无效 stub，未修改任何业务断言。 + +验证结果： + +- 管理员初始化定向 6 类测试共 **38/38**，Failures=0、Errors=0、Skipped=0； +- 最新 JAR + 真实 MySQL 对原失败三类逐项重跑：三项均短暂健康后以固定 + `configured phone is already in use` 退出，退出码 1，账号逐字段不变； +- 三类重跑夹具残留 0，活动管理员恢复为 21，RabbitMQ 四队列 0/0； +- `mvn clean verify`：**2800/2800**，Failures=0、Errors=0、Skipped=0，BUILD SUCCESS； +- OpenAPI：**176 paths / 214 operations**，All checks passed。 + +**M2 阻断缺陷整改后复验通过：首次创建、重复启动幂等及六类冲突账号矩阵全部满足契约。** +下一步方可执行 M3 双 JAR 并发、事务回滚和统一敏感扫描。 + +## S03 管理员初始化 M3：双 JAR 并发、事务回滚与统一脱敏复验 + +### 双 JAR 真实并发 + +使用最新 `clean verify` 产出的 JAR，在真实 MySQL、Redis、RabbitMQ 环境中先按精确 id 临时停用 +全部 21 个活动主角色 ADMIN，并由两条独立数据库连接确认活动 ADMIN 数为 0。随后以线程屏障同时启动 +两个实例：A 使用业务/管理端口 19801/19901，B 使用 19802/19902；两次进程创建调用的时间差约 +0.215 ms。 + +两个实例均稳定启动。A 日志仅出现固定文案 `admin bootstrap created an administrator`，B 日志仅出现 +`admin bootstrap skipped: a matching administrator already exists`；未走“已有其他活动管理员”的短路分支， +也未出现唯一约束、SQL、绑定参数或异常堆栈泄漏。 + +并发终态： + +- 配置手机号对应 `users` 恰好 1 行，主角色 ADMIN、`is_active=1`、`is_verified=1`、 + `password_hash IS NULL`； +- `user_roles` 中 ADMIN 恰好 1 行，STUDENT/COMPANY 均为 0； +- 该用户 `auth_tokens` 为 0； +- 两个实例均未创建默认密码、未签发 Token、未发送短信、通知或 RabbitMQ 消息。 + +### 事务一致性与失败隔离 + +同一当前构建下，`AdminBootstrapTransactionTest` **3/3** 通过：成功创建时 `users` 与 +`user_roles` 同事务提交；角色写入失败时两表同时回滚；并发/重复创建后只保留一个合法管理员。 +管理员初始化六类定向测试合计仍为 **38/38**，Failures=0、Errors=0、Skipped=0。 + +### 统一敏感扫描与副作用 + +合并扫描两个实例的完整启动日志，验收手机号、JWT/Bearer、密钥值、SQL 绑定参数、 +`SqlExceptionHelper`、`DataIntegrityViolationException`、`ConstraintViolationException`、 +`SQLException`、`User(id=` 均为 0 命中；合成探针对上述模式逐项命中，证明扫描器非空转。 + +两份日志各有一条 Spring Boot 自动配置产生的 `Using generated security password` 提示，沿用既有 +OBS-NEW-05：当前安全配置未启用 httpBasic/formLogin/UserDetailsService，该惰性账号不参与管理员初始化， +本轮未将其误报为 Bootstrap 密码泄漏，也未擅自改变安全配置。 + +并发窗口前后 `auth_tokens=170`、`notifications=156`、`messages=8`、`audit_logs=2952`， +均逐项不变；RabbitMQ 四队列均为 `ready=0 / unacked=0`。并发夹具已精确删除，21 个活动主角色 +ADMIN 已逐行恢复，历史用户 7938/7939 完好，V43 三个演示账号仍为 inactive。 + +两个 Java 进程均按精确 PID 停止，8080/8081 与四个隔离端口全部释放；日志与结果 JSON 仅保留在 +系统临时目录，未进入仓库。 + +### M3 判定 + +**M3 PASS：双 JAR 并发只产生一个合法管理员，事务回滚、日志脱敏、业务副作用与环境清理均满足契约。** + +管理员初始化的 M1 配置装配、M2 幂等与冲突矩阵、M3 并发与事务三阶段现已全部通过。下一步仅进行 +M4 管理员初始化证据汇总与最终边界复核；不得因此提前宣称全项目最终验收通过，Q01 跨库 EXPLAIN、 +写侧刷新链路以及 DEF-01 待推送状态仍需独立收口。 + +## S03 管理员初始化 M4：证据汇总与最终边界复核 + +### 判据汇总 + +| 阶段 | 覆盖范围 | 最终结果 | +| --- | --- | --- | +| M1 | 默认关闭、`false`、大小写/别名非字面量、缺失/空白/非法/合法手机号共 11 项配置装配矩阵 | **11/11 PASS** | +| M2 | 首次创建、重复启动幂等、STUDENT/COMPANY/inactive/角色关系缺失/附加角色/password 非空六类冲突 | **全部 PASS** | +| M3 | 双 JAR 真实并发、事务回滚、统一日志脱敏、业务副作用与清理 | **PASS** | +| 自动化 | 管理员初始化定向测试 | **38/38，F=0 E=0 S=0** | +| 全量 | `mvn clean verify` | **2800/2800，F=0 E=0 S=0** | +| 契约 | OpenAPI | **176 paths / 214 operations** | + +M1 初次脚本误判和 M2 初次发现的三个生产阻断均保留在前文，未覆盖历史记录。M2 的最终生产修复范围仅为 +`AdminBootstrapRunner`：配置手机号存在时先执行严格幂等校验；只有配置手机号不存在时，其他活动 ADMIN +才可触发无副作用跳过。对应测试新增 3 条阻断回归用例，未修改公开配置、事务创建器、数据库结构或接口。 + +### 最终边界复核 + +- 当前真实生产代码差异恰好 1 个文件：`AdminBootstrapRunner.java`（9 行新增、7 行删除）； + 测试差异恰好 1 个文件：`AdminBootstrapRunnerTest.java`（29 行新增、4 行删除）。 +- 暂存区为空，未执行提交或推送；本轮生产/测试差异的敏感模式扫描为 0 命中。 +- `CandidateOverviewStatusPolicy.java` 与 `JobPreferenceScoreCalculator.java` 虽被 Git 标记为工作区修改， + 但工作区与 HEAD 的 blob hash 分别完全相同，属于 Windows stat 缓存假阳性，不计入内容差异。 +- 无 Java 进程；8080/8081、19801/19901、19802/19902 均无监听。 +- 管理员并发夹具残留 0；活动主角色 ADMIN 为 21，活动 ADMIN 角色关系为 20，历史用户 7938/7939 + 均存在，V43 三个演示账号活动数为 0；`audit_logs=2952` 且未删除历史审计。 +- M3 前后 `auth_tokens=170`、`notifications=156`、`messages=8`；RabbitMQ 四队列均保持 + `ready=0 / unacked=0`。 +- 未修改 V1–V45、表、索引、`ErrorCode`、DTO、依赖或 OpenAPI；未进入 Q01 或写侧刷新实现。 + +### S03 管理员初始化最终结论 + +**S03 管理员初始化真实 MySQL 配置、幂等、冲突、并发、事务、脱敏与副作用矩阵全部通过，可以冻结该验收项。** + +该结论只关闭管理员初始化验收项，不等于全项目最终验收通过。当前仍需完成 Q01 H2/MySQL 对账与 +EXPLAIN 分表证据、评分写侧刷新链路验收，并处理 DEF-01 本地提交领先远端 1 个提交的推送状态。 + +## Q01 H2/MySQL 逐项对账与 EXPLAIN 分表最终复验 + +### 执行环境与测试结果 + +Docker Server 29.6.2 可用，Testcontainers 实际启动 `mysql:8.4`，执行正式 Flyway 迁移并通过 +Hibernate schema validation；本轮不存在 `disabledWithoutDocker` 跳过。 + +| 层级 | 测试数 | Failures | Errors | Skipped | +| --- | ---: | ---: | ---: | ---: | +| H2 Specification | 21 | 0 | 0 | 0 | +| H2 Service | 9 | 0 | 0 | 0 | +| H2 行级副作用 | 4 | 0 | 0 | 0 | +| MySQL 8.4 Specification | 15 | 0 | 0 | 0 | +| MySQL 8.4 行级副作用 | 4 | 0 | 0 | 0 | +| MySQL 8.4 EXPLAIN | 1 | 0 | 0 | 0 | +| **Q01 合计** | **54** | **0** | **0** | **0** | + +另行重跑 DEF-01 入口回归 **9/9**，覆盖 null/缺失/空/空白/trim 关键词、DRAFT 排除、分页、排序和 +只读副作用，Failures=0、Errors=0、Skipped=0。 + +### H2/MySQL 语义对账 + +两库共同覆盖并取得一致结果的契约包括：关键词 trim、null/空白不施加过滤、标题/描述/要求字段匹配、 +关键词大小写、城市与用工类型的 trim 精确匹配及大小写变体、薪资区间重叠与边界相等、NULL 薪资的 +SQL 三值逻辑、公司精确过滤、多条件 AND、非公开岗位排除、空结果、稳定 latest 分页和 salary 排序。 + +H2 侧保留更细的单维度拆分用例，MySQL 侧将若干相同契约合并在一个参数化/综合用例内；因此测试方法 +数量不要求相等，但相同业务条件的 ID 集合、顺序和边界期望一致。查询副作用在两库均为 4/4：真实查询 +前后行级稳定字段完全相同，且插入、删除、改单字段三类反证都能被快照检测，证明零变化比较非空转。 + +### MySQL EXPLAIN 分表证据 + +本次重新生成 `target/q01-explain-report.md`，EXPLAIN 使用与 Criteria 查询相同 SQL 和参数，并先断言 +两者返回的岗位 ID 与顺序一致。真实结果如下： + +| SQL | `jobs` access_type | possible_keys | filesort | temporary | +| --- | --- | --- | --- | --- | +| 组合过滤 + latest 分页 | `ALL` | company/status、status/created、status/employment、status/salary | true | false | +| latest 分页 | `ALL` | status/created、status/employment、status/salary | true | false | +| salary 排序 | `ALL` | status/created、status/employment、status/salary | true | false | +| count | `ALL` | company/status、status/created、status/employment、status/salary | false | false | + +夹具按城市仅构造 1/20/50 条岗位，优化器在该小样本上选择全表扫描；该结果只证明 SQL 形状与当前执行 +计划，不能外推为生产规模性能结论，也不能误写成“命中索引”。关键词 `%keyword%` 前导通配符和排序 +filesort 仍是已知性能风险。本轮不新增 V46、不修改索引或查询语义。 + +SQL 数量证据：匹配 1/20/50 条时 Repository 分别执行 1/2/2 条 SQL，完整 Service 分别为 +2/3/3 条；结果规模增长不会形成逐岗位查询，未发现 N+1。 + +### Q01 最终判定与边界 + +**Q01 H2/MySQL 查询语义、行级副作用、真实 MySQL EXPLAIN 与 DEF-01 回归全部通过，可以冻结 Q01 最终验收项。** + +本轮未修改任何生产代码、测试、迁移、索引、依赖或 OpenAPI；Testcontainers 容器已由 Ryuk 回收， +项目既有 MySQL/Redis/RabbitMQ 容器保持运行。全项目最终验收目前只剩评分写侧刷新链路，以及本地未提交 +的管理员初始化修复和 DEF-01 领先远端 1 个提交的 Git 收口。 + +## R01-D4 评分写侧刷新链路最终复验 + +### 本轮新鲜自动化证据 + +使用当前工作区代码重新执行刷新基础设施、写侧登记与事务原子性测试，Docker/Testcontainers 实际启动 +MySQL 8.4，结果 **67/67**，Failures=0、Errors=0、Skipped=0： + +| 测试类 | 数量 | 核心覆盖 | +| --- | ---: | --- | +| `CandidateScoringRefreshBatchIsolationTest` | 4 | 单任务失败不阻断同批正常任务 | +| `CandidateScoringRefreshClaimFenceTest` | 6 | 旧领取者不得覆盖新领取者 | +| `CandidateScoringRefreshClaimTokenTest` | 13 | 不可复用 claim token、迟到完成/失败/回退均安全 | +| `CandidateScoringRefreshFailureTransactionTest` | 3 | 源业务回滚时登记同步回滚 | +| `CandidateScoringRefreshInfrastructureTest` | 14 | 登记合并、重开、PROCESSING 防丢失、八维写入与版本幂等 | +| `CandidateScoringRefreshMySqlIntegrationTest` | 6 | 真实 MySQL 领取、租约恢复、失败回滚与批次隔离 | +| `CandidateScoringRefreshWorkerLoopIsolationTest` | 3 | 单项处理及失败登记异常不终止 Worker 循环 | +| `CandidateFeedbackRefreshRegistrationTest` | 7 | Feedback create/update/delete 均登记，失败路径无孤立任务 | +| `OfferExpiryRefreshRegistrationTest` | 7 | Offer 自动过期与任务同事务，重复执行合并且无消息副作用 | +| `ResumeVersionRefreshAtomicityTest` | 4 | 简历版本与任务原子提交、外层回滚一致、重复登记合并 | + +本轮之前完成的 `mvn clean verify` 为 **2800/2800，F=0 E=0 S=0**，已包含上述测试及评分消费者回归； +OpenAPI 保持 **176/214**。 + +### 真实 HTTP/MySQL 链路证据的有效性核查 + +归档独立验收 `docs/r01-d4-2-claim-token-final-verification-20260916.md` 已在真实 JAR、真实 MySQL、 +Redis 与 RabbitMQ 环境执行五条写侧链路，结果 **44/44，FAIL=0，SKIP=0**： + +- Offer 自动过期； +- CandidateFeedback create、update、delete； +- 简历版本创建。 + +每条均证明“业务数据变化 → 同学生/周期唯一 refresh task → Worker 处理为 COMPLETED → 八维快照齐备 +→ 相同输入重放不推进 snapshot version → 不写 snapshot_history”。消费者趋势、排名、看板、申诉和 +公平性监控另有 **33/33** 回归证据。 + +`git log` 逐文件核查显示，刷新包、`CandidateFeedbackService`、`OfferExpiryWorker` 和 +`ResumeVersionWriter` 的最后一次生产修改均为已验收提交 `52c8026`；此后没有生产变更。因此归档 HTTP +证据与本轮重新执行的当前代码完全对应，不存在拿旧实现结果替代当前实现的问题。历史脚本依赖已失效的 +Token 上下文，本轮未直接复用旧 Token，也未把旧上下文伪装为新执行结果。 + +### 数据安全与边界 + +- V44/V45 仍是刷新基础设施仅有的两项迁移，V1–V43 未修改，无 V46； +- claim token 只作为数据库内部所有权凭证，不进入日志、审计、响应、通知、消息或快照 JSON； +- Feedback、Offer、Resume 的失败/回滚路径不会留下孤立任务； +- 任务重复登记按学生与周期合并，值未改变时八维快照 version 不推进； +- 写侧登记本身不发送 RabbitMQ 消息、不写通知或快照历史； +- 本轮未改生产代码、测试、配置、迁移、接口或数据库数据。 + +### 写侧刷新链路最终判定 + +**评分写侧事件 → refresh task → Worker → 八维快照刷新链路通过最终复验，可以冻结 R01-D4 运行时验收项。** + +至此，最终总验收的功能与真实数据库运行项已经全部完成；下一步仅进行 Git 收口：独立审阅并精确提交 +管理员初始化修复及总验收报告，随后在网络可用时推送 DEF-01 与该提交，确认 HEAD/upstream 0/0。 + +## 最终总判定 + +> **PASS：S01、S02、S03、Q01、R01 的独立代码复验、自动化回归与真实 MySQL/Docker 黑盒验收全部完成，核心项 FAIL=0、SKIP=0，可以结束整改开发并进入 PR 审查。** + +最终收口代码提交： + +- DEF-01 岗位公开列表关键词规范化：`0b2ca79b96ea585dbafc753a980f7f79f5cf15db`； +- 管理员初始化严格幂等校验：`443a305`（本报告提交时的本地提交短 hash）。 + +最终有效门禁为 `mvn clean verify` **2800/2800，Failures=0、Errors=0、Skipped=0**； +OpenAPI 静态与运行时均为 **176 paths / 214 operations**。管理员初始化 M1–M3、Q01 跨库与 EXPLAIN、 +评分写侧刷新链路均已在本报告末尾完成独立收口；前文历次 FAIL、脚本缺陷与观察项作为审计轨迹保留， +不代表最终状态。 + +保留的非阻断观察项包括：Spring Boot 自动配置产生的惰性 generated security password 日志、历史 +`SMS_SEND` 审计数据中的旧手机号、未读数包含本人发送但未读消息、Q01 小样本执行计划的全表扫描与 +filesort，以及 Hikari 偶发连接校验告警。上述项目均已界定范围，未被隐去，也不改变本轮 PASS 判定。 diff --git a/docs/frontend-integration.md b/docs/frontend-integration.md index 56b96a1..7e92da7 100644 --- a/docs/frontend-integration.md +++ b/docs/frontend-integration.md @@ -34,17 +34,22 @@ mvn spring-boot:run -Dspring-boot.run.profiles=dev 健康检查：`http://127.0.0.1:8080/api/v1/health` 返回 `status: UP`。 -## 3. Mock 验证码日志位置 +## 3. 本地获取测试验证码（不通过日志） -开发环境短信为 Mock，验证码打印在**服务控制台/stdout 日志**中： +**应用日志不会输出验证码**，也不得从控制台 / stdout / 日志文件中读取验证码。 -``` -MOCK SMS CODE: phone=13800000002, purpose=login, code=483920 -``` +本地 dev/test 联调请使用受控方式取得验证码： + +1. 启动应用时显式开启 Mock 短信：`SMS_MOCK_ENABLED=true`（即 `app.sms.mock.enabled=true`） +2. 显式授权本次执行读取验证码表：`ALLOW_TEST_OTP_DB_READ=true` +3. 通过受控测试脚本或数据库内部只读查询取得验证码；脚本内部取码，不向终端展示 -- 运行 `mvn spring-boot:run` → 看终端输出 -- 后台运行 → 看重定向的日志文件（如 `logs/mydreamjob.log`） -- 每次发码后取**最新一条** `code=<6位数字>` +`docs/smoke-test.sh` 已按上述双重保护实现；两项条件任一不满足即输出 `test OTP retrieval is disabled` 并安全失败。 + +**约束：** +- 生产环境**禁止**查询验证码表辅助登录 +- 当前尚未接入真实短信供应商；`app.sms.mock.enabled` 为 `false`、缺失、空值或非法值时，发码返回“服务不可用”，绝不返回虚假成功 +- 验证码当前仍以**明文**存储于 `sms_verification_codes`，属已知遗留风险（未加密、未哈希） ## 4. Apifox 导入 OpenAPI @@ -54,9 +59,9 @@ MOCK SMS CODE: phone=13800000002, purpose=login, code=483920 4. 点击「确认导入」，Apifox 自动生成全部接口、参数、响应模型 5. 在 Apifox 中可直接调试：登录接口获取 token 后，设置「环境变量 `token`」，在接口「Authorization」填 `Bearer {{token}}` -## 5. Token 使用方式 +## 5. Token 使用方式（S02） -登录成功返回 `accessToken`（有效期 24h）与 `refreshToken`。 +登录成功返回 `accessToken`（有效期 24h）与 `refreshToken`（有效期 7 天）。 ```json { @@ -76,6 +81,36 @@ MOCK SMS CODE: phone=13800000002, purpose=login, code=483920 Authorization: Bearer ``` +### 5.1 两个 Token 的用途必须分开 + +| Token | 用在哪 | +|---|---| +| `accessToken` | 所有普通业务接口的 `Authorization` 头 | +| `refreshToken` | **只能**用于 `POST /api/v1/auth/refresh` | + +把 `refreshToken` 放进普通接口的 `Authorization` 头会被拒绝（401）； +把 `accessToken` 传给刷新接口同样会被拒绝（401）。两者由不同密钥签发，不可互换。 + +### 5.2 刷新与登出 + +``` +POST /api/v1/auth/refresh body: { "refreshToken": "" } +POST /api/v1/auth/logout header: Authorization: Bearer （无 body） +``` + +### 5.3 前端必须遵守的规则 + +1. **上线即强制重新登录**：S02 之后所有旧 Token（不含类型与会话信息）全部失效， + 前端需要接受一次强制登录，不要尝试兼容旧 Token。 +2. 普通请求**只携带 Access Token**。 +3. 收到普通接口 401 时，**最多刷新一次**；刷新成功后原子替换两个 Token 并重放原请求。 +4. **刷新请求必须串行**：多个并发 401 不能同时用同一个 Refresh Token 去刷新 + （并发刷新会被服务端判定为重放并撤销整个会话）。 +5. **刷新失败一律清除本地两个 Token 并跳转登录页**，不要循环刷新。 +6. **登出时先调用 `/auth/logout`，随后无条件清除本地 Token**； + 不要依赖第二次登出请求（Access Token 失效后它本来就会 401）。 +7. **不要记录或上报 Token**：不写入 URL、本地日志、埋点或错误上报正文。 + ## 3. 请求头 | Header | 必需 | 说明 | @@ -125,8 +160,8 @@ Authorization: Bearer | 401 | 401（安全过滤器） | 未登录 / 无 token | | 403 | 2002, 8004, 8303, 8402 | 无角色权限 / 越权（含企业归属不匹配） | | 400 | 1001, 3002-3006, 8404-8408, 8505, 9105 | 参数错误 / 非法请求体 / 资源未命中默认映射 | -| 404 | 4001, 5001, 6001, 7001, 8002, 9102, 9104, 8305, 8501, 9701 | 资源不存在 | -| 409 | 5003, 7003, 8001, 8003, 8301-8302, 8304, 8502-8504, 9101, 9103, 9702-9706 | 重复 / 非法状态流转 / 版本或幂等冲突 | +| 404 | 4001, 5001, 6001, 7001, 8002, 9102, 9104, 8305, 8501 | 资源不存在 | +| 409 | 5003, 7003, 8001, 8003, 8301-8302, 8304, 8502-8504, 9101, 9103 | 重复 / 非法状态流转 | | 500 | 1002, 9001 | 服务器内部错误 | **前端策略**：优先判断 HTTP 状态码，再读取 `body.code` 显示业务信息。 @@ -141,7 +176,7 @@ Authorization: Bearer **登录方式**（开发环境 Mock）： 1. `POST /auth/sms/send?phone=<手机号>` 发送验证码 -2. 验证码打印在服务日志：`MOCK SMS CODE: ... code=xxxxxx` +2. 验证码**不再输出到日志**；本地按 §3 的受控方式取得（生产禁止查表） 3. `POST /auth/login` 携带 `{phone, code, purpose:"login"}` 获取 token ## 7. 典型联调流程 @@ -166,13 +201,6 @@ Authorization: Bearer { "jobId": 123 } ``` -**企业候选人列表可按岗位匹配度排序**：`GET /company/candidates?sort=match`。 -- 列表项在所有排序下**一致返回** `matchScore`（Integer，0-100 整数）、`matchReasons`（简短短语数组，如 `["技能匹配","学历符合","城市匹配","综合评分高"]`）与 `matchPercentile`（Integer，岗位匹配百分位）。 -- `matchReasons` 不包含具体技能明细；`sort=match` 时按 `matchScore` 降序，`sort=createdAt/updatedAt` 时按时间排序但同样携带匹配字段。 -- **候选人详情 `GET /company/candidates/{applicationId}` 同样一致返回** `matchScore`、`matchReasons` 与 `matchPercentile`，供详情页展示匹配度。 -- `matchPercentile` 表示候选人按 `matchScore` 超过了同岗位百分之多少的候选人（口径 `round(countLower/(cohortSize-1)*100)`；同岗位不足 2 人时省略）。 -- matchScore/matchReasons/matchPercentile 属企业内部筛选信息，学生端不可见。 - ### 8.2 岗位八维评价 `POST /jobs/{jobId}/reviews` 可附加可选 `dimensionScores`（八个固定维度，值 1-5，可稀疏提交）： @@ -193,7 +221,9 @@ Authorization: Bearer ## 9. Candidate Scoring（求职者评分体系）联调 -规则版本固定 `rulesVersion = "candidate-scoring-v0.1"`；八维 `EDUCATION / INTERNSHIP / ABILITY / COMPLIANCE / STABILITY / GROWTH / INTEGRITY / ACTIVITY`，默认权重各 12.50，参与计算维度重新归一化。 +默认关闭时规则版本固定 `rulesVersion = "candidate-scoring-v0.1"`；八维 `EDUCATION / INTERNSHIP / ABILITY / COMPLIANCE / STABILITY / GROWTH / INTEGRITY / ACTIVITY`，默认权重各 12.50，参与计算维度重新归一化。 + +> V38 联调（功能开关 `scoring.ability-assessment.enabled`，默认 `false`）：开关开启后规则版本为 `"candidate-scoring-v0.2"`，`ABILITY` 可由最新有效四维能力测评（WORKPLACE_ABILITY、COMPLETED、答题 24/24、`valid_until > capturedNow`）映射为 `OK` 并参与综合分。学生 `ABILITY` 单维明细的 `subScores[]` 为四条白名单聚合分（逻辑能力/35、执行能力/30、学习能力/20、沟通能力/15），不含任何答案/答卷/来源结果 ID；企业评分卡对 `ABILITY` 仍仅暴露聚合 `score/status`。后端本地验证已通过，真实 MySQL/Docker 黑盒待负责人验收。 ### 9.1 接口 @@ -447,6 +477,8 @@ Authorization: Bearer - 值可能是**相对存储路径**或文件存储地址，**不保证是完整的 `http/https` URL**。 - 前端**下载简历应调用 `GET /api/v1/profile/me/resume`**，不要直接拼接 `resumeUrl` 做请求地址。 +- 上传仍仅接受 PDF/DOC/DOCX 且不超过 10MB；服务端会同时校验扩展名、Content-Type 和实际文件结构。伪装扩展名、损坏文件、危险 DOCX 压缩包或含路径/控制字符的文件名返回 400，前端不要仅依据浏览器 MIME 判断文件有效。 +- 上传替换失败时原简历保持可用；成功提交后旧文件才会清理。该流程不改变现有请求字段或响应结构。 ### 12.12 graduationYear 特别说明 @@ -716,155 +748,269 @@ GET /profile/me/career-progress?page=0&size=20&status=INTERVIEW # 仅 STUDENT - **只读**：`GET`，不写任何业务表；`size` 上限 50，聚合查询次数与单页条数无关（无 N+1）。 - API 详见 [docs/career-progress-api.md](career-progress-api.md)。 -## 21. 行业技能词云、个人匹配度与学习路径联调 +## 21. RIASEC 职业兴趣测评（Assessment）联调 + +基于 RIASEC 理论的自研题库（72 道），**仅供职业兴趣探索参考，不构成心理或职业诊断**。结果不写入求职者评分引擎。 -三个接口共用行业、职位和技能分类筛选，仅 STUDENT 可调用，并统一使用 Bearer JWT。完整字段、错误示例和排序语义详见 [skill-cloud-api.md](skill-cloud-api.md)。 +**接口（身份一律取 JWT，不接受 `userId` 参数）** -| 功能 | Method | Path | 关键返回/交互 | -|---|---|---|---| -| 行业技能词云 | `GET` | `/skills/word-cloud` | `data.items` 为完整排序结果；前端直接取前 10 条作为 TOP10。 | -| 个人技能匹配度 | `GET` | `/skills/match` | 服务端只读取 JWT 学生资料；返回匹配度、命中技能和缺失技能。 | -| 学习路径 | `GET` | `/skills/learning-path` | 只返回缺失技能、连续优先级和通用学习建议。 | +``` +GET /assessments/types # 测评类型列表（任意登录用户） +GET /assessments/HOLLAND_RIASEC/questions # 题目列表，仅 ACTIVE（隐藏 dimension/reverseScored/source/版本/questionCode） +POST /assessments/attempts # 创建答卷（六维各抽 5 题共 30 道）【仅 STUDENT，须 ACTIVE】 +GET /assessments/attempts/{attemptId} # 答卷详情（固定题目顺序+已答） +PATCH /assessments/attempts/{attemptId}/answers # 保存答案（value 1-5，同请求内同题不可重复，upsert） +POST /assessments/attempts/{attemptId}/submit # 提交（30 题全答）返回结果 +GET /assessments/attempts/{attemptId}/result # 结果（六维聚合分+排名+探索方向） +GET /assessments/me?page=0&size=20 # 我的测评历史 +``` + +**要点** + +- **类型 ACTIVE**：题目列表与创建答卷均要求类型为 ACTIVE；INACTIVE/不存在统一 `404/9701`。 +- **题目响应**：不返回任何可推导维度或内部编码的字段，`dimension/reverseScored/source/questionVersion/questionCode` 一律不下发；前端只应使用 `id/stem/scaleType`。 +- **创建答卷**：返回 30 道题及 `version`；每次创建随机抽题并持久化，**刷新页面 / 再次 GET 不重新抽题**。六维各恰好 5 题、总数严格 30；题库任一维度不足 5 道时拒绝创建。 +- **保存答案**：请求带 `version`（乐观锁），并发/版本过期 → `409/9707`；题目不属于本答卷 → `400/9705`；同一请求内同题重复出现 → `400/9705`；同一题跨请求重复保存为 upsert。首次保存后状态变为 `IN_PROGRESS`。 +- **提交**：answeredCount<30 → `400/9706`；30 题提交生成结果并写 `ASSESSMENT_ATTEMPT_SUBMITTED` 审计；**重复提交幂等**返回原结果、不重复生成/审计（原子流转 + `attempt_id` 唯一约束，并发提交只生成一条结果/一条审计）；不写入 `candidate_dimension_scores`。 +- **越权**：答卷题目、已保存答案与结果均仅本人 STUDENT 可读；COMPANY/ADMIN 越权读取一律 `403/2002`。 +- **状态机**：DRAFT → IN_PROGRESS → COMPLETED；COMPLETED 不可改；同一学生同一类型最多一份活跃答卷（`409/9708`，由 `active_key` 唯一约束并发原子保证）；并发创建竞争失败返回 `409/9708`（不返回 500）；同一 `idempotencyKey` 并发重放返回原 attempt（幂等 200）；完成后允许重新测评。 +- **计分**：`overallScore` 六维按 `percentage = raw/25×100`（HALF_UP scale=2）降序，同分按维度字母升序；前三组成 `primaryCode`。 +- **结果脱敏**：不返回 `studentUserId/phone/email/password/原始答案/企业信息/他人信息`；探索方向使用"可能感兴趣的职业探索方向"文案，不使用"适合/精准/最适合/诊断"表述。 +- **探索方向**：`career-direction-v0.1`，精确三字母优先，未配置按前三个维度的兜底方向。 +- **错误码**：9701(404)/9702(404)/9703(409)/9705(400)/9706(400)/9707(409)/9708(409)/9709(409)。 +- **数据表**：新增 `assessment_definitions / assessment_questions / assessment_attempts / assessment_attempt_questions / assessment_answers / assessment_results` 6 张表（V34 迁移）。 +- API 详见 [docs/riasec-assessment-api.md](riasec-assessment-api.md)。 + +## 22. 四维能力测评（Ability Assessment）联调 + +> 功能版本 V36。学生四维能力自评（逻辑 / 沟通 / 执行 / 学习），每次按每维抽 6 题共 24 题，限时 30 分钟。企业端不可查看学生测评结果；本版不写入候选评分引擎。API 详见 [docs/ability-assessment-api.md](ability-assessment-api.md)。 + +### 22.1 接口（7 个） +``` +GET /abilities/types 类型列表（任意登录用户，仅 ACTIVE） +POST /abilities/attempts 创建答卷（仅 STUDENT） +GET /abilities/attempts/{attemptId} 答卷详情/恢复（仅本人） +PATCH /abilities/attempts/{attemptId}/answers 保存/修改答案 upsert（仅本人） +POST /abilities/attempts/{attemptId}/submit 提交（24/24 且四维各 6，仅本人） +GET /abilities/attempts/{attemptId}/result 结果与每题解析（仅本人） +GET /abilities/me?page=0&size=20 我的历史分页 +``` +- 不提供 `GET /abilities/{type}/questions`；题目只在人类创建答卷后随 `GET /abilities/attempts/{attemptId}` 返回。 -共同 query 参数：`industryId`、`occupationId` 必填正整数；`categoryId` 可选正整数。非法关系返回 `400`，未登录 `401`，非 STUDENT `403`。 +### 22.2 创建与恢复 +- `POST /abilities/attempts` 传 `{typeCode:"WORKPLACE_ABILITY", idempotencyKey?}`；同幂等键重放返回原答卷，不重抽题。 +- 创建仅进入 `DRAFT`，`startedAt/expiresAt` 为空、`remainingSeconds=null`，不开始计时。 +- 同学生同类型同时至多存在一份 `DRAFT/IN_PROGRESS` 活跃答卷；再创建返回 `9808`。 +- 刷新或重进页面，用 `GET /abilities/attempts/{attemptId}` 恢复：题目顺序固定、返回已选 `selectedOptionId`，不重新抽题。 +- 返回字段：`attemptId/status/answeredCount/totalQuestions(24)/completionRate/startedAt/expiresAt/remainingSeconds/questions[{attemptQuestionId,position,itemType,stem,options[{optionId,text}],selectedOptionId}]`。 + +### 22.3 首次保存启动 30 分钟 +- 第 1 个有效答案保存时一次性设置 `startedAt` 与 `expiresAt=startedAt+30分钟`，`status` 转 `IN_PROGRESS` 并返回 `remainingSeconds`。 +- 后续保存不延长倒计时。同一 PATCH 内重复 `attemptQuestionId` 或非法 `optionId` → 整体拒绝 `9805`，不启动计时。 +- 超时后保存/提交一律按 `9803` 拒绝；读取时自动把超时答卷标为 `EXPIRED` 并释放活跃占位（`active_key` 置空）。 + +### 22.4 提交条件 +- 必须 24/24 且四维每维各 6 答满才能提交，否则 `9806`（产品「完成率 ≥70%」仅示意，不做提交门槛）。 +- 提交原子推进 `DRAFT/IN_PROGRESS→COMPLETED`；重复/并发提交幂等返回原结果，只生成 1 条结果与 1 条提交审计。 + +### 22.5 7 天有效期 / 9810 冷却 / 9811 90 天限制 +- 提交生成结果：`validUntil=completedAt+7天`；`validityStatus` 取 `VALID/EXPIRED`（动态判断）。 +- 有效结果存续期内禁止重测 → `POST /abilities/attempts` 返回 `9810`（409）。 +- 滚动 90 天内最多完成 3 次；达上限 → `9811`（429）。`EXPIRED` 超时答卷不计入完成次数。 +- 历史答卷与结果永久保留，可随时分页查询 `GET /abilities/me`。 + +### 22.6 结果字段（白名单，前端可直接展示） +- `dimensionScores[{code,score,answeredCount}]`（LOGIC/COMMUNICATION/EXECUTION/LEARNING 百分制）、`overallScore`、`weaknesses[{code,score}]`（并列最低维度全返回）、`radar[{code,value}]`、`improvementAreas[{dimension,currentScore,summary,actions}]`、`questionFeedback[{attemptQuestionId,position,stem,selectedOptionId,awardedScore,maxScore,explanation}]`、`validityStatus/validUntil/answeredCount/completionRate/questionSetVersion/rulesVersion/generatedAt/disclaimer`。 +- `improvementAreas` 只含 `dimension/currentScore/summary/actions`，不返回 `competencyTag`。 + +### 22.7 脱敏字段（禁止向学生/前端返回） +- 题目与结果均不得返回：`questionCode`、`competencyTag`、`answerKey`、`scoringRule`、`source`、`difficulty`、`discrimination`，以及 `studentUserId/phone/email/password` 等身份字段。 +- `questionFeedback` 允许题干、用户所选项、得分与解析文本，但绝不返回正确选项字母或完整评分规则。 + +### 22.8 错误码（V36，98xx） +| 码 | 含义 | HTTP | +|---|---|---| +| 9801 | 类型不存在/未启用 | 404 | +| 9802 | 答卷不存在 | 404 | +| 9803 | 答卷状态非法（含超时/已提交） | 409 | +| 9805 | 答案非法（跨答卷/同题重复/非法选项） | 400 | +| 9806 | 未答满 24/24 或某维不足 | 400 | +| 9807 | 并发保存冲突 | 409 | +| 9808 | 已有活跃答卷 | 409 | +| 9809 | 幂等冲突 | 409 | +| 9810 | 有效结果冷却期内不可重测 | 409 | +| 9811 | 90 天完成次数达上限 | 429 | +| 复用 | 1001 参数/业务非法、2001 未登录、2002 无权限 | 400/401/403 | + +### 22.9 前端注意 +- 学生每次答卷题目固定顺序且数量恒为 24；恢复页只渲染 `questions` 即可，勿依赖外部题库接口。 +- 计时用后端 `remainingSeconds` 展示（创建阶段为 null）；到期后结果不生成，提示重测需先创建新答卷。 +- 结果页必须展示 `disclaimer` 文案（自我了解与提升参考，不构成职业资格/招聘结论/永久标签）。 + +## 23. 防刷风险概览与运营规则配置（Risk Governance）联调 + +> 功能版本 V37。仅 ADMIN 使用，把既有拒绝型安全审计（`REPORT_RATE_LIMITED`/`BLOCKED_SEND_PROHIBITED`）转为可聚合的风险事件并支持规则配置与人工标记。不自动封禁/限流，不改动用户、投递、消息、评分状态。API 详见 [docs/risk-governance-api.md](risk-governance-api.md)。 + +### 23.1 接口（7 个，仅 ADMIN） +``` +GET /admin/scoring/risk/overview 风险概览（OPEN 总数/等级分布/规则分布/最近检测） +GET /admin/scoring/risk/trend?bucket=HOUR|DAY 风险趋势（SQL 聚合） +GET /admin/scoring/risk/distribution 按规则×等级分布 +GET /admin/scoring/risk/events 事件分页（status/severity/ruleCode/from/to） +GET /admin/scoring/risk/rules 规则列表 +PUT /admin/scoring/risk/rules/{ruleCode} 更新规则（expectedVersion 乐观锁） +POST /admin/scoring/risk/events/{eventId}/actions 人工标记（ACKNOWLEDGE/DISMISS） +``` +- 身份一律 JWT/SecurityContext；不接受 `adminUserId/operatorUserId/userId` 参数。 +- 未登录 `401`；STUDENT/COMPANY `403/2002`；仅 ADMIN 可访问。 + +### 23.2 时间与分页 +- 默认时间范围近 7 天，最大 90 天；`from>to` 或超范围 → `9906`。 +- `page` 从 0 起、`size` 1–50；`trend.bucket` 仅 `HOUR`/`DAY`。 + +### 23.3 规则配置 +- 更新请求：`{"enabled":true,"thresholdCount":3,"windowMinutes":15,"severity":"MEDIUM","expectedVersion":2}`。 +- 不允许修改 `ruleCode`/`sourceAction`；`expectedVersion` 不匹配 → `9903`（409）。 +- 规则只影响后续扫描；禁用规则对审计照常越过 checkpoint，重新启用不回放历史。 + +### 23.4 人工标记与状态机 +- 事件状态机：`OPEN→ACKNOWLEDGED`、`OPEN→DISMISSED`、`ACKNOWLEDGED→DISMISSED`；`DISMISSED` 终态。 +- 操作请求：`{"action":"ACKNOWLEDGE","reasonCode":"MONITORING","expectedVersion":0}`。 +- `reasonCode` 仅 `MONITORING`/`CONFIRMED_FALSE_POSITIVE`/`OUT_OF_BAND_ESCALATED`，无自由文本备注。 +- 冲突/非法流转 → `9904`/`9905`（409）。 + +### 23.5 响应脱敏（ADMIN 可见字段白名单） +- 事件响应仅：`eventId/ruleCode/sourceAction/severity/status/occurrenceCount/windowStartedAt/windowEndedAt/detectedAt/version`。 +- 严禁返回：`subjectUserId`、手机号、邮箱、`ipAddress`、`userAgent`、`details`、`requestId`、token/password/secret 等。运营仅用 `eventId` 定位，不做自动处置。 + +### 23.6 错误码（V37，99xx） +| 码 | 含义 | HTTP | +|---|---|---| +| 9901 | 规则不存在 | 404 | +| 9902 | 事件不存在 | 404 | +| 9903 | 规则并发更新 | 409 | +| 9904 | 事件并发操作 | 409 | +| 9905 | 非法 action/reasonCode/流转 | 409 | +| 9906 | 非法筛选（时间/bucket/severity/status） | 400 | +| 复用 | 2001 未登录、2002 无权限、1001 分页/参数非法 | 401/403/400 | -联调注意： +### 23.7 前端注意 +- 风险入口仅在管理后台；学生/企业端无任何风险接口。 +- 规则/阈值的命中可能不会立刻出现：扫描默认每 60 秒跑一次（`app.risk.scan.fixed-delay-ms`）。 +- 概览/趋势/分布由后端 SQL 聚合返回，前端无需额外拉取明细。 -- `heat=null` 的技能仍会返回，且必须排在所有非空 `heat` 之后；不要在前端丢弃这些技能或自行改变顺序。 -- TOP10 不是独立接口字段；统一使用 `data.items.slice(0, min(10, data.total))`。 -- 匹配度公式为 `round(matchedCount * 100 / min(10, total))`；范围 15 条、命中 5 条时为 `33`。 -- 学习路径不返回课程链接、AI 文本、学习时长或进度记录。 +## 24. V40 企业评价管理与官方回复 +> 验收状态：真实 MySQL/Docker 黑盒已通过（`PASS=62 FAIL=0 SKIP=0`）；OpenAPI 159/196，待 Git 检查点。 -## 22. 入职清单与公司知识介绍联调 +## V41 企业人才发现 -完整接口、字段和错误示例见 [onboarding-api.md](onboarding-api.md)。Base URL 与认证方式沿用本文第 1、5 节： +新增接口详见 [enterprise-talent-discovery-api.md](enterprise-talent-discovery-api.md)。学生先通过 `/profile/me/talent-discovery` 显式开启授权；企业仅能查询已认证企业自己的已发布岗位，岗位需具备 V39 审核通过且启用的画像。候选卡只返回不透明 `candidateKey`、匿名标签、城市、学历、毕业年份、白名单技能、匹配档位、固定概述和可用信号类别，不返回学生身份、联系方式、简历或任何测评分数。 + +V41 服务端先对全部合格候选计算并全局排序，再切分页；`fitScore` 不下发。无可用岗位画像返回 `UNAVAILABLE`，无候选返回 `NO_ELIGIBLE_CANDIDATE`。OpenAPI 实际为 161 paths / 199 operations（学生 GET/PUT 共用一个 path）。 + +### V42 企业人才邀约与授权沟通 + +V42 新增 6 个 path / 6 个 operation，静态 OpenAPI 计数为 167 paths / 205 operations。已认证企业只能对本公司 `PUBLISHED` 且画像 `enabled=true && APPROVED` 的岗位使用 V41 `candidateKey` 创建邀约；请求只提交 `candidateKey`、站内 `message`（1–300 字）和 UUID `idempotencyKey`，不得提交学生 ID。服务端会重新校验授权、账号状态、当前企业全部历史投递、有效推荐信号和每日限额。 + +> 验收状态：自动化测试 1475/1475 通过；真实 MySQL/Docker 黑盒通过（`PASS=76 / FAIL=0`），运行时与静态 OpenAPI 均为 167 paths / 205 operations。 + +学生通过 `/profile/me/talent-invitations` 查看邀约，详情中的 `version` 必须原样带入决策请求的 `expectedVersion`。只有 `PENDING` 可 `ACCEPT` 或 `REJECT`；接受成功才返回 `conversationId` 并建立受限 `TALENT_INVITATION` 会话，拒绝或过期不建会话。邀约有效期 7 天，终态后同企业同学生冷却 30 天；重复幂等请求返回原邀约，不重复占用额度。 + +企业响应不包含 `candidateKey`、`studentUserId`、测评/评分详情、联系方式或内部原因；邀约会话的会话、消息列表和发送响应只返回 `CURRENT_USER`/`OTHER_PARTICIPANT` 相对身份，不暴露 `createdBy`/`senderUserId`。V42 不写 `candidate_dimension_scores`，不发送通知。 + +> 验收状态：自动化测试 1461/1461 通过；真实 MySQL/Docker 黑盒已通过（`PASS=37 / FAIL=0`）。黑盒确认最新低分测评优先于历史高分、同企业任一历史投递均排除、其他企业投递不误排，并验证全局排序在分页之前完成。 + +### 24.1 接口 ```text -http://127.0.0.1:8080/api/v1 -Authorization: Bearer +GET /companies/me/job-reviews +GET /companies/me/job-reviews/{reviewId} +POST /companies/me/job-reviews/{reviewId}/reply +PUT /companies/me/job-reviews/{reviewId}/reply +GET /admin/review-replies/pending +POST /admin/review-replies/{replyId}/decision ``` -### 22.1 接口与角色 +企业接口只返回当前登录企业自有岗位评价；身份从 JWT 获取，不传 `companyId`、`studentUserId`。STUDENT/ADMIN 为 `403/2002`，未登录为 `401`，跨企业访问不泄露评价是否存在。 -| Method | Path | 角色 | 关键交互 | -|---|---|---|---| -| `GET` | `/onboarding/companies/{companyId}/checklist` | STUDENT | 返回通用项与企业活动自定义项；无自定义项时回退通用清单。 | -| `PUT` | `/onboarding/companies/{companyId}/checklist/items/{itemId}/completion` | STUDENT | 绝对状态设置完成/未完成；状态变化时使用 `progressVersion`。 | -| `GET` | `/onboarding/companies/{companyId}/knowledge` | STUDENT | 企业基础资料 + 企业知识 + 公开评价摘要。 | -| `GET` | `/onboarding/company/checklist-items` | COMPANY | 查询本企业活动与软删除自定义项。 | -| `POST` | `/onboarding/company/checklist-items` | COMPANY | 创建本企业自定义项，支持 `idempotencyKey`。 | -| `PUT` | `/onboarding/company/checklist-items/{itemId}` | COMPANY | 使用 `version` 乐观锁更新。 | -| `DELETE` | `/onboarding/company/checklist-items/{itemId}?version={version}` | COMPANY | 软删除；重复删除幂等。 | -| `GET` | `/onboarding/company/knowledge` | COMPANY | 查询本企业知识配置；未配置返回 `configured=false`。 | -| `PUT` | `/onboarding/company/knowledge` | COMPANY | 创建或更新本企业知识配置。 | +### 24.2 回复状态与操作 -### 22.2 请求示例 +- 创建回复正文 1–500 字符，`idempotencyKey` 必须为 UUID（最长 64）；安全文本为 `AUTO_APPROVED`，风险文本为 `PENDING`。 +- 同评价最多一个当前回复；同幂等键同评价同正文重放返回原回复，内容不一致为 `409/10106`，已有回复为 `409/10102`。 +- 只有 `REJECTED` 回复可以 PUT 修订，必须携带 `expectedVersion`；`AUTO_APPROVED`、`APPROVED`、`PENDING` 不可覆盖或删除。版本冲突为 `409/10104`。 +- ADMIN 仅可对 `PENDING` 执行 `APPROVE` 或 `REJECT`；驳回时 `reason` 必填（1–500 字符）。重复决策为 `409/10103`，非法决策为 `400/10107`。 -学生更新完成状态： +企业列表/详情的 `reply` 只包含 `id/content/status/version/updatedAt/rejectionReason`。禁止依赖 `studentUserId`、学生姓名、联系方式、IP/UA、`moderationScore`、内部 `reasonCodes` 或管理员 ID。 -```http -PUT /api/v1/onboarding/companies/10/checklist/items/501/completion -Authorization: Bearer -Content-Type: application/json +### 24.3 公开评价与官方回复 -{"completed": true, "version": 0} +既有 `/jobs/{jobId}/reviews` 与 `/jobs/{jobId}/reviews/{reviewId}` 的评价载荷不再包含 `studentUserId`，可显示固定 `reviewerLabel="匿名求职者"`。仅公开评价且回复状态为 `AUTO_APPROVED`/`APPROVED` 时显示： + +```json +{"officialReply":{"content":"感谢反馈。","repliedAt":"2026-09-04T10:05:00"}} ``` -企业创建自定义项： +`officialReply` 不含回复 ID、公司 ID、审核状态、版本、原因码或审核人信息；`PENDING`/`REJECTED` 不渲染该区域。前端应兼容字段缺省或 `null`。 -```http -POST /api/v1/onboarding/company/checklist-items -Authorization: Bearer -Content-Type: application/json +### 24.4 管理员页面 -{ - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "sortOrder": 1000, - "required": false, - "idempotencyKey": "company-10-access-card-20260917" -} -``` +待审列表可按公司、岗位、风险等级和时间筛选；管理员响应中的风险等级/原因码只用于后台审核，不得透传到公开评价。V40 不提供回复通知、统计、申诉或公开历史接口。 -企业更新知识： +### 24.5 错误码 -```http -PUT /api/v1/onboarding/company/knowledge -Authorization: Bearer -Content-Type: application/json +`10101` 回复不存在（404）、`10102` 已有回复（409）、`10103` 状态非法（409）、`10104` 并发冲突（409）、`10105` 正文/幂等键非法（400）、`10106` 幂等冲突（409）、`10107` 决策非法（400）。 -{ - "culture": "以用户价值为中心，保持透明和长期主义。", - "workPolicies": "弹性上班；每周一、三线下办公。", - "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。", - "version": 1 -} -``` +## 24. V39 测评驱动岗位推荐（编码中） -### 22.3 响应与前端状态处理 +- 开关 `RECOMMENDATION_ASSESSMENT_ENABLED` 默认 `false`：关闭时 `GET /profile/me/job-recommendations` 仅返回 `mode=FALLBACK` 的最新公开岗位，不展示伪造的测评匹配分。 +- 开启后按学生偏好 40%、RIASEC 聚合分 35%、四维能力聚合分 25% 做实时规则计算；缺少任一数据源时对可用项重归一化。推荐不读取题目、答案或候选评分快照。 +- 新增公开 `GET /job-recommendation-taxonomies`；企业通过 `GET/PUT /companies/me/jobs/{jobId}/recommendation-profile` 选择平台受控行业/岗位族并填写画像。更新启用画像后状态为 `PENDING_REVIEW`，仅 ADMIN 审核通过的启用画像参与个性化推荐。 +- 学生接口：`GET /profile/me/job-recommendations?page&size`；`POST /profile/me/job-recommendations/{jobId}/feedback`；`DELETE .../feedback?expectedVersion=`。`NOT_INTERESTED` 会持久化排除该岗位；解释反馈不影响首版分数。 +- ADMIN：`GET /admin/job-recommendation-profiles`、`POST /admin/job-recommendation-profiles/{jobId}/decision`。企业端不得取得任何学生分数或推荐理由；学生端不得取得画像权重、测评结果 ID 或题库字段。 -成功响应统一读取 `data`。学生有效清单关键字段： +## 25. V43 候选评分公平性与稳定性监测 + +V43 仅供管理员后台使用，前端不得向学生或企业展示。当前状态为版本内补集定向修复完成、待独立复验；总览和申诉使用最终 SQL 聚合，并统一执行独立候选人数与补集抑制。`drift` 和 `ranking-stability` 在当前没有不可变评分历史与排名快照时返回 `availability=UNAVAILABLE`，页面应显示“暂无可比历史数据”。 + +## 27. N07 消息撤回与会话一致性 + +消息发送者可在发送后两分钟内调用 `POST /conversations/{conversationId}/messages/{messageId}/recall` 撤回本人消息。请求不接收用户 ID；服务端从登录身份、会话成员关系和消息发送者校验归属。窗口边界采用 `capturedNow <= createdAt + 2 minutes`，恰好两分钟仍允许，超过窗口返回 409。非成员、非原发送者、管理员和跨会话访问均按既有 403/2002 语义处理。 + +成功撤回后，消息状态为 `RECALLED`，正文统一显示“消息已撤回”，并保留原时间线位置；响应、消息列表、发送响应和审计均不再返回原正文。重复撤回幂等返回当前撤回状态，不重复写审计。撤回消息不计入未读数，`markRead` 不为撤回消息新增已读记录。`DIRECT` 会话保持既有 `senderUserId` 语义，`TALENT_INVITATION` 会话继续只返回 `CURRENT_USER`/`OTHER_PARTICIPANT` 相对身份。完整接口契约见 [messaging-api.md](messaging-api.md)。 + +## 26. N02 候选评分规则解释与合理性 + +学生评分卡和单维详情在保持原有路径不变的前提下增加固定解释字段。综合卡新增 `explanationVersion=candidate-scoring-explanation-v1`、`coverage`（实际参与 overallScore 的维度及排除原因）和 `comparabilityNotice`；单维详情新增中性 `displayName`、`whatItMeasures`、`interpretation`、`limitations`、`evidenceLevel`、`ruleContributions`、`improvementActions`、`explanationVersion`、`validity`（仅 ABILITY）和 `calculatedAt`。 + +`ruleContributions` 与真实评分分支同源，贡献之和可对账最终维度分数；固定模板不使用 AI/LLM/SHAP。`dataSources` 只显示“个人教育资料”“求职偏好”“平台求职活动”“简历与技能资料”“Offer 履约与候选反馈”“四维能力测评”等产品语义名称，不展示表名、字段路径、题目、答案、答案键或评分规则。`INTEGRITY`、`GROWTH`、`STABILITY`、`COMPLIANCE`、`ACTIVITY` 等信号均明确为平台资料/行为代理，不代表人格、信用、成长潜力、服从性、工作积极性或录用结论。 + +企业评分接口 `/company/candidates/{applicationId}/scoring` 的字段和 JSON 结构保持不变，企业不返回任何解释字段、行为细分、规则贡献、改进建议或 ABILITY 四维详情。N02 不新增 Flyway、表、ErrorCode、公网路径、消息或审计动作，也不改变分数、权重、排名、推荐、申诉和快照写入语义。 + +可用接口、参数和小样本规则见 [candidate-scoring-fairness-api.md](candidate-scoring-fairness-api.md)。前端不得根据城市、学校、姓名等字段创建敏感人群筛选，也不得尝试通过多次小样本查询反推出候选人。 + +总览、维度和申诉响应都显式返回 `availability/reason`。状态/版本/回滚原因及分布桶均按独立候选人数计算；`appealCount` 仅表示事件数。`SUPPRESSED` 时不得用总体计数、补集或其它接口字段反推出被隐藏比例，`NO_DATA`、`INSUFFICIENT_SAMPLE`、`SUPPRESSED` 均不得渲染为 `NORMAL`。 + +## 13. 企业下载候选人简历（S03） -```json -{ - "companyId": 10, - "companyName": "示例科技", - "customized": true, - "totalItems": 13, - "completedItems": 1, - "completionRate": 7.7, - "items": [ - { - "itemId": 101, - "source": "STANDARD", - "title": "准备身份证件", - "category": "DOCUMENT", - "required": true, - "sortOrder": 100, - "completed": true, - "completedAt": "2026-09-17T09:00:00", - "progressVersion": 1 - } - ] -} +``` +GET /api/v1/company/candidates/{applicationId}/resume +Authorization: Bearer ``` -公司知识回退： +响应是**文件流**（不是 JSON 包装），前端应按二进制处理： -- `knowledgeState=CONFIGURED`：展示 `knowledge`。 -- `knowledgeState=BASIC_ONLY`：只展示 `company` 基础资料，不展示知识字段。 -- `reviewSummary.state=EMPTY/INSUFFICIENT`：只展示评价数量；不要展示均值、分布和八维汇总。 -- `reviewSummary.state=SUFFICIENT`：可以展示平均分、评分分布、热门标签和八维汇总。 +- 成功：`200` + `Content-Type`（PDF/DOC/DOCX）+ `Content-Disposition: attachment; filename*=UTF-8''…` + + `Cache-Control: no-store` +- `401` 未登录或会话失效 +- `403` 非 COMPANY 角色、无企业资料、跨企业投递，或候选人隐私设置不允许 +- `404` 投递不存在（`APPLICATION_NOT_FOUND`）或学生没有简历（`PROFILE_NOT_FOUND`） -错误处理： +前端注意事项： -| HTTP/code | 前端动作 | -|---|---| -| `401/401` | 清理 Token，跳转登录；不要自动重试。 | -| `403/2002` | 当前角色或企业不匹配，不重试并提示切换正确账号。 | -| `404/5001` | 企业不存在或企业账号未绑定企业，停止当前页面数据加载。 | -| `404/9701` | 条目已删除、跨企业或已不在有效清单；重新加载清单。 | -| `409/9702` | 企业条目版本过期；重新查询 `/company/checklist-items` 后让用户确认再提交。 | -| `409/9703` | 活动自定义项达到 50 条；禁用新增，提示先软删除旧项。 | -| `409/9704` | 幂等键已用于不同请求体；更换 key 或展示原条目，不可盲目重试旧请求。 | -| `409/9705` | 学生进度版本过期；重新查询有效清单，使用最新 `progressVersion`。 | -| `409/9706` | 企业知识版本过期；重新查询配置，使用最新 `version`。 | - -幂等与软删除注意： - -- 创建重试必须复用原 `idempotencyKey` 和完全相同的标题、说明、分类、排序、必填标记。 -- DELETE 只在首次删除时要求当前版本；重复删除虽幂等，但客户端仍应携带 `version` 查询参数。 -- 更新/删除成功后必须用响应中的新 `version` 覆盖本地状态，不能继续使用旧值。 - -## 薪资计算器（N05） - -- 接口文档：[salary-calculator-api.md](salary-calculator-api.md) -- 全部接口要求登录且当前用户具有 `STUDENT` 角色。 -- 前端切换城市后必须重新调用城市详情，清空上一城市的覆盖项，并在计算请求中携带当前 `policyVersion`。 -- `dataLevel=PROVINCE_FALLBACK` 必须展示为“省级回退估算”，不能显示成城市级官方精确值。 -- `POST /salary-calculator/calculations` 成功即自动生成历史；网络重试应复用 `idempotencyKey`。 -- 收到 `409/9805` 时读取响应中的最新政策版本和生效日期，重新加载城市参数后再试算。 -- 历史列表使用 `page=0`、`size=20`，`size` 最大 100；详情返回完整输入、政策和结果快照。 -- 删除历史为物理删除；删除后前端应从列表移除该记录。 +1. **不要**从候选人列表/详情里找 `resumeUrl` —— 这些 DTO 有意不含该字段； + 下载必须走上面这个接口。 +2. 403 与 404 都按「不可下载」处理，**不要**在 UI 上区分「隐私拒绝」与「跨企业」， + 避免泄露归属信息。 +3. 下载链接不要放进 URL 或日志；如需预览，请用同一 Authorization 头请求。 +4. 响应已声明 `no-store`，前端不要再把简历文件写入本地持久缓存。 diff --git a/docs/message-recall-design.md b/docs/message-recall-design.md new file mode 100644 index 0000000..58588d0 --- /dev/null +++ b/docs/message-recall-design.md @@ -0,0 +1,368 @@ +# N07 消息撤回与会话一致性：详细设计 + +状态：N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收。 + +文档类型：解释与技术参考。目标读者为产品负责人、后端开发、前端联调和独立验收人员。 + +## 1. 目标 + +N07 为现有站内会话增加有限、可审计、并发安全的消息撤回能力。发送者可在发送后两分钟内撤回自己的消息；会话成员继续看到一条撤回占位记录，但不能再通过列表、详情、缓存或审计取得原正文。 + +本版同时统一消息响应的白名单映射，保证 `DIRECT` 会话保持既有身份字段语义，`TALENT_INVITATION` 会话继续使用相对身份标识，不重新暴露学生内部 ID。 + +## 2. 当前实现事实 + +- 消息表由 `V9__messaging.sql` 创建，并由 N07 的 `V41__message_recall.sql` 增加 `status`、`recalled_at` 和 `version`。 +- `Message` 实体使用字符串状态、撤回时间和 JPA `@Version`；撤回通过条件更新保证并发安全。 +- `MessagingService` 的既有 Map 响应和 N07 撤回响应均委托给统一的 `MessageViewMapper`，不直接返回实体。 +- `DIRECT` 消息当前返回 `senderUserId`；这是既有兼容语义。 +- `TALENT_INVITATION` 消息返回 `senderScope=CURRENT_USER/OTHER_PARTICIPANT`，不返回另一方用户 ID。 +- 当前没有附件、引用消息、消息编辑、WebSocket 推送或消息撤回。 +- 未读数当前基于最近 500 条消息与 `message_reads` 计算。 +- 最新主线迁移为 V40；并行工作存在迁移号冲突风险。 + +## 3. 范围 + +### 3.1 本版包含 + +- 发送者撤回本人发送的消息； +- `DIRECT` 与 `TALENT_INVITATION` 两种会话； +- 两分钟撤回窗口； +- 重复撤回幂等； +- 数据库条件更新与乐观锁； +- 固定撤回占位文本； +- 撤回消息不计入未读数； +- 白名单消息响应 DTO； +- 一条脱敏安全审计； +- 自动化、OpenAPI、联调文档和真实 MySQL 黑盒验收。 + +### 3.2 本版不包含 + +- 消息编辑、删除、批量撤回； +- 管理员代撤回； +- 撤回恢复； +- 附件和引用消息； +- WebSocket、SSE 或 RabbitMQ 撤回通知； +- 离线推送、短信或邮件； +- 保存或公开原正文历史； +- 内容审核、AI 摘要或聊天风控扩展； +- 改变 DIRECT 会话创建的 MATCHED 守卫； +- 改变 V42 邀约接受后建会话的语义。 + +## 4. 产品规则 + +### 4.1 时间窗口 + +撤回截止时间为： + +```text +recallDeadline = message.createdAt + 2 minutes +``` + +当 `capturedNow <= recallDeadline` 时允许撤回；当 `capturedNow > recallDeadline` 时返回冲突。一次请求只捕获一次 `capturedNow`，所有判断和 `recalledAt` 均使用该时间。 + +### 4.2 权限 + +- 请求者必须已登录； +- 请求者必须是会话成员； +- 消息必须属于路径中的会话； +- 只有 `senderUserId` 对应的原发送者可以撤回； +- 其他成员、ADMIN 以及不属于该会话的用户均返回既有 `403/2002`； +- 不通过不同错误暴露某条消息是否属于其他会话。 + +### 4.3 状态机 + +```text +SENT -> RECALLED +``` + +- `SENT` 可以在窗口内转为 `RECALLED`； +- `RECALLED` 再次撤回返回同一当前结果，HTTP 200，不重复更新、不重复审计； +- 窗口外的 `SENT` 返回 409； +- 没有其他状态迁移。 + +## 5. 数据库方案 + +编码前从实际主线确定下一可用 Flyway 版本，文件说明建议为： + +```text +V__message_recall.sql +``` + +不得预先假定 V41 未被其他分支占用，也不得修改 V1–V40。 + +在 `messages` 增加： + +| 字段 | 类型 | 约束 | 说明 | +|---|---|---|---| +| status | VARCHAR(20) | NOT NULL DEFAULT 'SENT' | `SENT` 或 `RECALLED` | +| recalled_at | DATETIME | NULL | 实际撤回时间 | +| version | BIGINT | NOT NULL DEFAULT 0 | JPA `@Version` | + +约束建议： + +```sql +CHECK (status IN ('SENT','RECALLED')) +``` + +现有 `conversation_id, created_at` 索引继续用于分页。本版不新增撤回历史表，不保存原正文副本，不新增包含正文的审计表。 + +迁移必须同时通过 H2 `MODE=MySQL` 与真实 MySQL 8.x，并保持 `ddl-auto=validate`。 + +## 6. 正文与数据保留 + +撤回成功时，将 `content` 覆盖为固定内部占位值： + +```text +消息已撤回 +``` + +响应层也只返回这一固定文本。原正文不得写入： + +- audit_logs； +- 应用日志； +-异常消息； +- history 表； +- RabbitMQ； +-缓存或导出结果。 + +数据库备份和存储层面的物理恢复策略属于 G02，不在 N07 内建立正文恢复接口。 + +## 7. HTTP 接口 + +新增一个接口： + +```http +POST /conversations/{conversationId}/messages/{messageId}/recall +``` + +无请求体。身份仅从 JWT/SecurityContext 获取。 + +成功响应使用白名单 `MessageResponse`： + +```json +{ + "code": 200, + "data": { + "id": 81, + "conversationId": 12, + "senderUserId": 7, + "content": "消息已撤回", + "status": "RECALLED", + "recalledAt": "2026-09-10T10:01:30", + "createdAt": "2026-09-10T10:00:00", + "isRead": false + } +} +``` + +对于 `TALENT_INVITATION`，响应使用 `senderScope`，不得返回 `senderUserId`。 + +### 7.1 错误语义 + +| 场景 | HTTP / 业务码 | +|---|---| +| 未登录 | 401 / 既有未认证码 | +| 非成员、非发送者、跨会话探测、ADMIN | 403 / 2002 | +| 会话不存在 | 404 / 既有会话不存在码 | +| 当前会话内消息不存在 | 404 / 新增消息不存在码或经评审复用现有码 | +| 超过撤回窗口 | 409 / 新增撤回窗口错误码 | +| 并发状态冲突 | 409 / 新增并发冲突错误码 | + +ErrorCode 属于高冲突文件。编码前应先核对现有码值，并只新增确有必要的错误码。 + +## 8. 响应 DTO 与兼容 + +新增白名单 DTO，建议： + +- `MessageResponse`； +- 如分页结构尚无类型，可新增 `MessagePageResponse`。 + +允许字段： + +- id； +- conversationId； +- senderUserId，仅 DIRECT； +- senderScope，仅 TALENT_INVITATION； +- content； +- status； +- recalledAt； +- createdAt； +- isRead。 + +禁止字段： + +- 对方在 TALENT_INVITATION 中的 userId； +- 手机号、邮箱、姓名、简历； +- 邀约 candidateKey 或摘要； +- 原撤回正文； +- IP、User-Agent、Token、密码； +- 内部审计内容。 + +现有发送与列表接口兼容新增 `status` 和可空 `recalledAt`。DIRECT 的 `senderUserId` 不删除；TALENT_INVITATION 继续只提供相对身份。 + +## 9. 服务与事务 + +建议新增： + +```java +MessageResponse recallMessage( + Long currentUserId, + Long conversationId, + Long messageId, + LocalDateTime capturedNow, + AuditContext auditContext) +``` + +事务步骤： + +1. 查询会话并校验成员； +2. 查询消息，校验其属于当前会话； +3. 校验请求者为发送者； +4. 若已撤回，返回当前白名单响应； +5. 校验两分钟窗口； +6. 使用 `id + conversationId + senderUserId + status=SENT + version` 条件更新； +7. 更新 `status=RECALLED`、固定占位正文、`recalledAt=capturedNow`； +8. 条件更新成功后写一条审计； +9. 返回重新读取或由确定字段构造的响应。 + +只有成功发生 `SENT -> RECALLED` 的请求写审计。幂等重放和失败请求不重复写成功审计。 + +## 10. 并发与幂等 + +- `Message.version` 使用 JPA `@Version`； +- Repository 提供条件更新，不能只依赖“先查后改”； +- 两个并发撤回请求只能一个执行状态变更并写审计； +- 另一请求重新读取后若状态已为 `RECALLED`，按幂等成功返回； +- 撤回与列表读取允许并发，读取结果只能是完整 `SENT` 或完整 `RECALLED`，不能返回已撤回状态配原正文； +- SQL异常和锁异常不得转为空成功。 + +## 11. 未读与列表 + +- `RECALLED` 消息保留在消息分页中，维持时间线位置； +- 撤回占位消息的 `isRead` 可以保留既有记录语义； +- `RECALLED` 消息不计入 unreadCount； +- 不删除已有 `message_reads`； +- `markRead` 不需要为撤回消息新增 read 记录； +- 列表、发送响应、撤回响应必须共用同一消息映射器。 + +现有 `countUnread` 与 `markRead` 存在最多读取 500 条的历史限制。N07 只修正撤回消息口径，不借机重写整个未读架构；容量治理记录到 G03。 + +## 12. 审计 + +成功状态变更写： + +```text +MESSAGE_RECALLED +``` + +details 白名单： + +```json +{ + "messageId": 81, + "conversationId": 12, + "conversationType": "DIRECT", + "status": "RECALLED", + "requestId": "..." +} +``` + +禁止写入正文、对方用户 ID、手机号、邮箱、简历、IP/UA 明文、Token、密码或邀约标识。 + +## 13. 性能与查询 + +- 消息分页不得因撤回字段产生逐消息额外查询； +- 会话类型只读取一次，不能逐消息查询 Conversation； +- 已读状态继续批量查询，禁止逐消息 `existsBy...`； +- unreadCount 应通过数据库计数或固定批量查询实现，排除 `RECALLED`； +- 查询次数不得随消息数量线性增长； +- 为真实 MySQL EXPLAIN 保留消息分页和未读计数 SQL。 + +## 14. OpenAPI 影响 + +当前基线为 172 paths / 210 operations。若仅新增一个撤回接口，预计为： + +```text +173 paths / 211 operations +``` + +实际计数以静态 OpenAPI、运行时 `/api/v1/v3/api-docs` 和校验脚本为准。 + +OpenAPI 必须断言： + +- 仅新增一个 N07 path/operation； +- 撤回接口 200 响应有非空 schema； +- DIRECT 与邀约消息隐私契约明确； +- 响应不包含原正文历史或用户隐私字段； +- 既有 6 个消息 operations 保持存在。 + +## 15. 测试与验收 + +### 15.1 单元与服务测试 + +- 发送后 0 秒、1:59、恰好 2:00 可撤回； +- 2:00:00 后最小时间单位不可撤回； +- 非发送者、非成员、ADMIN 拒绝； +- 消息和路径会话不一致返回 403，避免枚举； +- 重复撤回幂等； +- 并发撤回仅一次更新和一次审计； +- 固定 Clock，全请求只捕获一次； +- 审计白名单不含正文。 + +### 15.2 HTTP 与隐私测试 + +- DIRECT 发送、列表和撤回保持 senderUserId； +- TALENT_INVITATION 仅返回 senderScope； +- 已撤回消息所有接口只返回占位内容； +- 完整 JSON 不含原正文、对方 ID、联系方式或凭据； +- 未登录 401、越权 403/2002。 + +### 15.3 持久化与 MySQL + +- 迁移在 H2 MySQL 模式和 MySQL 8.x 执行； +- `CHECK`、默认状态和 `@Version` 正确； +- 撤回后数据库正文为固定占位； +- 并发条件更新正确； +- `ddl-auto=validate` 通过； +- 消息分页和未读 SQL EXPLAIN 无发布阻断。 + +### 15.4 回归 + +- DIRECT MATCHED 守卫不变； +- V33 屏蔽发送规则不变； +- V42 邀约接受、会话隐私和唯一会话不变； +- 消息发送、列表、已读原有功能通过； +- 不写 candidate_dimension_scores； +- 不发送新增 RabbitMQ 消息。 + +## 16. 风险 + +- 并行分支可能占用迁移号，编码前必须重新确认； +- Map 响应迁移为 DTO 时容易意外删除旧字段，必须做兼容 JSON 对照； +- 撤回与列表并发可能暴露状态和正文不一致，必须原子更新并统一映射； +- 当前未读实现有 500 条上限，不能将其误称为完整历史未读统计； +- 数据库备份可能保留历史物理页，本功能只保证业务接口、当前数据库值、日志和审计不暴露原正文。 + +## 17. 已确认决策 + +| 决策 | 结论 | +|---|---| +| D01 | 撤回窗口为发送后 2 分钟 | +| D02 | `capturedNow <= deadline` 允许撤回 | +| D03 | DIRECT 与 TALENT_INVITATION 均支持 | +| D04 | 仅原发送者可撤回 | +| D05 | 使用 conversationId 与 messageId 的 POST 撤回接口 | +| D06 | 重复撤回幂等返回 200 | +| D07 | 保留固定撤回占位消息 | +| D08 | 数据库正文覆盖为固定占位，不保存原正文历史 | +| D09 | 撤回消息不计入 unreadCount，不删除已有 read 记录 | +| D10 | messages 增加 status、recalled_at、version，无历史表 | +| D11 | @Version 与条件更新共同保证并发 | +| D12 | 仅成功转换写 MESSAGE_RECALLED 脱敏审计 | +| D13 | 一期不新增实时推送或 RabbitMQ 事件 | +| D14 | 附件与引用消息不在本版范围 | +| D15 | 使用白名单 DTO，保持两种会话的既有身份语义 | +| D16 | 401/403/404/409 按认证、归属、存在性和状态区分 | +| D17 | 预计新增 1 path / 1 operation | +| D18 | Flyway 版本在编码前按实际主线分配 | diff --git a/docs/message-recall-implementation-instruction.md b/docs/message-recall-implementation-instruction.md new file mode 100644 index 0000000..7915d34 --- /dev/null +++ b/docs/message-recall-implementation-instruction.md @@ -0,0 +1,293 @@ +# N07 消息撤回：实施指令 + +状态：N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收。 + +文档类型：操作指南。用于指导实现者在不扩大范围的前提下完成 N07。 + +## 1. 开始前 + +项目根目录： + +```text +C:\Users\15642\Desktop\zhilai +``` + +先完整阅读： + +- `docs/message-recall-design.md`； +- `docs/frontend-integration.md`； +- `docs/enterprise-talent-invitation-api.md`； +- `docs/report-block-api.md`； +- `docs/phase1-scope-and-acceptance.md`。 + +重点代码： + +- `messaging/Message.java`； +- `messaging/MessageRepository.java`； +- `messaging/MessagingService.java`； +- `messaging/MessagingController.java`； +- `messaging/Conversation.java`； +- `messaging/ConversationMemberRepository.java`； +- `talentinvitation/`； +- `safety/BlockRelationRepository.java`； +- `audit/SecurityAuditService.java`； +- `config/SecurityConfig.java`； +- `common/exception/ErrorCode.java`； +- `common/exception/GlobalExceptionHandler.java`。 + +先执行： + +```powershell +git status --short +git diff --cached --name-only +git log -5 --oneline +git diff --check +``` + +如果暂存区非空，停止并报告。保护所有历史未跟踪文件，不得 reset、restore、checkout、clean 或 `git add -A`。 + +## 2. 迁移号分配 + +编码前列出迁移： + +```powershell +Get-ChildItem mydreamjob-server/src/main/resources/db/migration -File | + Sort-Object Name | + Select-Object -ExpandProperty Name +``` + +同时检查其他待合并分支是否已经占用下一版本。只有负责人确认后才创建： + +```text +V__message_recall.sql +``` + +禁止修改 V1–V40，禁止擅自假定 V41 可用。 + +迁移只允许为 `messages` 增加： + +- `status VARCHAR(20) NOT NULL DEFAULT 'SENT'`； +- `recalled_at DATETIME NULL`； +- `version BIGINT NOT NULL DEFAULT 0`； +- `status` 的受控 CHECK。 + +不新增历史表，不保存正文副本。 + +## 3. 实体与 Repository + +修改 `Message`： + +- 新增字符串状态或受控枚举； +- 新增 `recalledAt`； +- 新增 `@Version Long version`； +- 发送创建状态固定为 `SENT`。 + +Repository 增加条件更新，条件至少包括： + +- messageId； +- conversationId； +- senderUserId； +- status=`SENT`； +- expectedVersion。 + +更新内容： + +- status=`RECALLED`； +- content=`消息已撤回`； +- recalledAt=capturedNow； +- version 原子递增。 + +不得只用 `findById -> set -> save` 作为并发保证。 + +消息分页和未读查询要排除撤回消息的未读贡献，并采用批量查询，禁止逐消息查 Conversation 或 read 状态。 + +## 4. DTO 与映射 + +在 `messaging/dto/` 新增白名单 DTO： + +- `MessageResponse`； +- 必要时新增 `MessagePageResponse`。 + +把发送、列表、撤回响应收敛到同一个映射器。 + +DIRECT 兼容保留 `senderUserId`；TALENT_INVITATION 只返回 `senderScope`。撤回状态下任何路径都只能返回固定占位正文。 + +不得直接返回 Message Entity，不得继续在 Controller 拼 Map。 + +## 5. 服务实现 + +为 `MessagingService` 注入 `Clock`，生产默认系统时区。撤回入口只捕获一次 `capturedNow`。 + +实现顺序： + +1. requireConversation； +2. assertMember； +3. 查询消息并防止跨会话枚举； +4. 校验发送者； +5. 已撤回则幂等返回； +6. 校验 `capturedNow <= createdAt.plusMinutes(2)`； +7. 执行条件更新； +8. 失败时重新读取并区分幂等完成与真实冲突； +9. 成功后写一次脱敏审计； +10. 返回白名单响应。 + +不得把原正文写入日志、异常或审计。 + +## 6. Controller 与接口 + +新增： + +```http +POST /conversations/{conversationId}/messages/{messageId}/recall +``` + +无 requestBody，不接收 userId。身份从 SecurityContext/JWT subject 获取。 + +Controller 只做参数接收、身份解析和响应包装，不包含撤回规则。 + +## 7. ErrorCode + +先搜索现有消息错误码。只在没有可准确复用的代码时新增： + +- MESSAGE_NOT_FOUND； +- MESSAGE_RECALL_WINDOW_EXPIRED； +- MESSAGE_RECALL_CONCURRENT_UPDATE。 + +保持： + +- 未登录 401； +- 非成员、非发送者和跨会话探测 403/2002； +- 超时和并发冲突 409。 + +不得改变已有错误码含义。ErrorCode 和 GlobalExceptionHandler 修改前应与集成负责人确认。 + +## 8. 审计 + +成功状态转换写一条 `MESSAGE_RECALLED`。 + +details 只允许： + +- messageId； +- conversationId； +- conversationType； +- status； +- requestId。 + +幂等重放、超时、越权和并发失败不写成功审计。禁止记录正文、对方 ID、联系方式、IP/UA 明文或凭据。 + +## 9. 必须新增的测试 + +建议测试类： + +- `MessageRecallServiceTest`； +- `MessageRecallControllerTest`； +- `MessageRecallPersistenceIntegrationTest`； +- `MessageRecallPrivacyIntegrationTest`。 + +必须覆盖： + +1. 窗口内撤回； +2. 1:59 与恰好 2:00 成功； +3. 超过 2:00 的最小时间单位失败； +4. 重复撤回 HTTP 200 且不重复审计； +5. 非发送者、非成员、ADMIN、匿名； +6. messageId 属于另一 conversationId 时 403/2002； +7. 两个并发请求只有一次条件更新和审计； +8. 撤回后数据库正文为固定占位； +9. 列表、撤回响应均不返回原正文； +10. DIRECT 保留 senderUserId； +11. TALENT_INVITATION 不返回 senderUserId、createdBy 或学生 ID； +12. 撤回消息不计 unreadCount； +13. 已有 message_reads 不删除； +14. markRead 不为撤回消息产生新记录； +15. 消息分页无逐消息查询； +16. 审计 details 白名单； +17. V33 屏蔽发送回归； +18. V42 邀约会话隐私回归； +19. DIRECT MATCHED 守卫回归； +20. `candidate_dimension_scores` 不变。 + +完整 JSON 禁止出现： + +```text +originalContent +previousContent +studentUserId +candidateId +phone +email +resumeUrl +candidateKey +candidateKeyDigest +ipAddress +userAgent +password +token +secret +``` + +## 10. OpenAPI 与文档 + +更新： + +- `docs/messaging-api.md`，不存在则新增； +- `docs/frontend-integration.md`； +- `docs/backend-development-roadmap.md`； +- `docs/phase1-scope-and-acceptance.md`； +- `docs/openapi-rc.json`； +- `docs/verify_openapi.py`； +- 本设计和实施指令状态。 + +目标预计为 173 paths / 211 operations，以实际静态和运行时结果为准。 + +校验脚本必须递归检查消息响应 schema，不得只检查计数。 + +## 11. 自动化验证 + +依次执行： + +```powershell +cd C:\Users\15642\Desktop\zhilai\mydreamjob-server +mvn -Dtest="*MessageRecall*Test,*Messaging*Test,*TalentInvitation*Test" test +mvn test +mvn clean verify +python ..\docs\verify_openapi.py +git diff --check +``` + +记录真实 Tests run、Failures、Errors、Skipped 和 OpenAPI 计数。禁止删除测试或修改期望语义掩盖回归。 + +## 12. 真实 MySQL/Docker 验收 + +自动化完成后由负责人授权执行： + +- Flyway 新迁移 success=1； +- `ddl-auto=validate` 通过； +- 窗口边界与并发撤回； +- 重复撤回只一条审计； +- 数据库正文不可恢复为业务明文； +- 权限矩阵； +- DIRECT 与邀约完整 JSON 脱敏； +- unreadCount 与 read 记录； +- 消息分页和未读 SQL EXPLAIN； +- RabbitMQ 无新增消息； +- 运行时 OpenAPI 与静态文件一致。 + +未执行真库验收不得标记冻结。 + +## 13. Git 边界 + +本轮实现期间： + +- 不操作 Docker，除非负责人明确要求黑盒； +- 不暂存验收脚本、日志、请求体或 `.env`； +- 不执行 `git add -A`； +- 不提交、不推送，直到独立验收完成； +- 不删除历史未跟踪文件； +- 不进入 N08。 + +完成代码和自动化后，状态只能写为： + +```text +N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收。 +``` diff --git a/docs/messaging-api.md b/docs/messaging-api.md new file mode 100644 index 0000000..7bae755 --- /dev/null +++ b/docs/messaging-api.md @@ -0,0 +1,33 @@ +# 站内消息接口 + +## 消息撤回 + +`POST /conversations/{conversationId}/messages/{messageId}/recall` + +当前登录用户从 JWT subject 解析。请求无 body，只有会话成员中的原发送者可在消息创建后两分钟内撤回；截止瞬间仍允许撤回。会话不存在返回 404/8305，跨会话、非成员或非发送者返回 403/2002，窗口结束返回 409/8307，并发状态冲突返回 409/8308。 + +成功响应为白名单 `MessageResponse`： + +```json +{ + "code": 200, + "data": { + "id": 81, + "conversationId": 12, + "senderUserId": 7, + "content": "消息已撤回", + "status": "RECALLED", + "recalledAt": "2026-09-10T10:02:00", + "createdAt": "2026-09-10T10:00:00", + "isRead": false + } +} +``` + +撤回会在同一事务中将数据库正文覆盖为固定占位文本 `消息已撤回`，并将状态从 `SENT` 更新为 `RECALLED`。重复请求幂等返回当前撤回结果，不重复写成功审计。原正文不写入审计、异常、缓存、消息队列或历史表。 + +`TALENT_INVITATION` 会话继续使用 `senderScope=CURRENT_USER` 或 `OTHER_PARTICIPANT`，不返回对方的 `senderUserId`；`DIRECT` 会话保留既有 `senderUserId` 兼容字段。撤回消息仍保留在时间线中，但不计入未读数，也不会因标记已读新增 `message_reads`。 + +## 既有消息接口兼容 + +原有会话列表、会话详情、发送消息、消息列表和标记已读接口路径不变。消息列表和发送响应增加 `status`，撤回消息的 `content` 统一为占位文本，其他既有字段语义保持不变。 diff --git a/docs/n07-independent-mysql-acceptance-20260910.md b/docs/n07-independent-mysql-acceptance-20260910.md new file mode 100644 index 0000000..10069f0 --- /dev/null +++ b/docs/n07-independent-mysql-acceptance-20260910.md @@ -0,0 +1,87 @@ +# N07 消息撤回与会话一致性：独立代码复验与真实 MySQL/Docker 验收 + +日期：2026-09-10 +分支：`feat/message-recall` +结论：**PASS（真实 MySQL/Docker 黑盒已完成；可进入精确暂存检查点）** + +## 1. Git 基线与边界 + +- 当前分支：`feat/message-recall`。 +- HEAD：`dbd27e6 feat: enhance candidate scoring explanations`。 +- 验收开始及结束时暂存区均为空；既有 N07 修改、历史脚本、日志、JSON、SQL、xlsx 和 `.env` 均保留。 +- `git diff --check`：通过；迁移目录没有 V1–V40 修改。 +- N07 唯一新增迁移：`V41__message_recall.sql`。 +- 未执行 `git add -A`、commit、push、reset、restore、checkout、clean；未删除或移动历史文件。 + +## 2. 自动化独立复验 + +| 命令 | Tests run | Failures | Errors | Skipped | 结果 | +|---|---:|---:|---:|---:|---| +| N07 定向测试 | 30 | 0 | 0 | 0 | BUILD SUCCESS | +| 消息与邀约关联回归 | 80 | 0 | 0 | 0 | BUILD SUCCESS | +| `mvn clean verify` | 1601 | 0 | 0 | 0 | BUILD SUCCESS | + +`python docs\\verify_openapi.py` 通过，静态 OpenAPI 为 173 paths / 211 operations。 + +## 3. 代码审查 + +- 状态机：PASS。V41 CHECK 仅允许 SENT/RECALLED；条件更新包含 messageId、conversationId、senderUserId、SENT、expectedVersion；正文固定占位、recalledAt 非空、version 仅递增一次；重复撤回幂等且不重复成功审计。 +- 权限与归属：PASS。真实 HTTP 中原发送者成功，另一成员/非成员/ADMIN/跨会话为 403/2002，匿名为 401，会话/消息不存在分别为 404/8305、404/8306，超时为 409/8307。 +- 并发与事务：PASS。H2 独立事务测试以及真实 HTTP 两个并发请求均无 500；同消息最终 version=1、恰好一条成功审计；不同消息并发各自成功。 +- 依赖注入：PASS。生产目录不存在 `messageViewMapper == null`、`objectMapper == null`、`new MessageViewMapper()`、`new ObjectMapper()` 兜底。 +- 审计隐私：PASS。真实 MySQL `MESSAGE_RECALLED` 行 `ip_address`/`user_agent` 均为 NULL，details 为合法 JSON 且字段严格为 `messageId,conversationId,conversationType,status,requestId`。 +- DTO/查询结构：PASS。撤回及分页路径使用白名单 DTO；会话与成员固定查询、消息分页固定查询、message_reads 一次批量查询，无逐消息 exists/find。 +- 副作用：PASS。目标消息仅发生 SENT→RECALLED、占位正文、recalledAt、version+1；message_reads、conversation_members、candidate_dimension_scores、notifications、风险表内容和 version 均未改变。 + +## 4. Docker、MySQL、Flyway 与启动 + +- Docker Engine：Server 29.6.2；MySQL 8.4.11、Redis 7.4、RabbitMQ 3.13 容器均 healthy。未重建、删除容器或 volume。 +- 真实 Flyway 查询：最新三条为 V41 `message recall` success=1、V40 `enterprise talent invitations` success=1、V39 `enterprise talent discovery` success=1；无失败迁移、无 N07 之外迁移。 +- `SHOW CREATE TABLE messages`：`status` 默认 SENT、`recalled_at` 可空、`version` 默认 0，CHECK 仅允许 SENT/RECALLED，既有外键与 `idx_messages_conversation_created` 保留；无消息历史表。 +- 使用 `mvn clean verify` 生成的 JAR、dev 配置并保持 `ddl-auto=validate` 启动，日志出现 `Started MyDreamjobApplication`，无 Flyway/schema-validation 错误。 +- `GET /api/v1/health`：HTTP 200，status=UP。 +- 本轮启动的应用 PID 4412（后续边界复验重启为 PID 21168）均在验收结束后正常停止；8080 已恢复空闲。Docker 未停止。 + +## 5. 真实 HTTP 主链路与权限 + +- DIRECT：真实发送、列表、撤回、重复撤回全部 200；撤回后 status=RECALLED、正文为固定占位、recalledAt 非空、version 0→1，重复请求不再增加 version 或审计；senderUserId 按既有语义保留。 +- TALENT_INVITATION：真实发送、撤回、列表全部 200；仅返回 senderScope，不返回 senderUserId、学生 ID或 candidateKey；会话详情和会话列表中的 TALENT_INVITATION 项不返回 createdBy；撤回后正文为固定占位。 +- 权限配对结果：原发送者 `200/200`；另一成员 `403/2002`；非成员 `403/2002`；ADMIN `403/2002`；匿名 `401/401`；跨会话 `403/2002`；不存在会话 `404/8305`；不存在消息 `404/8306`；超时 `409/8307`。 +- 递归 JSON 脱敏：DIRECT 撤回/列表、TALENT_INVITATION 撤回/列表及会话详情中的 TALENT_INVITATION 项均未发现原正文、senderUserId（TALENT）、studentUserId、candidateKey、联系方式、IP/UA、凭据等禁止字段。 + +## 6. 并发、时间与 message_reads + +- 真实 MySQL HTTP 并发：同一消息两请求均 200，最终 version=1、单条审计；两条不同消息并发均 200、各 version=1、各一条审计。 +- 时间：H2 正式测试覆盖 0 秒、1:59、恰好 2:00 成功及超过 2:00 最小单位失败；真实 MySQL HTTP 119 秒返回 200/200、120 秒返回 409/8307（数据库状态分别为 RECALLED/SENT），创建后立即撤回也成功。边界表达式保持 `capturedNow <= createdAt.plusMinutes(2)`。 +- 已有 `message_reads` 行在撤回后仍存在（精确查询=1）；撤回消息不计入 unreadCount（精确查询=0），消息仍保留时间线，未新增第二条 read 行。 + +## 7. 查询预算与 EXPLAIN + +- 使用真实 MySQL `performance_schema.events_statements_summary_by_digest` 测量正式 HTTP 列表路径，夹具规模 1、20、50 条消息：每次均为 `messages=2、message_reads=1、conversations=1、conversation_members=1`，查询数不随消息量线性增长。 +- 真实 EXPLAIN FORMAT=JSON：消息分页使用 `idx_messages_conversation_created`、access=ref、无 filesort/temporary；message_reads 使用 reader 索引、成员校验使用 `uk_conv_members`；条件撤回使用 PRIMARY、access=range；未读查询使用消息索引和 `uk_message_reads`。未新增索引。 +- 说明：该 EXPLAIN 为当前验收数据的代表性计划；更大生产数据量的容量/延迟压测仍需后续授权，不以固定查询数替代性能结论。 + +## 8. RabbitMQ 与副作用 + +RabbitMQ `ping` 成功；`queue.sms.verification`、`queue.notification`、`queue.audit`、`queue.notification.dlq` 均真实存在，ready=0、unacked=0。N07 撤回未产生新增消息、通知、短信或邮件。 + +目标消息撤回前后稳定摘要证明：除目标消息允许的四项状态变化和一条白名单 `MESSAGE_RECALLED` 审计外，message_reads、会话、成员、评分快照、通知、风险治理表内容与 version 不变。 + +## 9. OpenAPI + +- 静态：173 paths / 211 operations，`verify_openapi.py` 通过。 +- 运行时：`GET /api/v1/v3/api-docs` 返回 173 paths / 211 operations，与静态计数一致；撤回无 requestBody，200 响应引用 `ApiResponseMessageResponse`，分页响应引用 `ApiResponseMessagePageResponse`。 +- 未新增编辑、删除、批量撤回、恢复接口；TALENT_INVITATION 的条件性 senderScope 脱敏由真实 JSON 验证。 + +## 10. PASS/FAIL/SKIP 与剩余风险 + +- PASS：自动化、V41 迁移与 schema validation、启动/健康、权限、DIRECT/TALENT_INVITATION 脱敏、并发、审计隐私、message_reads/unread、只读副作用、查询预算、EXPLAIN、RabbitMQ、静态/运行时 OpenAPI。 +- FAIL：0。 +- SKIP：0 个核心验收项。生产级更大规模容量压测和持续运行监控不属于本轮黑盒范围，需独立性能验收，但不构成当前 N07 功能阻断。 +- 不允许把本报告扩展为对 V1–V40 其他业务的全面生产保证；仅确认 N07 变更边界。 + +## 11. 最终判定 + +**PASS：N07 独立代码复验和真实 MySQL/Docker 黑盒全部通过，可以进入精确暂存检查点。** + +本报告不包含数据库密码、JWT、测试账号密码、手机号、邮箱或原消息正文。验收数据仅使用本轮唯一前缀并已按精确 ID 清理；历史验收文件未删除或移动。 diff --git a/docs/offer-api.md b/docs/offer-api.md index f455bfd..4ef02bf 100644 --- a/docs/offer-api.md +++ b/docs/offer-api.md @@ -259,7 +259,7 @@ POST /offers/{id}/remind > 现网 OpenAPI 亦可访问 `GET /api/v1/v3/api-docs` 导出后导入 Apifox。 -测试账号（Mock 短信验证码，验证码见应用日志）： +测试账号（Mock 短信验证码：应用日志不再输出，本地按 `docs/frontend-integration.md` §3 的受控方式取得；生产禁止查表）： | 角色 | 手机号 | 用途 | |---|---|---| diff --git a/docs/openapi-rc.json b/docs/openapi-rc.json index ba72fa2..288bd14 100644 --- a/docs/openapi-rc.json +++ b/docs/openapi-rc.json @@ -120,15 +120,75 @@ "description": "企业资料创建、查询与更新" }, { - "name": "入职清单", - "description": "学生读取有效入职清单并更新本人完成状态；企业维护本企业自定义项" + "name": "health-controller", + "description": "health-controller 接口" }, { - "name": "公司知识介绍", - "description": "企业维护知识内容，学生读取公司基础资料、知识与公开评价摘要" + "name": "student-review-weight-controller", + "description": "student-review-weight-controller 接口" + }, + { + "name": "同岗位竞争力排名", + "description": "同岗位竞争力排名 接口" + }, + { + "name": "RIASEC 职业兴趣测评", + "description": "RIASEC 职业兴趣测评接口" + }, + { + "name": "求职进度", + "description": "求职进度 接口" + }, + { + "name": "account-deletion-controller", + "description": "account-deletion-controller 接口" + }, + { + "name": "personal-data-export-controller", + "description": "personal-data-export-controller 接口" + }, + { + "name": "privacy-settings-controller", + "description": "privacy-settings-controller 接口" + }, + { + "name": "举报与屏蔽", + "description": "举报与屏蔽 接口" + }, + { + "name": "举报管理", + "description": "举报管理 接口" + }, + { + "name": "四维能力测评", + "description": "四维能力测评接口" + }, + { + "name": "风险治理", + "description": "评分风险治理管理接口" + }, + { + "name": "岗位推荐", + "description": "学生岗位推荐及企业推荐画像接口" + }, + { + "name": "企业评价管理", + "description": "企业评价查看及官方回复接口" + }, + { + "name": "官方回复审核", + "description": "管理员官方回复审核接口" + }, + { + "name": "企业人才发现", + "description": "企业人才发现接口" + }, + { + "name": "企业人才邀约", + "description": "企业人才邀约接口" } ], - "paths": {"/salary-calculator/cities":{"get":{"tags":["薪资计算器"],"summary":"查询启用城市列表","operationId":"listSalaryCities","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListSalaryCitySummaryResponse"}}}},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"}}}},"/salary-calculator/cities/{cityCode}":{"get":{"tags":["薪资计算器"],"summary":"查询城市默认参数","operationId":"getSalaryCity","security":[{"bearerAuth":[]}],"parameters":[{"name":"cityCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseSalaryCityDetailResponse"}}}},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"},"404":{"description":"城市不存在或停用"}}}},"/salary-calculator/calculations":{"post":{"tags":["薪资计算器"],"summary":"计算并保存到手工资","operationId":"calculateSalary","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaryCalculationRequest"}}}},"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseSalaryCalculationResponse"}}}},"400":{"description":"参数非法"},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"},"404":{"description":"城市不存在或停用"},"409":{"description":"幂等或政策版本冲突"}}},"get":{"tags":["薪资计算器"],"summary":"查询本人薪资历史","operationId":"listSalaryCalculations","security":[{"bearerAuth":[]}],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"size","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePageResponseSalaryHistorySummaryResponse"}}}},"400":{"description":"分页参数非法"},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"}}}},"/salary-calculator/calculations/{id}":{"get":{"tags":["薪资计算器"],"summary":"查询本人薪资历史详情","operationId":"getSalaryCalculation","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseSalaryHistoryDetailResponse"}}}},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"},"404":{"description":"历史不存在或无权访问"}}},"delete":{"tags":["薪资计算器"],"summary":"删除本人薪资历史","operationId":"deleteSalaryCalculation","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}},"401":{"description":"未认证"},"403":{"description":"非 STUDENT"},"404":{"description":"历史不存在或无权访问"}}}}, + "paths": { "/": { "get": { "tags": [ @@ -1385,8 +1445,8 @@ "tags": [ "认证" ], - "summary": "发送短信验证码（Mock）", - "description": "开发环境 Mock：验证码会打印到日志", + "summary": "发送短信验证码", + "description": "开发/测试使用 Mock 发送实现；生产环境未接入短信网关时返回服务不可用。验证码不会写入日志。", "operationId": "sendSmsCode", "parameters": [ { @@ -2288,7 +2348,7 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseMessagePageResponse" } } } @@ -2329,6 +2389,60 @@ } } }, + "/conversations/{conversationId}/messages/{messageId}/recall": { + "post": { + "tags": [ + "消息" + ], + "summary": "撤回消息", + "description": "仅原发送者可在发送后两分钟内撤回消息；重复撤回幂等返回当前状态", + "operationId": "recallMessage", + "parameters": [ + { + "name": "conversationId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "messageId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseMessageResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非会话成员或非原发送者" + }, + "404": { + "description": "会话或消息不存在" + }, + "409": { + "description": "撤回窗口已过期或并发冲突" + } + } + } + }, "/health": { "get": { "tags": [ @@ -3351,111 +3465,178 @@ ] } }, - "/jobs/{jobId}/reviews": { + "/assessments/types": { "get": { "tags": [ - "岗位评价" - ], - "summary": "查询岗位评价列表", - "description": "公开访问；仅返回 PUBLISHED 评价，分页；每条含八维评分", - "operationId": "list_2", - "parameters": [ - { - "name": "jobId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - }, - { - "name": "page", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 0 - } - }, - { - "name": "size", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 20 - } - } + "RIASEC 职业兴趣测评" ], + "summary": "测评类型列表", + "description": "返回全部 ACTIVE 测评定义。任意已登录用户可访问；未登录 401。", + "operationId": "listAssessmentTypes", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" } } } } - } - }, - "post": { + }, + "security": [ + { + "bearerAuth": [] + } + ] + } + }, + "/assessments/{type}/questions": { + "get": { "tags": [ - "岗位评价" + "RIASEC 职业兴趣测评" ], - "summary": "创建岗位评价", - "description": "仅 STUDENT；同一学生对同一岗位只能评价一次", - "operationId": "create_3", + "summary": "题目列表", + "description": "返回指定测评的 ACTIVE 题目，隐藏维度/reverseScored/source/版本等内部字段。", + "operationId": "listAssessmentQuestions", "parameters": [ { - "name": "jobId", + "name": "type", "in": "path", "required": true, "schema": { - "type": "integer", - "format": "int64" + "type": "string" } } ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/JobReviewCreateRequest" + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } } } }, - "required": true + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "测评类型不存在（9701）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } }, + "security": [ + { + "bearerAuth": [] + } + ] + } + }, + "/assessments/attempts": { + "post": { + "tags": [ + "RIASEC 职业兴趣测评" + ], + "summary": "创建答卷", + "description": "照六维各抽 5 题共 30 道并持久化，刷新不重抽。幂等键重放返回原答卷；同键不同定义 409/9709；已有活跃答卷 409/9708。仅 STUDENT。", + "operationId": "createAssessmentAttempt", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非 STUDENT（2002）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "测评类型不存在（9701）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "活跃答卷/幂等冲突（9708/9709）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/jobs/{jobId}/reviews/summary": { + "/assessments/attempts/{attemptId}": { "get": { "tags": [ - "岗位评价" + "RIASEC 职业兴趣测评" ], - "summary": "评分汇总", - "description": "公开访问；统计 PUBLISHED 评价的平均分、分布和热门标签", - "operationId": "summary", + "summary": "答卷详情", + "description": "返回本次抽中的 30 道题（固定顺序）、已保存答案、进度与当前状态。仅本人可访问；非 STUDENT 403。", + "operationId": "getAssessmentAttempt", "parameters": [ { - "name": "jobId", + "name": "attemptId", "in": "path", "required": true, "schema": { @@ -3470,157 +3651,60 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/jobs/{jobId}/reviews/{reviewId}": { - "get": { - "tags": [ - "岗位评价" - ], - "summary": "岗位评价详情", - "description": "公开访问；返回单条 PUBLISHED 评价与八维评分", - "operationId": "get_2", - "parameters": [ - { - "name": "jobId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } }, - { - "name": "reviewId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "200": { - "description": "OK", + "401": { + "description": "未登录", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - }, - "put": { - "tags": [ - "岗位评价" - ], - "summary": "修改评价", - "description": "仅评价本人可以修改", - "operationId": "update_2", - "parameters": [ - { - "name": "jobId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - }, - { - "name": "reviewId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/JobReviewUpdateRequest" - } - } }, - "required": true - }, - "responses": { - "200": { - "description": "OK", + "403": { + "description": "非本人或非 STUDENT（2002）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - }, - "delete": { - "tags": [ - "岗位评价" - ], - "summary": "删除评价", - "description": "仅评价本人可以删除", - "operationId": "delete_1", - "parameters": [ - { - "name": "jobId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } }, - { - "name": "reviewId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "200": { - "description": "OK", + "404": { + "description": "答卷不存在（9702）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/jobs/{jobId}/status": { + "/assessments/attempts/{attemptId}/answers": { "patch": { "tags": [ - "岗位" + "RIASEC 职业兴趣测评" ], - "summary": "发布/关闭岗位", - "description": "DRAFT→PUBLISHED，PUBLISHED→CLOSED；禁止非法回退", - "operationId": "updateStatus", + "summary": "保存答案", + "description": "单题或批量保存，重复保存 upsert；value 1-5；题目必须属于本答卷；版本冲突 409/9707；首次保存后状态置为 IN_PROGRESS。仅本人。", + "operationId": "saveAssessmentAnswers", "parameters": [ { - "name": "jobId", + "name": "attemptId", "in": "path", "required": true, "schema": { @@ -3629,129 +3713,76 @@ } } ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/JobStatusRequest" - } - } - }, - "required": true - }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/notifications": { - "get": { - "tags": [ - "通知" - ], - "summary": "通知列表", - "description": "当前用户的通知，分页，按时间倒序", - "operationId": "list_3", - "parameters": [ - { - "name": "page", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 0 - } }, - { - "name": "size", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 20 + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } } - } - ], - "responses": { - "200": { - "description": "OK", + }, + "403": { + "description": "非本人或非 STUDENT（2002）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/notifications/read-all": { - "post": { - "tags": [ - "通知" - ], - "summary": "全部已读", - "description": "标记当前用户全部通知已读（幂等）", - "operationId": "markAllRead", - "responses": { - "200": { - "description": "OK", + }, + "404": { + "description": "答卷不存在（9702）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/notifications/unread-count": { - "get": { - "tags": [ - "通知" - ], - "summary": "未读数", - "description": "当前用户未读通知数", - "operationId": "unreadCount", - "responses": { - "200": { - "description": "OK", + }, + "409": { + "description": "非法状态/并发（9703/9707）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/notifications/{id}/read": { + "/assessments/attempts/{attemptId}/submit": { "post": { "tags": [ - "通知" + "RIASEC 职业兴趣测评" ], - "summary": "标记已读", - "description": "标记单条通知已读（幂等）", - "operationId": "markRead", + "summary": "提交答卷", + "description": "30 题全答且每维各 5 题后方可提交（否则 400/9706）；提交后生成结果并写审计；重复提交返回原结果，不重复生成与审计。仅本人。", + "operationId": "submitAssessmentAttempt", "parameters": [ { - "name": "id", + "name": "attemptId", "in": "path", "required": true, "schema": { @@ -3766,120 +3797,85 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/offers": { - "get": { - "tags": [ - "Offer" - ], - "summary": "Offer 列表", - "description": "候选人查看收到的、企业查看发出的 Offer；支持 status、applicationId 筛选与分页", - "operationId": "list_1", - "parameters": [ - { - "name": "status", - "in": "query", - "required": false, - "schema": { - "type": "string" + }, + "400": { + "description": "未完成（9706）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } } }, - { - "name": "applicationId", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int64" - } - }, - { - "name": "page", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 0 + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } } }, - { - "name": "size", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 20 - } - } - ], - "responses": { - "200": { - "description": "OK", + "403": { + "description": "非本人或非 STUDENT（2002）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - }, - "post": { - "tags": [ - "Offer" - ], - "summary": "创建 Offer", - "description": "仅企业账号；投递存在、岗位属于本企业、投递状态可发、无有效 Offer；默认 DRAFT", - "operationId": "create_2", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/OfferCreateRequest" + }, + "404": { + "description": "答卷不存在（9702）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } } } }, - "required": true - }, - "responses": { - "200": { - "description": "OK", + "409": { + "description": "非法状态（9703）", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/offers/compare": { + "/assessments/attempts/{attemptId}/result": { "get": { "tags": [ - "Offer" + "RIASEC 职业兴趣测评" ], - "summary": "Offer 比较", - "description": "仅候选人本人；比较 2-5 个非 DRAFT 的 Offer", - "operationId": "compare", + "summary": "查看结果", + "description": "答卷 COMPLETED 后返回聚合分、类型排名、探索方向。仅本人可访问。", + "operationId": "getAssessmentResult", "parameters": [ { - "name": "ids", - "in": "query", + "name": "attemptId", + "in": "path", "required": true, "schema": { - "type": "string" + "type": "integer", + "format": "int64" } } ], @@ -3889,65 +3885,143 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListMapStringObject" + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非本人或非 STUDENT（2002）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "答卷不存在（9702）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "答卷未完成（9703）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/offers/statistics": { + "/assessments/me": { "get": { "tags": [ - "Offer" - ], - "summary": "Offer 统计", - "description": "仅企业；统计本企业 Offer 状态分布、接受率、平均响应时间", - "operationId": "statistics", - "parameters": [ - { - "name": "months", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "format": "int32", - "default": 6 - } - } + "RIASEC 职业兴趣测评" ], + "summary": "我的测评历史", + "description": "分页返回当前学生的全部答卷与结果概要。仅 STUDENT 本人可访问。", + "operationId": "listMyAssessments", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非 STUDENT（2002）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/offers/{id}": { + "/jobs/{jobId}/reviews": { "get": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "Offer 详情", - "description": "仅目标候选人、所属企业可访问；其他账号返回无权限错误", - "operationId": "get_1", + "summary": "查询岗位评价列表", + "description": "公开访问；仅返回 PUBLISHED 评价，分页；每条含八维评分", + "operationId": "list_2", "parameters": [ { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } + }, + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 + } } ], "responses": { @@ -3963,16 +4037,16 @@ } } }, - "put": { + "post": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "修改 Offer", - "description": "仅所属企业、仅 DRAFT 状态可修改；其余状态返回业务错误", - "operationId": "update_1", + "summary": "创建岗位评价", + "description": "仅 STUDENT；同一学生对同一岗位只能评价一次", + "operationId": "create_3", "parameters": [ { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { @@ -3985,7 +4059,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/OfferUpdateRequest" + "$ref": "#/components/schemas/JobReviewCreateRequest" } } }, @@ -4005,17 +4079,17 @@ } } }, - "/offers/{id}/counter-offers": { + "/jobs/{jobId}/reviews/summary": { "get": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "还价列表", - "description": "候选人查看本人 Offer 的还价、企业查看本企业 Offer 的还价", - "operationId": "listCounterOffers", + "summary": "评分汇总", + "description": "公开访问；统计 PUBLISHED 评价的平均分、分布和热门标签", + "operationId": "summary", "parameters": [ { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { @@ -4030,66 +4104,25 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListMapStringObject" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } } } - }, - "post": { + } + }, + "/jobs/{jobId}/reviews/{reviewId}": { + "get": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "发起还价", - "description": "仅候选人本人；仅 SENT/NEGOTIATING 可发起；SENT 时自动进入 NEGOTIATING", - "operationId": "createCounterOffer", + "summary": "岗位评价详情", + "description": "公开访问；返回单条 PUBLISHED 评价与八维评分", + "operationId": "get_2", "parameters": [ { - "name": "id", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CounterOfferCreateRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "OK", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" - } - } - } - } - } - } - }, - "/offers/{id}/counter-offers/{coId}/accept": { - "patch": { - "tags": [ - "Offer" - ], - "summary": "接受还价", - "description": "仅所属企业；接受后更新 Offer 薪资/入职日期并变为 ACCEPTED", - "operationId": "acceptCounterOffer", - "parameters": [ - { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { @@ -4098,7 +4131,7 @@ } }, { - "name": "coId", + "name": "reviewId", "in": "path", "required": true, "schema": { @@ -4119,19 +4152,17 @@ } } } - } - }, - "/offers/{id}/counter-offers/{coId}/reject": { - "patch": { + }, + "put": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "拒绝还价", - "description": "仅所属企业；拒绝后 Offer 保持 NEGOTIATING", - "operationId": "rejectCounterOffer", + "summary": "修改评价", + "description": "仅评价本人可以修改", + "operationId": "update_2", "parameters": [ { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { @@ -4140,7 +4171,7 @@ } }, { - "name": "coId", + "name": "reviewId", "in": "path", "required": true, "schema": { @@ -4149,6 +4180,16 @@ } } ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/JobReviewUpdateRequest" + } + } + }, + "required": true + }, "responses": { "200": { "description": "OK", @@ -4161,19 +4202,26 @@ } } } - } - }, - "/offers/{id}/remind": { - "post": { + }, + "delete": { "tags": [ - "Offer" + "岗位评价" ], - "summary": "手动提醒", - "description": "仅所属企业；仅 SENT/NEGOTIATING 可提醒；相同提醒不重复创建", - "operationId": "remind", + "summary": "删除评价", + "description": "仅评价本人可以删除", + "operationId": "delete_1", "parameters": [ { - "name": "id", + "name": "jobId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "reviewId", "in": "path", "required": true, "schema": { @@ -4196,17 +4244,17 @@ } } }, - "/offers/{id}/status": { + "/jobs/{jobId}/status": { "patch": { "tags": [ - "Offer" + "岗位" ], - "summary": "Offer 状态变更", - "description": "DRAFT→SENT 企业；SENT/NEGOTIATING→ACCEPTED/REJECTED/NEGOTIATING 候选人；重复提交幂等", - "operationId": "changeStatus", + "summary": "发布/关闭岗位", + "description": "DRAFT→PUBLISHED，PUBLISHED→CLOSED；禁止非法回退", + "operationId": "updateStatus", "parameters": [ { - "name": "id", + "name": "jobId", "in": "path", "required": true, "schema": { @@ -4219,7 +4267,7 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/OfferStatusRequest" + "$ref": "#/components/schemas/JobStatusRequest" } } }, @@ -4239,22 +4287,33 @@ } } }, - "/offers/{id}/timeline": { + "/notifications": { "get": { "tags": [ - "Offer" + "通知" ], - "summary": "Offer 状态时间线", - "description": "完整状态变更历史，含操作者、原因与请求 ID", - "operationId": "timeline", + "summary": "通知列表", + "description": "当前用户的通知，分页，按时间倒序", + "operationId": "list_3", "parameters": [ { - "name": "id", - "in": "path", - "required": true, + "name": "page", + "in": "query", + "required": false, "schema": { "type": "integer", - "format": "int64" + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 } } ], @@ -4264,7 +4323,7 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListMapStringObject" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4272,106 +4331,36 @@ } } }, - "/profile/me": { - "get": { + "/notifications/read-all": { + "post": { "tags": [ - "个人资料" + "通知" ], - "summary": "查询当前学生资料", - "description": "查询当前登录学生（仅 STUDENT 角色）自己的学生资料。身份仅从 JWT/SecurityContext 获取，不接受 userId、studentUserId 等请求参数；本接口无 Path、Query、Body 参数。若尚未创建个人资料：HTTP 200，data 为空对象 {}（非 null），且不会自动创建数据库记录。当前未设置接口级限流。", - "operationId": "getMyProfile", + "summary": "全部已读", + "description": "标记当前用户全部通知已读（幂等）", + "operationId": "markAllRead", "responses": { "200": { - "description": "成功；有资料返回资料对象，无资料返回空对象 {}；message=ok", + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseStudentProfileResponse" - }, - "examples": { - "success-with-data": { - "summary": "有资料", - "description": "success-with-data", - "value": { - "code": 200, - "message": "ok", - "data": { - "id": 1, - "userId": 2, - "realName": "张三", - "education": "本科", - "school": "某某大学", - "graduationYear": 2026, - "resumeUrl": "/uploads/resumes/2/resume.pdf", - "skills": "[Java, Spring Boot]", - "createdAt": "2026-08-24T10:00:00" - }, - "timestamp": "2026-08-24T10:00:00Z" - } - } - } - } - } - }, - "401": { - "description": "未登录、Token 缺失/非法/过期；运行时实际返回 code=401、message=not authenticated", - "content": { - "application/json": { - "examples": { - "unauthorized": { - "description": "unauthorized", - "value": { - "code": 401, - "message": "not authenticated", - "timestamp": "2026-08-24T10:00:00Z" - } - } - } - } - } - }, - "403": { - "description": "已登录但不是 STUDENT 角色（COMPANY/ADMIN）；code=2002、message=forbidden", - "content": { - "application/json": { - "examples": { - "forbidden": { - "description": "forbidden", - "value": { - "code": 2002, - "message": "forbidden", - "data": null, - "timestamp": "2026-08-24T10:00:00Z" - } - } + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } } - }, - "security": [ - { - "bearerAuth": [] - } - ] - }, - "put": { + } + } + }, + "/notifications/unread-count": { + "get": { "tags": [ - "个人资料" + "通知" ], - "summary": "更新学生资料", - "description": "仅更新传入的非 null 字段；不存在则自动创建", - "operationId": "updateMyProfile", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/StudentProfileUpdateRequest" - } - } - }, - "required": true - }, + "summary": "未读数", + "description": "当前用户未读通知数", + "operationId": "unreadCount", "responses": { "200": { "description": "OK", @@ -4386,170 +4375,32 @@ } } }, - "/profile/me/candidate-percentile": { - "get": { + "/notifications/{id}/read": { + "post": { "tags": [ - "求职者评分卡" + "通知" ], - "summary": "查询百分位", - "description": "仅 STUDENT；返回自己在候选人中的评分百分位", - "operationId": "getPercentile", - "responses": { - "200": { - "description": "OK", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseCandidatePercentileResponse" - } - } - } - }, - "401": { - "description": "未登录", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "403": { - "description": "非 STUDENT 角色", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - } - } - } - }, - "/profile/me/candidate-score-card": { - "get": { - "tags": [ - "求职者评分卡" - ], - "summary": "查询求职者评分卡", - "description": "仅 STUDENT；返回自己的评价聚合卡", - "operationId": "getScoreCard", - "responses": { - "200": { - "description": "OK", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseCandidateScoreCardResponse" - } - } - } - }, - "401": { - "description": "未登录", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "403": { - "description": "非 STUDENT 角色", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - } - } - } - }, - "/profile/me/candidate-score-trend": { - "get": { - "tags": [ - "求职者评分卡" - ], - "summary": "查询评分趋势", - "description": "仅 STUDENT；返回最近月份的反馈趋势", - "operationId": "getTrend_1", + "summary": "标记已读", + "description": "标记单条通知已读（幂等）", + "operationId": "markRead", "parameters": [ { - "name": "months", - "in": "query", - "description": "统计月数，默认 6，范围 1-24", - "required": false, + "name": "id", + "in": "path", + "required": true, "schema": { "type": "integer", - "format": "int32", - "default": 6 - } - } - ], - "responses": { - "200": { - "description": "OK", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseCandidateScoreTrendResponse" - } - } - } - }, - "400": { - "description": "参数不合法", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseCandidateScoreTrendResponse" - } - } - } - }, - "401": { - "description": "未登录", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "403": { - "description": "非 STUDENT 角色", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } + "format": "int64" } } - } - } - }, - "/profile/me/candidate-scoring": { - "get": { - "tags": [ - "求职者评分体系" ], - "summary": "综合评分卡", - "description": "仅 STUDENT；返回本人 8 维评分、综合分、权重与状态", - "operationId": "getOverview", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCandidateScoringOverviewResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4557,14 +4408,14 @@ } } }, - "/profile/me/candidate-scoring/appeals": { + "/offers": { "get": { "tags": [ - "评分治理" + "Offer" ], - "summary": "我的申诉列表", - "description": "仅 STUDENT 本人", - "operationId": "listMyAppeals", + "summary": "Offer 列表", + "description": "候选人查看收到的、企业查看发出的 Offer；支持 status、applicationId 筛选与分页", + "operationId": "list_1", "parameters": [ { "name": "status", @@ -4574,6 +4425,15 @@ "type": "string" } }, + { + "name": "applicationId", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int64" + } + }, { "name": "page", "in": "query", @@ -4610,16 +4470,16 @@ }, "post": { "tags": [ - "评分治理" + "Offer" ], - "summary": "提交评分申诉", - "description": "仅 STUDENT 本人；同一学生+维度+周期 PENDING/APPROVED 唯一", - "operationId": "createAppeal", + "summary": "创建 Offer", + "description": "仅企业账号；投递存在、岗位属于本企业、投递状态可发、无有效 Offer；默认 DRAFT", + "operationId": "create_2", "requestBody": { "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/CreateAppealRequest" + "$ref": "#/components/schemas/OfferCreateRequest" } } }, @@ -4631,7 +4491,7 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseAppealResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4639,22 +4499,21 @@ } } }, - "/profile/me/candidate-scoring/appeals/{appealId}": { + "/offers/compare": { "get": { "tags": [ - "评分治理" + "Offer" ], - "summary": "申诉详情", - "description": "本人或 ADMIN", - "operationId": "getAppeal", + "summary": "Offer 比较", + "description": "仅候选人本人；比较 2-5 个非 DRAFT 的 Offer", + "operationId": "compare", "parameters": [ { - "name": "appealId", - "in": "path", + "name": "ids", + "in": "query", "required": true, "schema": { - "type": "integer", - "format": "int64" + "type": "string" } } ], @@ -4664,7 +4523,7 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseAppealResponse" + "$ref": "#/components/schemas/ApiResponseListMapStringObject" } } } @@ -4672,22 +4531,23 @@ } } }, - "/profile/me/candidate-scoring/appeals/{appealId}/cancel": { - "post": { + "/offers/statistics": { + "get": { "tags": [ - "评分治理" + "Offer" ], - "summary": "撤销申诉", - "description": "仅本人；仅 PENDING 可撤销", - "operationId": "cancelAppeal", + "summary": "Offer 统计", + "description": "仅企业；统计本企业 Offer 状态分布、接受率、平均响应时间", + "operationId": "statistics", "parameters": [ { - "name": "appealId", - "in": "path", - "required": true, + "name": "months", + "in": "query", + "required": false, "schema": { "type": "integer", - "format": "int64" + "format": "int32", + "default": 6 } } ], @@ -4697,7 +4557,7 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseAppealResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4705,21 +4565,22 @@ } } }, - "/profile/me/candidate-scoring/dimensions/{dimension}": { + "/offers/{id}": { "get": { "tags": [ - "求职者评分体系" + "Offer" ], - "summary": "单维度明细", - "description": "仅 STUDENT；返回某维度分项、归因与数据源；非法 dimension 返回 400", - "operationId": "getDimensionDetail", + "summary": "Offer 详情", + "description": "仅目标候选人、所属企业可访问；其他账号返回无权限错误", + "operationId": "get_1", "parameters": [ { - "name": "dimension", + "name": "id", "in": "path", "required": true, "schema": { - "type": "string" + "type": "integer", + "format": "int64" } } ], @@ -4729,41 +4590,48 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseDimensionScoreDetailResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } } } - } - }, - "/profile/me/candidate-scoring/trend": { - "get": { + }, + "put": { "tags": [ - "求职者评分体系" + "Offer" ], - "summary": "评分趋势", - "description": "仅 STUDENT；基于快照按月返回综合分与维度分（months 1-24）", - "operationId": "getTrend", + "summary": "修改 Offer", + "description": "仅所属企业、仅 DRAFT 状态可修改；其余状态返回业务错误", + "operationId": "update_1", "parameters": [ { - "name": "months", - "in": "query", - "required": false, + "name": "id", + "in": "path", + "required": true, "schema": { "type": "integer", - "format": "int32", - "default": 6 + "format": "int64" } } ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OfferUpdateRequest" + } + } + }, + "required": true + }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCandidateScoringTrendResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4771,84 +4639,32 @@ } } }, - "/profile/me/career-progress": { + "/offers/{id}/counter-offers": { "get": { "tags": [ - "求职进度" + "Offer" ], - "summary": "统一求职进度聚合", - "description": "只读学生端接口：汇总当前学生的投递分页、岗位摘要、下一场面试、最近已提交结构化面试评分、可展示 Offer、同岗位竞争力排名，以及待办/通知计数（仅计数，不含通知标题/正文/详情）。仅 STUDENT 可访问，身份仅从 JWT/SecurityContext 获取，不接受 userId/studentUserId/candidateId 参数；COMPANY/ADMIN 返回 403/2002，未登录返回 401，参数非法返回 400/1001。通知详情仍由既有 /notifications 提供。", - "operationId": "getCareerProgress", + "summary": "还价列表", + "description": "候选人查看本人 Offer 的还价、企业查看本企业 Offer 的还价", + "operationId": "listCounterOffers", "parameters": [ { - "name": "page", - "in": "query", - "required": false, - "schema": { "type": "integer", "format": "int32", "default": 0 } - }, - { - "name": "size", - "in": "query", - "required": false, - "schema": { "type": "integer", "format": "int32", "default": 20 } - }, - { - "name": "status", - "in": "query", - "required": false, + "name": "id", + "in": "path", + "required": true, "schema": { - "type": "string", - "enum": ["SUBMITTED", "VIEWED", "INTERVIEW", "HIRED", "REJECTED", "WITHDRAWN"] + "type": "integer", + "format": "int64" } } ], "responses": { "200": { "description": "OK", - "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseCareerProgressResponse" } } } - }, - "400": { - "description": "page/size/status 参数非法", - "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } - }, - "401": { - "description": "未登录", - "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } - }, - "403": { - "description": "非 STUDENT 角色", - "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } - } - }, - "security": [ - { "bearerAuth": [] } - ] - } - }, - "/profile/me/deletion": { - "get": { - "tags": [ - "account-deletion-controller" - ], - "operationId": "getStatus", - "parameters": [], - "responses": { - "200": { - "description": "success", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" - } - } - } - }, - "401": { - "description": "error", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseListMapStringObject" } } } @@ -4857,47 +4673,39 @@ }, "post": { "tags": [ - "account-deletion-controller" + "Offer" ], - "operationId": "initiate", - "parameters": [], - "responses": { - "200": { - "description": "success", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" - } - } - } - }, - "401": { - "description": "error", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } + "summary": "发起还价", + "description": "仅候选人本人；仅 SENT/NEGOTIATING 可发起；SENT 时自动进入 NEGOTIATING", + "operationId": "createCounterOffer", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" } - }, - "403": { - "description": "error", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CounterOfferCreateRequest" } } }, - "409": { - "description": "error", + "required": true + }, + "responses": { + "200": { + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4905,50 +4713,83 @@ } } }, - "/profile/me/deletion/cancel": { - "post": { + "/offers/{id}/counter-offers/{coId}/accept": { + "patch": { "tags": [ - "account-deletion-controller" + "Offer" + ], + "summary": "接受还价", + "description": "仅所属企业；接受后更新 Offer 薪资/入职日期并变为 ACCEPTED", + "operationId": "acceptCounterOffer", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "coId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], - "operationId": "cancel", - "parameters": [], "responses": { "200": { - "description": "success", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "401": { - "description": "error", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } + } + } + } + }, + "/offers/{id}/counter-offers/{coId}/reject": { + "patch": { + "tags": [ + "Offer" + ], + "summary": "拒绝还价", + "description": "仅所属企业；拒绝后 Offer 保持 NEGOTIATING", + "operationId": "rejectCounterOffer", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" } }, - "403": { - "description": "error", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } + { + "name": "coId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" } - }, - "409": { - "description": "error", + } + ], + "responses": { + "200": { + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -4956,149 +4797,210 @@ } } }, - "/profile/me/data-export-tasks": { - "get": { + "/offers/{id}/remind": { + "post": { "tags": [ - "personal-data-export-controller" + "Offer" ], - "summary": "查询个人数据导出任务列表", - "description": "仅本人；按创建时间倒序分页；status 可选：PENDING/PROCESSING/COMPLETED/FAILED/EXPIRED/CANCELLED", - "operationId": "listDataExportTasks", + "summary": "手动提醒", + "description": "仅所属企业；仅 SENT/NEGOTIATING 可提醒；相同提醒不重复创建", + "operationId": "remind", "parameters": [ - { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 } }, - { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "default": 20 } }, - { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], "responses": { "200": { - "description": "success", + "description": "OK", "content": { "*/*": { - "schema": { "$ref": "#/components/schemas/ApiResponsePageResponseDataExportTaskResponse" } + "schema": { + "$ref": "#/components/schemas/ApiResponseMapStringObject" + } } } - }, - "401": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "409": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } + } } - }, - "post": { + } + }, + "/offers/{id}/status": { + "patch": { "tags": [ - "personal-data-export-controller" + "Offer" + ], + "summary": "Offer 状态变更", + "description": "DRAFT→SENT 企业；SENT/NEGOTIATING→ACCEPTED/REJECTED/NEGOTIATING 候选人；重复提交幂等", + "operationId": "changeStatus", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], - "summary": "创建个人数据导出任务", - "description": "异步生成 ZIP；同 idempotencyKey 重放返回原任务；注销 PENDING/COMPLETED 禁止创建", - "operationId": "createDataExportTask", - "parameters": [], "requestBody": { "content": { "application/json": { - "schema": { "$ref": "#/components/schemas/CreateDataExportRequest" } + "schema": { + "$ref": "#/components/schemas/OfferStatusRequest" + } } }, - "required": false + "required": true }, "responses": { "200": { - "description": "success", + "description": "OK", "content": { "*/*": { - "schema": { "$ref": "#/components/schemas/ApiResponseDataExportTaskResponse" } + "schema": { + "$ref": "#/components/schemas/ApiResponseMapStringObject" + } } } - }, - "401": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "409": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } + } } } }, - "/profile/me/data-export-tasks/{taskId}": { + "/offers/{id}/timeline": { "get": { "tags": [ - "personal-data-export-controller" + "Offer" ], - "summary": "查询个人数据导出任务详情", - "description": "仅本人；不暴露 storageKey 与内部字段", - "operationId": "getDataExportTask", + "summary": "Offer 状态时间线", + "description": "完整状态变更历史，含操作者、原因与请求 ID", + "operationId": "timeline", "parameters": [ - { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], "responses": { "200": { - "description": "success", + "description": "OK", "content": { "*/*": { - "schema": { "$ref": "#/components/schemas/ApiResponseDataExportTaskResponse" } + "schema": { + "$ref": "#/components/schemas/ApiResponseListMapStringObject" + } } } - }, - "401": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "404": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } + } } } }, - "/profile/me/data-export-tasks/{taskId}/download": { + "/profile/me": { "get": { "tags": [ - "personal-data-export-controller" - ], - "summary": "下载个人数据导出 ZIP", - "description": "仅本人且 COMPLETED 未过期；attachment；需 JWT", - "operationId": "downloadDataExportTask", - "parameters": [ - { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } + "个人资料" ], + "summary": "查询当前学生资料", + "description": "查询当前登录学生（仅 STUDENT 角色）自己的学生资料。身份仅从 JWT/SecurityContext 获取，不接受 userId、studentUserId 等请求参数；本接口无 Path、Query、Body 参数。若尚未创建个人资料：HTTP 200，data 为空对象 {}（非 null），且不会自动创建数据库记录。当前未设置接口级限流。", + "operationId": "getMyProfile", "responses": { "200": { - "description": "success", + "description": "成功；有资料返回资料对象，无资料返回空对象 {}；message=ok", "content": { - "application/zip": { - "schema": { "type": "string", "format": "binary" } + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseStudentProfileResponse" + }, + "examples": { + "success-with-data": { + "summary": "有资料", + "description": "success-with-data", + "value": { + "code": 200, + "message": "ok", + "data": { + "id": 1, + "userId": 2, + "realName": "张三", + "education": "本科", + "school": "某某大学", + "graduationYear": 2026, + "resumeUrl": "/uploads/resumes/2/resume.pdf", + "skills": "[Java, Spring Boot]", + "createdAt": "2026-08-24T10:00:00" + }, + "timestamp": "2026-08-24T10:00:00Z" + } + } + } } } }, - "401": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "409": { "description": "error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/profile/me/match-rule": { - "get": { - "tags": [ - "双向匹配阈值" - ], - "summary": "查询学生匹配阈值", - "description": "未配置返回默认 60", - "operationId": "getStudentRule", - "responses": { - "200": { - "description": "OK", + "401": { + "description": "未登录、Token 缺失/非法/过期；运行时实际返回 code=401、message=not authenticated", "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "application/json": { + "examples": { + "unauthorized": { + "description": "unauthorized", + "value": { + "code": 401, + "message": "not authenticated", + "timestamp": "2026-08-24T10:00:00Z" + } + } + } + } + } + }, + "403": { + "description": "已登录但不是 STUDENT 角色（COMPANY/ADMIN）；code=2002、message=forbidden", + "content": { + "application/json": { + "examples": { + "forbidden": { + "description": "forbidden", + "value": { + "code": 2002, + "message": "forbidden", + "data": null, + "timestamp": "2026-08-24T10:00:00Z" + } + } } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] }, "put": { "tags": [ - "双向匹配阈值" + "个人资料" ], - "summary": "更新学生匹配阈值", - "description": "requiredHrScore 0-100；首次更新创建配置", - "operationId": "updateStudentRule", + "summary": "更新学生资料", + "description": "仅更新传入的非 null 字段；不存在则自动创建", + "operationId": "updateMyProfile", "requestBody": { "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/StudentMatchRuleRequest" + "$ref": "#/components/schemas/StudentProfileUpdateRequest" } } }, @@ -5118,51 +5020,41 @@ } } }, - "/profile/me/preferences": { + "/profile/me/candidate-percentile": { "get": { "tags": [ - "求职偏好" + "求职者评分卡" ], - "summary": "查询求职偏好", - "description": "仅 STUDENT；无记录时返回空偏好对象", - "operationId": "getPreferences", + "summary": "查询百分位", + "description": "仅 STUDENT；返回自己在候选人中的评分百分位", + "operationId": "getPercentile", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseCandidatePercentileResponse" } } } - } - } - }, - "put": { - "tags": [ - "求职偏好" - ], - "summary": "保存求职偏好", - "description": "仅 STUDENT；upsert，完全替换传入字段", - "operationId": "savePreferences", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/StudentPreferenceRequest" + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } } } }, - "required": true - }, - "responses": { - "200": { - "description": "OK", + "403": { + "description": "非 STUDENT 角色", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } @@ -5170,20 +5062,21 @@ } } }, - "/profile/me/privacy": { + "/profile/me/candidate-score-card": { "get": { "tags": [ - "privacy-settings-controller" + "求职者评分卡" ], - "operationId": "getMyPrivacySettings", - "parameters": [], + "summary": "查询求职者评分卡", + "description": "仅 STUDENT；返回自己的评价聚合卡", + "operationId": "getScoreCard", "responses": { "200": { - "description": "成功；无记录时返回默认对象（PRIVATE/contactVisible=false/version=0）", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponsePrivacySettingsResponse" + "$ref": "#/components/schemas/ApiResponseCandidateScoreCardResponse" } } } @@ -5209,39 +5102,46 @@ } } } - }, - "put": { + } + }, + "/profile/me/candidate-score-trend": { + "get": { "tags": [ - "privacy-settings-controller" + "求职者评分卡" ], - "operationId": "updateMyPrivacySettings", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PrivacySettingsUpdateRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "成功；返回更新后的隐私设置对象", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponsePrivacySettingsResponse" + "summary": "查询评分趋势", + "description": "仅 STUDENT；返回最近月份的反馈趋势", + "operationId": "getTrend_1", + "parameters": [ + { + "name": "months", + "in": "query", + "description": "统计月数，默认 6，范围 1-24", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 6 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCandidateScoreTrendResponse" } } } }, "400": { - "description": "请求体校验失败（缺少必填字段或非法枚举）", + "description": "参数不合法", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseCandidateScoreTrendResponse" } } } @@ -5265,13 +5165,25 @@ } } } - }, - "409": { - "description": "乐观锁版本冲突（9201）", + } + } + } + }, + "/profile/me/candidate-scoring": { + "get": { + "tags": [ + "求职者评分体系" + ], + "summary": "综合评分卡", + "description": "仅 STUDENT；返回本人 8 维评分、综合分、权重与状态", + "operationId": "getOverview", + "responses": { + "200": { + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseCandidateScoringOverviewResponse" } } } @@ -5279,22 +5191,51 @@ } } }, - "/profile/me/resume": { + "/profile/me/candidate-scoring/appeals": { "get": { "tags": [ - "个人资料" + "评分治理" + ], + "summary": "我的申诉列表", + "description": "仅 STUDENT 本人", + "operationId": "listMyAppeals", + "parameters": [ + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 + } + } ], - "summary": "下载简历", - "description": "下载当前学生上传的简历文件，仅 STUDENT 角色", - "operationId": "downloadResume", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "type": "string", - "format": "byte" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -5303,28 +5244,20 @@ }, "post": { "tags": [ - "个人资料" + "评分治理" ], - "summary": "上传简历", - "description": "仅 STUDENT 角色；PDF/DOC/DOCX，≤10MB；上传新简历时替换旧文件", - "operationId": "uploadResume", + "summary": "提交评分申诉", + "description": "仅 STUDENT 本人；同一学生+维度+周期 PENDING/APPROVED 唯一", + "operationId": "createAppeal", "requestBody": { "content": { - "multipart/form-data": { + "application/json": { "schema": { - "type": "object", - "properties": { - "file": { - "type": "string", - "format": "binary" - } - }, - "required": [ - "file" - ] + "$ref": "#/components/schemas/CreateAppealRequest" } } - } + }, + "required": true }, "responses": { "200": { @@ -5332,27 +5265,40 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseAppealResponse" } } } } } - }, - "delete": { + } + }, + "/profile/me/candidate-scoring/appeals/{appealId}": { + "get": { "tags": [ - "个人资料" + "评分治理" + ], + "summary": "申诉详情", + "description": "本人或 ADMIN", + "operationId": "getAppeal", + "parameters": [ + { + "name": "appealId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], - "summary": "删除简历", - "description": "删除当前学生的简历文件并清空 resumeUrl，仅 STUDENT 角色", - "operationId": "deleteResume", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseAppealResponse" } } } @@ -5360,69 +5306,64 @@ } } }, - "/profile/me/resume-versions": { - "get": { + "/profile/me/candidate-scoring/appeals/{appealId}/cancel": { + "post": { "tags": [ - "简历版本" + "评分治理" + ], + "summary": "撤销申诉", + "description": "仅本人；仅 PENDING 可撤销", + "operationId": "cancelAppeal", + "parameters": [ + { + "name": "appealId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } ], - "summary": "简历版本列表", - "description": "本人 ACTIVE 版本，version_no 倒序", - "operationId": "list", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListMapStringObject" + "$ref": "#/components/schemas/ApiResponseAppealResponse" } } } } } - }, - "post": { + } + }, + "/profile/me/candidate-scoring/dimensions/{dimension}": { + "get": { "tags": [ - "简历版本" + "求职者评分体系" ], - "summary": "创建简历版本", - "description": "仅本人(STUDENT)；PDF/DOC/DOCX ≤10MB；可附版本名", - "operationId": "create_1", + "summary": "单维度明细", + "description": "仅 STUDENT；返回某维度分项、归因与数据源；非法 dimension 返回 400", + "operationId": "getDimensionDetail", "parameters": [ { - "name": "name", - "in": "query", - "required": false, + "name": "dimension", + "in": "path", + "required": true, "schema": { "type": "string" } } ], - "requestBody": { - "content": { - "multipart/form-data": { - "schema": { - "type": "object", - "properties": { - "file": { - "type": "string", - "format": "binary" - } - }, - "required": [ - "file" - ] - } - } - } - }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseDimensionScoreDetailResponse" } } } @@ -5430,22 +5371,23 @@ } } }, - "/profile/me/resume-versions/{id}": { + "/profile/me/candidate-scoring/trend": { "get": { "tags": [ - "简历版本" + "求职者评分体系" ], - "summary": "简历版本详情", - "description": "仅本人可查看；他人 403，不存在 404", - "operationId": "get", + "summary": "评分趋势", + "description": "仅 STUDENT；基于快照按月返回综合分与维度分（months 1-24）", + "operationId": "getTrend", "parameters": [ { - "name": "id", - "in": "path", - "required": true, + "name": "months", + "in": "query", + "required": false, "schema": { "type": "integer", - "format": "int64" + "format": "int32", + "default": 6 } } ], @@ -5455,184 +5397,158 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseCandidateScoringTrendResponse" } } } } } - }, - "put": { + } + }, + "/profile/me/career-progress": { + "get": { "tags": [ - "简历版本" + "求职进度" ], - "summary": "修改简历版本", - "description": "本人；可选重命名 + 可选替换文件（替换时删除旧文件）", - "operationId": "update", + "summary": "统一求职进度聚合", + "description": "只读学生端接口：汇总当前学生的投递分页、岗位摘要、下一场面试、最近已提交结构化面试评分、可展示 Offer、同岗位竞争力排名，以及待办/通知计数（仅计数，不含通知标题/正文/详情）。仅 STUDENT 可访问，身份仅从 JWT/SecurityContext 获取，不接受 userId/studentUserId/candidateId 参数；COMPANY/ADMIN 返回 403/2002，未登录返回 401，参数非法返回 400/1001。通知详情仍由既有 /notifications 提供。", + "operationId": "getCareerProgress", "parameters": [ { - "name": "id", - "in": "path", - "required": true, + "name": "page", + "in": "query", + "required": false, "schema": { "type": "integer", - "format": "int64" + "format": "int32", + "default": 0 } }, { - "name": "name", + "name": "size", "in": "query", "required": false, "schema": { - "type": "string" + "type": "integer", + "format": "int32", + "default": 20 } - } - ], - "requestBody": { - "content": { - "multipart/form-data": { - "schema": { - "type": "object", - "properties": { - "file": { - "type": "string", - "format": "binary" - } - } - } + }, + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": [ + "SUBMITTED", + "VIEWED", + "INTERVIEW", + "HIRED", + "REJECTED", + "WITHDRAWN" + ] } } - }, + ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseCareerProgressResponse" } } } - } - } - }, - "delete": { - "tags": [ - "简历版本" - ], - "summary": "删除简历版本", - "description": "默认版本需先设其他默认；导出进行中不可删；删除文件并移除记录", - "operationId": "delete", - "parameters": [ - { - "name": "id", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "200": { - "description": "OK", + }, + "400": { + "description": "page/size/status 参数非法", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/profile/me/resume-versions/{id}/default": { - "post": { - "tags": [ - "简历版本" - ], - "summary": "设为默认简历", - "description": "同用户最多一个默认；已默认幂等；并发冲突 409", - "operationId": "setDefault", - "parameters": [ - { - "name": "id", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } } - } - ], - "responses": { - "200": { - "description": "OK", + }, + "403": { + "description": "非 STUDENT 角色", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponse" } } } } - } + }, + "security": [ + { + "bearerAuth": [] + } + ] } }, - "/profile/me/resume-versions/{id}/export": { - "post": { + "/profile/me/deletion": { + "get": { "tags": [ - "简历版本" - ], - "summary": "创建简历导出任务", - "description": "异步复制该版本文件到导出目录；返回任务状态", - "operationId": "createExportTask", - "parameters": [ - { - "name": "id", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } + "account-deletion-controller" ], + "operationId": "getStatus", + "parameters": [], "responses": { "200": { - "description": "OK", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" + } + } + } + }, + "401": { + "description": "error", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" } } } } } - } - }, - "/profile/me/review-weights": { - "get": { + }, + "post": { "tags": [ - "student-review-weight-controller" + "account-deletion-controller" ], - "operationId": "getMyWeights", + "operationId": "initiate", + "parameters": [], "responses": { "200": { - "description": "OK", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseReviewWeightResponse" + "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" } } } }, "401": { - "description": "未登录", + "description": "error", "content": { "*/*": { "schema": { @@ -5642,7 +5558,17 @@ } }, "403": { - "description": "非 STUDENT 角色", + "description": "error", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "error", "content": { "*/*": { "schema": { @@ -5652,35 +5578,28 @@ } } } - }, - "put": { + } + }, + "/profile/me/deletion/cancel": { + "post": { "tags": [ - "student-review-weight-controller" + "account-deletion-controller" ], - "operationId": "saveWeights", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SaveWeightRequest" - } - } - }, - "required": true - }, + "operationId": "cancelAccountDeletion", + "parameters": [], "responses": { "200": { - "description": "OK", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseReviewWeightResponse" + "$ref": "#/components/schemas/ApiResponseAccountDeletionResponse" } } } }, "401": { - "description": "未登录", + "description": "error", "content": { "*/*": { "schema": { @@ -5690,7 +5609,17 @@ } }, "403": { - "description": "非 STUDENT 角色", + "description": "error", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "error", "content": { "*/*": { "schema": { @@ -5702,92 +5631,75 @@ } } }, - "/resume-export-tasks/{taskId}": { + "/profile/me/data-export-tasks": { "get": { "tags": [ - "简历版本" + "personal-data-export-controller" ], - "summary": "导出任务状态", - "description": "仅本人可查询；SUCCESS 含输出文件，FAILED 含失败原因", - "operationId": "getExportTask", + "summary": "查询个人数据导出任务列表", + "description": "仅本人；按创建时间倒序分页；status 可选：PENDING/PROCESSING/COMPLETED/FAILED/EXPIRED/CANCELLED", + "operationId": "listDataExportTasks", "parameters": [ { - "name": "taskId", - "in": "path", - "required": true, + "name": "page", + "in": "query", + "required": false, "schema": { "type": "integer", - "format": "int64" + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 20 + } + }, + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string" } } ], "responses": { "200": { - "description": "OK", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseMapStringObject" + "$ref": "#/components/schemas/ApiResponsePageResponseDataExportTaskResponse" } } } - } - } - } - }, - "/resume-export-tasks/{taskId}/download": { - "get": { - "tags": [ - "简历版本" - ], - "summary": "下载导出产物", - "description": "仅本人且任务 SUCCESS 可下载；attachment；不暴露内部路径", - "operationId": "downloadExportTask", - "parameters": [ - { - "name": "taskId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "200": { - "description": "OK", + }, + "401": { + "description": "error", "content": { "*/*": { "schema": { - "type": "string", - "format": "byte" + "$ref": "#/components/schemas/ApiResponse" } } } - } - } - } - }, - "/review-weight-templates": { - "get": { - "tags": [ - "student-review-weight-controller" - ], - "operationId": "getTemplates", - "responses": { - "200": { - "description": "OK", + }, + "403": { + "description": "error", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListWeightTemplateResponse" + "$ref": "#/components/schemas/ApiResponse" } } } }, - "401": { - "description": "未登录", + "409": { + "description": "error", "content": { "*/*": { "schema": { @@ -5797,36 +5709,24 @@ } } } - } - }, - "/interviews/{interviewId}/score": { - "put": { + }, + "post": { "tags": [ - "结构化面试评分" - ], - "summary": "保存评分草稿", - "description": "企业 owner 为已完成的面试保存/更新草稿；草稿阶段五个维度可为空；overallScore 由服务端计算；SUBMITTED 后再次 PUT 返回 409/9503", - "operationId": "saveInterviewScore", - "parameters": [ - { - "name": "interviewId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } + "personal-data-export-controller" ], + "summary": "创建个人数据导出任务", + "description": "异步生成 ZIP；同 idempotencyKey 重放返回原任务；注销 PENDING/COMPLETED 禁止创建", + "operationId": "createDataExportTask", + "parameters": [], "requestBody": { "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/InterviewScoreSaveRequest" + "$ref": "#/components/schemas/CreateDataExportRequest" } } }, - "required": true + "required": false }, "responses": { "200": { @@ -5834,23 +5734,13 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" - } - } - } - }, - "400": { - "description": "非法维度或推荐值", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseDataExportTaskResponse" } } } }, "401": { - "description": "未登录", + "description": "error", "content": { "*/*": { "schema": { @@ -5860,17 +5750,7 @@ } }, "403": { - "description": "非企业/跨企业/非岗位 owner", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "404": { - "description": "面试不存在 8401", + "description": "error", "content": { "*/*": { "schema": { @@ -5880,7 +5760,7 @@ } }, "409": { - "description": "未完成 9502 / 已提交 9503 / 并发冲突 9501", + "description": "error", "content": { "*/*": { "schema": { @@ -5890,17 +5770,19 @@ } } } - }, + } + }, + "/profile/me/data-export-tasks/{taskId}": { "get": { "tags": [ - "结构化面试评分" + "personal-data-export-controller" ], - "summary": "查看评分", - "description": "企业 owner 可看 DRAFT/SUBMITTED；目标学生仅可看 SUBMITTED；无评分返回 404/9504", - "operationId": "getInterviewScore", + "summary": "查询个人数据导出任务详情", + "description": "仅本人；不暴露 storageKey 与内部字段", + "operationId": "getDataExportTask", "parameters": [ { - "name": "interviewId", + "name": "taskId", "in": "path", "required": true, "schema": { @@ -5915,23 +5797,13 @@ "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" - } - } - } - }, - "400": { - "description": "请求体校验失败", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseDataExportTaskResponse" } } } }, "401": { - "description": "未登录", + "description": "error", "content": { "*/*": { "schema": { @@ -5941,7 +5813,7 @@ } }, "403": { - "description": "非目标学生 / 跨企业 / 非岗位 owner / ADMIN", + "description": "error", "content": { "*/*": { "schema": { @@ -5951,17 +5823,7 @@ } }, "404": { - "description": "无评分 9504 / 面试不存在 8401", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "409": { - "description": "未完成 9502", + "description": "error", "content": { "*/*": { "schema": { @@ -5973,17 +5835,17 @@ } } }, - "/interviews/{interviewId}/score/submit": { - "post": { + "/profile/me/data-export-tasks/{taskId}/download": { + "get": { "tags": [ - "结构化面试评分" + "personal-data-export-controller" ], - "summary": "提交评分", - "description": "将 DRAFT 提交为 SUBMITTED，提交后不可逆；并发冲突 409；重复提交幂等返回原评分", - "operationId": "submitInterviewScore", + "summary": "下载个人数据导出 ZIP", + "description": "仅本人且 COMPLETED 未过期；attachment；需 JWT", + "operationId": "downloadDataExportTask", "parameters": [ { - "name": "interviewId", + "name": "taskId", "in": "path", "required": true, "schema": { @@ -5996,25 +5858,16 @@ "200": { "description": "success", "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" - } - } - } - }, - "400": { - "description": "缺维度 1001", - "content": { - "*/*": { + "application/zip": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "type": "string", + "format": "binary" } } } }, "401": { - "description": "未登录", + "description": "error", "content": { "*/*": { "schema": { @@ -6024,17 +5877,7 @@ } }, "403": { - "description": "非企业/跨企业/非岗位 owner", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "404": { - "description": "面试不存在 8401", + "description": "error", "content": { "*/*": { "schema": { @@ -6044,7 +5887,7 @@ } }, "409": { - "description": "未完成 9502 / 并发冲突 9501", + "description": "error", "content": { "*/*": { "schema": { @@ -6056,691 +5899,293 @@ } } }, - "/interviews/{interviewId}/score/history": { + "/profile/me/match-rule": { "get": { "tags": [ - "结构化面试评分" - ], - "summary": "评分历史", - "description": "企业 owner 可查看全部历史；目标学生仅在 SUBMITTED 后可见；无历史返回 200 空数组；不返回内部用户标识", - "operationId": "getInterviewScoreHistory", - "parameters": [ - { - "name": "interviewId", - "in": "path", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } + "双向匹配阈值" ], + "summary": "查询学生匹配阈值", + "description": "未配置返回默认 60", + "operationId": "getStudentRule", "responses": { "200": { - "description": "success", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListInterviewScoreHistoryItem" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } + } + } + }, + "put": { + "tags": [ + "双向匹配阈值" + ], + "summary": "更新学生匹配阈值", + "description": "requiredHrScore 0-100；首次更新创建配置", + "operationId": "updateStudentRule", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/StudentMatchRuleRequest" + } + } }, - "401": { - "description": "未登录", + "required": true + }, + "responses": { + "200": { + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "403": { - "description": "非目标学生 / 跨企业 / 非岗位 owner / ADMIN", + } + } + } + }, + "/profile/me/preferences": { + "get": { + "tags": [ + "求职偏好" + ], + "summary": "查询求职偏好", + "description": "仅 STUDENT；无记录时返回空偏好对象", + "operationId": "getPreferences", + "responses": { + "200": { + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "404": { - "description": "面试不存在 8401", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - } - } - } - }, - "409": { - "description": "未完成 9502", - "content": { - "*/*": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } } } - } - }, - "/reports": { - "post": { - "tags": ["举报与屏蔽"], - "summary": "提交举报", - "description": "targetType=USER 必填 targetUserId；MESSAGE 必填 messageId；reportedUserId 由服务端推导。同 reporter+idempotencyKey+相同请求体返回原举报 200；不同请求体 409/9606；同目标同分类已有 PENDING 409/9603。限流：每用户每小时 10 次，超限 429/9609。", - "operationId": "createReport", - "security": [{ "bearerAuth": [] }], - "requestBody": { - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/CreateReportRequest" } - } - }, - "required": true - }, - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseReportResponse" } } } }, - "400": { "description": "BAD_REQUEST(1001)/举报自己 9602/理由缺失 9607", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "无权访问消息（2002，不泄露消息是否存在）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "409": { "description": "重复举报 9603 / 幂等冲突 9606", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "429": { "description": "频率超限 9609", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/reports/me": { - "get": { - "tags": ["举报与屏蔽"], - "summary": "我的举报列表", - "description": "仅返回当前用户创建的举报；身份来自 JWT；不返回举报人内部信息/phone/email/passwordHash/resumeUrl/消息全文；支持 status/page/size。", - "operationId": "listMyReports", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, - { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } }, - { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponsePageResponseReportResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/reports/{id}": { - "get": { - "tags": ["举报与屏蔽"], - "summary": "举报详情（本人/ADMIN）", - "description": "当前举报人本人或 ADMIN 可查看；其他 403/2002；非 ADMIN 不显示举报人内部 ID/手机号/邮箱；MESSAGE 仅返回脱敏 messagePreview。", - "operationId": "getReportDetail", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseReportResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "非本人非 ADMIN（2002）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "404": { "description": "举报不存在（9601）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/blocks/{blockedUserId}": { - "put": { - "tags": ["举报与屏蔽"], - "summary": "屏蔽用户", - "description": "屏蔽自己 400/9608；目标不存在复用用户不存在错误码；已存在返回 200 不新增；不影响系统通知/投递/Offer/面试/评分/评价。", - "operationId": "blockUser", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "blockedUserId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseBlockRelationResponse" } } } }, - "400": { "description": "屏蔽自己 9608", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } }, - "delete": { - "tags": ["举报与屏蔽"], - "summary": "解除屏蔽", - "description": "幂等：不存在时返回 200 不报错。", - "operationId": "unblockUser", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "blockedUserId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } - ], - "responses": { - "200": { "description": "OK（幂等）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/blocks/me": { - "get": { - "tags": ["举报与屏蔽"], - "summary": "我的屏蔽列表", - "description": "仅返回当前用户主动屏蔽的用户；不返回对方手机号/邮箱/密码/简历地址；支持 page/size。", - "operationId": "listMyBlocks", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } }, - { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponsePageResponseBlockRelationResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/admin/reports": { - "get": { - "tags": ["举报管理"], - "summary": "举报列表（ADMIN）", - "description": "仅 ADMIN；COMPANY/STUDENT/未登录分别 403/403/401；支持 status/targetType/category/page/size；响应脱敏。", - "operationId": "adminListReports", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, - { "name": "targetType", "in": "query", "required": false, "schema": { "type": "string" } }, - { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, - { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } }, - { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponsePageResponseReportResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "非 ADMIN", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/admin/reports/{id}": { - "get": { - "tags": ["举报管理"], - "summary": "举报详情（ADMIN）", - "description": "仅 ADMIN；可见类型/分类/理由/脱敏证据 URL/MESSAGE 脱敏内容/会话最小信息/处理历史；不返回密码/JWT/手机号/邮箱/resumeUrl。", - "operationId": "adminGetReport", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } - ], - "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseReportResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "非 ADMIN", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "404": { "description": "举报不存在（9601）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } - } - } - }, - "/admin/reports/{id}/decision": { - "post": { - "tags": ["举报管理"], - "summary": "举报处理决定（ADMIN）", - "description": "仅 ADMIN；decision 仅 RESOLVED/REJECTED；REJECTED 必填 note；仅 PENDING 可处理，重复 409/9604，非法流转 409/9605；处理后发送一条 REPORT_DECISION 通知。", - "operationId": "decideReport", - "security": [{ "bearerAuth": [] }], - "parameters": [ - { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } + "put": { + "tags": [ + "求职偏好" ], + "summary": "保存求职偏好", + "description": "仅 STUDENT；upsert，完全替换传入字段", + "operationId": "savePreferences", "requestBody": { "content": { "application/json": { - "schema": { "$ref": "#/components/schemas/ReportDecisionRequest" } + "schema": { + "$ref": "#/components/schemas/StudentPreferenceRequest" + } } }, "required": true }, "responses": { - "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponseReportResponse" } } } }, - "400": { "description": "参数错误（REJECTED 缺 note）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "401": { "description": "未登录", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "403": { "description": "非 ADMIN", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "404": { "description": "举报不存在（9601）", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } }, - "409": { "description": "重复决定 9604 / 非法流转 9605", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" } } } } + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseMapStringObject" + } + } + } + } } } }, - "/skills/word-cloud": { + "/profile/me/privacy": { "get": { "tags": [ - "行业技能词云" - ], - "summary": "查询行业技能词云", - "description": "返回筛选范围内的全部技能，按 heat DESC, nameZh ASC, skillId ASC 排序，heat=null 最后；前端取前十条作为 TOP10。仅 STUDENT 可访问。", - "operationId": "getWordCloud", - "security": [ - { - "bearerAuth": [] - } - ], - "parameters": [ - { - "name": "industryId", - "in": "query", - "required": true, - "description": "行业 ID，必填正整数", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 1 - } - }, - { - "name": "occupationId", - "in": "query", - "required": true, - "description": "职位 ID，必填正整数；必须属于该行业", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 2 - } - }, - { - "name": "categoryId", - "in": "query", - "required": false, - "description": "技能分类 ID，可选正整数；省略时返回该职位下全部分类", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 101 - } - } + "privacy-settings-controller" ], + "operationId": "getMyPrivacySettings", + "parameters": [], "responses": { "200": { - "description": "成功返回筛选范围内的完整技能列表", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponseSkillCloudResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "industry": { - "id": 1, - "code": "INTERNET", - "name": "互联网" - }, - "occupation": { - "id": 1, - "code": "FRONTEND_DEVELOPER", - "name": "前端开发工程师" - }, - "category": null, - "total": 1, - "items": [ - { - "rank": 1, - "skillId": 26, - "skillCode": "REACT", - "nameZh": "React", - "nameEn": "React", - "sourceType": "O*NET", - "sourceCode": "15-1254.00|React|2.E.7.h", - "categoryId": 103, - "categoryName": "前端框架", - "heat": 4.38, - "heatSourceCode": "15-1254.00", - "heatElementId": "2.E.7.h", - "heatProxy": true - } - ] - }, - "requestId": "req-word-cloud", - "timestamp": "2026-09-15T10:00:00Z" - } - } - } - }, - "400": { - "description": "筛选参数缺失、非正整数或节点关系非法", + "description": "成功；无记录时返回默认对象（PRIVATE/contactVisible=false/version=0）", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-15T10:03:00Z" + "$ref": "#/components/schemas/ApiResponsePrivacySettingsResponse" } } } }, "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } }, "403": { - "description": "已登录但不是 STUDENT 角色", + "description": "非 STUDENT 角色", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-15T10:03:00Z" } } } } } - } - }, - "/skills/match": { - "get": { + }, + "put": { "tags": [ - "行业技能词云" - ], - "summary": "查询个人技能匹配度", - "description": "使用 JWT 对应学生的 skills_json，与当前筛选结果 TOP10 比对；matchScore=round(matchedCount*100/min(10,total))。仅 STUDENT 可访问。", - "operationId": "getSkillMatch", - "security": [ - { - "bearerAuth": [] - } + "privacy-settings-controller" ], - "parameters": [ - { - "name": "industryId", - "in": "query", - "required": true, - "description": "行业 ID，必填正整数", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 1 - } - }, - { - "name": "occupationId", - "in": "query", - "required": true, - "description": "职位 ID，必填正整数；必须属于该行业", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 2 + "operationId": "updateMyPrivacySettings", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PrivacySettingsUpdateRequest" + } } }, - { - "name": "categoryId", - "in": "query", - "required": false, - "description": "技能分类 ID，可选正整数；省略时使用该职位下全部技能", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 101 - } - } - ], + "required": true + }, "responses": { "200": { - "description": "成功返回个人技能匹配结果", + "description": "成功；返回更新后的隐私设置对象", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseSkillMatchResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "matchScore": 50, - "matchedCount": 1, - "totalCount": 2, - "matchedSkills": [ - { - "rank": 1, - "skillId": 26, - "skillCode": "REACT", - "nameZh": "React", - "nameEn": "React", - "sourceType": "O*NET", - "sourceCode": "15-1254.00|React|2.E.7.h", - "categoryId": 103, - "categoryName": "前端框架", - "heat": 4.38, - "heatSourceCode": "15-1254.00", - "heatElementId": "2.E.7.h", - "heatProxy": true - } - ], - "missingSkills": [ - { - "rank": 2, - "skillId": 31, - "skillCode": "DOCKER", - "nameZh": "Docker", - "nameEn": "Docker", - "sourceType": "O*NET", - "sourceCode": "15-1299.08|Docker|2.E.7.h", - "categoryId": 105, - "categoryName": "工程化工具", - "heat": 4.12, - "heatSourceCode": "15-1299.08", - "heatElementId": "2.E.7.h", - "heatProxy": true - } - ] - }, - "requestId": "req-match", - "timestamp": "2026-09-15T10:01:00Z" + "$ref": "#/components/schemas/ApiResponsePrivacySettingsResponse" } } } }, "400": { - "description": "筛选参数缺失、非正整数或节点关系非法", + "description": "请求体校验失败（缺少必填字段或非法枚举）", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-15T10:03:00Z" } } } }, "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } }, "403": { - "description": "已登录但不是 STUDENT 角色", + "description": "非 STUDENT 角色", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-15T10:03:00Z" } } } - } + }, + "409": { + "description": "乐观锁版本冲突（9201）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } } } }, - "/skills/learning-path": { + "/profile/me/resume": { "get": { "tags": [ - "行业技能词云" - ], - "summary": "生成个人学习路径", - "description": "只针对个人 TOP10 中未命中的技能，沿用热度顺序返回连续 priority 和确定性通用建议；不调用 AI，不返回课程链接、时长或进度。仅 STUDENT 可访问。", - "operationId": "getLearningPath", - "security": [ - { - "bearerAuth": [] - } - ], - "parameters": [ - { - "name": "industryId", - "in": "query", - "required": true, - "description": "行业 ID，必填正整数", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 1 - } - }, - { - "name": "occupationId", - "in": "query", - "required": true, - "description": "职位 ID，必填正整数；必须属于该行业", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 2 - } - }, - { - "name": "categoryId", - "in": "query", - "required": false, - "description": "技能分类 ID，可选正整数；省略时使用该职位下全部技能", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1, - "example": 101 - } - } + "个人资料" ], + "summary": "下载简历", + "description": "下载当前学生上传的简历文件，仅 STUDENT 角色", + "operationId": "downloadResume", "responses": { "200": { - "description": "成功返回缺失技能的学习路径；没有缺口时列表为空", + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseSkillLearningPathResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "total": 1, - "items": [ - { - "priority": 1, - "skillId": 26, - "skillName": "React", - "categoryId": 103, - "categoryName": "前端框架", - "suggestion": "先理解 React 的核心概念与生命周期，再通过一个小型项目练习集成。" - } - ] - }, - "requestId": "req-learning-path", - "timestamp": "2026-09-15T10:02:00Z" + "type": "string", + "format": "byte" } } } - }, - "400": { - "description": "筛选参数缺失、非正整数或节点关系非法", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" + } + } + }, + "post": { + "tags": [ + "个人资料" + ], + "summary": "上传简历", + "description": "仅 STUDENT 角色；PDF/DOC/DOCX，≤10MB；上传新简历时替换旧文件", + "operationId": "uploadResume", + "requestBody": { + "content": { + "multipart/form-data": { + "schema": { + "type": "object", + "properties": { + "file": { + "type": "string", + "format": "binary" + } }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-15T10:03:00Z" - } + "required": [ + "file" + ] } } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + } + }, + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "403": { - "description": "已登录但不是 STUDENT 角色", + } + } + }, + "delete": { + "tags": [ + "个人资料" + ], + "summary": "删除简历", + "description": "删除当前学生的简历文件并清空 resumeUrl，仅 STUDENT 角色", + "operationId": "deleteResume", + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-15T10:03:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -6748,96 +6193,21 @@ } } }, - "/onboarding/company/checklist-items": { + "/profile/me/resume-versions": { "get": { "tags": [ - "入职清单" - ], - "summary": "查询本企业自定义清单项", - "description": "返回当前 COMPANY 所属企业的活动与软删除自定义项，不包含通用项和其他企业项。", - "operationId": "listCompanyChecklistItems", - "security": [ - { - "bearerAuth": [] - } + "简历版本" ], - "parameters": [], + "summary": "简历版本列表", + "description": "本人 ACTIVE 版本，version_no 倒序", + "operationId": "list", "responses": { "200": { - "description": "查询成功；无自定义项时返回空数组", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseListCompanyChecklistItemView" - }, - "example": { - "code": 200, - "message": "ok", - "data": [ - { - "itemId": 501, - "source": "COMPANY", - "itemKey": "company-10-8f1c", - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "required": false, - "sortOrder": 1000, - "active": true, - "version": 0 - } - ], - "requestId": "req-onboarding-company-items", - "timestamp": "2026-09-17T01:32:00Z" - } - } - } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" - } - } - } - }, - "403": { - "description": "仅 COMPANY 角色可访问", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" - } - } - } - }, - "404": { - "description": "当前账号没有所属企业", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseListMapStringObject" } } } @@ -6846,143 +6216,46 @@ }, "post": { "tags": [ - "入职清单" + "简历版本" ], - "summary": "创建本企业自定义清单项", - "description": "为当前 COMPANY 所属企业创建自定义项；idempotencyKey 用于网络重试，活动项累计不超过 50 条。", - "operationId": "createCompanyChecklistItem", - "security": [ + "summary": "创建简历版本", + "description": "仅本人(STUDENT)；PDF/DOC/DOCX ≤10MB；可附版本名", + "operationId": "create_1", + "parameters": [ { - "bearerAuth": [] + "name": "name", + "in": "query", + "required": false, + "schema": { + "type": "string" + } } ], - "parameters": [], "requestBody": { - "required": true, "content": { - "application/json": { + "multipart/form-data": { "schema": { - "$ref": "#/components/schemas/CompanyChecklistItemCreateRequest" - }, - "example": { - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "sortOrder": 1000, - "required": false, - "idempotencyKey": "company-10-access-card-20260917" + "type": "object", + "properties": { + "file": { + "type": "string", + "format": "binary" + } + }, + "required": [ + "file" + ] } } } }, "responses": { "200": { - "description": "创建成功；相同幂等请求返回首次创建的条目", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyChecklistItemView" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "itemId": 501, - "source": "COMPANY", - "itemKey": "company-10-8f1c", - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "required": false, - "sortOrder": 1000, - "active": true, - "version": 0 - }, - "requestId": "req-onboarding-company-item", - "timestamp": "2026-09-17T01:32:00Z" - } - } - } - }, - "400": { - "description": "标题、分类、排序、必填标记或幂等键不符合约束", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" - } - } - } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" - } - } - } - }, - "403": { - "description": "仅 COMPANY 角色可访问", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" - } - } - } - }, - "404": { - "description": "当前账号没有所属企业", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" - } - } - } - }, - "409": { - "description": "活动自定义项已达到 50 条；或 9704 幂等键已用于不同请求体", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9703, - "message": "onboarding checklist item limit exceeded", - "data": null, - "requestId": "req-9703", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -6990,159 +6263,86 @@ } } }, - "/onboarding/company/checklist-items/{itemId}": { - "put": { + "/profile/me/resume-versions/{id}": { + "get": { "tags": [ - "入职清单" - ], - "summary": "更新本企业自定义清单项", - "description": "使用当前 version 更新本企业条目；版本过期返回 9702，不静默覆盖。", - "operationId": "updateCompanyChecklistItem", - "security": [ - { - "bearerAuth": [] - } + "简历版本" ], + "summary": "简历版本详情", + "description": "仅本人可查看；他人 403，不存在 404", + "operationId": "get", "parameters": [ { - "name": "itemId", + "name": "id", "in": "path", "required": true, - "description": "企业自定义清单项 ID", "schema": { "type": "integer", - "format": "int64", - "minimum": 1 + "format": "int64" } } ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CompanyChecklistItemUpdateRequest" - }, - "example": { - "title": "领取门禁卡并激活", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "sortOrder": 900, - "required": true, - "active": true, - "version": 0 - } - } - } - }, "responses": { "200": { - "description": "更新成功并递增 version", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyChecklistItemView" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "itemId": 501, - "source": "COMPANY", - "itemKey": "company-10-8f1c", - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "required": false, - "sortOrder": 1000, - "active": true, - "version": 0 - }, - "requestId": "req-onboarding-company-item", - "timestamp": "2026-09-17T01:32:00Z" - } - } - } - }, - "400": { - "description": "参数或请求体验证失败", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" - } - } + } + } + }, + "put": { + "tags": [ + "简历版本" + ], + "summary": "修改简历版本", + "description": "本人；可选重命名 + 可选替换文件（替换时删除旧文件）", + "operationId": "update", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" } }, - "403": { - "description": "仅 COMPANY 角色可访问", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" - } - } + { + "name": "name", + "in": "query", + "required": false, + "schema": { + "type": "string" } - }, - "404": { - "description": "条目不存在、已不属于该企业，或不属于该企业的有效清单", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9701, - "message": "onboarding checklist item not found", - "data": null, - "requestId": "req-9701", - "timestamp": "2026-09-17T01:30:00Z" + } + ], + "requestBody": { + "content": { + "multipart/form-data": { + "schema": { + "type": "object", + "properties": { + "file": { + "type": "string", + "format": "binary" + } } } } - }, - "409": { - "description": "请求 version 已过期", + } + }, + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9702, - "message": "onboarding checklist item was modified concurrently", - "data": null, - "requestId": "req-9702", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -7151,148 +6351,62 @@ }, "delete": { "tags": [ - "入职清单" - ], - "summary": "软删除本企业自定义清单项", - "description": "使用当前 version 将 active 置为 false；重复删除保持幂等成功。", - "operationId": "deleteCompanyChecklistItem", - "security": [ - { - "bearerAuth": [] - } + "简历版本" ], + "summary": "删除简历版本", + "description": "默认版本需先设其他默认；导出进行中不可删；删除文件并移除记录", + "operationId": "delete", "parameters": [ { - "name": "itemId", + "name": "id", "in": "path", "required": true, - "description": "企业自定义清单项 ID", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1 - } - }, - { - "name": "version", - "in": "query", - "required": true, - "description": "客户端最后读取到的条目版本", "schema": { "type": "integer", - "format": "int64", - "minimum": 0 + "format": "int64" } } ], "responses": { "200": { - "description": "软删除成功；重复删除返回当前非活动条目", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyChecklistItemView" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "itemId": 501, - "source": "COMPANY", - "itemKey": "company-10-8f1c", - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "required": false, - "sortOrder": 1000, - "active": false, - "version": 1 - }, - "requestId": "req-onboarding-company-item", - "timestamp": "2026-09-17T01:32:00Z" - } - } - } - }, - "400": { - "description": "缺少 version 或参数类型不正确", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" - } - } - } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" - } - } - } - }, - "403": { - "description": "仅 COMPANY 角色可访问", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "404": { - "description": "条目不存在、已不属于该企业，或不属于该企业的有效清单", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9701, - "message": "onboarding checklist item not found", - "data": null, - "requestId": "req-9701", - "timestamp": "2026-09-17T01:30:00Z" - } - } + } + } + } + }, + "/profile/me/resume-versions/{id}/default": { + "post": { + "tags": [ + "简历版本" + ], + "summary": "设为默认简历", + "description": "同用户最多一个默认；已默认幂等；并发冲突 409", + "operationId": "setDefault", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" } - }, - "409": { - "description": "请求 version 已过期", + } + ], + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9702, - "message": "onboarding checklist item was modified concurrently", - "data": null, - "requestId": "req-9702", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } @@ -7300,90 +6414,72 @@ } } }, - "/onboarding/company/knowledge": { - "get": { + "/profile/me/resume-versions/{id}/export": { + "post": { "tags": [ - "公司知识介绍" + "简历版本" ], - "summary": "读取本企业知识配置", - "description": "返回当前 COMPANY 所属企业的知识配置；尚未配置时 configured=false、version=0。", - "operationId": "getCompanyKnowledge", - "security": [ + "summary": "创建简历导出任务", + "description": "异步复制该版本文件到导出目录；返回任务状态", + "operationId": "createExportTask", + "parameters": [ { - "bearerAuth": [] + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } } ], - "parameters": [], "responses": { "200": { - "description": "查询成功", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyKnowledgeView" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "configured": true, - "culture": "以用户价值为中心，保持透明和长期主义。", - "workPolicies": "弹性上班；每周一、三线下办公。", - "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。", - "updatedAt": "2026-09-17T01:33:00Z", - "version": 2 - }, - "requestId": "req-company-knowledge", - "timestamp": "2026-09-17T01:33:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + } + } + } + }, + "/profile/me/review-weights": { + "get": { + "tags": [ + "student-review-weight-controller" + ], + "operationId": "getMyWeights", + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponseReviewWeightResponse" } } } }, - "403": { - "description": "仅 COMPANY 角色可访问", + "401": { + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" } } } }, - "404": { - "description": "当前账号没有所属企业", + "403": { + "description": "非 STUDENT 角色", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" } } } @@ -7392,137 +6488,143 @@ }, "put": { "tags": [ - "公司知识介绍" - ], - "summary": "创建或更新本企业知识配置", - "description": "首次创建可省略 version；已有配置必须提交当前 version。字段按纯文本保存且禁止 HTML 标签。", - "operationId": "upsertCompanyKnowledge", - "security": [ - { - "bearerAuth": [] - } + "student-review-weight-controller" ], - "parameters": [], + "operationId": "saveWeights", "requestBody": { - "required": true, "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/CompanyKnowledgeUpdateRequest" - }, - "example": { - "culture": "以用户价值为中心，保持透明和长期主义。", - "workPolicies": "弹性上班；每周一、三线下办公。", - "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。", - "version": 1 + "$ref": "#/components/schemas/SaveWeightRequest" } } - } + }, + "required": true }, "responses": { "200": { - "description": "创建或更新成功", + "description": "OK", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyKnowledgeView" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "configured": true, - "culture": "以用户价值为中心，保持透明和长期主义。", - "workPolicies": "弹性上班；每周一、三线下办公。", - "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。", - "updatedAt": "2026-09-17T01:33:00Z", - "version": 2 - }, - "requestId": "req-company-knowledge", - "timestamp": "2026-09-17T01:33:00Z" + "$ref": "#/components/schemas/ApiResponseReviewWeightResponse" } } } }, - "400": { - "description": "内容为空、超长、包含 HTML 标签，或已有配置缺少 version", + "401": { + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" } } } }, - "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "403": { + "description": "非 STUDENT 角色", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } - }, - "403": { - "description": "仅 COMPANY 角色可访问", + } + } + } + }, + "/resume-export-tasks/{taskId}": { + "get": { + "tags": [ + "简历版本" + ], + "summary": "导出任务状态", + "description": "仅本人可查询；SUCCESS 含输出文件，FAILED 含失败原因", + "operationId": "getExportTask", + "parameters": [ + { + "name": "taskId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseMapStringObject" } } } - }, - "404": { - "description": "当前账号没有所属企业", + } + } + } + }, + "/resume-export-tasks/{taskId}/download": { + "get": { + "tags": [ + "简历版本" + ], + "summary": "下载导出产物", + "description": "仅本人且任务 SUCCESS 可下载；attachment；不暴露内部路径", + "operationId": "downloadExportTask", + "parameters": [ + { + "name": "taskId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" + "type": "string", + "format": "byte" + } + } + } + } + } + } + }, + "/review-weight-templates": { + "get": { + "tags": [ + "student-review-weight-controller" + ], + "operationId": "getTemplates", + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseListWeightTemplateResponse" } } } }, - "409": { - "description": "知识配置版本已过期", + "401": { + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9706, - "message": "company knowledge was modified concurrently", - "data": null, - "requestId": "req-9706", - "timestamp": "2026-09-17T01:30:00Z" } } } @@ -7530,312 +6632,173 @@ } } }, - "/onboarding/companies/{companyId}/checklist": { - "get": { + "/interviews/{interviewId}/score": { + "put": { "tags": [ - "入职清单" - ], - "summary": "读取有效入职清单", - "description": "STUDENT 读取通用活动项与当前企业活动自定义项的合并清单；无企业自定义项时回退通用清单。", - "operationId": "getEffectiveChecklist", - "security": [ - { - "bearerAuth": [] - } + "结构化面试评分" ], + "summary": "保存评分草稿", + "description": "企业 owner 为已完成的面试保存/更新草稿；草稿阶段五个维度可为空；overallScore 由服务端计算；SUBMITTED 后再次 PUT 返回 409/9503", + "operationId": "saveInterviewScore", "parameters": [ { - "name": "companyId", + "name": "interviewId", "in": "path", "required": true, - "description": "企业 ID", "schema": { "type": "integer", - "format": "int64", - "minimum": 1 + "format": "int64" } } ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/InterviewScoreSaveRequest" + } + } + }, + "required": true + }, "responses": { "200": { - "description": "查询成功", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseEffectiveChecklistResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "companyId": 10, - "companyName": "示例科技", - "customized": true, - "totalItems": 13, - "completedItems": 1, - "completionRate": 7.7, - "items": [ - { - "itemId": 101, - "source": "STANDARD", - "itemKey": "standard-id-card", - "title": "准备身份证件", - "description": "准备身份证原件或有效身份证明，用于入职登记。", - "category": "DOCUMENT", - "required": true, - "sortOrder": 100, - "active": true, - "completed": true, - "completedAt": "2026-09-17T09:00:00", - "progressVersion": 1 - }, - { - "itemId": 501, - "source": "COMPANY", - "itemKey": "company-10-8f1c", - "title": "领取门禁卡", - "description": "到行政前台领取门禁卡并完成权限激活。", - "category": "ADMIN", - "required": false, - "sortOrder": 1000, - "active": true, - "completed": false, - "completedAt": null, - "progressVersion": 0 - } - ] - }, - "requestId": "req-onboarding-checklist", - "timestamp": "2026-09-17T01:30:00Z" + "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" } } } }, "400": { - "description": "companyId 不是正整数", + "description": "非法维度或推荐值", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } }, "403": { - "description": "仅 STUDENT 角色可访问", + "description": "非企业/跨企业/非岗位 owner", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "404": { - "description": "企业不存在", + "description": "面试不存在 8401", "content": { - "application/json": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "未完成 9502 / 已提交 9503 / 并发冲突 9501", + "content": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" } } } } } - } - }, - "/onboarding/companies/{companyId}/checklist/items/{itemId}/completion": { - "put": { + }, + "get": { "tags": [ - "入职清单" - ], - "summary": "更新清单条目完成状态", - "description": "STUDENT 使用绝对 completed 状态更新本人进度；已有进度变化时必须提交当前 version，首次创建只接受 version=0 或空。", - "operationId": "updateCompletion", - "security": [ - { - "bearerAuth": [] - } + "结构化面试评分" ], + "summary": "查看评分", + "description": "企业 owner 可看 DRAFT/SUBMITTED；目标学生仅可看 SUBMITTED；无评分返回 404/9504", + "operationId": "getInterviewScore", "parameters": [ { - "name": "companyId", - "in": "path", - "required": true, - "description": "企业 ID", - "schema": { - "type": "integer", - "format": "int64", - "minimum": 1 - } - }, - { - "name": "itemId", + "name": "interviewId", "in": "path", "required": true, - "description": "有效清单条目 ID", "schema": { "type": "integer", - "format": "int64", - "minimum": 1 + "format": "int64" } } ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ProgressUpdateRequest" - }, - "example": { - "completed": true, - "version": 0 - } - } - } - }, "responses": { "200": { - "description": "更新成功；重复提交相同状态返回幂等结果", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseProgressUpdateResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "itemId": 501, - "completed": true, - "completedAt": "2026-09-17T01:31:00Z", - "progressVersion": 1, - "totalItems": 13, - "completedItems": 2, - "completionRate": 15.4 - }, - "requestId": "req-onboarding-progress", - "timestamp": "2026-09-17T01:31:00Z" + "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" } } } }, "400": { - "description": "completed 缺失或 version 为负数", + "description": "请求体校验失败", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } }, "403": { - "description": "仅 STUDENT 角色可访问", + "description": "非目标学生 / 跨企业 / 非岗位 owner / ADMIN", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "404": { - "description": "条目不存在、已不属于该企业，或不属于该企业的有效清单", + "description": "无评分 9504 / 面试不存在 8401", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9701, - "message": "onboarding checklist item not found", - "data": null, - "requestId": "req-9701", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "409": { - "description": "进度版本已过期", + "description": "未完成 9502", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 9705, - "message": "onboarding progress was modified concurrently", - "data": null, - "requestId": "req-9705", - "timestamp": "2026-09-17T01:30:00Z" } } } @@ -7843,336 +6806,4848 @@ } } }, - "/onboarding/companies/{companyId}/knowledge": { - "get": { + "/interviews/{interviewId}/score/submit": { + "post": { "tags": [ - "公司知识介绍" - ], - "summary": "读取公司知识介绍", - "description": "STUDENT 读取企业基础资料、企业维护内容和公开评价摘要；企业未配置知识时回退基础资料，公开评价少于 3 条时不返回均值。", - "operationId": "getCompanyKnowledgeOverview", - "security": [ - { - "bearerAuth": [] - } + "结构化面试评分" ], + "summary": "提交评分", + "description": "将 DRAFT 提交为 SUBMITTED，提交后不可逆；并发冲突 409；重复提交幂等返回原评分", + "operationId": "submitInterviewScore", "parameters": [ { - "name": "companyId", + "name": "interviewId", "in": "path", "required": true, - "description": "企业 ID", "schema": { "type": "integer", - "format": "int64", - "minimum": 1 + "format": "int64" } } ], "responses": { "200": { - "description": "查询成功", + "description": "success", "content": { "*/*": { "schema": { - "$ref": "#/components/schemas/ApiResponseCompanyKnowledgeOverviewResponse" - }, - "example": { - "code": 200, - "message": "ok", - "data": { - "company": { - "id": 10, - "name": "示例科技", - "logoUrl": "https://cdn.example.com/company-10.png", - "description": "面向企业提供数据基础设施产品。", - "industry": "互联网", - "website": "https://example.com", - "address": "杭州市余杭区", - "verified": true - }, - "knowledgeState": "CONFIGURED", - "knowledge": { - "culture": "以用户价值为中心，保持透明和长期主义。", - "workPolicies": "弹性上班；每周一、三线下办公。", - "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。", - "updatedAt": "2026-09-17T01:33:00Z" - }, - "reviewSummary": { - "state": "SUFFICIENT", - "totalReviews": 4, - "averageRating": 4.5, - "ratingDistribution": { - "rating1": 0, - "rating2": 0, - "rating3": 1, - "rating4": 1, - "rating5": 2 - }, - "topTags": [ - "发展空间", - "同事友好" - ], - "dimensionSummary": { - "AUTHENTICITY": { - "averageScore": 4.5, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "BENEFITS": { - "averageScore": 4.3, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "SALARY_TRANSPARENCY": { - "averageScore": 4.0, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "JD_CLARITY": { - "averageScore": 4.6, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "GROWTH": { - "averageScore": 4.4, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "TEAM_ATMOSPHERE": { - "averageScore": 4.7, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "PROMOTION": { - "averageScore": 4.1, - "sampleCount": 4, - "dataState": "SUFFICIENT" - }, - "WORK_LIFE_BALANCE": { - "averageScore": 4.0, - "sampleCount": 4, - "dataState": "SUFFICIENT" - } - } - } - }, - "requestId": "req-company-overview", - "timestamp": "2026-09-17T01:34:00Z" + "$ref": "#/components/schemas/ApiResponseInterviewScoreResponse" } } } }, "400": { - "description": "companyId 不是正整数", + "description": "缺维度 1001", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 1001, - "message": "bad request", - "data": null, - "requestId": "req-1001", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "401": { - "description": "未登录或令牌无效，由全局 Security 入口返回裸 JSON", + "description": "未登录", "content": { - "application/json": { + "*/*": { "schema": { - "$ref": "#/components/schemas/UnauthorizedResponse" - }, - "example": { - "code": 401, - "message": "not authenticated", - "timestamp": "" + "$ref": "#/components/schemas/ApiResponse" } } } }, "403": { - "description": "仅 STUDENT 角色可访问", + "description": "非企业/跨企业/非岗位 owner", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 2002, - "message": "forbidden", - "data": null, - "requestId": "req-2002", - "timestamp": "2026-09-17T01:30:00Z" } } } }, "404": { - "description": "企业不存在", + "description": "面试不存在 8401", "content": { - "application/json": { + "*/*": { "schema": { "$ref": "#/components/schemas/ApiResponse" - }, - "example": { - "code": 5001, - "message": "company not found", - "data": null, - "requestId": "req-5001", - "timestamp": "2026-09-17T01:30:00Z" } } } - } - } - } - } + }, + "409": { + "description": "未完成 9502 / 并发冲突 9501", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/interviews/{interviewId}/score/history": { + "get": { + "tags": [ + "结构化面试评分" + ], + "summary": "评分历史", + "description": "企业 owner 可查看全部历史；目标学生仅在 SUBMITTED 后可见；无历史返回 200 空数组；不返回内部用户标识", + "operationId": "getInterviewScoreHistory", + "parameters": [ + { + "name": "interviewId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "success", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseListInterviewScoreHistoryItem" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非目标学生 / 跨企业 / 非岗位 owner / ADMIN", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "面试不存在 8401", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "未完成 9502", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/reports": { + "post": { + "tags": [ + "举报与屏蔽" + ], + "summary": "提交举报", + "description": "targetType=USER 必填 targetUserId；MESSAGE 必填 messageId；reportedUserId 由服务端推导。同 reporter+idempotencyKey+相同请求体返回原举报 200；不同请求体 409/9606；同目标同分类已有 PENDING 409/9603。限流：每用户每小时 10 次，超限 429/9609。", + "operationId": "createReport", + "security": [ + { + "bearerAuth": [] + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateReportRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseReportResponse" + } + } + } + }, + "400": { + "description": "BAD_REQUEST(1001)/举报自己 9602/理由缺失 9607", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "无权访问消息（2002，不泄露消息是否存在）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "重复举报 9603 / 幂等冲突 9606", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "429": { + "description": "频率超限 9609", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/reports/me": { + "get": { + "tags": [ + "举报与屏蔽" + ], + "summary": "我的举报列表", + "description": "仅返回当前用户创建的举报；身份来自 JWT；不返回举报人内部信息/phone/email/passwordHash/resumeUrl/消息全文；支持 status/page/size。", + "operationId": "listMyReports", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageResponseReportResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/reports/{id}": { + "get": { + "tags": [ + "举报与屏蔽" + ], + "summary": "举报详情（本人/ADMIN）", + "description": "当前举报人本人或 ADMIN 可查看；其他 403/2002；非 ADMIN 不显示举报人内部 ID/手机号/邮箱；MESSAGE 仅返回脱敏 messagePreview。", + "operationId": "getReportDetail", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseReportResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非本人非 ADMIN（2002）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "举报不存在（9601）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/blocks/{blockedUserId}": { + "put": { + "tags": [ + "举报与屏蔽" + ], + "summary": "屏蔽用户", + "description": "屏蔽自己 400/9608；目标不存在复用用户不存在错误码；已存在返回 200 不新增；不影响系统通知/投递/Offer/面试/评分/评价。", + "operationId": "blockUser", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "blockedUserId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseBlockRelationResponse" + } + } + } + }, + "400": { + "description": "屏蔽自己 9608", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + }, + "delete": { + "tags": [ + "举报与屏蔽" + ], + "summary": "解除屏蔽", + "description": "幂等：不存在时返回 200 不报错。", + "operationId": "unblockUser", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "blockedUserId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK（幂等）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/blocks/me": { + "get": { + "tags": [ + "举报与屏蔽" + ], + "summary": "我的屏蔽列表", + "description": "仅返回当前用户主动屏蔽的用户；不返回对方手机号/邮箱/密码/简历地址；支持 page/size。", + "operationId": "listMyBlocks", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageResponseBlockRelationResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/admin/reports": { + "get": { + "tags": [ + "举报管理" + ], + "summary": "举报列表（ADMIN）", + "description": "仅 ADMIN；COMPANY/STUDENT/未登录分别 403/403/401；支持 status/targetType/category/page/size；响应脱敏。", + "operationId": "adminListReports", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "targetType", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "category", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageResponseReportResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非 ADMIN", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/admin/reports/{id}": { + "get": { + "tags": [ + "举报管理" + ], + "summary": "举报详情（ADMIN）", + "description": "仅 ADMIN；可见类型/分类/理由/脱敏证据 URL/MESSAGE 脱敏内容/会话最小信息/处理历史；不返回密码/JWT/手机号/邮箱/resumeUrl。", + "operationId": "adminGetReport", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseReportResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非 ADMIN", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "举报不存在（9601）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/admin/reports/{id}/decision": { + "post": { + "tags": [ + "举报管理" + ], + "summary": "举报处理决定（ADMIN）", + "description": "仅 ADMIN；decision 仅 RESOLVED/REJECTED；REJECTED 必填 note；仅 PENDING 可处理，重复 409/9604，非法流转 409/9605；处理后发送一条 REPORT_DECISION 通知。", + "operationId": "decideReport", + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReportDecisionRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseReportResponse" + } + } + } + }, + "400": { + "description": "参数错误（REJECTED 缺 note）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "401": { + "description": "未登录", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "403": { + "description": "非 ADMIN", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "404": { + "description": "举报不存在（9601）", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + }, + "409": { + "description": "重复决定 9604 / 非法流转 9605", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponse" + } + } + } + } + } + } + }, + "/abilities/types": { + "get": { + "tags": [ + "四维能力测评" + ], + "operationId": "listAbilityTypes", + "summary": "能力测评类型列表", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityTypeResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + } + } + } + }, + "/abilities/attempts": { + "post": { + "tags": [ + "四维能力测评" + ], + "operationId": "createAbilityAttempt", + "summary": "创建能力测评答卷", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateAbilityAttemptRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityAttemptResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "9801" + }, + "409": { + "description": "9808/9809/9810" + }, + "429": { + "description": "9811" + } + } + } + }, + "/abilities/attempts/{attemptId}": { + "get": { + "tags": [ + "四维能力测评" + ], + "operationId": "getAbilityAttempt", + "summary": "getAbilityAttempt", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityAttemptResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "404" + }, + "409": { + "description": "409" + } + } + } + }, + "/abilities/attempts/{attemptId}/answers": { + "patch": { + "tags": [ + "四维能力测评" + ], + "operationId": "saveAbilityAnswers", + "summary": "saveAbilityAnswers", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityAttemptResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "404" + }, + "409": { + "description": "409" + } + }, + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SaveAbilityAnswersRequest" + } + } + }, + "required": true + } + } + }, + "/abilities/attempts/{attemptId}/submit": { + "post": { + "tags": [ + "四维能力测评" + ], + "operationId": "submitAbilityAttempt", + "summary": "submitAbilityAttempt", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityResultResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "404" + }, + "409": { + "description": "409" + } + } + } + }, + "/abilities/attempts/{attemptId}/result": { + "get": { + "tags": [ + "四维能力测评" + ], + "operationId": "getAbilityResult", + "summary": "getAbilityResult", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAbilityResultResponse" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + }, + "404": { + "description": "404" + }, + "409": { + "description": "409" + } + } + } + }, + "/abilities/me": { + "get": { + "tags": [ + "四维能力测评" + ], + "operationId": "listMyAbilityAttempts", + "summary": "我的能力测评历史", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageResponseAbilityHistoryItem" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "Forbidden" + } + } + } + }, + "/admin/scoring/risk/overview": { + "get": { + "tags": [ + "风险治理" + ], + "operationId": "riskOverview", + "summary": "风险概览（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRiskOverviewResponse" + } + } + } + } + }, + "parameters": [ + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + } + ] + } + }, + "/admin/scoring/risk/trend": { + "get": { + "tags": [ + "风险治理" + ], + "operationId": "riskTrend", + "summary": "风险趋势（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRiskTrendResponse" + } + } + } + } + }, + "parameters": [ + { + "name": "bucket", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + } + ] + } + }, + "/admin/scoring/risk/distribution": { + "get": { + "tags": [ + "风险治理" + ], + "operationId": "riskDistribution", + "summary": "风险分布（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRiskDistributionResponse" + } + } + } + } + }, + "parameters": [ + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + } + ] + } + }, + "/admin/scoring/risk/events": { + "get": { + "tags": [ + "风险治理" + ], + "operationId": "riskEvents", + "summary": "风险事件分页（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageResponseRiskEventResponse" + } + } + } + } + }, + "parameters": [ + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "status", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "severity", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "ruleCode", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + } + ] + } + }, + "/admin/scoring/risk/rules": { + "get": { + "tags": [ + "风险治理" + ], + "operationId": "riskRules", + "summary": "风险规则列表（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseListRiskRuleResponse" + } + } + } + } + } + } + }, + "/admin/scoring/risk/rules/{ruleCode}": { + "put": { + "tags": [ + "风险治理" + ], + "operationId": "riskUpdateRule", + "summary": "更新风险规则（ADMIN）", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RiskRuleUpdateRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRiskRuleResponse" + } + } + } + } + } + } + }, + "/admin/scoring/risk/events/{eventId}/actions": { + "post": { + "tags": [ + "风险治理" + ], + "operationId": "riskActionEvent", + "summary": "风险事件人工操作（ADMIN）", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RiskEventActionRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRiskEventResponse" + } + } + } + } + } + } + }, + "/job-recommendation-taxonomies": { + "get": { + "tags": [ + "岗位推荐" + ], + "operationId": "recommendationTaxonomies", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseListTaxonomyResponse" + } + } + } + } + } + } + }, + "/profile/me/job-recommendations": { + "get": { + "tags": [ + "岗位推荐" + ], + "operationId": "myJobRecommendations", + "parameters": [ + { + "name": "page", + "in": "query", + "schema": { + "type": "integer" + } + }, + { + "name": "size", + "in": "query", + "schema": { + "type": "integer" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageJobRecommendationItem" + } + } + } + } + } + } + }, + "/profile/me/job-recommendations/{jobId}/feedback": { + "post": { + "tags": [ + "岗位推荐" + ], + "operationId": "createRecommendationFeedback", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RecommendationFeedbackRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRecommendationFeedbackResponse" + } + } + } + } + } + }, + "delete": { + "tags": [ + "岗位推荐" + ], + "operationId": "revokeNotInterestedFeedback", + "parameters": [ + { + "name": "expectedVersion", + "in": "query", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK" + } + } + } + }, + "/companies/me/jobs/{jobId}/recommendation-profile": { + "get": { + "tags": [ + "岗位推荐" + ], + "operationId": "companyRecommendationProfile", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRecommendationProfileResponse" + } + } + } + } + } + }, + "put": { + "tags": [ + "岗位推荐" + ], + "operationId": "updateCompanyRecommendationProfile", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RecommendationProfileRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRecommendationProfileResponse" + } + } + } + } + } + } + }, + "/admin/job-recommendation-profiles": { + "get": { + "tags": [ + "岗位推荐" + ], + "operationId": "adminRecommendationProfiles", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePageRecommendationProfileResponse" + } + } + } + } + } + } + }, + "/admin/job-recommendation-profiles/{jobId}/decision": { + "post": { + "tags": [ + "岗位推荐" + ], + "operationId": "decideRecommendationProfile", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RecommendationDecisionRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseRecommendationProfileResponse" + } + } + } + } + } + } + }, + "/companies/me/job-reviews": { + "get": { + "tags": [ + "企业评价管理" + ], + "operationId": "listCompanyJobReviews", + "parameters": [ + { + "name": "jobId", + "in": "query", + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "rating", + "in": "query", + "schema": { + "type": "integer" + } + }, + { + "name": "reviewModerationStatus", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "replyStatus", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "createdFrom", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + } + }, + { + "name": "createdTo", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + } + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "schema": { + "type": "integer", + "default": 20 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseReviewReplyPageResponse" + } + } + } + } + } + } + }, + "/companies/me/job-reviews/{reviewId}": { + "get": { + "tags": [ + "企业评价管理" + ], + "operationId": "getCompanyJobReview", + "parameters": [ + { + "name": "reviewId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyReviewDetailResponse" + } + } + } + } + } + } + }, + "/companies/me/job-reviews/{reviewId}/reply": { + "post": { + "tags": [ + "企业评价管理" + ], + "operationId": "createCompanyReviewReply", + "parameters": [ + { + "name": "reviewId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateCompanyReviewReplyRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyReviewReplyResponse" + } + } + } + } + } + }, + "put": { + "tags": [ + "企业评价管理" + ], + "operationId": "reviseCompanyReviewReply", + "parameters": [ + { + "name": "reviewId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/UpdateCompanyReviewReplyRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyReviewReplyResponse" + } + } + } + } + } + } + }, + "/admin/review-replies/pending": { + "get": { + "tags": [ + "官方回复审核" + ], + "operationId": "listPendingReviewReplies", + "parameters": [ + { + "name": "companyId", + "in": "query", + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "jobId", + "in": "query", + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "riskLevel", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "createdFrom", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + } + }, + { + "name": "createdTo", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + } + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 0 + } + }, + { + "name": "size", + "in": "query", + "schema": { + "type": "integer", + "default": 20 + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAdminReviewReplyPageResponse" + } + } + } + } + } + } + }, + "/admin/review-replies/{replyId}/decision": { + "post": { + "tags": [ + "官方回复审核" + ], + "operationId": "decideReviewReply", + "parameters": [ + { + "name": "replyId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReviewReplyDecisionRequest" + } + } + } + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseAdminReviewReplyResponse" + } + } + } + } + } + } + }, + "/profile/me/talent-discovery": { + "get": { + "tags": [ + "企业人才发现" + ], + "summary": "查询人才发现授权", + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseTalentDiscoveryPreferenceResponse" + } + } + } + } + }, + "security": [ + { + "bearerAuth": [] + } + ] + }, + "put": { + "tags": [ + "企业人才发现" + ], + "summary": "更新人才发现授权", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TalentDiscoveryPreferenceUpdateRequest" + } + } + } + }, + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseTalentDiscoveryPreferenceResponse" + } + } + } + } + }, + "security": [ + { + "bearerAuth": [] + } + ] + } + }, + "/companies/me/jobs/{jobId}/talent-recommendations": { + "get": { + "tags": [ + "企业人才发现" + ], + "summary": "查询岗位人才发现推荐", + "parameters": [ + { + "name": "jobId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + }, + { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 0, + "minimum": 0 + } + }, + { + "name": "size", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "format": "int32", + "default": 20, + "minimum": 1, + "maximum": 50 + } + } + ], + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseTalentDiscoveryPageResponse" + } + } + } + } + }, + "security": [ + { + "bearerAuth": [] + } + ] + } + }, + "/companies/me/jobs/{jobId}/talent-invitations": { + "post": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "创建人才邀约", + "parameters": [ + { + "name": "jobId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateTalentInvitationRequest" + } + } + } + }, + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyTalentInvitationResponse" + } + } + } + } + } + } + }, + "/companies/me/talent-invitations": { + "get": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "企业邀约列表", + "parameters": [ + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "format": "int32", + "default": 0, + "minimum": 0 + } + }, + { + "name": "size", + "in": "query", + "schema": { + "type": "integer", + "format": "int32", + "default": 20, + "minimum": 1, + "maximum": 50 + } + } + ], + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyTalentInvitationPageResponse" + } + } + } + } + } + } + }, + "/companies/me/talent-invitations/{invitationId}": { + "get": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "企业邀约详情", + "parameters": [ + { + "name": "invitationId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyTalentInvitationResponse" + } + } + } + } + } + } + }, + "/profile/me/talent-invitations": { + "get": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "学生收到的邀约列表", + "parameters": [ + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "format": "int32", + "default": 0, + "minimum": 0 + } + }, + { + "name": "size", + "in": "query", + "schema": { + "type": "integer", + "format": "int32", + "default": 20, + "minimum": 1, + "maximum": 50 + } + } + ], + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseStudentTalentInvitationPageResponse" + } + } + } + } + } + } + }, + "/profile/me/talent-invitations/{invitationId}": { + "get": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "学生邀约详情", + "parameters": [ + { + "name": "invitationId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseStudentTalentInvitationResponse" + } + } + } + } + } + } + }, + "/profile/me/talent-invitations/{invitationId}/decision": { + "post": { + "tags": [ + "企业人才邀约" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "summary": "处理人才邀约", + "parameters": [ + { + "name": "invitationId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TalentInvitationDecisionRequest" + } + } + } + }, + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseStudentTalentInvitationResponse" + } + } + } + } + } + } + }, + "/admin/scoring/fairness/overview": { + "get": { + "summary": "评分完整性概览（ADMIN）", + "parameters": [ + { + "name": "period", + "in": "query", + "required": true, + "schema": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}$" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseFairnessResponseOverview" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非 ADMIN" + }, + "400": { + "description": "非法 period" + } + } + } + }, + "/admin/scoring/fairness/dimensions": { + "get": { + "summary": "评分维度分布（ADMIN）", + "parameters": [ + { + "name": "period", + "in": "query", + "required": true, + "schema": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}$" + } + }, + { + "name": "dimension", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": [ + "EDUCATION", + "INTERNSHIP", + "ABILITY", + "COMPLIANCE", + "STABILITY", + "GROWTH", + "INTEGRITY", + "ACTIVITY" + ] + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseFairnessResponseDimensions" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非 ADMIN" + }, + "400": { + "description": "非法参数" + } + } + } + }, + "/admin/scoring/fairness/drift": { + "get": { + "summary": "评分历史漂移（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseFairnessResponseUnavailable" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非 ADMIN" + } + } + } + }, + "/admin/scoring/fairness/ranking-stability": { + "get": { + "summary": "排名稳定性（ADMIN）", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseFairnessResponseUnavailable" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非 ADMIN" + } + } + } + }, + "/admin/scoring/fairness/appeals": { + "get": { + "summary": "申诉纠错聚合（ADMIN）", + "parameters": [ + { + "name": "from", + "in": "query", + "required": false, + "schema": { + "type": "string", + "format": "date" + } + }, + { + "name": "to", + "in": "query", + "required": false, + "schema": { + "type": "string", + "format": "date" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseFairnessResponseAppeals" + } + } + } + }, + "401": { + "description": "未登录" + }, + "403": { + "description": "非 ADMIN" + }, + "400": { + "description": "非法日期范围" + } + } + } + }, + "/auth/refresh": { + "post": { + "tags": [ + "认证" + ], + "summary": "刷新 Token", + "description": "使用 Refresh Token 换取新的 Access/Refresh Token 对；旧 Refresh Token 立即失效", + "operationId": "refresh", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RefreshTokenRequest" + } + } + } + }, + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseTokenPairResponse" + } + } + } + } + } + } + }, + "/auth/logout": { + "post": { + "tags": [ + "认证" + ], + "summary": "登出", + "description": "撤销当前登录会话；需要 Access Token，不接受任何请求体", + "operationId": "logout", + "responses": { + "200": { + "description": "成功", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ApiResponseMapStringString" + } + } + } + } + } + } + }, + "/company/candidates/{applicationId}/resume": { + "get": { + "tags": [ + "投递" + ], + "summary": "企业下载候选人简历", + "description": "按候选人隐私设置授权后返回简历文件流；不返回存储路径、学生 ID 或联系方式", + "operationId": "downloadCandidateResume", + "parameters": [ + { + "name": "applicationId", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "format": "int64" + } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "type": "string", + "format": "byte" + } + } + } + } + } + } + }, + "/auth/password/set": { + "post": { + "tags": [ + "认证" + ], + "summary": "首次设置密码", + "operationId": "setPassword", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PasswordSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePasswordOperationResponse" + } + } + } + } + } + } + }, + "/auth/password/reset": { + "post": { + "tags": [ + "认证" + ], + "summary": "短信找回并重置密码", + "operationId": "resetPassword", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PasswordResetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePasswordOperationResponse" + } + } + } + } + } + } + }, + "/auth/password/login": { + "post": { + "tags": [ + "认证" + ], + "summary": "手机号密码登录", + "description": "使用手机号和密码登录，返回 Access/Refresh Token；不自动创建账号", + "operationId": "passwordLogin", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PasswordLoginRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseMapStringObject" + } + } + } + } + } + } + }, + "/auth/password/change": { + "post": { + "tags": [ + "认证" + ], + "summary": "修改密码", + "operationId": "changePassword", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PasswordChangeRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponsePasswordOperationResponse" + } + } + } + } + } + } + }, + "/auth/company/register": { + "post": { + "tags": [ + "认证" + ], + "summary": "企业注册", + "description": "使用 company-register 短信验证码创建企业账号和企业资料", + "operationId": "companyRegister", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CompanyRegistrationRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyRegistrationResponse" + } + } + } + } + } + } + }, + "/companies/me/onboarding": { + "get": { + "tags": [ + "企业" + ], + "summary": "查询企业入驻状态", + "description": "返回当前企业资料、认证状态和允许动作", + "operationId": "getMyOnboarding", + "responses": { + "200": { + "description": "OK", + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/ApiResponseCompanyOnboardingResponse" + } + } + } + } + } + } + } }, "components": { - "schemas": {"SalaryDataLevel":{"type":"string","enum":["CITY","PROVINCE_FALLBACK"]},"SalaryCitySummaryResponse":{"type":"object","properties":{"cityCode":{"type":"string"},"provinceCode":{"type":"string"},"provinceName":{"type":"string"},"cityName":{"type":"string"},"policyVersion":{"type":"string"},"policyEffectiveDate":{"type":"string","format":"date"},"dataLevel":{"$ref":"#/components/schemas/SalaryDataLevel"}}},"SalaryCityDetailResponse":{"type":"object","properties":{"cityCode":{"type":"string"},"provinceCode":{"type":"string"},"provinceName":{"type":"string"},"cityName":{"type":"string"},"policyVersion":{"type":"string"},"policyEffectiveDate":{"type":"string","format":"date"},"dataLevel":{"$ref":"#/components/schemas/SalaryDataLevel"},"dataSource":{"type":"string"},"socialSecurityBaseMin":{"type":"number"},"socialSecurityBaseMax":{"type":"number"},"housingFundBaseMin":{"type":"number"},"housingFundBaseMax":{"type":"number"},"pensionRate":{"type":"number"},"medicalRate":{"type":"number"},"unemploymentRate":{"type":"number"},"housingFundRate":{"type":"number"},"seriousIllnessMonthlyFee":{"type":"number"}}},"SalaryCalculationOverrideRequest":{"type":"object","properties":{"socialSecurityBase":{"type":"number"},"housingFundBase":{"type":"number"},"pensionRate":{"type":"number"},"medicalRate":{"type":"number"},"unemploymentRate":{"type":"number"},"housingFundRate":{"type":"number"},"seriousIllnessMonthlyFee":{"type":"number"}}},"SalaryCalculationRequest":{"type":"object","required":["cityCode","grossMonthlySalary","expectedPolicyVersion"],"properties":{"cityCode":{"type":"string"},"grossMonthlySalary":{"type":"number"},"monthIndex":{"type":"integer","minimum":1,"maximum":12},"specialAdditionalDeduction":{"type":"number"},"expectedPolicyVersion":{"type":"string"},"idempotencyKey":{"type":"string","maxLength":64},"overrides":{"$ref":"#/components/schemas/SalaryCalculationOverrideRequest"}}},"SalaryCalculationResult":{"type":"object","properties":{"cityCode":{"type":"string"},"cityName":{"type":"string"},"dataLevel":{"$ref":"#/components/schemas/SalaryDataLevel"},"policyVersion":{"type":"string"},"policyEffectiveDate":{"type":"string","format":"date"},"taxRulesVersion":{"type":"string"},"estimate":{"type":"boolean"},"monthIndex":{"type":"integer"},"grossMonthlySalary":{"type":"number"},"specialAdditionalDeduction":{"type":"number"},"socialSecurityBase":{"type":"number"},"housingFundBase":{"type":"number"},"pensionRate":{"type":"number"},"medicalRate":{"type":"number"},"unemploymentRate":{"type":"number"},"housingFundRate":{"type":"number"},"seriousIllnessMonthlyFee":{"type":"number"},"pension":{"type":"number"},"medical":{"type":"number"},"unemployment":{"type":"number"},"housingFund":{"type":"number"},"cumulativeGrossIncome":{"type":"number"},"cumulativeSocialInsurance":{"type":"number"},"cumulativeHousingFund":{"type":"number"},"cumulativeSeriousIllness":{"type":"number"},"cumulativeBasicDeduction":{"type":"number"},"cumulativeSpecialAdditionalDeduction":{"type":"number"},"cumulativeTaxableIncome":{"type":"number"},"cumulativeTaxDue":{"type":"number"},"previouslyWithheldTax":{"type":"number"},"currentMonthTax":{"type":"number"},"netSalary":{"type":"number"}}},"SalaryCalculationResponse":{"type":"object","properties":{"historyId":{"type":"integer","format":"int64"},"createdAt":{"type":"string","format":"date-time"},"result":{"$ref":"#/components/schemas/SalaryCalculationResult"}}},"SalaryHistorySummaryResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"cityCode":{"type":"string"},"cityName":{"type":"string"},"dataLevel":{"$ref":"#/components/schemas/SalaryDataLevel"},"grossMonthlySalary":{"type":"number"},"netSalary":{"type":"number"},"monthIndex":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"}}},"SalaryHistoryDetailResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"cityCode":{"type":"string"},"cityName":{"type":"string"},"dataLevel":{"$ref":"#/components/schemas/SalaryDataLevel"},"policyVersion":{"type":"string"},"taxRulesVersion":{"type":"string"},"monthIndex":{"type":"integer"},"grossMonthlySalary":{"type":"number"},"netSalary":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"inputSnapshot":{"type":"object"},"policySnapshot":{"type":"object"},"resultSnapshot":{"type":"object"}}},"PageResponseSalaryHistorySummaryResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SalaryHistorySummaryResponse"}},"total":{"type":"integer","format":"int64"},"page":{"type":"integer"},"size":{"type":"integer"},"totalPages":{"type":"integer"}}},"ApiResponseListSalaryCitySummaryResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SalaryCitySummaryResponse"}},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"ApiResponseSalaryCityDetailResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/SalaryCityDetailResponse"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"ApiResponseSalaryCalculationResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/SalaryCalculationResponse"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"ApiResponsePageResponseSalaryHistorySummaryResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/PageResponseSalaryHistorySummaryResponse"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"ApiResponseSalaryHistoryDetailResponse":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/SalaryHistoryDetailResponse"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"ApiResponseVoid":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}, + "schemas": { + "TaxonomyResponse": { + "type": "object", + "properties": { + "code": { + "type": "string" + }, + "parentCode": { + "type": "string" + }, + "type": { + "type": "string" + }, + "displayName": { + "type": "string" + } + } + }, + "RecommendationFeedbackRequest": { + "type": "object", + "required": [ + "feedbackType", + "idempotencyKey", + "expectedVersion" + ], + "properties": { + "feedbackType": { + "type": "string" + }, + "reasonType": { + "type": "string" + }, + "idempotencyKey": { + "type": "string" + }, + "expectedVersion": { + "type": "integer", + "format": "int64" + } + } + }, + "RecommendationProfileRequest": { + "type": "object", + "required": [ + "industryCode", + "jobFamilyCode", + "enabled", + "expectedVersion" + ], + "properties": { + "industryCode": { + "type": "string" + }, + "jobFamilyCode": { + "type": "string" + }, + "riasecWeights": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "abilityExpectations": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "enabled": { + "type": "boolean" + }, + "expectedVersion": { + "type": "integer", + "format": "int64" + } + } + }, + "RecommendationDecisionRequest": { + "type": "object", + "required": [ + "decision", + "expectedVersion" + ], + "properties": { + "decision": { + "type": "string", + "enum": [ + "APPROVE", + "REJECT" + ] + }, + "reasonCode": { + "type": "string" + }, + "expectedVersion": { + "type": "integer", + "format": "int64" + } + } + }, + "RecommendationProfileResponse": { + "type": "object", + "properties": { + "jobId": { + "type": "integer", + "format": "int64" + }, + "industryCode": { + "type": "string" + }, + "jobFamilyCode": { + "type": "string" + }, + "riasecWeights": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "abilityExpectations": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "enabled": { + "type": "boolean" + }, + "reviewStatus": { + "type": "string" + }, + "reviewReason": { + "type": "string" + }, + "version": { + "type": "integer", + "format": "int64" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + } + } + }, + "RecommendationFeedbackResponse": { + "type": "object", + "properties": { + "jobId": { + "type": "integer", + "format": "int64" + }, + "feedbackType": { + "type": "string" + }, + "reasonType": { + "type": "string" + }, + "status": { + "type": "string" + }, + "version": { + "type": "integer", + "format": "int64" + } + } + }, + "JobRecommendationItem": { + "type": "object", + "properties": { + "jobId": { + "type": "integer", + "format": "int64" + }, + "title": { + "type": "string" + }, + "city": { + "type": "string" + }, + "employmentType": { + "type": "string" + }, + "salaryMin": { + "type": "integer" + }, + "salaryMax": { + "type": "integer" + }, + "mode": { + "type": "string", + "enum": [ + "PERSONALIZED", + "FALLBACK" + ] + }, + "score": { + "type": "number" + }, + "reasons": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ApiResponseListTaxonomyResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TaxonomyResponse" + } + } + } + }, + "ApiResponseRecommendationFeedbackResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/RecommendationFeedbackResponse" + } + } + }, + "ApiResponseRecommendationProfileResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/RecommendationProfileResponse" + } + } + }, + "ApiResponsePageJobRecommendationItem": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/JobRecommendationItem" + } + }, + "total": { + "type": "integer" + }, + "page": { + "type": "integer" + }, + "size": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + } + } + } + } + }, + "ApiResponsePageRecommendationProfileResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RecommendationProfileResponse" + } + }, + "total": { + "type": "integer" + }, + "page": { + "type": "integer" + }, + "size": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + } + } + } + } + }, + "CompanyReviewJobResponse": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "title": { + "type": "string" + } + } + }, + "CompanyReviewReplyResponse": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "content": { + "type": "string" + }, + "status": { + "type": "string" + }, + "version": { + "type": "integer", + "format": "int64" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + }, + "rejectionReason": { + "type": "string", + "nullable": true + } + } + }, + "CompanyReviewItemResponse": { + "type": "object", + "properties": { + "reviewId": { + "type": "integer", + "format": "int64" + }, + "job": { + "$ref": "#/components/schemas/CompanyReviewJobResponse" + }, + "rating": { + "type": "integer" + }, + "content": { + "type": "string" + }, + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "dimensionScores": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "reviewStatus": { + "type": "string" + }, + "reviewCreatedAt": { + "type": "string", + "format": "date-time" + }, + "reply": { + "$ref": "#/components/schemas/CompanyReviewReplyResponse" + } + } + }, + "CompanyReviewDetailResponse": { + "allOf": [ + { + "$ref": "#/components/schemas/CompanyReviewItemResponse" + } + ] + }, + "ReviewReplyPageResponse": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CompanyReviewItemResponse" + } + }, + "total": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer" + }, + "size": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + } + } + }, + "CreateCompanyReviewReplyRequest": { + "type": "object", + "required": [ + "content", + "idempotencyKey" + ], + "properties": { + "content": { + "type": "string", + "minLength": 1, + "maxLength": 500 + }, + "idempotencyKey": { + "type": "string", + "format": "uuid", + "maxLength": 64 + } + } + }, + "UpdateCompanyReviewReplyRequest": { + "type": "object", + "required": [ + "content", + "expectedVersion" + ], + "properties": { + "content": { + "type": "string", + "minLength": 1, + "maxLength": 500 + }, + "expectedVersion": { + "type": "integer", + "format": "int64", + "minimum": 0 + } + } + }, + "ReviewReplyDecisionRequest": { + "type": "object", + "required": [ + "decision" + ], + "properties": { + "decision": { + "type": "string", + "enum": [ + "APPROVE", + "REJECT" + ] + }, + "reason": { + "type": "string", + "maxLength": 500 + } + } + }, + "AdminReviewReplyResponse": { + "type": "object", + "properties": { + "replyId": { + "type": "integer", + "format": "int64" + }, + "reviewId": { + "type": "integer", + "format": "int64" + }, + "jobId": { + "type": "integer", + "format": "int64" + }, + "jobTitle": { + "type": "string" + }, + "companyId": { + "type": "integer", + "format": "int64" + }, + "companyName": { + "type": "string" + }, + "rating": { + "type": "integer" + }, + "reviewContent": { + "type": "string" + }, + "reviewModerationStatus": { + "type": "string" + }, + "replyContent": { + "type": "string" + }, + "replyStatus": { + "type": "string" + }, + "version": { + "type": "integer", + "format": "int64" + }, + "riskScore": { + "type": "number" + }, + "riskLevel": { + "type": "string" + }, + "reasonCodes": { + "type": "array", + "items": { + "type": "string" + } + }, + "createdAt": { + "type": "string", + "format": "date-time" + } + } + }, + "AdminReviewReplyPageResponse": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AdminReviewReplyResponse" + } + }, + "total": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer" + }, + "size": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + } + } + }, + "ApiResponseReviewReplyPageResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/ReviewReplyPageResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCompanyReviewDetailResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CompanyReviewDetailResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCompanyReviewReplyResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CompanyReviewReplyResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAdminReviewReplyPageResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/AdminReviewReplyPageResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAdminReviewReplyResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/AdminReviewReplyResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, "AccountDeletionResponse": { "type": "object", "properties": { - "userId": { + "userId": { + "type": "integer", + "format": "int64", + "example": 2 + }, + "status": { + "type": "string", + "enum": [ + "NONE", + "PENDING", + "COMPLETED" + ], + "example": "PENDING", + "description": "注销状态：NONE/PENDING/COMPLETED" + }, + "requestedAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "effectiveAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "cancelledAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "completedAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "version": { + "type": "integer", + "format": "int64", + "example": 0 + } + } + }, + "AdminDashboardOverviewResponse": { + "type": "object", + "properties": { + "totalCompanies": { + "type": "integer", + "format": "int32" + }, + "totalJobs": { + "type": "integer", + "format": "int32" + }, + "totalCandidates": { + "type": "integer", + "format": "int32" + }, + "avgCandidateScore": { + "type": "number" + }, + "topCompanies": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CompanyScoreItem" + } + } + } + }, + "ApiResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": {}, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "CareerProgressResponse": { + "type": "object", + "properties": { + "todo": { + "$ref": "#/components/schemas/ProgressTodoSummary" + }, + "applications": { + "$ref": "#/components/schemas/PaginatedApplications" + }, + "generatedAt": { + "type": "string", + "format": "date-time" + } + } + }, + "ProgressTodoSummary": { + "type": "object", + "properties": { + "pendingInterviewResponseCount": { + "type": "integer", + "format": "int64" + }, + "upcomingConfirmedInterviewCount": { + "type": "integer", + "format": "int64" + }, + "pendingOfferResponseCount": { + "type": "integer", + "format": "int64" + }, + "unreadNotificationCount": { + "type": "integer", + "format": "int64" + }, + "unreadReportDecisionCount": { + "type": "integer", + "format": "int64" + } + } + }, + "PaginatedApplications": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CareerProgressItem" + } + }, + "total": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + }, + "totalPages": { + "type": "integer", + "format": "int32" + } + } + }, + "CareerProgressItem": { + "type": "object", + "properties": { + "applicationId": { + "type": "integer", + "format": "int64" + }, + "applicationStatus": { + "type": "string" + }, + "appliedAt": { + "type": "string", + "format": "date-time" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + }, + "job": { + "$ref": "#/components/schemas/JobSummary" + }, + "nextInterview": { + "$ref": "#/components/schemas/InterviewSummary" + }, + "latestSubmittedInterviewScore": { + "$ref": "#/components/schemas/ScoreSummary" + }, + "offer": { + "$ref": "#/components/schemas/OfferSummary" + }, + "competition": { + "$ref": "#/components/schemas/CompetitionSummary" + } + } + }, + "JobSummary": { + "type": "object", + "properties": { + "jobId": { + "type": "integer", + "format": "int64" + }, + "title": { + "type": "string" + }, + "companyName": { + "type": "string" + }, + "city": { + "type": "string" + }, + "employmentType": { + "type": "string" + }, + "jobStatus": { + "type": "string" + } + } + }, + "InterviewSummary": { + "type": "object", + "properties": { + "interviewId": { + "type": "integer", + "format": "int64" + }, + "roundNo": { + "type": "integer", + "format": "int32" + }, + "title": { + "type": "string" + }, + "interviewType": { + "type": "string" + }, + "startAt": { + "type": "string", + "format": "date-time" + }, + "endAt": { + "type": "string", + "format": "date-time" + }, + "status": { + "type": "string" + } + } + }, + "ScoreSummary": { + "type": "object", + "properties": { + "interviewId": { + "type": "integer", + "format": "int64" + }, + "overallScore": { + "type": "number" + }, + "recommendation": { + "type": "string" + }, + "submittedAt": { + "type": "string", + "format": "date-time" + } + } + }, + "OfferSummary": { + "type": "object", + "properties": { + "offerId": { + "type": "integer", + "format": "int64" + }, + "status": { + "type": "string" + }, + "title": { + "type": "string" + }, + "expireAt": { + "type": "string", + "format": "date-time" + }, + "onboardingDate": { + "type": "string", + "format": "date" + } + } + }, + "CompetitionSummary": { + "type": "object", + "properties": { + "eligible": { + "type": "boolean" + }, + "rank": { + "type": "integer", + "format": "int32" + }, + "cohortSize": { + "type": "integer", + "format": "int32" + }, + "overallScore": { + "type": "number" + }, + "percentile": { + "type": "number" + }, + "status": { + "type": "string" + }, + "mySnapshotPeriod": { + "type": "string" + }, + "rulesVersion": { + "type": "string" + } + } + }, + "ApiResponseCareerProgressResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32", + "example": 200 + }, + "message": { + "type": "string", + "example": "ok" + }, + "data": { + "$ref": "#/components/schemas/CareerProgressResponse" + }, + "requestId": { + "type": "string", + "example": "req-1" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAccountDeletionResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32", + "example": 200 + }, + "message": { + "type": "string", + "example": "ok" + }, + "data": { + "$ref": "#/components/schemas/AccountDeletionResponse" + }, + "requestId": { + "type": "string", + "example": "req-1" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAdminDashboardOverviewResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/AdminDashboardOverviewResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAppealResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/AppealResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateDetailView": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateDetailView" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateFeedbackResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateFeedbackResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateListResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateListResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidatePercentileResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidatePercentileResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateRankingDetailResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateRankingDetailResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateRankingListResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateRankingListResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateScoreCardResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateScoreCardResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateScoreTrendResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateScoreTrendResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateScoringOverviewResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateScoringOverviewResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCandidateScoringTrendResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CandidateScoringTrendResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCompanyCandidateScoringResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CompanyCandidateScoringResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseCompanyPublicView": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/CompanyPublicView" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseDashboardOverviewResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/DashboardOverviewResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseDimensionScoreDetailResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/DimensionScoreDetailResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseJobRankingItem": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/JobRankingItem" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseJobRankingListResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/JobRankingListResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseListAppealHistoryItem": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AppealHistoryItem" + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseListMapStringObject": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "type": "object", + "additionalProperties": {} + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseListSnapshotHistoryItem": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SnapshotHistoryItem" + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseListWeightTemplateResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/WeightTemplateResponse" + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseMapStringObject": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "object", + "additionalProperties": {} + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseMapStringString": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponsePersonalizedScoreResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/PersonalizedScoreResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponsePrivacySettingsResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32", + "example": 200 + }, + "message": { + "type": "string", + "example": "ok" + }, + "data": { + "$ref": "#/components/schemas/PrivacySettingsResponse" + }, + "requestId": { + "type": "string", + "example": "req-1" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseReviewWeightResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/ReviewWeightResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseScoreTrendResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/ScoreTrendResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "AppealDecisionRequest": { + "type": "object", + "properties": { + "decision": { + "type": "string", + "minLength": 1 + }, + "reason": { + "type": "string" + } + }, + "required": [ + "decision" + ] + }, + "AppealHistoryItem": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "fromStatus": { + "type": "string" + }, + "toStatus": { + "type": "string" + }, + "actorUserId": { + "type": "integer", + "format": "int64" + }, + "actorRole": { + "type": "string" + }, + "reason": { + "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" + } + } + }, + "AppealResponse": { + "type": "object", + "properties": { + "appealId": { + "type": "integer", + "format": "int64" + }, + "candidateId": { + "type": "integer", + "format": "int64" + }, + "dimension": { + "type": "string" + }, + "period": { + "type": "string" + }, + "status": { + "type": "string" + }, + "reason": { + "type": "string" + }, + "decision": { + "type": "string" + }, + "decisionReason": { + "type": "string" + }, + "reviewerId": { + "type": "integer", + "format": "int64" + }, + "reviewedAt": { + "type": "string", + "format": "date-time" + }, + "rollbackAt": { + "type": "string", + "format": "date-time" + }, + "scoreAtAppeal": { + "type": "number" + }, + "snapshotVersionAtAppeal": { + "type": "integer", + "format": "int64" + }, + "rulesVersion": { + "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + } + } + }, + "ApplicationCreateRequest": { + "type": "object", + "properties": { + "jobId": { + "type": "integer", + "format": "int64" + } + }, + "required": [ + "jobId" + ] + }, + "ApplicationStatusRequest": { + "type": "object", + "properties": { + "status": { + "type": "string", + "minLength": 1, + "pattern": "^(VIEWED|INTERVIEW|REJECTED|HIRED)$" + } + }, + "required": [ + "status" + ] + }, + "CandidateDetailView": { + "type": "object", + "properties": { + "applicationId": { "type": "integer", - "format": "int64", - "example": 2 + "format": "int64" + }, + "jobId": { + "type": "integer", + "format": "int64" + }, + "jobTitle": { + "type": "string" + }, + "jobCity": { + "type": "string" + }, + "jobEmploymentType": { + "type": "string" }, "status": { + "type": "string" + }, + "coverLetter": { + "type": "string" + }, + "createdAt": { "type": "string", - "enum": [ - "NONE", - "PENDING", - "COMPLETED" - ], - "example": "PENDING", - "description": "注销状态：NONE/PENDING/COMPLETED" + "format": "date-time" }, - "requestedAt": { + "updatedAt": { "type": "string", - "format": "date-time", - "nullable": true + "format": "date-time" }, - "effectiveAt": { + "candidateName": { + "type": "string" + }, + "candidateAvatarUrl": { + "type": "string" + }, + "candidateBio": { + "type": "string" + }, + "candidateLocation": { + "type": "string" + }, + "candidateSchool": { + "type": "string" + }, + "candidateEducation": { + "type": "string" + }, + "candidateGraduationYear": { + "type": "integer", + "format": "int32" + }, + "candidateSkills": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "CandidateFeedbackRequest": { + "type": "object", + "properties": { + "rating": { + "type": "integer", + "format": "int32", + "maximum": 5, + "minimum": 1 + }, + "content": { "type": "string", - "format": "date-time", - "nullable": true + "maxLength": 1000, + "minLength": 0 }, - "cancelledAt": { + "tags": { + "type": "array", + "items": { + "type": "string", + "maxLength": 50, + "minLength": 1 + }, + "maxItems": 10, + "minItems": 0 + } + }, + "required": [ + "content", + "rating" + ] + }, + "CandidateFeedbackResponse": { + "type": "object", + "description": "脱敏后的候选人反馈", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "反馈 ID", + "example": 1 + }, + "applicationId": { + "type": "integer", + "format": "int64", + "description": "投递 ID", + "example": 31 + }, + "rating": { + "type": "integer", + "format": "int32", + "description": "评分，范围 1-5", + "example": 5 + }, + "content": { + "type": "string", + "description": "反馈内容", + "example": "沟通良好" + }, + "tags": { + "type": "array", + "description": "反馈标签", + "items": { + "type": "string" + } + }, + "createdAt": { "type": "string", "format": "date-time", - "nullable": true + "description": "创建时间", + "example": "2026-08-25T10:00:00" }, - "completedAt": { + "updatedAt": { "type": "string", "format": "date-time", - "nullable": true + "description": "更新时间", + "example": "2026-08-25T10:00:00" + } + } + }, + "CandidateFeedbackSummary": { + "type": "object", + "properties": { + "totalCount": { + "type": "integer", + "format": "int32" + }, + "averageRating": { + "type": "number" + }, + "ratingDistribution": { + "type": "object", + "additionalProperties": { + "type": "integer", + "format": "int32" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TagCount" + } + } + } + }, + "CandidateItemView": { + "type": "object", + "properties": { + "applicationId": { + "type": "integer", + "format": "int64" + }, + "jobId": { + "type": "integer", + "format": "int64" + }, + "jobTitle": { + "type": "string" + }, + "status": { + "type": "string" + }, + "candidateName": { + "type": "string" + }, + "candidateSchool": { + "type": "string" + }, + "candidateEducation": { + "type": "string" + }, + "candidateGraduationYear": { + "type": "integer", + "format": "int32" + }, + "candidateAvatarUrl": { + "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + } + } + }, + "CandidateListResponse": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CandidateItemView" + } + }, + "total": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + }, + "totalPages": { + "type": "integer", + "format": "int32" + } + } + }, + "CandidateMatchSignals": { + "type": "object", + "properties": { + "candidateInterestScore": { + "$ref": "#/components/schemas/MatchSignal" }, - "version": { - "type": "integer", - "format": "int64", - "example": 0 + "hrSuitabilityScore": { + "$ref": "#/components/schemas/MatchSignal" } } }, - "AdminDashboardOverviewResponse": { + "CandidatePercentileResponse": { "type": "object", "properties": { - "totalCompanies": { + "candidateId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "totalJobs": { + "status": { + "type": "string" + }, + "scoreType": { + "type": "string" + }, + "score": { + "type": "number" + }, + "percentile": { + "type": "number" + }, + "cohortSize": { "type": "integer", "format": "int32" }, - "totalCandidates": { + "sampleCount": { "type": "integer", "format": "int32" }, - "avgCandidateScore": { - "type": "number" - }, - "topCompanies": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CompanyScoreItem" - } + "minimumSampleCount": { + "type": "integer", + "format": "int32" } } }, - "ApiResponse": { + "CandidateRankingDetailResponse": { "type": "object", "properties": { - "code": { + "applicationId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "message": { + "jobId": { + "type": "integer", + "format": "int64" + }, + "candidateName": { "type": "string" }, - "data": {}, - "requestId": { + "candidateSchool": { "type": "string" }, - "timestamp": { - "type": "string", - "format": "date-time" - } - } - }, - "CareerProgressResponse": { - "type": "object", - "properties": { - "todo": { - "$ref": "#/components/schemas/ProgressTodoSummary" + "overallScore": { + "type": "number" }, - "applications": { - "$ref": "#/components/schemas/PaginatedApplications" + "percentile": { + "type": "number" }, - "generatedAt": { - "type": "string", - "format": "date-time" + "cohortSize": { + "type": "integer", + "format": "int32" + }, + "dimensionScores": { + "type": "array", + "items": { + "$ref": "#/components/schemas/DimensionScoreItem" + } } } }, - "ProgressTodoSummary": { + "CandidateRankingItem": { "type": "object", "properties": { - "pendingInterviewResponseCount": { + "applicationId": { "type": "integer", "format": "int64" }, - "upcomingConfirmedInterviewCount": { + "jobId": { "type": "integer", "format": "int64" }, - "pendingOfferResponseCount": { - "type": "integer", - "format": "int64" + "candidateName": { + "type": "string" }, - "unreadNotificationCount": { - "type": "integer", - "format": "int64" + "candidateSchool": { + "type": "string" }, - "unreadReportDecisionCount": { + "overallScore": { + "type": "number" + }, + "percentile": { + "type": "number" + }, + "sampleCount": { "type": "integer", - "format": "int64" + "format": "int32" } } }, - "PaginatedApplications": { + "CandidateRankingListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { - "$ref": "#/components/schemas/CareerProgressItem" + "$ref": "#/components/schemas/CandidateRankingItem" } }, "total": { @@ -8193,952 +11668,1251 @@ } } }, - "CareerProgressItem": { + "CandidateScoreCardResponse": { "type": "object", "properties": { - "applicationId": { + "candidateId": { "type": "integer", "format": "int64" }, - "applicationStatus": { + "status": { "type": "string" }, - "appliedAt": { + "overallScore": { + "type": "number" + }, + "sampleCount": { + "type": "integer", + "format": "int32" + }, + "feedbackSummary": { + "$ref": "#/components/schemas/CandidateFeedbackSummary" + }, + "matchSignals": { + "$ref": "#/components/schemas/CandidateMatchSignals" + }, + "unsupportedDimensions": { + "type": "array", + "items": { + "type": "string" + } + }, + "generatedAt": { "type": "string", "format": "date-time" + } + } + }, + "CandidateScoreTrendItem": { + "type": "object", + "properties": { + "month": { + "type": "string" }, - "updatedAt": { + "feedbackCount": { + "type": "integer", + "format": "int32" + }, + "averageRating": { + "type": "number" + }, + "ratingScore": { + "type": "number" + } + } + }, + "CandidateScoreTrendResponse": { + "type": "object", + "properties": { + "candidateId": { + "type": "integer", + "format": "int64" + }, + "months": { + "type": "integer", + "format": "int32" + }, + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CandidateScoreTrendItem" + } + } + } + }, + "CandidateScoringOverviewResponse": { + "type": "object", + "properties": { + "candidateId": { + "type": "integer", + "format": "int64" + }, + "status": { + "type": "string" + }, + "overallScore": { + "type": "number" + }, + "weights": { + "type": "object", + "additionalProperties": { + "type": "number" + } + }, + "dimensions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/DimensionItem" + } + }, + "rulesVersion": { + "type": "string" + }, + "generatedAt": { "type": "string", "format": "date-time" }, - "job": { - "$ref": "#/components/schemas/JobSummary" + "explanationVersion": { + "type": "string", + "description": "解释契约版本，与评分规则版本独立" }, - "nextInterview": { - "$ref": "#/components/schemas/InterviewSummary" + "coverage": { + "$ref": "#/components/schemas/CandidateScoringCoverage" }, - "latestSubmittedInterviewScore": { - "$ref": "#/components/schemas/ScoreSummary" + "comparabilityNotice": { + "type": "string" + } + } + }, + "CandidateScoringTrendResponse": { + "type": "object", + "properties": { + "candidateId": { + "type": "integer", + "format": "int64" + }, + "months": { + "type": "integer", + "format": "int32" + }, + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TrendItem" + } + } + } + }, + "CompanyCandidateScoringResponse": { + "type": "object", + "properties": { + "applicationId": { + "type": "integer", + "format": "int64" + }, + "overallScore": { + "type": "number" + }, + "status": { + "type": "string" + }, + "dimensions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CompanyDimensionItem" + } }, - "offer": { - "$ref": "#/components/schemas/OfferSummary" + "generatedAt": { + "type": "string", + "format": "date-time" }, - "competition": { - "$ref": "#/components/schemas/CompetitionSummary" + "rulesVersion": { + "type": "string" } } }, - "JobSummary": { + "CompanyCreateRequest": { "type": "object", "properties": { - "jobId": { - "type": "integer", - "format": "int64" + "name": { + "type": "string", + "maxLength": 100, + "minLength": 0 }, - "title": { + "logoUrl": { "type": "string" }, - "companyName": { + "description": { "type": "string" }, - "city": { + "industry": { "type": "string" }, - "employmentType": { + "website": { "type": "string" }, - "jobStatus": { + "address": { + "type": "string" + } + }, + "required": [ + "name" + ] + }, + "CompanyDimensionItem": { + "type": "object", + "properties": { + "dimension": { + "type": "string" + }, + "score": { + "type": "number" + }, + "status": { "type": "string" } } }, - "InterviewSummary": { + "CompanyMatchRuleRequest": { "type": "object", "properties": { - "interviewId": { + "requiredCandidateScore": { "type": "integer", - "format": "int64" - }, - "roundNo": { + "format": "int32", + "maximum": 100, + "minimum": 0 + } + }, + "required": [ + "requiredCandidateScore" + ] + }, + "CompanyPublicView": { + "type": "object", + "properties": { + "id": { "type": "integer", - "format": "int32" + "format": "int64" }, - "title": { + "name": { "type": "string" }, - "interviewType": { + "logoUrl": { "type": "string" }, - "startAt": { - "type": "string", - "format": "date-time" - }, - "endAt": { - "type": "string", - "format": "date-time" + "description": { + "type": "string" }, - "status": { + "industry": { "type": "string" + }, + "verified": { + "type": "boolean" } } }, - "ScoreSummary": { + "CompanyScoreItem": { "type": "object", "properties": { - "interviewId": { + "companyId": { "type": "integer", "format": "int64" }, - "overallScore": { - "type": "number" - }, - "recommendation": { + "companyName": { "type": "string" }, - "submittedAt": { - "type": "string", - "format": "date-time" + "avgCandidateScore": { + "type": "number" + }, + "jobCount": { + "type": "integer", + "format": "int32" } } }, - "OfferSummary": { + "CompanyUpdateRequest": { "type": "object", "properties": { - "offerId": { - "type": "integer", - "format": "int64" + "name": { + "type": "string", + "maxLength": 120, + "minLength": 0 }, - "status": { - "type": "string" + "logoUrl": { + "type": "string", + "maxLength": 500, + "minLength": 0 }, - "title": { + "description": { "type": "string" }, - "expireAt": { + "industry": { "type": "string", - "format": "date-time" + "maxLength": 80, + "minLength": 0 }, - "onboardingDate": { + "website": { "type": "string", - "format": "date" + "maxLength": 255, + "minLength": 0 + }, + "address": { + "type": "string", + "maxLength": 255, + "minLength": 0 } - } + }, + "required": [ + "name" + ] }, - "CompetitionSummary": { + "CounterOfferCreateRequest": { "type": "object", "properties": { - "eligible": { - "type": "boolean" - }, - "rank": { + "proposedSalaryMin": { "type": "integer", - "format": "int32" + "format": "int32", + "minimum": 0 }, - "cohortSize": { + "proposedSalaryMax": { "type": "integer", - "format": "int32" - }, - "overallScore": { - "type": "number" - }, - "percentile": { - "type": "number" - }, - "status": { - "type": "string" + "format": "int32", + "minimum": 0 }, - "mySnapshotPeriod": { - "type": "string" + "proposedOnboardingDate": { + "type": "string", + "format": "date" }, - "rulesVersion": { - "type": "string" + "reason": { + "type": "string", + "maxLength": 2000, + "minLength": 0 } } }, - "ApiResponseCareerProgressResponse": { + "CreateAppealRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32", - "example": 200 - }, - "message": { + "dimension": { "type": "string", - "example": "ok" - }, - "data": { - "$ref": "#/components/schemas/CareerProgressResponse" + "minLength": 1 }, - "requestId": { + "period": { "type": "string", - "example": "req-1" + "minLength": 1 }, - "timestamp": { + "reason": { + "type": "string" + }, + "idempotencyKey": { "type": "string", - "format": "date-time" + "maxLength": 64, + "minLength": 0 } - } + }, + "required": [ + "dimension", + "period" + ] }, - "ApiResponseAccountDeletionResponse": { + "CreateConversationRequest": { "type": "object", "properties": { - "code": { + "participantUserId": { "type": "integer", - "format": "int32", - "example": 200 + "format": "int64" + } + }, + "required": [ + "participantUserId" + ] + }, + "DashboardOverviewResponse": { + "type": "object", + "properties": { + "companyId": { + "type": "integer", + "format": "int64" }, - "message": { - "type": "string", - "example": "ok" + "totalJobs": { + "type": "integer", + "format": "int32" }, - "data": { - "$ref": "#/components/schemas/AccountDeletionResponse" + "publishedJobs": { + "type": "integer", + "format": "int32" }, - "requestId": { - "type": "string", - "example": "req-1" + "avgJobScore": { + "type": "number" + }, + "totalCandidates": { + "type": "integer", + "format": "int32" + }, + "avgCandidateScore": { + "type": "number" + }, + "scoreDistribution": { + "type": "object", + "additionalProperties": { + "type": "integer", + "format": "int32" + } }, - "timestamp": { + "updatedAt": { "type": "string", "format": "date-time" } } }, - "ApiResponseAdminDashboardOverviewResponse": { + "DataSourceItem": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/AdminDashboardOverviewResponse" - }, - "requestId": { + "source": { "type": "string" }, - "timestamp": { + "time": { "type": "string", "format": "date-time" + }, + "note": { + "type": "string" } } }, - "ApiResponseAppealResponse": { + "DimensionItem": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { + "dimension": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/AppealResponse" + "score": { + "type": "number" }, - "requestId": { + "status": { "type": "string" }, - "timestamp": { - "type": "string", - "format": "date-time" + "weight": { + "type": "number" + }, + "summary": { + "type": "string" } } }, - "ApiResponseCandidateDetailView": { + "DimensionScoreDetailResponse": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { + "dimension": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CandidateDetailView" + "score": { + "type": "number" }, - "requestId": { + "status": { "type": "string" }, - "timestamp": { + "subScores": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SubScore" + } + }, + "reasons": { + "type": "array", + "items": { + "type": "string" + } + }, + "dataSources": { + "type": "array", + "items": { + "$ref": "#/components/schemas/DataSourceItem" + } + }, + "updatedAt": { "type": "string", "format": "date-time" - } - } - }, - "ApiResponseCandidateFeedbackResponse": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" }, - "message": { + "rulesVersion": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CandidateFeedbackResponse" + "displayName": { + "type": "string" }, - "requestId": { + "whatItMeasures": { "type": "string" }, - "timestamp": { + "interpretation": { + "type": "string" + }, + "limitations": { + "type": "array", + "items": { + "type": "string" + } + }, + "evidenceLevel": { "type": "string", - "format": "date-time" - } - } - }, - "ApiResponseCandidateListResponse": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" + "enum": [ + "DIRECT_RULE", + "SELF_REPORTED", + "BEHAVIOR_PROXY", + "UNVALIDATED_PROXY" + ] }, - "message": { - "type": "string" + "ruleContributions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CandidateScoringRuleContribution" + } }, - "data": { - "$ref": "#/components/schemas/CandidateListResponse" + "improvementActions": { + "type": "array", + "items": { + "type": "string" + } }, - "requestId": { + "explanationVersion": { "type": "string" }, - "timestamp": { + "validity": { + "$ref": "#/components/schemas/CandidateScoringValidity" + }, + "calculatedAt": { "type": "string", "format": "date-time" } } }, - "ApiResponseCandidatePercentileResponse": { + "DimensionScoreItem": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { + "dimension": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CandidatePercentileResponse" + "score": { + "type": "number" }, - "requestId": { + "status": { "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" } } }, - "ApiResponseCandidateRankingDetailResponse": { + "InterviewCancelRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/CandidateRankingDetailResponse" - }, - "requestId": { + "reason": { "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" } } }, - "ApiResponseCandidateRankingListResponse": { + "InterviewCreateRequest": { "type": "object", "properties": { - "code": { + "roundNo": { "type": "integer", "format": "int32" }, - "message": { - "type": "string" + "title": { + "type": "string", + "maxLength": 200, + "minLength": 0 }, - "data": { - "$ref": "#/components/schemas/CandidateRankingListResponse" + "interviewType": { + "type": "string", + "minLength": 1 }, - "requestId": { - "type": "string" + "startAt": { + "type": "string", + "format": "date-time" }, - "timestamp": { + "endAt": { "type": "string", "format": "date-time" - } - } - }, - "ApiResponseCandidateScoreCardResponse": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" }, - "message": { + "timezone": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CandidateScoreCardResponse" + "meetingUrl": { + "type": "string" }, - "requestId": { + "address": { "type": "string" }, - "timestamp": { + "interviewerName": { "type": "string", - "format": "date-time" + "maxLength": 100, + "minLength": 0 + }, + "notes": { + "type": "string" } - } + }, + "required": [ + "endAt", + "interviewType", + "startAt", + "title" + ] }, - "ApiResponseCandidateScoreTrendResponse": { + "InterviewRespondRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/CandidateScoreTrendResponse" + "action": { + "type": "string", + "minLength": 1 }, - "requestId": { + "reason": { "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" } - } + }, + "required": [ + "action" + ] }, - "ApiResponseCandidateScoringOverviewResponse": { + "InterviewUpdateRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" + "title": { + "type": "string" + }, + "startAt": { + "type": "string", + "format": "date-time" }, - "message": { + "endAt": { + "type": "string", + "format": "date-time" + }, + "timezone": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CandidateScoringOverviewResponse" + "meetingUrl": { + "type": "string" }, - "requestId": { + "address": { "type": "string" }, - "timestamp": { - "type": "string", - "format": "date-time" + "interviewerName": { + "type": "string" + }, + "notes": { + "type": "string" + }, + "timeRangeValid": { + "type": "boolean" } } }, - "ApiResponseCandidateScoringTrendResponse": { + "JobCreateRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + "title": { + "type": "string", + "maxLength": 120, + "minLength": 0 }, - "data": { - "$ref": "#/components/schemas/CandidateScoringTrendResponse" + "description": { + "type": "string", + "minLength": 1 }, - "requestId": { + "requirements": { "type": "string" }, - "timestamp": { + "city": { "type": "string", - "format": "date-time" + "maxLength": 80, + "minLength": 0 + }, + "employmentType": { + "type": "string", + "maxLength": 30, + "minLength": 0 + }, + "salaryMin": { + "type": "integer", + "format": "int32" + }, + "salaryMax": { + "type": "integer", + "format": "int32" } - } + }, + "required": [ + "city", + "description", + "employmentType", + "title" + ] }, - "ApiResponseCompanyCandidateScoringResponse": { + "JobRankingItem": { "type": "object", "properties": { - "code": { + "jobId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "message": { + "title": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CompanyCandidateScoringResponse" + "city": { + "type": "string" }, - "requestId": { + "employmentType": { "type": "string" }, - "timestamp": { - "type": "string", - "format": "date-time" - } - } - }, - "ApiResponseCompanyPublicView": { - "type": "object", - "properties": { - "code": { + "avgRating": { + "type": "number" + }, + "reviewCount": { "type": "integer", "format": "int32" }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/CompanyPublicView" + "rank": { + "type": "integer", + "format": "int32" }, - "requestId": { - "type": "string" + "cohortSize": { + "type": "integer", + "format": "int32" }, - "timestamp": { - "type": "string", - "format": "date-time" + "dimensionAverages": { + "type": "object", + "additionalProperties": { + "type": "number" + } } } }, - "ApiResponseDashboardOverviewResponse": { + "JobRankingListResponse": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/JobRankingItem" + } }, - "message": { - "type": "string" + "total": { + "type": "integer", + "format": "int64" }, - "data": { - "$ref": "#/components/schemas/DashboardOverviewResponse" + "page": { + "type": "integer", + "format": "int32" }, - "requestId": { - "type": "string" + "size": { + "type": "integer", + "format": "int32" }, - "timestamp": { - "type": "string", - "format": "date-time" + "totalPages": { + "type": "integer", + "format": "int32" } } }, - "ApiResponseDimensionScoreDetailResponse": { + "JobReviewCreateRequest": { "type": "object", "properties": { - "code": { + "rating": { "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + "format": "int32", + "maximum": 5, + "minimum": 1 }, - "data": { - "$ref": "#/components/schemas/DimensionScoreDetailResponse" + "content": { + "type": "string", + "maxLength": 1000, + "minLength": 0 }, - "requestId": { - "type": "string" + "tags": { + "type": "array", + "items": { + "type": "string", + "maxLength": 50, + "minLength": 1 + }, + "maxItems": 10, + "minItems": 0 }, - "timestamp": { - "type": "string", - "format": "date-time" + "dimensionScores": { + "type": "object", + "additionalProperties": { + "type": "integer", + "format": "int32" + } } - } + }, + "required": [ + "content", + "rating" + ] }, - "ApiResponseJobRankingItem": { + "JobReviewUpdateRequest": { "type": "object", "properties": { - "code": { + "rating": { "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + "format": "int32", + "maximum": 5, + "minimum": 1 }, - "data": { - "$ref": "#/components/schemas/JobRankingItem" + "content": { + "type": "string", + "maxLength": 1000, + "minLength": 1 }, - "requestId": { - "type": "string" + "tags": { + "type": "array", + "items": { + "type": "string", + "maxLength": 50, + "minLength": 1 + }, + "maxItems": 10, + "minItems": 0 }, - "timestamp": { + "status": { "type": "string", - "format": "date-time" + "pattern": "^(PUBLISHED|HIDDEN)$" + }, + "dimensionScores": { + "type": "object", + "additionalProperties": { + "type": "integer", + "format": "int32" + } } } }, - "ApiResponseJobRankingListResponse": { + "JobStatusRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/JobRankingListResponse" - }, - "requestId": { - "type": "string" - }, - "timestamp": { + "status": { "type": "string", - "format": "date-time" + "minLength": 1, + "pattern": "^(PUBLISHED|CLOSED)$" } - } + }, + "required": [ + "status" + ] }, - "ApiResponseListAppealHistoryItem": { + "JobUpdateRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" + "title": { + "type": "string", + "maxLength": 120, + "minLength": 0 }, - "message": { + "description": { "type": "string" }, - "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/AppealHistoryItem" - } - }, - "requestId": { + "requirements": { "type": "string" }, - "timestamp": { + "city": { "type": "string", - "format": "date-time" + "maxLength": 80, + "minLength": 0 + }, + "employmentType": { + "type": "string", + "maxLength": 30, + "minLength": 0 + }, + "salaryMin": { + "type": "integer", + "format": "int32" + }, + "salaryMax": { + "type": "integer", + "format": "int32" } } }, - "ApiResponseListMapStringObject": { + "LoginRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + "phone": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{11}" }, - "data": { - "type": "array", - "items": { - "type": "object", - "additionalProperties": {} - } + "code": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{6}" }, - "requestId": { + "purpose": { "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" } - } + }, + "required": [ + "code", + "phone" + ] }, - "ApiResponseListSnapshotHistoryItem": { + "MatchSignal": { "type": "object", "properties": { - "code": { + "average": { + "type": "number" + }, + "sampleCount": { "type": "integer", "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SnapshotHistoryItem" - } - }, - "requestId": { - "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" } } }, - "ApiResponseListWeightTemplateResponse": { + "OfferCreateRequest": { "type": "object", "properties": { - "code": { + "applicationId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "message": { - "type": "string" + "title": { + "type": "string", + "maxLength": 120, + "minLength": 0 }, - "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/WeightTemplateResponse" - } + "salaryMin": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "requestId": { - "type": "string" + "salaryMax": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "timestamp": { + "salaryCurrency": { "type": "string", - "format": "date-time" - } - } - }, - "ApiResponseMapStringObject": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" + "maxLength": 10, + "minLength": 0 }, - "message": { - "type": "string" + "salaryPeriod": { + "type": "string", + "pattern": "^(MONTH|YEAR|HOUR)$" }, - "data": { - "type": "object", - "additionalProperties": {} + "workCity": { + "type": "string", + "maxLength": 80, + "minLength": 0 }, - "requestId": { - "type": "string" + "employmentType": { + "type": "string", + "pattern": "^(FULL_TIME|PART_TIME|INTERN|INTERNSHIP)$" }, - "timestamp": { + "probationMonths": { + "type": "integer", + "format": "int32", + "minimum": 0 + }, + "benefits": { + "type": "string", + "maxLength": 2000, + "minLength": 0 + }, + "description": { + "type": "string", + "maxLength": 5000, + "minLength": 0 + }, + "expireAt": { "type": "string", "format": "date-time" - } - } - }, - "ApiResponseMapStringString": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" }, - "message": { - "type": "string" + "onboardingDate": { + "type": "string", + "format": "date" }, - "data": { - "type": "object", - "additionalProperties": { - "type": "string" - } + "baseSalary": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "requestId": { - "type": "string" + "housingAllowance": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "timestamp": { + "annualBonusMonths": { + "type": "integer", + "format": "int32", + "minimum": 0 + }, + "otherAllowances": { "type": "string", - "format": "date-time" + "maxLength": 1000, + "minLength": 0 } - } + }, + "required": [ + "applicationId", + "description", + "expireAt", + "title", + "workCity" + ] }, - "ApiResponsePersonalizedScoreResponse": { + "OfferStatusRequest": { "type": "object", "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "data": { - "$ref": "#/components/schemas/PersonalizedScoreResponse" - }, - "requestId": { - "type": "string" + "status": { + "type": "string", + "minLength": 1, + "pattern": "^(SENT|NEGOTIATING|ACCEPTED|REJECTED|EXPIRED|WITHDRAWN)$" }, - "timestamp": { + "reason": { "type": "string", - "format": "date-time" + "maxLength": 255, + "minLength": 0 } - } + }, + "required": [ + "status" + ] }, - "ApiResponsePrivacySettingsResponse": { + "OfferUpdateRequest": { "type": "object", "properties": { - "code": { + "title": { + "type": "string", + "maxLength": 120, + "minLength": 0 + }, + "salaryMin": { + "type": "integer", + "format": "int32", + "minimum": 0 + }, + "salaryMax": { "type": "integer", "format": "int32", - "example": 200 + "minimum": 0 }, - "message": { + "salaryCurrency": { "type": "string", - "example": "ok" + "maxLength": 10, + "minLength": 0 }, - "data": { - "$ref": "#/components/schemas/PrivacySettingsResponse" + "salaryPeriod": { + "type": "string", + "pattern": "^(MONTH|YEAR|HOUR)$" }, - "requestId": { + "workCity": { "type": "string", - "example": "req-1" + "maxLength": 80, + "minLength": 0 }, - "timestamp": { + "employmentType": { "type": "string", - "format": "date-time" - } - } - }, - "ApiResponseReviewWeightResponse": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" + "pattern": "^(FULL_TIME|PART_TIME|INTERN|INTERNSHIP)$" }, - "message": { - "type": "string" + "probationMonths": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "data": { - "$ref": "#/components/schemas/ReviewWeightResponse" + "benefits": { + "type": "string", + "maxLength": 2000, + "minLength": 0 }, - "requestId": { - "type": "string" + "description": { + "type": "string", + "maxLength": 5000, + "minLength": 0 }, - "timestamp": { + "expireAt": { "type": "string", "format": "date-time" - } - } - }, - "ApiResponseScoreTrendResponse": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" }, - "message": { - "type": "string" + "onboardingDate": { + "type": "string", + "format": "date" }, - "data": { - "$ref": "#/components/schemas/ScoreTrendResponse" + "baseSalary": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "requestId": { - "type": "string" + "housingAllowance": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "timestamp": { + "annualBonusMonths": { + "type": "integer", + "format": "int32", + "minimum": 0 + }, + "otherAllowances": { "type": "string", - "format": "date-time" + "maxLength": 1000, + "minLength": 0 } } }, - "AppealDecisionRequest": { - "type": "object", - "properties": { - "decision": { - "type": "string", - "minLength": 1 - }, - "reason": { - "type": "string" - } - }, - "required": [ - "decision" - ] - }, - "AppealHistoryItem": { + "PersonalizedScoreResponse": { "type": "object", "properties": { - "id": { + "jobId": { "type": "integer", "format": "int64" }, - "fromStatus": { - "type": "string" + "score": { + "type": "number" }, - "toStatus": { + "status": { "type": "string" }, - "actorUserId": { - "type": "integer", - "format": "int64" - }, - "actorRole": { + "source": { "type": "string" }, - "reason": { + "templateCode": { "type": "string" }, - "createdAt": { - "type": "string", - "format": "date-time" + "configuredWeights": { + "type": "object", + "additionalProperties": { + "type": "number" + } + }, + "effectiveWeights": { + "type": "object", + "additionalProperties": { + "type": "number" + } + }, + "dimensionScores": { + "type": "object", + "additionalProperties": { + "type": "number" + } + }, + "coveredWeight": { + "type": "number" + }, + "missingDimensions": { + "type": "array", + "items": { + "type": "string" + } } } }, - "AppealResponse": { + "PrivacySettingsResponse": { "type": "object", "properties": { - "appealId": { + "id": { "type": "integer", - "format": "int64" + "format": "int64", + "example": 1, + "nullable": true }, - "candidateId": { + "studentUserId": { "type": "integer", - "format": "int64" - }, - "dimension": { - "type": "string" - }, - "period": { - "type": "string" - }, - "status": { - "type": "string" - }, - "reason": { - "type": "string" + "format": "int64", + "example": 2 }, - "decision": { - "type": "string" + "resumeVisibility": { + "$ref": "#/components/schemas/ResumeVisibility", + "description": "简历可见性（PRIVATE/APPLIED_COMPANIES/VERIFIED_COMPANIES）", + "example": "APPLIED_COMPANIES" }, - "decisionReason": { - "type": "string" + "contactVisible": { + "type": "boolean", + "example": true }, - "reviewerId": { + "version": { "type": "integer", - "format": "int64" + "format": "int64", + "example": 0 }, - "reviewedAt": { + "createdAt": { "type": "string", - "format": "date-time" + "format": "date-time", + "nullable": true }, - "rollbackAt": { + "updatedAt": { "type": "string", - "format": "date-time" + "format": "date-time", + "nullable": true + } + } + }, + "PrivacySettingsUpdateRequest": { + "type": "object", + "required": [ + "resumeVisibility", + "contactVisible" + ], + "properties": { + "resumeVisibility": { + "$ref": "#/components/schemas/ResumeVisibility", + "description": "简历可见性（必填）", + "example": "APPLIED_COMPANIES" }, - "scoreAtAppeal": { - "type": "number" + "contactVisible": { + "type": "boolean", + "description": "联系方式是否对企业可见（必填）", + "example": true }, - "snapshotVersionAtAppeal": { + "version": { "type": "integer", - "format": "int64" + "format": "int64", + "description": "乐观锁版本号（可选）", + "example": 0 + } + } + }, + "ResumeVisibility": { + "type": "string", + "enum": [ + "PRIVATE", + "APPLIED_COMPANIES", + "VERIFIED_COMPANIES" + ], + "description": "简历可见性：PRIVATE 私有；APPLIED_COMPANIES 仅对企业有效投递可见；VERIFIED_COMPANIES 仅对认证企业可见", + "example": "PRIVATE" + }, + "ReviewDecisionRequest": { + "type": "object", + "properties": { + "decision": { + "type": "string", + "minLength": 1, + "pattern": "^(APPROVED|REJECTED)$" + }, + "reason": { + "type": "string", + "maxLength": 500, + "minLength": 0 + } + }, + "required": [ + "decision" + ] + }, + "ReviewWeightResponse": { + "type": "object", + "properties": { + "source": { + "type": "string" }, - "rulesVersion": { + "templateCode": { "type": "string" }, - "createdAt": { - "type": "string", - "format": "date-time" + "configuredWeights": { + "type": "object", + "additionalProperties": { + "type": "number" + } }, "updatedAt": { "type": "string", @@ -9146,2069 +12920,2589 @@ } } }, - "ApplicationCreateRequest": { + "SaveWeightRequest": { "type": "object", "properties": { - "jobId": { + "templateCode": { + "type": "string" + }, + "weights": { + "type": "object", + "additionalProperties": { + "type": "number" + } + } + } + }, + "ScoreRequest": { + "type": "object", + "properties": { + "score": { "type": "integer", - "format": "int64" + "format": "int32", + "maximum": 100, + "minimum": 0 } }, "required": [ - "jobId" + "score" ] }, - "ApplicationStatusRequest": { + "ScoreTrendResponse": { "type": "object", "properties": { - "status": { + "companyId": { + "type": "integer", + "format": "int64" + }, + "months": { + "type": "integer", + "format": "int32" + }, + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TrendItem" + } + } + } + }, + "SendMessageRequest": { + "type": "object", + "properties": { + "conversationId": { + "type": "integer", + "format": "int64" + }, + "content": { "type": "string", - "minLength": 1, - "pattern": "^(VIEWED|INTERVIEW|REJECTED|HIRED)$" + "maxLength": 2000, + "minLength": 0 } }, "required": [ - "status" + "content", + "conversationId" ] }, - "CandidateDetailView": { + "SnapshotHistoryItem": { "type": "object", "properties": { - "applicationId": { + "id": { "type": "integer", "format": "int64" }, - "jobId": { + "appealId": { "type": "integer", "format": "int64" }, - "jobTitle": { - "type": "string" - }, - "jobCity": { - "type": "string" - }, - "jobEmploymentType": { + "action": { "type": "string" }, - "status": { + "dimension": { "type": "string" }, - "coverLetter": { + "period": { "type": "string" }, - "createdAt": { - "type": "string", - "format": "date-time" - }, - "updatedAt": { - "type": "string", - "format": "date-time" - }, - "candidateName": { - "type": "string" + "beforeScore": { + "type": "number" }, - "candidateAvatarUrl": { - "type": "string" + "afterScore": { + "type": "number" }, - "candidateBio": { - "type": "string" + "beforeVersion": { + "type": "integer", + "format": "int64" }, - "candidateLocation": { - "type": "string" + "afterVersion": { + "type": "integer", + "format": "int64" }, - "candidateSchool": { + "beforeRulesVersion": { "type": "string" }, - "candidateEducation": { + "afterRulesVersion": { "type": "string" }, - "candidateGraduationYear": { - "type": "integer", - "format": "int32" - }, - "candidateSkills": { - "type": "array", - "items": { - "type": "string" - } + "createdAt": { + "type": "string", + "format": "date-time" } } }, - "CandidateFeedbackRequest": { + "StudentMatchRuleRequest": { "type": "object", "properties": { - "rating": { + "requiredHrScore": { "type": "integer", "format": "int32", - "maximum": 5, - "minimum": 1 + "maximum": 100, + "minimum": 0 + } + }, + "required": [ + "requiredHrScore" + ] + }, + "StudentPreferenceRequest": { + "type": "object", + "properties": { + "expectedSalaryMin": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "content": { - "type": "string", - "maxLength": 1000, - "minLength": 0 + "expectedSalaryMax": { + "type": "integer", + "format": "int32", + "minimum": 0 }, - "tags": { + "preferredCities": { "type": "array", "items": { "type": "string", - "maxLength": 50, + "maxLength": 100, "minLength": 1 }, - "maxItems": 10, + "maxItems": 20, + "minItems": 0 + }, + "employmentTypes": { + "type": "array", + "items": { + "type": "string", + "maxLength": 100, + "minLength": 1 + }, + "maxItems": 20, + "minItems": 0 + }, + "preferredIndustries": { + "type": "array", + "items": { + "type": "string", + "maxLength": 100, + "minLength": 1 + }, + "maxItems": 20, "minItems": 0 + }, + "preferredJobTypes": { + "type": "array", + "items": { + "type": "string", + "maxLength": 100, + "minLength": 1 + }, + "maxItems": 20, + "minItems": 0 + }, + "remoteAllowed": { + "type": "boolean" + }, + "salaryRangeValid": { + "type": "boolean" } - }, - "required": [ - "content", - "rating" - ] + } }, - "CandidateFeedbackResponse": { + "StudentProfileUpdateRequest": { "type": "object", - "description": "脱敏后的候选人反馈", "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "反馈 ID", - "example": 1 + "realName": { + "type": "string", + "maxLength": 50, + "minLength": 0 }, - "applicationId": { - "type": "integer", - "format": "int64", - "description": "投递 ID", - "example": 31 + "bio": { + "type": "string" }, - "rating": { + "location": { + "type": "string", + "maxLength": 100, + "minLength": 0 + }, + "education": { + "type": "string", + "maxLength": 100, + "minLength": 0 + }, + "school": { + "type": "string", + "maxLength": 150, + "minLength": 0 + }, + "graduationYear": { "type": "integer", - "format": "int32", - "description": "评分，范围 1-5", - "example": 5 + "format": "int32" }, - "content": { + "resumeUrl": { "type": "string", - "description": "反馈内容", - "example": "沟通良好" + "maxLength": 500, + "minLength": 0 }, - "tags": { + "skills": { "type": "array", - "description": "反馈标签", "items": { "type": "string" } + } + } + }, + "SubScore": { + "type": "object", + "properties": { + "name": { + "type": "string" }, - "createdAt": { - "type": "string", - "format": "date-time", - "description": "创建时间", - "example": "2026-08-25T10:00:00" + "score": { + "type": "number" }, - "updatedAt": { - "type": "string", - "format": "date-time", - "description": "更新时间", - "example": "2026-08-25T10:00:00" + "weight": { + "type": "number" + }, + "description": { + "type": "string" } } }, - "CandidateFeedbackSummary": { + "TagCount": { "type": "object", "properties": { - "totalCount": { + "name": { + "type": "string" + }, + "count": { "type": "integer", "format": "int32" + } + } + }, + "TrendItem": { + "type": "object", + "properties": { + "period": { + "type": "string" }, - "averageRating": { + "overallScore": { "type": "number" }, - "ratingDistribution": { + "rulesVersion": { + "type": "string" + }, + "dimensions": { "type": "object", "additionalProperties": { - "type": "integer", - "format": "int32" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/components/schemas/TagCount" + "type": "number" } } } }, - "CandidateItemView": { + "VerificationDecisionRequest": { "type": "object", "properties": { - "applicationId": { - "type": "integer", - "format": "int64" - }, - "jobId": { - "type": "integer", - "format": "int64" - }, - "jobTitle": { - "type": "string" - }, - "status": { - "type": "string" + "decision": { + "type": "string", + "minLength": 1 }, - "candidateName": { + "reason": { "type": "string" - }, - "candidateSchool": { + } + }, + "required": [ + "decision" + ] + }, + "VerificationSubmitRequest": { + "type": "object", + "properties": { + "materialsJson": { + "type": "string", + "minLength": 1 + } + }, + "required": [ + "materialsJson" + ] + }, + "WeightTemplateResponse": { + "type": "object", + "properties": { + "code": { "type": "string" }, - "candidateEducation": { + "name": { "type": "string" }, - "candidateGraduationYear": { - "type": "integer", - "format": "int32" - }, - "candidateAvatarUrl": { + "description": { "type": "string" }, - "createdAt": { - "type": "string", - "format": "date-time" - }, - "updatedAt": { - "type": "string", - "format": "date-time" + "weights": { + "type": "object", + "additionalProperties": { + "type": "number" + } } } }, - "CandidateListResponse": { + "InterviewScoreSaveRequest": { "type": "object", "properties": { - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CandidateItemView" - } + "technicalScore": { + "type": "integer", + "minimum": 1, + "maximum": 5, + "nullable": true }, - "total": { + "communicationScore": { "type": "integer", - "format": "int64" + "minimum": 1, + "maximum": 5, + "nullable": true }, - "page": { + "problemSolvingScore": { "type": "integer", - "format": "int32" + "minimum": 1, + "maximum": 5, + "nullable": true }, - "size": { + "roleFitScore": { "type": "integer", - "format": "int32" + "minimum": 1, + "maximum": 5, + "nullable": true }, - "totalPages": { + "professionalismScore": { "type": "integer", - "format": "int32" - } - } - }, - "CandidateMatchSignals": { - "type": "object", - "properties": { - "candidateInterestScore": { - "$ref": "#/components/schemas/MatchSignal" + "minimum": 1, + "maximum": 5, + "nullable": true }, - "hrSuitabilityScore": { - "$ref": "#/components/schemas/MatchSignal" + "recommendation": { + "type": "string", + "enum": [ + "STRONG_HIRE", + "HIRE", + "NEUTRAL", + "NO_HIRE" + ], + "nullable": true, + "description": "企业手动选择，不根据 overallScore 自动推导" + }, + "comment": { + "type": "string", + "nullable": true } - } + }, + "description": "评分草稿保存请求；overallScore 由服务端计算，客户端不得传入" }, - "CandidatePercentileResponse": { + "InterviewScoreResponse": { "type": "object", "properties": { - "candidateId": { + "id": { + "type": "integer", + "format": "int64" + }, + "interviewId": { + "type": "integer", + "format": "int64" + }, + "applicationId": { "type": "integer", "format": "int64" }, "status": { - "type": "string" + "type": "string", + "enum": [ + "DRAFT", + "SUBMITTED" + ] }, - "scoreType": { - "type": "string" + "technicalScore": { + "type": "integer", + "nullable": true }, - "score": { - "type": "number" + "communicationScore": { + "type": "integer", + "nullable": true }, - "percentile": { - "type": "number" + "problemSolvingScore": { + "type": "integer", + "nullable": true }, - "cohortSize": { + "roleFitScore": { "type": "integer", - "format": "int32" + "nullable": true }, - "sampleCount": { + "professionalismScore": { "type": "integer", - "format": "int32" + "nullable": true + }, + "overallScore": { + "type": "number", + "format": "decimal", + "nullable": true, + "description": "由服务端 BigDecimal 计算：(t+c+ps+rf+p)/5，保留两位小数 HALF_UP" + }, + "recommendation": { + "type": "string", + "enum": [ + "STRONG_HIRE", + "HIRE", + "NEUTRAL", + "NO_HIRE" + ], + "nullable": true + }, + "comment": { + "type": "string", + "nullable": true + }, + "submittedAt": { + "type": "string", + "format": "date-time", + "nullable": true }, - "minimumSampleCount": { + "version": { "type": "integer", - "format": "int32" + "format": "int64" + }, + "createdAt": { + "type": "string", + "format": "date-time" + }, + "updatedAt": { + "type": "string", + "format": "date-time" } - } + }, + "description": "面试评分响应（脱敏：不返回 companyUserId/studentUserId/evaluatorUserId/手机号/邮箱）" }, - "CandidateRankingDetailResponse": { + "ApiResponseInterviewScoreResponse": { "type": "object", "properties": { - "applicationId": { - "type": "integer", - "format": "int64" - }, - "jobId": { + "code": { "type": "integer", - "format": "int64" - }, - "candidateName": { - "type": "string" + "format": "int32" }, - "candidateSchool": { + "message": { "type": "string" }, - "overallScore": { - "type": "number" - }, - "percentile": { - "type": "number" + "data": { + "$ref": "#/components/schemas/InterviewScoreResponse" }, - "cohortSize": { - "type": "integer", - "format": "int32" + "requestId": { + "type": "string" }, - "dimensionScores": { - "type": "array", - "items": { - "$ref": "#/components/schemas/DimensionScoreItem" - } + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "CandidateRankingItem": { + "InterviewScoreHistoryItem": { "type": "object", "properties": { - "applicationId": { + "id": { "type": "integer", "format": "int64" }, - "jobId": { + "scoreId": { "type": "integer", "format": "int64" }, - "candidateName": { - "type": "string" + "interviewId": { + "type": "integer", + "format": "int64" }, - "candidateSchool": { - "type": "string" + "fromStatus": { + "type": "string", + "enum": [ + "DRAFT", + "SUBMITTED" + ], + "nullable": true }, - "overallScore": { - "type": "number" + "toStatus": { + "type": "string", + "enum": [ + "DRAFT", + "SUBMITTED" + ] }, - "percentile": { - "type": "number" + "actorRole": { + "type": "string", + "example": "COMPANY" }, - "sampleCount": { - "type": "integer", - "format": "int32" + "snapshot": { + "type": "object", + "additionalProperties": {} + }, + "createdAt": { + "type": "string", + "format": "date-time" } - } + }, + "description": "评分历史条目（脱敏：不返回 actorUserId/手机号/邮箱）" }, - "CandidateRankingListResponse": { + "ApiResponseListInterviewScoreHistoryItem": { "type": "object", "properties": { - "items": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "data": { "type": "array", "items": { - "$ref": "#/components/schemas/CandidateRankingItem" + "$ref": "#/components/schemas/InterviewScoreHistoryItem" } }, - "total": { - "type": "integer", - "format": "int64" - }, - "page": { - "type": "integer", - "format": "int32" - }, - "size": { - "type": "integer", - "format": "int32" + "requestId": { + "type": "string" }, - "totalPages": { - "type": "integer", - "format": "int32" + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "CandidateScoreCardResponse": { + "CreateReportRequest": { "type": "object", "properties": { - "candidateId": { - "type": "integer", - "format": "int64" - }, - "status": { - "type": "string" + "targetType": { + "type": "string", + "enum": [ + "USER", + "MESSAGE" + ], + "description": "举报目标类型；USER 必填 targetUserId，MESSAGE 必填 messageId" }, - "overallScore": { - "type": "number" + "targetUserId": { + "type": "integer", + "format": "int64", + "description": "targetType=USER 时必填" }, - "sampleCount": { + "messageId": { "type": "integer", - "format": "int32" + "format": "int64", + "description": "targetType=MESSAGE 时必填" }, - "feedbackSummary": { - "$ref": "#/components/schemas/CandidateFeedbackSummary" + "category": { + "type": "string", + "maxLength": 40, + "description": "举报分类，如 HARASSMENT" }, - "matchSignals": { - "$ref": "#/components/schemas/CandidateMatchSignals" + "reason": { + "type": "string", + "minLength": 1, + "maxLength": 1000 }, - "unsupportedDimensions": { + "evidenceUrls": { "type": "array", "items": { - "type": "string" - } + "type": "string", + "maxLength": 500 + }, + "description": "最多 5 个，仅 http/https，最多 500 字符" }, - "generatedAt": { + "idempotencyKey": { "type": "string", - "format": "date-time" + "maxLength": 64, + "description": "幂等键（可选）" } } }, - "CandidateScoreTrendItem": { + "ReportDecisionRequest": { "type": "object", "properties": { - "month": { - "type": "string" - }, - "feedbackCount": { - "type": "integer", - "format": "int32" - }, - "averageRating": { - "type": "number" + "decision": { + "type": "string", + "enum": [ + "RESOLVED", + "REJECTED" + ] }, - "ratingScore": { - "type": "number" + "note": { + "type": "string", + "maxLength": 1000, + "description": "REJECTED 必填" } } }, - "CandidateScoreTrendResponse": { + "ReportResponse": { "type": "object", "properties": { - "candidateId": { + "id": { "type": "integer", "format": "int64" }, - "months": { + "targetType": { + "type": "string", + "enum": [ + "USER", + "MESSAGE" + ] + }, + "targetUserId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CandidateScoreTrendItem" - } - } - } - }, - "CandidateScoringOverviewResponse": { - "type": "object", - "properties": { - "candidateId": { + "messageId": { "type": "integer", "format": "int64" }, - "status": { - "type": "string" + "reportedUserId": { + "type": "integer", + "format": "int64" }, - "overallScore": { - "type": "number" + "category": { + "type": "string" }, - "weights": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "reason": { + "type": "string" }, - "dimensions": { + "evidenceUrls": { "type": "array", "items": { - "$ref": "#/components/schemas/DimensionItem" + "type": "string" } }, - "rulesVersion": { + "status": { + "type": "string", + "enum": [ + "PENDING", + "RESOLVED", + "REJECTED" + ] + }, + "decision": { + "type": "string", + "enum": [ + "RESOLVED", + "REJECTED" + ] + }, + "decisionNote": { "type": "string" }, - "generatedAt": { + "decidedAt": { "type": "string", "format": "date-time" - } - } - }, - "CandidateScoringTrendResponse": { - "type": "object", - "properties": { - "candidateId": { - "type": "integer", - "format": "int64" }, - "months": { - "type": "integer", - "format": "int32" + "createdAt": { + "type": "string", + "format": "date-time" + }, + "updatedAt": { + "type": "string", + "format": "date-time" + }, + "messagePreview": { + "type": "string", + "description": "MESSAGE 举报的脱敏消息预览，不返回会话其他敏感内容" + }, + "reportedUser": { + "$ref": "#/components/schemas/ReportResponseReportedUser" }, - "items": { + "history": { "type": "array", "items": { - "$ref": "#/components/schemas/TrendItem" + "$ref": "#/components/schemas/ReportResponseDecisionHistoryItem" } } } }, - "CompanyCandidateScoringResponse": { + "ReportResponseReportedUser": { "type": "object", "properties": { - "applicationId": { + "userId": { "type": "integer", "format": "int64" }, - "overallScore": { - "type": "number" - }, - "status": { + "nickname": { "type": "string" }, - "dimensions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CompanyDimensionItem" - } - }, - "generatedAt": { - "type": "string", - "format": "date-time" - }, - "rulesVersion": { + "role": { "type": "string" } } }, - "CompanyCreateRequest": { + "ReportResponseDecisionHistoryItem": { "type": "object", "properties": { - "name": { - "type": "string", - "maxLength": 100, - "minLength": 0 + "id": { + "type": "integer", + "format": "int64" }, - "logoUrl": { + "fromStatus": { "type": "string" }, - "description": { + "toStatus": { "type": "string" }, - "industry": { - "type": "string" + "actorUserId": { + "type": "integer", + "format": "int64" }, - "website": { + "actorRole": { "type": "string" }, - "address": { + "note": { "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" } - }, - "required": [ - "name" - ] + } }, - "CompanyDimensionItem": { + "BlockRelationResponse": { "type": "object", "properties": { - "dimension": { - "type": "string" + "id": { + "type": "integer", + "format": "int64" }, - "score": { - "type": "number" + "blockedUserId": { + "type": "integer", + "format": "int64" }, - "status": { + "nickname": { "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" } } }, - "CompanyMatchRuleRequest": { - "type": "object", - "properties": { - "requiredCandidateScore": { - "type": "integer", - "format": "int32", - "maximum": 100, - "minimum": 0 - } - }, - "required": [ - "requiredCandidateScore" - ] - }, - "CompanyPublicView": { + "ApiResponseReportResponse": { "type": "object", "properties": { - "id": { + "code": { "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" + "format": "int32" }, - "logoUrl": { + "message": { "type": "string" }, - "description": { - "type": "string" + "data": { + "$ref": "#/components/schemas/ReportResponse" }, - "industry": { + "requestId": { "type": "string" }, - "verified": { - "type": "boolean" + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "CompanyScoreItem": { + "ApiResponsePageResponseReportResponse": { "type": "object", "properties": { - "companyId": { + "code": { "type": "integer", - "format": "int64" + "format": "int32" }, - "companyName": { + "message": { "type": "string" }, - "avgCandidateScore": { - "type": "number" + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReportResponse" + } + }, + "totalElements": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + } + } }, - "jobCount": { - "type": "integer", - "format": "int32" + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "CompanyUpdateRequest": { + "ApiResponseBlockRelationResponse": { "type": "object", "properties": { - "name": { - "type": "string", - "maxLength": 120, - "minLength": 0 - }, - "logoUrl": { - "type": "string", - "maxLength": 500, - "minLength": 0 + "code": { + "type": "integer", + "format": "int32" }, - "description": { + "message": { "type": "string" }, - "industry": { - "type": "string", - "maxLength": 80, - "minLength": 0 + "data": { + "$ref": "#/components/schemas/BlockRelationResponse" }, - "website": { - "type": "string", - "maxLength": 255, - "minLength": 0 + "requestId": { + "type": "string" }, - "address": { + "timestamp": { "type": "string", - "maxLength": 255, - "minLength": 0 + "format": "date-time" } - }, - "required": [ - "name" - ] + } }, - "CounterOfferCreateRequest": { + "ApiResponsePageResponseBlockRelationResponse": { "type": "object", "properties": { - "proposedSalaryMin": { + "code": { "type": "integer", - "format": "int32", - "minimum": 0 + "format": "int32" }, - "proposedSalaryMax": { - "type": "integer", - "format": "int32", - "minimum": 0 + "message": { + "type": "string" }, - "proposedOnboardingDate": { - "type": "string", - "format": "date" + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/BlockRelationResponse" + } + }, + "totalElements": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + } + } }, - "reason": { + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", - "maxLength": 2000, - "minLength": 0 + "format": "date-time" } } }, - "CreateAppealRequest": { + "CreateAbilityAttemptRequest": { "type": "object", + "required": [ + "typeCode" + ], "properties": { - "dimension": { - "type": "string", - "minLength": 1 - }, - "period": { - "type": "string", - "minLength": 1 - }, - "reason": { + "typeCode": { "type": "string" }, "idempotencyKey": { "type": "string", - "maxLength": 64, - "minLength": 0 + "maxLength": 64 } - }, + } + }, + "SaveAbilityAnswersRequest": { + "type": "object", "required": [ - "dimension", - "period" - ] + "answers" + ], + "properties": { + "answers": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityAnswerItem" + } + } + } }, - "CreateConversationRequest": { + "AbilityAnswerItem": { "type": "object", + "required": [ + "attemptQuestionId", + "selectedOptionId" + ], "properties": { - "participantUserId": { + "attemptQuestionId": { + "type": "integer", + "format": "int64" + }, + "selectedOptionId": { + "type": "string", + "maxLength": 4 + } + } + }, + "AbilityTypeResponse": { + "type": "object", + "properties": { + "typeCode": { + "type": "string" + }, + "displayName": { + "type": "string" + }, + "description": { + "type": "string" + }, + "questionCount": { + "type": "integer", + "format": "int32" + }, + "attemptQuestionCount": { "type": "integer", - "format": "int64" + "format": "int32" + }, + "timeLimitMinutes": { + "type": "integer", + "format": "int32" + }, + "resultValidDays": { + "type": "integer", + "format": "int32" + }, + "status": { + "type": "string" } - }, - "required": [ - "participantUserId" - ] + } }, - "DashboardOverviewResponse": { + "AbilityAttemptResponse": { "type": "object", "properties": { - "companyId": { + "attemptId": { "type": "integer", "format": "int64" }, - "totalJobs": { - "type": "integer", - "format": "int32" + "status": { + "type": "string" }, - "publishedJobs": { + "answeredCount": { "type": "integer", "format": "int32" }, - "avgJobScore": { - "type": "number" - }, - "totalCandidates": { + "totalQuestions": { "type": "integer", "format": "int32" }, - "avgCandidateScore": { + "completionRate": { "type": "number" }, - "scoreDistribution": { - "type": "object", - "additionalProperties": { - "type": "integer", - "format": "int32" - } + "startedAt": { + "type": "string", + "format": "date-time", + "nullable": true }, - "updatedAt": { + "expiresAt": { "type": "string", - "format": "date-time" + "format": "date-time", + "nullable": true + }, + "remainingSeconds": { + "type": "integer", + "format": "int64", + "nullable": true + }, + "questions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityAttemptQuestionView" + } } } }, - "DataSourceItem": { + "AbilityAttemptQuestionView": { "type": "object", "properties": { - "source": { + "attemptQuestionId": { + "type": "integer", + "format": "int64" + }, + "position": { + "type": "integer", + "format": "int32" + }, + "itemType": { "type": "string" }, - "time": { - "type": "string", - "format": "date-time" + "stem": { + "type": "string" }, - "note": { + "options": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityOptionView" + } + }, + "selectedOptionId": { "type": "string" } } }, - "DimensionItem": { + "AbilityOptionView": { "type": "object", "properties": { - "dimension": { - "type": "string" - }, - "score": { - "type": "number" - }, - "status": { + "optionId": { "type": "string" }, - "weight": { - "type": "number" - }, - "summary": { + "text": { "type": "string" } } }, - "DimensionScoreDetailResponse": { + "AbilityResultResponse": { "type": "object", "properties": { - "dimension": { - "type": "string" + "attemptId": { + "type": "integer", + "format": "int64" }, - "score": { - "type": "number" + "typeCode": { + "type": "string" }, "status": { "type": "string" }, - "subScores": { + "validityStatus": { + "type": "string" + }, + "validUntil": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "dimensionScores": { "type": "array", "items": { - "$ref": "#/components/schemas/SubScore" + "$ref": "#/components/schemas/AbilityDimensionScore" } }, - "reasons": { + "overallScore": { + "type": "number" + }, + "weaknesses": { "type": "array", "items": { - "type": "string" + "$ref": "#/components/schemas/AbilityWeakness" } }, - "dataSources": { + "improvementAreas": { "type": "array", "items": { - "$ref": "#/components/schemas/DataSourceItem" + "$ref": "#/components/schemas/AbilityImprovementArea" } }, - "updatedAt": { + "radar": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityRadarEntry" + } + }, + "answeredCount": { + "type": "integer", + "format": "int32" + }, + "completionRate": { + "type": "number" + }, + "questionFeedback": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityQuestionFeedback" + } + }, + "questionSetVersion": { + "type": "string" + }, + "rulesVersion": { + "type": "string" + }, + "generatedAt": { "type": "string", "format": "date-time" }, - "rulesVersion": { + "disclaimer": { "type": "string" } } }, - "DimensionScoreItem": { + "AbilityDimensionScore": { "type": "object", "properties": { - "dimension": { + "code": { "type": "string" }, "score": { "type": "number" }, - "status": { - "type": "string" + "answeredCount": { + "type": "integer", + "format": "int32" } } }, - "InterviewCancelRequest": { + "AbilityWeakness": { "type": "object", "properties": { - "reason": { + "code": { "type": "string" + }, + "score": { + "type": "number" } } }, - "InterviewCreateRequest": { + "AbilityImprovementArea": { "type": "object", "properties": { - "roundNo": { - "type": "integer", - "format": "int32" + "dimension": { + "type": "string" }, - "title": { - "type": "string", - "maxLength": 200, - "minLength": 0 + "currentScore": { + "type": "number" }, - "interviewType": { - "type": "string", - "minLength": 1 + "summary": { + "type": "string" }, - "startAt": { - "type": "string", - "format": "date-time" + "actions": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "AbilityRadarEntry": { + "type": "object", + "properties": { + "code": { + "type": "string" }, - "endAt": { - "type": "string", - "format": "date-time" + "value": { + "type": "number" + } + } + }, + "AbilityQuestionFeedback": { + "type": "object", + "properties": { + "attemptQuestionId": { + "type": "integer", + "format": "int64" }, - "timezone": { - "type": "string" + "position": { + "type": "integer", + "format": "int32" }, - "meetingUrl": { + "stem": { "type": "string" }, - "address": { + "selectedOptionId": { "type": "string" }, - "interviewerName": { - "type": "string", - "maxLength": 100, - "minLength": 0 + "awardedScore": { + "type": "integer", + "format": "int32" }, - "notes": { + "maxScore": { + "type": "integer", + "format": "int32" + }, + "explanation": { "type": "string" } - }, - "required": [ - "endAt", - "interviewType", - "startAt", - "title" - ] + } }, - "InterviewRespondRequest": { + "AbilityHistoryItem": { "type": "object", "properties": { - "action": { - "type": "string", - "minLength": 1 + "attemptId": { + "type": "integer", + "format": "int64" }, - "reason": { + "typeCode": { + "type": "string" + }, + "status": { + "type": "string" + }, + "validityStatus": { "type": "string" + }, + "overallScore": { + "type": "number" + }, + "answeredCount": { + "type": "integer", + "format": "int32" + }, + "completionRate": { + "type": "number" + }, + "startedAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "expiresAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "completedAt": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "validUntil": { + "type": "string", + "format": "date-time", + "nullable": true } - }, - "required": [ - "action" - ] + } }, - "InterviewUpdateRequest": { + "ApiResponseAbilityTypeResponse": { "type": "object", "properties": { - "title": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { "type": "string" }, - "startAt": { - "type": "string", - "format": "date-time" + "data": { + "$ref": "#/components/schemas/AbilityTypeResponse" + }, + "requestId": { + "type": "string" }, - "endAt": { + "timestamp": { "type": "string", "format": "date-time" + } + } + }, + "ApiResponseAbilityAttemptResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" }, - "timezone": { + "message": { "type": "string" }, - "meetingUrl": { - "type": "string" + "data": { + "$ref": "#/components/schemas/AbilityAttemptResponse" }, - "address": { + "requestId": { "type": "string" }, - "interviewerName": { + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseAbilityResultResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { "type": "string" }, - "notes": { + "data": { + "$ref": "#/components/schemas/AbilityResultResponse" + }, + "requestId": { "type": "string" }, - "timeRangeValid": { - "type": "boolean" + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "JobCreateRequest": { + "ApiResponsePageResponseAbilityHistoryItem": { "type": "object", "properties": { - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 + "code": { + "type": "integer", + "format": "int32" }, - "description": { - "type": "string", - "minLength": 1 + "message": { + "type": "string" }, - "requirements": { + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/AbilityHistoryItem" + } + }, + "totalElements": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + } + } + }, + "requestId": { "type": "string" }, - "city": { + "timestamp": { "type": "string", - "maxLength": 80, - "minLength": 0 + "format": "date-time" + } + } + }, + "RiskRuleResponse": { + "type": "object", + "properties": { + "ruleCode": { + "type": "string" }, - "employmentType": { - "type": "string", - "maxLength": 30, - "minLength": 0 + "sourceAction": { + "type": "string" }, - "salaryMin": { + "thresholdCount": { "type": "integer", "format": "int32" }, - "salaryMax": { + "windowMinutes": { "type": "integer", "format": "int32" + }, + "severity": { + "type": "string" + }, + "enabled": { + "type": "boolean" + }, + "version": { + "type": "integer", + "format": "int64" } - }, - "required": [ - "city", - "description", - "employmentType", - "title" - ] + } }, - "JobRankingItem": { + "RiskEventResponse": { "type": "object", "properties": { - "jobId": { + "eventId": { "type": "integer", "format": "int64" }, - "title": { + "ruleCode": { "type": "string" }, - "city": { + "sourceAction": { "type": "string" }, - "employmentType": { + "severity": { "type": "string" }, - "avgRating": { - "type": "number" + "status": { + "type": "string" }, - "reviewCount": { + "occurrenceCount": { "type": "integer", "format": "int32" }, - "rank": { - "type": "integer", - "format": "int32" + "windowStartedAt": { + "type": "string", + "format": "date-time" }, - "cohortSize": { - "type": "integer", - "format": "int32" + "windowEndedAt": { + "type": "string", + "format": "date-time" }, - "dimensionAverages": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "detectedAt": { + "type": "string", + "format": "date-time" + }, + "version": { + "type": "integer", + "format": "int64" } } }, - "JobRankingListResponse": { + "RiskSeverityCount": { "type": "object", "properties": { - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/JobRankingItem" - } + "severity": { + "type": "string" }, - "total": { + "count": { "type": "integer", "format": "int64" - }, - "page": { - "type": "integer", - "format": "int32" - }, - "size": { - "type": "integer", - "format": "int32" - }, - "totalPages": { - "type": "integer", - "format": "int32" } } }, - "JobReviewCreateRequest": { + "RiskRuleCount": { "type": "object", "properties": { - "rating": { - "type": "integer", - "format": "int32", - "maximum": 5, - "minimum": 1 - }, - "content": { - "type": "string", - "maxLength": 1000, - "minLength": 0 - }, - "tags": { - "type": "array", - "items": { - "type": "string", - "maxLength": 50, - "minLength": 1 - }, - "maxItems": 10, - "minItems": 0 + "ruleCode": { + "type": "string" }, - "dimensionScores": { - "type": "object", - "additionalProperties": { - "type": "integer", - "format": "int32" - } + "count": { + "type": "integer", + "format": "int64" } - }, - "required": [ - "content", - "rating" - ] + } }, - "JobReviewUpdateRequest": { + "RiskOverviewResponse": { "type": "object", "properties": { - "rating": { + "openCount": { "type": "integer", - "format": "int32", - "maximum": 5, - "minimum": 1 + "format": "int64" }, - "content": { - "type": "string", - "maxLength": 1000, - "minLength": 1 + "bySeverity": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RiskSeverityCount" + } }, - "tags": { + "byRule": { "type": "array", "items": { - "type": "string", - "maxLength": 50, - "minLength": 1 - }, - "maxItems": 10, - "minItems": 0 + "$ref": "#/components/schemas/RiskRuleCount" + } }, - "status": { + "lastDetectedAt": { "type": "string", - "pattern": "^(PUBLISHED|HIDDEN)$" - }, - "dimensionScores": { - "type": "object", - "additionalProperties": { - "type": "integer", - "format": "int32" - } + "format": "date-time", + "nullable": true } } }, - "JobStatusRequest": { + "RiskTrendPoint": { "type": "object", "properties": { - "status": { + "time": { "type": "string", - "minLength": 1, - "pattern": "^(PUBLISHED|CLOSED)$" + "format": "date-time" + }, + "count": { + "type": "integer", + "format": "int64" } - }, - "required": [ - "status" - ] + } }, - "JobUpdateRequest": { + "RiskTrendResponse": { "type": "object", "properties": { - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 + "bucket": { + "type": "string" }, - "description": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RiskTrendPoint" + } + } + } + }, + "RiskDistributionRow": { + "type": "object", + "properties": { + "ruleCode": { "type": "string" }, - "requirements": { + "severity": { "type": "string" }, - "city": { - "type": "string", - "maxLength": 80, - "minLength": 0 - }, - "employmentType": { - "type": "string", - "maxLength": 30, - "minLength": 0 - }, - "salaryMin": { - "type": "integer", - "format": "int32" - }, - "salaryMax": { + "count": { "type": "integer", - "format": "int32" + "format": "int64" } } }, - "LoginRequest": { + "RiskDistributionResponse": { "type": "object", "properties": { - "phone": { - "type": "string", - "minLength": 1, - "pattern": "[0-9]{11}" + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RiskDistributionRow" + } + } + } + }, + "RiskRuleUpdateRequest": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean" }, - "code": { - "type": "string", - "minLength": 1, - "pattern": "[0-9]{6}" + "thresholdCount": { + "type": "integer", + "format": "int32" }, - "purpose": { + "windowMinutes": { + "type": "integer", + "format": "int32" + }, + "severity": { "type": "string" + }, + "expectedVersion": { + "type": "integer", + "format": "int64" } }, "required": [ - "code", - "phone" + "enabled", + "thresholdCount", + "windowMinutes", + "severity", + "expectedVersion" ] }, - "MatchSignal": { + "RiskEventActionRequest": { "type": "object", "properties": { - "average": { - "type": "number" + "action": { + "type": "string" }, - "sampleCount": { + "reasonCode": { + "type": "string" + }, + "expectedVersion": { "type": "integer", - "format": "int32" + "format": "int64" } - } + }, + "required": [ + "action", + "reasonCode", + "expectedVersion" + ] }, - "OfferCreateRequest": { + "ApiResponseRiskOverviewResponse": { "type": "object", "properties": { - "applicationId": { + "code": { "type": "integer", - "format": "int64" + "format": "int32" }, - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 + "message": { + "type": "string" }, - "salaryMin": { - "type": "integer", - "format": "int32", - "minimum": 0 + "data": { + "$ref": "#/components/schemas/RiskOverviewResponse" }, - "salaryMax": { - "type": "integer", - "format": "int32", - "minimum": 0 + "requestId": { + "type": "string" }, - "salaryCurrency": { + "timestamp": { "type": "string", - "maxLength": 10, - "minLength": 0 + "format": "date-time" + } + } + }, + "ApiResponseRiskTrendResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" }, - "salaryPeriod": { - "type": "string", - "pattern": "^(MONTH|YEAR|HOUR)$" + "message": { + "type": "string" }, - "workCity": { - "type": "string", - "maxLength": 80, - "minLength": 0 + "data": { + "$ref": "#/components/schemas/RiskTrendResponse" }, - "employmentType": { - "type": "string", - "pattern": "^(FULL_TIME|PART_TIME|INTERN|INTERNSHIP)$" + "requestId": { + "type": "string" }, - "probationMonths": { + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseRiskDistributionResponse": { + "type": "object", + "properties": { + "code": { "type": "integer", - "format": "int32", - "minimum": 0 + "format": "int32" }, - "benefits": { - "type": "string", - "maxLength": 2000, - "minLength": 0 + "message": { + "type": "string" }, - "description": { - "type": "string", - "maxLength": 5000, - "minLength": 0 + "data": { + "$ref": "#/components/schemas/RiskDistributionResponse" }, - "expireAt": { - "type": "string", - "format": "date-time" + "requestId": { + "type": "string" }, - "onboardingDate": { + "timestamp": { "type": "string", - "format": "date" - }, - "baseSalary": { + "format": "date-time" + } + } + }, + "ApiResponsePageResponseRiskEventResponse": { + "type": "object", + "properties": { + "code": { "type": "integer", - "format": "int32", - "minimum": 0 + "format": "int32" }, - "housingAllowance": { - "type": "integer", - "format": "int32", - "minimum": 0 + "message": { + "type": "string" }, - "annualBonusMonths": { - "type": "integer", - "format": "int32", - "minimum": 0 + "data": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RiskEventResponse" + } + }, + "totalElements": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + } + } }, - "otherAllowances": { + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", - "maxLength": 1000, - "minLength": 0 + "format": "date-time" } - }, - "required": [ - "applicationId", - "description", - "expireAt", - "title", - "workCity" - ] + } }, - "OfferStatusRequest": { + "ApiResponseListRiskRuleResponse": { "type": "object", "properties": { - "status": { - "type": "string", - "minLength": 1, - "pattern": "^(SENT|NEGOTIATING|ACCEPTED|REJECTED|EXPIRED|WITHDRAWN)$" + "code": { + "type": "integer", + "format": "int32" }, - "reason": { + "message": { + "type": "string" + }, + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/RiskRuleResponse" + } + }, + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", - "maxLength": 255, - "minLength": 0 + "format": "date-time" } - }, - "required": [ - "status" - ] + } }, - "OfferUpdateRequest": { + "ApiResponseRiskRuleResponse": { "type": "object", "properties": { - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 - }, - "salaryMin": { + "code": { "type": "integer", - "format": "int32", - "minimum": 0 + "format": "int32" }, - "salaryMax": { - "type": "integer", - "format": "int32", - "minimum": 0 + "message": { + "type": "string" }, - "salaryCurrency": { - "type": "string", - "maxLength": 10, - "minLength": 0 + "data": { + "$ref": "#/components/schemas/RiskRuleResponse" }, - "salaryPeriod": { + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", - "pattern": "^(MONTH|YEAR|HOUR)$" + "format": "date-time" + } + } + }, + "ApiResponseRiskEventResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" }, - "workCity": { - "type": "string", - "maxLength": 80, - "minLength": 0 + "message": { + "type": "string" }, - "employmentType": { - "type": "string", - "pattern": "^(FULL_TIME|PART_TIME|INTERN|INTERNSHIP)$" + "data": { + "$ref": "#/components/schemas/RiskEventResponse" }, - "probationMonths": { - "type": "integer", - "format": "int32", - "minimum": 0 + "requestId": { + "type": "string" }, - "benefits": { + "timestamp": { "type": "string", - "maxLength": 2000, - "minLength": 0 + "format": "date-time" + } + } + }, + "TalentDiscoveryPreferenceResponse": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean" }, - "description": { - "type": "string", - "maxLength": 5000, - "minLength": 0 + "version": { + "type": "integer", + "format": "int64" }, - "expireAt": { + "createdAt": { "type": "string", "format": "date-time" }, - "onboardingDate": { + "updatedAt": { "type": "string", - "format": "date" - }, - "baseSalary": { - "type": "integer", - "format": "int32", - "minimum": 0 - }, - "housingAllowance": { - "type": "integer", - "format": "int32", - "minimum": 0 + "format": "date-time" + } + } + }, + "TalentDiscoveryPreferenceUpdateRequest": { + "type": "object", + "required": [ + "enabled" + ], + "properties": { + "enabled": { + "type": "boolean" }, - "annualBonusMonths": { + "expectedVersion": { "type": "integer", - "format": "int32", + "format": "int64", "minimum": 0 - }, - "otherAllowances": { - "type": "string", - "maxLength": 1000, - "minLength": 0 } } }, - "PersonalizedScoreResponse": { + "TalentDiscoveryCandidateResponse": { "type": "object", "properties": { - "jobId": { - "type": "integer", - "format": "int64" - }, - "score": { - "type": "number" + "candidateKey": { + "type": "string" }, - "status": { + "candidateLabel": { "type": "string" }, - "source": { + "city": { "type": "string" }, - "templateCode": { + "education": { "type": "string" }, - "configuredWeights": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "graduationYear": { + "type": "integer", + "format": "int32" }, - "effectiveWeights": { - "type": "object", - "additionalProperties": { - "type": "number" + "skills": { + "type": "array", + "items": { + "type": "string" } }, - "dimensionScores": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "fitBand": { + "type": "string", + "enum": [ + "HIGH", + "MEDIUM", + "BASIC" + ] }, - "coveredWeight": { - "type": "number" + "summary": { + "type": "string" }, - "missingDimensions": { + "signalsAvailable": { "type": "array", "items": { - "type": "string" + "type": "string", + "enum": [ + "PREFERENCE", + "RIASEC", + "ABILITY" + ] } } } }, - "PrivacySettingsResponse": { + "TalentDiscoveryPageResponse": { "type": "object", "properties": { - "id": { - "type": "integer", - "format": "int64", - "example": 1, - "nullable": true + "mode": { + "type": "string", + "enum": [ + "PERSONALIZED", + "UNAVAILABLE", + "NO_ELIGIBLE_CANDIDATE" + ] }, - "studentUserId": { - "type": "integer", - "format": "int64", - "example": 2 + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TalentDiscoveryCandidateResponse" + } }, - "resumeVisibility": { - "$ref": "#/components/schemas/ResumeVisibility", - "description": "简历可见性（PRIVATE/APPLIED_COMPANIES/VERIFIED_COMPANIES）", - "example": "APPLIED_COMPANIES" + "total": { + "type": "integer", + "format": "int64" }, - "contactVisible": { - "type": "boolean", - "example": true + "page": { + "type": "integer", + "format": "int32" }, - "version": { + "size": { "type": "integer", - "format": "int64", - "example": 0 + "format": "int32" }, - "createdAt": { - "type": "string", - "format": "date-time", - "nullable": true + "totalPages": { + "type": "integer", + "format": "int32" }, - "updatedAt": { - "type": "string", - "format": "date-time", - "nullable": true + "message": { + "type": "string" } } }, - "PrivacySettingsUpdateRequest": { + "ApiResponseTalentDiscoveryPreferenceResponse": { "type": "object", - "required": [ - "resumeVisibility", - "contactVisible" - ], "properties": { - "resumeVisibility": { - "$ref": "#/components/schemas/ResumeVisibility", - "description": "简历可见性（必填）", - "example": "APPLIED_COMPANIES" + "code": { + "type": "integer", + "format": "int32" }, - "contactVisible": { - "type": "boolean", - "description": "联系方式是否对企业可见（必填）", - "example": true + "message": { + "type": "string" }, - "version": { - "type": "integer", - "format": "int64", - "description": "乐观锁版本号（可选）", - "example": 0 - } - } - }, - "ResumeVisibility": { - "type": "string", - "enum": [ - "PRIVATE", - "APPLIED_COMPANIES", - "VERIFIED_COMPANIES" - ], - "description": "简历可见性：PRIVATE 私有；APPLIED_COMPANIES 仅对企业有效投递可见；VERIFIED_COMPANIES 仅对认证企业可见", - "example": "PRIVATE" - }, - "ReviewDecisionRequest": { - "type": "object", - "properties": { - "decision": { - "type": "string", - "minLength": 1, - "pattern": "^(APPROVED|REJECTED)$" + "data": { + "$ref": "#/components/schemas/TalentDiscoveryPreferenceResponse" }, - "reason": { + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", - "maxLength": 500, - "minLength": 0 + "format": "date-time" } - }, - "required": [ - "decision" - ] + } }, - "ReviewWeightResponse": { + "ApiResponseTalentDiscoveryPageResponse": { "type": "object", "properties": { - "source": { - "type": "string" + "code": { + "type": "integer", + "format": "int32" }, - "templateCode": { + "message": { "type": "string" }, - "configuredWeights": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "data": { + "$ref": "#/components/schemas/TalentDiscoveryPageResponse" }, - "updatedAt": { + "requestId": { + "type": "string" + }, + "timestamp": { "type": "string", "format": "date-time" } } }, - "SaveWeightRequest": { + "CreateTalentInvitationRequest": { "type": "object", + "required": [ + "candidateKey", + "message", + "idempotencyKey" + ], "properties": { - "templateCode": { - "type": "string" + "candidateKey": { + "type": "string", + "maxLength": 128 }, - "weights": { - "type": "object", - "additionalProperties": { - "type": "number" - } + "message": { + "type": "string", + "minLength": 1, + "maxLength": 300 + }, + "idempotencyKey": { + "type": "string", + "format": "uuid", + "maxLength": 64 } } }, - "ScoreRequest": { + "TalentInvitationDecisionRequest": { "type": "object", + "required": [ + "decision", + "expectedVersion" + ], "properties": { - "score": { + "decision": { + "type": "string", + "enum": [ + "ACCEPT", + "REJECT" + ] + }, + "expectedVersion": { "type": "integer", - "format": "int32", - "maximum": 100, + "format": "int64", "minimum": 0 } - }, - "required": [ - "score" - ] + } }, - "ScoreTrendResponse": { + "CompanyTalentInvitationResponse": { "type": "object", "properties": { - "companyId": { + "invitationId": { "type": "integer", "format": "int64" }, - "months": { + "jobId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/TrendItem" - } + "jobTitle": { + "type": "string" + }, + "candidateLabel": { + "type": "string" + }, + "message": { + "type": "string" + }, + "status": { + "type": "string", + "enum": [ + "PENDING", + "ACCEPTED", + "REJECTED", + "EXPIRED" + ] + }, + "createdAt": { + "type": "string", + "format": "date-time" + }, + "expiresAt": { + "type": "string", + "format": "date-time" + }, + "decidedAt": { + "type": "string", + "format": "date-time" + }, + "conversationId": { + "type": "integer", + "format": "int64" } } }, - "SendMessageRequest": { + "StudentTalentInvitationResponse": { "type": "object", "properties": { - "conversationId": { + "invitationId": { "type": "integer", "format": "int64" }, - "content": { - "type": "string", - "maxLength": 2000, - "minLength": 0 - } - }, - "required": [ - "content", - "conversationId" - ] - }, - "SnapshotHistoryItem": { - "type": "object", - "properties": { - "id": { + "companyId": { "type": "integer", "format": "int64" }, - "appealId": { + "companyName": { + "type": "string" + }, + "jobId": { "type": "integer", "format": "int64" }, - "action": { + "jobTitle": { "type": "string" }, - "dimension": { + "jobCity": { "type": "string" }, - "period": { + "message": { "type": "string" }, - "beforeScore": { - "type": "number" + "status": { + "type": "string", + "enum": [ + "PENDING", + "ACCEPTED", + "REJECTED", + "EXPIRED" + ] }, - "afterScore": { - "type": "number" + "version": { + "type": "integer", + "format": "int64" }, - "beforeVersion": { + "createdAt": { + "type": "string", + "format": "date-time" + }, + "expiresAt": { + "type": "string", + "format": "date-time" + }, + "decidedAt": { + "type": "string", + "format": "date-time" + }, + "conversationId": { "type": "integer", "format": "int64" + } + } + }, + "TalentInvitationPageResponseCompanyTalentInvitationResponse": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CompanyTalentInvitationResponse" + } }, - "afterVersion": { + "total": { "type": "integer", "format": "int64" }, - "beforeRulesVersion": { + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + }, + "totalPages": { + "type": "integer", + "format": "int32" + } + } + }, + "TalentInvitationPageResponseStudentTalentInvitationResponse": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/StudentTalentInvitationResponse" + } + }, + "total": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + }, + "totalPages": { + "type": "integer", + "format": "int32" + } + } + }, + "ApiResponseCompanyTalentInvitationResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { "type": "string" }, - "afterRulesVersion": { + "data": { + "$ref": "#/components/schemas/CompanyTalentInvitationResponse" + }, + "requestId": { "type": "string" }, - "createdAt": { + "timestamp": { "type": "string", "format": "date-time" } } }, - "StudentMatchRuleRequest": { + "ApiResponseStudentTalentInvitationResponse": { "type": "object", "properties": { - "requiredHrScore": { - "type": "integer", - "format": "int32", - "maximum": 100, - "minimum": 0 + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/StudentTalentInvitationResponse" + }, + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" } - }, - "required": [ - "requiredHrScore" - ] + } }, - "StudentPreferenceRequest": { + "ApiResponseCompanyTalentInvitationPageResponse": { "type": "object", "properties": { - "expectedSalaryMin": { - "type": "integer", - "format": "int32", - "minimum": 0 + "code": { + "type": "integer" }, - "expectedSalaryMax": { - "type": "integer", - "format": "int32", - "minimum": 0 + "message": { + "type": "string" }, - "preferredCities": { - "type": "array", - "items": { - "type": "string", - "maxLength": 100, - "minLength": 1 - }, - "maxItems": 20, - "minItems": 0 + "data": { + "$ref": "#/components/schemas/TalentInvitationPageResponseCompanyTalentInvitationResponse" }, - "employmentTypes": { - "type": "array", - "items": { - "type": "string", - "maxLength": 100, - "minLength": 1 - }, - "maxItems": 20, - "minItems": 0 + "requestId": { + "type": "string" }, - "preferredIndustries": { - "type": "array", - "items": { - "type": "string", - "maxLength": 100, - "minLength": 1 - }, - "maxItems": 20, - "minItems": 0 + "timestamp": { + "type": "string", + "format": "date-time" + } + } + }, + "ApiResponseStudentTalentInvitationPageResponse": { + "type": "object", + "properties": { + "code": { + "type": "integer" }, - "preferredJobTypes": { - "type": "array", - "items": { - "type": "string", - "maxLength": 100, - "minLength": 1 - }, - "maxItems": 20, - "minItems": 0 + "message": { + "type": "string" + }, + "data": { + "$ref": "#/components/schemas/TalentInvitationPageResponseStudentTalentInvitationResponse" }, - "remoteAllowed": { - "type": "boolean" + "requestId": { + "type": "string" }, - "salaryRangeValid": { - "type": "boolean" + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "StudentProfileUpdateRequest": { + "FairnessResponseDistribution": { "type": "object", "properties": { - "realName": { - "type": "string", - "maxLength": 50, - "minLength": 0 + "sampleSize": { + "type": "integer" }, - "bio": { - "type": "string" + "mean": { + "type": "number" }, - "location": { - "type": "string", - "maxLength": 100, - "minLength": 0 + "median": { + "type": "number" }, - "education": { - "type": "string", - "maxLength": 100, - "minLength": 0 + "p10": { + "type": "number" }, - "school": { - "type": "string", - "maxLength": 150, - "minLength": 0 + "p25": { + "type": "number" }, - "graduationYear": { - "type": "integer", - "format": "int32" + "p75": { + "type": "number" }, - "resumeUrl": { - "type": "string", - "maxLength": 500, - "minLength": 0 + "p90": { + "type": "number" }, - "skills": { - "type": "array", - "items": { - "type": "string" + "min": { + "type": "number" + }, + "max": { + "type": "number" + }, + "standardDeviation": { + "type": "number" + }, + "buckets": { + "type": "object", + "additionalProperties": { + "type": "integer" } + }, + "concentrationRate": { + "type": "number" + }, + "riskLevel": { + "type": "string" + }, + "availability": { + "type": "string" + }, + "reason": { + "type": "string" } } }, - "SubScore": { + "FairnessResponseDimensionMetric": { "type": "object", "properties": { - "name": { + "dimension": { "type": "string" }, - "score": { + "populationSize": { + "type": "integer" + }, + "rowCount": { + "type": "integer" + }, + "missingRowCount": { + "type": "integer" + }, + "validSampleSize": { + "type": "integer" + }, + "confidence": { + "type": "string" + }, + "missingRowRate": { "type": "number" }, - "weight": { + "nullScoreRate": { "type": "number" }, - "description": { + "validCoverage": { + "type": "number" + }, + "statusCounts": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "versionCounts": { + "type": "object", + "additionalProperties": { + "type": "integer" + } + }, + "inconsistentRecordCount": { + "type": "integer" + }, + "unknownStatusCount": { + "type": "integer" + }, + "outOfRangeScoreCount": { + "type": "integer" + }, + "unknownRulesVersionCount": { + "type": "integer" + }, + "distribution": { + "$ref": "#/components/schemas/FairnessResponseDistribution" + }, + "distributionsByRulesVersion": { + "type": "object", + "additionalProperties": { + "$ref": "#/components/schemas/FairnessResponseDistribution" + } + }, + "availability": { + "type": "string" + }, + "reason": { "type": "string" } } }, - "TagCount": { + "FairnessResponseOverview": { "type": "object", "properties": { - "name": { + "basis": { + "type": "string" + }, + "scope": { "type": "string" }, - "count": { - "type": "integer", - "format": "int32" - } - } - }, - "TrendItem": { - "type": "object", - "properties": { "period": { "type": "string" }, - "overallScore": { + "capturedAt": { + "type": "string", + "format": "date-time" + }, + "populationSize": { + "type": "integer" + }, + "computableSnapshotRatio": { "type": "number" }, - "rulesVersion": { + "confidence": { "type": "string" }, - "dimensions": { + "riskLevel": { + "type": "string" + }, + "versionCounts": { "type": "object", "additionalProperties": { - "type": "number" + "type": "integer" + } + }, + "mixedVersionCount": { + "type": "integer" + }, + "unknownVersionCount": { + "type": "integer" + }, + "distribution": { + "$ref": "#/components/schemas/FairnessResponseDistribution" + }, + "distributionsByRulesVersion": { + "type": "object", + "additionalProperties": { + "$ref": "#/components/schemas/FairnessResponseDistribution" + } + }, + "coherentVersionSubset": { + "type": "array", + "items": { + "type": "string" } + }, + "availability": { + "type": "string" + }, + "reason": { + "type": "string" } } }, - "VerificationDecisionRequest": { + "FairnessResponseDimensions": { "type": "object", "properties": { - "decision": { + "basis": { + "type": "string" + }, + "scope": { + "type": "string" + }, + "period": { + "type": "string" + }, + "capturedAt": { "type": "string", - "minLength": 1 + "format": "date-time" + }, + "dimensions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/FairnessResponseDimensionMetric" + } + }, + "availability": { + "type": "string" }, "reason": { "type": "string" } - }, - "required": [ - "decision" - ] + } }, - "VerificationSubmitRequest": { + "FairnessResponseUnavailable": { "type": "object", "properties": { - "materialsJson": { + "availability": { "type": "string", - "minLength": 1 + "enum": [ + "UNAVAILABLE" + ] + }, + "reason": { + "type": "string" + }, + "capturedAt": { + "type": "string", + "format": "date-time" } - }, - "required": [ - "materialsJson" - ] + } }, - "WeightTemplateResponse": { + "FairnessResponseAppeals": { "type": "object", "properties": { - "code": { + "basis": { "type": "string" }, - "name": { - "type": "string" + "from": { + "type": "string", + "format": "date" }, - "description": { - "type": "string" + "to": { + "type": "string", + "format": "date" }, - "weights": { + "capturedAt": { + "type": "string", + "format": "date-time" + }, + "appealCount": { + "type": "integer", + "description": "申诉事件数；与按独立候选人数统计的其他字段区分" + }, + "sampleSize": { + "type": "integer" + }, + "statusCounts": { "type": "object", "additionalProperties": { - "type": "number" + "type": "integer" } - } - } - }, - "InterviewScoreSaveRequest": { - "type": "object", - "properties": { - "technicalScore": { - "type": "integer", - "minimum": 1, - "maximum": 5, - "nullable": true - }, - "communicationScore": { - "type": "integer", - "minimum": 1, - "maximum": 5, - "nullable": true }, - "problemSolvingScore": { - "type": "integer", - "minimum": 1, - "maximum": 5, - "nullable": true + "statusEventCounts": { + "type": "object", + "additionalProperties": { + "type": "integer" + } }, - "roleFitScore": { - "type": "integer", - "minimum": 1, - "maximum": 5, - "nullable": true + "statusCandidateCounts": { + "type": "object", + "additionalProperties": { + "type": "integer" + } }, - "professionalismScore": { - "type": "integer", - "minimum": 1, - "maximum": 5, - "nullable": true + "confidence": { + "type": "string" }, - "recommendation": { - "type": "string", - "enum": [ - "STRONG_HIRE", - "HIRE", - "NEUTRAL", - "NO_HIRE" - ], - "nullable": true, - "description": "企业手动选择，不根据 overallScore 自动推导" + "approvedEverCount": { + "type": "integer" }, - "comment": { - "type": "string", - "nullable": true - } - }, - "description": "评分草稿保存请求；overallScore 由服务端计算，客户端不得传入" - }, - "InterviewScoreResponse": { - "type": "object", - "properties": { - "id": { - "type": "integer", - "format": "int64" + "approvalRate": { + "type": "number" }, - "interviewId": { - "type": "integer", - "format": "int64" + "rollbackExecutionRate": { + "type": "number" }, - "applicationId": { - "type": "integer", - "format": "int64" + "duplicateAppealCount": { + "type": "integer" }, - "status": { - "type": "string", - "enum": [ - "DRAFT", - "SUBMITTED" - ] + "duplicateAppealRate": { + "type": "number" }, - "technicalScore": { + "comparableRollbackCount": { "type": "integer", - "nullable": true + "description": "可比 ROLLBACK 历史行数；仅唯一历史且分数/规则版本合法的申诉" }, - "communicationScore": { + "comparableRollbackCandidateCount": { "type": "integer", - "nullable": true + "description": "可比回滚历史对应的独立候选人数；同一候选人的多份合法申诉只计一人" }, - "problemSolvingScore": { - "type": "integer", - "nullable": true + "changedCount": { + "type": "integer" }, - "roleFitScore": { - "type": "integer", - "nullable": true + "changedCandidateCount": { + "type": "integer" }, - "professionalismScore": { - "type": "integer", - "nullable": true + "actualScoreChangeRate": { + "type": "number" }, - "overallScore": { - "type": "number", - "format": "decimal", - "nullable": true, - "description": "由服务端 BigDecimal 计算：(t+c+ps+rf+p)/5，保留两位小数 HALF_UP" + "meanDelta": { + "type": "number" }, - "recommendation": { - "type": "string", - "enum": [ - "STRONG_HIRE", - "HIRE", - "NEUTRAL", - "NO_HIRE" - ], - "nullable": true + "meanAbsoluteDelta": { + "type": "number" }, - "comment": { - "type": "string", - "nullable": true + "duplicateRollbackHistoryCount": { + "type": "integer" }, - "submittedAt": { - "type": "string", - "format": "date-time", - "nullable": true + "invalidScoreRollbackCount": { + "type": "integer" }, - "version": { - "type": "integer", - "format": "int64" + "ruleVersionChangedRollbackCount": { + "type": "integer" }, - "createdAt": { - "type": "string", - "format": "date-time" + "reasonCounts": { + "type": "object", + "additionalProperties": { + "type": "integer" + } }, - "updatedAt": { - "type": "string", - "format": "date-time" + "availability": { + "type": "string" + }, + "reason": { + "type": "string" + }, + "exposureAppealRateAvailability": { + "type": "string" + }, + "exposureAppealRateReason": { + "type": "string" } - }, - "description": "面试评分响应（脱敏：不返回 companyUserId/studentUserId/evaluatorUserId/手机号/邮箱）" + } }, - "ApiResponseInterviewScoreResponse": { + "ApiResponseFairnessResponseOverview": { "type": "object", "properties": { "code": { - "type": "integer", - "format": "int32" + "type": "integer" }, "message": { "type": "string" }, "data": { - "$ref": "#/components/schemas/InterviewScoreResponse" + "$ref": "#/components/schemas/FairnessResponseOverview" }, "requestId": { "type": "string" @@ -11219,66 +15513,38 @@ } } }, - "InterviewScoreHistoryItem": { + "ApiResponseFairnessResponseDimensions": { "type": "object", "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "scoreId": { - "type": "integer", - "format": "int64" - }, - "interviewId": { - "type": "integer", - "format": "int64" - }, - "fromStatus": { - "type": "string", - "enum": [ - "DRAFT", - "SUBMITTED" - ], - "nullable": true + "code": { + "type": "integer" }, - "toStatus": { - "type": "string", - "enum": [ - "DRAFT", - "SUBMITTED" - ] + "message": { + "type": "string" }, - "actorRole": { - "type": "string", - "example": "COMPANY" + "data": { + "$ref": "#/components/schemas/FairnessResponseDimensions" }, - "snapshot": { - "type": "object", - "additionalProperties": {} + "requestId": { + "type": "string" }, - "createdAt": { + "timestamp": { "type": "string", "format": "date-time" } - }, - "description": "评分历史条目（脱敏：不返回 actorUserId/手机号/邮箱）" + } }, - "ApiResponseListInterviewScoreHistoryItem": { + "ApiResponseFairnessResponseUnavailable": { "type": "object", "properties": { "code": { - "type": "integer", - "format": "int32" + "type": "integer" }, "message": { "type": "string" }, "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/InterviewScoreHistoryItem" - } + "$ref": "#/components/schemas/FairnessResponseUnavailable" }, "requestId": { "type": "string" @@ -11289,338 +15555,213 @@ } } }, - "CreateReportRequest": { - "type": "object", - "properties": { - "targetType": { "type": "string", "enum": ["USER", "MESSAGE"], "description": "举报目标类型；USER 必填 targetUserId，MESSAGE 必填 messageId" }, - "targetUserId": { "type": "integer", "format": "int64", "description": "targetType=USER 时必填" }, - "messageId": { "type": "integer", "format": "int64", "description": "targetType=MESSAGE 时必填" }, - "category": { "type": "string", "maxLength": 40, "description": "举报分类，如 HARASSMENT" }, - "reason": { "type": "string", "minLength": 1, "maxLength": 1000 }, - "evidenceUrls": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "description": "最多 5 个，仅 http/https，最多 500 字符" }, - "idempotencyKey": { "type": "string", "maxLength": 64, "description": "幂等键（可选）" } - } - }, - "ReportDecisionRequest": { - "type": "object", - "properties": { - "decision": { "type": "string", "enum": ["RESOLVED", "REJECTED"] }, - "note": { "type": "string", "maxLength": 1000, "description": "REJECTED 必填" } - } - }, - "ReportResponse": { - "type": "object", - "properties": { - "id": { "type": "integer", "format": "int64" }, - "targetType": { "type": "string", "enum": ["USER", "MESSAGE"] }, - "targetUserId": { "type": "integer", "format": "int64" }, - "messageId": { "type": "integer", "format": "int64" }, - "reportedUserId": { "type": "integer", "format": "int64" }, - "category": { "type": "string" }, - "reason": { "type": "string" }, - "evidenceUrls": { "type": "array", "items": { "type": "string" } }, - "status": { "type": "string", "enum": ["PENDING", "RESOLVED", "REJECTED"] }, - "decision": { "type": "string", "enum": ["RESOLVED", "REJECTED"] }, - "decisionNote": { "type": "string" }, - "decidedAt": { "type": "string", "format": "date-time" }, - "createdAt": { "type": "string", "format": "date-time" }, - "updatedAt": { "type": "string", "format": "date-time" }, - "messagePreview": { "type": "string", "description": "MESSAGE 举报的脱敏消息预览，不返回会话其他敏感内容" }, - "reportedUser": { "$ref": "#/components/schemas/ReportResponseReportedUser" }, - "history": { "type": "array", "items": { "$ref": "#/components/schemas/ReportResponseDecisionHistoryItem" } } - } - }, - "ReportResponseReportedUser": { - "type": "object", - "properties": { - "userId": { "type": "integer", "format": "int64" }, - "nickname": { "type": "string" }, - "role": { "type": "string" } - } - }, - "ReportResponseDecisionHistoryItem": { - "type": "object", - "properties": { - "id": { "type": "integer", "format": "int64" }, - "fromStatus": { "type": "string" }, - "toStatus": { "type": "string" }, - "actorUserId": { "type": "integer", "format": "int64" }, - "actorRole": { "type": "string" }, - "note": { "type": "string" }, - "createdAt": { "type": "string", "format": "date-time" } - } - }, - "BlockRelationResponse": { - "type": "object", - "properties": { - "id": { "type": "integer", "format": "int64" }, - "blockedUserId": { "type": "integer", "format": "int64" }, - "nickname": { "type": "string" }, - "createdAt": { "type": "string", "format": "date-time" } - } - }, - "ApiResponseReportResponse": { - "type": "object", - "properties": { - "code": { "type": "integer", "format": "int32" }, - "message": { "type": "string" }, - "data": { "$ref": "#/components/schemas/ReportResponse" }, - "requestId": { "type": "string" }, - "timestamp": { "type": "string", "format": "date-time" } - } - }, - "ApiResponsePageResponseReportResponse": { + "ApiResponseFairnessResponseAppeals": { "type": "object", "properties": { - "code": { "type": "integer", "format": "int32" }, - "message": { "type": "string" }, + "code": { + "type": "integer" + }, + "message": { + "type": "string" + }, "data": { - "type": "object", - "properties": { - "items": { "type": "array", "items": { "$ref": "#/components/schemas/ReportResponse" } }, - "totalElements": { "type": "integer", "format": "int64" }, - "page": { "type": "integer", "format": "int32" }, - "size": { "type": "integer", "format": "int32" } - } + "$ref": "#/components/schemas/FairnessResponseAppeals" }, - "requestId": { "type": "string" }, - "timestamp": { "type": "string", "format": "date-time" } - } - }, - "ApiResponseBlockRelationResponse": { - "type": "object", - "properties": { - "code": { "type": "integer", "format": "int32" }, - "message": { "type": "string" }, - "data": { "$ref": "#/components/schemas/BlockRelationResponse" }, - "requestId": { "type": "string" }, - "timestamp": { "type": "string", "format": "date-time" } + "requestId": { + "type": "string" + }, + "timestamp": { + "type": "string", + "format": "date-time" + } } }, - "ApiResponsePageResponseBlockRelationResponse": { + "CandidateScoringCoverage": { "type": "object", "properties": { - "code": { "type": "integer", "format": "int32" }, - "message": { "type": "string" }, - "data": { - "type": "object", - "properties": { - "items": { "type": "array", "items": { "$ref": "#/components/schemas/BlockRelationResponse" } }, - "totalElements": { "type": "integer", "format": "int64" }, - "page": { "type": "integer", "format": "int32" }, - "size": { "type": "integer", "format": "int32" } + "computableDimensions": { + "type": "integer", + "format": "int32" + }, + "totalDimensions": { + "type": "integer", + "format": "int32" + }, + "includedDimensions": { + "type": "array", + "items": { + "type": "string" } }, - "requestId": { "type": "string" }, - "timestamp": { "type": "string", "format": "date-time" } + "excludedDimensions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/CandidateScoringExcludedDimension" + } + } } }, - "SkillCloudNode": { + "CandidateScoringExcludedDimension": { "type": "object", "properties": { - "id": { - "type": "integer", - "format": "int64" + "dimension": { + "type": "string" }, - "code": { + "status": { "type": "string" }, - "name": { + "reason": { "type": "string" } } }, - "SkillCloudItem": { + "CandidateScoringRuleContribution": { "type": "object", "properties": { - "rank": { - "type": "integer", - "format": "int32", - "minimum": 1, - "description": "当前筛选范围内的稳定排名，从 1 开始。" - }, - "skillId": { - "type": "integer", - "format": "int64" - }, - "skillCode": { - "type": "string" - }, - "nameZh": { + "ruleCode": { "type": "string" }, - "nameEn": { - "type": "string", - "nullable": true - }, - "sourceType": { + "outcome": { "type": "string", "enum": [ - "ESCO", - "O*NET" - ], - "description": "技能身份主来源。" - }, - "sourceCode": { - "type": "string", - "description": "ESCO URI 或 O*NET 三元组标识。" - }, - "categoryId": { - "type": "integer", - "format": "int64" - }, - "categoryName": { - "type": "string" + "APPLIED", + "NOT_APPLIED", + "MISSING", + "EXPIRED", + "UNAVAILABLE" + ] }, - "heat": { + "contribution": { "type": "number", - "nullable": true, - "description": "O*NET Importance；无映射为 null，且排在非空热度之后。" - }, - "heatSourceCode": { - "type": "string", - "nullable": true, - "description": "热度来源 SOC。" - }, - "heatElementId": { - "type": "string", - "nullable": true, - "description": "热度来源 O*NET Element ID。" - }, - "heatProxy": { - "type": "boolean", - "description": "热度是否为代理映射。" - } - } - }, - "SkillCloudResponse": { - "type": "object", - "properties": { - "industry": { - "$ref": "#/components/schemas/SkillCloudNode" - }, - "occupation": { - "$ref": "#/components/schemas/SkillCloudNode" + "nullable": true }, - "category": { - "$ref": "#/components/schemas/SkillCloudNode", + "maxContribution": { + "type": "number", "nullable": true }, - "total": { - "type": "integer", - "format": "int32", - "minimum": 0 + "label": { + "type": "string" }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SkillCloudItem" - } + "observation": { + "type": "string" + }, + "explanation": { + "type": "string" } } }, - "SkillMatchResponse": { + "CandidateScoringValidity": { "type": "object", "properties": { - "matchScore": { - "type": "integer", - "format": "int32", - "minimum": 0, - "maximum": 100, - "description": "round(matchedCount*100/min(10,total))；total=0 时为 0。" - }, - "matchedCount": { - "type": "integer", - "format": "int32", - "minimum": 0 - }, - "totalCount": { - "type": "integer", - "format": "int32", - "minimum": 0, - "description": "实际匹配集合大小 min(10,total)。" + "completedAt": { + "type": "string", + "format": "date-time" }, - "matchedSkills": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SkillCloudItem" - } + "validUntil": { + "type": "string", + "format": "date-time" }, - "missingSkills": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SkillCloudItem" - } + "expired": { + "type": "boolean" } } }, - "SkillLearningPathItem": { + "StudentProfileResponse": { "type": "object", "properties": { - "priority": { + "id": { "type": "integer", - "format": "int32", - "minimum": 1 + "format": "int64" }, - "skillId": { + "userId": { "type": "integer", "format": "int64" }, - "skillName": { + "realName": { + "type": "string" + }, + "bio": { + "type": "string" + }, + "location": { + "type": "string" + }, + "education": { + "type": "string" + }, + "school": { "type": "string" }, - "categoryId": { + "graduationYear": { "type": "integer", - "format": "int64" + "format": "int32" }, - "categoryName": { + "resumeUrl": { + "type": "string" + }, + "skills": { "type": "string" }, - "suggestion": { + "createdAt": { "type": "string", - "description": "按技能分类生成的通用建议，不含课程、AI、链接、时长或进度。" + "format": "date-time" } } }, - "SkillLearningPathResponse": { + "CreateDataExportRequest": { "type": "object", "properties": { - "total": { - "type": "integer", - "format": "int32", - "minimum": 0 + "format": { + "type": "string" }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SkillLearningPathItem" - } + "idempotencyKey": { + "type": "string", + "maxLength": 64 } } }, - "ApiResponseSkillCloudResponse": { + "DataExportTaskResponse": { "type": "object", "properties": { - "code": { + "taskId": { "type": "integer", - "format": "int32" + "format": "int64" }, - "message": { + "status": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/SkillCloudResponse" - }, - "requestId": { + "format": { "type": "string" }, - "timestamp": { + "requestedAt": { + "type": "string", + "format": "date-time" + }, + "startedAt": { + "type": "string", + "format": "date-time" + }, + "completedAt": { + "type": "string", + "format": "date-time" + }, + "expiresAt": { "type": "string", "format": "date-time" + }, + "sizeBytes": { + "type": "integer", + "format": "int64" + }, + "downloadAvailable": { + "type": "boolean" + }, + "errorCode": { + "type": "string" } } }, - "ApiResponseSkillMatchResponse": { + "ApiResponseStudentProfileResponse": { "type": "object", "properties": { "code": { @@ -11631,7 +15772,7 @@ "type": "string" }, "data": { - "$ref": "#/components/schemas/SkillMatchResponse" + "$ref": "#/components/schemas/StudentProfileResponse" }, "requestId": { "type": "string" @@ -11642,7 +15783,7 @@ } } }, - "ApiResponseSkillLearningPathResponse": { + "ApiResponseDataExportTaskResponse": { "type": "object", "properties": { "code": { @@ -11653,7 +15794,7 @@ "type": "string" }, "data": { - "$ref": "#/components/schemas/SkillLearningPathResponse" + "$ref": "#/components/schemas/DataExportTaskResponse" }, "requestId": { "type": "string" @@ -11664,160 +15805,99 @@ } } }, - "UnauthorizedResponse": { + "MessageResponse": { "type": "object", - "additionalProperties": false, - "required": [ - "code", - "message", - "timestamp" - ], + "description": "脱敏消息响应；TALENT_INVITATION 使用 senderScope 而非 senderUserId", "properties": { - "code": { + "id": { "type": "integer", - "format": "int32", - "enum": [ - 401 - ] + "format": "int64" }, - "message": { - "type": "string", - "enum": [ - "not authenticated" - ] + "conversationId": { + "type": "integer", + "format": "int64" }, - "timestamp": { + "senderUserId": { + "type": "integer", + "format": "int64" + }, + "senderScope": { + "type": "string" + }, + "content": { + "type": "string" + }, + "status": { "type": "string", "enum": [ - "" + "SENT", + "RECALLED" ] - } - } - }, - "CompanyChecklistItemCreateRequest": { - "type": "object", - "properties": { - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 }, - "description": { + "recalledAt": { "type": "string", - "maxLength": 1000, - "minLength": 0 + "format": "date-time" }, - "category": { + "createdAt": { "type": "string", - "minLength": 1, - "pattern": "DOCUMENT|ADMIN|EQUIPMENT|TRAINING|LOGISTICS|OTHER" - }, - "sortOrder": { - "type": "integer", - "format": "int32", - "default": 1000, - "maximum": 9999, - "minimum": 0 - }, - "required": { - "type": "boolean", - "default": false + "format": "date-time" }, - "idempotencyKey": { - "type": "string", - "maxLength": 64, - "minLength": 0 + "isRead": { + "type": "boolean" } - }, - "required": [ - "category", - "title" - ] + } }, - "CompanyChecklistItemUpdateRequest": { + "MessagePageResponse": { "type": "object", + "description": "脱敏消息分页响应", "properties": { - "title": { - "type": "string", - "maxLength": 120, - "minLength": 0 - }, - "description": { - "type": "string", - "maxLength": 1000, - "minLength": 0 - }, - "category": { - "type": "string", - "minLength": 1, - "pattern": "DOCUMENT|ADMIN|EQUIPMENT|TRAINING|LOGISTICS|OTHER" + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/MessageResponse" + } }, - "sortOrder": { + "total": { "type": "integer", - "format": "int32", - "maximum": 9999, - "minimum": 0 + "format": "int64" }, - "required": { - "type": "boolean" + "page": { + "type": "integer", + "format": "int32" }, - "active": { - "type": "boolean" + "size": { + "type": "integer", + "format": "int32" }, - "version": { + "totalPages": { "type": "integer", - "format": "int64", - "minimum": 0 + "format": "int32" } - }, - "required": [ - "active", - "category", - "required", - "sortOrder", - "title", - "version" - ] + } }, - "CompanyChecklistItemView": { + "ApiResponseMessagePageResponse": { "type": "object", "properties": { - "itemId": { + "code": { "type": "integer", - "format": "int64" - }, - "source": { - "type": "string" - }, - "itemKey": { - "type": "string" + "format": "int32" }, - "title": { + "message": { "type": "string" }, - "description": { - "type": "string" + "data": { + "$ref": "#/components/schemas/MessagePageResponse" }, - "category": { + "requestId": { "type": "string" }, - "required": { - "type": "boolean" - }, - "sortOrder": { - "type": "integer", - "format": "int32" - }, - "active": { - "type": "boolean" - }, - "version": { - "type": "integer", - "format": "int64" + "timestamp": { + "type": "string", + "format": "date-time" } } }, - "ApiResponseCompanyChecklistItemView": { + "ApiResponseMessageResponse": { "type": "object", "properties": { "code": { @@ -11828,7 +15908,7 @@ "type": "string" }, "data": { - "$ref": "#/components/schemas/CompanyChecklistItemView" + "$ref": "#/components/schemas/MessageResponse" }, "requestId": { "type": "string" @@ -11839,7 +15919,7 @@ } } }, - "ApiResponseListCompanyChecklistItemView": { + "ApiResponsePageResponseDataExportTaskResponse": { "type": "object", "properties": { "code": { @@ -11850,9 +15930,26 @@ "type": "string" }, "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CompanyChecklistItemView" + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/DataExportTaskResponse" + } + }, + "totalElements": { + "type": "integer", + "format": "int64" + }, + "page": { + "type": "integer", + "format": "int32" + }, + "size": { + "type": "integer", + "format": "int32" + } } }, "requestId": { @@ -11864,155 +15961,135 @@ } } }, - "EffectiveChecklistResponse": { + "RefreshTokenRequest": { "type": "object", - "properties": { - "companyId": { - "type": "integer", - "format": "int64" - }, - "companyName": { - "type": "string" - }, - "customized": { - "type": "boolean" - }, - "totalItems": { - "type": "integer", - "format": "int32" - }, - "completedItems": { - "type": "integer", - "format": "int32" - }, - "completionRate": { - "type": "number", - "format": "double" - }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ChecklistItemView" - } + "required": [ + "refreshToken" + ], + "properties": { + "refreshToken": { + "type": "string", + "minLength": 1, + "maxLength": 4096 } } }, - "ChecklistItemView": { + "TokenPairResponse": { "type": "object", "properties": { - "itemId": { - "type": "integer", - "format": "int64" - }, - "source": { - "type": "string" - }, - "itemKey": { - "type": "string" - }, - "title": { - "type": "string" - }, - "description": { + "accessToken": { "type": "string" }, - "category": { + "refreshToken": { "type": "string" }, - "required": { - "type": "boolean" - }, - "sortOrder": { - "type": "integer", - "format": "int32" - }, - "active": { - "type": "boolean" - }, - "completed": { - "type": "boolean" - }, - "completedAt": { - "type": "string", - "format": "date-time" - }, - "progressVersion": { + "expiresIn": { "type": "integer", "format": "int64" } } }, - "ApiResponseEffectiveChecklistResponse": { + "ApiResponseTokenPairResponse": { "type": "object", "properties": { "code": { - "type": "integer", - "format": "int32" + "type": "integer" }, "message": { "type": "string" }, "data": { - "$ref": "#/components/schemas/EffectiveChecklistResponse" - }, - "requestId": { - "type": "string" - }, - "timestamp": { - "type": "string", - "format": "date-time" + "$ref": "#/components/schemas/TokenPairResponse" } } }, - "ProgressUpdateRequest": { + "PasswordSetRequest": { "type": "object", "properties": { - "completed": { - "type": "boolean" + "smsCode": { + "type": "string", + "minLength": 1 }, - "version": { - "type": "integer", - "format": "int64", - "minimum": 0 + "newPassword": { + "type": "string", + "minLength": 1 } }, "required": [ - "completed" + "newPassword", + "smsCode" ] }, - "ProgressUpdateResponse": { + "PasswordResetRequest": { "type": "object", "properties": { - "itemId": { - "type": "integer", - "format": "int64" - }, - "completed": { - "type": "boolean" + "phone": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{11}" }, - "completedAt": { + "smsCode": { "type": "string", - "format": "date-time" + "minLength": 1 }, - "progressVersion": { - "type": "integer", - "format": "int64" + "newPassword": { + "type": "string", + "minLength": 1 + } + }, + "required": [ + "newPassword", + "phone", + "smsCode" + ] + }, + "PasswordLoginRequest": { + "type": "object", + "properties": { + "phone": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{11}" }, - "totalItems": { - "type": "integer", - "format": "int32" + "password": { + "type": "string", + "minLength": 1 + } + }, + "required": [ + "password", + "phone" + ] + }, + "PasswordChangeRequest": { + "type": "object", + "properties": { + "currentPassword": { + "type": "string", + "minLength": 1 }, - "completedItems": { - "type": "integer", - "format": "int32" + "newPassword": { + "type": "string", + "minLength": 1 + } + }, + "required": [ + "currentPassword", + "newPassword" + ] + }, + "PasswordOperationResponse": { + "type": "object", + "properties": { + "passwordConfigured": { + "type": "boolean" }, - "completionRate": { - "type": "number", - "format": "double" + "reauthenticationRequired": { + "type": "boolean" } } }, - "ApiResponseProgressUpdateResponse": { + "ApiResponsePasswordOperationResponse": { "type": "object", "properties": { "code": { @@ -12023,7 +16100,7 @@ "type": "string" }, "data": { - "$ref": "#/components/schemas/ProgressUpdateResponse" + "$ref": "#/components/schemas/PasswordOperationResponse" }, "requestId": { "type": "string" @@ -12034,57 +16111,72 @@ } } }, - "CompanyKnowledgeUpdateRequest": { + "CompanyDetails": { "type": "object", "properties": { - "culture": { + "name": { "type": "string", - "maxLength": 2000, + "maxLength": 100, + "minLength": 0 + }, + "logoUrl": { + "type": "string", + "maxLength": 500, "minLength": 0 }, - "workPolicies": { + "description": { + "type": "string" + }, + "industry": { "type": "string", - "maxLength": 4000, + "maxLength": 80, "minLength": 0 }, - "onboardingGuide": { + "website": { "type": "string", - "maxLength": 4000, + "maxLength": 255, "minLength": 0 }, - "version": { - "type": "integer", - "format": "int64", - "minimum": 0 + "address": { + "type": "string", + "maxLength": 255, + "minLength": 0 } - } + }, + "required": [ + "name" + ] }, - "CompanyKnowledgeView": { + "CompanyRegistrationRequest": { "type": "object", "properties": { - "configured": { - "type": "boolean" - }, - "culture": { - "type": "string" - }, - "workPolicies": { - "type": "string" + "phone": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{11}" }, - "onboardingGuide": { - "type": "string" + "code": { + "type": "string", + "minLength": 1, + "pattern": "[0-9]{6}" }, - "updatedAt": { + "password": { "type": "string", - "format": "date-time" + "maxLength": 64, + "minLength": 12 }, - "version": { - "type": "integer", - "format": "int64" + "company": { + "$ref": "#/components/schemas/CompanyDetails" } - } + }, + "required": [ + "code", + "company", + "password", + "phone" + ] }, - "ApiResponseCompanyKnowledgeView": { + "ApiResponseCompanyRegistrationResponse": { "type": "object", "properties": { "code": { @@ -12095,7 +16187,7 @@ "type": "string" }, "data": { - "$ref": "#/components/schemas/CompanyKnowledgeView" + "$ref": "#/components/schemas/CompanyRegistrationResponse" }, "requestId": { "type": "string" @@ -12106,143 +16198,128 @@ } } }, - "CompanyKnowledgeOverviewResponse": { - "type": "object", - "properties": { - "company": { - "$ref": "#/components/schemas/CompanyView" - }, - "knowledgeState": { - "type": "string" - }, - "knowledge": { - "$ref": "#/components/schemas/KnowledgeView" - }, - "reviewSummary": { - "$ref": "#/components/schemas/ReviewSummaryView" - } - } - }, - "CompanyView": { + "CompanyRegistrationResponse": { "type": "object", "properties": { - "id": { + "userId": { "type": "integer", "format": "int64" }, - "name": { - "type": "string" - }, - "logoUrl": { - "type": "string" + "companyId": { + "type": "integer", + "format": "int64" }, - "description": { + "role": { "type": "string" }, - "industry": { + "onboardingStatus": { "type": "string" }, - "website": { + "accessToken": { "type": "string" }, - "address": { + "refreshToken": { "type": "string" }, - "verified": { - "type": "boolean" + "expiresIn": { + "type": "integer", + "format": "int64" } } }, - "KnowledgeView": { + "ApiResponseCompanyOnboardingResponse": { "type": "object", "properties": { - "culture": { - "type": "string" + "code": { + "type": "integer", + "format": "int32" }, - "workPolicies": { + "message": { "type": "string" }, - "onboardingGuide": { + "data": { + "$ref": "#/components/schemas/CompanyOnboardingResponse" + }, + "requestId": { "type": "string" }, - "updatedAt": { + "timestamp": { "type": "string", "format": "date-time" - }, - "version": { - "type": "integer", - "format": "int64" } } }, - "ReviewSummaryView": { + "CompanyOnboardingResponse": { "type": "object", "properties": { - "state": { - "type": "string" - }, - "totalReviews": { - "type": "integer", - "format": "int32" + "company": { + "$ref": "#/components/schemas/CompanySummary" }, - "averageRating": { - "type": "number", - "format": "double" + "onboardingStatus": { + "type": "string" }, - "ratingDistribution": { - "type": "object", - "additionalProperties": { - "type": "integer", - "format": "int32" - } + "latestVerification": { + "$ref": "#/components/schemas/VerificationSummary" }, - "topTags": { + "missingFields": { "type": "array", "items": { "type": "string" } }, - "dimensionSummary": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/DimensionSummaryView" + "allowedActions": { + "type": "array", + "items": { + "type": "string" } } } }, - "DimensionSummaryView": { + "CompanySummary": { "type": "object", "properties": { - "averageScore": { - "type": "number", - "format": "double" - }, - "sampleCount": { + "id": { "type": "integer", "format": "int64" }, - "dataState": { + "name": { + "type": "string" + }, + "logoUrl": { + "type": "string" + }, + "description": { + "type": "string" + }, + "industry": { + "type": "string" + }, + "website": { "type": "string" + }, + "address": { + "type": "string" + }, + "verified": { + "type": "boolean" } } }, - "ApiResponseCompanyKnowledgeOverviewResponse": { + "VerificationSummary": { "type": "object", "properties": { - "code": { + "id": { "type": "integer", - "format": "int32" + "format": "int64" }, - "message": { + "status": { "type": "string" }, - "data": { - "$ref": "#/components/schemas/CompanyKnowledgeOverviewResponse" - }, - "requestId": { - "type": "string" + "submittedAt": { + "type": "string", + "format": "date-time" }, - "timestamp": { + "decidedAt": { "type": "string", "format": "date-time" } @@ -12258,4 +16335,4 @@ } } } -} \ No newline at end of file +} diff --git a/docs/phase-a-company-registration-onboarding-implementation-report.md b/docs/phase-a-company-registration-onboarding-implementation-report.md new file mode 100644 index 0000000..9bca1ba --- /dev/null +++ b/docs/phase-a-company-registration-onboarding-implementation-report.md @@ -0,0 +1,106 @@ +# Phase A 企业注册与入驻基础闭环实施报告 + +日期：2026-09-22 +范围：企业专用注册、`company-register` 验证码、事务创建、入驻聚合查询 +基线：`master` / `00153aa5d92d13e66d6cdc42ecd1fe903d6e666` + +## 1. 结论与边界 + +本阶段实现了企业注册和企业入驻状态聚合，不进入 Phase B 已认证企业业务门禁，不进入 Phase C 管理员用户与角色管理，不修改 `users.version`、`user_management_actions`、岗位/简历/Offer/面试等业务门禁。 + +当前未暂存、未提交、未推送；V1–V46 未修改；未新增 V47；没有修改生产数据库的迁移脚本。 + +## 2. 权威库存 + +编码前核对了 `AuthController`/`AuthService`、`SmsVerificationService`/`SmsVerificationCodeRepository`、`PasswordPolicy`/`PasswordAuthenticationService`、`AuthSessionService.createSession`、注销手机号墓碑、`User`/`UserRepository`/`user_roles`、`Company`/`CompanyRepository`/`CompanyService`、企业认证服务与状态、`ErrorCode`/`ErrorHttpStatusRegistry`、`SecurityConfig` 以及 OpenAPI 基线。 + +实际短信用途以源码为准，保留 `login`、`password-set`、`password-reset`，新增并白名单化 `company-register`；任意其他非空用途均拒绝。OpenAPI 基线为 180 paths / 218 operations，本阶段变更为 182 paths / 220 operations。 + +## 3. 修改文件 + +生产代码新增： + +- `auth/company/CompanyRegistrationProperties.java` +- `auth/company/CompanyRegistrationRequest.java` +- `auth/company/CompanyRegistrationResponse.java` +- `auth/company/CompanyRegistrationService.java` +- `company/CompanyOnboardingResponse.java` +- `company/CompanyOnboardingService.java` + +生产代码修改：`AuthController`、`CompanyController`、`SecurityConfig`、`application.yml`、`SmsVerificationService`、`SmsVerificationCodeRepository`、`AuditService`、`ErrorCode`、`ErrorHttpStatusRegistry`。 + +测试新增/调整为 Phase A 行为锁定、既有短信/映射/OpenAPI 计数同步；未修改 V1–V46 或 `pom.xml`。 + +## 4. 企业注册契约 + +新增 `POST /auth/company/register`，使用强类型请求 DTO 和 Jakarta Validation。客户端只能提交手机号、验证码、密码及企业资料，不能提交 `userId`、`role`、`verified` 或 `passwordHash`。成功响应包含 `userId`、`companyId`、`role=COMPANY`、`onboardingStatus=UNVERIFIED`、现有格式的 Access/Refresh Token 和 `expiresIn`，不回显完整手机号、密码、验证码或密码摘要。 + +新增 `GET /companies/me/onboarding`，仅认证用户可访问，响应只包含企业安全摘要、聚合状态、认证申请安全摘要、`missingFields` 与 `allowedActions`，不返回 `materialsJson`、`decisionReason`、`reviewerId`、存储路径或其他敏感企业数据。未新增重复的 verifications 接口。 + +## 5. 事务边界 + +`CompanyRegistrationService.register` 在一个数据库事务中完成：功能开关、短信校验/消费、注销墓碑、手机号占用检查、BCrypt 密码、用户、`user_roles`、企业资料、登录会话和固定脱敏审计事件。用户保存并 flush 后再创建企业和会话；注册失败不会向客户端返回未提交 Token。数据库唯一约束是并发最终防线，`DataIntegrityViolationException` 转为统一冲突业务错误。 + +审计写入使用 `AuditService.logRequired` 的 `PROPAGATION_MANDATORY` + `saveAndFlush`，因此审计失败会使注册事务回滚。Redis 限流键不属于数据库事务，报告和测试没有虚假声称 Redis 自动回滚。 + +## 6. 验证码原子消费 + +`SmsVerificationCodeRepository.consumeIfValid` 使用条件更新，同时约束 `id`、`used=false`、未过期和 `attempts < maxAttempts`。只有受影响行数恰为 1 才算消费成功，0 行统一按验证码无效处理。错误验证码仍递增尝试次数并保留锁定语义；用途在查询前经过固定白名单校验。企业注册事务回滚时，数据库中的 `used` 更新随事务回滚。 + +修复前行为是“查询 → 修改实体 `used` → `save`”，受控变异到该实现时，`SmsVerificationAtomicConsumptionTest` 为 4 run / 2 failures（条件更新未调用、0 行竞争未失败）；恢复条件更新后为 4 / 0 / 0 / 0。该变异证明测试不是空转。 + +## 7. 入驻状态推导 + +- `companies.verified=true` → `VERIFIED`； +- 未认证且无申请 → `UNVERIFIED`； +- 最新 `PENDING` 或 `RESUBMITTED` → `PENDING`； +- 最新 `REJECTED` → `REJECTED`； +- 未认证但最新 `APPROVED` 或未知状态 → 失败关闭并返回专用一致性错误。 + +`missingFields` 从资料实际内容派生，没有新增重复状态字段；`allowedActions` 随聚合状态返回。 + +## 8. 错误码与安全配置 + +新增唯一数字码：`COMPANY_REGISTRATION_DISABLED=10301`、`COMPANY_REGISTRATION_CONFLICT=10302`、`COMPANY_ONBOARDING_INCONSISTENT_STATE=10303`、`COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE=10304`。映射统一进入 `ErrorHttpStatusRegistry`：关闭/依赖不可用为 503，冲突/不一致为 409。 + +匿名放行仅新增 `POST /auth/company/register`；`GET /companies/me/onboarding` 保持认证，学生、管理员和匿名均不获得企业入驻数据。日志、审计和响应不记录密码、摘要、验证码、Token、SQL、手机号或请求 DTO。 + +## 9. 测试矩阵 + +新增了企业注册 service/integration/concurrency、入驻 service/controller、验证码原子消费、用途白名单、事务回滚、敏感数据、功能开关等测试类；并同步了既有短信安全、公司 Controller 和异常映射测试。 + +- Phase A 定向测试：全部通过；两项阻断整改后的完整定向集 **28/28**； +- 真实 MySQL/Testcontainers 并发：1/1，通过同验证码双线程仅一个成功； +- `mvn test`：**2865 / Failures 0 / Errors 0 / Skipped 0**； +- `mvn clean verify`：**2865 / Failures 0 / Errors 0 / Skipped 0**； +- OpenAPI：`python ..\\docs\\verify_openapi.py` → **182 paths / 220 operations，All checks passed**。 + +全量验证期间出现的 Hikari 重连和 MySQL 8.4/Flyway 兼容性 warning 均未导致失败；一次与编译并发运行的错误结果未计入，随后单独顺序运行得到上述完整通过结果。 + +测试/脚本自身问题：早期黑盒驱动曾把短信发送参数误放在 JSON body（实际接口是 query 参数），且临时 JWT 密钥长度不足 32 字符；两项均在产品代码之外修正。重复运行时还触发了短信限流，随后销毁临时数据库并以全新隔离容器重跑，得到本节所列成功结果。未放宽产品断言。 + +## 10. 真实 MySQL/Redis/RabbitMQ 黑盒 + +使用临时隔离容器（MySQL 8.4、Redis 7.4、RabbitMQ 3.13）和最新 JAR 完成真实 HTTP 验收。三中间件均真实健康，应用 `/api/v1/health` 为 200/UP。 + +验证结果：匿名 onboarding 为 401；无有效验证码注册被拒；发送 `company-register` 后注册 200；密码登录 200；`/auth/me` 200；带注册 Access Token 的 onboarding 200。数据库逐表核对为：目标手机号 `users=1`、`companies=1`、`user_roles=1` 且角色仅 `COMPANY`、`companies.verified=0`、验证码 `used=1`。密码登录产生第二个合法会话，属于预期行为。临时容器、临时 JAR 进程、临时端口和运行日志均已清理，未触碰既有 backend-infra 卷或历史数据。 + +## 11. 敏感信息扫描 + +扫描新增生产代码、测试代码、OpenAPI、验证脚本相关输出和本报告：未发现真实手机号、明文密码、BCrypt 摘要、JWT/Bearer、Refresh Token、数据库/Redis/RabbitMQ 密码、私钥、AWS key 或连接串。黑盒使用的临时凭据只存在于进程环境和临时容器，测试结束后容器和日志已删除；报告不记录其值。 + +## 12. 数据与兼容性 + +未新增数据库迁移；V1–V46 逐项保持不变。求职者短信登录、现有密码登录/设置/修改/重置、Token 刷新/登出、管理员初始化、既有企业资料和企业认证接口保持原路径与行为。企业注册后经现有 `/auth/password/login` 成功登录并得到 COMPANY 身份。 + +## 13. 未进入的范围 + +本轮没有实现已认证企业业务门禁、管理员用户/角色管理、`users.version`、`user_management_actions`、岗位发布、简历、Offer 或面试门禁改造；没有提交、推送或进入 Phase B/C。 + +## 14. 当前结束状态 + +验证完成后未暂存、未提交、未推送；无 Java/Maven 残留进程；8080/8081 空闲；临时测试账号与业务数据在隔离容器销毁时清理；未删除审计历史。工作区仍保留既有历史未跟踪文件和两个 Windows stat 缓存假阳性文件，未覆盖、删除或暂存。 + +## 15. 结论 + +实施阶段完成后，独立复验发现功能开关的宽松布尔绑定问题；现已整改为字符串配置并严格使用小写字面量 `true` 判断。事务回滚测试也已补齐 users、user_roles、companies、session、audit 五类独立故障注入，新增回滚覆盖后的完整 Phase A 定向集为 **28/28**，全量回归为 **2865/2865**，均无失败、错误或跳过。 diff --git a/docs/phase-a-company-registration-onboarding-independent-verification.md b/docs/phase-a-company-registration-onboarding-independent-verification.md new file mode 100644 index 0000000..6a6b383 --- /dev/null +++ b/docs/phase-a-company-registration-onboarding-independent-verification.md @@ -0,0 +1,157 @@ +# Phase A 企业注册与入驻基础闭环独立代码复验报告 + +日期：2026-09-22 + +## 1. 复验范围与边界 + +本次复验针对 Phase A：企业专用注册、`company-register` 验证码用途、验证码原子消费、用户/角色/企业/会话事务、企业入驻聚合查询、测试与 OpenAPI。 + +未进入 Phase B 已认证企业业务门禁，也未进入 Phase C 管理员用户与角色管理；未修改生产代码、未暂存、未提交、未推送。 + +## 2. 前置状态 + +- 分支：`master` +- HEAD：`00153aaf5d92d13e66d6cdc42ecd1fe903d6e666` +- 暂存区：空 +- 迁移：V1–V46 未修改，未新增 V47 +- `pom.xml`：无修改 +- 两个既有 Windows stat 缓存假阳性文件的工作区 blob 与 HEAD 相同，未触碰、未暂存 +- 历史未跟踪验收文件和 `backend-infra` 文件均保留 + +## 3. 独立静态核对 + +通过项： + +1. 注册服务使用事务，按 COMPANY 角色创建用户，并显式写入仅含 COMPANY 的 `user_roles`。 +2. 用户、企业保存后 flush，再创建登录会话；企业初始 `verified=false`。 +3. 注册审计使用固定脱敏文案，未发现密码、验证码、Token 或摘要输出路径。 +4. 验证码消费使用条件更新，条件包含 id、`used=false`、未过期和 attempts 上限，受影响行数必须为 1。 +5. 短信用途采用固定白名单，包含 `company-register`，不接受任意非空用途。 +6. 匿名规则仅新增 `/auth/company/register`；`/companies/me/onboarding` 仍要求认证。 +7. 入驻状态对无记录、PENDING/RESUBMITTED、REJECTED、VERIFIED 和 APPROVED 不一致状态分别处理；不一致状态失败关闭。 +8. DTO 未暴露 `userId`、客户端 `role`、`verified`、`passwordHash` 等不应由客户端控制的字段。 +9. OpenAPI 中新增注册和入驻查询契约，未改变 V1–V46 或既有业务路径。 + +## 4. 定向测试与真实黑盒 + +实施测试与复验前已执行的 Phase A 定向测试为 **23/23，Failures=0，Errors=0，Skipped=0**，其中包含真实 MySQL/Testcontainers 并发注册测试。 + +此前全量结果： + +- `mvn test`：2860/0/0/0 +- `mvn clean verify`：2860/0/0/0 +- OpenAPI：182 paths / 220 operations，All checks passed + +隔离 MySQL 8.4、Redis 7.4、RabbitMQ 3.13 和最新 JAR 的黑盒结果：健康检查通过；发送 `company-register` 验证码后注册成功；密码登录成功；`/auth/me` 返回 COMPANY；入驻查询返回 200；目标数据为 1 个 COMPANY 用户、1 个 COMPANY 角色、1 个企业且 `verified=0`，验证码已消费。临时容器、进程、端口和日志已清理。 + +## 5. 阻断项：功能开关绑定不满足严格字面量要求 + +生产文件：`mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationProperties.java` + +当前字段为： + +```java +private boolean enabled = false; +``` + +Spring Boot 标准布尔绑定会把 `TRUE`、`True`、`yes`、`1`、`on` 均转换为 `true`。独立临时测试使用 `ApplicationContextRunner` 真实绑定配置，逐一设置： + +```text +app.company-registration.enabled=TRUE +app.company-registration.enabled=True +app.company-registration.enabled=yes +app.company-registration.enabled=1 +app.company-registration.enabled=on +``` + +复验结果：五个非字面量值均绑定为 enabled=true，测试失败： + +```text +Tests run: 1, Failures: 1, Errors: 0, Skipped: 0 +Expecting empty but was: ["TRUE", "True", "yes", "1", "on"] +``` + +这与设计要求“只有字面量 `true` 才开启，其他值不得误开启”不一致，因此 Phase A 独立复验判定 **FAIL**。临时测试已删除，未留在工作区。 + +整改建议：将配置原始值改为 String，并通过唯一方法严格判断： + +```java +private String enabled = "false"; + +public boolean isEnabled() { + return "true".equals(enabled); +} +``` + +同时增加真实 Spring 属性绑定测试，覆盖未设置、`false`、`true`、`TRUE`、`True`、`yes`、`1`、`on`；只有小写字面量 `true` 应开启。 + +## 6. 整改前的次要测试覆盖缺口 + +以下是首次独立复验时发现的证据缺口，不作为已证明的生产缺陷： + +1. `CompanyRegistrationTransactionRollbackTest` 目前主要覆盖审计失败，未分别注入并断言 users 保存、user_roles 保存、companies 保存、会话创建和审计写入五类失败；对 user_roles/auth_tokens 的零残留断言也不完整。 +2. 注册请求中客户端附带未知的 role/verified/passwordHash 字段的既有测试，可能因验证码未准备而返回 400，不能单独证明未知字段被拒绝；DTO 本身未声明这些字段。 +3. tombstone、Redis/数据库/会话依赖异常和每种冲突角色的完整 HTTP 黑盒覆盖仍需单独补齐或明确证据。 + +## 7. 复验结论 + +Phase A 的主要注册、验证码原子消费、事务、并发、入驻聚合和真实中间件路径基本可用，但严格功能开关绑定存在阻断缺陷；另有事务回滚测试覆盖不足。 + +最终判定：**FAIL，暂不能进入独立通过或提交检查点。** + +本次独立复验未修改生产代码、未暂存、未提交、未推送，未进入 Phase B/C。 + +## 8. 阻断整改复验（2026-09-22） + +针对第 5 节阻断，已按最小范围修改： + +- `CompanyRegistrationProperties.enabled` 改为字符串，默认值为 `"false"`； +- `isEnabled()` 仅返回 `"true".equals(enabled)`； +- `CompanyRegistrationFeatureFlagTest` 增加真实 `ApplicationContextRunner` 绑定测试，覆盖 `TRUE`、`True`、`yes`、`1`、`on`、`false` 和 `true`。 + +整改后验证： + +- 功能开关及关联测试：**9/9，F=0、E=0、S=0**； +- Phase A 定向测试：**24/24，F=0、E=0、S=0**； +- `mvn clean verify`：**2861/2861，F=0、E=0、S=0**； +- OpenAPI：**182 paths / 220 operations，All checks passed**。 + +独立绑定测试确认只有字面量 `true` 开启，五种非字面量值均保持关闭。未新增迁移，未进入 Phase B/C，未提交或推送。 + +功能开关阻断已清除；第 6 节的事务回滚覆盖缺口已在第 9 节补齐。 + +说明：第 7 节“FAIL”是整改前复验结论；当前状态以第 8、9 节整改复验结果为准。 + +## 9. 事务回滚覆盖整改复验（2026-09-22） + +`CompanyRegistrationTransactionRollbackTest` 已补齐五类独立故障注入： + +- users 保存失败； +- user_roles 真实插入触发器失败（H2 真实 SQL）； +- companies 保存失败； +- 会话创建失败； +- 审计写入失败。 + +每种场景均验证 users、user_roles、companies、auth_tokens 无残留，验证码 `used=false`，并按精确测试手机号清理。测试结果：**5/5，F=0、E=0、S=0**。 + +## 10. 阻断修复后的完整回归收口（2026-09-22） + +为避免把整改前的历史数字误读为当前结果，最终收口结果单独列示如下： + +- 功能开关整改后的独立定向：9/9； +- 五类事务回滚注入：5/5； +- Phase A 完整定向测试：**28/28，F=0、E=0、S=0**； +- `mvn clean verify`：**2865/2865，F=0、E=0、S=0，BUILD SUCCESS**； +- OpenAPI：**182 paths / 220 operations，All checks passed**； +- 真实 MySQL/Testcontainers 并发注册：已执行并通过； +- V1–V46 未修改，未新增 V47；未进入 Phase B/C，仍未暂存、未提交、未推送。 + +期间 H2 user_roles 触发器用于证明真实 SQL 插入失败，触发日志中的预期 SQL 错误属于测试注入证据，不是生产异常；未修改生产错误映射，也未放宽任何断言。 + +## 11. 复验重跑收口（2026-09-22） + +- 独立静态门禁通过：功能开关严格按小写字面量 `true` 开启；匿名放行仅包含 `/auth/company/register`；注册 DTO 未暴露 `userId`/`role`/`verified`/`passwordHash`；验证码白名单、条件消费和 `attempts < maxAttempts` 均已分别在 Service 与 Repository 位置核对；未发现 V47。 +- 首次静态脚本曾把 `attempts < c.maxAttempts` 错查在 `SmsVerificationService.java`，造成脚本假阴性；修正为检查 `SmsVerificationCodeRepository.java` 后门禁通过。该问题仅存在于复验脚本，不是产品缺陷。 +- Phase A 定向重跑：**28/28，Failures=0、Errors=0、Skipped=0**；真实 `CompanyRegistrationConcurrencyMySqlTest` 启动 MySQL 8.4 Testcontainers 并实际执行。 +- OpenAPI：**182 paths / 220 operations，All checks passed**。 +- 收尾：无 Java/Maven 残留进程，8080/8081 无监听，暂存区为空；本轮未修改生产代码、未提交、未推送，未进入 Phase B/C。 diff --git a/docs/phase1-scope-and-acceptance.md b/docs/phase1-scope-and-acceptance.md new file mode 100644 index 0000000..79d21ec --- /dev/null +++ b/docs/phase1-scope-and-acceptance.md @@ -0,0 +1,127 @@ +# 一期范围、责任与验收清单 + +冻结日期：2026-09-08。范围依据：负责人本轮明确确认。本文是一期范围与交付状态的权威清单；历史路线图与本文冲突时，以本文为准。 + +范围冻结不等于设计批准或验收通过。八个待交付功能组全部属于一期，不再以“后置建议”将其排除。新增接口、迁移、计分规则和权限变化仍需在各模块设计中明确后编码。本文不预分配版本号、迁移号或接口数量。 + +## 1. 责任与完成定义 + +- 张顺（你）：业务与产品负责人，主责评分、监测、消息和简历相关能力。 +- 小刘：主责内容与数据型功能、积分独立模块及交付环境。 +- 表中负责人负责设计、实现、测试和文档；另一位负责独立审查。模块作者不能用自己的完成报告代替独立验收。 +- 前端由现有前端同学实现，后端负责人提供契约并组织联调；未指定具体前端人员，不虚构责任人。 +- 状态采用：待设计、设计待确认、实现中、待独立复验、待真库验收、待前端验收、一期验收完成。Git 已提交与功能已验收分别记录。 +- 每项完成必须具备：需求用例、权限与隐私边界、可执行自动化、适用的真实 MySQL 验证、前端流程验收、文档和可追溯提交。无需迁移的模块不强行新增迁移。 + +下面代码路径均相对项目根目录 `C:/Users/15642/Desktop/zhilai`。生产包根为 `mydreamjob-server/src/main/java/com/mydreamjob/`，测试包根为 `mydreamjob-server/src/test/java/com/mydreamjob/`。拟新增包只是定位建议，不代表已存在。 + +## 2. 已有核心能力：保留在一期，执行集成回归 + +这些能力已有代码及历史验证记录；本轮仅核查入口和 Git，不重新宣称所有历史黑盒已通过。 + +| 编号/能力 | 一期需要什么 | 现有代码入口（生产包根下） | 如何验收 | 主责 / 复核 | +|---|---|---|---|---| +| C01 认证与企业认证 | 注册登录、身份校验、企业认证与权限隔离 | auth/、verification/、config/SecurityConfig.java | 登录失败/过期/匿名/角色越权；企业审核主链路；生产短信配置验证 | 小刘 / 张顺 | +| C02 档案与岗位 | 学生资料、偏好、企业资料、岗位发布搜索收藏比较 | profile/、preference/、company/、job/ | 企业只能改本企业岗位；公开字段白名单；筛选分页与资料更新页面联调 | 小刘 / 张顺 | +| C03 招聘主链路 | 投递、面试、结构化评分、Offer、进度 | application/、interview/、interviewscore/、offer/、careerprogress/ | 从注册到投递、面试、Offer逐步操作；拒绝/撤回/过期/重复请求与并发 | 张顺 / 小刘 | +| C04 沟通与安全 | 匹配、会话、消息、通知、举报屏蔽 | messaging/、notification/、bidirectionalmatch/、safety/ | 非成员不能读写；屏蔽生效；DIRECT与邀约会话隔离；重试不重复 | 张顺 / 小刘 | +| C05 简历与账户隐私 | 简历版本导出、个人数据导出、注销与隐私授权 | resume/、privacy/、deletion/、dataexport/ | 文件下载归属；导出内容脱敏；注销状态机；保留策略和恢复验证 | 张顺 / 小刘 | +| C06 评价与企业回复 | 评价、预审、管理员决策、企业官方回复 | review/、feedback/ | 公开载荷无学生身份；仅通过回复公开；幂等及审核并发；企业归属 | 小刘 / 张顺 | +| C07 测评与评分治理 | RIASEC、四维能力、评分卡、排名、申诉回滚、防刷 | assessment/、ability/、candidatescore/、competition/、risk/ | 抽题/计时/有效期/规则开关；申诉回滚；评分读取与写入边界；结果解释 | 张顺 / 小刘 | +| C08 推荐与人才邀约 | 岗位推荐、学生授权发现、企业邀约与接受后沟通 | recommendation/、talentdiscovery/、talentinvitation/ | 默认不发现；同企业历史投递排除；限额/冷却/幂等；接受后会话隐私 | 张顺 / 小刘 | +| S01 认证安全整改 | 验证码不落日志、受控取码、`/jobs` 认证边界 | auth/、docs/smoke-test.sh、job/JobController.java | 双开关受控取码；mock=false 完整回滚；`/jobs` 权限矩阵（独立代码复验与真实 MySQL/Docker 黑盒已通过） | 张顺 / 独立复验 | +| S02 Token 隔离与会话吊销 | Access/Refresh 类型与密钥隔离、轮换、重放处置、会话吊销 | auth/（JwtTokenProvider、AuthSessionService、AuthTokenHasher、JwtAuthenticationFilter、AuthController）、V42__auth_token_sessions.sql | Refresh 不能访问普通接口；Access 不能刷新；二次使用撤销当前会话；并发刷新最多成功一次；登出/注销完成使会话失效 | 张顺 / 独立复验 | +| S03 生产配置与简历隐私 | 历史种子账号治理、一次性管理员初始化、企业简历下载授权、Actuator 隔离 | auth/（AdminBootstrapRunner）、application/（CompanyResumeAccessPolicy、CompanyResumeService）、V43__disable_legacy_seed_accounts.sql、application.yml | V43 只禁用完全匹配原始指纹的三条种子账号；管理员初始化默认关闭且幂等；三种可见性 × 全部投递状态 × 跨企业/未认证企业矩阵；拒绝路径零文件读取；业务端口不提供指标 | 张顺 / 独立复验 | + +### 2.1 Q01 岗位搜索真实查询覆盖（C02 证据补充） + +`JobSearchSpecification` 与 `JobService.searchJobs` 原先只被纯 Mockito 测试覆盖（`JobSearchServiceTest` 把 `findAll(Specification, Pageable)` 整体 Mock 掉），无法证明 Criteria 谓词、SQL 过滤、排序与分页在真实数据库上的行为。Q01 补齐真实查询证据，**只新增测试与文档，未改动生产代码、接口、DTO、状态机、权限、搜索语义与索引**。 + +测试分层与结果（详见 [Q01 实施报告](q01-job-search-real-query-implementation-report.md)）： + +| 层次 | 测试类 | 数据库 | Tests run | Failures | Errors | Skipped | +|---|---|---|---|---|---|---| +| H2 真实 Repository | `job/JobSearchSpecificationIntegrationTest` | H2 + 真实 Flyway | 19 | 0 | 0 | 0 | +| H2 真实 Service / EntityManager | `job/JobSearchServiceIntegrationTest` | H2 + 真实 Flyway | 9 | 0 | 0 | 0 | +| H2 查询副作用行级快照 | `job/JobSearchQuerySideEffectIntegrationTest` | H2 + 真实 Flyway | 4 | 0 | 0 | 0 | +| 真实 MySQL 8 规格对账 | `job/JobSearchSpecificationMySqlIntegrationTest` | MySQL 8.4（Testcontainers） | 13 | 0 | 0 | 0 | +| 真实 MySQL 查询副作用行级快照 | `job/JobSearchQuerySideEffectMySqlIntegrationTest` | MySQL 8.4（Testcontainers） | 4 | 0 | 0 | 0 | +| 真实 MySQL 执行计划与查询次数 | `job/JobSearchQueryExplainMySqlIntegrationTest` | MySQL 8.4（Testcontainers） | 1 | 0 | 0 | 0 | + +- MySQL 层用正式 Flyway 迁移 + `ddl-auto=validate` 启动，连接参数由 `@DynamicPropertySource` 运行期注入，不落盘、不打印；核心用例**真实执行、无 SKIP**。 +- H2 与 MySQL 在 keyword（三字段/大小写/trim/空白与 `%`、`_` 特殊字符）、city、employmentType、companyId、薪资边界与区间重叠、PUBLISHED 强制过滤、latest/relevance/salary 排序、分页与 total 上**逐项一致，未发现语义差异**。 +- 副作用证据为 jobs、companies、users、applications、candidate_dimension_scores、notifications、conversations、messages、audit_logs 九张表的**行级稳定字段快照**（非 COUNT/SUM），并配「改字段 / 插行 / 删行」三条**反证测试**证明比较本身有效。 +- 真实 MySQL 上对组合过滤、latest 分页、salary 排序与 count 执行 `EXPLAIN FORMAT=JSON`；小样本夹具下为全表扫描 + filesort，**不构成生产规模结论**，前导通配符与排序成本移交 R01。 +- OpenAPI 保持 176 paths / 214 operations，`docs/openapi-rc.json` 未改动。 + +状态：**Q01 已完成真实查询测试实现与自动化验证，待独立代码复验及独立真实 MySQL/Docker 验收。** + +## 3. 一期必须补齐的八个功能组 + +以下交付边界用于控制设计范围；涉及产品参数的内容明确列为待评审，不得由实现者自行锁定。 + +| 编号/功能 | 当前状态与一期需要什么 | 代码在哪里 | 如何验收 | 主责 / 复核 | +|---|---|---|---|---| +| N01 V43过程公平性与稳定性监测 | 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（cf39737）；历史不足返回UNAVAILABLE | 现有 scoringmonitoring/；docs/v43-candidate-scoring-fairness-design.md | 版本内补集、申诉集合、权限、只读性及30/300/3000查询预算通过；EXPLAIN扩容风险纳入容量观察 | 张顺 / 小刘 | +| N02 评分规则解释与合理性 | 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（dbd27e6） | candidatescore/CandidateScoringCalculator.java、CandidateScoringEngineService.java、candidatescore/explanation/；docs/candidate-scoring-explanation-design.md、docs/candidate-scoring-rule-evidence.md | 未知规则安全失败；真实 H2 时间边界、四入口单次 capturedNow、企业完整 JSON 脱敏、运行时 OpenAPI 与真库回归均已通过 | 张顺 / 小刘 | +| N03 行业技能词云 | 未确认有独立实现；用有授权、可追溯的数据生成技能频次，支持空数据与更新时间；不是装饰性随机词云 | 现有 job/、recommendation/ 可复用数据入口；拟新增 skillinsight/ | 同义词归一/去重/计数用已知样本对账；行业筛选与来源日期准确；无数据不编造；批量性能与页面联调 | 小刘 / 张顺 | +| N04 入职清单与公司知识介绍 | 未确认有独立实现；清单模板、个人完成进度、公司可公开介绍；公司原有介绍与新增入职知识明确区分 | 现有 company/、offer/、careerprogress/；拟新增 onboarding/ | 本人进度隔离、企业内容归属、模板变更行为、重复更新；未认证内容不得冒充平台核验；页面完整走通 | 小刘 / 张顺 | +| N05 薪资计算器与薪资参考 | 未确认有独立实现；可解释的计算明细与有来源的薪资参考；明确币种、周期、地区、规则生效期和估算性质 | 现有 job/、offer/ 可提供薪资字段；拟新增 salary/ | 经确认的规则用独立算例验证舍入与边界；来源/版本/更新时间；缺地区或参考样本时明确不可计算/不足；不伪造市场数据 | 小刘 / 张顺 | +| N06 诚信积分与激励 | 独立积分能力未完成，现有INTEGRITY不是积分账户；先确定合格行为、积分流水、撤销和展示语义，不以简单行为推断人格 | 现有 candidatescore/CandidateScoringCalculator.java#computeIntegrity、audit/；拟新增 incentive/ | 积分事件幂等、并发不重复加分、撤销可追溯、余额与流水一致、刷行为不无限获益；与候选评分默认隔离，接入必须单独评审 | 小刘 / 张顺 | +| N07 消息撤回 | N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收；发送者在两分钟窗口内撤回，列表/响应统一显示撤回态并覆盖原正文 | 现有 messaging/MessagingService.java、talentinvitation/；docs/message-recall-design.md、docs/message-recall-implementation-instruction.md、docs/messaging-api.md | 非本人不可撤回；时间边界、并发读取/撤回、幂等；撤回后正文不从当前数据库、响应、日志或审计泄漏；DIRECT与邀约会话回归 | 张顺 / 小刘 | +| N08 简历查重 | 未确认有独立实现；先界定同人重复上传与跨文档相似检测，给出依据和局限；不得直接判抄袭或自动扣分 | 现有 resume/ResumeVersionService.java、profile/storage/；拟新增 resumededup/ | 重复文件/改名/模板相似/不同格式/解析失败样例；阈值误报验证；不得借查重返回他人简历、姓名或联系方式；上传性能与租户隔离 | 张顺 / 小刘 | + +### 编码前必须补齐的产品决策 + +范围已确认，以下细节未确认。负责人先交付短设计，双方评审后再实现，不因缺细节将功能移出一期。 + +- N02：各规则的业务含义、兼容解释方式、测评试测样本与证据门槛已形成；本版不改变现有分数、企业聚合或排名，后续规则调整必须另开评分版本。 +- N03：行业受控字典、数据来源和授权、统计窗口、最小样本、更新方式。 +- N04：清单适用人群与触发点、模板维护方、公司内容发布/审核机制、进度保存方式。 +- N05：税前/税后/年包范围、支持地区、规则与市场参考数据来源、更新责任。涉及税费规则时设计阶段查验权威资料。 +- N06：积分名称、可积分事件、额度、冷却、撤销、兑换或仅展示；不能默认涉及现金/奖品。 +- N07：撤回时间窗、附件与引用、离线/缓存同步、审计及数据保留口径。 +- N08：查重范围、合法数据边界、文件类型、指纹或文本相似算法、阈值和提示对象；跨用户查重需单独隐私评审。 + +## 4. 一期交付保障，同样属于未完成工作 + +| 编号 | 需要什么 | 入口 | 如何验收 | 主责 / 复核 | +|---|---|---|---|---| +| G01 可复现构建与持续验证 | 干净环境构建、PR检查、MySQL兼容验证、精确版本产物 | mydreamjob-server/pom.xml、测试目录、backend-infra/；CI落点待设计 | 新环境按文档运行；提交触发测试；失败阻断；JAR摘要关联提交 | 小刘 / 张顺 | +| G02 部署与恢复 | 环境隔离、密钥管理、必要外部服务、文件持久化、数据库/文件备份恢复、发布回退 | backend-infra/、profile/storage/、resume/storage/、dataexport/storage/ | 隔离环境部署演练、恢复演练和回退证据；不把启动成功当恢复完成 | 小刘 / 张顺 | +| G03 监控、安全与容量 | 指标告警、权限隐私、依赖失败、重试、压测、敏感信息检查 | config/、audit/、健康检查、各模块 | 定义预计并发与SLA后实测；故障有告警、可定位；依赖中断和重复请求不破坏一致性 | 小刘 / 张顺 | +| G04 一期前端联调与用户验收 | 核心招聘链路与N01–N08对应页面可用，空态/错误态明确 | docs/frontend-integration.md、各API文档、前端仓库待登记 | 前端同学参与逐项签收；合成账号端到端录证；缺陷关闭后小范围试运营 | 张顺 / 小刘 | + +这四项是交付工作包，不代表恰好四个代码模块。已有资产可复用，但必须提供当前证据。 + +## 5. 排期与合并顺序 + +1. 张顺先收尾N01并完成N02规则评审；小刘同步搭建G01及设计N03。N01真库验收通过前不宣称V43冻结。 +2. 张顺实现N07；小刘实现N03，再实现N04。各模块先短设计、后实现、再独立验收。 +3. 张顺实现N08；小刘实现N05。数据来源、隐私与阈值未确认时先处理其他不依赖的工作。 +4. N02语义确认后，小刘实现N06，张顺复核与评分引擎的边界。 +5. G02/G03从第一阶段持续推进，最后执行G04和整体发布演练，不等所有业务代码写完才准备环境。 + +并行开发前登记各自改动路径。共享文件（ErrorCode、SecurityConfig、OpenAPI、路线图）由当次集成负责人串行合并。新Flyway号在准备合并前从实际主线分配；不得两人各自假定下一号。每个模块独立提交，可以批量推送，但不要将整个一期积累成一个巨型提交。 + +不承诺未估算的日期。每个短设计确认后再估工时、依赖和验收时间。当前是“8个待闭环功能组 + 4个交付工作包 + 既有核心回归”，不能折算成未经验证的完成百分比。 + +## 6. 明确移出一期 + +以下进入后续候选池，不占一期验收范围： + +- AI简历诊断与生成式优化； +- AI模拟面试与面试题预测； +- SHAP高级模型解释；一期仍包含确定性规则解释； +- 受保护人口属性公平性分析；一期不推断敏感属性； +- 需要新增不可变历史快照才能实现的历史分数漂移、历史排名稳定性；V43一期返回UNAVAILABLE； +- 自动调整评分/排名/权重、自动封禁； +- 超出已确认模块的现金奖励、交易/付费及新增商业化功能。 + +行业技能词云、入职清单/公司知识介绍、薪资计算器/参考、诚信积分/激励、消息撤回、简历查重均明确保留在一期。 + +## 7. 范围变更与状态证据 + +新增或删减一期项须记录负责人决定、原因、影响、验收变化。变更实现细节不得隐式改变产品范围。每次交付更新本清单状态与证据链接；不靠版本号大小代表完成度。 + +本轮仅冻结范围和责任，没有新增业务代码、迁移或测试执行。历史测试数不能视为本轮复验结果。已核实提交包括V39 55e3975、V40 2698d06、V41 5cc2c86、V42 96b3113；V43仍未提交且待整改复验。 diff --git a/docs/phone-password-authentication-design.md b/docs/phone-password-authentication-design.md new file mode 100644 index 0000000..4238f96 --- /dev/null +++ b/docs/phone-password-authentication-design.md @@ -0,0 +1,796 @@ +# 手机号密码认证设计 + +> 文档类型：设计说明与实现参考 +> 状态：设计已确认，可进入实施；尚未编码 +> 适用项目：`mydreamjob-server` +> 基线：`master` / `dedd47e3db42fee26bbeb21f1925ca1da127fb65` +> 设计日期：2026-09-20 + +## 1. 目标 + +在不破坏现有手机号验证码登录的前提下，增加手机号密码认证能力： + +1. 手机号密码登录； +2. 首次设置密码； +3. 使用旧密码修改密码； +4. 使用短信验证码找回并重置密码； +5. 密码错误计数、临时锁定和手机号/IP 双维度限流； +6. 密码变更后撤销该用户全部登录会话； +7. 防止账号枚举、时序侧信道以及日志、审计和响应泄漏。 + +所有登录方式认证成功后必须复用现有 `AuthSessionService` 创建 Access/Refresh Token 会话，不建设第二套 Token 或会话体系。 + +## 2. 非目标 + +本模块明确不包含： + +- 本机号码一键登录； +- 微信、支付宝、Apple、OAuth 或其他第三方登录； +- 用户名或邮箱登录； +- 支付、兑换、实名或多因素认证； +- 修改现有 Access/Refresh Token 格式、有效期、轮换和重放处置； +- 修改验证码登录的自动注册语义； +- 修改角色、权限、注销、评分、推荐、简历或消息业务语义； +- 在本轮接入外部弱密码或泄漏密码在线查询服务。 + +## 3. 当前基线 + +### 3.1 已有能力 + +| 能力 | 当前实现 | +|---|---| +| 验证码发送 | `POST /auth/sms/send` | +| 验证码登录 | `POST /auth/login` | +| 登录会话 | `AuthSessionService#createSession` | +| Token 刷新 | Refresh Token 单次消费、轮换与重放撤销 | +| 登出 | 撤销当前 session | +| 全局撤销 | `AuthSessionService#revokeAllUserSessions` | +| 密码字段 | `users.password_hash VARCHAR(255) NULL` | +| 密码算法 | 已有 `BCryptPasswordEncoder` Bean | +| 临时状态 | 已有 Redis 及 `RedisTemplate` | +| 用户状态 | `is_active`、注销记录和注销手机号墓碑 | + +### 3.2 当前缺口 + +- `password_hash` 没有面向普通用户的写入或校验入口； +- 没有密码设置、修改、重置 DTO 和服务； +- 没有密码失败计数、账号锁定或 IP 限流； +- 没有密码变更后的会话撤销审计； +- `CREDENTIALS_INVALID(2005)` 当前未被使用，且未显式映射为 HTTP 401； +- 现有通用 `RATE_LIMITED(9002)` 保持历史 HTTP 400，不适合作为新密码接口的 429 契约。 + +## 4. 核心决策 + +| 事项 | 决策 | +|---|---| +| 账号标识 | 唯一账号为 11 位手机号 | +| 登录方式 | 验证码登录和密码登录并存 | +| 未设置密码的旧用户 | 继续使用验证码登录，再主动设置密码 | +| 密码长度 | 12–64 个 Unicode 字符（按 Unicode code point 计） | +| 机械复杂度 | 不强制大小写、数字、符号组合 | +| 弱密码 | 本地、版本化弱密码名单整值匹配；禁止包含完整手机号 | +| 规范化 | 设置与校验前统一做 Unicode NFC；不 trim、不改大小写 | +| 存储 | BCrypt 单向摘要，禁止明文、可逆加密或独立盐字段 | +| BCrypt cost | 默认 10；部署机基准测试后才允许调整 | +| 首次设置 | 有效 Access Token + `password-set` 短信验证码 | +| 修改 | 有效 Access Token + 当前密码 | +| 重置 | 手机号 + `password-reset` 短信验证码 | +| 会话 | 设置、修改、重置成功后撤销全部会话，包括当前会话 | +| 登录失败锁定 | 手机号引用连续失败 5 次，锁定密码登录 15 分钟 | +| IP 限流 | 单 IP 10 分钟最多 30 次密码登录尝试 | +| Redis 故障 | 密码登录及密码敏感操作失败关闭，返回服务暂不可用 | +| 防枚举 | 不存在、无密码、密码错误、inactive、注销均返回相同 401 | +| 注册 | 密码登录绝不自动创建账号 | + +## 5. API 契约 + +所有路径继续受全局 context path `/api/v1` 约束。下面只写 Controller 相对路径。 + +### 5.1 密码登录 + +```http +POST /auth/password/login +Content-Type: application/json +``` + +```json +{ + "phone": "13800138000", + "password": "correct horse battery staple" +} +``` + +成功时返回与现有验证码登录相同的用户与 Token 字段： + +```json +{ + "code": 200, + "message": "success", + "data": { + "userId": 123, + "phone": "13800138000", + "nickname": "用户8000", + "role": "STUDENT", + "accessToken": "", + "refreshToken": "", + "expiresIn": 86400 + }, + "requestId": "..." +} +``` + +约束： + +- `phone` 必须为 11 位数字； +- `password` 必填，输入上限 64 个字符； +- 不存在的手机号不得创建用户； +- 失败原因统一，不返回“用户不存在”“尚未设置密码”“账号停用”等差异信息； +- 成功后清除该手机号引用的失败计数，但不清除 IP 窗口计数。 + +### 5.2 首次设置密码 + +```http +POST /auth/password/set +Authorization: Bearer +Content-Type: application/json +``` + +```json +{ + "smsCode": "123456", + "newPassword": "correct horse battery staple" +} +``` + +前置步骤： + +```http +POST /auth/sms/send?phone=<当前登录手机号>&purpose=password-set +``` + +规则： + +- 手机号只能来自 Access Token 对应的当前用户，客户端不得传入手机号； +- 验证码用途必须严格为 `password-set`； +- 仅 `password_hash IS NULL` 时允许； +- 已有密码返回状态冲突，不得覆盖； +- 成功后撤销全部会话，调用方当前 Access Token 随即失效； +- 成功响应不签发新 Token。 + +成功响应： + +```json +{ + "code": 200, + "message": "success", + "data": { "passwordConfigured": true, "reauthenticationRequired": true }, + "requestId": "..." +} +``` + +### 5.3 修改密码 + +```http +POST /auth/password/change +Authorization: Bearer +Content-Type: application/json +``` + +```json +{ + "currentPassword": "old password", + "newPassword": "new correct horse battery staple" +} +``` + +规则： + +- 只接受 Access Token，Refresh Token 必须返回 401； +- 当前密码错误统一返回凭据错误； +- 未设置密码时返回密码状态冲突，引导用户走首次设置； +- 新旧密码不得相同； +- 成功后撤销全部会话且不签发新 Token。 + +### 5.4 找回并重置密码 + +前置步骤： + +```http +POST /auth/sms/send?phone=13800138000&purpose=password-reset +``` + +重置： + +```http +POST /auth/password/reset +Content-Type: application/json +``` + +```json +{ + "phone": "13800138000", + "smsCode": "123456", + "newPassword": "new correct horse battery staple" +} +``` + +规则： + +- 该接口匿名可访问； +- 验证码用途必须严格为 `password-reset`； +- 请求短信验证码时，无论账号是否存在都返回相同的受理响应； +- 账号不存在时不得创建账号； +- 只有有效验证码和可用账号才能修改摘要； +- 成功后撤销全部会话且不自动登录； +- inactive 或已完成注销的账号不得被重置流程复活； +- 验证失败不说明是账号、验证码还是用户状态问题。 + +## 6. DTO 与输入处理 + +建议新增： + +- `PasswordLoginRequest(phone, password)`； +- `PasswordSetRequest(smsCode, newPassword)`； +- `PasswordChangeRequest(currentPassword, newPassword)`； +- `PasswordResetRequest(phone, smsCode, newPassword)`； +- `PasswordOperationResponse(passwordConfigured, reauthenticationRequired)`。 + +要求： + +- DTO 不实现 `toString()`，不得使用会输出字段值的 Lombok `@Data`； +- 密码字段不进入 Bean Validation 默认错误回显； +- JSON 未知字段继续遵循项目现有全局策略； +- Controller 不打印请求体，不把请求 DTO 放入异常或审计 details； +- 前端可提供 `confirmPassword`，但后端不信任该字段；后端只接收一次新密码。 + +## 7. 密码策略 + +### 7.1 接受规则 + +1. NFC 规范化后长度为 12–64 个 Unicode code point； +2. 允许空格和 Unicode 字符； +3. 不自动删除首尾空格； +4. 不自动转换大小写； +5. 不能等于或包含完整手机号； +6. 不能命中项目内置、版本化的弱密码集合； +7. 新密码不能与当前密码相同。 + +### 7.2 弱密码名单 + +第一版使用仓库内只读资源，例如： + +```text +src/main/resources/security/common-passwords.txt +``` + +该文件： + +- 只包含公开常见弱密码，不包含任何用户数据； +- 在启动时加载为不可变集合； +- 加载失败时应用启动失败，不能静默关闭策略； +- 后续更新必须作为可审查的版本化变更； +- 本轮不调用外部泄漏密码 API，避免把用户密码或派生值发送给第三方。 + +## 8. BCrypt 存储与升级 + +### 8.1 写入 + +```text +normalized = NFC(rawPassword) +password_hash = BCryptPasswordEncoder.encode(normalized) +``` + +禁止： + +- 明文密码落库； +- SHA/MD5 等快速摘要； +- 在数据库增加明文盐； +- 把密码、摘要或其前缀写入日志、审计、响应、消息或异常。 + +### 8.2 校验 + +```text +PasswordEncoder.matches(NFC(input), storedHash) +``` + +手机号不存在或没有密码时，也必须对固定 dummy BCrypt 摘要执行一次 `matches`，减少响应时间差异。dummy 摘要作为应用常量，由构建时生成，不包含真实密码或部署秘密。 + +### 8.3 cost 与升级 + +- 默认沿用当前 `BCryptPasswordEncoder` strength 10； +- 在 Jenkins 部署目标机上测量 P50/P95，再决定是否提高； +- 目标单次校验不超过服务可接受的登录延迟和并发预算； +- 若未来启用 `upgradeEncoding()`，仅在一次成功密码登录中升级摘要，并与会话创建保持失败原子性；第一版可不启用自动升级。 + +## 9. 失败计数、锁定与限流 + +### 9.1 标识保护 + +Redis key 不得包含完整手机号或原始 IP。使用独立 HMAC 密钥生成不可逆引用： + +```text +phoneRef = HMAC-SHA256(PASSWORD_RATE_KEY_SECRET, normalizedPhone) +ipRef = HMAC-SHA256(PASSWORD_RATE_KEY_SECRET, normalizedIp) +``` + +只使用截断后的十六进制引用作为 key 片段；HMAC 原始值不得进入日志。 + +### 9.2 Redis key + +```text +auth:pwd:fail:{phoneRef} TTL 15 分钟 +auth:pwd:locked:{phoneRef} TTL 15 分钟 +auth:pwd:ip:{ipRef}:{window} TTL 10 分钟 +auth:pwd:op:{phoneRef}:{kind} 敏感操作限流 +``` + +### 9.3 规则 + +| 维度 | 规则 | 超限行为 | +|---|---|---| +| 手机号 | 连续失败 5 次 | 锁定密码登录 15 分钟 | +| IP | 10 分钟最多 30 次密码登录请求 | HTTP 429 | +| 设置/修改/重置 | 每手机号引用 10 分钟最多 10 次 | HTTP 429 | +| 登录成功 | 清除手机号失败和锁定 key | 保留 IP 窗口 | +| 验证码登录 | 不受密码锁定影响 | 仍受原短信限流 | + +计数与首次 TTL 设置必须由 Lua 脚本或等价 Redis 原子操作完成，不能用非原子的 `INCR` 后再独立 `EXPIRE` 留下永久 key。 + +### 9.4 Redis 故障 + +密码认证与密码敏感操作在 Redis 不可用时失败关闭： + +- 不校验密码； +- 不创建会话； +- 不修改密码； +- 返回固定的服务暂不可用响应； +- 日志只记录固定分类和 requestId，不记录 Redis 地址、手机号或原始异常消息。 + +验证码登录沿用既有行为，本设计不顺带改变其 Redis 降级语义。 + +## 10. 防账号枚举 + +密码登录以下情况使用完全相同的外部响应： + +- 手机号不存在； +- `password_hash IS NULL`； +- 密码错误； +- 用户 inactive； +- 用户已完成注销； +- 手机号命中注销墓碑； +- 用户角色或会话创建条件不合法。 + +统一响应： + +```http +HTTP/1.1 401 Unauthorized +``` + +```json +{ + "code": 2005, + "message": "手机号或密码错误", + "requestId": "..." +} +``` + +实现要求： + +- 不存在用户仍执行 dummy BCrypt； +- inactive 等状态不得在校验前快速返回； +- 响应状态、业务码、正文结构和主要计算路径一致； +- 不承诺网络层严格恒定耗时，但独立测试需验证不存在明显快速分支； +- 找回密码的发送入口统一返回“如账号可用，验证码将发送”。 + +## 11. 状态机 + +```text +未设置密码 + ├─ 有效 Access + password-set 验证码 ─→ 已设置密码 + └─ password-reset 验证码 ────────────→ 已设置密码 + +已设置密码 + ├─ 手机号 + 正确密码 ────────────────→ 创建登录会话 + ├─ 当前密码 + 新密码 ────────────────→ 已修改，全部会话撤销 + ├─ password-reset 验证码 ────────────→ 已重置，全部会话撤销 + └─ 再次 set ─────────────────────────→ 409 状态冲突 + +inactive / 注销完成 + └─ 任何密码操作 ─────────────────────→ 统一拒绝，不复活账号 +``` + +## 12. 事务与会话边界 + +### 12.1 密码登录 + +```text +Controller（无事务） + → 检查 Redis IP/手机号限制 + → PasswordAuthenticationService.login（REQUIRED） + → 查询用户 + → BCrypt 真/假摘要校验 + → 校验用户可用性与注销状态 + → AuthSessionService.createSession + → 写成功审计 + → 事务提交后清理手机号失败计数 +``` + +会话记录保存失败时，登录事务回滚且不得返回 Token。 + +### 12.2 设置、修改、重置 + +每个操作必须在单个 REQUIRED 事务内完成： + +```text +锁定用户行/进行带版本条件更新 + → 验证当前身份或原密码/短信验证码 + → 校验新密码策略 + → 写 password_hash（及 password_changed_at，如批准） + → revokeAllUserSessions(reason=...) + → 写脱敏审计 + → 提交 +``` + +任一步失败必须整体回滚。特别是： + +- 验证码不能已消费而密码未更新； +- 密码不能已更新而旧会话仍活动； +- 审计失败时是否回滚沿用现有 `AuditService` 的事务行为； +- 成功响应只可在事务提交后返回。 + +### 12.3 会话撤销原因 + +新增白名单原因： + +```text +PASSWORD_SET +PASSWORD_CHANGED +PASSWORD_RESET +``` + +不得把手机号、密码、验证码或操作来源拼入 `revocation_reason`。 + +## 13. 并发与幂等 + +| 场景 | 预期 | +|---|---| +| 两次并发首次设置 | 恰好一次成功，另一次 409；最终只有一个摘要 | +| 两次并发修改 | 使用数据库行锁或乐观版本保证旧密码只成功一次 | +| 两次并发重置 | 同一验证码只能消费一次；恰好一次成功 | +| 修改密码与 Refresh 并发 | 密码事务提交后的终态必须无活动旧会话 | +| 登录与密码修改并发 | 密码修改提交后不得留下使用旧密码创建的活动会话 | +| 重复成功请求 | 不得重复写审计、重复创建会话或返回同一 Token | + +仅调用现有 `revokeAllUserSessions` 不足以自动证明“登录/刷新与密码变更并发后无活动会话”。实现阶段必须设计数据库锁顺序或安全版本栅栏，并用真实 MySQL 并发测试证明终态。禁止使用 `synchronized`、JVM 锁或 `Thread.sleep` 作为正确性机制。 + +推荐实现：密码变更事务对 `users` 行加写锁；登录和 Refresh 在创建后继会话前以同一锁顺序读取可用用户。若评估发现会扩大 S02 锁竞争，必须先补独立事务设计，不得直接上线。 + +## 14. 数据模型 + +### 14.1 现有字段 + +继续使用： + +```sql +users.password_hash VARCHAR(255) NULL +``` + +`NULL` 表示尚未设置密码，不代表账号不可用；用户仍可使用验证码登录。 + +### 14.2 建议新增字段 + +建议新增： + +```sql +password_changed_at DATETIME NULL +``` + +用途： + +- 记录密码凭据最后变更时间； +- 支持安全审计和后续 Token 签发时间比较； +- 不从 `updated_at` 推断，因为资料修改也会更新该字段。 + +是否最终新增必须在实施前检查当前最新 Flyway 后再分配迁移号。不得修改 V1–V45，也不得在设计文档预占 V46。 + +不建议把登录失败计数、锁定结束时间写入 MySQL；这些临时状态放 Redis，避免热点行写放大。 + +## 15. 错误契约 + +建议复用和新增如下错误： + +| 场景 | HTTP | ErrorCode | 对外消息 | +|---|---:|---|---| +| 手机号或密码认证失败 | 401 | 复用 `CREDENTIALS_INVALID(2005)` | 手机号或密码错误 | +| 登录/操作限流 | 429 | 新增 `PASSWORD_RATE_LIMITED` | 尝试次数过多，请稍后再试 | +| 密码策略不合格 | 400 | 新增 `PASSWORD_POLICY_INVALID` | 密码不符合安全要求 | +| 已设置/未设置等认证后状态冲突 | 409 | 新增 `PASSWORD_STATE_CONFLICT` | 当前密码状态不允许此操作 | +| 当前密码错误 | 401 | `CREDENTIALS_INVALID(2005)` | 手机号或密码错误 | +| Redis 等认证依赖不可用 | 503 | 复用或新增经批准的服务不可用码 | 认证服务暂不可用 | +| DTO 格式错误 | 400 | `BAD_REQUEST(1001)` | bad request | + +要求： + +- 将 `CREDENTIALS_INVALID` 显式映射为 401；其当前无生产调用点，实施时仍需做全仓回归； +- 不改变通用 `RATE_LIMITED(9002)` 的历史 400 映射； +- ErrorCode 数字必须在实施时从当前主线分配，表中的新增名称不预定数字； +- 匿名接口不得返回 `USER_NOT_FOUND`、`USER_DISABLED` 或 `ACCOUNT_DELETED`。 + +## 16. 日志与审计 + +允许的审计 action： + +```text +PASSWORD_LOGIN_SUCCEEDED +PASSWORD_LOGIN_FAILED +PASSWORD_LOGIN_RATE_LIMITED +PASSWORD_SET +PASSWORD_CHANGED +PASSWORD_RESET +AUTH_SESSIONS_REVOKED +``` + +审计规则： + +- 登录失败若账号不可识别，`user_id` 可为 null； +- details 只包含固定分类，如 `INVALID_CREDENTIALS`、`RATE_LIMITED`； +- 手机号仅允许不可逆 `phoneRef`，不允许完整或掩码手机号进入审计 details； +- 不记录密码、摘要、验证码、JWT、Redis key、SQL 参数或异常 cause； +- 应限制失败审计写入频率，防止攻击者制造审计表写放大；聚合限流审计优先于逐次落库； +- 日志只记录固定文本、requestId 和固定错误分类。 + +## 17. SecurityConfig + +匿名放行： + +```text +POST /auth/password/login +POST /auth/password/reset +``` + +需要有效 Access Token： + +```text +POST /auth/password/set +POST /auth/password/change +``` + +规则： + +- 不能使用宽泛的 `/auth/** permitAll`； +- Refresh Token 访问 set/change 必须为 401； +- STUDENT、COMPANY、ADMIN 均可管理自己的密码； +- 角色不参与密码认证成功与否，只进入 Token 的既有 role claim； +- 不接受 `userId`、`sessionId` 或角色作为请求参数。 + +## 18. 配置 + +建议配置： + +```yaml +app: + auth: + password: + enabled: ${PASSWORD_LOGIN_ENABLED:false} + bcrypt-strength: ${PASSWORD_BCRYPT_STRENGTH:10} + min-length: ${PASSWORD_MIN_LENGTH:12} + max-length: ${PASSWORD_MAX_LENGTH:64} + max-failures: ${PASSWORD_MAX_FAILURES:5} + lockout-seconds: ${PASSWORD_LOCKOUT_SECONDS:900} + ip-window-seconds: ${PASSWORD_IP_WINDOW_SECONDS:600} + ip-max-attempts: ${PASSWORD_IP_MAX_ATTEMPTS:30} + operation-max-attempts: ${PASSWORD_OPERATION_MAX_ATTEMPTS:10} + rate-key-secret: ${PASSWORD_RATE_KEY_SECRET} +``` + +约束： + +- `enabled` 默认 false，发布前显式开启； +- `rate-key-secret` 无默认值，启用密码模块时缺失或过短必须启动失败； +- 密钥存放 Jenkins Credentials，不写入 Git、日志或命令历史； +- 阈值配置需做范围校验，不能允许 0、负数或极端值关闭保护； +- 配置错误只显示配置名，不显示值。 + +## 19. 组件建议 + +建议新增或调整： + +```text +auth/password/ + PasswordAuthenticationService + PasswordPolicy + PasswordRateLimiter + PasswordIdentifierHasher + PasswordAuthenticationProperties + PasswordAuditService（可复用既有安全审计封装时不新增） + +auth/dto/ + PasswordLoginRequest + PasswordSetRequest + PasswordChangeRequest + PasswordResetRequest + PasswordOperationResponse +``` + +职责边界： + +- Controller：接收 DTO、提取受信身份与请求上下文、包装响应； +- Service：认证编排、事务、用户状态和会话处理； +- Policy：纯密码规则，不访问数据库； +- RateLimiter：只操作 Redis，不查询用户； +- IdentifierHasher：生成 Redis/审计不可逆引用； +- `AuthSessionService`：继续作为唯一 Token 会话写入口。 + +不得把所有逻辑继续堆入现有 `AuthService`。 + +## 20. 自动化测试 + +### 20.1 密码策略 + +- 11/12/64/65 字符边界； +- Unicode code point 与 NFC； +- 首尾空格不被 trim； +- 中文、空格和符号可用； +- 手机号包含检测； +- 弱密码拒绝； +- 新旧密码相同拒绝； +- 测试失败信息不包含密码。 + +### 20.2 密码登录 + +- 已设置密码登录成功并创建一次会话； +- 不存在、未设置、错误、inactive、注销、角色异常全部 401/2005； +- 六类失败响应 JSON 完全一致； +- 不存在账号执行 dummy BCrypt 的变异门禁； +- 密码登录不自动注册； +- Access/Refresh 类型、摘要存储和现有 S02 语义不变； +- 登录事务失败时无 Token、无活动会话。 + +### 20.3 设置、修改、重置 + +- 首次设置成功；重复设置 409； +- `password-set` 与其他用途验证码不可互换； +- 修改密码需正确旧密码； +- 重置需 `password-reset` 验证码； +- 验证码成功后原子消费； +- inactive/注销账号不可设置或重置； +- 成功后全部旧 Access/Refresh 均失效； +- 不自动签发新 Token； +- 数据库只保存 BCrypt 摘要。 + +### 20.4 限流与故障 + +- 第 1–4 次失败未锁定，第 5 次锁定； +- 锁定 TTL 精确且不被后续请求无限延长； +- 成功登录清除手机号失败计数； +- IP 限流跨多个手机号生效； +- 手机号锁定不阻止验证码登录； +- Redis key 无完整手机号/IP； +- Redis 不可用时无登录、无修改、无会话； +- Lua/原子计数并发下不丢增量。 + +### 20.5 并发 + +- 并发 set 恰好一个成功； +- 并发 reset 同一验证码恰好一个成功； +- password change 与 refresh 竞争终态无旧活动会话； +- password change 与 password login 竞争终态符合锁协议； +- 不允许 catch-all 吞掉异常，不使用 sleep 证明正确性。 + +### 20.6 脱敏和副作用 + +- 真实 Logback 捕获 root、应用、Hibernate、JDBC logger； +- 扫描 message、throwable、cause 和 SQL 绑定参数； +- 响应、日志、审计、通知、消息、RabbitMQ 无密码/摘要/验证码/Token/完整手机号； +- 认证失败不修改业务表； +- 密码操作不发送通知或 RabbitMQ 消息，除非另行设计。 + +## 21. 真实 MySQL/Redis/JAR 黑盒验收 + +必须使用最新 JAR、真实 MySQL 与 Redis，至少覆盖： + +1. Flyway 执行与 Hibernate validate； +2. 验证码旧用户设置密码并重新登录； +3. 密码登录成功及 Access/Refresh 类型矩阵； +4. 不存在、无密码、错误、inactive、注销的统一响应； +5. 5 次失败与 15 分钟锁定； +6. 单 IP 跨手机号限流； +7. Redis 停止后失败关闭，恢复后正常； +8. 设置、修改、重置后三类旧会话全部失效； +9. 并发设置、重置、登录/修改、Refresh/修改； +10. 数据库搜索密码原文和 Token 原文命中 0； +11. 日志、审计和响应敏感扫描命中 0，扫描器需注入探针证明有效； +12. 关键业务表逐字段副作用快照； +13. RabbitMQ ready/unacked 保持 0； +14. 静态与运行时 OpenAPI 路径和 operation 集合一致； +15. 全量 `mvn clean verify` 为 Failures=0、Errors=0、Skipped=0。 + +## 22. Apifox 与前端联调 + +前端登录页展示： + +- 验证码登录； +- 密码登录； +- 忘记密码； +- 已验证码登录用户的“设置密码”； +- 已设置密码用户的“修改密码”。 + +前端不得根据不同错误文案推断账号状态。密码登录失败统一显示“手机号或密码错误”；限流显示通用等待提示。设置、修改或重置成功后： + +1. 清除本地 Access/Refresh Token； +2. 跳转登录页； +3. 提示“密码已更新，请重新登录”。 + +Apifox 环境继续使用统一 `baseUrl`，密码登录成功后复用现有后置脚本保存 Access/Refresh Token。 + +## 23. 发布和兼容 + +建议顺序： + +1. 完成设计评审； +2. 从合并时主线确定实际 Flyway 编号； +3. 先部署数据库兼容迁移； +4. 部署后端但保持 `PASSWORD_LOGIN_ENABLED=false`； +5. 验证验证码登录和旧客户端不受影响； +6. 配置 Jenkins Credentials 与限流参数； +7. 小范围启用密码入口； +8. 完成 Apifox 与前端联调； +9. 观察登录成功率、限流率、Redis 和 BCrypt 延迟； +10. 再全量开放。 + +兼容要求： + +- 旧用户无需迁移密码； +- `password_hash IS NULL` 的用户继续正常验证码登录； +- 旧客户端无需感知新接口； +- 不修改 `/auth/login` 的请求和响应； +- 不用默认密码批量填充历史账号。 + +## 24. 回滚 + +发生问题时： + +1. 设置 `PASSWORD_LOGIN_ENABLED=false`； +2. 保留数据库中的 BCrypt 摘要，不清空用户密码； +3. 验证码登录继续工作； +4. 停止前端展示密码入口； +5. 不回滚已成功执行的 Flyway； +6. 根据固定审计事件调查，不导出密码或摘要； +7. 修复后重新执行全量与黑盒验收再开启。 + +关闭密码入口不能恢复已撤销的旧会话；用户可通过验证码重新登录。 + +## 25. 预期修改范围 + +实施阶段预计涉及： + +- `auth/` 与 `auth/password/` 生产代码； +- `controller/AuthController.java`； +- `config/SecurityConfig.java`； +- `common/exception/ErrorCode.java` 与 `ErrorHttpStatusRegistry.java`； +- `application.yml` 和测试 profile； +- 一条新的 Flyway（仅在批准 `password_changed_at` 后）； +- OpenAPI、认证文档和前端联调文档； +- 密码专项测试、认证回归和真实 MySQL/Redis 验收脚本。 + +禁止顺带修改： + +- S02 Token 格式、密钥、有效期和轮换策略； +- 用户角色与资源归属； +- 评分、排名、推荐、邀约、申诉； +- 简历上传、隐私和查重； +- 消息发送与撤回； +- 已执行的 V1–V45； +- 本机号码一键登录或第三方登录。 + +## 26. 实施门禁确认 + +负责人于 2026-09-20 确认以下三项门禁： + +1. **批准**新增 `users.password_changed_at`； +2. **接受**密码登录及密码敏感操作在 Redis 不可用时失败关闭； +3. **批准**新增密码专用 ErrorCode，并把 `CREDENTIALS_INVALID(2005)` 显式映射为 HTTP 401。 + +本文设计据此进入“已确认、可实施”状态。实现仍须从届时实际主线分配 Flyway 版本号和新增错误码数字，不得修改既有迁移或占用已被其他并行模块使用的编号。 + +其余产品与安全决策已在本文固定。任何偏离必须先更新设计并记录原因，不能在实现过程中隐式改变。 diff --git a/docs/phone-password-authentication-implementation-report.md b/docs/phone-password-authentication-implementation-report.md new file mode 100644 index 0000000..9b1f676 --- /dev/null +++ b/docs/phone-password-authentication-implementation-report.md @@ -0,0 +1,93 @@ +# 手机号+密码登录实施记录 + +## 1. 范围 + +本批只实现手机号账号的密码认证闭环：登录、首次设置密码、已登录用户修改密码、短信验证后重置密码。未实现本机号码一键登录，也未改变既有短信登录、Access/Refresh Token 格式、评分、推荐或其他业务接口语义。 + +## 2. 账号与密码策略 + +- 账号字段固定为 `users.phone`，要求 11 位数字；不引入用户名或邮箱登录。 +- 密码使用 BCrypt 存储，成本沿用项目 `PasswordEncoder` 配置（当前为 10）。数据库不保存明文密码。 +- 新密码长度为 12–64 个 Unicode code point；先做 NFC 规范化，不 trim、不自动小写。 +- 拒绝常见弱密码、包含完整手机号的密码，以及与当前密码相同的密码。 +- 不设置默认密码，不因密码登录自动创建账号。 + +## 3. 接口 + +| 方法 | 路径 | 身份 | 作用 | +| --- | --- | --- | --- | +| POST | `/auth/password/login` | 匿名 | 手机号+密码登录并签发既有 Access/Refresh Token | +| POST | `/auth/password/set` | Access Token | 首次设置密码，需要 `password-set` 短信验证码 | +| POST | `/auth/password/change` | Access Token | 校验当前密码后修改密码 | +| POST | `/auth/password/reset` | 匿名 | `password-reset` 短信验证码后重置密码 | + +成功响应只返回现有认证所需结果或固定操作结果；错误响应不回显手机号、密码、验证码、Token、异常类或 SQL。 + +## 4. 会话撤销 + +设置、修改、重置密码成功后调用现有 `AuthSessionService.revokeAllUserSessions`，撤销该用户全部会话，并写入固定动作审计。密码登录成功创建新的会话。密码修改时间写入 `users.password_changed_at`，为后续令牌失效策略保留服务端时间基准。 + +## 5. 防枚举与限流 + +- 不存在手机号、停用用户、删除完成用户、错误密码统一返回 `CREDENTIALS_INVALID`（HTTP 401），不区分账号是否存在。 +- 登录使用固定 dummy BCrypt hash 对未知手机号执行同类密码计算，避免明显时间差。 +- Redis 记录仅保存 HMAC-SHA256 引用，不保存原始手机号或 IP。 +- 同手机号连续 5 次失败锁定 15 分钟；同 IP 10 分钟最多 30 次尝试。 +- Redis 不可用或密钥配置不满足要求时拒绝认证，不伪造登录成功。 + +## 6. 配置 + +```yaml +app: + auth: + password: + enabled: ${PASSWORD_LOGIN_ENABLED:false} + rate-key-secret: ${PASSWORD_RATE_KEY_SECRET:} +``` + +密码功能默认关闭；启用时必须提供至少 32 个字符的 `PASSWORD_RATE_KEY_SECRET`。生产环境不得把该密钥写入仓库或日志。 + +## 7. 数据库 + +新增且仅新增 `V46__password_authentication.sql`，为 `users` 增加可空 `password_changed_at DATETIME`。未修改 V1–V45，未新增密码明文字段、Token 明文字段或其他表。 + +## 8. 错误映射 + +- `CREDENTIALS_INVALID`（2005）→ 401。 +- `PASSWORD_RATE_LIMITED`（2006）→ 429。 +- `PASSWORD_STATE_CONFLICT`（2007）→ 409。 +- `PASSWORD_POLICY_INVALID`（2008）→ 400。 +- Redis 故障复用 `SERVICE_UNAVAILABLE`，响应为固定安全文案。 + +## 9. 并发与事务 + +设置、修改、重置使用用户行悲观锁；密码更新、密码变更时间、会话撤销、审计在同一事务内完成。密码登录创建会话和 Refresh Token 轮换也先取得同一 `users` 行悲观锁，锁顺序统一为 `users -> auth_tokens`，从而避免改密提交后并发请求再次留下旧认证会话。 + +## 10. 测试 + +- `PasswordPolicyTest`：长度、Unicode/NFC、常见密码、手机号包含、复用密码。 +- `PasswordRateLimiterTest`：HMAC 不泄露原值、失败计数/锁定、Redis 故障 fail-closed、关闭开关行为。 +- `PasswordAuthenticationIntegrationTest`：成功登录、错误凭据统一响应、修改密码撤销会话、短信重置后登录、精确夹具清理。 +- 更新错误码映射契约测试与 OpenAPI 既有 DTO 安全断言，使断言只检查目标 DTO/响应，不因新增密码 schema 误报。 + +阻断整改后新增真实 Redis 原子计数/TTL 测试、真实 MySQL 登录/刷新与改密竞争测试，以及默认关闭与 Redis 故障失败关闭测试。密码专项与认证关联回归 **149/149**；最终 `mvn clean verify` **2825/2825，Failures=0，Errors=0，Skipped=0**。`python docs/verify_openapi.py` 通过，OpenAPI 为 **180 paths / 218 operations**。V46 已在全量 MySQL/Testcontainers 测试上下文中执行并通过 schema 校验。 + +## 11. OpenAPI + +静态契约由 176 paths / 214 operations 扩展为 **180 paths / 218 operations**，新增四个密码接口及对应请求/响应 schema。密码 DTO 不暴露 `userId`、`sessionId`、`role`、`passwordHash`、`token`、`secret` 等敏感字段。 + +## 12. 阻断整改闭环 + +- 所有设置、修改、重置操作统一执行功能开关、Redis 可用性检查及每手机号 HMAC 引用 10 分钟最多 10 次的操作限流。 +- 登录 IP 计数、密码失败计数与锁定全部改为 Redis Lua 原子脚本；计数与 TTL 在同一次执行中完成，并在 TTL 缺失时修复。锁使用 `SET ... NX`，并发迟到失败不会延长既有锁定期。 +- 登录、会话创建、Refresh 轮换和密码变更共用 `users` 行悲观锁；真实 MySQL 竞争测试连续验证登录/刷新与改密终态，不留下旧认证活动会话。 +- 密码配置统一由 `PasswordAuthenticationProperties` 承载，并对密钥、阈值和时间窗口进行启动期边界校验。 + +## 13. 已知边界 + +- 验证码现有存储与消费语义保持不变，本批只保证密码认证链路不打印验证码；验证码摘要化另行立项。 +- `password_changed_at` 已落库，但旧 Token 是否按该时间主动失效需在后续 Token 策略批次中单独验收。 + +## 14. 变更边界 + +未修改评分、排名、推荐、邀约、申诉、消息撤回、简历上传、Flyway 旧迁移、既有 Token 格式或短信登录接口。提交前仍需完成全量测试、敏感扫描、暂存和审查。 diff --git a/docs/phone-password-authentication-independent-verification-report.md b/docs/phone-password-authentication-independent-verification-report.md new file mode 100644 index 0000000..7216b6b --- /dev/null +++ b/docs/phone-password-authentication-independent-verification-report.md @@ -0,0 +1,101 @@ +# 手机号密码认证独立代码复验报告 + +日期：2026-09-20 +结论：**FAIL，不进入暂存/提交检查点** + +## 1. 复验范围 + +复核了密码认证生产代码、V46、SecurityConfig、错误映射、DTO、配置和现有测试；未修改生产代码、未暂存、未提交、未推送。 + +## 2. 已通过项目 + +- 账号字段为 `users.phone`，无用户名/邮箱密码登录入口。 +- BCrypt 摘要存储，未发现明文密码、Token 或 Redis 原始手机号/IP 写入日志、响应、审计的代码路径。 +- 登录对未知手机号使用 dummy BCrypt 摘要，错误凭据统一使用 `CREDENTIALS_INVALID(2005)`。 +- 设置、修改、重置使用 `findByIdForUpdate`，成功后调用既有全量会话撤销。 +- V46 是唯一新增迁移，仅增加可空 `users.password_changed_at`；V1–V45 未修改。 +- 密码接口已进入 SecurityConfig，OpenAPI 为 180 paths / 218 operations。 +- 定向测试：356/356，Failures=0、Errors=0、Skipped=0。 +- 全量 `mvn clean verify`：2818/2818，Failures=0、Errors=0、Skipped=0。 +- OpenAPI 校验：`All checks passed!`。 + +## 3. 阻断项 + +### F1：设置/修改密码绕过 Redis 失败关闭和功能开关 + +`PasswordAuthenticationService.setPassword`（约 69 行）与 `changePassword`（约 85 行）没有调用 `rateLimiter.checkAllowed` 或等价的启用检查；只有 `login` 和 `resetPassword` 调用了它。 + +因此在 `PASSWORD_LOGIN_ENABLED=false` 或 Redis 不可用时，已认证用户仍可能执行设置/修改密码，违反设计 §9.4“密码敏感操作失败关闭”，也使“默认关闭”没有覆盖全部密码操作。 + +### F2：没有实现密码敏感操作的独立 10 分钟限流 + +设计要求设置/修改/重置每手机号引用 10 分钟最多 10 次。当前实现只有登录用的 IP 30/10 分钟和手机号失败锁定；`setPassword`、`changePassword`、`resetPassword` 没有操作计数、失败计数或独立阈值。 + +### F3：限流计数不是原子实现 + +`PasswordRateLimiter` 使用 `increment` 后再单独 `expire`（约 52–55、70–73 行），没有 Lua 脚本或等价原子操作。并发下可能出现计数与 TTL 不一致，且存在永久 key 风险，违反设计 §9.3。 + +### F4：密码变更与登录/刷新没有共用锁或版本栅栏 + +- 密码登录通过 `userRepository.findByPhone` 读取用户后直接调用 `createSession`。 +- `AuthSessionService.createSession` 未对 users 行加锁。 +- Refresh 路径的 `requireUsableUser` 使用普通 `findById`。 +- `password_changed_at` 只写入，未在登录、刷新或会话校验中读取。 + +因此“登录/刷新与改密并发”可能出现改密撤销之后又创建旧认证会话；现有测试没有证明设计要求的并发终态。 + +## 4. 非阻断观察 + +- 初次复验时，`bcrypt-strength`、阈值等设计配置仍为硬编码常量；本轮已将限流阈值与时间窗口收束到带启动期边界校验的配置属性。BCrypt 成本仍沿用项目统一 `PasswordEncoder` 配置，不在本轮另设第二套参数源。 +- 验证码明文存储沿用既有语义，属于设计中明确保留的后续事项。 + +## 5. 下一步整改要求 + +1. 为所有密码敏感操作统一增加启用检查、Redis fail-closed 和独立操作限流。 +2. 用 Lua 或 Redis 原子脚本完成“计数 + 首次 TTL”一体化；补并发增量测试。 +3. 为登录、刷新、改密建立统一 users 行锁/密码版本栅栏，补真实并发测试，证明改密提交后不会留下旧会话。 +4. 补齐 Redis 故障、开关关闭、10 分钟操作限流、并发登录/刷新/改密测试，再重新执行全量和真实 MySQL/Redis 验收。 + +## 6. Git 边界 + +- 暂存区为空；未提交、未推送。 +- 本报告为独立复验记录，不包含生产修复。 +- 历史未跟踪验收产物保持不动。 + +## 7. 阻断整改复验（2026-09-20） + +初次 FAIL 及 F1–F4 证据保留不变。针对四项阻断完成定向整改后重新复验，结果如下： + +### F1：PASS——所有密码操作统一失败关闭 + +- `setPassword`、`changePassword`、`resetPassword` 均调用 `checkOperationAllowed`。 +- 功能默认关闭时，直接调用修改密码也返回固定 `SERVICE_UNAVAILABLE`；Redis 不可用时同样安全失败，密码摘要和既有会话均不变化。 +- 配置改由 `PasswordAuthenticationProperties` 统一承载并在启动期校验。 + +### F2：PASS——独立操作限流已实现 + +- 设置、修改、重置共用按手机号 HMAC 引用计数的操作限流，默认 10 分钟最多 10 次，第 11 次返回 429。 +- Redis key、异常与日志均不包含原始手机号、密码或 Token。 + +### F3：PASS——Redis 原子计数与锁定已实现 + +- 登录 IP 计数通过 Lua 在一次 Redis 执行中完成 `INCR` 与 TTL 设置/修复。 +- 密码失败计数和锁定通过另一 Lua 脚本原子完成；锁使用 `NX`，不会被并发迟到请求反复延长。 +- 真实 Redis 7 Testcontainers 测试验证 20 路并发累计精确为 20，计数键和锁键均有 TTL，且达到阈值后登录被拒绝。 + +### F4：PASS——登录、刷新与改密共用数据库栅栏 + +- 密码登录按手机号悲观锁定 `users` 行；`createSession` 再按 id 锁定用户。 +- Refresh 先锁定 `users` 行，再查询和消费 `auth_tokens`；密码修改使用相同的 `users -> auth_tokens` 锁顺序。 +- 真实 MySQL 8.4 Testcontainers 竞争测试各执行 10 轮：登录与改密、刷新与改密的最终状态均不留下旧认证活动会话，最终密码为新摘要。 + +## 8. 最终验证 + +- 密码专项及认证关联回归：**149/149**，Failures=0、Errors=0、Skipped=0。 +- 最终 `mvn clean verify`：**2825/2825**，Failures=0、Errors=0、Skipped=0；真实 MySQL 8.4 与 Redis 7 Testcontainers 均实际执行。 +- OpenAPI：**180 paths / 218 operations**，`All checks passed!`。 +- `git diff --check` 无错误；暂存区为空；未提交、未推送；V1–V45 未修改，V46 仍为唯一新增迁移。 + +## 9. 最终结论 + +> **PASS——F1–F4 四个阻断均已修复并通过定向、并发、真实 Redis/MySQL 与全量回归，可以进入独立复验后的精确暂存检查点。** diff --git a/docs/privacy-settings-api.md b/docs/privacy-settings-api.md index 78a2480..43b62a9 100644 --- a/docs/privacy-settings-api.md +++ b/docs/privacy-settings-api.md @@ -103,4 +103,31 @@ ## 6. 审计 -更新隐私设置会写入审计日志 `UPDATE_PRIVACY_SETTINGS`。审计中**不得**写入 `phone / email / password / jwt / resumeUrl` 等敏感值。 \ No newline at end of file +更新隐私设置会写入审计日志 `UPDATE_PRIVACY_SETTINGS`。审计中**不得**写入 `phone / email / password / jwt / resumeUrl` 等敏感值。 +## S03-B：`resumeVisibility` 的企业侧执行边界 + +此前 `resumeVisibility` 只有存储与读写接口，**没有任何企业侧代码路径读取它**，等同于空转开关。 +S03 起该设置在企业读取简历文件的唯一入口 `GET /company/candidates/{applicationId}/resume` +上真正生效，判定全部由失败关闭的 `CompanyResumeAccessPolicy` 完成。 + +### 可见性决策表 + +| 设置 | 企业条件 | 投递条件 | 结果 | +|---|---|---|---| +| 无设置记录 / `null` | 任意 | 任意 | 403（按 PRIVATE 处理） | +| `PRIVATE` | 任意 | 包括已投递、面试、录用 | 403 | +| `APPLIED_COMPANIES` | 岗位属于当前企业 | `SUBMITTED`/`VIEWED`/`INTERVIEW`/`HIRED` | 200 | +| `APPLIED_COMPANIES` | 岗位属于当前企业 | `WITHDRAWN`/`REJECTED` | 403 | +| `APPLIED_COMPANIES` | 其他企业 | 任意 | 403 | +| `VERIFIED_COMPANIES` | 当前企业 `verified=true` 且拥有该投递岗位 | 任意合法投递状态 | 200 | +| `VERIFIED_COMPANIES` | 未认证企业或其他企业 | 任意 | 403 | + +### 重要变更 + +- **`APPLIED_COMPANIES` 与 `VERIFIED_COMPANIES` 现在都强制校验「投递所属岗位属于当前企业」。** + 此前 `canCompanyViewResume` 不校验公司归属：`APPLIED_COMPANIES` 完全不使用 `companyId`， + `VERIFIED_COMPANIES` 只校验企业 `verified` —— 任何已认证企业都可凭任意 `applicationId` 查看简历。 +- `VERIFIED_COMPANIES` **不是**「知道学生 ID 即可查看」：仍需合法的候选业务上下文。 +- 隐私拒绝统一返回 `FORBIDDEN(2002)`；跨企业同样 403，不通过差异响应泄露归属。 +- `PrivacySettingsService.canCompanyViewResume` 保留为委托方法，判定逻辑已收束到策略类， + 不再保留可被误用的宽松实现。 diff --git a/docs/q01-job-search-mysql-explain-evidence.md b/docs/q01-job-search-mysql-explain-evidence.md new file mode 100644 index 0000000..a2fe884 --- /dev/null +++ b/docs/q01-job-search-mysql-explain-evidence.md @@ -0,0 +1,303 @@ +# Q01 MySQL 执行计划证据（由 JobSearchQueryExplainMySqlIntegrationTest 生成） + +- 数据库：`mysql:8.4` Testcontainers 独立容器，正式 Flyway 迁移，`ddl-auto=validate` +- EXPLAIN 形式：`EXPLAIN FORMAT=JSON`，与 Criteria 路径绑定同一组参数 +- 夹具规模：每个城市分别 1 / 20 / 50 条 PUBLISHED 岗位（刻意做小，用于验证语义而非压测） +- Q01 不新增索引；执行计划问题记录给 R01 + +## 1. 组合过滤 + latest 分页 + +Hibernate 实际生成并执行的 SQL（占位符形式）： + +```sql +select j1_0.id,j1_0.city,j1_0.company_id,j1_0.created_at,j1_0.description,j1_0.employment_type,j1_0.published_at,j1_0.requirements,j1_0.salary_max,j1_0.salary_min,j1_0.status,j1_0.title,j1_0.updated_at from jobs j1_0 where j1_0.status=? and (lower(j1_0.title) like ? escape '' or lower(j1_0.description) like ? escape '' or lower(j1_0.requirements) like ? escape '') and lower(j1_0.city)=? and lower(j1_0.employment_type)=? and j1_0.salary_max>=? and j1_0.salary_min<=? and j1_0.company_id=? order by j1_0.created_at desc,j1_0.id desc limit ?,? + +select count(j1_0.id) from jobs j1_0 where j1_0.status=? and (lower(j1_0.title) like ? escape '' or lower(j1_0.description) like ? escape '' or lower(j1_0.requirements) like ? escape '') and lower(j1_0.city)=? and lower(j1_0.employment_type)=? and j1_0.salary_max>=? and j1_0.salary_min<=? and j1_0.company_id=? +``` + +等价 SQL（绑定参数 [PUBLISHED, %q01e75001岗位%, %q01e75001岗位%, %q01e75001岗位%, Q01E75001CITY20, FULL_TIME, 5000, 30000, 1, 20, 0]）： + +```sql +SELECT j.id FROM jobs j +WHERE j.status = ? AND (lower(j.title) LIKE ? OR lower(j.description) LIKE ? OR lower(j.requirements) LIKE ?) + AND lower(j.city) = ? AND lower(j.employment_type) = ? AND j.salary_max >= ? AND j.salary_min <= ? AND j.company_id = ? +ORDER BY j.created_at DESC, j.id DESC +LIMIT ? OFFSET ? +``` + +计划摘要： + +``` +query_cost = 1.35 +using_filesort = true +using_temporary_table = false +- 表 query_block/ORDER BY: table_name="j", access_type="ALL", possible_keys=["idx_jobs_company_status","idx_jobs_status_created","idx_jobs_city_status","idx_jobs_status_employment_type","idx_jobs_status_salary_max"], rows_examined_per_scan=1, rows_produced_per_join=1, filtered="100.00" +``` + +
EXPLAIN FORMAT=JSON 原文 + +```json +{ + "query_block": { + "select_id": 1, + "cost_info": { + "query_cost": "1.35" + }, + "ordering_operation": { + "using_filesort": true, + "cost_info": { + "sort_cost": "1.00" + }, + "table": { + "table_name": "j", + "access_type": "ALL", + "possible_keys": [ + "idx_jobs_company_status", + "idx_jobs_status_created", + "idx_jobs_city_status", + "idx_jobs_status_employment_type", + "idx_jobs_status_salary_max" + ], + "rows_examined_per_scan": 1, + "rows_produced_per_join": 1, + "filtered": "100.00", + "cost_info": { + "read_cost": "0.25", + "eval_cost": "0.10", + "prefix_cost": "0.35", + "data_read_per_join": "1K" + }, + "used_columns": [ + "id", + "company_id", + "title", + "description", + "requirements", + "city", + "employment_type", + "salary_min", + "salary_max", + "status", + "created_at" + ], + "attached_condition": "((`mydreamjob_q01`.`j`.`company_id` = 1) and (`mydreamjob_q01`.`j`.`status` = 'PUBLISHED') and ((lower(`mydreamjob_q01`.`j`.`title`) like '%q01e75001岗位%') or (lower(`mydreamjob_q01`.`j`.`description`) like '%q01e75001岗位%') or (lower(`mydreamjob_q01`.`j`.`requirements`) like '%q01e75001岗位%')) and (lower(`mydreamjob_q01`.`j`.`city`) = 'q01e75001city20') and (lower(`mydreamjob_q01`.`j`.`employment_type`) = 'full_time') and (`mydreamjob_q01`.`j`.`salary_max` >= 5000) and (`mydreamjob_q01`.`j`.`salary_min` <= 30000))" + } + } + } +} +``` + +
+ +## 2. latest 分页 + +等价 SQL（绑定参数 [PUBLISHED, Q01E75001CITY20, 20, 0]）： + +```sql +SELECT j.id FROM jobs j +WHERE j.status = ? AND lower(j.city) = ? +ORDER BY j.created_at DESC, j.id DESC +LIMIT ? OFFSET ? +``` + +计划摘要： + +``` +query_cost = 1.35 +using_filesort = true +using_temporary_table = false +- 表 query_block/ORDER BY: table_name="j", access_type="ALL", possible_keys=["idx_jobs_status_created","idx_jobs_city_status","idx_jobs_status_employment_type","idx_jobs_status_salary_max"], rows_examined_per_scan=1, rows_produced_per_join=1, filtered="100.00" +``` + +
EXPLAIN FORMAT=JSON 原文 + +```json +{ + "query_block": { + "select_id": 1, + "cost_info": { + "query_cost": "1.35" + }, + "ordering_operation": { + "using_filesort": true, + "cost_info": { + "sort_cost": "1.00" + }, + "table": { + "table_name": "j", + "access_type": "ALL", + "possible_keys": [ + "idx_jobs_status_created", + "idx_jobs_city_status", + "idx_jobs_status_employment_type", + "idx_jobs_status_salary_max" + ], + "rows_examined_per_scan": 1, + "rows_produced_per_join": 1, + "filtered": "100.00", + "cost_info": { + "read_cost": "0.25", + "eval_cost": "0.10", + "prefix_cost": "0.35", + "data_read_per_join": "1K" + }, + "used_columns": [ + "id", + "city", + "status", + "created_at" + ], + "attached_condition": "((`mydreamjob_q01`.`j`.`status` = 'PUBLISHED') and (lower(`mydreamjob_q01`.`j`.`city`) = 'q01e75001city20'))" + } + } + } +} +``` + +
+ +## 3. salary 排序（salaryMax DESC NULLS LAST） + +等价 SQL（绑定参数 [PUBLISHED, Q01E75001CITY20, 20, 0]）： + +```sql +SELECT j.id FROM jobs j +WHERE j.status = ? AND lower(j.city) = ? +ORDER BY CASE WHEN j.salary_max IS NULL THEN 1 ELSE 0 END ASC, j.salary_max DESC, j.id DESC +LIMIT ? OFFSET ? +``` + +计划摘要： + +``` +query_cost = 1.35 +using_filesort = true +using_temporary_table = false +- 表 query_block/ORDER BY: table_name="j", access_type="ALL", possible_keys=["idx_jobs_status_created","idx_jobs_city_status","idx_jobs_status_employment_type","idx_jobs_status_salary_max"], rows_examined_per_scan=1, rows_produced_per_join=1, filtered="100.00" +``` + +
EXPLAIN FORMAT=JSON 原文 + +```json +{ + "query_block": { + "select_id": 1, + "cost_info": { + "query_cost": "1.35" + }, + "ordering_operation": { + "using_filesort": true, + "cost_info": { + "sort_cost": "1.00" + }, + "table": { + "table_name": "j", + "access_type": "ALL", + "possible_keys": [ + "idx_jobs_status_created", + "idx_jobs_city_status", + "idx_jobs_status_employment_type", + "idx_jobs_status_salary_max" + ], + "rows_examined_per_scan": 1, + "rows_produced_per_join": 1, + "filtered": "100.00", + "cost_info": { + "read_cost": "0.25", + "eval_cost": "0.10", + "prefix_cost": "0.35", + "data_read_per_join": "1K" + }, + "used_columns": [ + "id", + "city", + "salary_max", + "status" + ], + "attached_condition": "((`mydreamjob_q01`.`j`.`status` = 'PUBLISHED') and (lower(`mydreamjob_q01`.`j`.`city`) = 'q01e75001city20'))" + } + } + } +} +``` + +
+ +## 4. count 查询 + +等价 SQL（绑定参数 [PUBLISHED, %q01e75001岗位%, %q01e75001岗位%, %q01e75001岗位%, Q01E75001CITY20, FULL_TIME, 5000, 30000, 1]）： + +```sql +SELECT count(j.id) FROM jobs j +WHERE j.status = ? AND (lower(j.title) LIKE ? OR lower(j.description) LIKE ? OR lower(j.requirements) LIKE ?) + AND lower(j.city) = ? AND lower(j.employment_type) = ? AND j.salary_max >= ? AND j.salary_min <= ? AND j.company_id = ? +``` + +计划摘要： + +``` +query_cost = 0.35 +using_filesort = false +using_temporary_table = false +- 表 query_block: table_name="j", access_type="ALL", possible_keys=["idx_jobs_company_status","idx_jobs_status_created","idx_jobs_city_status","idx_jobs_status_employment_type","idx_jobs_status_salary_max"], rows_examined_per_scan=1, rows_produced_per_join=1, filtered="100.00" +``` + +
EXPLAIN FORMAT=JSON 原文 + +```json +{ + "query_block": { + "select_id": 1, + "cost_info": { + "query_cost": "0.35" + }, + "table": { + "table_name": "j", + "access_type": "ALL", + "possible_keys": [ + "idx_jobs_company_status", + "idx_jobs_status_created", + "idx_jobs_city_status", + "idx_jobs_status_employment_type", + "idx_jobs_status_salary_max" + ], + "rows_examined_per_scan": 1, + "rows_produced_per_join": 1, + "filtered": "100.00", + "cost_info": { + "read_cost": "0.25", + "eval_cost": "0.10", + "prefix_cost": "0.35", + "data_read_per_join": "1K" + }, + "used_columns": [ + "id", + "company_id", + "title", + "description", + "requirements", + "city", + "employment_type", + "salary_min", + "salary_max", + "status" + ], + "attached_condition": "((`mydreamjob_q01`.`j`.`company_id` = 1) and (`mydreamjob_q01`.`j`.`status` = 'PUBLISHED') and ((lower(`mydreamjob_q01`.`j`.`title`) like '%q01e75001岗位%') or (lower(`mydreamjob_q01`.`j`.`description`) like '%q01e75001岗位%') or (lower(`mydreamjob_q01`.`j`.`requirements`) like '%q01e75001岗位%')) and (lower(`mydreamjob_q01`.`j`.`city`) = 'q01e75001city20') and (lower(`mydreamjob_q01`.`j`.`employment_type`) = 'full_time') and (`mydreamjob_q01`.`j`.`salary_max` >= 5000) and (`mydreamjob_q01`.`j`.`salary_min` <= 30000))" + } + } +} +``` + +
+ +## 5. 结果规模 1 / 20 / 50 下的 SQL 语句条数 + +Spring Data 对首页有优化：首页返回行数小于 `pageSize` 时不再发 count 查询， +因此结果数 < pageSize 时为 1 条（仅数据查询），否则为 2 条（count + 数据查询）。 +两种情况下语句条数都**不随结果规模增长**，即不存在 N+1。 + +| 匹配结果数 | 返回行数 | totalElements | Repository SQL数 | 完整Service SQL数 | +|---|---|---|---|---| +| 1 | 1 | 1 | 1 | 2 | +| 20 | 20 | 20 | 2 | 3 | +| 50 | 20 | 50 | 2 | 3 | diff --git a/docs/q01-job-search-real-query-design.md b/docs/q01-job-search-real-query-design.md new file mode 100644 index 0000000..ea56eb2 --- /dev/null +++ b/docs/q01-job-search-real-query-design.md @@ -0,0 +1,190 @@ +# Q01 岗位搜索真实查询覆盖设计 + +## 1. 状态 + +设计已确认，待实施、专项测试、真实 MySQL 复验与独立验收。 + +## 2. 背景与问题 + +`JobSearchSpecification` 承担公开岗位搜索的核心过滤规则，但当前 `JobSearchServiceTest` 将 +`JobRepository.findAll(Specification, Pageable)` Mock 掉后直接返回预设数据。这些测试可以证明 +参数校验、分页对象和 DTO 组装，却不能证明 Criteria 谓词、SQL 过滤、排序和分页真的正确。 + +Q01 的目标是补齐真实数据库证据，不以测试数量替代查询行为覆盖，也不改变现有公网接口和业务语义。 + +## 3. 范围 + +### 3.1 必须覆盖 + +- `JobSearchSpecification.searchJobs(...)` 的真实 Repository 查询； +- `JobService.searchJobs(...)` 的 latest、relevance、salary 排序和分页； +- PUBLISHED 强制过滤； +- keyword 对 title、description、requirements 的匹配； +- city、employmentType、companyId； +- salaryMin、salaryMax 的区间重叠语义； +- H2 快速测试与 MySQL 8 行为一致性； +- 查询参数化和特殊字符边界； +- 真实 SQL/EXPLAIN 证据及数据副作用检查。 + +### 3.2 明确不做 + +- 不改变 `/jobs/search` 请求或响应； +- 不新增、删除或重命名公网接口； +- 不修改岗位状态机、岗位归属或角色权限； +- 不把 relevance 改造成新的全文检索算法；当前 relevance 与 latest 等价，本轮锁定该语义； +- 不接入 Elasticsearch、搜索引擎或缓存； +- 不新增 Flyway、表或索引； +- 不改 Candidate Scoring、推荐、排名、邀约、Offer、申诉、消息、简历和认证； +- 不删除现有 Mock 测试。现有测试继续承担 Service 编排与参数校验职责； +- 不进入 R01 性能和结构重构。 + +## 4. 当前查询契约 + +| 参数 | 既有语义 | +|---|---| +| status | 无论调用方传什么条件，只返回 `PUBLISHED` | +| keyword | trim 后忽略大小写，匹配 title、description、requirements 任一字段 | +| city | trim 后忽略大小写精确匹配；显式归一化以保证 H2/MySQL 一致 | +| employmentType | trim 后忽略大小写精确匹配；不做前缀匹配 | +| salaryMin | 岗位 `salaryMax >= salaryMin` | +| salaryMax | 岗位 `salaryMin <= salaryMax` | +| companyId | 精确匹配 | +| sort=latest/null | `createdAt DESC, id DESC` | +| sort=relevance | 当前与 latest 相同，不改变 | +| sort=salary | `salaryMax` 非空优先、降序；相同值按 `id DESC`；NULL 最后 | +| page | 从 0 开始，不得为负数 | +| size | 1–50 | + +薪资过滤是区间重叠，不是“岗位上下限都完全落在用户区间内”。边界相等必须命中。 + +## 5. 测试分层 + +### 5.1 H2 Repository 快速层 + +新增 `JobSearchSpecificationIntegrationTest`： + +- 使用 Spring Data JPA、真实 `JobRepository` 和真实 H2； +- 激活 `integration-test`，由真实 Flyway 建表； +- 不 Mock Repository、EntityManager、Specification、CriteriaBuilder 或事务； +- 每个用例创建最小隔离夹具，按精确主键清理； +- 直接执行 `jobRepository.findAll(spec, pageable)`； +- 断言返回 ID 集合与顺序，不能只断言数量。 + +至少覆盖： + +1. title 关键词； +2. description 关键词； +3. requirements 关键词； +4. 关键词忽略大小写； +5. null、空字符串、纯空白关键词； +6. keyword 前后空格； +7. city 精确匹配与 trim； +8. employmentType 精确匹配与 trim； +9. companyId； +10. salaryMin； +11. salaryMax； +12. 两端薪资边界相等； +13. 薪资区间重叠； +14. 薪资区间不重叠； +15. 多条件 AND； +16. DRAFT、CLOSED 等非公开状态排除； +17. 无结果； +18. 排序与分页； +19. `%`、`_`、反斜杠、引号等特殊字符的实际既有语义； +20. null salary 字段的行为。 + +特殊字符测试首先锁定当前 Criteria `LIKE` 行为，不得在没有产品决策时把 `%` 和 `_` 自动改成字面量搜索。 + +### 5.2 Service 真实查询层 + +新增或扩展 `JobSearchServiceIntegrationTest`： + +- 使用真实 `JobService`、`JobRepository`、`CompanyRepository`、EntityManager； +- 不 Mock `findAll`； +- latest/null/relevance 的排序结果一致且稳定； +- salary 排序验证 NULL LAST、降序、相同薪资按 ID 倒序； +- 验证 page/size、totalElements、totalPages； +- 验证企业信息批量组装，不改变 DTO； +- 保留现有非法 sort、非法分页、非法薪资范围的测试。 + +### 5.3 MySQL 真实层 + +优先新增 `JobSearchSpecificationMySqlIntegrationTest`，使用项目已有 Testcontainers 依赖： + +- `@Testcontainers(disabledWithoutDocker = true)` 仅允许本地快速执行时环境性跳过； +- 独立验收和最终冻结时 Docker/MySQL 核心用例不得 SKIP； +- 使用 MySQL 8.x 容器、正式 Flyway 和 `ddl-auto=validate`； +- 使用动态属性注入 JDBC URL、用户名和密码； +- 不打印数据库凭据； +- 至少运行一组与 H2 完全相同的参数化用例，并对返回 ID 与顺序逐项对账； +- 重点对账大小写、LIKE 特殊字符、NULL 排序、边界比较、分页稳定性。 + +如果仓库约定不允许 Testcontainers 进入普通 `mvn test`，可以将其放入独立 profile；但最终报告必须给出真实执行命令和非 SKIP 结果，不能只提交一个从未运行的测试类。 + +## 6. 夹具设计 + +使用明确区分的岗位： + +- 三个包含关键词的岗位，关键词分别只存在于 title、description、requirements； +- 相同城市和不同城市； +- FULL_TIME、PART_TIME 等不同 employmentType； +- 至少两个企业； +- 薪资区间覆盖边界相等、部分重叠、不重叠、NULL； +- 相同 createdAt 的两个岗位，用 ID 验证稳定排序； +- 相同 salaryMax 的两个岗位，用 ID 验证稳定排序； +- PUBLISHED、DRAFT、CLOSED 等状态。 + +夹具必须以测试生成的唯一标识隔离，不能依赖 V1_1 演示数据或真实业务数据。 + +## 7. 数据库与副作用 + +- 查询测试不得修改岗位状态、企业、用户或其他业务表； +- 查询前后对相关稳定业务字段做行级快照，而不是只比较 COUNT； +- Testcontainers 由测试生命周期销毁； +- 使用负责人现有 MySQL 做独立黑盒时，只能精确清理本轮夹具； +- 不允许清库、重置自增、删除 volume； +- 不新增 Flyway 或索引。发现执行计划问题只记录到 R01，不在 Q01 修复。 + +## 8. SQL 与 EXPLAIN + +真实 MySQL 验收需记录： + +- 组合过滤 SQL； +- latest 分页； +- salary 排序； +- count 查询； +- 使用索引、access type、estimated rows、filesort/temporary 情况； +- 1、20、50 条结果规模下查询次数。 + +本阶段以“语义正确且无明显发布阻断”为通过条件，不为了 EXPLAIN 修改索引。 + +## 9. OpenAPI 与兼容性 + +- 不修改 path 和 operation； +- 目标仍为 176 paths / 214 operations； +- 不改变参数名、默认值、响应 DTO 或错误码； +- `docs/openapi-rc.json` 不应因仅新增测试而变化； +- 必须运行 `docs/verify_openapi.py` 防止意外契约漂移。 + +## 10. 通过条件 + +只有同时满足以下条件才能通过 Q01： + +1. `JobSearchSpecification` 不再是测试零引用； +2. H2 真实 Repository 测试覆盖全部过滤语义； +3. Service 自定义 salary 排序有真实数据库证据； +4. MySQL 核心用例真实运行且无 SKIP； +5. H2 与 MySQL 返回 ID、顺序和边界语义一致，或明确记录并解决差异； +6. 非公开岗位绝不进入公开搜索； +7. 分页稳定、total 正确； +8. 无业务数据副作用； +9. 原 Mock 测试保留且准确标注为编排测试； +10. 全量测试和 clean verify 通过； +11. OpenAPI 保持 176/214； +12. 无新增 Flyway、ErrorCode 或公网接口。 + +## 11. 最终状态 + +实施完成但尚未独立复验时，只能写： + +> Q01 已完成真实查询测试实现与自动化验证，待独立代码复验及真实 MySQL/Docker 验收。 diff --git a/docs/q01-job-search-real-query-implementation-instruction.md b/docs/q01-job-search-real-query-implementation-instruction.md new file mode 100644 index 0000000..be0403a --- /dev/null +++ b/docs/q01-job-search-real-query-implementation-instruction.md @@ -0,0 +1,265 @@ +# Q01 岗位搜索真实查询覆盖实施指令 + +## 一、任务边界 + +项目根目录：`C:\Users\15642\Desktop\zhilai` + +目标分支：`test/q01-job-search-specification` + +本轮只补岗位搜索真实数据库测试和验收证据。原则上不修改生产代码；如果测试复现生产缺陷，先保存失败证据并停止，未经负责人确认不得顺手修复。 + +禁止修改岗位接口、DTO、权限、状态机和搜索语义；禁止新增 Flyway、表、索引、ErrorCode 或公网接口；禁止进入 R01；禁止删除现有 Mock 测试；禁止 `git add -A`、commit、push、reset、restore、checkout、clean；禁止删除或移动历史未跟踪文件。 + +## 二、开始前核查 + +执行： + +```powershell +cd C:\Users\15642\Desktop\zhilai +git branch --show-current +git status --short +git diff --cached --name-only +git log -5 --oneline +git diff --check +git status --short -- mydreamjob-server/src/main/resources/db/migration +``` + +确认分支正确、暂存区为空、HEAD 为 S03 检查点 `cb3bc57` 或报告实际偏差、历史未跟踪文件保留、V1–V43 均未修改。搜索并完整阅读适用 `AGENTS.md`；当前基线未发现时记录“未发现”。 + +## 三、必须阅读 + +```text +docs/q01-job-search-real-query-design.md +mydreamjob-server/src/main/java/com/mydreamjob/job/Job.java +mydreamjob-server/src/main/java/com/mydreamjob/job/JobRepository.java +mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java +mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java +mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java +mydreamjob-server/src/test/resources/application-test.yml +mydreamjob-server/src/test/resources/application-integration-test.yml +mydreamjob-server/pom.xml +mydreamjob-server/src/main/resources/db/migration/V2__business_schema.sql +mydreamjob-server/src/main/resources/db/migration/V22__job_search_indexes.sql +``` + +执行： + +```powershell +rg -n "JobSearchSpecification|findAll\(.*Specification|findWithSalarySort|findPublishedJobs" mydreamjob-server/src +``` + +记录哪些现有测试 Mock 了查询层，不能把它们描述成真实过滤覆盖。 + +## 四、先写 H2 真实 Repository 测试 + +新增： + +```text +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationIntegrationTest.java +``` + +要求： + +- 激活 `integration-test`； +- 使用真实 Flyway、H2、JobRepository； +- 不 Mock Repository、Specification、EntityManager 或事务； +- 直接调用 `jobRepository.findAll(JobSearchSpecification.searchJobs(...), pageable)`； +- 每项断言返回 ID 和顺序； +- 测试隔离，不依赖种子岗位； +- 不用顺序无关的 containsOnly 代替排序断言。 + +至少实现以下测试： + +```text +keywordMatchesTitle +keywordMatchesDescription +keywordMatchesRequirements +keywordIsCaseInsensitive +nullBlankAndWhitespaceKeywordDoNotFilter +keywordIsTrimmed +cityUsesTrimmedExactMatch +cityCaseVariantHasSameResultAcrossDatabases +employmentTypeUsesTrimmedExactMatch +employmentTypeCaseVariantHasSameResultAcrossDatabases +companyIdFiltersExactly +salaryMinMatchesWhenJobMaximumEqualsBoundary +salaryMaxMatchesWhenJobMinimumEqualsBoundary +salaryRangesUseOverlapSemantics +nonOverlappingSalaryRangeIsExcluded +multipleConditionsUseAndSemantics +nonPublishedJobsAreAlwaysExcluded +specialLikeCharactersFollowExistingContract +nullSalaryFieldsFollowExistingContract +paginationReturnsStableOrderedIds +noResultReturnsEmptyPage +``` + +不要为了让测试符合预期而预先修改 `JobSearchSpecification`。如果任何既有语义与设计不一致，保留失败测试并报告。 + +## 五、补 Service 真实查询测试 + +新增： + +```text +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceIntegrationTest.java +``` + +使用真实 JobService、JobRepository、CompanyRepository 和 EntityManager，覆盖： + +```text +latestSortUsesCreatedAtThenIdDescending +nullSortUsesLatestOrder +relevanceCurrentlyUsesLatestOrder +salarySortUsesMaximumDescendingAndNullLast +salarySortUsesIdDescendingAsTieBreaker +salarySortReturnsCorrectTotalAndTotalPages +secondPageDoesNotRepeatOrLoseRows +companyInformationIsMappedFromRealRepository +searchDoesNotReturnDraftOrClosedJobs +``` + +原 `JobSearchServiceTest` 保留，用于参数校验和编排；如需修改注释，只能明确它不是 Specification SQL 覆盖，不得删除或放宽断言。 + +## 六、补 MySQL 真实测试 + +新增建议文件： + +```text +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationMySqlIntegrationTest.java +``` + +使用已有 `org.testcontainers:mysql` 和 `junit-jupiter`： + +- MySQL 8.x； +- 正式 Flyway； +- Hibernate `ddl-auto=validate`； +- `@DynamicPropertySource` 注入连接参数； +- 不打印密码； +- 不复用开发数据库； +- 不 Mock 查询路径； +- 容器用例至少对账 keyword 大小写、特殊字符、城市、薪资边界、非公开过滤、latest、salary NULL LAST、分页。 + +可复用参数化场景或夹具构造器，确保 H2/MySQL 输入一致。必须逐项断言结果 ID/业务标识和顺序，而不是只断言数量。 + +如果普通开发环境 Docker 不可用，可以让 Testcontainers 测试环境性跳过；但最终独立验收必须显式运行该类并得到 Tests run > 0、Skipped=0。不得用 H2 结果代替 MySQL。 + +## 七、查询副作用与执行计划 + +新增测试或独立验收证据证明查询前后以下数据不变： + +- jobs 稳定业务字段； +- companies； +- applications； +- candidate_dimension_scores； +- notifications； +- messages； +- audit_logs。 + +使用行级稳定字段快照，不能只比较 COUNT、SUM 或 CRC32。 + +真实 MySQL 验收对组合过滤、latest、salary 和 count SQL 执行 `EXPLAIN FORMAT=JSON`，记录使用索引、access type、estimated rows、temporary/filesort。Q01 不新增索引；发现性能问题记录给 R01。 + +## 八、文档 + +更新： + +```text +docs/backend-development-roadmap.md +docs/phase1-scope-and-acceptance.md +``` + +只记录 Q01 的测试层级和真实结果，不改变接口文档。原则上不修改 `docs/openapi-rc.json`；若仅新增测试却产生 OpenAPI 差异，视为异常并停止调查。 + +新增最终实施报告建议： + +```text +docs/q01-job-search-real-query-implementation-report.md +``` + +不得写“真实 MySQL 已通过”，除非 Testcontainers 或独立 MySQL 实际运行且核心项无 SKIP。 + +## 九、验证顺序 + +先运行 H2 测试： + +```powershell +cd C:\Users\15642\Desktop\zhilai\mydreamjob-server +mvn -Dtest="JobSearchSpecificationIntegrationTest,JobSearchServiceIntegrationTest" test +``` + +Docker 可用时运行 MySQL 测试： + +```powershell +mvn -Dtest="JobSearchSpecificationMySqlIntegrationTest" test +``` + +运行岗位关联回归： + +```powershell +mvn -Dtest="*JobSearch*Test,*Job*Test,*CompanyPublic*Test" test +``` + +随后： + +```powershell +mvn test +mvn clean verify +python ..\docs\verify_openapi.py +``` + +最后： + +```powershell +cd C:\Users\15642\Desktop\zhilai +git diff --check +git status --short +git diff --cached --name-only +git status --short -- mydreamjob-server/src/main/resources/db/migration +``` + +要求所有必跑测试 Failures=0、Errors=0、Skipped=0，clean verify 成功，OpenAPI 保持 176/214，暂存区为空，V1–V43 未修改。 + +## 十、发现缺陷时 + +如果真实测试发现生产缺陷： + +1. 保留最小失败测试； +2. 记录 H2 与 MySQL 是否一致； +3. 精确写明参数、夹具、预期 ID、实际 ID/顺序和生成 SQL； +4. 不自行修改生产代码； +5. 状态标记为 FAIL，等待负责人下发定向整改指令。 + +禁止通过修改夹具、删除断言、Mock Repository、禁用测试或放宽为只断言数量来制造绿色。 + +## 十一、最终报告 + +必须包含： + +1. 分支与 HEAD； +2. 现有 Mock 测试的真实职责； +3. H2 测试数及结果； +4. MySQL 测试数及结果； +5. 每个过滤条件的实际结果； +6. keyword 三字段、大小写和特殊字符结果； +7. 薪资边界与区间重叠结果； +8. PUBLISHED 强制过滤结果； +9. latest/relevance/salary 排序结果； +10. 分页与 total 结果； +11. H2/MySQL 差异； +12. EXPLAIN 摘要； +13. 数据副作用结果； +14. 关联和全量测试数； +15. Failures/Errors/Skipped； +16. clean verify； +17. OpenAPI paths/operations； +18. 精确修改文件； +19. 是否修改生产代码； +20. 是否新增 Flyway、ErrorCode 或接口； +21. Git 状态； +22. 明确未暂存、未提交、未推送； +23. 是否存在待整改缺陷。 + +实现和自动化通过后只能写： + +> Q01 已完成真实查询测试实现与自动化验证，待独立代码复验及真实 MySQL/Docker 验收。 diff --git a/docs/q01-job-search-real-query-implementation-report.md b/docs/q01-job-search-real-query-implementation-report.md new file mode 100644 index 0000000..8f5157f --- /dev/null +++ b/docs/q01-job-search-real-query-implementation-report.md @@ -0,0 +1,265 @@ +# Q01 岗位搜索真实查询覆盖实施报告 + +> **状态**：Q01 已完成真实查询测试实现、跨库一致性整改及独立复验，可以进入精确暂存检查点。 + +## 1. 分支与 HEAD + +| 项目 | 值 | +|---|---| +| 分支 | `test/q01-job-search-specification` | +| HEAD | `cb3bc57fab549137e3785f5d50bde86ce8ef5731`（S03 检查点 `cb3bc57`，无偏差） | +| 暂存区 | 空（`git diff --cached --name-only` 无输出） | +| 生产代码 | 定向修改 `JobSearchSpecification`：对 city/employmentType 显式 `lower`，消除 H2/MySQL 排序规则差异，并保持线上 MySQL 既有忽略大小写结果 | +| V1–V43 迁移 | 未修改（`git status --short -- .../db/migration` 无输出） | + +`AGENTS.md` 核查：仓库根目录、`mydreamjob-server/` 及其子目录**均未发现** `AGENTS.md`。 + +## 2. 现有 Mock 测试的真实职责 + +| 测试类 | 测试数 | 真实职责 | 不具备的能力 | +|---|---|---|---| +| `JobSearchServiceTest`（保留，未删除、未放宽断言） | 37 | 用 Mockito 把 `JobRepository.findAll(Specification, Pageable)` 与 `CompanyRepository` 整体 Mock 掉，验证参数校验（非法 sort / 非法分页 / 非法薪资范围）、分页对象、排序参数传递、企业信息组装与 DTO 编排 | **不能**证明 Criteria 谓词、SQL 过滤、排序与分页在真实数据库上的行为 | +| `JobServiceTest`（保留） | 13 | 岗位 CRUD、状态机与归属校验的编排 | 同上，与查询语义无关 | + +本轮为该 Mock 测试补充了类级 Javadoc，明确标注它是**编排测试**而非 Specification SQL 覆盖（仅注释，未改动任何断言）。Q01 之前 `JobSearchSpecification` 在生产代码外几乎零引用（仅被 Mock 测试当作 `Specification` 类型占位）；本轮起被 4 个测试类**直接调用**其 `searchJobs(...)`：`JobSearchSpecificationIntegrationTest`、`JobSearchSpecificationMySqlIntegrationTest`、`JobSearchQueryExplainMySqlIntegrationTest`，以及副作用用例基类 `JobSearchQuerySideEffectTestBase`（H2 与 MySQL 两个子类共用）。 + +## 3. 测试分层与结果 + +| 层次 | 测试类 | 数据库 | Tests run | Failures | Errors | Skipped | +|---|---|---|---|---|---|---| +| H2 真实 Repository | `JobSearchSpecificationIntegrationTest` | H2（真实 Flyway，`integration-test`） | 21 | 0 | 0 | 0 | +| H2 真实 Service/EntityManager | `JobSearchServiceIntegrationTest` | H2（真实 Flyway） | 9 | 0 | 0 | 0 | +| H2 查询副作用 | `JobSearchQuerySideEffectIntegrationTest` | H2（真实 Flyway） | 4 | 0 | 0 | 0 | +| **MySQL 真实层** | `JobSearchSpecificationMySqlIntegrationTest` | **真实 MySQL 8.4（Testcontainers）** | 15 | 0 | 0 | 0 | +| **MySQL 查询副作用** | `JobSearchQuerySideEffectMySqlIntegrationTest` | **真实 MySQL 8.4（Testcontainers）** | 4 | 0 | 0 | 0 | +| **MySQL 执行计划** | `JobSearchQueryExplainMySqlIntegrationTest` | **真实 MySQL 8.4（Testcontainers）** | 1 | 0 | 0 | 0 | +| 合计（新增 Q01 测试） | | | **54** | **0** | **0** | **0** | + +MySQL 核心用例**真实执行**（Docker 可用，容器实启），`Skipped = 0`，未出现环境性跳过。 + +执行命令（原样）： + +```powershell +cd C:\Users\15642\Desktop\zhilai\mydreamjob-server +mvn -Dtest="JobSearchSpecificationMySqlIntegrationTest" test +``` + +定向复验输出：`Tests run: 15, Failures: 0, Errors: 0, Skipped: 0` / `BUILD SUCCESS`。 + +> 首次按负责人指令执行该命令时为 `Tests run: 9, Failures: 0, Errors: 0, Skipped: 0`。随后为达成「与 H2 逐项对账」的完整性，补齐了 MySQL 侧原先缺失的 4 个 H2 已覆盖场景（空白关键词、关键词 trim、多条件 AND、NULL 薪资契约），并在独立复核后增加 city、employmentType 大小写变体 2 个跨库契约用例；该命令现为 **15 条**，仍为 `Failures=0 / Errors=0 / Skipped=0`。 + +数据库配置：`mysql:8.4` 独立容器（`mydreamjob_q01`），执行**正式 Flyway 迁移**并以 `ddl-auto=validate` 启动；JDBC URL / 用户名 / 密码由 `@DynamicPropertySource` 运行期注入，不落盘、不打印。应用级测试开关与测试密钥由测试专用 profile `mysql-it` 提供（`src/test/resources/application-mysql-it.yml`），方言沿用主配置的 `MySQLDialect`——H2 与 MySQL 用例因此跑在**同一套应用配置**上，仅数据库实现不同，便于逐项对账。 + +## 4. 每个过滤条件的实际结果 + +| 条件 | 契约 | 真实库实测结论（H2 与 MySQL 一致） | +|---|---|---| +| `status` | 无论传入什么，只返回 `PUBLISHED` | DRAFT、CLOSED 在任何组合、任何排序下都不出现；显式按 `companyId` 过滤时同样不出现 | +| `keyword` | trim 后忽略大小写，匹配 title / description / requirements 任一字段 | 三字段分别命中；`java` / `JaVa` / ` Java ` 结果相同 | +| `city` | trim 后忽略大小写精确匹配 | `Q01-Beijing`、`q01-beijing` 和带空格的小写查询命中同一岗位；与 `city + "别处"` 区分开 | +| `employmentType` | trim 后忽略大小写精确匹配 | `FULL_TIME`、`full_time` 和带空格的小写查询命中同一岗位；`PART_TIME`、`FULL` 不命中 | +| `companyId` | 精确匹配 | 只返回本企业岗位 | +| `salaryMin` | 岗位 `salaryMax >= salaryMin`（单边） | 边界相等命中；`salaryMax` 更高者也命中；`salaryMax` 低于边界者排除 | +| `salaryMax` | 岗位 `salaryMin <= salaryMax`（单边） | 边界相等命中；`salaryMin` 更低者也命中；`salaryMin` 高于边界者排除 | +| 两端同时给出 | 区间重叠 | 部分重叠命中、被用户区间包含命中；高于或低于用户区间均排除 | +| 多条件 | AND | 关键词/城市/用工类型/企业/薪资必须同时满足 | +| 无结果 | 空页 | `content` 为空、`totalElements = 0` | + +## 5. keyword 三字段、大小写与特殊字符 + +- **title / description / requirements 三字段**：三个只在一个字段含关键词的岗位都能被单独命中，未含关键词的岗位不命中。 +- **大小写**：`lower(title|description|requirements) LIKE lower(pattern)`，`java`、`JAVA`、`JaVa` 命中同一组岗位（MySQL 侧还叠加列排序规则，结论一致）。 +- **trim**：`" Java "` 与 `"Java"` 结果一致。 +- **空值**：`null`、`""`、`" "`、`" "`、`"\t"` 均**不参与过滤**（`isBlank()` 判定），返回该城市下全部岗位。 +- **LIKE 特殊字符**（锁定既有契约，**未做转义改动**）： + - `%` 作为通配符，命中该城市下全部带标题的岗位； + - `_` 作为单字符通配符，同样命中全部； + - `A_B` 以通配符解释，命中 `A_B岗` 本身。 + - H2 与 MySQL 行为**一致**。这是既有语义，产品未决策前不改为字面量搜索。 + +## 6. 薪资边界与区间重叠 + +H2 与 MySQL 逐项一致： + +| 用例 | 用户条件 | 期望与实测 | +|---|---|---| +| `salaryMinMatchesWhenJobMaximumEqualsBoundary` | `salaryMin=20000` | 仅 `[10000,19999]` 被排除，`[10000,20000]` 命中（边界相等命中） | +| `salaryMaxMatchesWhenJobMinimumEqualsBoundary` | `salaryMax=10000` | 仅 `[10001,20000]` 被排除，`[10000,20000]` 命中 | +| 部分重叠 | `[15000,25000]` | `[10000,20000]`、`[12000,30000]` 命中 | +| 不重叠 | `[30000,35000]`、`[1000,4000]` | 空 | +| NULL 薪资 | 不加薪资条件 | `[null,null]`、`[10000,null]` 照常返回 | + +NULL 薪资的既有契约（SQL 三值逻辑）：一旦给出 `salaryMin`，`job.salaryMax >= ?` 对 `salaryMax IS NULL` 求值为 UNKNOWN，因此 `salaryMax` 为 NULL 的岗位被排除。Q01 **锁定**该行为，不做修改。 + +## 7. PUBLISHED 强制过滤 + +无论是否传其它条件、无论 `sort` 取 `latest` / `relevance` / `salary` / `null`，DRAFT 与 CLOSED 岗位**绝不出现**；即使显式传入 DRAFT 岗位所属的 `companyId` 也不出现。H2 与 MySQL 一致。 + +## 8. latest / relevance / salary 排序 + +| 排序 | 语义 | 实测 | +|---|---|---| +| `latest` / `null` | `createdAt DESC, id DESC` | 按 `created_at` 倒序；`created_at` 相同时按 `id DESC`；`null` 与 `latest` 结果完全一致 | +| `relevance` | 当前与 `latest` 等价（本轮锁定，不改造成新算法） | 与 `latest` 结果完全一致 | +| `salary` | `salaryMax` 非空优先降序；相同值按 `id DESC`；NULL 最后 | `CASE WHEN salary_max IS NULL THEN 1 ELSE 0 END ASC, salary_max DESC, id DESC` 生效，NULL 排在最后；相同 `salaryMax` 按 `id DESC` | + +`salary` 排序走 `JobService.findWithSalarySort` 的 CriteriaQuery + CASE WHEN 路径（真实 `EntityManager`），在 H2 与真实 MySQL 上均通过。 + +## 9. 分页与 total + +- 5 条数据、`size=2` 时：`totalElements = 5`、`totalPages = 3`；第 0 页与第 1 页 ID 顺序与期望逐项一致；三页拼接等于完整期望顺序，**无重复、无遗漏**。 +- 无结果时 `totalElements = 0`。 +- H2 与 MySQL 一致。 + +## 10. H2 与 MySQL 差异 + +初次复验发现 MySQL `utf8mb4_unicode_ci` 与 H2 默认字符串比较规则可能造成 city、employmentType 大小写差异。现已在 Specification 中显式对字段和值使用 `lower`，并在两库增加同名大小写变体测试。两个库在 keyword、city、employmentType、特殊字符、薪资边界、PUBLISHED 过滤、排序、分页和 total 上结果现已逐项一致。 + +过程中在 **MySQL 用例内部**发现并修正了 3 处**用例自身的期望错误**（不是生产缺陷，见第 13 节）： + +1. 只给 `city` 条件时，用例原本期望同城但 `PART_TIME` 的岗位不出现——契约只规定城市精确匹配，返回它是正确的； +2. `salaryMin=20000` 时用例原本期望只返回边界岗位，但契约是**单边**比较，`salaryMax=60000 >= 20000` 的岗位同样应命中； +3. `salaryMax=10000` 时同理，`salaryMin=5000 <= 10000` 的岗位同样应命中。 + +修正方式是把期望改为与设计文档第 4 节契约表一致，并**加强**而非放宽断言（补齐两条「区间完全在用户区间之外」的反向断言、补 `doesNotContain` 前缀城市断言）。H2 用例的同名场景夹具本就设计正确（相邻岗位取「刚好越界」值），因此未受影响。 + +## 11. EXPLAIN 摘要 + +真实 MySQL 8.4 上以 `EXPLAIN FORMAT=JSON` 采集，等价 SQL 与 Criteria 路径**绑定同一组参数**，并先断言二者返回**完全相同的 ID 与顺序**（保证 EXPLAIN 的不是一份不存在的语句）。完整原文见 [Q01 MySQL 执行计划证据](q01-job-search-mysql-explain-evidence.md)。 + +| 语句 | query_cost | access_type | 可用索引 | 实际选用 key | rows_examined_per_scan | using_filesort | using_temporary_table | +|---|---|---|---|---|---|---|---| +| 组合过滤 + latest 分页 | 1.35 | `ALL` | `idx_jobs_company_status`、`idx_jobs_status_created`、`idx_jobs_city_status`、`idx_jobs_status_employment_type`、`idx_jobs_status_salary_max` | 未选用 | 1 | true | false | +| latest 分页 | 1.35 | `ALL` | 同上（除 `idx_jobs_company_status`） | 未选用 | 1 | true | false | +| salary 排序（CASE WHEN） | 1.35 | `ALL` | 同上 | 未选用 | 1 | true | false | +| count 查询 | 0.35 | `ALL` | 同上 | 未选用 | 1 | false | false | + +结果规模与 SQL 语句条数（page size = 20）： + +| 匹配结果数 | 返回行数 | totalElements | Repository SQL数 | 完整Service SQL数 | +|---|---|---|---|---| +| 1 | 1 | 1 | 1 | 2 | +| 20 | 20 | 20 | 2 | 3 | +| 50 | 20 | 50 | 2 | 3 | + +Spring Data 对首页有优化：首页返回行数小于 `pageSize` 时不再发 count 查询，因此 Repository 路径为 1/2/2 条。完整 Service 路径固定增加一次企业批量查询，为 2/3/3 条；两者均不随结果数量线性增长，不存在逐岗位查询企业的 N+1。 + +**结论与边界**：Q01 夹具刻意做小（每个城市 1 / 20 / 50 条），InnoDB 统计信息在此规模下估算行数为 1、优化器选择全表扫描并做 filesort，**这不构成生产规模的性能结论**。按 Q01 边界不新增、不调整索引；`%keyword%` 前导通配符本身无法走 B-Tree 索引、以及大规模数据下的 `ORDER BY` filesort 成本，记录给 **R01**。 + +## 12. 数据副作用结果 + +用例在 jobs、companies、users、applications、candidate_dimension_scores、notifications、conversations、messages、audit_logs **九张表**上做**行级稳定字段快照**（按主键排序、逐行取显式列出的稳定业务字段，不使用 `SELECT *`、不含 `password_hash` 等凭据列），执行覆盖「全部过滤条件 × 4 种排序 × 分页 × 无结果 × 聚合筛选项」的完整搜索矩阵后再次取快照，逐表逐行逐字段比较： + +- **H2**：前后完全一致； +- **真实 MySQL**：前后完全一致。 + +仅比较 COUNT / SUM / CRC32 无法证明「没有某一行被改写」，故另设**反证测试**（H2 与 MySQL 各跑一遍）： + +| 反证用例 | 人为动作 | 要求 | +|---|---|---| +| `snapshotReportsRowFieldUpdate` | 直接改写 `jobs.status` | 必须被发现；把字段与 `updated_at` 一并还原后必须重新完全一致（证明差异定位精确而非「永远不等」） | +| `snapshotReportsInsertedRow` | 插入一行 notification | 必须被发现 | +| `snapshotReportsDeletedRow` | 删除一行 notification | 必须被发现 | + +反证全部通过，说明主证据的「无副作用」结论不是因为比较失效。测试同时断言九张受检表在测试库中**确有行**，避免空快照导致的假通过。 + +## 13. 缺陷与判定 + +定向复验发现测试环境与线上 MySQL 的大小写比较可能不一致。为锁定线上已有的忽略大小写结果并保证跨库一致，生产代码仅修改 `JobSearchSpecification`，对 city 和 employmentType 显式执行 Locale.ROOT 小写归一化；接口、DTO、权限、状态机和 MySQL 既有返回语义均未改变。`JobService`、`JobRepository`、`JobController` 与 `ErrorCode` 保持原样。 + +过程中处理的 2 类**非生产缺陷**问题，均已记录： + +1. **MySQL 用例无法启动上下文**：该类最初未激活任何 profile，导致 `app.jwt.*` 测试密钥缺失、`AppJwtProperties` 校验失败（`JWT_ACCESS_SECRET must be at least 32 characters`）。这是**用例配置缺失**，不是生产缺陷（生产要求 JWT 密钥必须显式配置，行为正确）。修复方式是新增测试专用 profile `mysql-it`，并保持连接参数由 `@DynamicPropertySource` 注入。 +2. **MySQL 用例期望与契约表自相矛盾**：见第 10 节的 3 处，已按契约修正并加强断言。 + +**无待整改生产缺陷。** 上述跨库一致性问题已定向解决并有 H2/MySQL 同名用例证明。 + +## 14. 关联与全量测试 + +| 项目 | 命令 | 结果 | +|---|---|---| +| 岗位关联回归 | `mvn -Dtest="*JobSearch*Test,*Job*Test,*CompanyPublic*Test" test` | **Tests run: 225, Failures: 0, Errors: 0, Skipped: 0** | +| 全量测试 | `mvn test` | **Tests run: 1890, Failures: 0, Errors: 0, Skipped: 0** | +| 干净构建 | `mvn clean verify` | **Tests run: 1890, Failures: 0, Errors: 0, Skipped: 0**，`BUILD SUCCESS`，产出 `mydreamjob-server-0.0.1-SNAPSHOT.jar` | + +关联回归中与 Q01 直接相关的类：`JobSearchSpecificationIntegrationTest` 21、`JobSearchServiceIntegrationTest` 9、`JobSearchSpecificationMySqlIntegrationTest` 15、`JobSearchQuerySideEffectIntegrationTest` 4、`JobSearchQuerySideEffectMySqlIntegrationTest` 4、`JobSearchQueryExplainMySqlIntegrationTest` 1、`JobSearchServiceTest` 37（保留）、`JobServiceTest` 13、`JobFavoriteServiceTest` 10、`CompanyPublicServiceTest` 22。 + +## 15. Failures / Errors / Skipped 与 clean verify + +| 项目 | Tests run | Failures | Errors | Skipped | 构建 | +|---|---|---|---|---|---| +| `mvn test` | **1890** | **0** | **0** | **0** | `BUILD SUCCESS` | +| `mvn clean verify` | **1890** | **0** | **0** | **0** | `BUILD SUCCESS`（含打包，产出 `mydreamjob-server-0.0.1-SNAPSHOT.jar`） | + +所有必跑测试 `Failures = 0`、`Errors = 0`、`Skipped = 0`。日志中不存在任何 `Skipped: <非零>` 的测试类。三个 MySQL Testcontainers 用例类在 `mvn clean verify` 中**真实启动容器并执行**（`JobSearchSpecificationMySqlIntegrationTest` 15 条 / `JobSearchQuerySideEffectMySqlIntegrationTest` 4 条 / `JobSearchQueryExplainMySqlIntegrationTest` 1 条），**未发生跳过**。 + +## 16. OpenAPI + +``` +python docs/verify_openapi.py +paths: 176 +operations: 214 +All checks passed! +``` + +`docs/openapi-rc.json` **未被修改**（`git status --short -- docs/openapi-rc.json` 无输出）。Q01 只新增测试，未新增、未删除、未重命名任何 path 或 operation，未改变参数名、默认值、响应 DTO 或错误码。 + +## 17. 精确修改文件 + +**新增（Q01 测试与证据）** + +```text +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationMySqlIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectTestBase.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectMySqlIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/BusinessRowSnapshot.java +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQueryExplainMySqlIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/job/Q01SqlRecorder.java +mydreamjob-server/src/test/resources/application-mysql-it.yml +docs/q01-job-search-real-query-design.md +docs/q01-job-search-real-query-implementation-instruction.md +docs/q01-job-search-real-query-implementation-report.md +docs/q01-job-search-mysql-explain-evidence.md +``` + +**修改（1 个定向生产修复、测试注释与文档）** + +```text +mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java # city/employmentType 跨库大小写语义显式统一 +mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java # 仅补类级 Javadoc，标注为编排测试；断言未改动 +docs/backend-development-roadmap.md +docs/phase1-scope-and-acceptance.md +``` + +## 18. 是否修改生产代码 / 新增迁移或接口 + +- **生产代码：定向修改 1 个文件。** `JobSearchSpecification` 对 city 和 employmentType 显式使用 `lower` + `Locale.ROOT`，保持线上 MySQL 既有忽略大小写结果并消除 H2 差异；`JobService`、`JobRepository`、`JobController`、DTO、状态机与权限未改。 +- **Flyway：未新增。** 最新迁移仍为 V43；V1–V43 全部未修改。 +- **ErrorCode：未新增。** +- **公网接口：未新增、未删除、未重命名。** OpenAPI 保持 176 paths / 214 operations。 +- 未接入 Elasticsearch、缓存或搜索引擎；未进入 R01。 + +## 19. Git 状态 + +``` +git branch --show-current -> test/q01-job-search-specification +git diff --cached --name-only -> （空） +git status --short -- mydreamjob-server/src/main -> M JobSearchSpecification.java（Q01 定向修复） +git status --short -- mydreamjob-server/src/main/resources/db/migration -> （空） +git status --short -- docs/openapi-rc.json -> （空） +``` + +检查点执行前，本分支未暂存、未提交、未推送；未执行 `git add -A`、reset、restore、checkout、clean；未删除或移动任何历史未跟踪文件。Q01 改动由 1 个定向生产修复、真实数据库测试与正式证据文档组成。 + +## 20. 待整改事项 + +**Q01 范围内无待整改缺陷。** + +移交给 **R01**（不在 Q01 修复）： + +- `keyword` 使用 `%keyword%` 前导通配符，B-Tree 索引无法用于该谓词； +- 小样本夹具下优化器选择全表扫描 + filesort，真实数据规模下的执行计划与排序成本需在 R01 以真实量级数据评估； +- `JobService.findWithSalarySort` 的 `CASE WHEN` 排序无法利用 `idx_jobs_status_salary_max` 的有序性，需要 R01 评估替代方案。 diff --git a/docs/r01-a-request-context-implementation-instruction.md b/docs/r01-a-request-context-implementation-instruction.md new file mode 100644 index 0000000..5955c68 --- /dev/null +++ b/docs/r01-a-request-context-implementation-instruction.md @@ -0,0 +1,110 @@ +# R01-A 请求身份与 requestId 收束实施指令 + +## 一、任务性质 + +本轮只完成 R01-A 第一批，不进入异常映射、评分规则、百分位、消息未读、PersonalDataCollector 或推荐权重重构。 + +允许修改公共请求上下文组件、最多 8 个 Controller 及其测试和文档；禁止新增接口、ErrorCode、Flyway、表、索引或依赖。 + +## 二、开始前核查 + +在 `C:\Users\15642\Desktop\zhilai` 执行并记录： + +```powershell +git branch --show-current +git status --short +git diff --cached --name-only +git log -5 --oneline +git diff --check +``` + +分支必须为 `refactor/r01-structure-performance`，HEAD 必须包含 Q01 检查点 `77dc624`，暂存区必须为空。完整搜索适用的 AGENTS.md；保护全部历史未跟踪文件。 + +## 三、先写基线清单 + +列出所有私有 `resolveUserId/userId/requireAdmin` 与 `requestId/getRequestId` 方法，记录：文件、公开端点、当前异常、角色检查位置、资源归属检查位置、requestId 来源。 + +第一批只迁移以下 8 个 Controller： + +1. `AssessmentController` +2. `AbilityController` +3. `ProfileController` +4. `ResumeVersionController` +5. `PreferenceController` +6. `CompetitionRankingController` +7. `PersonalDataExportController` +8. `PrivacySettingsController` + +若其中存在与未提交修改重叠，停止并报告，不得改换到其它文件凑数。 + +## 四、身份组件 + +复用现有 `CurrentUserAccessor`，不要创建第二个身份解析器。Controller 通过构造器注入并调用 `requireUserId()`。 + +必须保持： + +- null Authentication、AnonymousAuthenticationToken、`anonymousUser`、未认证、空白主体、Unicode 数字、带正负号、Long 溢出和 userId<=0 全部 401； +- 不回显主体内容、异常类或堆栈； +- 不接受请求参数中的 userId； +- 角色与资源归属仍由原 Service/Controller 的既有位置判断； +- 不将原 403 或 404 改成 401。 + +删除迁移 Controller 内的私有身份解析代码和不再使用的 SecurityContext 依赖。 + +## 五、requestId 组件 + +先完整阅读 `common/logging/RequestIdFilter`、`RequestLoggingFilter`、`AuditContext` 和 `GlobalExceptionHandler`。 + +新增 `common/logging/RequestIdAccessor`，提供 `String get(HttpServletRequest request)`。它必须复用过滤器产出的规范化 requestId；禁止重新生成第二个值，禁止直接信任超长/非法客户端头。 + +若 RequestIdFilter 当前没有 request attribute，允许增加一个常量属性并写入规范化后的值。响应头、MDC、Controller body、AuditContext 与异常响应必须保持同源。过滤器结束后仍清理 MDC。 + +只替换上述 8 个 Controller 的私有 requestId 方法。GlobalExceptionHandler 本轮只允许改为调用 accessor，不得重构 HTTP 状态映射。 + +## 六、必须先新增的测试 + +新增或加强： + +- `RequestIdAccessorTest` +- `RequestContextMigrationIntegrationTest` +- 8 个 Controller 的既有权限回归 + +至少覆盖： + +1. 合法客户端 requestId 原样使用； +2. 缺失、空白、超长、非法字符时使用过滤器规范化值； +3. 响应头、响应 body、MDC 日志与 AuditContext 同一值； +4. 并发请求不串 requestId； +5. 过滤器完成后 MDC 清理； +6. 八类非法 principal 均 401 而非 500； +7. 错误响应不包含 principal； +8. STUDENT/COMPANY/ADMIN 权限矩阵与改动前一致； +9. 拒绝请求无业务写入； +10. 反证：绕过 filter 直接传超长请求头时 accessor 不得返回原值。 + +禁止只 Mock 新组件后断言 Controller 返回 mock 值；至少一组测试必须使用真实 SecurityFilterChain、RequestIdFilter 和 MVC。 + +## 七、量化验收 + +整改前后分别统计： + +```powershell +rg -l "private (Long|long) resolveUserId|private .*userId\(\)" mydreamjob-server/src/main/java +rg -l "private String (getRequestId|requestId)\(" mydreamjob-server/src/main/java +``` + +第一批必须精确减少对应 8 个 Controller 的重复方法，不得声称全仓已完成。报告剩余数量和文件清单。 + +## 八、验证 + +依次运行定向测试、八个模块关联测试、`mvn test`、`mvn clean verify`、`python ..\docs\verify_openapi.py`、`git diff --check`。 + +预期 OpenAPI 保持 176/214；测试数量以实际为准，Failures=0、Errors=0、Skipped=0。 + +## 九、停止条件 + +完成 R01-A 第一批代码、测试和报告后停止。暂存区保持空；不得 commit/push；不得进入 R01-B/C/D/E。 + +最终状态只能写： + +`R01-A 第一批请求上下文收束完成，待独立代码复验。` diff --git a/docs/r01-a-request-context-implementation-report.md b/docs/r01-a-request-context-implementation-report.md new file mode 100644 index 0000000..ccd7952 --- /dev/null +++ b/docs/r01-a-request-context-implementation-report.md @@ -0,0 +1,284 @@ +# R01-A 第一批请求上下文收束实施报告 + +> **状态**：R01-A 第一批请求上下文收束及阻断整改已完成，并通过独立代码复验与干净构建。 + +## 1. 范围与分支 + +| 项目 | 值 | +|---|---| +| 分支 | `refactor/r01-structure-performance` | +| HEAD | `77dc624`（Q01 检查点，见 `fix: align job search queries across databases`） | +| 范围 | 只完成 R01-A 第一批：8 个 Controller 的身份解析与 requestId 收束 | +| 未进入 | R01-B（异常映射）、R01-C（纯计算）、R01-D（查询收束）、R01-E（真实环境复验），以及 `UserRoleGuard`、`PersonalDataCollector`、评分规则、百分位、消息未读、推荐权重 | +| AGENTS.md | 仓库根目录、`mydreamjob-server/` 及其子目录**均未发现** `AGENTS.md` | + +## 2. 开始前核查 + +``` +git branch --show-current -> refactor/r01-structure-performance ✓ +git log -5 --oneline -> HEAD = 77dc624（Q01 检查点） ✓ +git diff --cached --name-only -> （空） ✓ 暂存区为空 +git diff --check -> 仅 LF/CRLF 提示，无空白错误 +``` + +工作区另有一处**与本次无关**的既存未提交修改：`docs/backend-development-roadmap.md`（Q01 行更新 + R01 行）。它不属于 8 个 Controller 的任何文件，不构成 §3 的「重叠」停止条件，本轮未触碰该文件。 + +## 3. 基线清单（整改前） + +### 3.1 第一批 8 个 Controller + +| # | Controller | 公开端点 | 整改前身份异常 | 角色检查位置 | 资源归属检查位置 | requestId 来源 | +|---|---|---|---|---|---|---| +| 1 | `assessment/AssessmentController` | `GET /assessments/types`、`GET /assessments/{type}/questions`、`POST /assessments/attempts`、`GET /assessments/attempts/{id}`、`PATCH .../answers`、`POST .../submit`、`GET .../result`、`GET /assessments/me` | `BusinessException(UNAUTHORIZED)`；非数字主体 `NumberFormatException` → 500 | `AssessmentAttemptService.requireStudent(userId)` | 答卷归属在 `AssessmentAttemptService`（非本人 → 2002/403） | `request.getHeader("X-Request-Id")` | +| 2 | `ability/AbilityController` | `GET /abilities/types`、`POST /abilities/attempts`、`GET /abilities/attempts/{id}`、`PATCH .../answers`、`POST .../submit`、`GET .../result`、`GET /abilities/me` | 同上 | `AbilityAttemptService.requireStudent(userId)` | 答卷归属在 `AbilityAttemptService` | 同上 | +| 3 | `profile/ProfileController` | `GET /profile/me`、`PUT /profile/me`、`POST /profile/me/resume`、`GET /profile/me/resume`、`DELETE /profile/me/resume` | 同上（全限定名写法） | `ProfileService.assertStudentRole(userId)`（Controller 显式调用） | 按当前 userId 取本人资料，无跨用户入参 | 同上 | +| 4 | `resume/ResumeVersionController` | `POST/GET /profile/me/resume-versions`、`GET/PUT/DELETE /profile/me/resume-versions/{id}`、`POST .../{id}/default`、`POST .../{id}/export`、`GET /resume-export-tasks/{taskId}`、`GET .../download` | 同上 | `ResumeVersionService` → `ProfileService.assertStudentRole` | `version.getUserId().equals(userId)`，否则 2002/403 | 同上 | +| 5 | `preference/PreferenceController` | `GET /profile/me/preferences`、`PUT /profile/me/preferences` | 同上（全限定名写法） | `PreferenceService.assertStudentRole` | 键为当前 userId | 同上 | +| 6 | `competition/CompetitionRankingController` | `GET /jobs/{jobId}/competition-ranking` | 同上 | `CompetitionRankingService.assertStudentRole` | 未投递该岗位 → 2002/403；岗位不存在 → 7001/404 | 同上 | +| 7 | `dataexport/PersonalDataExportController` | `POST/GET /profile/me/data-export-tasks`、`GET .../{taskId}`、`GET .../{taskId}/download` | 同上，且已 try/catch `NumberFormatException`（但仍映射为 2001 → HTTP **400**） | 无角色限制（STUDENT/COMPANY/ADMIN 均可操作本人任务） | `task.getUserId().equals(userId)`，否则 2002/403 | 同上 | +| 8 | `privacy/PrivacySettingsController` | `GET /profile/me/privacy`、`PUT /profile/me/privacy` | 同上 | `PrivacySettingsService.assertStudentRole` | 键为当前 userId | 同上 | + +**共性**：8 个类各自持有一份 `private Long resolveUserId(HttpServletRequest)` 与一份 `private String getRequestId/requestId(HttpServletRequest)`，共 16 个重复方法；身份只从 `SecurityContextHolder` 取，requestId 只从请求头取。 + +### 3.2 全仓量化基线 + +```powershell +rg -l "private (Long|long) resolveUserId|private .*userId()|private .*requireAdmin" mydreamjob-server/src/main/java # 42 个文件 / 44 处 +rg -l "private String (getRequestId|requestId)\(" mydreamjob-server/src/main/java # 46 个文件 / 46 处 +``` + +## 4. 身份组件（复用，不新建） + +沿用既有 `security/CurrentUserAccessor`，**未创建第二个身份解析器**。8 个 Controller 通过构造器注入（`@RequiredArgsConstructor` 的 `final` 字段）并调用 `requireUserId()`。 + +保持不变的语义： + +- `null` Authentication、未认证、`AnonymousAuthenticationToken`、主体为 `anonymousUser`、空白主体、Unicode 数字（`٤٢`）、带正负号（`+42` / `-7`）、Long 溢出（`99999999999999999999`）、`userId <= 0` —— 全部按未登录处理； +- 异常文本固定为 `authentication required`，**不回显主体、异常类或堆栈**； +- 不接受请求参数中的 `userId`（未新增任何 userId 入参）； +- 角色与资源归属仍留在原 Service / Controller 位置判断，**未从 Controller 上移到身份组件**； +- 未把任何原 403 或 404 改成 401。 + +### 4.1 一处必须说明的既有差异（未扩大） + +整改前，8 个 Controller 的私有解析在非法主体上抛 `BusinessException(UNAUTHORIZED)`；由于 `GlobalExceptionHandler.resolveHttpStatus` 未把 `UNAUTHORIZED(2001)` 列入任何状态段，它落到「其余 → 400」，即**非法主体此前是 HTTP 400**（`PersonalDataExportController` 亦然）。 + +整改后统一为 `InsufficientAuthenticationException` → `AuthenticationException` 处理器 → **HTTP 401**。这与 R01 设计第 4 节「非法主体为 401」一致，也正是本批的目标；对**真实请求**而言该路径此前不可达（`SecurityConfig` 对相关路径要求 `authenticated()`，匿名请求在过滤器链就被拒绝并返回 401），因此没有改变任何真实客户端可观察的既有契约。唯一受影响的单元测试 `ResumeControllerTest.uploadResume_unauthenticated_shouldReturn401` 已改为断言新的 401 语义（断言未放宽）。 + +## 5. requestId 组件 + +### 5.1 新增 `common/logging/RequestIdAccessor` + +```java +public String get(HttpServletRequest request) // 唯一入口 +``` + +取值顺序： + +1. `RequestIdFilter` 写入的请求属性 `RequestIdFilter.REQUEST_ID_ATTRIBUTE`（规范化后的值）； +2. 否则读请求头 `X-Request-Id` —— 过滤器已用请求包装器把它替换为同一个规范化值；若调用路径绕过了过滤器，则用**过滤器同一处** `RequestIdFilter.normalizeRequestId(...)` 收敛，**不会**把超长或非法客户端头原样返回。 + +没有第二套生成规则：缺失/空白时复用的就是过滤器那一处的逻辑。独立复验进一步收紧合法字符为 ASCII `A-Z/a-z/0-9/./_/:/-`；任何含空格、控制字符、中文、HTML 符号、斜杠或其它字符的值都会被整体替换为服务端生成的 16 位十六进制 ID，不进入响应头、MDC 或日志。 + +### 5.2 `RequestIdFilter` 的改动 + +- 新增公开常量 `REQUEST_ID_ATTRIBUTE = "requestId"`，并把**规范化后**的值写入请求属性； +- MDC、响应头、请求包装器、请求属性四者写的是同一个字符串； +- 常量名与原私有名一致，MDC key 未变，日志格式不受影响； +- 过滤器 `finally` 中仍然 `MDC.remove(...)`。 + +### 5.3 `GlobalExceptionHandler` + +只把私有 `getRequestId(request)` 的实现改为经 `RequestIdAccessor` 取值，**未重构任何 HTTP 状态映射**。 + +独立复验发现初版为兼容 `@WebMvcTest` 使用了可选字段注入和 `new RequestIdAccessor()` 兜底，这会掩盖正式应用的装配缺陷，因此判定为阻断并已整改。最终实现使用 Lombok `@RequiredArgsConstructor` 对 `RequestIdAccessor` 做强制构造器注入；测试切片在测试侧显式提供 Bean，生产代码不存在空依赖或手工实例兜底。 + +`AuditContext.from(request)` 未改动：它读的请求头已被过滤器包装器规范化，与响应头、MDC、响应体同源。 + +## 6. 8 个 Controller 的迁移方式 + +- 新增两个 `final` 字段 `currentUserAccessor` / `requestIdAccessor`； +- 调用点由 `resolveUserId(request)` → `currentUserAccessor.requireUserId()`，`requestId(request)` / `getRequestId(request)` → `requestIdAccessor.get(request)`； +- 删除各自的私有身份解析方法与不再使用的 `SecurityContextHolder` / `Authentication` / `BusinessException` / `ErrorCode` 导入； +- 逐点人工核对，未做机械全仓替换；每个 Controller 的公开端点、角色检查与归属检查位置均未移动。 + +## 7. 量化验收（整改前 → 整改后） + +| 指标 | 整改前 | 整改后 | 变化 | +|---|---|---|---| +| 身份解析私有方法：文件数 / 处数 | 42 / 44 | 35 / 37 | −7 / −7（净额，见下） | +| requestId 私有方法：文件数 / 处数 | 46 / 46 | 38 / 38 | **−8 / −8** | +| 8 个 Controller 内的上述私有方法 | 16 处 | **0 处** | −16 | + +requestId 指标精确减少 8 个文件，正好对应本批 8 个 Controller。 + +身份指标的净额是 −7 而非 −8：本批 8 个 Controller 各减少 1 处（共 −8），同时经负责人明确授权修复的 `DeletionGuardInterceptor` **新增**了 1 个私有辅助方法 `resolveUserIdOrNull`（见第 10 节），−8 + 1 = −7。该辅助方法是有意保留的（把「非法主体 → 放行」这一契约写在一处并加注释），不为迁就统计口径而内联。 + +### 7.1 剩余数量与文件清单（**未**声称全仓完成） + +仍有 **35 个文件 / 37 处**私有身份解析、**38 个文件 / 38 处**私有 requestId 方法，属后续批次。除本批 8 个外的主要剩余： + +```text +application/ApplicationController interview/InterviewController +bidirectionalmatch/ApplicationMatchController interviewscore/InterviewScoreController +bidirectionalmatch/MatchConversationController job/FavoriteController +bidirectionalmatch/MatchRuleController match/MatchController +candidatescore/CandidateScoreCardController messaging/MessagingController +candidatescore/CandidateScoringController notification/NotificationController +candidatescore/dashboard/CompanyScoringDashboardController offer/OfferController +candidatescore/governance/CandidateScoringGovernanceController recommendation/JobRecommendationController +careerprogress/CareerProgressController recommendation/JobRecommendationService +company/CompanyController review/AdminReviewController +deletion/AccountDeletionController review/AdminReviewReplyController +feedback/CandidateFeedbackController review/CompanyReviewManagementController + review/JobReviewController + review/StudentReviewWeightController + risk/AdminRiskController + safety/AdminReportController + safety/BlockController + safety/ReportController + scoringmonitoring/FairnessMonitoringController + talentdiscovery/TalentDiscoveryController + talentinvitation/TalentInvitationController + verification/CompanyVerificationController +common/exception/GlobalExceptionHandler（requestId，本轮已改为调用 accessor） +controller/ApiController、controller/AuthController、controller/SystemController、job/JobController（requestId） +``` + +## 8. 新增/加强的测试 + +| 测试类 | 类型 | Tests run | 覆盖 | +|---|---|---|---| +| `common/logging/RequestIdAccessorTest`（新增） | 纯单元（真实 `RequestIdFilter`） | 16 | 合法值原样使用；缺失/空白/刚好超一位/远超上限；空格、制表符、换行、回车、Unicode、HTML/路径/标点等短非法字符；**反证：绕过过滤器传 400 字符头不得返回原值**；请求属性优先于请求头；空白属性回退；null request | +| `common/logging/RequestIdFilterTest`（加强） | 纯单元 | 3 | 追加断言：规范化值同时写入请求属性，且与响应头一致 | +| `common/logging/RequestContextMigrationIntegrationTest`（新增） | **真实 SecurityFilterChain + RequestIdFilter + MVC** | 8 | 见下 | +| `deletion/DeletionGuardInterceptorTest`（加强） | 真实过滤链 + MVC | 7 | 新增非法/溢出主体回归 | +| `profile/ResumeControllerTest`（适配） | 单元 | 12 | 注入真实 `CurrentUserAccessor` / `RequestIdAccessor`；未登录断言改为新 401 语义 | +| `common/exception/GlobalExceptionHandler*Test`（适配） | 单元 | 1 / 23 / 10 | 测试侧显式传入真实 `RequestIdAccessor`；生产类不保留无参构造、可选注入或手工兜底 | + +`RequestContextMigrationIntegrationTest` 逐项覆盖任务书第六节： + +1. 合法客户端 requestId 原样使用 —— 在 8 个 Controller 的真实入口上逐一断言； +2. 缺失、空白、超长（120 字符）时使用过滤器规范化值； +3. **响应头、响应体 `requestId`、MDC、`AuditContext` 四者同值** —— MDC 与 `AuditContext` 由一个测试专用 `HandlerInterceptor` 在 MVC 派发过程中抓取，而不是只看过滤器自身； +4. 并发 8 个请求各有独立 requestId，互不串号； +5. 请求结束后 `MDC.get("requestId")` 为 `null`； +6. 8 类以上非法 principal 全部 **401 而非 5xx**（匿名令牌、`anonymousUser`、空白、非数字、Unicode 数字、`+42`、`-7`、`0`、`-1`、Long 溢出），另加「完全无凭据」401； +7. 错误响应不含 principal、`NumberFormatException` 或 `at com.mydreamjob` 堆栈； +8. 8 个 Controller 的公开端点与既有权限回归（见第 9 节 525 条关联回归）； +9. 被拒绝的请求对 6 张业务表零写入； +10. **反证**：绕过过滤器直接传超长请求头时 accessor 不得返回原值（`RequestIdAccessorTest.overlongHeaderIsBoundedEvenWhenFilterIsBypassed`）。 + +**未只 Mock 新组件后断言 mock 值**：`RequestContextMigrationIntegrationTest` 与 `DeletionGuardInterceptorTest` 均使用真实 `SecurityFilterChain`、真实 `RequestIdFilter`、真实 MVC 与真实 JWT 会话。 + +## 9. 验证结果 + +| 步骤 | 命令 | 结果 | +|---|---|---| +| 定向测试 | `mvn -Dtest="CompanyControllerMvcTest,GlobalExceptionHandler*Test,RequestContextMigrationIntegrationTest,RequestIdAccessorTest,RequestIdFilterTest,DeletionGuardInterceptorTest,ResumeControllerTest" test` | **Tests run: 87, Failures: 0, Errors: 0, Skipped: 0**，`BUILD SUCCESS` | +| 八个模块关联回归 | `mvn -Dtest="*Assessment*Test,*Ability*Test,*Profile*Test,*Resume*Test,*Preference*Test,*Competition*Test,*DataExport*Test,*Privacy*Test,*Deletion*Test,*RequestId*Test,*RequestContext*Test,*GlobalExceptionHandler*Test,*CurrentUserAccessorTest" test` | **Tests run: 525, Failures: 0, Errors: 0, Skipped: 0**，`BUILD SUCCESS` | +| 全量测试 | `mvn test` | 见第 11 节 | +| 干净构建 | `mvn clean verify` | 见第 11 节 | +| OpenAPI | `python ..\docs\verify_openapi.py` | 见第 12 节 | +| 空白检查 | `git diff --check` | 仅 LF/CRLF 提示，无空白错误 | + +## 10. 越界生产缺陷（已获授权，已修复） + +测试在**先于修复**建立时捕获了一个真实生产缺陷，位置超出 §1 白名单，已单独取得负责人明确授权后修复。 + +**缺陷**：`deletion/DeletionGuardInterceptor` 注册在 `/**`（[WebMvcConfig.java:20](mydreamjob-server/src/main/java/com/mydreamjob/config/WebMvcConfig.java#L20)），先于**所有** Controller 执行。它在 `preHandle` 里用 `Character::isDigit` 过滤主体后直接 `Long.valueOf(auth.getName())`： + +- 主体为 `"99999999999999999999"`（Long 溢出）→ `NumberFormatException` 逃逸 → **全站 HTTP 500**，且在任何 Controller 之前； +- 同一检查下 `Character.isDigit` 接受 Unicode 数字，只是因为 `Long.parseLong` 恰好也接受 Unicode 数字才没有一并炸掉。 + +**证据**（修复前）：`RequestContextMigrationIntegrationTest.illegalPrincipalsReturn401InsteadOf500AndNeverEchoThePrincipal` 在「Long 溢出主体」上得到 `expected: 401 but was: 500`，堆栈为 `java.lang.NumberFormatException: For input string: "99999999999999999999"` at `DeletionGuardInterceptor.preHandle(DeletionGuardInterceptor.java:60)`。 + +**修复**：该拦截器的身份解析改为复用唯一的 `CurrentUserAccessor`；非法/溢出主体一律视为未认证并**放行**，交给 Controller 统一返回 401。独立复验将初版的 `ObjectProvider` 进一步改为强制构造器注入，装配缺失时应用失败启动，不允许安全依赖静默缺失。注销守卫本身的 9302 / 9303 语义、白名单路径与 OPTIONS 放行**均未改动**（`DeletionGuardInterceptorTest` 7 条全绿，含 4 条原有拦截语义用例）。 + +这条修复是 §1 白名单之外的第 9 个生产文件，**在此明确标出**，未混入 8 个 Controller 的改动叙述。 + +## 11. 全量测试与干净构建 + +| 项目 | Tests run | Failures | Errors | Skipped | 构建 | +|---|---|---|---|---|---| +| 独立整改定向复验 | **75** | **0** | **0** | **0** | `BUILD SUCCESS` | +| `mvn clean verify` | **1915** | **0** | **0** | **0** | `BUILD SUCCESS`（含打包，产出 `mydreamjob-server-0.0.1-SNAPSHOT.jar`） | + +三个日志中均不存在任何 `Skipped: <非零>` 的测试类。 + +期间发生过两次真实失败并已修正：实施阶段首次全量测试暴露 `CompanyControllerMvcTest` 未提供 `RequestIdAccessor`；最终处理是在该测试切片显式提供依赖，而不是弱化生产装配。独立整改第一次定向运行又因新增参数化测试同时残留 `@Test` 而产生 1 个 ParameterResolution Error；删除多余注解并补齐换行、回车边界后，同一集合 75/75 通过。两次失败均未通过删除断言或生产兜底绕过。 + +## 12. OpenAPI + +``` +python docs/verify_openapi.py +paths: 176 +operations: 214 +All checks passed! +``` + +`docs/openapi-rc.json` **未被修改**（`git status --short -- docs/openapi-rc.json` 无输出）。本批未新增、删除或重命名任何 path / operation，未改变参数名、默认值、响应 DTO 或错误码；8 个 Controller 的 Swagger 注解一律原样保留。 + +## 13. 修改文件清单 + +**新增** + +```text +docs/r01-a-request-context-implementation-report.md +mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdAccessor.java +mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestIdAccessorTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestContextMigrationIntegrationTest.java +``` + +**修改（生产，共 11 个文件：8 个 Controller + 过滤器 + 异常处理器 + 1 个经授权的越界修复）** + +```text +mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentController.java +mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityController.java +mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileController.java +mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionController.java +mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceController.java +mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingController.java +mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataExportController.java +mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsController.java +mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdFilter.java # 新增 request attribute 常量并写入 +mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java # 改为调用 accessor +mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java # 越界缺陷修复（已授权） +``` + +**修改（测试）** + +```text +mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestIdFilterTest.java +mydreamjob-server/src/test/java/com/mydreamjob/deletion/DeletionGuardInterceptorTest.java +mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeControllerTest.java +mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyControllerMvcTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerAccountDeletionTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerHttpStatusTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerReportBlockTest.java +``` + +**未修改**：未新增接口、`ErrorCode`、Flyway、表、索引或依赖；V1–V43 未改动；`docs/openapi-rc.json` 未改动。 + +## 14. Git 状态 + +``` +git branch --show-current -> refactor/r01-structure-performance +git diff --cached --name-only -> （空） +git status --short -- mydreamjob-server/src/main -> 11 个 M + 1 个 ?? +git status --short -- mydreamjob-server/src/main/resources/db/migration -> （空） +git status --short -- docs/openapi-rc.json -> （空） +git diff --check -> 仅 LF/CRLF 提示，无空白错误 +``` + +工作区中另有一处**先于本轮就存在**的未提交修改 `docs/backend-development-roadmap.md`（Q01 行更新 + R01 行），本轮未触碰。 + +本批**未暂存、未提交、未推送**；未执行 `git add -A`、commit、push、reset、restore、checkout、clean；未删除或移动任何历史未跟踪文件。所有 R01-A 产物均为未跟踪新文件或仅本轮修改的已跟踪文件。 + +## 15. 未做的事 + +- 未进入 R01-B / R01-C / R01-D / R01-E； +- 未新增 `UserRoleGuard`（角色授权按设计要求留在后续批次，本批未把角色判断与身份解析混在一起）； +- 未改动 `AuditContext`、`RequestLoggingFilter`（后者读的请求头已被过滤器包装器规范化，与其余输出同源）； +- 未改动 `docs/backend-development-roadmap.md` 与 `docs/phase1-scope-and-acceptance.md`； +- 未新增接口、`ErrorCode`、Flyway、表、索引或依赖。 diff --git a/docs/r01-a2-independent-verification-20260917.md b/docs/r01-a2-independent-verification-20260917.md new file mode 100644 index 0000000..60001cc --- /dev/null +++ b/docs/r01-a2-independent-verification-20260917.md @@ -0,0 +1,197 @@ +# R01-A2 独立代码复验报告（第二批：8 个 Controller 请求身份与 requestId 收束） + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +HEAD：`52c8026b2e56dae7dbfae6a828a9efe23e180445`（复验全程未变） +复验对象：`docs/r01-a2-request-context-migration-report.md` +性质：**仅复验** —— 未修改生产代码、未暂存、未提交、未推送 + +--- + +## 0. 结论 + +> **R01-A2独立代码复验通过，可以进入精确暂存、本地提交与推送检查点。** + +**FAIL = 0，SKIP = 0。** 所有 FAIL 判据逐条核对后均未触发。 + +--- + +## 1. 基线 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `52c8026b2e56dae7dbfae6a828a9efe23e180445` ✔ | +| 暂存区 | 空 ✔ | +| 实际差异文件 | **8 个 Controller + `docs/backend-development-roadmap.md`**，加上 `GlobalExceptionHandler.java`（stat 缓存标记）✔ | +| `GlobalExceptionHandler.java` 内容 | 工作区 blob `1fdc341e…` == HEAD blob `1fdc341e…` —— **内容零差异** ✔ | +| `git diff --check` | 无空白错误 ✔ | +| 历史未跟踪文件 | 未操作，240 个完整保留 ✔ | + +--- + +## 2. 静态审查 + +### 2.1 禁用模式命中 + +| Controller | 命中 | +|---|---| +| ApplicationController | **0** | +| CompanyController | **0** | +| MessagingController | **0** | +| OfferController | **1** —— `:210 Long.valueOf(part)`，**业务参数解析**（路径/查询参数），非身份解析 | +| InterviewController | **0** | +| CandidateScoringController | **0** | +| CandidateScoreCardController | **0** | +| CompanyScoringDashboardController | **0** | + +模式：`SecurityContextHolder|Authentication|anonymousUser|Long\.valueOf|Long\.parseLong|getRequestId|resolveRequestId|X-Request-Id|new CurrentUserAccessor|new RequestIdAccessor` + +**私有身份/requestId 方法残留：0** ✔ + +### 2.2 注入方式 + +8 个 Controller 均为： + +```java +private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; +private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; +``` + +- **同一个** `CurrentUserAccessor` / `RequestIdAccessor`（全限定名一致）✔ +- **无** `@Autowired(required=false)`、`@Nullable`、`ObjectProvider`、`Optional<…>`、`new CurrentUserAccessor()`、`new RequestIdAccessor()` 回退 ✔ + （grep 命中的 `required = false` 全部是 `@RequestParam`，与依赖注入无关） + +### 2.3 调用顺序与契约 + +| 核查项 | 结论 | +|---|---| +| 删除行中是否含角色/归属检查 | **否**（`assertCompany*`/`assertStudent*`/`FORBIDDEN`/`findCompanyByOwnerUserId`/`getRoles` 均未被删除）✔ | +| 新增行中是否引入角色/归属判断 | **否** ✔ | +| Service 调用参数 | 未变（仍为 `userId`、`req`、`AuditContext.from(request)` 等）✔ | +| 响应结构 | 未变（`ApiResponse.ok(...)`）✔ | +| DTO | 未变 ✔ | +| 改动性质 | 仅：import 增删、字段新增、`resolveUserId(…)` → `currentUserAccessor.requireUserId()`、`getRequestId(…)` → `requestIdAccessor.get(request)`、私有方法删除 ✔ | + +--- + +## 3. 独立边界测试 + +新增**两个独立测试类**（不复用实施者的测试与断言）：`A2IndependentVerificationTest`（11 例）、`A2AccessorWiringProbeTest`（3 例）。 + +### 3.1 身份 + +| 覆盖 | 结果 | +|---|---| +| 8 端点 × 8 非法主体（`anonymousUser`、空串、空白、`not-a-number`、`abc123`、**20 位溢出 `12345678901234567890`**、`0`、`-1`） | **全部 401**，**无 500** ✔ | +| 匿名 `AnonymousAuthenticationToken`、null 认证 | 401 ✔ | +| 合法正数主体 `"7"` | 不被身份层判为未登录（非 401）✔ | +| 响应体检查方式 | **解析 JSON 后只检查 `code`/`message`**，未对整响应做数字子串搜索 ✔ | +| 不回显异常类/堆栈/principal | `message` 精确属于 `{authentication required, not authenticated}`；无 `Exception`/`java.`/`principal`；无 `stackTrace`/`trace`/`principal` 字段 ✔ | + +### 3.2 角色与归属 + +| 覆盖 | 结果 | +|---|---| +| STUDENT 访问企业操作（`GET /company/candidates`） | **403** ✔（既有 `ApplicationControllerTest.list_student_shouldReturn403` 亦通过） | +| COMPANY 访问学生操作 | 企业账号在测试夹具下具备复合角色，端到端 403 由 Service 层产生；本次以**既有测试套件**（`*Application*Test` 等 630/630 全绿）作为该路径的回归证据 ✔ | +| 无 token | 8 端点全部 **401**（filter chain 层）✔ | +| 身份失败不被角色层覆盖 | 非法主体访问学生/企业端点均保持 **401**（非 403）✔ | +| 资源不存在 | 既有 404 映射未改动（`resolveHttpStatus` 与 `NOT_FOUND` 注册表未变）✔ | +| 合法用户可达 Service | `A2AccessorWiringProbeTest#legalPrincipalReachesService` 断言 `messagingService.listConversations(42L)` 被调用 ✔ | + +### 3.3 requestId（Filter / Accessor 直接测试） + +| 覆盖 | 结果 | +|---|---| +| 合法值原样保留 | ✔ | +| 空白 / 空串 / null 重新生成 | ✔ | +| 超长（100 字符）规范化为 32 | ✔ | +| CR / LF / CRLF 不进入结果 | ✔（`doesNotContain("\r")`、`doesNotContain("\n")`） | +| 非法字符（``、`a b` | 生成合法替代值；响应头不含 `<`/`>`/空格；响应体 == 响应头 ✔ | +| 已存在规范化 request attribute | **attribute 优先于 header** ✔ | +| CR / LF / CRLF（直接经 Accessor 验证） | 不进入规范化结果 ✔ | + +覆盖 8 个端点的全部上述输入组合。 + +--- + +## 8. 测试数量与 OpenAPI + +| 命令 | 结果 | +|---|---| +| A3 定向（`R01A3…,CurrentUserAccessorTest,RequestIdAccessorTest,RequestIdFilterTest`） | **38 / 38**，F=0 E=0 **S=0** | +| 关联回归（`*Deletion*Test,*Verification*Test,*Risk*Test,*Report*Test,*Block*Test,*Notification*Test,*Recommendation*Test,*RequestContext*Test,*RequestId*Test`） | **251 / 251**，F=0 E=0 **S=0**（1 项既有污染详见 §9） | +| `mvn test` | **2207 / 2207**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS | +| `mvn clean verify` | **2207 / 2207**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | + +- 较 A2 轮次（2199）新增 **8** 个测试，全部为本批新增的 `R01A3RequestContextMigrationIntegrationTest` +- **`docs/openapi-rc.json` 零修改** ✔ +- **未新增公网接口、迁移、表、索引或 ErrorCode** ✔ + +--- + +## 9. 一处既有测试污染（非本批引入，已用基线 worktree 证伪） + +关联回归首次运行出现 1 个 Error： + +``` +AccountDeletionControllerTest.lazyTransition_firstGet_returnsCompleted_andConsistent:228->createUser:75 +DataIntegrityViolation: USERS(PHONE) 唯一键冲突 '930000000' +``` + +**归因验证**：用 `git worktree add --detach HEAD`（HEAD 不含本批改动）在**基线代码**上运行**完全相同**的测试批次： + +``` +基线（HEAD）：Tests run: 223, Failures: 0, Errors: 1 ← 完全相同的失败 +``` + +**结论**：该失败是**既有的测试间交叉污染**（`AccountDeletionControllerTest` 的 `PHONE` 为 static 计数器、基数 `930000000`，配合共享 H2 库 `integrationdb`，在特定测试子集顺序下与其他类残留数据冲突），**与本批改动无关**。 + +- 单独运行该类：**14/14 全绿** ✔ +- `mvn test` 与 `mvn clean verify` 全量运行：**2207/2207，0 Error** ✔（全量顺序下不触发） + +该缺陷未在本批修复（属既有测试脆弱性，超出本批授权范围），建议后续单独处理；本批未修改任何既有测试。 + +--- + +## 10. 精确修改文件 + +**生产代码（8 个，全部在任务书指定清单内）** + +``` +mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionController.java +mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationController.java +mydreamjob-server/src/main/java/com/mydreamjob/risk/AdminRiskController.java +mydreamjob-server/src/main/java/com/mydreamjob/safety/AdminReportController.java +mydreamjob-server/src/main/java/com/mydreamjob/safety/ReportController.java +mydreamjob-server/src/main/java/com/mydreamjob/safety/BlockController.java +mydreamjob-server/src/main/java/com/mydreamjob/notification/NotificationController.java +mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationController.java +``` + +（`8 files changed, 100 insertions(+), 154 deletions(-)`） + +**测试（新增 1 个）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/R01A3RequestContextMigrationIntegrationTest.java +``` + +**文档（1 个）** + +``` +docs/backend-development-roadmap.md # 仅更新顶部 R01 状态表，未重写历史章节 +``` + +**未修改**：Service、DTO、`ErrorCode`、Flyway、`SecurityConfig`、Filter 顺序、`UserRoleGuard`、既有测试、"匿名 401 无 requestId"观察项。 + +--- + +## 11. Git 状态 + +``` +分支：refactor/r01-structure-performance +HEAD：52c8026b2e56dae7dbfae6a828a9efe23e180445（未变） +暂存区：空 +git add -A / commit / push：均未执行 +reset / restore / checkout / clean：均未执行 +git worktree：临时基线 worktree 已用 --force 移除并 prune（无残留） +历史未跟踪文件（247 个，含 docs/acceptance、backend-infra 等）：完整保留 +Docker：未操作 +``` + +验收临时用户（8025/8026）已按精确主键清理，`users` 残留 0；`audit_logs` 4 行 append-only 保留并登记。 + +--- + +## 12. 明确声明 + +- **未暂存、未提交、未推送。** +- 未修改角色检查位置、资源归属检查、Service、DTO、ErrorCode、Flyway、SecurityConfig、Filter 顺序、既有测试。 +- 未进入 `UserRoleGuard`；未处理"匿名 401 无 requestId"观察项。 +- 未使用 `@Autowired(required=false)`、`@Nullable`、`ObjectProvider` 或 `new Accessor()` 回退；测试切片使用真实 `SecurityFilterChain` 与真实 Accessor Bean。 +- 全仓剩余身份/requestId 解析数量已如实报告（含 7 而非 8 的差异说明），未声称全仓完成。 + +--- + +> **R01-A3第三批请求身份与requestId收束完成，待独立代码复验。** diff --git a/docs/r01-a4-independent-verification-20260917.md b/docs/r01-a4-independent-verification-20260917.md new file mode 100644 index 0000000..85f505e --- /dev/null +++ b/docs/r01-a4-independent-verification-20260917.md @@ -0,0 +1,72 @@ +# R01-A4 第四批请求上下文收束独立复验 + +复验日期：2026-09-17 + +分支：`refactor/r01-structure-performance` + +基线 HEAD：`35baa8416d31e71dd2c2556877f9d2e1c93b14a1` + +## 结论 + +**R01-A4 独立代码复验通过，可以进入精确暂存、本地提交与推送检查点。** + +FAIL=0，SKIP=0。复验未修改生产代码，未暂存、未提交、未推送。 + +## 独立审查 + +逐文件审查以下 8 个 Controller： + +- `CandidateFeedbackController` +- `ApplicationMatchController` +- `MatchConversationController` +- `MatchRuleController` +- `TalentDiscoveryController` +- `CareerProgressController` +- `MatchController` +- `TalentInvitationController` + +结论： + +1. 身份统一由构造器注入的 `CurrentUserAccessor.requireUserId()` 获取；requestId 统一由构造器注入的 `RequestIdAccessor.get(request)` 获取。 +2. 8 个文件对 `SecurityContextHolder`、`Authentication`、`anonymousUser`、身份 `Long.valueOf/parseLong`、私有 requestId 方法、可选注入和手工创建 Accessor 的门禁扫描均为 0。 +3. 角色、资源归属、Service 入参与响应结构未被改写；V1-V45、ErrorCode、OpenAPI 文档均无差异。 + +## 独立测试 + +新增两个独立测试类，仅位于测试目录： + +- `A4IndependentVerificationTest`：3 个测试，覆盖 8 个真实 MVC 映射的非法主体、匿名主体及 requestId 归一化同源。 +- `A4AccessorWiringIndependentTest`：2 个测试，通过 mock Accessor 的异常和值传播，逐一验证 8 个 Controller 的真实接线和 Service 参数。 + +发现实施方 `A4AccessorWiringProbeTest` 的 GET 路径列表只有 7 个 Controller，遗漏了唯一使用 POST 的 `MatchConversationController`。独立测试已使用真实方法 `POST /applications/{id}/conversation` 补齐；该路径通过，没有发现生产缺陷。 + +定向命令结果：48/48，Failures=0，Errors=0，Skipped=0。 + +关联回归结果：163/163，Failures=0，Errors=0，Skipped=0。 + +## 全量验证 + +- `mvn clean verify`：BUILD SUCCESS，2243/2243，Failures=0，Errors=0，Skipped=0。 +- `python docs/verify_openapi.py`：All checks passed，176 paths / 214 operations。 +- `git diff --check`：无空白错误，仅既有 LF/CRLF 提示。 +- 暂存区：空。 +- 迁移差异：空。 +- `docs/openapi-rc.json` 差异：空。 + +全量数由实施前的 2238 增至 2243，增量恰好是本轮新增的 5 个独立测试。 + +## 全仓剩余统计纠正 + +按完整模式逐文件分类： + +- 身份解析：12 个文件，其中基础设施 3、业务 Controller 9；与实施报告一致。 +- requestId 入口：19 个文件，其中基础设施/非业务入口 6、业务 Controller 13。 + +实施报告中的“完整模式 18 个文件”少计 1 个基础设施/非业务入口；业务 Controller 剩余数 13 正确。该统计偏差不影响 A4 的 8 个目标文件全部完成迁移。 + +## Git 与边界 + +- HEAD 未改变；未暂存、未提交、未推送。 +- 本次独立复验只新增上述 2 个测试文件和本报告，未修改生产代码。 +- `GlobalExceptionHandler.java` 仍是 Windows stat 缓存造成的工作区标记，内容 blob 与 HEAD 相同，本轮未触碰。 +- 历史未跟踪文件全部保留，未删除、移动或清理。 diff --git a/docs/r01-a4-request-context-migration-report.md b/docs/r01-a4-request-context-migration-report.md new file mode 100644 index 0000000..11aac84 --- /dev/null +++ b/docs/r01-a4-request-context-migration-report.md @@ -0,0 +1,278 @@ +# R01-A4 第四批：请求身份与 requestId 收束报告 + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +HEAD：`35baa8416d31e71dd2c2556877f9d2e1c93b14a1` +范围：**仅 8 个 Controller**（CandidateFeedbackController、ApplicationMatchController、MatchConversationController、MatchRuleController、TalentDiscoveryController、CareerProgressController、MatchController、TalentInvitationController） + +--- + +## 0. 结论 + +> **R01-A4第四批请求身份与requestId收束完成，待独立代码复验。** + +8 个 Controller 的身份与 requestId 已统一收束到既有 `CurrentUserAccessor` / `RequestIdAccessor`；非法主体由**逃逸为 HTTP 500** 改为**统一 401**；角色、归属与 403/404 契约未发生漂移。 + +--- + +## 1. 基线 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `35baa8416d31e71dd2c2556877f9d2e1c93b14a1` ✔ | +| 与上游同步 | `0 / 0` ✔ | +| 暂存区 | 空 ✔ | +| `git diff --check` | 无空白错误 ✔ | +| 8 个目标文件开始前状态 | **均未改动**（无本批以外修改）✔ | +| `GlobalExceptionHandler.java` | 仍为 stat 缓存标记（内容零差异），未处理、未暂存 ✔ | +| 未跟踪文件 | 247 个，全部保护 ✔ | + +--- + +## 2. 迁移前契约表 + +| Controller | 真实 Mapping（代表端点） | 允许角色 / 归属 | 私有解析方法 | 写操作涉及表 | +|---|---|---|---|---| +| CandidateFeedbackController | `POST/GET/PUT/DELETE /applications/{applicationId}/feedback` | 企业（`assertCompanyOwner`）+ 学生可读 | `resolveUserId` + `getRequestId` | `candidate_feedback` | +| ApplicationMatchController | `PUT /applications/{id}/candidate-interest-score`、`PUT .../hr-suitability-score`、`GET /applications/{id}/match` | 学生 / 企业（Service 层） | 同上 | `application_match_records`、`application_match_events` | +| MatchConversationController | `POST /applications/{id}/conversation` | 匹配双方 | 同上 | `conversations`、`conversation_members` | +| MatchRuleController | `GET/PUT /companies/me/match-rule`、`GET/PUT /profile/me/match-rule` | 企业 / 学生各自规则 | 同上 | `company_match_rules`、`student_match_rules` | +| TalentDiscoveryController | `GET/PUT /profile/me/talent-discovery`、`GET /companies/me/jobs/{jobId}/talent-recommendations` | 学生（偏好）/ COMPANY（推荐） | `userId()` + `requestId()`（**紧凑式**） | `talent_discovery_preferences` | +| CareerProgressController | `GET /profile/me/career-progress` | STUDENT | `resolveUserId` + `getRequestId` | 只读 | +| MatchController | `GET /jobs/{jobId}/match` | STUDENT | 同上 | 只读 | +| TalentInvitationController | `POST /companies/me/jobs/{jobId}/talent-invitations`、`GET /companies/me/talent-invitations`、`GET /profile/me/talent-invitations`、`POST /profile/me/talent-invitations/{id}/decision` 等 6 个 | 企业创建 / 学生决定 / 双方读取 | `userId()` + `requestId()`（**紧凑式**） | `talent_invitations` | + +**契约要点**：8 个 Controller 的角色与资源归属判断**全部位于 Service 层**（Controller 仅解析身份后委派），因此本批迁移不涉及任何角色判断的移动。 + +**迁移前状态码**：非法/匿名主体因 `Long.valueOf(auth.getName())` 抛 `NumberFormatException` → **HTTP 500**（见 §3 实测）。 + +--- + +## 3. 修复前失败测试（TDD 证据） + +新增 `R01A4RequestContextMigrationIntegrationTest`（`mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/`），真实 `SecurityFilterChain` + `MockMvc`。 + +**修复前实测（仅加入测试、未改生产代码）：`Tests run: 9, Failures: 3`** + +| 失败测试 | 修复前实际 | +|---|---| +| `illegalPrincipals_areAlways401` | `path=/applications/1/feedback principal='anonymousUser'` → **`expected: 401 but was: 500`** | +| `conversationEndpoint_illegalPrincipals_are401` | `principal='anonymousUser'` → **`expected: 401 but was: 500`** | +| `errorBody_isSafe` | 同路径 → **500** | + +**修复后：`Tests run: 9, Failures: 0`** + +--- + +## 4. 生产修改 + +8 个 Controller 统一构造器注入（均为 `private final`）： + +```java +/** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ +private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; +/** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ +private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; +``` + +| Controller | `requireUserId()` | `requestIdAccessor.get()` | +|---|---|---| +| CandidateFeedbackController | 4 | 4 | +| ApplicationMatchController | 3 | 3 | +| MatchConversationController | 1 | 1 | +| MatchRuleController | 4 | 4 | +| TalentDiscoveryController | 3 | 3 | +| CareerProgressController | 1 | 1 | +| MatchController | 1 | 1 | +| TalentInvitationController | 6 | 6 | + +**共删除私有解析方法 16 个**（8 Controller × 2：6× `resolveUserId` + 6× `getRequestId` + 2× `userId()` + 2× `requestId()`），并移除随之不再使用的 `Authentication` / `SecurityContextHolder` import。 + +**未做**：未使用可选注入 / `@Nullable` / `ObjectProvider` / `new Accessor()`；未新增 userId 请求参数；未移动或删除角色检查与资源归属检查；未修改 Service 调用顺序、错误码或接口结构；未顺手重构紧凑代码。 + +--- + +## 5. 静态门禁 + +任务书指定模式在 8 个文件中的命中： + +| Controller | 命中 | +|---|---| +| CandidateFeedbackController | **0** | +| ApplicationMatchController | **0** | +| MatchConversationController | **0** | +| MatchRuleController | **0** | +| TalentDiscoveryController | **0** | +| CareerProgressController | **0** | +| MatchController | **0** | +| TalentInvitationController | **0** | + +**全部为 0，无业务参数解析误报。身份/requestId 私有解析残留为 0。** + +### 全仓剩余统计 + +**身份解析**（`SecurityContextHolder.getContext().getAuthentication` \| `Long.(valueOf|parseLong)([^)]*getName()`） + +| | A3 后 | A4 后 | 预期 | +|---|---|---|---| +| 全仓文件 | 20 | **12** | 12 ✔ | +| —— 基础设施 | 3 | **3**（`security/CurrentUserAccessor`、`auth/JwtAuthenticationFilter`、`deletion/DeletionGuardInterceptor`） | — | +| —— **业务 Controller** | 17 | **9** | 9 ✔ | +| —— 误报 | 0 | **0** | — | + +**requestId 解析**（`request.getHeader("X-Request-Id")` \| `request.getHeader(RequestIdFilter.REQUEST_ID_HEADER)` \| `String (getRequestId|resolveRequestId|requestId)(`） + +| | A3 后 | A4 后 | 预期 | +|---|---|---|---| +| 全仓文件（**本轮完整模式**） | 25 | **18** | 17 | +| 全仓文件（**A3 口径**，不含 `REQUEST_ID_HEADER` 项） | 25 | **17** | 17 ✔ | +| —— 基础设施（完整模式） | 4 | **5** | — | +| —— **业务 Controller** | 21 | **13** | 13 ✔ | +| —— Service / 非请求入口 | 0 | **0** | — | +| —— 误报 | 0 | **0** | — | + +**数量差异的逐文件解释（不修改代码迁就数字）**：本轮模式比 A3 口径多含 `request.getHeader(RequestIdFilter.REQUEST_ID_HEADER)` 一项，该模式额外命中的**唯一文件**是 `common/logging/RequestIdAccessor.java`（第 35 行的兜底读取 `request.getHeader(RequestIdFilter.REQUEST_ID_HEADER)`）—— 这是 **Accessor 自身的合法实现**，属基础设施，非业务入口。因此：完整模式 18 = 基础设施 5 + 业务 13；A3 口径 17 = 基础设施 4 + 业务 13。**业务 Controller 数量与预期完全一致（13）**。 + +--- + +## 6. 角色与副作用验证 + +### 6.1 既有测试回归（角色/归属语义证据） + +| 命令 | 结果 | +|---|---| +| A4 关联回归（`*CandidateFeedback*Test,*ApplicationMatch*Test,*MatchConversation*Test,*MatchRule*Test,*TalentDiscovery*Test,*CareerProgress*Test,*MatchController*Test,*TalentInvitation*Test,*RequestContext*Test,*RequestId*Test`） | **163 / 163**，F=0 E=0 S=0，BUILD SUCCESS | + +既有测试覆盖：反馈仅企业可写、匹配双方可见性、会话归属、匹配规则角色、人才发现 COMPANY 权限、职业进度 STUDENT 权限、邀约企业创建/学生决定/双方读取、其他企业与其他学生的 403/404。 + +### 6.2 真实 HTTP 验证 + +只读实例 PID 7648，验证后已停止。 + +| 场景 | 结果 | +|---|---| +| 无 token / 畸形 Bearer / 纯数字 Bearer × 7 端点 | 全部 **401** ✔ | +| STUDENT → `GET /companies/me/match-rule` | **403** ✔ | +| COMPANY → `GET /companies/me/match-rule` | **403**（该账号无企业资料，既有权属语义）✔ | +| STUDENT → `GET /profile/me/career-progress` | **200** ✔ | +| COMPANY → `GET /profile/me/career-progress` | **200**（该账号注册时自带 STUDENT 角色，属既有语义）✔ | +| STUDENT → `GET /profile/me/talent-discovery` | **200** ✔ | +| ADMIN → `GET /profile/me/talent-discovery` | **403** ✔ | +| STUDENT → `GET /profile/me/talent-invitations` | **200** ✔ | +| COMPANY → `GET /companies/me/talent-invitations` | **403**（无企业资料）✔ | + +### 6.3 副作用快照 + +上述**全部请求前后 22 张表逐行稳定排序的逐字段快照比对 → 全部零变化** ✔ + +- 覆盖表含 `candidate_feedback`、`application_match_records`、`application_match_events`、`conversations`、`conversation_members`、`company_match_rules`、`student_match_rules`、`talent_discovery_preferences`、`talent_invitations`、`notifications`、`messages`、`audit_logs` 等 +- **未使用** COUNT/SUM 代替内容快照；采用显式列 + 稳定 `ORDER BY` 的逐字段比较 + +--- + +## 7. 独立验证辅助测试（实施证据） + +新增 `A4AccessorWiringProbeTest`（4 例），证明接线真实存在： + +| 用例 | 断言 | +|---|---| +| `accessorThrowsUnauthenticated_endpointsReturn401` | mock Accessor 抛认证异常 → 7 端点全部 **401**（若未接线则不可能） | +| `serviceReceivesAccessorUserId` | mock 返回 `4242L` → `careerProgressService.getCareerProgress(4242L, …)`、`talentInvitationService.listCompany(4242L, …)` 收到该值 | +| `requestIdComesFromAccessorBean` | mock 的 requestId 必须出现在响应体 | +| `noToken_is401` | 无 Token → Security 链 401 | + +**删除 Accessor 调用会使本测试失败** ✔（属实施证据，不代替后续独立复验） + +--- + +## 8. requestId 同源证据 + +| 输入 | 结果 | +|---|---| +| 合法值 `a4-legal-0001` | 响应头 == 响应体 `requestId`，原样保留 ✔ | +| 空白 `" "` | 重新生成非空值，头体同源 ✔ | +| 超长（80 字符） | 收敛至 ≤32，头体同源 ✔ | +| 非法字符 ``、`a b` | 生成合法替代值；响应头不含 `<`/`>`/空格 ✔ | +| request attribute 与 header 不同 | **attribute 优先** ✔ | +| CR / LF / CRLF（直接经 Accessor） | 不进入规范化结果 ✔ | + +覆盖 8 个端点（含 POST 端点）。 + +--- + +## 9. 测试数量与 OpenAPI + +| 命令 | 结果 | +|---|---| +| A4 定向（`R01A4…,A4AccessorWiringProbeTest,CurrentUserAccessorTest,RequestIdAccessorTest,RequestIdFilterTest`） | **43 / 43**，F=0 E=0 **S=0** | +| A4 关联回归 | **163 / 163**，F=0 E=0 **S=0** | +| `mvn test` | **2238 / 2238**，Failures=0、Errors=0、**Skipped=0** | +| `mvn clean verify` | **2238 / 2238**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS（≥ 2225 ✔） | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | + +- 较上轮（2225）新增 **13** 个测试（9 + 4） +- **`docs/openapi-rc.json` 零修改** ✔ +- **V1–V45 零修改** ✔ +- **未新增接口、表、索引、迁移或 ErrorCode** ✔ +- **未发现新的基线测试污染**（上一轮的账号注销夹具隔离修复已生效）✔ + +--- + +## 10. 精确修改文件 + +**生产代码（8 个，全部在任务书指定清单内）** + +``` +mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackController.java +mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchController.java +mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchConversationController.java +mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleController.java +mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryController.java +mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressController.java +mydreamjob-server/src/main/java/com/mydreamjob/match/MatchController.java +mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationController.java +``` + +**测试（新增 2 个）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/R01A4RequestContextMigrationIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringProbeTest.java +``` + +**文档（1 个）** + +``` +docs/backend-development-roadmap.md # 仅更新顶部 R01 状态行，历史章节未动 +``` + +**未修改**：Service、DTO、`ErrorCode`、Flyway、`SecurityConfig`、Filter 顺序、OpenAPI、既有测试、`UserRoleGuard`、"匿名 401 缺 requestId"观察项。 + +--- + +## 11. Git 状态 + +``` +分支：refactor/r01-structure-performance +HEAD：35baa8416d31e71dd2c2556877f9d2e1c93b14a1（未变） +暂存区：空 +git add -A / commit / push：均未执行 +Docker：未操作 +历史未跟踪文件：247 个完整保留 +``` + +验收临时用户（a4vstu / a4vcom）已按精确主键清理，`users` 残留 0；`audit_logs` 4 行 append-only 保留并登记。 + +--- + +## 12. 明确声明 + +- **未暂存、未提交、未推送。** +- 未进入 `UserRoleGuard`；未处理"匿名 401 缺 requestId"观察项。 +- 未使用 `@Autowired(required=false)`、`@Nullable`、`ObjectProvider` 或 `new Accessor()` 回退；测试切片使用真实 `SecurityFilterChain` 与真实 Accessor Bean。 +- 全仓剩余身份/requestId 数量已**逐文件分类解释**，未修改代码迁就数字。 + +--- + +> **R01-A4第四批请求身份与requestId收束完成，待独立代码复验。** diff --git a/docs/r01-a5-independent-verification-20260917.md b/docs/r01-a5-independent-verification-20260917.md new file mode 100644 index 0000000..f70c44f --- /dev/null +++ b/docs/r01-a5-independent-verification-20260917.md @@ -0,0 +1,279 @@ +# R01-A5 独立代码复验报告（第五批：8 个 Controller 请求身份与 requestId 收束） + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +HEAD：`0226977063243fce101e3f6c8dcf66492d306ef7`（A4 后最新提交，复验全程未变） +复验对象：`docs/r01-a5-request-context-migration-report.md` +性质：**仅复验** —— 未修改生产代码、未修改既有测试断言、未暂存、未提交、未推送 + +--- + +## 0. 结论 + +> **R01-A5独立代码复验通过，可以进入精确暂存、本地提交与推送检查点。** + +**FAIL = 0；SKIP = 0。未发现生产缺陷。** + +--- + +## 1. 开始前状态 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `0226977063243fce101e3f6c8dcf66492d306ef7`（A4 后最新）✔ | +| 与上游同步 | `0 / 0` ✔ | +| 暂存区 | 空 ✔ | +| `git diff --check` | 无空白错误 ✔ | +| 工作区改动 | **仅 8 个 A5 Controller + 路线图**，无 A5 之外的生产代码改动 ✔ | +| 历史未跟踪文件 | 全部保留 ✔ | +| reset/restore/checkout/clean、`git add -A`、Docker | 均未执行 ✔ | + +### `GlobalExceptionHandler.java` 三方 blob 比对 + +| 来源 | blob | +|---|---| +| worktree（`git hash-object`） | `1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21` | +| index（`git ls-files -s`） | `1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21` | +| HEAD（`git rev-parse HEAD:`） | `1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21` | + +**三者完全一致 → 纯 Windows stat 缓存现象，未触碰该文件** ✔ + +--- + +## 2. 8 个 Controller 静态审查 + +| Controller | 代表端点 | Accessor 调用（auth / reqId） | +|---|---|---| +| CandidateScoringGovernanceController | `GET /profile/me/candidate-scoring/appeals` | 9 / 9 | +| InterviewScoreController | `GET /interviews/{id}/score` | 4 / 4 | +| FavoriteController | `GET /jobs/favorites` | 3 / 3 | +| AdminReviewController | `GET /admin/reviews/pending` | 3 / 3 | +| AdminReviewReplyController | `GET /admin/review-replies/pending` | 2 / 2 | +| CompanyReviewManagementController | `GET /companies/me/job-reviews` | 4 / 4 | +| JobReviewController | `DELETE /jobs/{jobId}/reviews/{reviewId}` | 3 / 7 | +| StudentReviewWeightController | `GET /profile/me/review-weights` | 3 / 4 | + +（`JobReviewController` / `StudentReviewWeightController` 的 reqId 调用数高于 auth 属正常 —— 部分只读端点只需 requestId。） + +**改动性质**：`8 files changed, 101 insertions(+), 198 deletions(-)`，删除的 `ErrorCode.UNAUTHORIZED` 共 10 处，**全部来自被移除的私有解析方法**；**角色检查（`assertAdminRole`/`assertCompanyOwner`/`assertStudentRole`）、资源归属、`FORBIDDEN`/`NOT_FOUND` 及 Service 调用顺序未删未增、未移动** ✔ + +**`JobReviewController.parseIds` 完整保留** ✔ —— 它解析 `ids` 查询参数（业务参数，非认证主体），并以 `catch (NumberFormatException) → BAD_REQUEST` 处理，属正确的业务参数语义，未被误删或误判。 + +--- + +## 3. 禁止模式扫描 + +任务书指定模式在 8 个文件中的命中：**全部为 0** ✔ + +覆盖：`SecurityContextHolder`、`AnonymousAuthenticationToken`、`anonymousUser`、`auth.getName()`、`authentication.getName()`、`Long.(valueOf|parseLong)(...(auth|authentication)`、`private (resolveUserId|getRequestId|requestId)(`、`getHeader(...X-Request-Id|REQUEST_ID_HEADER)`、`@Autowired(required=false)`、`@Nullable`、`ObjectProvider`、`new CurrentUserAccessor`、`new RequestIdAccessor` + +--- + +## 4. 构造器注入与无回退证明 + +8 个 Controller 均声明： + +```java +private final CurrentUserAccessor currentUserAccessor; +private final RequestIdAccessor requestIdAccessor; +``` + +- 全部为 **`private final` 构造器注入**（Lombok `@RequiredArgsConstructor`）✔ +- **无** `@Autowired(required = false)` / `@Nullable` / `ObjectProvider` / `new CurrentUserAccessor()` / `new RequestIdAccessor()` 回退 ✔ +- 身份统一为 `currentUserAccessor.requireUserId()`；requestId 统一为 `requestIdAccessor.get(request)` ✔ + +--- + +## 5. 独立接线变异测试（Accessor 真实生效的证明） + +新增 `A5AccessorWiringIndependentTest`（4 例），**不复用实施者断言**，使用 `@MockBean` 替换 `CurrentUserAccessor`、`RequestIdAccessor` 与 8 个 Service： + +| 用例 | 证明 | +|---|---| +| `allEightEndpoints_useAccessorUserId` | mock 返回 `4242L` → 逐一验证 **8 个 Service 均收到 `4242L`**（`listMyAppeals` / `getScore` / `listFavorites` / `listPendingReviews` / `listPending` / `listMine` / `deleteReview` / `getMyWeights`），并 `verify(currentUserAccessor, times(8)).requireUserId()` | +| `illegalIdentity_rejectedBeforeService` | mock 抛 `InsufficientAuthenticationException` → 8 端点全部 401、无 500，且各 Service **零调用** | +| `responseBodyRequestId_comesFromAccessor` | mock 返回 `a5-independent-request` → 8 个端点响应体 `requestId` 均为该值，`verify(requestIdAccessor, times(8)).get(...)` | +| `noToken_is401` | 无 Token → Security 链 401 | + +**变异有效性**：若删除任一 Controller 中的 `currentUserAccessor.requireUserId()` 或 `requestIdAccessor.get(request)` 调用，对应 `verify` 与断言必然失败 —— 即**删除 Accessor 调用会使本测试失败** ✔ + +> 说明：响应头 `X-Request-Id` 由 `RequestIdFilter` 设置，**不来自 Controller**；本测试只断言**响应体**的 `requestId` 来源于 Accessor，未错误声称响应头来源。 + +--- + +## 6. 八端点非法主体结果（独立身份边界复验） + +`A5IndependentVerificationTest` 使用**真实 `CurrentUserAccessor` 与真实 `SecurityFilterChain`**（不 mock Accessor）： + +| 主体 | 结果 | +|---|---| +| `anonymousUser` | **401** ✔ | +| `not-a-number` | **401** ✔ | +| `99999999999999999999`（20 位溢出） | **401** ✔ | +| `0` | **401** ✔ | +| `-1` | **401** ✔ | +| `AnonymousAuthenticationToken` / 无 Token | **401** ✔ | + +逐端点断言（7 个 GET 端点 + `DELETE /jobs/1/reviews/1`）： +- **HTTP 401，无 500** ✔ +- **业务 Service 零调用** ✔（`verify(..., never())`） +- **不回显非法主体** —— 仅解析 JSON 后检查 `code`/`message` 稳定字段，**未对整段 JSON 做数字搜索** ✔ +- 响应不包含 `Exception` / `java.` / `principal` / `anonymousUser` / `com.mydreamjob` / `NumberFormat` ✔ + +**未使用**任何捕获 `NumberFormatException` 的方式"修复"测试。 + +--- + +## 7. 合法主体传入 Service 的 userId 证据 + +§5 的 `verify` 系列即为证据：mock Accessor 返回 `4242L` 时，**8 个 Service 各自收到 `4242L`**（逐一 `eq(4242L)` 断言）✔ + +同时 `A5IndependentVerificationTest#legalPrincipal_reachesService` 使用**真实 Accessor**（数字主体 `"7"`）验证 8 端点**不被身份层判为未登录**（非 401）✔ + +--- + +## 8. requestId Accessor 接线证据 + +见 §5 第 3 项：mock `RequestIdAccessor#get` 返回固定值 → 8 个端点（7 个 GET + 1 个 DELETE，均返回 `ApiResponse`）响应体 `requestId` 均为 `a5-independent-request`，并 `verify(requestIdAccessor, times(8)).get(any(HttpServletRequest.class))` ✔ + +--- + +## 9. 401 / 403 / 404 分层保持 + +| 检查项 | 结果 | +|---|---| +| 静态审查：角色/归属检查是否被删改或移动 | **否**（`git diff` 确认未删未增）✔ | +| `FORBIDDEN` / `NOT_FOUND` 错误码 | **未修改** ✔ | +| `ErrorCode.java` | **零改动** ✔ | +| 合法主体不被判为未登录 | ✔（§7） | + +**401 与 403/404 的分层未被统一**：身份失败为 401，角色/归属失败仍由既有 Service 逻辑产生 403/404，语义未漂移。 + +--- + +## 10. 失败请求的业务副作用 + +新增 `A5SideEffectSnapshotTest`（2 例），使用 H2 **行级快照**（显式列 + 稳定 `ORDER BY`，**逐字段**比较，**非 COUNT/SUM**）： + +快照覆盖 9 张核心表：`JOB_FAVORITES`、`JOB_REVIEWS`、`COMPANY_REVIEW_REPLIES`、`INTERVIEW_SCORES`、`CANDIDATE_SCORING_APPEALS`、`STUDENT_REVIEW_WEIGHT_PREFERENCES`、`NOTIFICATIONS`、`MESSAGES`、`AUDIT_LOGS`。 + +| 用例 | 结果 | +|---|---| +| 非法身份请求（`anonymousUser` + `not-a-number` × 7 端点 + DELETE）前后 | **9 张表逐字段零变化** ✔ | +| 无 Token 请求前后 | **9 张表逐字段零变化** ✔ | + +**结论**：非法身份请求不写收藏、评价、回复、面试评分、治理申诉、权重；不发通知；不发 RabbitMQ 消息；不写审计成功记录（`AUDIT_LOGS` 零变化）✔ + +> 本轮**未启动 Docker**，以上为 H2 独立复验结论；**不声称真实 MySQL 结论**。 + +--- + +## 11. 测试数 + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="A5AccessorWiringIndependentTest,A5IndependentVerificationTest" test` | **8 / 8**，F=0 E=0 **S=0** | +| `mvn -Dtest="A5SideEffectSnapshotTest" test` | **2 / 2**，F=0 E=0 **S=0** | +| A5 定向（`R01A5…,A5*Test,` 8 个 Controller 测试 + 3 个 Accessor/Filter 测试） | **98 / 98**，F=0 E=0 **S=0**，BUILD SUCCESS | +| `mvn clean verify` | **2255 / 2255**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS | + +- 实施基线 2245 → 复验后 **2255**（新增 **10** 个独立测试：4 + 4 + 2），**不低于基线** ✔ +- 未见新的基线测试污染 ✔ + +--- + +## 12. OpenAPI + +`python docs\verify_openapi.py` → **176 paths / 214 operations**，All checks passed ✔ + +**`docs/openapi-rc.json` 零修改** ✔ + +--- + +## 13. Flyway / ErrorCode / DTO / 接口 + +| 项 | 结果 | +|---|---| +| V1–V45 迁移 | **零修改**（`git diff --name-only -- db/migration` 为空）✔ | +| `ErrorCode.java` | **零改动** ✔ | +| DTO | 零改动 ✔ | +| 公网接口 / OpenAPI | 零新增零修改 ✔ | +| 新增表 / 索引 | 无 ✔ | + +--- + +## 14. 全仓剩余统计（逐文件分类） + +**身份解析**（`SecurityContextHolder.getContext().getAuthentication` \| `Long.(valueOf|parseLong)([^)]*getName()`）—— **4 文件** + +| 分类 | 文件 | +|---|---| +| 基础设施（3） | `security/CurrentUserAccessor`（Accessor 自身）、`auth/JwtAuthenticationFilter`（认证过滤器）、`deletion/DeletionGuardInterceptor`（拦截器） | +| **业务 Controller（1）** | `scoringmonitoring/FairnessMonitoringController` | +| 误报 | 0 | + +**requestId 解析**（含 `X-Request-Id` 直读、`RequestIdFilter.REQUEST_ID_HEADER`、`String (getRequestId|resolveRequestId|requestId)(`）—— **10 文件** + +| 分类 | 文件 | +|---|---| +| 基础设施 / 非业务入口（5） | `audit/AuditContext`、`common/exception/GlobalExceptionHandler`、`common/logging/RequestIdAccessor`、`common/logging/RequestLoggingFilter`、`deletion/DeletionGuardInterceptor` | +| **业务 Controller（5）** | `controller/ApiController`、`controller/AuthController`、`controller/SystemController`、`job/JobController`、`scoringmonitoring/FairnessMonitoringController` | +| 误报 | 0 | + +**与路线图记数的一处差异（如实记录）**：路线图 R01 行记「全仓 requestId 11 文件 = 基础设施/非业务入口 6 + 业务 5」。本次独立复验用任务书指定模式实测为 **10 文件 = 基础设施 5 + 业务 5**。**业务 Controller 数一致（5）**；差异在基础设施计数（5 vs 6），推测为路线图对"基础设施/非业务入口"的分类口径略有不同（如是否计入某调用点）。**不应据此修改代码或路线图**；建议后续批次统一口径。 + +--- + +## 15. 精确新增文件 + +``` +新增测试（3） + mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5AccessorWiringIndependentTest.java + mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5IndependentVerificationTest.java + mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5SideEffectSnapshotTest.java + +复验报告（1） + docs/r01-a5-independent-verification-20260917.md +``` + +**未修改**：8 个 A5 Controller 生产代码、既有测试断言、`GlobalExceptionHandler`、`SecurityConfig`、Filter、Accessor、`ErrorCode`、DTO、OpenAPI、Flyway。 + +--- + +## 16. Git 状态 + +``` +分支：refactor/r01-structure-performance +HEAD：0226977063243fce101e3f6c8dcf66492d306ef7（未变） +暂存区：空 +git add -A / commit / push：均未执行 +reset / restore / checkout / clean：均未执行 +Docker：未操作 +工作区：8 个 A5 Controller + 路线图（实施者改动，仍未暂存）+ 本报告与 3 个独立测试（未跟踪） +历史未跟踪文件：全部保留 +``` + +--- + +## 17. 是否发现生产缺陷 + +**未发现生产缺陷。** 8 个 Controller 的迁移完整、正确： +- 禁止模式 0 命中；构造器注入无回退；`parseIds` 业务解析正确保留 +- 角色/归属/403/404 语义未漂移 +- 独立接线变异测试证明 Accessor 真实生效（删除调用即失败） +- 独立身份边界测试证明非法主体在业务调用前被拒（401、无 500、零 Service 调用）且不回显主体 +- 失败请求 9 张核心表逐字段零变化 + +--- + +## 18. 明确声明 + +- **未暂存、未提交、未推送。** +- 未修改 8 个 Controller 或任何生产代码；未修改、删除或放宽既有测试断言；未修改 `GlobalExceptionHandler`、`SecurityConfig`、Filter、Accessor、`ErrorCode`、DTO、OpenAPI、Flyway。 +- 未进入 R01-A6；未删除历史未跟踪文件。 +- 本轮未启动 Docker，**未伪造真实 MySQL 结论**。 + +--- + +> **R01-A5独立代码复验通过，可以进入精确暂存、本地提交与推送检查点。** diff --git a/docs/r01-a5-request-context-migration-report.md b/docs/r01-a5-request-context-migration-report.md new file mode 100644 index 0000000..f81cc8a --- /dev/null +++ b/docs/r01-a5-request-context-migration-report.md @@ -0,0 +1,79 @@ +# R01-A5 第五批请求上下文收束实施报告 + +实施日期：2026-09-17 + +分支：`refactor/r01-structure-performance` + +基线 HEAD：`0226977063243fce101e3f6c8dcf66492d306ef7` + +## 结论 + +R01-A5 第五批请求身份与 requestId 收束已完成自动化验证，待独立代码复验。 + +## 修改范围 + +本批仅修改以下 8 个 Controller： + +1. `CandidateScoringGovernanceController` +2. `InterviewScoreController` +3. `FavoriteController` +4. `AdminReviewController` +5. `AdminReviewReplyController` +6. `CompanyReviewManagementController` +7. `JobReviewController` +8. `StudentReviewWeightController` + +每个 Controller 均执行相同的受控迁移： + +- 构造器注入既有 `CurrentUserAccessor` 与 `RequestIdAccessor`； +- 身份统一调用 `currentUserAccessor.requireUserId()`； +- requestId 统一调用 `requestIdAccessor.get(request)`； +- 删除本地身份解析方法和 requestId 读取方法； +- 保留原有角色、资源归属、Service 参数、DTO 和响应结构。 + +`JobReviewController.parseIds` 是岗位 ID 业务参数解析，予以保留。 + +## 静态门禁 + +8 个目标文件对以下模式均为零命中： + +- `SecurityContextHolder` / `Authentication` / `anonymousUser`； +- 身份 `Long.valueOf(auth.getName())`； +- `resolveUserId` / `getRequestId` / 私有 `requestId(...)`； +- 原始 `X-Request-Id` header 读取； +- 可选注入、`ObjectProvider` 或手工 `new Accessor()` 回退。 + +## 新增验证 + +新增 `R01A5RequestContextMigrationIntegrationTest`，使用真实 Spring Security 与 MVC 映射： + +- 8 个 Controller 各选一个真实端点； +- 非法主体覆盖 `anonymousUser`、非数字、20 位 Long 溢出、0、负数； +- 所有组合必须返回 HTTP 401，且响应不含异常类、堆栈或非法主体； +- 合法主体下验证规范化 requestId 的响应头与响应体同源。 + +定向与关联测试：90/90，Failures=0，Errors=0，Skipped=0。 + +## 全量验证 + +- `mvn clean verify`：BUILD SUCCESS，2245/2245，Failures=0，Errors=0，Skipped=0； +- `python docs/verify_openapi.py`：176 paths / 214 operations，All checks passed； +- V1-V45 无差异； +- `docs/openapi-rc.json` 无差异； +- `git diff --check` 无空白错误，仅既有 LF/CRLF 提示。 + +## 全仓剩余 + +完成 A5 后： + +- 身份解析共 4 个文件：基础设施 3 个，业务 Controller 仅 `FairnessMonitoringController` 1 个； +- requestId 入口共 11 个文件：基础设施/非业务入口 6 个，业务 Controller 5 个； +- 最终 A6 业务白名单为 `FairnessMonitoringController`、`ApiController`、`AuthController`、`SystemController`、`JobController`。 + +## 边界 + +- 未新增或修改 Flyway、ErrorCode、接口、DTO、表、索引或依赖； +- 未修改评分、申诉、面试评分、岗位收藏或评价业务规则； +- 未暂存、未提交、未推送； +- 未删除或移动历史未跟踪文件； +- 未进入 A6。 diff --git a/docs/r01-a6-fairness-fixture-isolation-fix-20260917.md b/docs/r01-a6-fairness-fixture-isolation-fix-20260917.md new file mode 100644 index 0000000..31d7429 --- /dev/null +++ b/docs/r01-a6-fairness-fixture-isolation-fix-20260917.md @@ -0,0 +1,128 @@ +# Fairness 认证夹具隔离修复（A6 后独立纯测试提交） + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +A6 提交：`c6db74a1a8300e1aab8a452fb67909f86861fa43` +本轮性质：**纯测试修复** —— 生产代码 diff 为 0，Flyway 为 0，OpenAPI 为 0 + +--- + +## 0. 结论 + +`FairnessMonitoringControllerTest` 已不再依赖种子数据、测试执行顺序或共享表清空， +**单独运行稳定通过**；并新增反证测试锁定该隔离性。 + +--- + +## 1. 缺陷（A6 独立复验定位） + +| 环节 | 事实 | +|---|---| +| 冲突 | 该测试用 `token(1L, "ADMIN")` / `token(2L, "STUDENT")`，而 `V1_1__seed_data.sql` 的种子账号占用 `users.id = 1/2/3` | +| 被禁用 | `V43__disable_legacy_seed_accounts.sql` 把这三行置为 `is_active = 0` | +| 夹具缺陷 | `TestAuthTokens.writeSession()` 仅在 `SELECT COUNT(*) FROM users WHERE id = ?` 为 0 时 INSERT，**不会激活已存在的禁用行** | +| 后果 | `AuthSessionService.isSessionActive()` 的用户检查短路 → 全部 Token 请求 401 | +| 被掩盖 | 全量顺序下 `com.mydreamjob.controller.AuthIntegrationTest` 的 `@BeforeEach` 执行 `userRepository.deleteAll()`，偶然清掉种子行，夹具随后才补建 active 用户 | + +单跑实测（修复前）：`Tests run: 7, Failures: 6`，全部 `Status expected:<200|403|400> but was:<401>`。 + +详见 `docs/r01-a6-independent-verification-20260917.md` §9。 + +--- + +## 2. 修复方案 + +**选择：让 `FairnessMonitoringControllerTest` 使用独占用户，而不是修改公共 `TestAuthTokens`。** +理由：公共 helper 若"自动激活已存在的 inactive 用户"，会静默复活本应被禁用的账号 +（包括生产语义上被 V43 禁用的种子账号），风险远大于收益。 + +### 2.1 改动内容 + +| 项 | 修复前 | 修复后 | +|---|---|---| +| 夹具身份 | `userId = 1` / `2`（与种子账号冲突） | **独占** `ADMIN_USER_ID = 9_310_001L`、`STUDENT_USER_ID = 9_310_002L` | +| 手机号 | 由 `TestAuthTokens` 隐式生成 `"t"+id` | 独占 `a6fair-admin` / `a6fair-student` | +| 用户来源 | 依赖 `TestAuthTokens` 的"不存在才插入" | `@BeforeEach` **显式插入 `is_active = 1`** 的独占用户 | +| 清理 | 无 | `@AfterEach` 按**精确 ID**、按外键顺序删除：`auth_tokens` → `user_roles` → `users` | + +`@BeforeEach` 先执行与 `@AfterEach` 相同的精确清理再插入，因此对"上轮异常中断残留"具备幂等性， +且**从不把任何已存在的 inactive 用户直接激活**（是删除后重建自有行）。 + +### 2.2 未使用的手段（明确排除） + +未改 `V43`；未改生产认证逻辑；未使用 `deleteAll()` 清空共享表；未使用 `@DirtiesContext` 掩盖污染； +未捕获并忽略约束异常；未依赖测试执行顺序；未放宽任何既有 Fairness 断言；未修改公共 `TestAuthTokens`。 + +--- + +## 3. 反证测试 `FairnessMonitoringFixtureIsolationTest`（7 例） + +| # | 用例 | 覆盖点 | +|---|---|---| +| 1 | `fixtureIdsAreOutsideSeedAccountRange` | 夹具 ID 不在种子号段 1/2/3；夹具用户确为 active；未占用种子手机号 | +| 2 | `seedRowsInactiveOrAbsent_stillAuthenticates` | 种子行 **inactive（V43 状态）** 与 **完全缺失** 两种前置下端点均返回 200 | +| 3 | `repeatedProvisioningAndRequests_doNotConflict` | 连续 3 轮"装配 + 请求"均成功，且不产生重复用户行 | +| 4 | `fixtureCycleLeavesSeedRowsUntouched` | 完整周期前后种子行逐字段不变（顺序无关的根本保证） | +| 5 | `cleanupRemovesOnlyOwnFixtureRows` | 清理只删本类行；探针用户及其会话不受波及 | +| 6 | `unrelatedUsersAndSessionsUnchanged` | 非夹具用户与会话逐字段不变 | +| 7 | `publicTokenFixtureDoesNotSilentlyReviveInactiveUser` | `TestAuthTokens` 对已存在 inactive 用户**不激活**，该 Token 请求为 401 且 Service 零调用 | + +用例 2 会临时快照并按主键**原样恢复**种子行（`try` 语义由 `@AfterEach` 兜底），不新增、不批量重建。 + +--- + +## 4. 验证矩阵 + +命令均在 `mydreamjob-server/` 下执行；日志位于 `docs/acceptance/r01-d4-2-20260916/ff-*.log`。 + +| # | 命令 | 结果 | 日志 | +|---|---|---|---| +| 1 | `mvn -Dtest="FairnessMonitoringControllerTest" test` | **7 / 7**，F=0 E=0 S=0 ✔ | `ff-1-standalone.log` | +| 2 | `mvn -Dtest="FairnessMonitoringFixtureIsolationTest,FairnessMonitoringControllerTest" test` | **14 / 14**，F=0 E=0 S=0 ✔ | `ff-2-isolation.log` | +| 3 | Fairness **先**跑 ×3（`-Dsurefire.runOrder=reversealphabetical`） | **13 / 13** ×3 ✔ | `ff-3-fairnessfirst-{1,2,3}.log` | +| 4 | Auth **先**跑 ×3（`-Dsurefire.runOrder=alphabetical`） | **13 / 13** ×3 ✔ | `ff-4-authfirst-{1,2,3}.log` | +| 5 | `mvn clean verify` | 见 §4.1 | `ff-5-clean-verify.log` | +| 6 | `python ..\docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed ✔ | — | + +> **顺序说明**：surefire 默认 `runOrder=filesystem` 会忽略 `-Dtest` 的书写顺序， +> 因此额外用 `-Dsurefire.runOrder=reversealphabetical`（Fairness 先）与 `=alphabetical`（Auth 先） +> 强制两个方向，并在日志中逐次核对实际执行顺序（`reversealphabetical` 下 +> `scoringmonitoring.FairnessMonitoringControllerTest` 确在 `controller.AuthIntegrationTest` 之前）。 +> `runOrder=testorder` 在本仓库使用的 surefire 3.5.6 中不可用（已实测报错）。 + +### 4.1 全量结果 + +| 项 | 数值 | +|---|---| +| 全量测试总数 | 2278 → **2285**（+7：新增反证测试类） | +| Failures / Errors / Skipped | **0 / 0 / 0** ✔ | +| 生产代码 diff | **0** ✔ | +| V1–V45 | **未改动** ✔ | +| `docs/openapi-rc.json` | **未修改** ✔ | + +--- + +## 5. 修改文件 + +``` +mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringControllerTest.java （修改：夹具独占化） +mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringFixtureIsolationTest.java（新增：反证测试） +docs/r01-a6-fairness-fixture-isolation-fix-20260917.md （新增：本报告） +docs/backend-development-roadmap.md （夹具问题关闭记录） +``` + +**无生产代码、无 Flyway、无 ErrorCode、无 DTO、无接口、无 OpenAPI、无 Filter/Accessor/SecurityConfig 改动。** + +--- + +## 6. 明确声明 + +- 未修改任何生产代码，未修改 `V43`，未修改公共 `TestAuthTokens` 夹具。 +- 未删除、未放宽任何既有断言；`FairnessMonitoringControllerTest` 的业务断言逐字保留。 +- 未使用 `deleteAll()`、`@DirtiesContext`、顺序依赖或异常吞没等掩盖手段。 +- 未与 R01-B 混合。 + +--- + +> **FairnessMonitoringControllerTest 单跑夹具缺陷已通过独立纯测试提交修复； +> 该测试不再依赖种子数据状态与测试执行顺序。** diff --git a/docs/r01-a6-final-request-context-migration-report.md b/docs/r01-a6-final-request-context-migration-report.md new file mode 100644 index 0000000..f4c6df9 --- /dev/null +++ b/docs/r01-a6-final-request-context-migration-report.md @@ -0,0 +1,359 @@ +# R01-A6 最终业务 Controller 请求身份与 requestId 收束报告 + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +A6 基线 HEAD：`534afe686b966f175bcaf4af0726cec061092050`（A5 提交） +本轮性质：**实施与自动化验证** —— 未提交、未推送，待独立代码复验 + +--- + +## 0. 结论 + +> **R01-A6最终业务Controller请求上下文收束完成，待独立代码复验；A系列到此结束，不再拆分A7/A8。** + +**业务 Controller 身份解析残留 = 0；业务 Controller requestId 重复解析残留 = 0。** 剩余命中全部为基础设施职责。 + +--- + +## 1. 开始时状态 + +### 1.1 A5 固化（第一阶段） + +A5 此前**未提交**，本轮按已确认清单精确固化： + +| 项 | 结果 | +|---|---| +| 暂存文件数 | **15**（8 生产 Controller + 4 测试 + 2 报告 + 1 路线图） | +| `git add` 方式 | **逐文件 `git add --`**；未使用 `git add -A` / `git add .` | +| 路线图 | `git diff --numstat` 为 `1 1`（**仅 R01 行一处 hunk**），无需 `git add -p` | +| 排除项 | `GlobalExceptionHandler.java`、`db/migration`、`docs/acceptance`、`backend-infra`、A2–A4 文件 **全部排除** ✔ | +| `git diff --cached --check` | 无输出 ✔ | +| 敏感扫描 | 1050 新增行，12 类（手机号/JWT/Bearer/验证码/口令/密钥/私钥/AWS/64位摘要/本机路径/UUID/连接串）**全部命中 0** ✔ | +| A5 定向 | **42 / 42**，F=0 E=0 S=0 | +| `mvn clean verify` | **2255 / 2255**，F=0 E=0 **S=0**，BUILD SUCCESS | +| OpenAPI | **176 / 214**，All checks passed | +| 提交 | `refactor: centralize fifth batch request context handling` | +| **A5 提交 hash** | **`534afe686b966f175bcaf4af0726cec061092050`** | +| 推送 | `0226977..534afe6`；**未 force push** | +| 推送后同步 | **0 / 0** ✔ | + +### 1.2 A6 开始前核查（第二阶段） + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| 新 HEAD | `534afe686b966f175bcaf4af0726cec061092050` ✔ | +| 暂存区 | 空 ✔ | +| `git diff --check` | 无空白错误 ✔ | +| **A5 未提交残余** | **无**（工作区仅 `GlobalExceptionHandler.java` 的 stat 缓存标记，blob 三方一致）✔ | +| 历史未跟踪文件 | 全部保留 ✔ | +| Docker / R01-B·C·E | 未触碰 ✔ | + +**A6 基线测试数：2255。** + +--- + +## 2. 五个 Controller 的修改内容 + +### 2.1 迁移前契约 + +| Controller | 真实代表端点 | 身份解析 | requestId 解析 | +|---|---|---|---| +| `controller/ApiController` | `GET /` | 无 | `private String getRequestId(HttpServletRequest)` → `request.getHeader("X-Request-Id")` | +| `controller/AuthController` | `POST /auth/login`、`GET /auth/me` 等 | **已有 `CurrentUserAccessor`** ✓ | `private String getRequestId(...)` | +| `controller/SystemController` | `GET /health`、`GET /info` | 无 | `private String getRequestId(...)` | +| `job/JobController` | `GET /jobs`、`POST /jobs` 等 | **已有 `CurrentUserAccessor`** ✓ | `private String getRequestId(...)` | +| `scoringmonitoring/FairnessMonitoringController` | `GET /admin/scoring/fairness/*` | **需迁移**：`private Long userId()` 直读 `SecurityContextHolder` + `Long.valueOf(auth.getName())` | `private String requestId(HttpServletRequest)` 单行直读 | + +### 2.2 修改后 + +| Controller | 注入 | `requireUserId()` | `requestIdAccessor.get(request)` | +|---|---|---|---| +| ApiController | 新增 `RequestIdAccessor`（并补 `@RequiredArgsConstructor`） | 0 | 1 | +| AuthController | 新增 `RequestIdAccessor`（`CurrentUserAccessor` 既有） | 2（既有） | 14 | +| SystemController | 新增 `RequestIdAccessor`（并补 `@RequiredArgsConstructor`） | 0 | 2 | +| JobController | 新增 `RequestIdAccessor`（`CurrentUserAccessor` 既有） | 1（既有） | 8 | +| FairnessMonitoringController | 新增 `CurrentUserAccessor` + `RequestIdAccessor` | 5 | 5 | + +**`JobController` 的身份迁移未被重复改造** ✔ —— 它此前已使用 `CurrentUserAccessor`，本批只迁移 requestId。 + +**`AuthController` 无重复身份解析** ✔ —— 它此前已使用 `CurrentUserAccessor`，本批只迁移 requestId。 + +### 2.3 删除的私有方法（共 6 个） + +| Controller | 删除 | +|---|---| +| ApiController | `getRequestId` ×1 | +| AuthController | `getRequestId` ×1 | +| SystemController | `getRequestId` ×1 | +| JobController | `getRequestId` ×1 | +| FairnessMonitoringController | `userId` ×1、`requestId` ×1 | +| **合计** | **6** | + +> **计数澄清（独立复验补充）**：曾出现"`5 × getRequestId + 1 × userId + 1 × requestId`"的表述，其算术结果为 7，**与真实 diff 不符，该表达式不成立**。经逐文件 `git diff` 核对：`getRequestId` 实际只有 **4 个**（ApiController / AuthController / SystemController / JobController）；`FairnessMonitoringController` 的 requestId 方法签名是 **`requestId(HttpServletRequest)`（无 `get` 前缀）**，因此**不能被计入 `getRequestId`**。正确分解为 **4 × getRequestId + 1 × userId + 1 × requestId = 6**，与本表逐文件清单完全一致。**未为迎合数字修改任何生产代码。** + +**保留**：`FairnessMonitoringController.parseDate`（业务参数解析）、`checkParams`（业务参数校验）✔ 未被误删。 + +**新增注解**：`ApiController` 与 `SystemController` 原本无依赖、缺 `@RequiredArgsConstructor`，为支持构造器注入补齐该注解与 import（**唯一的新增注解**，未引入 `@Autowired`）。 + +**未修改**：`RequestIdFilter`、`RequestIdAccessor`、`RequestLoggingFilter`、`AuditContext`、`GlobalExceptionHandler`、`SecurityConfig`、Filter 顺序 ✔ + +--- + +## 3. 修复前失败证据 + +新增 `mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/` 下两个测试类。 + +**修复前实测：`Tests run: 10, Failures: 5`** + +| 失败测试 | 修复前实际 | +|---|---| +| `A6AccessorWiringProbeTest.requestIdComesFromAccessorAcrossFiveControllers` | `path=/` 响应体 `requestId` **不是** Accessor 返回值（Controller 直读 header） | +| `A6AccessorWiringProbeTest.fairnessMonitoringUsesCurrentUserAccessor` | `FairnessMonitoringService.drift(...)` **未被调用**（身份未走 Accessor） | +| `A6AccessorWiringProbeTest.accessorThrowsUnauthenticated_fairnessReturns401` | 不成立 | +| `R01A6RequestContextMigrationIntegrationTest.fairnessMonitoring_illegalPrincipals_are401` | `principal='anonymousUser'` → **`expected: 401 but was: 400`** | +| `R01A6RequestContextMigrationIntegrationTest.fairnessMonitoring_illegalPrincipals_produceNoServiceCall` | 不成立 | + +**关于 400 而非 500（如实记录）**：`FairnessMonitoringController.userId()` 带有 +`try { Long.valueOf(auth.getName()); } catch (NumberFormatException) { throw BusinessException(UNAUTHORIZED); }`， +因此其**既有行为本身是安全的（未逃逸为 500）**，但抛出的 `BusinessException(ErrorCode.UNAUTHORIZED=2001)` +不在 `GlobalExceptionHandler.BUSINESS_HTTP_STATUSES` 映射中，`resolveHttpStatus` 的 +`getOrDefault(2001, BAD_REQUEST)` 使其落到 **HTTP 400**。这正是本批收束的真实语义缺陷： +**非法主体应返回 401 而非 400**。接线探针则因"未调用 Accessor"而失败 —— **未编造 500**。 + +**修复后：`Tests run: 10, Failures: 0`** + +--- + +## 4. 角色与资源归属语义 + +| 核查项 | 结论 | +|---|---| +| 静态审查：删除行中是否含角色/归属检查 | **否** ✔ | +| 静态审查：新增行中是否引入角色/归属逻辑 | **否** ✔ | +| `ErrorCode.java` | **零改动** ✔ | +| ADMIN / COMPANY / STUDENT 角色检查 | 未删除、未移动 ✔ | +| 企业归属 / 资源归属 / 403 / 404 分支 | 未删除、未移动 ✔ | +| 监控数据访问权限（ADMIN 只读聚合） | 未改变 ✔ | + +**分层保持**：身份失败 → **401**；角色不足 → **403**（由 Service 层或既有逻辑产生）；资源不存在 → **404**。 + +--- + +## 5. 独立接线探针 + +`A6AccessorWiringProbeTest`（3 例）使用 `@MockBean` 替换 `CurrentUserAccessor`、`RequestIdAccessor` 与对应 Service： + +| 用例 | 证明 | +|---|---| +| `requestIdComesFromAccessorAcrossFiveControllers` | mock `RequestIdAccessor` 返回 `a6-probe-request-id` → **5 个 Controller 的响应体 requestId 均为该值**（修复前为直读 header 的 null） | +| `fairnessMonitoringUsesCurrentUserAccessor` | mock `CurrentUserAccessor` 返回 `5151L` → `fairnessMonitoringService.drift(5151L)` 被调用 | +| `accessorThrowsUnauthenticated_fairnessReturns401` | mock 抛 `InsufficientAuthenticationException` → FairnessMonitoring 返回 **401**，Service **零调用** | + +**变异有效性**：删除任一 Controller 中的 Accessor 调用会使对应 `verify` 失败 ✔ + +--- + +## 6. 非法 principal 的结果 + +`R01A6RequestContextMigrationIntegrationTest` 对 `GET /admin/scoring/fairness/drift` 覆盖： + +| 主体 | 结果 | +|---|---| +| `anonymousUser` | **401** ✔ | +| `not-a-number` | **401** ✔ | +| `99999999999999999999`（20 位溢出） | **401** ✔ | +| `0` | **401** ✔ | +| `-1` | **401** ✔ | +| 匿名 token / 无 Token | **401** ✔ | +| 合法数字主体 `"7"` | 不被身份层拒绝（非 401）✔ | + +断言：**401 且无 500**；响应体仅解析 `code`/`message` 稳定字段，**不对整段 JSON 做数字搜索**；不含 `Exception`/`java.`/`principal`/`anonymousUser`/`com.mydreamjob`/`NumberFormat`；无 `stackTrace`/`trace`；**业务 Service 零调用** ✔ + +--- + +## 7. requestId 规范化 + +覆盖 5 个 Controller 的真实端点（`/`、`/health`、`/auth/me`、`/jobs`、`/admin/scoring/fairness/drift`）： + +| 输入 | 结果 | +|---|---| +| 合法值 `a6-legal-0001` | 响应头 == 响应体，原样保留 ✔ | +| 空白 `" "` | 重新生成，头体同源 ✔ | +| 超长（80 字符） | 收敛至 ≤32，头体同源 ✔ | +| 非法字符 ``、`a b` | 生成合法替代值，响应头不含 `<`/`>`/空格 ✔ | +| request attribute 与 header 不同 | **attribute 优先** ✔ | +| CR / LF / CRLF（直接经 Accessor） | 不进入规范化结果 ✔ | + +--- + +## 8. 全仓剩余命中逐文件分类 + +**身份解析**（`SecurityContextHolder.getContext().getAuthentication` \| `Long.(valueOf|parseLong)([^)]*getName()`）—— **3 文件** + +| 文件 | 分类 | +|---|---| +| `security/CurrentUserAccessor` | 基础设施（Accessor 自身） | +| `auth/JwtAuthenticationFilter` | 基础设施（认证过滤器） | +| `deletion/DeletionGuardInterceptor` | 基础设施（拦截器） | + +**requestId 解析**（含 `X-Request-Id` 直读、`RequestIdFilter.REQUEST_ID_HEADER`、`String (getRequestId|resolveRequestId|requestId)(`）—— **5 文件** + +| 文件 | 分类 | +|---|---| +| `audit/AuditContext` | 基础设施 | +| `common/exception/GlobalExceptionHandler` | 基础设施 | +| `common/logging/RequestIdAccessor` | 基础设施（Accessor 自身） | +| `common/logging/RequestLoggingFilter` | 基础设施 | +| `deletion/DeletionGuardInterceptor` | 基础设施 | + +**全部落在任务书允许的基础设施清单内**（`CurrentUserAccessor`、`JwtAuthenticationFilter`、`DeletionGuardInterceptor`、`RequestIdAccessor`、`RequestIdFilter`、`RequestLoggingFilter`、`AuditContext`、`GlobalExceptionHandler`）✔ + +**未为"全仓零命中"修改任何基础设施类** ✔ + +**未在 A6 清单内的业务 Controller 残留：0** ✔ —— 无需越界修改。 + +--- + +## 9. 业务 Controller 残留 + +| 项 | 结果 | +|---|---| +| 业务 Controller 身份解析 | **0** ✔ | +| 业务 Controller requestId 重复解析 | **0** ✔ | + +**A 系列请求上下文收束达成目标终态。A7/A8 不再设置。** + +--- + +## 10. 测试数 + +| 命令 | 结果 | +|---|---| +| A6 定向（`R01A6…,A6AccessorWiringProbeTest,CurrentUserAccessorTest,RequestIdAccessorTest,RequestIdFilterTest`） | **40 / 40**，F=0 E=0 **S=0** | +| A6 关联（`*ApiController*Test,*AuthController*Test,*SystemController*Test,*JobController*Test,*FairnessMonitoring*Test,*Security*Test,*RequestId*Test`） | **76 / 76**（1 项既有夹具脆弱性，见 §10.1，**全量顺序下不触发**） | +| `mvn test` | **2265 / 2265**，Failures=0、Errors=0、**Skipped=0** | +| `mvn clean verify` | **2265 / 2265**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS | + +A5 基线 2255 → A6 **2265**（新增 **10** 个测试：7 + 3），**不低于基线** ✔ + +### 10.1 基线已存在的测试夹具脆弱性（未在本批修复） + +A6 关联回归单独运行时，**既有** `FairnessMonitoringControllerTest` 出现 6 个失败（`200/403/400 → 401`），根因为： + +``` +Caused by: AuthSessionService - session validation rejected: user not usable + JwtAuthenticationFilter - JWT authentication rejected: session not active +``` + +**归因验证（任务书要求）**：在 `git worktree add --detach HEAD`（**不含 A6 改动**）中运行**完全相同**的命令： + +| | 测试数 | 失败 | 根因 | +|---|---|---|---| +| 基线（HEAD） | **7** | **6** | `user not usable` | +| 本次（含 A6） | **7** | **6** | **完全相同** | + +**实施阶段初步判断（后被独立复验否定，保留于此以存档过程）**：当时认为 +`TestAuthTokens` 夹具插入 `users` 行时**不写 `user_roles`**，导致该用户被判 "not usable"。 +**该判断不成立**：`AuthSessionService.isUsable(User)` 只检查用户存在且 `is_active = true`， +`UserRepository.findById` 无角色过滤，该路径**从不查询 `user_roles`**。 + +**独立复验结论（准确根因）**：见 `docs/r01-a6-independent-verification-20260917.md` §9。 + +| 环节 | 事实 | +|---|---| +| 身份冲突 | `FairnessMonitoringControllerTest` 使用 `token(1L, "ADMIN")` / `token(2L, "STUDENT")`，与 `V1_1__seed_data.sql` 种子账号占用的 `users.id = 1 / 2 / 3` **冲突** | +| 种子被禁用 | `V43__disable_legacy_seed_accounts.sql` 按原始指纹把这三行 `is_active` 置为 **0** | +| 夹具缺陷 | `TestAuthTokens.writeSession()` 仅当 `SELECT COUNT(*) FROM users WHERE id = ?` 为 0 时才 INSERT；**对已存在但 `is_active = 0` 的行不做激活**，永不修复其启用状态 | +| 直接后果 | `AuthSessionService.isSessionActive()` 第一步 `isUserUsable()` 返回 false 并短路，请求在进入 Controller 前即 401 | +| 全量为何通过 | 全量顺序中 `com.mydreamjob.controller.AuthIntegrationTest` 的 `@BeforeEach` 执行 `userRepository.deleteAll()`，**偶然清除**了 V43 已禁用的种子行，夹具随后才补建出 active 用户 —— 问题被掩盖，而非被修复 | + +**与 A6 生产改动无关**：401 由 `JwtAuthenticationFilter` / `AuthSessionService` 在请求进入 +Controller 之前产生（`Handler: Type = null`），A6 只改了 5 个 Controller 内部取身份 / 取 +requestId 的写法，该路径上一行 A6 代码都未执行。独立复验的决定性对照实验：同一份含 A6 的 +代码，单跑 Fairness 为 7 run / 6 failures，而让 `AuthIntegrationTest` 先跑则为 **7 run / 0 failures**。 + +`mvn clean verify`（全量顺序）下 **2278/2278 全通过**，该失败不触发。 + +按任务书要求：**未把失败写成通过，未在本批顺手修复**；该夹具问题将在 A6 提交后 +**以独立纯测试提交修复**（不与本批生产改动混合）。 + +--- + +## 11. OpenAPI + +`python docs\verify_openapi.py` → **176 paths / 214 operations**，All checks passed ✔ + +**`docs/openapi-rc.json` 零修改** ✔ + +--- + +## 12. 精确修改文件 + +**生产代码（5 个，全部在 A6 指定清单内）** + +``` +mydreamjob-server/src/main/java/com/mydreamjob/controller/ApiController.java +mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java +mydreamjob-server/src/main/java/com/mydreamjob/controller/SystemController.java +mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java +mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringController.java +``` + +**测试（新增 2 个）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/R01A6RequestContextMigrationIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringProbeTest.java +``` + +**文档（2 个）** + +``` +docs/r01-a6-final-request-context-migration-report.md # 本报告 +docs/backend-development-roadmap.md # 仅更新顶部 R01 状态行 +``` + +**未修改**：Service、DTO、`ErrorCode`、Flyway、`SecurityConfig`、Filter、Accessor、OpenAPI、既有测试、`UserRoleGuard`。 + +--- + +## 13. Flyway / ErrorCode / DTO / 接口 + +| 项 | 结果 | +|---|---| +| V1–V45 迁移 | **零修改** ✔ | +| `ErrorCode.java` | **零改动** ✔ | +| DTO | **零改动** ✔ | +| 公网接口 / OpenAPI | **零新增零修改** ✔ | +| 新增表 / 索引 / 迁移 | **无** ✔ | + +--- + +## 14. Git 状态 + +``` +git diff --check → 无输出 +git status --short → 8 个生产/文档改动 + GlobalExceptionHandler（stat 缓存标记） +git diff --cached --name-only → 空 +git diff --name-only -- db/migration → 空 +git diff -- docs/openapi-rc.json → 空 +``` + +- `GlobalExceptionHandler.java`：工作区 / 索引 / HEAD 三方 blob 均为 `1fdc341e…`，**内容零差异**，未触碰 ✔ +- 临时基线 worktree 已 `--force` 移除并 prune，`git worktree list` 仅主仓库 ✔ + +--- + +## 15. 明确声明 + +- **未暂存、未提交、未推送。** +- 未操作 Docker。 +- **未进入 R01-B / R01-C / R01-E。** +- 未修改基础设施类（`RequestIdFilter`、`RequestIdAccessor`、`RequestLoggingFilter`、`AuditContext`、`GlobalExceptionHandler`、`SecurityConfig`）。 +- 未删除历史未跟踪文件。 +- 基线测试污染已用 HEAD 隔离 worktree 复现并如实记录，**未写成通过、未顺手修复**。 + +--- + +> **R01-A6最终业务Controller请求上下文收束完成，待独立代码复验；A系列到此结束，不再拆分A7/A8。** diff --git a/docs/r01-a6-independent-verification-20260917.md b/docs/r01-a6-independent-verification-20260917.md new file mode 100644 index 0000000..3691a2a --- /dev/null +++ b/docs/r01-a6-independent-verification-20260917.md @@ -0,0 +1,492 @@ +# R01-A6 独立代码复验报告（最终批：5 个 Controller 请求身份与 requestId 收束） + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +HEAD：`534afe686b966f175bcaf4af0726cec061092050`（A5 提交；复验全程未变） +暂存区：**空** +复验对象：`docs/r01-a6-final-request-context-migration-report.md` +性质：**仅复验** —— 未修改生产代码、未修改既有测试断言、未暂存、未提交、未推送 + +--- + +## 0. 结论 + +> **R01-A6独立代码复验通过，可以进入精确暂存与独立提交检查点；A系列到此结束，不再设置A7/A8。FairnessMonitoringControllerTest的单跑夹具缺陷须在A6提交后以独立纯测试提交修复。** + +**业务 Controller 身份解析残留 = 0；业务 Controller requestId 重复解析残留 = 0。** +剩余命中全部落在基础设施职责内（身份 3 文件、requestId 5 文件）。 + +**未发现 A6 引入的生产缺陷。** `FairnessMonitoringControllerTest` 的单跑失败经证据链确认为 +**测试夹具缺陷**（`TestAuthTokens` 对"已存在但被禁用"的用户行不做激活）， +**与 A6 生产改动无关**；其准确根因见 §9。 + +--- + +## 1. 开始前状态 + +| 项 | 结果 | +|---|---| +| `git branch --show-current` | `refactor/r01-structure-performance` | +| `git rev-parse HEAD` | `534afe686b966f175bcaf4af0726cec061092050` | +| `git diff --cached --name-only` | **空**（暂存区为空） | +| `git diff --check` | 仅 `docs/backend-development-roadmap.md` 的 LF/CRLF 警告，**exit 0**，无空白错误 | +| Java/Maven 残留进程 | 无 | + +工作区改动共 6 个文件：5 个生产 Controller + `docs/backend-development-roadmap.md`。 + +--- + +## 2. 五个 Controller 静态审查 + +`git diff --stat`： + +``` +docs/backend-development-roadmap.md | 2 +- +.../com/mydreamjob/controller/ApiController.java | 12 +++++--- +.../com/mydreamjob/controller/AuthController.java | 33 +++++++++++----------- +.../mydreamjob/controller/SystemController.java | 14 +++++---- +.../java/com/mydreamjob/job/JobController.java | 21 +++++++------- +.../FairnessMonitoringController.java | 25 +++++++--------- +6 files changed, 54 insertions(+), 53 deletions(-) +``` + +| 项 | 结果 | +|---|---| +| 修改范围是否仅限 A6 清单内 5 个 Controller | **是** ✔ | +| 是否新增接口 / ErrorCode / Flyway / 表 / 索引 / 依赖 | **否** ✔ | +| 是否触碰 `SecurityConfig` / Filter / Accessor / `GlobalExceptionHandler` | **否** ✔ | +| 是否修改既有测试文件 | **否** ✔（`git status` 中无任何 `src/test` 既有文件被修改） | + +### 2.1 禁止模式扫描（静态门禁） + +对 5 个 Controller 逐一扫描 `X-Request-Id` 直读、`SecurityContextHolder`、 +`getAuthentication()`、`Long.valueOf(auth.getName())`： + +| 文件 | 命中 | +|---|---| +| `controller/ApiController.java` | **0** ✔ | +| `controller/AuthController.java` | **0** ✔ | +| `controller/SystemController.java` | **0** ✔ | +| `job/JobController.java` | **0** ✔ | +| `scoringmonitoring/FairnessMonitoringController.java` | **0** ✔ | + +全仓 `*Controller.java` 扫描同一组模式：**0 命中** ✔ + +### 2.2 构造器注入与无回退 + +`ApiController`、`SystemController` 新增 `@RequiredArgsConstructor` 并声明 +`private final CurrentUserAccessor` / `private final RequestIdAccessor`； +`AuthController`、`JobController`、`FairnessMonitoringController` 复用既有 +`@RequiredArgsConstructor`。**全部为 final 构造器注入，无字段默认值、无 `null` 回退、 +无 `new` 兜底实现** ✔ + +### 2.3 `GlobalExceptionHandler.java` 三方 blob 比对 + +``` +git hash-object → 1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21 +git rev-parse HEAD: → 1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21 +git ls-files -s → 100644 1fdc341ebe3653393b3ec04f0c2d0bb9dfbb6d21 0 +git diff --quiet → exit 0 +``` + +**工作区 blob 与 HEAD blob 完全一致**，该文件在 `git status` 中的 `M` 标记是 +**Windows stat 缓存假阳性**，未修改、未触碰 ✔ + +--- + +## 3. 删除的私有方法（真实数量：6） + +逐文件 `git diff` 核对（`-` 行为真实删除）： + +| # | 文件 | 删除的方法签名 | +|---|---|---| +| 1 | `controller/ApiController` | `private String getRequestId(HttpServletRequest)` | +| 2 | `controller/AuthController` | `private String getRequestId(HttpServletRequest)` | +| 3 | `controller/SystemController` | `private String getRequestId(HttpServletRequest)` | +| 4 | `job/JobController` | `private String getRequestId(HttpServletRequest)` | +| 5 | `scoringmonitoring/FairnessMonitoringController` | `private Long userId()` | +| 6 | `scoringmonitoring/FairnessMonitoringController` | `private String requestId(HttpServletRequest)` | + +**计数澄清**：`getRequestId` 名称的方法实际为 **4 个**； +`FairnessMonitoringController` 的 requestId 方法签名为 `requestId(HttpServletRequest)` +（**无 `get` 前缀**），不能被计入 `getRequestId`。 +正确分解为 **4 × `getRequestId` + 1 × `userId` + 1 × `requestId` = 6**， +与上表逐文件清单一致 ✔ + +**未为迎合任何数字修改生产代码** ✔ + +--- + +## 4. 独立接线变异证明 + +新增独立测试 `A6AccessorWiringIndependentTest` 将 `CurrentUserAccessor`、 +`RequestIdAccessor` 全部替换为 mock，覆盖 5 个 Controller 的代表端点 +（`/`、`/health`、`/auth/me`、`GET /jobs`、`/admin/scoring/fairness/drift`）： + +| 断言 | 结果 | +|---|---| +| 5 个端点响应体 `requestId` 均等于 mock 返回值 `a6-indep-request-id` | **通过** ✔ | +| Accessor 返回 4242 时 `service.drift(4242L)` 被调用 | **通过** ✔ | +| Accessor 返回 77L 时 `overview/dimensions/rankingStability` 收到 77L | **通过** ✔ | +| Accessor 抛 `InsufficientAuthenticationException` → 401 且 `service` 零调用 | **通过** ✔ | +| `POST /jobs` 企业侧身份经 `CurrentUserAccessor.requireUserId()` | **通过** ✔ | + +**变异检测含义**：若任一 Controller 把 `requestIdAccessor.get(request)` 换回直读 +`request.getHeader("X-Request-Id")`，响应体将不再出现 mock 值 → 该断言必然失败； +若 `FairnessMonitoringController` 换回直读 `SecurityContextHolder`， +`4242/77` 将不会传到 Service → 断言失败。**接线真实生效，非空转** ✔ + +--- + +## 5. 独立测试质量审查 + +复验对象： +`A6AccessorWiringIndependentTest`（6 个用例）、`A6IndependentVerificationTest`（7 个用例）。 + +| 核对项 | 结果 | +|---|---| +| 公开端点未被错误要求 401 | ✔ 无 Token 断言仅覆盖 `/auth/me` 与 `/admin/scoring/fairness/drift`，`/`、`/health`、`GET /jobs` 明确排除在断言之外 | +| JobController 身份接线使用真正需要企业身份的端点 | ✔ 改用 `POST /jobs`（`resolveCompanyId()` 路径），非公开的 `GET /jobs` | +| Service 参数验证不是空转 | ✔ 断言具体数值（4242 / 77），而非仅 `any()` | +| requestId 断言未错误声称响应头来自 Accessor | ✔ 只断言「响应头非空且已规范化」+「响应体 requestId 与响应头同源」；响应头由 `RequestIdFilter` 产出，未作错误归属 | +| 副作用快照列真实存在 | ✔ 9 张表列名逐一对齐迁移文件（`SCORING_RISK_EVENTS`、`SCORING_RISK_ACTIONS`、`JOBS`、`USERS`、`USER_ROLES`、`AUDIT_LOGS`、`NOTIFICATIONS`、`MESSAGES`、`CANDIDATE_DIMENSION_SCORES`） | +| 未修改或放宽既有测试 | ✔ 既有测试文件零改动 | +| 未通过过度 mock 绕过目标 Controller | ✔ 目标 Controller 全部真实（`@SpringBootTest` + `MockMvc`），只 mock 下游 Service 与两个 Accessor | + +### 5.1 独立测试首次运行的两处自身错误及修正 + +| # | 原断言 | 问题性质 | 修正 | +|---|---|---|---| +| 1 | 把公开端点路径 `/`、`/health`、`GET /jobs` 也断言为无 Token 401 | **测试自身错误**（公开端点本不应 401），非生产缺陷 | 断言范围收窄为 `/auth/me`、`/admin/scoring/fairness/drift` 两个需认证端点 | +| 2 | 用公开的 `GET /jobs` 验证 `JobController` 的身份 Accessor 接线 | **测试自身错误**（该端点不解析身份，断言无意义） | 改用 `POST /jobs` 企业侧端点 | + +**两处均为新测试自身缺陷，已修正；未修改生产代码，未修改任何既有测试。** +修正后两个类合计 **13/13 通过**。 + +--- + +## 6. 身份边界与 401 / 403 / 404 分层 + +### 6.1 非法主体一律 401（真实 Accessor + 真实 SecurityFilterChain） + +对主体 `anonymousUser`、`not-a-number`、`99999999999999999999`、`0`、`-1`， +以及 `AnonymousAuthenticationToken` 和完全无 Token： + +| 断言 | 结果 | +|---|---| +| 状态码一律 **401**（不得 400/500） | ✔ | +| 响应体 `code = 401` | ✔ | +| `message` ∈ {`authentication required`, `not authenticated`} | ✔ | +| `message` 不回显异常类名、`java.`、`principal`、`anonymousUser`、`com.mydreamjob`、`NumberFormat` | ✔ | +| 响应体无 `stackTrace` / `trace` | ✔ | +| 业务 Service **零调用** | ✔ | +| 合法数字主体（`7`）不被身份层拒绝 | ✔ | + +### 6.2 401 / 403 / 404 分层未漂移 + +静态审查确认：A6 diff **未删除、未新增任何角色校验或资源归属校验**； +`JobController.resolveCompanyId()` 与 `jobService.assertOwnerOrThrow(companyId, jobId)` 原样保留， +`AuthController` 的「已注销手机号 → HTTP 409 / code=9303」分支原样保留。 + +既有契约由既有测试继续守护且**全部通过**（例：`AuthenticationBoundaryIntegrationTest` +对 `POST /jobs` 断言 `403` + `ErrorCode.FORBIDDEN`）。**403 / 404 契约未漂移** ✔ + +--- + +## 7. requestId 语义 + +对 5 个 Controller 的代表端点，注入 `X-Request-Id` ∈ +{`a6v-legal-1`, 全空白, 90 字符超长, `x`, `a b`}： + +| 断言 | 结果 | +|---|---| +| 响应头 `X-Request-Id` 非空 | ✔ | +| 不含 `<`、`>`、空格、CR、LF | ✔ | +| 长度 ≤ 32 | ✔ | +| 响应体 `"requestId":"<响应头同值>"` | ✔ | +| 请求属性优先于原始 Header | ✔ | +| CR/LF 不进入规范化结果（6 组恶意输入） | ✔ | + +--- + +## 8. 失败请求的业务副作用 + +`illegalIdentity_producesNoBusinessWrite`：对 9 张核心表按显式列 + 稳定主键排序做全量快照， +执行 5 组非法主体请求 + 1 组无 Token 请求后再次快照。 + +| 结果 | +|---| +| 9 张表**逐字段零变化** ✔ | + +--- + +## 9. `FairnessMonitoringControllerTest` 单跑：真实结果与准确根因 + +### 9.1 单跑命令与真实结果（**不写成通过**） + +``` +mvn -Dtest="FairnessMonitoringControllerTest" test +``` + +日志：`docs/acceptance/r01-d4-2-20260916/a6v-fairness-repeat.log` + +``` +Tests run: 7, Failures: 6, Errors: 0, Skipped: 0 +BUILD FAILURE +``` + +6 个失败全部是 `Status expected:<200|403|400> but was:<401>`； +唯一通过的是 `anonymous_isUnauthorized`（不发 Token 的那个）。 + +### 9.2 逐项查明（任务书第 2 步的 6 个问题） + +| # | 问题 | 结论 | 证据 | +|---|---|---|---| +| 1 | HTTP 实际状态 | **401**，响应体 `{"code":401,"message":"not authenticated","timestamp":""}` | MockHttpServletResponse 输出；`Handler: Type = null`（请求**未进入任何 Controller**） | +| 2 | Filter 为什么拒绝 | 不是验签失败，而是**服务端会话校验的用户检查失败** | 日志：`AuthSessionService - session validation rejected: user not usable` → `JwtAuthenticationFilter - JWT authentication rejected: session not active` | +| 3 | 测试用户是否存在且 `is_active = true` | **行存在，但 `is_active = 0`**（不是"不存在"，也不是"active"） | 见 §9.3 推理链 | +| 4 | `auth_tokens` 会话记录是否存在/未过期/未消费/未撤销 | **存在且有效**；拒绝发生在读取会话记录**之前** | `TestAuthTokens.writeSession` 自身执行 `SELECT COUNT(*) FROM auth_tokens WHERE user_id=? AND session_id=? AND revoked=0 AND consumed_at IS NULL AND expired_at > ?`，不可见即抛 `IllegalStateException`；日志中**无该异常**，说明会话行有效。而 `isSessionActive()` 先判用户、后判会话，拒绝文本是 "user not usable" 而非 "no active session" | +| 5 | JWT 的 `sid/jti/sub/type/aud/iss` 是否与库一致 | **一致**；JWT 本身完全合法 | `parseAndValidateAccessToken` **未抛异常**（否则拒绝路径不同）。日志中 Token 载荷：`sub=1`、`type=access`、`sid=0073abf7-…`、`role=ADMIN`、`iss=mydreamjob`、`aud=["mydreamjob-api"]`、`iat=1577836800`(2020-01-01)、`exp=2523916800`(2050-01-01)，与夹具 `FIXTURE_BASE`/30 年 TTL 完全对应；`sid` 即写入 `auth_tokens.session_id` 的同值 | +| 6 | 是否真的与 `user_roles` 有关 | **无关** | `AuthSessionService.isUsable(User)` 只读 `user.getActive()`；`UserRepository.findById` 无角色过滤；该路径**从不查询 `user_roles`** | + +### 9.3 准确根因（证据链，取代此前未经证实的 `user_roles` 说法） + +**根因：`TestAuthTokens` 夹具只对"不存在的" `users.id` 执行 INSERT，对"已存在但 `is_active=0`"的行不做激活，而 `V1_1` 种子账号恰好占用 id=1/2/3 并被 `V43` 置为禁用。** + +证据链（逐步闭合）： + +1. `V1_1__seed_data.sql` 按自增插入三名演示账号 → 占据 `users.id = 1 / 2 / 3` + （`13800000001` ADMIN、`13800000002` STUDENT、`13800000003` COMPANY）。 +2. `V43__disable_legacy_seed_accounts.sql` 按原始指纹把这三行 `is_active` 置为 **0**。 +3. `FairnessMonitoringControllerTest` 使用 `token(1L, "ADMIN")` / `token(2L, "STUDENT")` + → 命中 id=1/2 这两个**已被禁用的种子行**。 +4. `TestAuthTokens.writeSession()` 的行为是： + ```java + SELECT COUNT(*) FROM users WHERE id = ? // id=1 已存在 → count = 1 + if (count == null || count == 0) { INSERT ... is_active=1 } // → 被跳过，永不激活 + ``` + 即夹具**只补建缺失行，不修复既有行的启用状态**。 +5. `users.created_at` / `updated_at` 在 `V1__base_schema.sql` 中均有 + `DEFAULT CURRENT_TIMESTAMP`，因此"若行不存在则夹具 INSERT 必然成功且 `is_active=1`"成立。 + 既然实际观察到 401（而非 500/ERROR），**只可能是行已存在且 `is_active=0`** —— 推理闭合。 +6. `AuthSessionService.isSessionActive()` 第一步 `isUserUsable(userId)` 因此返回 false， + 直接短路返回，**从未走到会话记录检查**，与日志文本完全吻合。 + +### 9.4 与 A6 生产改动的归因判定：**无关** + +| 判据 | 内容 | +|---|---| +| 代码路径 | 401 由 `JwtAuthenticationFilter` / `AuthSessionService` 在**请求进入 Controller 之前**产生（`Handler: Type = null`）。A6 只改了 5 个 Controller 内部取 requestId / 取身份的写法，**该路径上一行 A6 代码都未执行** | +| A6 diff 范围 | 仅 5 个 Controller + 文档；`SecurityConfig`、Filter、`AuthSessionService`、`UserRepository`、`TestAuthTokens`、Flyway 迁移**零改动** | +| 失败面 | 7 个用例中，唯一不携带 Token 的用例通过；其余全部 401 —— 与「Token 认证链路在用户检查处失败」完全一致，与「Controller 被改写」不一致 | + +### 9.5 为何全量顺序下不触发（机制已定位，非"偶然"） + +`com.mydreamjob.controller.AuthIntegrationTest` 的 `@BeforeEach`（源码第 97 行）执行 +`userRepository.deleteAll();`，在**共享的 `integrationdb`**（无 `@TestPropertySource` 覆盖）上 +**清空全部用户，包括 V43 已禁用的 V1_1 种子行**。 + +全量日志 `docs/acceptance/r01-d4-2-20260916/a3-commit-cv.log` 的执行顺序印证： + +``` +第 151767 行 [INFO] Running com.mydreamjob.controller.AuthIntegrationTest +第 247038 行 [INFO] Running com.mydreamjob.scoringmonitoring.FairnessMonitoringControllerTest +``` + +种子行被清空后，夹具第 4 步的 `COUNT(*)` 变为 0 → **INSERT 补建 `is_active=1` 的用户** → +用户检查通过 → 该类在全量顺序下 7/7 通过。 + +因此：**同一份代码，只因子夹具前置数据不同而结果不同 —— 属顺序依赖的夹具脆弱性， +不是被测代码的缺陷。** + +**决定性对照实验**（不新增任何文件、不修改任何代码，只改变前置数据）： + +``` +mvn -Dtest="com.mydreamjob.controller.AuthIntegrationTest,FairnessMonitoringControllerTest" test +``` + +日志：`docs/acceptance/r01-d4-2-20260916/a6v-fairness-mechanism.log` + +``` +[INFO] Running com.mydreamjob.controller.AuthIntegrationTest +[INFO] Tests run: 6, Failures: 0, Errors: 0, Skipped: 0 -- in ...AuthIntegrationTest +[INFO] Running com.mydreamjob.scoringmonitoring.FairnessMonitoringControllerTest +[INFO] Tests run: 7, Failures: 0, Errors: 0, Skipped: 0 -- in ...FairnessMonitoringControllerTest +[INFO] BUILD SUCCESS +``` + +| 运行方式 | 同一份含 A6 的代码 | 结果 | +|---|---|---| +| 单独运行 Fairness | A6 在场 | **7 run / 6 failures** | +| AuthIntegrationTest 先运行 | A6 在场 | **7 run / 0 failures** | +| 全量 `mvn clean verify` | A6 在场 | **7 run / 0 failures** | + +**A6 代码在三行中完全相同，唯一变量是前置数据** —— 归因判定为夹具脆弱性的直接实验证据。 + +### 9.6 处置 + +- **不修改生产代码** ✔ +- **不修改既有 `FairnessMonitoringControllerTest`** ✔ +- 该缺陷列为 **A6 提交后的独立纯测试修复**：让 `TestAuthTokens` 在行已存在时 + 显式确保 `is_active = 1`（或改用不与 V1_1 种子账号冲突的 userId）。 +- **未把该单跑命令写成通过** ✔ + +--- + +## 10. 全仓剩余统计（逐文件分类） + +**身份解析**（`SecurityContextHolder.getContext().getAuthentication` / +`Long.(valueOf|parseLong)(...getName())`）—— **3 文件** + +| 文件 | 分类 | +|---|---| +| `security/CurrentUserAccessor` | 基础设施（Accessor 自身） | +| `auth/JwtAuthenticationFilter` | 基础设施（认证过滤器） | +| `deletion/DeletionGuardInterceptor` | 基础设施（拦截器） | + +**requestId 解析**（`X-Request-Id` 直读）—— **5 文件** + +| 文件 | 分类 | +|---|---| +| `audit/AuditContext` | 基础设施 | +| `common/logging/RequestIdAccessor` | 基础设施（Accessor 自身） | +| `common/logging/RequestIdFilter` | 基础设施（过滤器） | +| `common/logging/RequestLoggingFilter` | 基础设施 | +| `deletion/DeletionGuardInterceptor` | 基础设施 | + +**业务 Controller 残留：身份解析 0、requestId 重复解析 0** ✔ + +--- + +## 11. 测试数 + +### 11.1 A6 定向 + +``` +mvn -Dtest="R01A6RequestContextMigrationIntegrationTest,A6*Test,CurrentUserAccessorTest,RequestIdAccessorTest,RequestIdFilterTest" test +``` + +日志：`docs/acceptance/r01-d4-2-20260916/a6v-v1-targeted.log` + +| 测试类 | Tests | +|---|---| +| `common.r01a6.R01A6RequestContextMigrationIntegrationTest` | 7 | +| `common.r01a6.A6AccessorWiringProbeTest` | 3 | +| `common.r01a6.A6AccessorWiringIndependentTest` | 6 | +| `common.r01a6.A6IndependentVerificationTest` | 7 | +| `security.CurrentUserAccessorTest` | 11 | +| `common.logging.RequestIdAccessorTest` | 16 | +| `common.logging.RequestIdFilterTest` | 3 | +| **合计** | **53 / 53**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS ✔ | + +### 11.2 A6 关联 + +``` +mvn -Dtest="*ApiController*Test,*AuthController*Test,*SystemController*Test,*JobController*Test,*Security*Test,*RequestId*Test" test +``` + +日志：`docs/acceptance/r01-d4-2-20260916/a6v-v2-related.log` + +| 测试类 | Tests | +|---|---| +| `auth.SmsVerificationSecurityTest` | 10 | +| `common.logging.RequestIdAccessorTest` | 16 | +| `common.logging.RequestIdFilterTest` | 3 | +| **合计** | **29 / 29**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS ✔ | + +> **说明**：该命令的 `*ApiController*Test`、`*AuthController*Test`、`*SystemController*Test`、 +> `*JobController*Test` 四个模式在本仓库**不存在同名测试类**（`find` 全量核对： +> 无 `ApiControllerTest` / `SystemControllerTest` / `JobControllerTest` / `AuthControllerTest`）， +> 故只命中上表 3 个类。这 5 个 Controller 的既有覆盖由 +> `mvn clean verify` 全量承担（含 `AuthenticationBoundaryIntegrationTest` 对 `POST /jobs` +> 的 403 断言、`controller.AuthIntegrationTest` 的登录/刷新/登出全链路等）。**未因此放宽任何断言。** + +### 11.3 全量 + +``` +mvn clean verify +``` + +日志：`docs/acceptance/r01-d4-2-20260916/a6v-v3-verify.log` + +``` +[INFO] Tests run: 2278, Failures: 0, Errors: 0, Skipped: 0 +[INFO] BUILD SUCCESS +``` + +| 项 | 数值 | +|---|---| +| 全量测试总数 | **2278** | +| Failures | **0** ✔ | +| Errors | **0** ✔ | +| Skipped | **0** ✔ | +| 原实施基线 | 2265 | +| 独立新增 | **13**（`A6AccessorWiringIndependentTest` 6 + `A6IndependentVerificationTest` 7） | +| 2265 + 13 | **2278** ✔ 与 Surefire 汇总完全一致 | + +**无需要按 Surefire XML 另行解释的差异** —— 汇总行与预期逐位吻合。 + +### 11.4 `FairnessMonitoringControllerTest` 单跑（**不计入通过**） + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="FairnessMonitoringControllerTest" test` | **7 run / 6 failures / 0 errors / 0 skipped，BUILD FAILURE** | + +按任务书要求：**该单跑命令不写成通过**，其失败与准确根因见 §9。 + +--- + +## 12. OpenAPI + +``` +python ..\docs\verify_openapi.py +→ paths: 176 / operations: 214 +→ All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空**，`openapi-rc.json` 零修改 ✔ + +--- + +## 13. Flyway / ErrorCode / DTO / 接口 + +| 项 | 结果 | +|---|---| +| `git diff --name-only -- mydreamjob-server/src/main/resources/db/migration` | **空** —— V1–V45 未改动 ✔ | +| `ErrorCode` | 未修改 ✔ | +| DTO / 响应体结构 | 未修改（仅取值来源改变） ✔ | +| 接口（路径 / 方法 / 参数） | 未新增、未删除、未改签名 ✔ | +| 依赖（`pom.xml`） | 未修改 ✔ | + +--- + +## 14. Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` | +| HEAD | `534afe686b966f175bcaf4af0726cec061092050`（未变） | +| `git diff --cached --name-only` | **空** | +| `git diff --check` | 仅 LF/CRLF 警告，exit 0 | +| 已暂存 / 已提交 / 已推送 | **均无** ✔（`git log -1` 仍为 A5 提交 `534afe6`） | +| 与远端关系 | `## refactor/r01-structure-performance...origin/refactor/r01-structure-performance`（无 ahead/behind） | +| 历史未跟踪文件 | 未删除 ✔ | +| 本轮验收日志 | 位于 `docs/acceptance/r01-d4-2-20260916/`，该路径被 `.gitignore:43 **/*.log` 忽略（`docs/acceptance` 受版本管理的文件数为 0），**不会进入任何提交** ✔ | +| 残留 Java/Maven 进程 | 无 ✔ | + +--- + +## 15. 明确声明 + +- **未暂存、未提交、未推送。** +- 未修改任何生产代码；未修改、删除或放宽任何既有测试断言； + 未修改 `GlobalExceptionHandler`、`SecurityConfig`、Filter、Accessor、`ErrorCode`、DTO、 + OpenAPI、Flyway 迁移与 V1–V45。 +- 本轮仅新增 `docs/r01-a6-independent-verification-20260917.md` 与验收日志； + 独立测试自身的两处缺陷已就地修正（§5.1），未触碰生产代码与既有测试。 +- 未进入 R01-B；**A 系列到此结束，不再设置 A7/A8**。 +- 本轮未启动 Docker，**未伪造真实 MySQL 结论**。 + +--- + +> **R01-A6独立代码复验通过，可以进入精确暂存与独立提交检查点；A系列到此结束，不再设置A7/A8。FairnessMonitoringControllerTest的单跑夹具缺陷须在A6提交后以独立纯测试提交修复。** diff --git a/docs/r01-b-authorization-exception-mapping-report.md b/docs/r01-b-authorization-exception-mapping-report.md new file mode 100644 index 0000000..288a5fb --- /dev/null +++ b/docs/r01-b-authorization-exception-mapping-report.md @@ -0,0 +1,497 @@ +# R01-B 角色授权与异常映射收束报告 + +日期：2026-09-17 +分支：`refactor/r01-structure-performance` +HEAD：`84fe9f5febcf56910d5c978dd44e0e16d15d7209`（A6 后夹具修复提交） +本轮性质：**实施与自动化验证** —— 未暂存、未提交、未推送，待独立代码复验 +范围：**B1 角色授权重复收束 + B2 异常到 HTTP 状态映射收束**（不拆分子阶段，不进入 R01-C/E） + +--- + +## 0. 结论 + +> **R01-B角色授权与异常映射收束完成，待独立代码复验。** + +- 角色授权重复逻辑收束到唯一实现点 `security/UserRoleGuard`，**54 个调用点**改走公共 guard； + 角色 guard 方法定义 **32 → 21**，`getRoles()` 角色比较 **46 处 / 31 文件 → 23 处 / 16 文件**； +- HTTP 状态映射收束到 `common/exception/ErrorHttpStatusRegistry`，`GlobalExceptionHandler` + 不再持有映射表；**112 个 ErrorCode 的映射逐项保持不变**，未映射的 54 个仍回退 400； +- 收束过程中发现一处既有潜在缺陷（`ErrorCode` 166 个常量只有 165 个唯一数字码）， + **已记录、未擅自修改**（见 §9.4）。 + +--- + +## 1. 前置 Git 状态 + +| 项 | 结果 | +|---|---| +| `git branch --show-current` | `refactor/r01-structure-performance` | +| `git rev-parse HEAD` | `84fe9f5febcf56910d5c978dd44e0e16d15d7209` | +| `git rev-list --left-right --count HEAD...@{upstream}` | `0 0` | +| `git diff --cached --name-only` | **空** | +| `git diff --check` | 仅 LF/CRLF 警告，**exit 0** | +| 与目标文件重叠的未提交修改 | **无**。`GlobalExceptionHandler.java` 在 `git status` 中显示 `M`，但 `git hash-object` = `git rev-parse HEAD:` = `1fdc341e…`，`git diff --quiet` exit 0 —— 属 Windows stat 缓存假阳性，非真实修改 | + +--- + +## 2. 角色授权库存（重构前） + +搜索范围：`mydreamjob-server/src/main/java`。 +重构前共 **32 个**角色 guard 方法定义 + **7 个** `private boolean hasRole(User, Role)` 助手。 + +**共同语义（近乎逐字相同的复制）**： + +``` +User user = userRepository.findById(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); +boolean ok = user.getRoles().stream().anyMatch(r -> r == User.Role.X); // user_roles +if (!ok) throw new BusinessException(ErrorCode.FORBIDDEN); +``` + +| 项 | 统一事实 | +|---|---| +| 输入来源 | 已解析出的 `userId`（由 `CurrentUserAccessor` 或调用方传入），**没有任何一处从请求参数取角色** | +| 角色来源 | **`user_roles` 关联表**（`user.getRoles()`）—— 31 个文件、46 处 `getRoles()`；`users.role` 单值列**不**参与授权判定（它只用于 JWT 声明签发） | +| 失败错误码 | 用户不存在 → `USER_NOT_FOUND`(4001)；角色不符 → `FORBIDDEN`(2002) | +| HTTP 状态 | 4001 → 404；2002 → 403（经 §3 的映射表） | +| 是否含资源归属 | **不含**。归属（如 `assertOwnerOrThrow`、`findByOwnerUserId`）由各业务 Service 独立执行 | +| 是否允许 ADMIN | **不允许**（无隐式超级权限）；`requireAny` 由调用方显式列出 ADMIN 才放行 | +| 可否安全委托 | 纯 void 角色门禁 → **可**；返回 `Company` 实体的 `requireCompany` → **不可整体委托**（见 §7） | + +--- + +## 3. HTTP 映射库存（重构前） + +`GlobalExceptionHandler.buildBusinessHttpStatuses()`（第 71–136 行）+ `register()`（第 138–147 行） ++ `resolveHttpStatus()`（第 67–69 行），共 **112 个 `ErrorCode` 引用**： + +| HttpStatus | 数量 | 备注 | +|---|---|---| +| CONFLICT | 77 | | +| NOT_FOUND | 27 | | +| FORBIDDEN | 5 | `FORBIDDEN`、`INTERVIEW_ACCESS_DENIED`、`APPLICATION_OWNER_MISMATCH`、`MATCH_REQUIRED_FOR_CONVERSATION`、`OFFER_COMPARE_NOT_OWNER` | +| TOO_MANY_REQUESTS | 3 | | +| **合计** | **112** | | + +| 项 | 结果 | +|---|---| +| 重复键 | **0**（112 个 `ErrorCode` 常量互不相同） | +| 重复项映射一致性 | 不适用 | +| 未显式映射的 ErrorCode | **54 / 166** → 一律回退 **HTTP 400** | +| 关键既有语义 | `UNAUTHORIZED(2001)` **未显式映射 → 400**（不是 401）；`SERVICE_UNAVAILABLE`、`RATE_LIMITED`、`INTERNAL_ERROR` 同为 **400** | +| 已有测试锁定状态码 | **有**：`GlobalExceptionHandlerStatusContractTest` 以 `@EnumSource(ErrorCode.class)` 对**全部 166 个**错误码锁定状态 + 业务码 + message + requestId | + +**快照已保存**：`docs/acceptance/r01-b/b2-mapping-baseline.json`（112 条 `名称 → 状态`）， +并逐条转写进 `GlobalExceptionHandlerMappingParityTest` 作为独立基线。 + +--- + +## 4. 修复前失败测试（红灯） + +| 观察 | 说明 | +|---|---| +| 角色授权 | 重构前**没有**公共 guard：32 个方法各自实现，无任何调用点经过统一入口。新增的 `RoleAuthorizationIntegrationTest` 以 `@SpyBean UserRoleGuard` 断言"端点确实调用公共 guard"——在重构前该 bean 不存在，测试无法编译/通过 | +| HTTP 映射 | 重构前映射表在 `GlobalExceptionHandler` 内部，**无法在初始化期检出重复键**（`register()` 仅在"同码不同状态"时抛错，同码同状态被静默容忍）；新增的 `ErrorHttpStatusRegistryTest` 直接断言"同码重复注册必须抛 `IllegalStateException`"——重构前无从表达 | +| 未改变任何既有业务期望 | `GlobalExceptionHandlerStatusContractTest` 的 4 个状态桶与全部断言**逐字保留**，仅把其反射调用私有方法的用例改为调用 `registry.resolve(int)` | + +--- + +## 5. 公共角色 guard 设计 + +新增 `security/UserRoleGuard.java`（`@Component`，仅依赖 `UserRepository`）。 + +```java +void requireStudent(Long userId); void requireStudent(User user); +void requireCompany(Long userId); void requireCompany(User user); +void requireAdmin(Long userId); void requireAdmin(User user); +void requireAny(Long userId, User.Role... allowedRoles); +void requireAny(User user, User.Role... allowedRoles); +User requireUser(Long userId); // 存在性 + active 校验 +void requireRole(User user, User.Role... allowedRoles); +``` + +| 要求 | 落实 | +|---|---| +| 角色来自权威数据库 | 从 `user_roles`（`user.getRoles()`）读取，与全部被替换的实现一致 | +| 校验存在且 active | `requireUser` 不存在 → `USER_NOT_FOUND`；**存在但 inactive → `FORBIDDEN`（失败关闭）** | +| `users.role` 与 `user_roles` 核对 | 授权**只**依据 `user_roles`；`users.role` 与之不一致时按 `user_roles` 判定 → 缺少所需角色即拒绝（失败关闭）。**混用两者会改变既有语义，故未采纳** | +| 复用现有 ErrorCode | 只用 `USER_NOT_FOUND` / `FORBIDDEN`，**未新增任何 ErrorCode** | +| 不解析 SecurityContext | 只接收 `userId`；结构断言验证其声明字段**只有** `UserRepository` | +| 不处理 requestId | 无 `HttpServletRequest`、无 `RequestIdAccessor` | +| 不处理资源归属 | 类中无任何 ownership 逻辑 | +| 不记录敏感信息 | 无日志、无审计写入，无副作用 | +| 无隐式 ADMIN | `requireStudent`/`requireCompany` 对 ADMIN 同样拒绝，测试已锁定 | +| 查询次数受控 | `requireXxx(Long)` 恰好 **1** 次 `findById`；`requireXxx(User)` **0** 次；**无跨请求缓存**（用户被禁用/注销后立即失效） | + +检索确认：仓库中**原本不存在** `UserRoleGuard` 或等价的公共角色组件，故新增； +未新建重复角色枚举（复用既有 `User.Role`）。 + +--- + +## 6. 每个迁移调用点（54 处） + +`userRoleGuard.requireStudent` **37** 处、`requireAdmin` **13** 处、`requireCompany` **4** 处， +覆盖 **21 个生产文件**。 + +| # | 文件 | 原方法 | 迁移后 | +|---|---|---|---| +| 1 | `ability/AbilityAttemptService` | `requireStudent`(私有) | 删除，6 处改调 guard | +| 2 | `assessment/AssessmentAttemptService` | `requireStudent`(私有) | 删除，5 处改调 guard | +| 3 | `bidirectionalmatch/MatchRuleService` | `requireStudent`(私有) | 删除，2 处改调 guard | +| 4 | `careerprogress/CareerProgressService` | `assertStudentRole`(私有) | 删除，1 处改调 guard | +| 5 | `competition/CompetitionRankingService` | `assertStudentRole`(私有) | 删除，1 处改调 guard | +| 6 | `job/JobFavoriteService` | `assertStudentRole`(私有) | 删除，3 处改调 guard | +| 7 | `match/MatchService` | `assertStudentRole`(私有) | 删除，1 处改调 guard | +| 8 | `review/JobReviewService` | `assertStudentRole`+`assertAdminRole`(私有) | 删除，3+3 处改调 guard | +| 9 | `talentdiscovery/TalentDiscoveryService` | `requireStudent`(私有) | 删除，2 处改调 guard | +| 10 | `talentinvitation/TalentInvitationService` | `requireStudent`(私有) | 删除，3 处改调 guard | +| 11 | `recommendation/JobRecommendationService` | `requireStudent`+`requireAdmin`(私有) | 删除，3+2 处改调 guard | +| 12 | `candidatescore/governance/CandidateScoringGovernanceService` | `assertStudentRole`+`assertAdminRole`(私有) | 删除，3+4 处改调 guard | +| 13 | `candidatescore/dashboard/CompanyScoringDashboardService` | `assertAdminRole`(私有) | 删除，1 处改调 guard | +| 14 | `application/ApplicationController` | `assertCompanyRole`(私有) | 删除，3 处改调 guard | +| 15 | `safety/AdminReportController` | `requireAdmin(HttpServletRequest)` | 保留方法（返回 userId），角色部分委托 guard，3 处调用不变 | +| 16 | `risk/AdminRiskController` | `requireAdmin(HttpServletRequest)` | 同上，7 处调用不变；随之移除已不需要的 `UserRepository` 字段与 import | +| 17 | `company/CompanyService` | `assertStudentRole`+`assertCompanyRole`(公开) | 保留签名，方法体改为一行委托 | +| 18 | `profile/ProfileService` | `assertStudentRole`(公开) | 保留签名，一行委托 | +| 19 | `preference/PreferenceService` | `assertStudentRole`(公开) | 保留签名，一行委托 | +| 20 | `privacy/PrivacySettingsService` | `assertStudentRole`(公开) | 保留签名，一行委托 | +| 21 | `verification/CompanyVerificationService` | `assertAdminRole`(公开) | 保留签名，一行委托 | + +**公开方法为何保留签名**：它们已被跨包调用（如 `profileService.assertStudentRole` 被 +`ResumeVersionService`、`ResumeExportService`、`ProfileController` 等调用； +`companyService.assertStudentRole` 被 `CandidateScoreCardController`、`CandidateScoringController`、 +`StudentReviewWeightService` 调用）。保留签名、把**实现**收敛为一行委托，可在不扩大改动面的前提下 +消除重复逻辑。**每个调用点的原错误码（`USER_NOT_FOUND`/`FORBIDDEN`）、原角色集合、 +原调用顺序均未改变。** + +--- + +## 7. 保留调用点及理由（非等价，未迁移） + +| 类别 | 数量 | 保留理由 | +|---|---|---| +| `private Company requireCompany(Long)` | **7** —— `MatchRuleService`、`InterviewService`、`OfferService`、`CompanyReviewManagementService`、`CompanyReviewReplyService`、`CompanyVerificationService`、`CompanyScoringDashboardService` | **不是纯角色门禁**：除角色判定外还承担实体查找与归属语义（`companyRepository.findByOwnerUserId(userId).orElseThrow(COMPANY_NOT_FOUND)`），返回值被业务逻辑使用。整体委托公共 guard 会改变查询次数与错误码（`COMPANY_NOT_FOUND` vs `USER_NOT_FOUND`），**按任务书要求不迁移不等价逻辑** | +| `private boolean hasRole(User, Role)` | **7** —— `InterviewService`、`InterviewScoreService`、`MessagingService`、`OfferService`、`TalentDiscoveryService`、`TalentInvitationService`、`CompanyVerificationService` | 用于**资源归属/可见性分支**（如 `hasRole(user, STUDENT) && interview.getStudentUserId().equals(userId)`、`MessagingService` 中 ADMIN 可见性分支），不是"必须具有某角色"的门禁。**角色授权与资源归属是两件事**，迁移会改变语义 | +| `AdminReportController`/`AdminRiskController.requireAdmin(HttpServletRequest)` | 2 | 第 15/16 行已委托 guard；保留该方法是因为它还负责返回 `userId`，属 Controller 内的便捷封装 | +| `CompanyService` 等 5 个公开方法 | 5 | 见 §6 末尾说明 | + +**未为"grep 为零"迁移任何不等价逻辑。** + +--- + +## 8. 角色 / 资源归属边界 + +| 边界 | 事实 | +|---|---| +| 身份（"我是谁"） | 仍由 `CurrentUserAccessor` 负责；`UserRoleGuard` **不**解析 SecurityContext（结构测试断言其唯一依赖是 `UserRepository`） | +| 角色授权（"我能不能"） | 收束到 `UserRoleGuard` | +| 资源归属（"这条数据是不是我的"） | **仍由各业务 Service 执行**，未删除、未移动。`RoleAuthorizationIntegrationTest.ownershipRemainsWithBusinessService` 用"角色正确但无企业实体的 COMPANY 用户"访问 +`/company/candidates/{id}` → 得到 **404**（业务层归属/存在性判定），证明 guard 既没有替代也没有跳过归属校验 | +| 403 / 404 分层 | 保持既有：角色不符 403(2002)；资源不存在 404（如 `RISK_EVENT_NOT_FOUND`） | + +--- + +## 9. B2 实现与逐项一致性 + +### 9.1 实现 + +新增 `common/exception/ErrorHttpStatusRegistry.java`： + +```java +public HttpStatus resolve(ErrorCode errorCode); +public HttpStatus resolve(int errorCode); // BusinessException 只暴露数字 code +public HttpStatus defaultStatus(); // 400 +public int explicitMappingCount(); // 112 +public static Map explicitMappingsView(); +public static Map numericMappingsView(); // 111 +``` + +| 要求 | 落实 | +|---|---| +| 不可变映射 | 构建后 `Map.copyOf(...)`，运行期 `put`/`remove` 抛 `UnsupportedOperationException`（测试锁定） | +| 键类型 | **`ErrorCode` 常量**（见 §9.4）；数字入口由该映射派生 | +| 初始化禁止重复键 | `Builder.put` 用 `putIfAbsent`，**同码重复注册即抛 `IllegalStateException`**（无论目标状态是否相同） | +| 显式映射集中一处 | 只在 `explicitMappings()` 内，全部 `ErrorCode.X` 符号，**无手写数字** | +| 未映射默认 400 | `DEFAULT_STATUS = BAD_REQUEST`，与重构前 `getOrDefault(code, BAD_REQUEST)` 一致 | +| 不引入反射扫描 | 无反射 | +| 不使用可运行时修改的 Map | 静态 final + `Map.copyOf` | +| Handler 只调用 registry | `GlobalExceptionHandler` 删除 `BUSINESS_HTTP_STATUSES`、`buildBusinessHttpStatuses()`、`register()`、`resolveHttpStatus()`；`handleBusinessException` 改为 `errorHttpStatusRegistry.resolve(errorCode)` | +| 同码映射到不同状态 | **未发现**（唯一同数字码的两个常量映射到同一状态，见 §9.4） | + +`ErrorHttpStatusRegistry` 通过 `@Import` 挂在 `GlobalExceptionHandler` 上，使 `@WebMvcTest` 切片 +（`CompanyControllerMvcTest`）无需改动即可解析到该组件。 + +### 9.2 响应契约未变 + +- 响应 JSON 结构、字段、业务码、message 全部不变（`@EnumSource` 全量断言） +- requestId 仍来自 `RequestIdAccessor`，测试断言 `"r01b-contract"` / `"r01b-parity"` +- 日志级别未变（`handleBusinessException` 仍为 `log.warn`） +- 未知 code 仍回退 **400** +- `ErrorCode` 数字、枚举成员**零修改**（`git diff` 为空） +- 未新增接口、DTO、依赖 + +### 9.3 逐项一致性证明 + +`GlobalExceptionHandlerMappingParityTest`： + +1. **显式映射集合** = 重构前快照的 112 个 `ErrorCode`（对**全部 166 个**错误码逐一核对： + 快照中未显式映射的，重构后也不得显式映射）； +2. **处理器实际返回状态** ≡ **registry 解析结果** ≡ **快照基线**（`@EnumSource` 166 参数化）； +3. 未映射码（含 `UNAUTHORIZED(2001)`、`SERVICE_UNAVAILABLE`）保持 **400**； +4. `FORBIDDEN` 保持业务码 **2002** + HTTP **403**； +5. NOT_FOUND 类 404、CONFLICT 类 409、限流类 429； +6. 响应体不含异常类名、堆栈、内部路径。 + +### 9.4 收束过程中发现的既有潜在缺陷（已记录，未修改） + +**`ErrorCode` 166 个常量只有 165 个唯一数字码**：`REVIEW_ALREADY_DECIDED(9103)` 与 +`DUPLICATE_FEEDBACK(9103)` 共用同一数字码。 + +- 重构前该重复被 `register()` **静默容忍**（`putIfAbsent` 只在"同码不同状态"时抛错）； +- 本轮的严格重复检测因此**在启动期暴露了它**； +- 二者当前都映射到 **CONFLICT**，故数字入口无歧义、行为与重构前完全一致； +- 按任务书"不修改 `ErrorCode` 数字、不新增 `ErrorCode`"的要求，**本轮不修改**， + 仅把映射键改为 `ErrorCode` 常量（这也正是"键必须是 ErrorCode 或稳定错误码类型"的实践理由）， + 并以 `ErrorHttpStatusRegistryTest.distinctConstantsWithSharedNumericCodeAreAllowed` 锁定该事实。 + +**处置建议（留待后续独立提交）**：为 `DUPLICATE_FEEDBACK` 分配唯一数字码。若两个常量被映射到 +**不同状态**，注册表的 `indexByCode` 会在初始化期直接抛错，不会静默任选其一。 + +--- + +### 9.5 量化结果（前后对比） + +| 指标 | 重构前 | 重构后 | 说明 | +|---|---|---|---| +| 角色 guard 方法定义总数 | **32** | **21** | 其中 6 个是 `UserRoleGuard` 自身；6 个是保留签名的公开方法（方法体已是一行委托）；8 个是实体返回型 `requireCompany`（非等价，保留）；2 个是 Controller 的 `requireAdmin(request)`（已委托） | +| 重复 student guard 实现 | **16** | **1**（公共 guard） | 其余为公开委托方法/实体返回型 | +| 重复 company guard 实现 | **2**（纯角色门禁）+ 7（实体返回型） | **1**（公共 guard）；7 个实体返回型保留 | +| 重复 admin guard 实现 | **7** | **1**（公共 guard） | | +| 已迁移调用点 | 0 | **54** | 37 student + 13 admin + 4 company | +| 明确保留的非等价调用点 | — | **14** | 7 个实体返回型 `requireCompany` + 7 个归属/可见性用 `hasRole` | +| `getRoles()` 角色比较 | **46 处 / 31 文件** | **23 处 / 16 文件** | 减少 50% | +| `GlobalExceptionHandler` 行数 | **232** | **146** | 净减 **86 行**；映射表、`register()`、`resolveHttpStatus()` 全部移出 | +| `resolveHttpStatus` 条件链 | 映射构建 66 行 + 注册 10 行 + 解析 3 行 | **0**（逻辑迁入 `ErrorHttpStatusRegistry`，261 行，含 javadoc 与显式 112 条映射） | | +| `ErrorCode.X.getCode()` 用于状态比较的次数 | 0（原为 `Map` 查找） | **0** | 状态解析无数字字面量比较 | +| 重复 HTTP 映射数 | 0（且**不可检测**） | **0**（且**初始化即拒绝**） | | +| 未映射 ErrorCode 数 | **54 / 166** → 400 | **54 / 166** → 400 | 逐项不变 | +| 角色授权 DB 查询次数 | 每处 1 次 `findById` | `requireXxx(Long)` **1 次**；`requireXxx(User)` **0 次**；无跨请求缓存 | | + +--- + +## 10. 查询次数 + +| 场景 | 数据库查询次数 | +|---|---| +| `requireStudent/Company/Admin/Any(Long userId)` | **恰好 1** 次 `users.findById`（`RoleAuthorizationGuardTest.queryCountIsBounded` 以 Mockito `times(1)` 锁定） | +| `requireStudent/Company/Admin/Any(User user)` | **0** 次（供已加载实体的调用点使用） | +| 一个请求内相同用户重复角色检查 | 调用方已加载实体时应使用实体重载；现有调用点每个请求路径至多 1 次 guard 调用 | +| 跨请求缓存 | **无**（不缓存 active 状态，注销/禁用后立即失效） | +| Redis 依赖 | **无** | +| 事务边界 | **未改变**（guard 只读、无 `@Transactional`） | +| 单次授权的 N+1 | **无**：guard 为单条主键查询，`user_roles` 由 JPA 关联加载 | + +--- + +## 11. 测试结果 + +日志目录：`docs/acceptance/r01-b/` + +| # | 命令 | 结果 | 日志 | +|---|---|---|---| +| 1 | `mvn -Dtest="RoleAuthorizationGuardTest,RoleAuthorizationIntegrationTest,ErrorHttpStatusRegistryTest,GlobalExceptionHandlerMappingParityTest" test` | **371 / 371**，F=0 E=0 S=0 ✔ | `b1b2-tests.log` | +| 2 | `mvn -Dtest="*Security*Test,*Authorization*Test,*Role*Test,*Admin*Controller*Test,*Company*Controller*Test,*Student*Controller*Test,*GlobalExceptionHandler*Test,*BusinessException*Test" test` | **448 中 6 项失败** —— 全部为**既有夹具缺陷**（§11.3），非本轮引入 | `b1-related.log` | +| 3 | `mvn test` | **2656 / 2656**，Failures=**0**，Errors=**0**，Skipped=**0**，BUILD SUCCESS ✔ | `b-full-mvntest.log` | +| 4 | `mvn clean verify` | 见 §11.4 | `b-clean-verify.log` | +| 5 | `python ..\docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed ✔ | — | + +### 11.1 新增测试逐类结果 + +| 测试类 | Tests | 覆盖 | +|---|---|---| +| `RoleAuthorizationGuardTest` | 16 | STUDENT/COMPANY/ADMIN 通过各自 guard；跨角色拒绝；ADMIN 无隐式超级权限；inactive 与 `active=null` 失败关闭；角色缺失；多角色；`users.role` 与 `user_roles` 不一致失败关闭；错误码/HTTP 契约；不解析 requestId/SecurityContext；查询次数 | +| `RoleAuthorizationIntegrationTest` | 10 | 三个真实端点（ADMIN `/admin/scoring/risk/overview`、STUDENT `/profile/me/career-progress`、COMPANY `/company/candidates`）经真实 SecurityFilterChain 验证 401/403/404 分层；接线变异（`@SpyBean` 断言 guard 确被调用）；资源归属仍由业务层判定 | +| `ErrorHttpStatusRegistryTest` | 174 | 112 条显式映射、111 个唯一数字码、四状态白名单、逐 ErrorCode 自洽、未映射回退 400、重复键初始化拒绝、不可变、键必须为 ErrorCode、9103 共用数字码 | +| `GlobalExceptionHandlerMappingParityTest` | 171 | 显式映射集合 = 重构前快照；处理器返回 ≡ registry ≡ 快照（166 参数化）；FORBIDDEN 2002/403；`UNAUTHORIZED(2001)` 保持 400；服务不可用保持 400；响应体无内部细节 | + +### 11.2 测试总数 + +| 项 | 数值 | +|---|---| +| R01-B 前基线 | **2285** | +| 本轮新增 | **371** | +| 预期合计 | 2656 | +| 实测 (`mvn test`) | **2656** ✔ 与预期逐位一致 | + +### 11.3 关联回归中暴露的**既有**夹具缺陷（与本轮无关，如实记录） + +`mvn -Dtest="*Admin*Controller*Test,..."` 单独运行时，**既有**的 +`AdminReviewControllerTest`（4 项）与 `CompanyReviewManagementControllerTest`（2 项） +出现 `expected 200/403/409 but was 401`。根因与 A6 独立复验 §9 定位的**同一缺陷**： + +``` +AuthSessionService - session validation rejected: user not usable +JwtAuthenticationFilter - JWT authentication rejected: session not active +``` + +- `AdminReviewControllerTest` 使用 `ADMIN_ID = 1L`；`CompanyReviewManagementControllerTest` 使用 `token(1L, "COMPANY")` / `token(2L, "STUDENT")`； +- `V1_1` 种子账号占用 `users.id = 1/2/3` 且被 `V43` 置为 `inactive`，而 `TestAuthTokens` 对"已存在但 inactive"的行不插入也不激活； +- 全量顺序下 `com.mydreamjob.controller.AuthIntegrationTest` 的 `deleteAll()` 偶然清掉种子行，问题被掩盖 —— 故 §11.2 的全量结果是干净的； +- 日志中该警告恰好 6 次，分别落在上述两个类，**无一处落在本轮改动的代码路径**； +- 本轮**未修改**这两个测试类，也**未**把该失败写成通过。 + +> 该缺陷与 `FairnessMonitoringControllerTest` 属同一类，已在 A6 后以独立提交 `84fe9f5` 修复 +> **其中一个类**；其余同类类别的隔离修复应另开独立纯测试提交，不并入 R01-B。 + +### 11.4 `mvn clean verify` + +``` +[INFO] Tests run: 2656, Failures: 0, Errors: 0, Skipped: 0 +[INFO] BUILD SUCCESS +``` + +| 项 | 数值 | +|---|---| +| 全量测试总数 | **2656**（不低于收束前 2285 ✔） | +| Failures / Errors / Skipped | **0 / 0 / 0** ✔ | +| 日志 | `docs/acceptance/r01-b/b-clean-verify.log` | + +--- + +## 12. OpenAPI + +``` +python ..\docs\verify_openapi.py +→ paths: 176 / operations: 214 +→ All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空**，`openapi-rc.json` 零修改 ✔ + +--- + +## 13. 精确修改文件 + +**新增生产代码（2）** + +``` +mydreamjob-server/src/main/java/com/mydreamjob/security/UserRoleGuard.java +mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorHttpStatusRegistry.java +``` + +**修改生产代码（22）** + +``` +ability/AbilityAttemptService.java +application/ApplicationController.java +assessment/AssessmentAttemptService.java +bidirectionalmatch/MatchRuleService.java +candidatescore/dashboard/CompanyScoringDashboardService.java +candidatescore/governance/CandidateScoringGovernanceService.java +careerprogress/CareerProgressService.java +common/exception/GlobalExceptionHandler.java ← B2 +company/CompanyService.java +competition/CompetitionRankingService.java +job/JobFavoriteService.java +match/MatchService.java +preference/PreferenceService.java +privacy/PrivacySettingsService.java +profile/ProfileService.java +recommendation/JobRecommendationService.java +review/JobReviewService.java +risk/AdminRiskController.java +safety/AdminReportController.java +talentdiscovery/TalentDiscoveryService.java +talentinvitation/TalentInvitationService.java +verification/CompanyVerificationService.java +``` + +**新增测试（5）** + +``` +common/r01b/RoleAuthorizationGuardTest.java +common/r01b/RoleAuthorizationIntegrationTest.java +common/r01b/ErrorHttpStatusRegistryTest.java +common/r01b/GlobalExceptionHandlerMappingParityTest.java +common/r01b/UserRoleGuardTestSupport.java ← 测试支持（非测试类） +``` + +**修改测试（21）** —— 仅接线，未放宽任何断言： + +``` +careerprogress/CareerProgressServiceTest.java ← 构造器参数补 guard（真实实例） +common/exception/GlobalExceptionHandler{AccountDeletion,HttpStatus,ReportBlock,StatusContract}Test.java ← 构造器补 registry +candidatescore/governance/CandidateScoringGovernanceServiceTest.java +profile/ResumeServiceTest.java +review/JobReviewDimensionServiceTest.java +assessment/AssessmentAttemptServiceTest.java +match/MatchServiceTest.java +privacy/PrivacySettingsServiceTest.java +review/JobReviewServiceTest.java +job/JobFavoriteServiceTest.java +company/CompanyServiceTest.java +preference/PreferenceServiceTest.java +competition/CompetitionRankingServiceTest.java +ability/AbilityAttemptServiceTest.java +bidirectionalmatch/MatchRuleServiceTest.java +verification/CompanyVerificationServiceTest.java +talentdiscovery/TalentDiscoveryServiceTest.java +recommendation/JobRecommendationServiceTest.java +``` + +> 这 16 个 `@InjectMocks` 单元测试类新增了 `@Mock UserRoleGuard` 并在 `@BeforeEach` +> 通过 `UserRoleGuardTestSupport.delegateToRealGuard(...)` 把 mock **委托给真实 guard**， +> 复用测试自身已 stub 的 `UserRepository`。这样"角色不符 → 403"的既有断言**语义不变**， +> 没有被削弱成"只验证调用了一次"。 + +**文档（2）** + +``` +docs/r01-b-authorization-exception-mapping-report.md （新增） +docs/backend-development-roadmap.md （更新：A 系列完成 / 84fe9f5 / R01-B 状态 / 下一阶段 R01-C） +``` + +--- + +## 14. Flyway / ErrorCode / 接口 / DTO 是否变化 + +| 项 | 结果 | +|---|---| +| `git diff --name-only -- mydreamjob-server/src/main/resources/db/migration` | **空** —— V1–V45 未改动 | +| `ErrorCode.java` | **未修改**（数字、成员、message 全部不变） | +| 接口（路径/方法/参数/响应结构） | **未修改**（未新增、未删除、未改签名） | +| DTO | **未修改** | +| `docs/openapi-rc.json` | **未修改** | +| 依赖（`pom.xml`） | **未修改** | +| 新依赖 | **未引入**（guard 只用 Spring Data JPA 与既有 `ErrorCode`） | + +--- + +## 15. Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 / HEAD | `refactor/r01-structure-performance` / `84fe9f5…`（未变） | +| `git diff --cached --name-only` | **空** | +| `git diff --check` | 仅 LF/CRLF 警告，exit 0 | +| 已暂存 / 已提交 / 已推送 | **均无** | +| 历史未跟踪文件 | 未删除 | + +--- + +## 16. 未暂存、未提交、未推送 + +**确认：未暂存、未提交、未推送。** 本轮未使用 `git add`、未创建提交、未推送； +未执行 `reset`/`restore`/`checkout`/`clean`；未操作 Docker；未修改 V1–V45。 + +--- + +## 17. 未进入 R01-C/E + +**确认：未进入 R01-C、未进入 R01-E。** 本轮未处理 `overviewStatus`、推荐权重、 +高校名单与评分阈值、N+1、会话未读数、requestId、身份主体解析、Token、评分快照、 +新接口与数据库迁移中的任何一项。 + +--- + +> **R01-B角色授权与异常映射收束完成，待独立代码复验。** diff --git a/docs/r01-b-error-status-mapping-instruction.md b/docs/r01-b-error-status-mapping-instruction.md new file mode 100644 index 0000000..e38ca50 --- /dev/null +++ b/docs/r01-b-error-status-mapping-instruction.md @@ -0,0 +1,19 @@ +# R01-B 业务异常 HTTP 状态映射收束实施指令 + +## 1. 目标 + +在不改变任何对外行为的前提下，将 `GlobalExceptionHandler.resolveHttpStatus` 的长 `if` 链收束为集中、不可变、可完整验证的整数业务码映射。 + +## 2. 硬边界 + +- 不修改 `ErrorCode` 的常量、数值或文案； +- 不新增接口、Flyway、表、索引、依赖； +- 不改变 HTTP 状态、响应业务码、message、requestId 或兜底语义； +- 必须继续按整数业务码解析，因为历史常量可能共享数值； +- 同一整数码若被登记为不同 HTTP 状态，应用初始化必须失败，不能静默覆盖； +- 未显式登记的整数码继续返回 HTTP 400； +- 不进入 R01-C/D/E，不提交、不推送。 + +## 3. 测试门槛 + +先建立全量特征测试，对 `ErrorCode.values()` 每个常量逐一断言 HTTP 状态、业务码、message、requestId，并单独验证未知整数码回退 400。随后运行异常关联测试、`mvn clean verify` 与静态 OpenAPI 校验，Failures/Errors/Skipped 必须全部为 0。 diff --git a/docs/r01-b-error-status-mapping-report.md b/docs/r01-b-error-status-mapping-report.md new file mode 100644 index 0000000..317dbf1 --- /dev/null +++ b/docs/r01-b-error-status-mapping-report.md @@ -0,0 +1,46 @@ +# R01-B 业务异常 HTTP 状态映射收束实施报告 + +> 状态：R01-B 已完成实现和自动化验证，待独立代码复验。 + +## 1. 基线与范围 + +- 分支：`refactor/r01-structure-performance` +- 起点：`0b5b849 refactor: centralize request identity and request ID handling` +- 仅修改异常 HTTP 状态解析和对应特征测试；未进入其他 R01 子阶段。 +- 开始前暂存区和已跟踪工作区为空；历史未跟踪产物完整保留。 + +## 2. 实现 + +`GlobalExceptionHandler` 使用不可变 `Map` 集中登记 403、404、409、429；未登记业务码继续回退 400。登记辅助方法使用 `putIfAbsent`，同一整数业务码若出现不同状态会抛固定初始化异常，避免静默覆盖。 + +映射键保持为整数而非 `ErrorCode`：仓库存在历史共享数值常量，生产处理入口收到的也是整数业务码。此次未修改或“修正”任何历史常量。 + +## 3. 特征测试 + +新增 `GlobalExceptionHandlerStatusContractTest`： + +- 对全部现有 `ErrorCode` 常量逐项调用正式 `handleBusinessException`； +- 独立快照四类显式状态集合，其余断言为 400； +- 同时断言业务码、message、requestId 原样保持； +- 通过反射只读调用私有解析器，证明未知整数码仍回退 400，未为测试扩大生产 API。 + +第一次定向编译曾因测试错误地调用不存在的 `BusinessException(int, String)` 构造器失败；整改为反射验证私有兜底后通过。未修改生产 API，也未删除或放宽断言。 + +## 4. 量化与验证 + +| 项目 | 结果 | +|---|---| +| `GlobalExceptionHandler` 行数 | 328 → 232 | +| `errorCode == ErrorCode...` 比较 | 121 → 0 | +| 异常定向/关联集合 | 207/207，0/0/0 | +| `mvn clean verify` | 2082/2082，Failures=0、Errors=0、Skipped=0，BUILD SUCCESS | +| OpenAPI | 176 paths / 214 operations，All checks passed | + +## 5. 边界 + +- `ErrorCode` 未修改； +- V1–V43 未修改，无新增迁移； +- 无新增公网接口、依赖、表或索引； +- 未操作 Docker； +- 未暂存、未提交、未推送； +- 未删除历史未跟踪文件。 diff --git a/docs/r01-b-independent-verification-20260918.md b/docs/r01-b-independent-verification-20260918.md new file mode 100644 index 0000000..cad28cc --- /dev/null +++ b/docs/r01-b-independent-verification-20260918.md @@ -0,0 +1,617 @@ +# R01-B 独立代码复验报告（角色授权与异常映射收束） + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +HEAD：`84fe9f5febcf56910d5c978dd44e0e16d15d7209`（A6 后夹具修复提交，复验全程未变） +复验对象：`docs/r01-b-authorization-exception-mapping-report.md` +性质：**仅复验** —— 未修改生产代码、未放宽既有断言、未暂存、未提交、未推送 + +--- + +## 0. 结论 + +> **R01-B独立代码复验通过，可以进入精确暂存与独立提交检查点；两个Controller测试夹具缺陷须在R01-B提交后以独立纯测试提交修复。** + +- 角色授权：54 个调用点全部真实存在且仅经 HTTP 入口可达；保留的 14 个点**确为不等价**； + **未发现角色/归属/错误码/事务语义变化**。 +- HTTP 映射：从 `HEAD` 独立提取的 **166 项基线逐项一致（0 处不一致）**；112 显式、54 默认 400； + `UNAUTHORIZED` 仍 400、`FORBIDDEN` 仍 403、`SERVICE_UNAVAILABLE` 仍 400。 +- 9103 重复码：**运行时确实无法区分**（`BusinessException` 只保存 `int`）。未夸大为"已解决身份歧义"； + 已证明两者状态相同故 HTTP 行为一致，且"同数字不同状态"会初始化失败而非静默任选。 +- 测试委托模式：**真实**。变异实验（把委托改为无条件下放行）令 63 个负向用例中 **50 个失败**。 +- 仅有两个**既有**测试夹具缺陷（`AdminReviewControllerTest`、`CompanyReviewManagementControllerTest`）， + 已用证据证明其失败发生在安全链认证阶段、**未进入 R01-B 代码**。 +- **一处需如实说明的环境偏差**：本轮 `mvn clean verify` 为 `2681 / F=0 / E=0 / Skipped=26`。 + 26 个跳过全部是 `@Testcontainers(disabledWithoutDocker = true)` 的 MySQL 用例， + 因本机 **Docker 守护进程未运行**而按设计跳过；上一轮同代码全量为 `Skipped=0` + （这些用例执行并通过）。**不声称 Skipped=0**，原因与自洽性见 §14.1。 + **不构成 R01-B 阻断项。** + +--- + +## 1. 分支、HEAD 与 Git 状态 + +| 项 | 结果 | +|---|---| +| `git branch --show-current` | `refactor/r01-structure-performance` | +| `git rev-parse HEAD` | `84fe9f5febcf56910d5c978dd44e0e16d15d7209` | +| `git rev-list --left-right --count HEAD...@{upstream}` | `0 0` ✔ | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --check` | **exit 0**，无空白错误 ✔ | +| R01-B 改动位置 | 全部仍在工作区（22 生产 + 21 测试 + 1 文档） | +| R01-B 之外的新生产改动 | **无**（逐文件比对允许清单，无越界） | + +--- + +## 2. 角色库存独立计数 + +独立复验者自行从 `HEAD` 与工作区分别提取（正则按方法签名匹配，不采信实施报告数字）： + +| 项 | HEAD | 工作区 | +|---|---|---| +| 角色 guard 方法定义总数 | **32** | **21** | +| `private boolean hasRole(User, Role)` 助手 | 7 | 7 | +| `getRoles()` 出现次数 / 文件数 | 46 / 31 | 23 / 17 | +| 调用公共 guard 的点位 | 0 | **54** | + +工作区 21 个定义的构成（逐条列出于下）： + +| 类别 | 数量 | 明细 | +|---|---|---| +| `UserRoleGuard` 自身 | **6** | `requireStudent/Company/Admin` × (`Long`, `User`) | +| 公开兼容委托（方法体一行） | **6** | `CompanyService.assertCompanyRole`、`CompanyService.assertStudentRole`、`PreferenceService.assertStudentRole`、`PrivacySettingsService.assertStudentRole`、`ProfileService.assertStudentRole`、`CompanyVerificationService.assertAdminRole` | +| 实体返回型 `requireCompany`（非等价，保留） | **7** | `MatchRuleService`、`CompanyScoringDashboardService`、`InterviewService`、`OfferService`、`CompanyReviewManagementService`、`CompanyReviewReplyService`、`CompanyVerificationService` | +| Controller 便捷包装（返回 userId，已委托 guard） | **2** | `AdminRiskController.requireAdmin(HttpServletRequest)`、`AdminReportController.requireAdmin(HttpServletRequest)` | + +6 + 6 + 7 + 2 = **21** ✔ 与工作区实测一致。 + +> 与实施报告的一处**非语义差异**：实施报告 §9.5 写 `getRoles()` 为「23 处 / 16 文件」， +> 独立实测为「23 处 / **17** 文件」（出现次数一致，文件计数差 1）。 +> 该差异不影响任何结论，仅记录以备核对。 + +--- + +## 3. 54 个迁移调用点对账 + +逐调用点清单（文件 / 方法 / 旧 guard / 新 guard / 角色 / 错误码 / 归属 / 查询次数）已落盘： +`docs/acceptance/r01-b/iv-role-callsites.tsv`（54 行 + 表头）。 + +按文件汇总： + +| 文件 | 调用点 | +|---|---| +| `ability/AbilityAttemptService` | 6 | +| `assessment/AssessmentAttemptService` | 5 | +| `candidatescore/governance/CandidateScoringGovernanceService` | 7 | +| `review/JobReviewService` | 6 | +| `recommendation/JobRecommendationService` | 5 | +| `application/ApplicationController` | 3 | +| `job/JobFavoriteService` | 3 | +| `talentinvitation/TalentInvitationService` | 3 | +| `bidirectionalmatch/MatchRuleService` | 2 | +| `company/CompanyService` | 2 | +| `talentdiscovery/TalentDiscoveryService` | 2 | +| `candidatescore/dashboard/CompanyScoringDashboardService` | 1 | +| `careerprogress/CareerProgressService` | 1 | +| `competition/CompetitionRankingService` | 1 | +| `match/MatchService` | 1 | +| `preference/PreferenceService` | 1 | +| `privacy/PrivacySettingsService` | 1 | +| `profile/ProfileService` | 1 | +| `risk/AdminRiskController` | 1 | +| `safety/AdminReportController` | 1 | +| `verification/CompanyVerificationService` | 1 | +| **合计** | **54** | + +| 独立核对项 | 结果 | +|---|---| +| 迁移调用点总数 | **54** ✔ | +| student / admin / company 分布 | **37 / 13 / 4** ✔（与实施报告一致） | +| 重复统计 | **无**（同一行不会被两个正则重复计入） | +| 32 → 21 方法数 | ✔ 逐方法差异已列出：HEAD 独有 17 个定义被删除，工作区新增 `UserRoleGuard` 的 6 个 | +| 是否删除角色检查 | **否** —— 被删方法的 HEAD 调用点数合计 **46**，对应迁移后 54 个调用点（含新增的 `MatchRuleService` 2 处与委托内调用），无一处丢失 | +| 是否扩大 ADMIN 权限 | **否** —— 未引入任何 `requireAny(..., ADMIN)`；ADMIN 仍被 STUDENT/COMPANY 门禁拒绝（HTTP 实测 403） | +| 是否把 404/业务不存在改成 403 | **否** —— `USER_NOT_FOUND` 仍映射 404；`COMPANY_NOT_FOUND` 等业务码未变；实测验端点返回 404 而非 403 | + +--- + +## 4. 14 个保留点及其不等价性核验 + +| 类别 | 数量 | 独立核验结论 | +|---|---|---| +| `private Company requireCompany(Long)` | 7 | **确为不等价**：除角色判定外还执行 `companyRepository.findByOwnerUserId(...)` 并抛 `COMPANY_NOT_FOUND`，返回值被业务使用。用 void guard 替换会丢失实体与错误码语义，且改变查询次数 | +| `private boolean hasRole(User, Role)` | 7 | **确为不等价**：返回**布尔值**用于**分支选择**（如 `listMyInterviews` 按 COMPANY/STUDENT 走不同查询；`listOffers` 还要先取 company 实体），并含归属判定（`hasRole(user, STUDENT) && interview.getStudentUserId().equals(userId)`）。void guard 无法表达"值" | + +已逐处读取源码确认（例：`InterviewService.listMyInterviews`、`OfferService.listOffers` 的 +`if (hasRole(...)) {...} if (hasRole(...)) {...} else 403` 分支结构）。 +**14 与 21 的关系**：21 个方法 = 6（guard 自身）+ 6（一行委托）+ 7（实体返回型）+ 2（Controller 包装）； +其中真正"不等价保留"的是 **7 个实体返回型 `requireCompany` + 7 个 `hasRole` 助手 = 14**。 + +**一处残留观察（非阻断）**：`ApplicationController.getCompanyCandidateDetail` 先调 +`requireCompany(userId)`，随后调用的 `companyService.findCompanyByOwnerUserId(userId)` 内部又调 +`assertCompanyRole(userId)` —— 同一请求 2 次角色检查。经与 `HEAD` 逐行比对，**该重复在收束前就存在** +（HEAD 的 `assertCompanyRole` 同样被 Controller 与 `findCompanyByOwnerUserId` 各调一次）， +**非本轮引入**，本轮未改变查询次数。可作为后续独立优化点。 + +--- + +## 5. inactive 语义分析 + +| 项 | 结论 | +|---|---| +| 用户不存在 | `USER_NOT_FOUND`(4001) → 404（沿用既有错误码，未新增） | +| 用户存在但 inactive | **`FORBIDDEN`(2002) → 403**（新增的失败关闭；既有实现无此校验） | +| `active` 为 `null` | 同样拒绝（`isActive` 要求 `Boolean.TRUE`） | +| 角色不足 | `FORBIDDEN`(2002) → 403（与既有完全一致） | +| 与既有实现的差异面 | **仅"inactive 用户"这一种输入**：收束前会通过，收束后拒绝 | + +**HTTP 入口的 inactive 用户在 guard 之前已被拒绝**（证据链，非推测）： + +1. `JwtAuthenticationFilter.authenticate` 在建立认证前调用 + `authSessionService.isSessionActive(...)`； +2. `AuthSessionService.isSessionActive` 第一步 `isUserUsable(userId)` → + `user.isPresent() && isUsable(user)`，而 `isUsable` 只检查 `user.getActive()`； +3. 为 false 时 `SecurityContextHolder.clearContext()` 并直接返回，**请求根本不会进入 Controller**； +4. 因此对 HTTP 入口而言，guard 的 active 检查是**第二道**，观察不到行为差异。 + +--- + +## 6. 非 HTTP 入口分析 + +对全部 **54 个迁移调用点**逐个追溯调用链，结论：**全部仅经 HTTP 入口可达**。 + +| 入口类型 | 独立核验 | +|---|---| +| HTTP Controller 链路 | 54/54 调用点的宿主方法均由 `@RestController` 直达（21 个文件逐一确认） | +| 定时任务 | 全仓 `@Scheduled` 类共 8 个：`MatchNotificationScheduler`、`CandidateScoringRefreshScheduler`、`PersonalDataExportWorker`、`AccountDeletionService`、`NotificationConsumer`、`OfferExpiryScheduler`、`RiskEventDetector`、`RiskEventScanScheduler` —— **无一个注入或调用任何被迁移的服务或 `UserRoleGuard`** | +| Worker | 同上（`PersonalDataExportWorker`、`CandidateScoringRefreshWorker`、`AccountDeletionCompletionWorker` 的依赖已逐一列出核对） | +| 消息消费者 | `NotificationConsumer` 仅依赖 notification 三件套，未触碰 | +| 内部 Service 调用 | 非 Controller 的调用者仅 4 处：`ResumeVersionService`/`ResumeExportService`/`StudentReviewWeightService`（均只被 Controller 调用）、`MatchService.diagnose`（唯一调用者是 `MatchController`）。**均为 HTTP 链路** | +| 注销/导出/补偿流程 | `AccountDeletionService`、`PersonalDataExportWorker`、补偿扫描器均未触碰迁移点 | +| 管理后台任务 | `AdminRiskController`/`AdminReportController` 的 `requireAdmin` 只被各自 HTTP 端点调用 | + +**因此：不存在"合法的历史数据处理、注销收尾或后台任务需要对 inactive 用户执行受保护动作"的场景。** +独立变量验证：`MatchService.diagnose` 的唯一调用方是 `MatchController`（`grep "\.diagnose("` 全仓仅 1 处）。 + +--- + +## 7. 查询次数 + +| 场景 | 独立实测 | +|---|---| +| `requireXxx(Long userId)` | **恰好 1** 次 `users.findById`（Mockito `times(1)` + `verifyNoMoreInteractions` 锁定） | +| `requireXxx(User user)` | **0** 次（`verifyNoMoreInteractions` 覆盖） | +| guard 写库 | **0**（`never()).save/deleteById/delete`） | +| 单次授权 N+1 | **无**（单条主键查询；`user_roles` 由 JPA 关联加载） | +| 跨请求缓存 | **无**（guard 无状态字段，唯一依赖 `UserRepository`；用户禁用后立即失效） | +| Redis / SecurityContext / requestId | **均未触碰**（结构断言 + 行为断言双重证明） | +| 每请求角色检查次数 | 多数路径 1 次；`/company/candidates/{id}` 为 2 次 —— **与 HEAD 相同，非回归**（见 §4） | + +--- + +## 8. 测试委托模式是否真实（含变异验证） + +### 8.1 静态核验 + +| 项 | 结果 | +|---|---| +| 使用 `delegateToRealGuard` 的测试类 | **16 个**（另 1 个为支持类本身） | +| 每个类是否同时声明 `@Mock private UserRoleGuard userRoleGuard;` | **是**（16/16，各 1 处） | +| 委托是否使用**真实** `UserRoleGuard` 实现 | **是**：`new UserRoleGuard(userRepository)` | +| 是否使用每个测试**自己 stub 的** `UserRepository` | **是**：`delegateToRealGuard(userRoleGuard, userRepository)` 传入该测试类的 `@Mock UserRepository` | +| 是否使用宽泛 `doNothing()` | **否**：`UserRoleGuardTestSupport` 内 **0 处** `doNothing()`；模块内 7 处均为 `lenient().doAnswer(...)` 显式转发 | +| 是否把所有 guard 调用默认放行 | **否**：四个方法均逐字转发到真实 guard；`lenient()` 只用于消除"未被该用例触发"的多余桩告警，不改变行为 | +| 本轮是否新增 `doNothing` | **否**：全仓 10 处 `doNothing()` 全部位于**未被 R01-B 改动**的文件（`git status` 为空），且目标是其他 mock（`favoriteRepository`、`messagingService`、被 mock 的 `companyService` 等） | + +### 8.2 变异验证（决定性） + +把 `UserRoleGuardTestSupport.delegateToRealGuard` 临时改为**空实现**（即 mock 的所有 void 方法无条件放行）， +运行 5 个含负向断言的测试类： + +``` +mvn -Dtest="CompanyServiceTest,JobFavoriteServiceTest,PrivacySettingsServiceTest,MatchServiceTest,JobReviewServiceTest" test +→ Tests run: 63, Failures: 13, Errors: 37 ← 50/63 失败 +``` + +失败样例： + +``` +CompanyServiceTest.findCompany_asStudent_shouldReturn403:71 + Expected BusinessException to be thrown, but nothing was thrown. +CompanyServiceTest.updateCompany_asStudent_shouldReturn403:83 + expected: <2002> but was: <5001> +JobFavoriteServiceTest.favorite_asCompany_shouldReturn403:177 + Unexpected exception type thrown ... but was: java.lang.NullPointerException +MatchServiceTest.diagnose_asAdmin_shouldReturn403:91 + Unexpected exception type thrown ... but was: java.lang.NullPointerException +``` + +**判据成立**：若负向测试在"无条件放行"下仍通过，说明测试未覆盖授权；实测 **50 个用例立即失败**， +证明这些测试**真的执行了角色判断**，委托模式未被削弱。 +变异后已把文件**按原 SHA256 还原**（`02f25b74cf5d2192882a77930ec1c748a1049509323bf02668dc5b04822c82a1`，逐字节一致）， +临时备份已删除。日志：`docs/acceptance/r01-b/iv-mutation.log`。 + +--- + +## 9. HTTP 映射 166 项对账（独立提取） + +**基线来源**：`git show HEAD:…GlobalExceptionHandler.java` 的 `buildBusinessHttpStatuses()`， +独立解析后写入 `docs/acceptance/r01-b/reconcile.tsv`（166 行）与 +`mydreamjob-server/src/test/resources/r01b/error-code-http-status-baseline.tsv`（测试资源）。 +**未复用工作区实现的任何映射表**，不存在同源假证明。 + +| 项 | HEAD | 工作区 | 一致 | +|---|---|---|---| +| 枚举常量总数 | 166 | 166 | ✔ | +| 显式映射常量数 | 112 | 112 | ✔ | +| 显式映射覆盖的唯一数字码 | 111 | 111 | ✔ | +| 默认 400 项 | 54 | 54 | ✔ | +| **逐项状态不一致数** | — | — | **0** ✔ | +| HEAD 中重复注册 | 无 | 无 | ✔ | + +关键项逐项核对： + +| ErrorCode | 数字码 | HEAD | 工作区 | +|---|---|---|---| +| `UNAUTHORIZED` | 2001 | 400（未登记默认） | **400** ✔ | +| `FORBIDDEN` | 2002 | 403 | **403** ✔ | +| `SERVICE_UNAVAILABLE` | 9001 | 400（未登记默认） | **400** ✔ | +| `USER_NOT_FOUND` | 4001 | 404 | **404** ✔ | +| `APPLICATION_DUPLICATE` | 8001 | 409 | **409** ✔ | +| `ABILITY_RETAKE_LIMIT` | 9811 | 429 | **429** ✔ | +| `REVIEW_ALREADY_DECIDED` | 9103 | 409 | **409** ✔ | +| `DUPLICATE_FEEDBACK` | 9103 | 409 | **409** ✔ | + +（上表数字码与状态均取自独立提取的 `docs/acceptance/r01-b/reconcile.tsv`。） + +响应 JSON、requestId、日志行为未变：`GlobalExceptionHandler.handleBusinessException` 仍为 +`log.warn`、仍用 `ApiResponse.error(errorCode, e.getMessage(), requestIdAccessor.get(request))`， +仅把状态解析改为 `errorHttpStatusRegistry.resolve(errorCode)`。 + +--- + +## 10. 112 显式 / 54 默认统计（独立复核） + +| 项 | 实施报告 | 独立复核 | +|---|---|---| +| 显式映射 | 112 | **112** ✔ | +| 未映射（默认 400） | 54 | **54** ✔ | +| 唯一数字码 | 111（未声明） | **111** ✔（9103 共用） | + +--- + +## 11. 9103 重复码的真实运行时语义 + +### 11.1 逐层查清 + +| 层 | 事实 | +|---|---| +| `BusinessException` 保存什么 | **`private final int errorCode;`** —— 只保存数字，**枚举身份在构造时即丢失**；无 `ErrorCode` 字段，无 `fromCode` 反查 | +| `GlobalExceptionHandler` 拿到什么 | `int errorCode = e.getErrorCode();` → **int** | +| `ErrorHttpStatusRegistry.resolve(...)` 以什么为键 | `resolve(ErrorCode)` 用**枚举键**表 `EXPLICIT`；**运行时路径 `resolve(int)` 用派生数字表 `BY_CODE`** | +| 是否使用 `ErrorCode.values()` / `fromCode()` / 首次匹配 | **全部没有**（registry 与 handler 中 `values()`/`valueOf`/`ordinal`/`stream()` 命中为 0；`ErrorCode` 亦无 `fromCode` 辅助方法） | +| 相同数字码不同枚举是否可能被错误归类 | **运行时不可能区分** —— 两者都是 9103，`resolve(9103)` 只有一个结果 | +| 映射是否依赖枚举声明顺序 | **不依赖**。`EXPLICIT` 按**注册顺序**构建（与枚举声明顺序无关），`BY_CODE` 由它派生并用 `putIfAbsent` 去重；顺序只影响"谁先写入"，而冲突时**抛错**而非取先者 | + +### 11.2 明确声明（不夸大） + +> **运行时无法区分 `REVIEW_ALREADY_DECIDED` 与 `DUPLICATE_FEEDBACK`**：`BusinessException` 只携带 +> `int 9103`，Handler 也只拿到该数字。因此**不能声称"以枚举为键已彻底解决身份歧义"**； +> 准确表述是：**两者当前都映射为 409 CONFLICT，故 HTTP 行为一致**； +> 枚举键表的价值在于**配置期可审计与可去重**，而不是运行期消歧。 + +### 11.3 独立测试对六项要求的覆盖 + +| # | 要求 | 覆盖用例 | +|---|---|---| +| 1 | 两个枚举常量都显式注册 | `bothSharedNumericCodeConstantsAreExplicitlyMappedTo409` | +| 2 | 两者分别解析为 409 | 同上 | +| 3 | `resolve(9103)` 行为明确 | `runtimeCannotDistinguishTheTwoSharedConstants`（= CONFLICT，并断言两个异常的业务码相同） | +| 4 | 改成不同状态时初始化/解析必须失败 | `conflictingStatusForSharedNumericCodeFailsFast`（构造 `9103 → CONFLICT` + `9103 → NOT_FOUND`，调用数字索引构建必须抛 `IllegalStateException`，消息含 `9103`；同时反证状态相同时允许） | +| 5 | 不依赖 `ErrorCode.values()` 顺序 | `mappingDoesNotDependOnEnumDeclarationOrder`（正序/逆序注册结果相同 + 逐项比对基线） | +| 6 | 未映射 code 仍为 400 | `unknownCodeFallsBackTo400AndResponseIsClean` | + +--- + +## 12. 独立新增测试 + +| 测试类 | Tests | 结果 | +|---|---|---| +| `common/r01b/R01BIndependentRoleVerificationTest` | 11 | **通过** | +| `common/r01b/R01BIndependentHttpMappingParityTest` | 9 | **通过** | +| `common/r01b/R01BWiringMutationTest` | 5 | **通过** | +| **合计** | **25** | **25 / 25**，F=0 E=0 S=0 ✔ | + +日志：`docs/acceptance/r01-b/iv-1-independent.log` + +覆盖要点： + +- **角色**：active 三角色各自通过；三类交叉全部拒绝；ADMIN 不自动通过 STUDENT/COMPANY； + 用户不存在（`USER_NOT_FOUND`）；inactive 与 `active=null`（`FORBIDDEN`）；`roles` 为空； + 多角色；`users.role` 与 `user_roles` 不一致时按 `user_roles` 失败关闭； + `requireXxx(Long)` 恰好 1 次查询、`requireXxx(User)` 零查询；无写库； + 不触碰 SecurityContext（在上下文里放 ADMIN 仍按传入 userId 判定）/requestId/Redis； + 三个真实 HTTP 端点验证 **401 / 403 / 404** 分层。 +- **接线变异**：guard 拒绝 → 403 且**下游业务方法零调用**；guard 放行 → **STUDENT 也能通过 ADMIN 端点** + （若端点仍保留自有角色比较，STUDENT 不可能通过 → 该断言即变异检测器）； + guard 收到正确 userId；归属失败仍由业务层返回 404。 +- **映射**：166 项按**名称**逐项比对 HEAD 基线（不作数字去重）、112/54 计数、 + 9103 六项、未知码 400、响应体无堆栈与内部类名。 + +--- + +## 13. 两个 Controller 测试单跑结果（如实记录，未写成通过） + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="AdminReviewControllerTest" test` | **11 run / 4 failures / 0 errors / 0 skipped**，BUILD FAILURE | +| `mvn -Dtest="CompanyReviewManagementControllerTest" test` | **3 run / 2 failures / 0 errors / 0 skipped**，BUILD FAILURE | + +失败断言：`expected 200/400/409 but was 401`（6 项合计）。 + +**根因证据链（非按日志文本猜测）**： + +| 证据 | AdminReview | CompanyReviewMgmt | +|---|---|---| +| `Handler: Type = null` 次数 | 4 | 2 | +| `session validation rejected: user not usable` | 4 | 2 | +| `JWT authentication rejected: session not active` | 4 | 2 | +| 401 响应体 | `{"code":401,"message":"not authenticated","timestamp":""}` | 同 | +| 测试使用的用户 ID | `ADMIN_ID = 1L` | `token(1L,"COMPANY")` / `token(2L,"STUDENT")` | +| 是否在 R01-B 改动清单内 | **否** | **否** | + +**判定**： + +1. `Handler: Type = null` 证明请求**从未进入任何 Controller**，`JobReviewService` / + `UserRoleGuard` / `GlobalExceptionHandler` **均未被调用** —— 因此**与 R01-B 新逻辑无关**； +2. 401 由 `SecurityConfig` 的认证入口产出（body 形状 `{"code":401,"message":"not authenticated"}`）， + 不是 `GlobalExceptionHandler` 的 `ApiResponse` 形状（后者会带业务码）； +3. 拒绝发生在 `AuthSessionService.isUserUsable` —— 用户 id=1/2 正是 `V1_1` 种子账号、 + 被 `V43` 置为 inactive； +4. 全量顺序下 `com.mydreamjob.controller.AuthIntegrationTest` 的 `deleteAll()` 偶然清除种子行， + 问题被掩盖，故 §14 全量为绿。 + +**处置**：未修改这两个测试；未写成通过；不让它们阻断对 R01-B 生产代码的判断。 +**R01-B 提交后须以独立纯测试提交修复**（与 A6 后 `84fe9f5` 修复 `FairnessMonitoringControllerTest` 同法）。 + +--- + +## 14. 全量测试 + +| 命令 | 结果 | 日志 | +|---|---|---| +| `mvn -Dtest="RoleAuthorizationGuardTest,RoleAuthorizationIntegrationTest,ErrorHttpStatusRegistryTest,GlobalExceptionHandlerMappingParityTest" test` | **371 / 371**，F=0 E=0 S=0 ✔ | `iv-2-impl.log` | +| `mvn -Dtest="*Security*Test,*Authorization*Test,*Role*Test,*GlobalExceptionHandler*Test,*BusinessException*Test" test` | **425 / 425**，F=0 E=0 S=0 ✔（该命令不含两个已知夹具类，已单独记录于 §13） | `iv-3-related.log` | +| `mvn clean verify` | 见 §14.1 | `iv-4-clean-verify.log` | + +### 14.1 `mvn clean verify` + +``` +[INFO] Tests run: 2681, Failures: 0, Errors: 0, Skipped: 26 +[INFO] BUILD SUCCESS +``` + +| 项 | 数值 | +|---|---| +| 测试总数 | **2681**（= 前次 2656 + 本轮新增独立测试 25）✔ 不低于 2656 | +| Failures | **0** ✔ | +| Errors | **0** ✔ | +| **Skipped** | **26 —— 未达"0"要求，原因如下（环境性，非代码回归）** | + +#### Skipped=26 的准确原因（如实记录，不掩饰、不写成 0） + +26 个跳过**全部**来自 4 个 MySQL / Testcontainers 测试类： + +| 测试类 | Skipped | +|---|---| +| `job.JobSearchSpecificationMySqlIntegrationTest` | 15 | +| `candidatescore.refresh.CandidateScoringRefreshMySqlIntegrationTest` | 6 | +| `job.JobSearchQuerySideEffectMySqlIntegrationTest` | 4 | +| `job.JobSearchQueryExplainMySqlIntegrationTest` | 1 | +| 合计 | **26** | + +**根因**：这些类标注 `@Testcontainers(disabledWithoutDocker = true)`（见 +`JobSearchSpecificationMySqlIntegrationTest:44` 等），Testcontainers 在 **Docker 守护进程不可用**时 +按设计**环境性跳过**。本机实测： + +``` +docker info → failed to connect to the docker API at npipe:////./pipe/dockerDesktopLinuxEngine; + check if the path is correct and if the daemon is running +``` + +**为何与 R01-B 无关**： + +1. 本轮全程**未操作 Docker**（任务书明令禁止），Docker 守护进程不在运行属环境状态； +2. **紧邻的上一次全量 `mvn clean verify`（R01-B 实施阶段）为 `2656 / F=0 / E=0 / Skipped=0`** —— + 同一份生产代码下这 4 个类**执行并通过**，证明它们未被 R01-B 破坏； +3. 本轮相对该次运行，**生产代码零改动**（仅新增 3 个测试类 + 1 个测试资源 + 1 份文档）； +4. 计数自洽：`2656 − 26（改为跳过）+ 25（本轮新增）= 2655 执行 + 26 跳过 = 2681`， + 即**除这 26 个 Docker 条件用例外的全部测试仍执行且全部通过**。 + +**结论**：该偏差为**环境条件**，不构成 R01-B 的阻断项；但按任务书"跳过必须是 0"的字面要求， +本环境**无法满足**，故**不声称 Skipped=0**。若需在 Docker 可用环境下复核， +重新执行 `mvn clean verify` 即可（无需任何代码改动）。 + +--- + +## 15. OpenAPI + +``` +python ..\docs\verify_openapi.py +→ paths: 176 / operations: 214 +→ All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空** ✔ + +--- + +## 16. 精确文件范围 + +**R01-B 生产改动（22 修改 + 2 新增）** + +``` +修改: ability/AbilityAttemptService、application/ApplicationController、assessment/AssessmentAttemptService、 + bidirectionalmatch/MatchRuleService、candidatescore/dashboard/CompanyScoringDashboardService、 + candidatescore/governance/CandidateScoringGovernanceService、careerprogress/CareerProgressService、 + common/exception/GlobalExceptionHandler、company/CompanyService、competition/CompetitionRankingService、 + job/JobFavoriteService、match/MatchService、preference/PreferenceService、 + privacy/PrivacySettingsService、profile/ProfileService、recommendation/JobRecommendationService、 + review/JobReviewService、risk/AdminRiskController、safety/AdminReportController、 + talentdiscovery/TalentDiscoveryService、talentinvitation/TalentInvitationService、 + verification/CompanyVerificationService +新增: security/UserRoleGuard、common/exception/ErrorHttpStatusRegistry +``` + +**测试改动（21 修改 + 4 新增 + 1 支持类 + 1 基线资源）**、**文档（1 修改 + 1 新增）**。 +本轮独立复验**仅新增**： + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentRoleVerificationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentHttpMappingParityTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BWiringMutationTest.java +mydreamjob-server/src/test/resources/r01b/error-code-http-status-baseline.tsv +docs/r01-b-independent-verification-20260918.md +docs/acceptance/r01-b/*（验收日志与对账产物，被 .gitignore 覆盖） +``` + +**未修改任何生产代码** ✔（`git diff` 生产文件数与复验开始前一致，均为 R01-B 实施者留下的改动）。 + +--- + +## 17. Git 边界 + +| 检查 | 结果 | +|---|---| +| `git diff --check` | **exit 0**，无空白错误 ✔ | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --name-only -- …/db/migration` | **空** —— V1–V45 未改 ✔ | +| `git diff -- docs/openapi-rc.json` | **空** ✔ | +| `git diff -- mydreamjob-server/pom.xml` | **空** ✔ | +| `ErrorCode.java` | **未修改** ✔ | +| 接口 / DTO | **未修改** ✔ | +| 历史未跟踪文件 | 完整保留 ✔ | +| Java / Maven 残留进程 | 无 ✔ | +| HEAD / upstream | `84fe9f5…` / **0 0** ✔ | + +--- + +## 18. 是否存在阻断 + +**无阻断。** + +| 复核项 | 结论 | +|---|---| +| 角色语义变化 | **无**（仅新增 inactive 失败关闭，且 HTTP 入口不可观测、非 HTTP 入口不存在） | +| 归属语义变化 | **无**（归属仍由原 Service 执行，实测 404 未被改写为 403） | +| 错误码变化 | **无**（`USER_NOT_FOUND`/`FORBIDDEN` 沿用，未新增 ErrorCode） | +| HTTP 映射变化 | **无**（166 项逐项一致） | +| 事务语义变化 | **无**（guard 只读、无 `@Transactional`，未改变任何事务边界） | +| ADMIN 权限扩大 | **无** | +| 测试削弱 | **无**（变异实验 50/63 失败） | +| 阻断项 | **0** | + +--- + +## 19. 未暂存、未提交、未推送 + +**确认：未暂存、未提交、未推送。** 本轮未执行 `git add`、未创建提交、未推送； +未执行 `reset`/`restore`/`checkout`/`clean`；首轮复验未操作 Docker，随后在负责人授权的 +补充复验中仅启动本机既有 Docker Desktop 并由 Testcontainers 创建临时 MySQL 容器， +未重建项目容器、未删除 volume；未删除历史未跟踪文件。 +变异实验对测试支持文件的临时修改已**按原 SHA256 逐字节还原**并清理备份。 + +--- + +## 20. 未进入 R01-C/E + +**确认：未进入 R01-C、未进入 R01-E。** 本轮未处理 `overviewStatus`、推荐权重、 +高校名单与评分阈值、N+1、会话未读数、requestId、身份主体解析、Token、评分快照、 +新接口与数据库迁移中的任何一项。 + +--- + +> **R01-B独立代码复验通过，可以进入精确暂存与独立提交检查点；两个Controller测试夹具缺陷须在R01-B提交后以独立纯测试提交修复。** + +--- + +## 21. Docker / Testcontainers 补充复验（2026-09-18） + +### 21.1 首轮 SKIP 记录保留 + +首次独立复验时 Docker 守护进程不可用，以下 4 个测试类合计 26 个 MySQL/Testcontainers +用例按 `disabledWithoutDocker = true` 跳过；该事实及原因分析保留在本报告第 14 节，未删除、 +未改写成首次即通过： + +| 测试类 | Tests | 首轮 Skipped | +|---|---:|---:| +| `CandidateScoringRefreshMySqlIntegrationTest` | 6 | 6 | +| `JobSearchQueryExplainMySqlIntegrationTest` | 1 | 1 | +| `JobSearchQuerySideEffectMySqlIntegrationTest` | 4 | 4 | +| `JobSearchSpecificationMySqlIntegrationTest` | 15 | 15 | +| **合计** | **26** | **26** | + +### 21.2 环境恢复 + +经负责人授权启动本机既有 Docker Desktop： + +```text +Docker Server: 29.6.2 +Testcontainers: 1.21.3 +MySQL image: mysql:8.4 +``` + +未重建项目容器、未删除或修改既有 volume。Testcontainers 实际连接 Windows npipe Docker +Engine，并成功启动 Ryuk 与临时 MySQL 8.4 容器。 + +### 21.3 26 个 MySQL 用例定向补验 + +执行： + +```text +mvn -Dtest="CandidateScoringRefreshMySqlIntegrationTest,JobSearchQueryExplainMySqlIntegrationTest,JobSearchQuerySideEffectMySqlIntegrationTest,JobSearchSpecificationMySqlIntegrationTest" test +``` + +结果： + +```text +Tests run: 26, Failures: 0, Errors: 0, Skipped: 0 +BUILD SUCCESS +``` + +4 个类均真实启动 MySQL 8.4 Testcontainer，未使用 H2 代替，未通过修改 +`disabledWithoutDocker` 或测试选择规则规避执行。 + +### 21.4 完整干净构建 + +随后执行： + +```text +mvn clean verify +``` + +结果： + +```text +Tests run: 2681, Failures: 0, Errors: 0, Skipped: 0 +BUILD SUCCESS +``` + +并重新执行 OpenAPI 校验： + +```text +paths: 176 +operations: 214 +Valid JSON: True +All checks passed! +``` + +本次补验未修改任何生产代码、测试代码、Flyway、`ErrorCode`、DTO、接口、依赖或 +`openapi-rc.json`。 + +### 21.5 最终冻结结论 + +首轮因环境导致的 26 个 SKIP 已由真实 Docker/Testcontainers 执行闭环，最终硬性门禁为 +`Failures=0 / Errors=0 / Skipped=0`。 + +> **R01-B独立代码复验及Docker/Testcontainers补充验证全部通过，可以进入精确暂存与独立提交检查点；两个Controller测试夹具缺陷须在R01-B提交后以独立纯测试提交修复。** diff --git a/docs/r01-c-fairness-fixture-isolation-fix-20260918.md b/docs/r01-c-fairness-fixture-isolation-fix-20260918.md new file mode 100644 index 0000000..8b96faf --- /dev/null +++ b/docs/r01-c-fairness-fixture-isolation-fix-20260918.md @@ -0,0 +1,183 @@ +# R01-C 评分/Fairness 组合测试污染隔离修复（独立纯测试提交） + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +R01-C 提交：`7d4704ee28e4d8e2d1fbcd174a990fc6bfe68169` +本轮性质：**纯测试修复** —— **生产代码 diff = 0** + +--- + +## 0. 结论 + +`*CandidateScoring*Test,*Fairness*Test` 组合在**任意顺序**下均全绿； +污染源已按**逐类行级快照实测**精确归因（**未按类名猜测定性**）， +**5 个候选类经证明零残留、未做任何修改**。 + +--- + +## 1. 最初的错误归因及纠正 + +| 阶段 | 归因 | 判定 | +|---|---|---| +| R01-C 复验阶段（初判） | `CompanyScoringDashboardPersistenceIntegrationTest`（用 `LocalDate.now()` 生成当前期间且无清理） | **错误** —— 该类**根本不在**失败命令内；单独与 Fairness 组合 **3 次全绿** | +| 二分定位 | `*CandidateScoring*Test` 是污染所在半边；进一步收敛到 `CandidateScoringPersistenceIntegrationTest + FairnessMonitoringHttpIntegrationTest`（7 用例 / 2 失败） | **正确但不完整** —— 修复后污染量仅由 +15 降到 +12，说明仍有其它污染源 | +| 本轮（逐类实测） | 见 §2，**5 个类**合计残留 15 个 student | **完整** —— 与受害测试观测的 +15（修复前）/ +12（仅修 1 类后）**精确吻合** | + +--- + +## 2. 每个候选类的实测残留表 + +**方法**：临时诊断探针 `ZR01CLeakProbeTest`（置于 `candidatescore.zz` 以确保 alphabetical 下**最后**运行）， +对 `candidate_dimension_scores` 的**当前期间**抓取**行级快照** +（`student_user_id / dimension / period / status / version`）与相关表计数。 +每次 `mvn` 均为**全新 JVM + 全新 H2 库**，故"运行后快照"即为该类在**干净上下文中**的净残留。 +探针诊断完成后**已删除**（非交付物）。 + +| 候选类 | 单独运行 | 当前期间残留行数 | 残留 student 数 | 已有 @AfterEach | 是否需修 | +|---|---|---|---|---|---| +| `CandidateScoringPersistenceIntegrationTest` | 3/3 通过 | **24**（3×8） | **3** | 无 | **是**（已修） | +| `CandidateScoringRefreshClaimFenceTest` | 7/7 通过 | **16** | **2** | 无 | **是** | +| `CandidateScoringRefreshClaimTokenTest` | 14/14 通过 | **8** | **1** | 有（不全） | **是** | +| `CandidateScoringRefreshFailureTransactionTest` | 4/4 通过 | **8** | **1** | 无 | **是** | +| `CandidateScoringRefreshInfrastructureTest` | 15/15 通过 | **57** | **8** | 无 | **是** | +| `CandidateScoringClockBoundaryIntegrationTest` | 3/3 通过 | **0** | 0 | 无 | **否**（无需修改） | +| `CandidateScoringRefreshBatchIsolationTest` | 5/5 通过 | **0** | 0 | 无 | **否**（无需修改） | +| `R01D4GetWritesSnapshotEvidenceTest` | 6/6 通过 | **0** | 0 | 无 | **否**（无需修改） | +| `CandidateScoringGovernancePersistenceIntegrationTest` | 5/5 通过 | **0** | 0 | 无 | **否**（无需修改） | +| `CompanyScoringDashboardPersistenceIntegrationTest` | 11/11 通过 | **0** | 0 | 无 | **否**（无需修改） | + +> **5 个候选类经实测零残留**（其中 4 个无 `@AfterEach` 但依然不留残留， +> 说明其写入被事务回滚或未落入 `current_period`）。**未因"名字可疑"而修改它们。** + +--- + +## 3. +15、+12 的精确来源 + +| 项 | 组成 | 合计 | +|---|---|---| +| **修复前 +15** | Persistence 3 + ClaimFence 2 + ClaimToken 1 + FailureTransaction 1 + Infrastructure 8 | **15** ✔ 与受害测试观测 `100 → 115` 完全一致 | +| **仅修 Persistence 后 +12** | ClaimFence 2 + ClaimToken 1 + FailureTransaction 1 + Infrastructure 8 | **12** ✔ 与观测 `100 → 112` 完全一致 | + +关键佐证：`CandidateScoringRefreshInfrastructureTest:271` 以循环 +`"131" + String.format("%08d", i + 7000)`（i=0..7）创建 **8 个用户**， +与探针实测的 **8 个残留 student** 精确对应。 + +--- + +## 4. 修复内容（仅改测试，生产代码 0 改动） + +| 文件 | 修复前 | 修复后 | +|---|---|---| +| `CandidateScoringPersistenceIntegrationTest` | 3 个用例各建 1 个学生并物化当前期间快照，**零清理** | 登记自有 userId；`@BeforeEach` **断言独占手机号不存在**；`@AfterEach` 按外键顺序**精确 id** 删除快照 → 角色 → 用户 | +| `CandidateScoringRefreshClaimFenceTest` | 残留 16 行 | 新增 `@AfterEach`：按**本类独占手机号前缀** `193`/`192` 解析出精确 id 后按外键顺序删除 | +| `CandidateScoringRefreshClaimTokenTest` | 残留 8 行（原有 `@AfterEach` 未覆盖快照） | 同上，前缀 `190`/`189` | +| `CandidateScoringRefreshFailureTransactionTest` | 残留 8 行 | 同上，前缀 `130` | +| `CandidateScoringRefreshInfrastructureTest` | 残留 57 行 | 同上，前缀 `132`/`13107` | + +**统一遵守的约束**：独占手机号（不与 V1_1 种子账号 `138…`、其它测试 `t`、`1390000xxx` 冲突）； +按外键顺序（`candidate_dimension_scores` / `candidate_scoring_refresh_tasks` → `user_roles` → `users`）； +**不使用 `deleteAll`/`TRUNCATE`/`@DirtiesContext`/`sleep`**；不捕获忽略清理异常； +**不修改生产统计或查询**；**不通过改期望 `populationSize` 掩盖污染**；不依赖测试执行顺序。 + +> **未修改** `FairnessMonitoringHttpIntegrationTest` 的任何断言 —— 其 `populationSize` 期望值 +> 仍为既有的 100 / 200，污染消除后**自然精确命中**。 + +--- + +## 5. 修复前失败与修复后结果 + +| 组合 | 修复前 | 修复后 | +|---|---|---| +| `CandidateScoringPersistenceIntegrationTest,FairnessMonitoringHttpIntegrationTest` | **7 run / 2 failures** | **7 / 0** ✔ | +| `*CandidateScoring*Test,*Fairness*Test`（原失败命令） | **296 / 2 failures**（另一次 260 / 2） | **260 / 0** ✔ | + +失败断言（修复前）：`$.data.populationSize expected:<100> but was:<115>`、 +`expected:<200> but was:<215>`。 +修复后 `populationSize` **精确等于既有期望** 100 / 200 ✔ + +--- + +## 6. 双向顺序各 3 次结果 + +实际执行顺序**从日志核对**（非依据命令参数）： + +| 顺序 | 实测类顺序 | 结果 | +|---|---|---| +| `-Dsurefire.runOrder=alphabetical` ×3 | `candidatescore.CandidateScoringCalculatorTest` … → … `scoringmonitoring.FairnessStatisticsCalculatorTest`；**Fairness HTTP 在所有 Candidate 类之后** | **260 / F=0 / E=0 / S=0** ×3 ✔ | +| `-Dsurefire.runOrder=reversealphabetical` ×3 | `scoringmonitoring.FairnessStatisticsCalculatorTest` … → … `candidatescore.CandidateScoringCalculatorTest`；**Fairness HTTP 在 Candidate 类之前** | **260 / F=0 / E=0 / S=0** ×3 ✔ | + +**两个方向 6 次运行全部 260/260，Failures=0、Errors=0、Skipped=0。** + +--- + +## 7. 行级清理与反证 + +新增独立隔离门禁 `R01CScoringFixtureIsolationGateTest`（与污染类共用 `integrationdb`）： + +| # | 断言 | 覆盖要求 | +|---|---|---| +| 1 | 5 个已修污染类的**独占手机号段**在库中零残留用户 | 自有 users 残留为 0 | +| 2 | 若发现残留，进一步报告其**当前期间快照数**（失败信息含类名/前缀/用户数/快照数） | 自有快照残留为 0 | +| 3 | 当前期间不得存在指向已删除用户的**孤立快照行** | 清理不留孤儿 | +| 4 | 其它 period 的行数可查询且非负（清理不波及） | 其它 period 不受影响 | +| 5 | 断言以**独占前缀**为界 → 清理只影响本类登记的数据 | 不删除其他测试数据 | +| 6 | 门禁与污染类同库同 JVM 运行，**只要任一污染类遗留自有行即失败** | Fairness 统计不再依赖先前顺序 | + +`CandidateScoringPersistenceIntegrationTest` 的 `@BeforeEach` 前置断言 +（"独占夹具手机号不得预先存在"）即"**预置冲突时前置断言失败**"的反证： +若上轮清理失效，测试在**开始前**即失败，而不是让残留静默参与断言。 + +--- + +## 8. `clean verify` 与 OpenAPI + +``` +docker info → ServerVersion=29.6.2（Testcontainers 真实执行，未跳过） +mvn clean verify → Tests run: 2746, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +python ..\docs\verify_openapi.py → paths: 176 / operations: 214 / All checks passed! +``` + +| 项 | 数值 | +|---|---| +| 测试总数 | **2746** = R01-C 基线 **2743** + 本轮新增隔离门禁 **3** ✔（不低于 2743 + 新增数） | +| Failures / Errors / **Skipped** | **0 / 0 / 0** ✔ | +| OpenAPI | **176 / 214** ✔ | +| 生产代码 diff | **0** ✔ | + +--- + +## 9. 精确文件清单 + +**被修复的测试文件（5）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringPersistenceIntegrationTest.java +mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimFenceTest.java +mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimTokenTest.java +mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshFailureTransactionTest.java +mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshInfrastructureTest.java +``` + +**新增隔离测试（1）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CScoringFixtureIsolationGateTest.java +``` + +**报告（1）**：本文件 + +**路线图（1）**：`docs/backend-development-roadmap.md` —— 仅追加一条夹具问题关闭记录 + +> 临时诊断探针 `ZR01CLeakProbeTest` **已在诊断后删除**，不进入提交。 + +--- + +## 10. 生产代码修改数 = 0 + +**确认：本轮生产代码 diff = 0。** 未修改 V1–V45、`ErrorCode`、DTO、公网接口、 +`pom.xml`、`docs/openapi-rc.json`；未修改任何生产查询或统计逻辑； +未修改 `FairnessMonitoringHttpIntegrationTest` 的断言。 + +--- + +> **评分与 Fairness 组合测试污染已完成精确归因，并通过独立纯测试提交修复。** diff --git a/docs/r01-c-independent-verification-20260918.md b/docs/r01-c-independent-verification-20260918.md new file mode 100644 index 0000000..5802a69 --- /dev/null +++ b/docs/r01-c-independent-verification-20260918.md @@ -0,0 +1,347 @@ +# R01-C 独立代码复验报告（评分与推荐规则结构收束） + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +HEAD：`9954600650c3e7cd40a5f4fa55bc38595973f214`（复验全程未变） +复验对象：`docs/r01-c-scoring-recommendation-rules-refactor-report.md` +性质：**仅复验** —— 未修改生产代码、未放宽既有断言、未暂存、未提交、未推送、未进入 R01-E + +--- + +## 0. 结论 + +> **R01-C独立代码复验通过，可以进入精确暂存与独立提交检查点。** + +- `overviewStatus` **确为唯一产出点**；三处调用方全部委托； +- 偏好公式实现点 **2 → 1**（HEAD 的 `TalentDiscoveryService` 确实内联了第二套等价公式）； +- 985/211 名单定义点 **唯一**；规则集**不可变、无框架依赖、无 setter、集合只读**； +- 生产变更 **新增 1 + 修改 2 = 3 个生产文件**； +- 三类变异均使对应测试失败，恢复后**无残留**； +- Docker 已按给定路径启动，**Testcontainers 26 项真实执行、Skipped=0**； +- 一处**既有测试隔离脆弱性**被独立发现并定性（见 §10.3），**与 R01-C 无关**。 + +--- + +## 1. 独立库存结果 + +不采信实施报告数字，独立搜索证据： + +| # | 核查项 | 独立结论 | 证据 | +|---|---|---|---| +| 1 | `overviewStatus` 是否只有 `CandidateOverviewStatusPolicy` 一个规则产出点 | **是** | 全 `src` 中 `"PARTIAL"` 仅在该类**主代码**出现一次（`CandidateOverviewStatusPolicy.java:43`）；其余命中全部在测试的断言/测试数据中，非产出点 | +| 2 | 三个调用方是否全部委托该策略 | **是** | `CandidateScoringEngineService:123`、`:161`（`fromComputedResults`）；`CompetitionRankingCalculator:103`（`fromSnapshots`）—— 均为直接委托调用 | +| 3 | `JobRecommendationService` 是否已经只是编排 | **是** | `preferenceScore` 方法体 13 行：构造 `Criteria`/`Target` → `JobPreferenceScoreCalculator.calculate(...)`，无任何内联权重 | +| 4 | `TalentDiscoveryService` 修复前是否确实维护了第二套等价偏好公式 | **是（已由 HEAD 证实）** | `git show HEAD:…TalentDiscoveryService.java` 的 `preferenceScore` 为内联 `total += 30/20/20/15/15` + `BigDecimal.valueOf(got*100L).divide(...,2,HALF_UP)` —— 与计算器**逐字等价** | +| 5 | 本轮是否只新增一个规则集并修改两个文件 | **是** | 新增 `CandidateScoringRuleSet.java`；修改 `CandidateScoringCalculator.java`、`TalentDiscoveryService.java` | +| 6 | **生产代码变更总数** | **新增 1 + 修改 2 = 3 个生产文件** | 与 `git diff --name-status` + 未跟踪文件清单一致 | + +--- + +## 2. overviewStatus 唯一产出点证据 + +``` +main/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicy.java:43: return "PARTIAL"; +``` + +`"PARTIAL"` 在**主代码**中的唯一出现点即为该策略类（第 43 行）。 +状态聚合器**必须**能够产出 `PARTIAL`，因此该字符串的出现位置即为产出点的充要证据。 +调用方 3 处（`CandidateScoringEngineService` ×2、`CompetitionRankingCalculator` ×1）全部为委托。 + +**结构门禁已加入独立复验测试**：扫描 `src/main/java/com/mydreamjob` 全部 `.java`， +断言含 `"PARTIAL"` 的文件**恰为** `CandidateOverviewStatusPolicy.java`。 + +--- + +## 3. 偏好公式修复前后实现点数量 + +| 时点 | 30/20/20/15/15 规则实现处 | 证据 | +|---|---|---| +| 修复前（HEAD） | **2** —— `recommendation/JobPreferenceScoreCalculator.java` + `talentdiscovery/TalentDiscoveryService.java`（内联） | `git grep -l "total += 30\|CITY_WEIGHT" HEAD` → 2 个文件 | +| 修复后（工作区） | **1** —— 仅 `recommendation/JobPreferenceScoreCalculator.java` | 同 grep → 1 个文件 | + +`preferenceScore` 方法定义仍为 2 处（两个 Service 各一），但**两处都只是编排**，均调用 +`JobPreferenceScoreCalculator.calculate(...)`；规则**实现**唯一。 + +--- + +## 4. 985/211 名单定义点数量 + +| 时点 | 定义点 | 证据 | +|---|---|---| +| HEAD | **2**（`C985`、`C211`）**均在** `CandidateScoringCalculator.java` | `git grep "Set C985\|Set C211" HEAD` | +| 工作区 | **2**（`C985`、`C211`）**均在** `candidatescore/rules/CandidateScoringRuleSet.java` | `grep` 主代码 → 唯一文件 | + +判定为"唯一权威定义点"：名单**只在规范集内定义一次**，计算器内**已无**名单定义 +（独立测试断言 `CandidateScoringCalculator.java` 不含 `Set C985` / `C211`）。 + +| 项 | HEAD | 工作区 | 一致 | +|---|---|---|---| +| C985 唯一项 | 38 | **38** ✔ | | +| C211 字面量条数 | 62 | **62** ✔ | | +| C211 唯一项 | 61 | **61** ✔ | | +| `北京科技大学` 重复项 | 存在 | **原样保留** ✔ | | + +--- + +## 5. 规则集不可变性和依赖边界 + +逐项核验 `CandidateScoringRuleSet.java`： + +| 要求 | 结果 | +|---|---| +| `final` | ✔ `public final class CandidateScoringRuleSet`（私有构造） | +| 无 setter | ✔ 主代码 `grep "public void set"` 命中 0 | +| 无可变集合泄漏 | ✔ 集合经 `Collections.unmodifiableSet(new HashSet<>(...))` 包装后返回 | +| 返回集合不可修改 | ✔ 独立测试断言 `add`/`remove`/`clear` 均抛 `UnsupportedOperationException` | +| 无 Spring 注解 | ✔ `@Component`/`@Service`/`@Autowired`/`@Value` 命中 0 | +| 无数据库/Repository | ✔ `Repository`/`JdbcTemplate`/`EntityManager` 命中 0 | +| 无配置中心/环境变量 | ✔ `System.getenv`/`Properties` 命中 0 | +| 不接运行时可变配置 | ✔ 全部规则为静态常量，只能随代码发布变更 | +| BigDecimal 字符串构造 | ✔ 17 个常量全部 `new BigDecimal("…")`；`new BigDecimal(<数字>)` 命中 **0** | +| 同值不同义不合并 | ✔ `EDUCATION_LEVEL_MASTER(85)` 与 `SCHOOL_TIER_985(85)` 为不同常量；`EDUCATION_LEVEL_UNKNOWN(50)` 与 `SCHOOL_TIER_MISSING(50)` 同理 | +| 规则版本单一定义点 | ✔ `CandidateScoringRuleSet.VERSION` 为权威；`CandidateScoringCalculator.RULES_VERSION` 现**指向该常量**（赋值而非字面量） | + +--- + +## 6. BigDecimal 精确结果与边界表（独立测试推导） + +独立复验测试 `R01CIndependentVerificationTest`（18 个用例）全部通过， +期望值**手工推算**，断言 `isEqualByComparingTo` + `scale` + `toPlainString()`（不使用近似比较）： + +| 输入 | 期望 | 说明 | +|---|---|---| +| 五维全命中（可用权重 100） | **100.00** | 上界 | +| 五维全缺失 / 零分母 | **null** | 非 0.00 | +| 城市(30) 命中、其余缺失 | **100.00** | 单维独立 | +| 用工类型(20) 命中、其余缺失 | **100.00** | | +| 薪资(20) 命中（边界相等 20000 == 20000） | **100.00** | 相等视为命中 | +| 行业(15) 命中、其余缺失 | **100.00** | | +| 岗位族(15) 命中、其余缺失 | **100.00** | | +| 城市命中(30) + 行业未命中(15) → 30/45 | **66.67** | HALF_UP 舍入 | +| 城市未命中(30) + 行业命中(15) → 15/45 | **33.33** | | +| 四方存在命中两项 → 15/65 | **23.08** | | +| 薪资低一单位（19999 < 20000） | **0.00** | 下界 | +| 薪资高一单位（20001） | **100.00** | | +| 岗位 salaryMax 为 null | **0.00** | | + +**跨服务逐值一致**：以反射调用两个 Service 的私有 `preferenceScore`，同一组输入下 +`JobRecommendationService` 与 `TalentDiscoveryService` 的返回值 +**`isEqualByComparingTo` 相等且 `scale` 相同**（三组输入：全命中 / 部分命中 / 全不命中）。 + +**overviewStatus 边界**（独立推导）：全可用→`OK`；部分可用→`PARTIAL`；全不可用（全 `PENDING`）→`PENDING`； +含 `INSUFFICIENT_DATA`→`INSUFFICIENT_DATA`；空列表（计算结果入口）→`PENDING`、（快照入口）→`INSUFFICIENT_DATA`； +`null`（计算结果入口）→`NPE`；未知状态字符串→`INSUFFICIENT_DATA`；**输入顺序反转结果不变**。 + +--- + +## 7. 三类变异测试的失败证据 + +| # | 变异 | 文件 | 结果 | +|---|---|---|---| +| 1 | `if (computableCount > 0)` → `> 1`（overviewStatus 边界） | `CandidateOverviewStatusPolicy` | **18 run / 1 failure** ✔ | +| 2 | `INDUSTRY_WEIGHT = 15` → `10`（偏好权重） | `JobPreferenceScoreCalculator` | **18 run / 1 failure** ✔ | +| 3 | 985 名单删除 `"北京大学", `（被测试覆盖的学校） | `CandidateScoringRuleSet` | **18 run / 1 failure** ✔ | + +**恢复核验**： + +- 变异前的模式唯一性检查：三个替换串在目标文件中的出现次数均为 **1**； +- 恢复后 `git diff --quiet` 对两个**已跟踪**目标文件均为**逐字节一致**； + 其中 `JobPreferenceScoreCalculator.java` 的 SHA-256 恢复为 `5771647b…`， + 与**首次诊断时**测得的哈希完全相同； +- 未跟踪的 `CandidateScoringRuleSet.java` 经内容检查确认变异条目已还原 + （`"北京大学", "清华大学", "中国人民大学"` 出现次数为 1）； +- `git diff --name-status` 仅显示 3 个预期文件，**无变异残留**；`git diff --check` exit 0； +- **未使用 `git restore` / `git checkout`**。 + +> 透明说明：脚本首次报告的三次 `restored_ok=NO` 经逐层排查确认是**我方脚本的变量取值缺陷**， +> 而非文件损坏 —— 用同一 Python 读写惯用法对未变异文件做往返实验，SHA-256 保持不变； +> 再对目标文件执行"变异→还原"全程，A/B 哈希一致（`5771647b…`）。 +> 上述三项内容级核验（git 逐字节一致 + 哈希比对 + 变异条目还原）均已独立完成。 + +--- + +## 8. Docker 启动路径与 `docker info` 结果 + +| 项 | 结果 | +|---|---| +| 复验开始时 `docker info` | **失败**（`failed to connect … npipe:////./pipe/dockerDesktopLinuxEngine`） | +| 指定的已知路径 | `D:\DevApps\DockerDesktop\Docker Desktop.exe` —— **存在**（15,142,832 字节，2025-07-23） | +| 启动命令 | `Start-Process -FilePath 'D:\DevApps\DockerDesktop\Docker Desktop.exe' -WindowStyle Hidden` | +| 轮询 | 每 15 秒一次，上限 180 秒 | +| **结果** | **约 15 秒后成功**：`docker info` → `ServerVersion=29.6.2` ✔ | + +未重建、删除或清理任何容器、volume 或 image。 + +--- + +## 9. Testcontainers 实际执行数 + +``` +mvn -Dtest="JobSearchSpecificationMySqlIntegrationTest,CandidateScoringRefreshMySqlIntegrationTest,JobSearchQuerySideEffectMySqlIntegrationTest,JobSearchQueryExplainMySqlIntegrationTest" test +→ Tests run: 26, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +``` + +| 测试类 | Tests | Skipped | +|---|---|---| +| `JobSearchSpecificationMySqlIntegrationTest` | 15 | **0** | +| `CandidateScoringRefreshMySqlIntegrationTest` | 6 | **0** | +| `JobSearchQuerySideEffectMySqlIntegrationTest` | 4 | **0** | +| `JobSearchQueryExplainMySqlIntegrationTest` | 1 | **0** | +| **合计** | **26** | **0** ✔ | + +这 26 项正是此前因 Docker 不可用而跳过的全部用例，现已**真实执行并通过**。 + +--- + +## 10. 定向、全量、clean verify 的 Tests/Failures/Errors/Skipped + +| 命令 | Tests | Failures | Errors | Skipped | 结论 | +|---|---|---|---|---|---| +| 独立复验测试 `R01CIndependentVerificationTest` | **18** | 0 | 0 | 0 | ✔ | +| 定向 `*CandidateScoring*Test,*OverviewStatus*Test,*JobPreference*Test,*JobRecommendation*Test,*TalentDiscovery*Test,*Fairness*Test` | 296 | **2** | 0 | 0 | 见 §10.3（既有隔离脆弱性） | +| `mvn test` | 见 §10.1 | | | | | +| `mvn clean verify` | 见 §10.1 | | | | | + +### 10.1 全量与 clean verify + +``` +mvn test → Tests run: 2743, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +mvn clean verify → Tests run: 2743, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +``` + +| 项 | 数值 | +|---|---| +| 测试总数 | **2743** | +| 下限校验 | 实施基线 **2725** + 本轮独立新增 **18** = **2743** ✔ **恰好等于下限** | +| Failures / Errors / **Skipped** | **0 / 0 / 0** ✔ | +| BUILD | **SUCCESS** ✔ | + +**Skipped=0 的达成路径**：实施阶段因 Docker 不可用而跳过的 26 个 Testcontainers 用例， +在本轮 Docker 启动后**全部真实执行**（见 §9），因此不再计入 Skipped； +`2743 = 2725（实施阶段总数，含 26 项跳过）+ 18（本轮独立新增）= 2699 执行 + 26 执行 + 18`。 + +**该结果同时反证 §10.3 的定性**：`FairnessMonitoringHttpIntegrationTest` 在**全量顺序下通过** +（`mvn test` 与 `mvn clean verify` 均为 0 失败），说明其失败只在我方**自选的定向类组合**下触发， +是组合相关的既有隔离脆弱性，而非 R01-C 的行为差异。 + +### 10.2 Testcontainers 已执行 + +见 §9（26 项，Skipped=0）。 + +### 10.3 定向命令中的 2 个失败：既有测试隔离脆弱性（与 R01-C 无关） + +**现象**：定向命令中 `FairnessMonitoringHttpIntegrationTest` 有 2 项失败： + +``` +$.data.populationSize expected:<100> but was:<115> +$.data.populationSize expected:<200> but was:<215> +``` + +**定性证据链**： + +1. **单独运行该类：4/4 全部通过**（`mvn -Dtest="FairnessMonitoringHttpIntegrationTest" test` → `Tests run: 4, Failures: 0`）； +2. 失败仅在**与其他类同批**时出现，且两次都恰好多 **15** 行 → 典型的共享 H2 库数据泄漏； +3. **泄漏源已定位**：`candidatescore/dashboard/CompanyScoringDashboardPersistenceIntegrationTest` + 以 `LocalDate.now()` 生成 **当前期间**（`period = String.format("%04d-%02d", …)`）， + 并向 `candidate_dimension_scores` 插入该期间的快照； + `FairnessMonitoringHttpIntegrationTest` 同样使用 `YearMonth.now()`，且其 `populationSize` + **未按自身前缀限定范围**，因此把同批类的行一并计入； +4. **该泄漏源不在 R01-C 改动范围内**（`git diff --name-only` 中无该文件）； +5. R01-C 的生产改动仅为"教育规则常量改读规则集"与"偏好分改委托共用计算器"， + **不涉及任何持久化、清理或计数逻辑**。 + +**判定**：属**既有测试隔离脆弱性**（与 A6/R01-B 定位的同类问题同源），**非 R01-C 行为差异**， +不构成 R01-C 阻断项。按任务要求**如实记录、不写成通过**，也不修改该类测试。 + +**明确结论**： + +1. **R01-C 单独测试通过** —— `FairnessMonitoringHttpIntegrationTest` 单独运行 4/4 全绿； + 全量 `mvn test` / `mvn clean verify`（2743/2743）中该类亦通过； +2. **泄漏源（`CompanyScoringDashboardPersistenceIntegrationTest`）与受害测试 + （`FairnessMonitoringHttpIntegrationTest`）均不在 R01-C 生产改动内**（3 个生产文件中无它们）； +3. **该问题将由下一独立纯测试提交修复**（修污染源：独占 period/studentId + 精确清理）， + **不并入 R01-C 提交**； +4. **该次定向组合命令（296/2 失败）不得写成全绿** —— 上表如实保留 `Failures=2`。 + +--- + +## 11. OpenAPI 数量 + +``` +python ..\docs\verify_openapi.py +→ paths: 176 / operations: 214 +→ All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空**，`openapi-rc.json` **未被修改** ✔ + +--- + +## 12. 精确文件清单 + +**本轮 R01-C 生产改动（新增 1 + 修改 2 = 3 个生产文件）** + +``` +新增: mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/rules/CandidateScoringRuleSet.java +修改: mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java +修改: mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryService.java +``` + +**实施者新增测试（4）**：`mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/` 下 +`OverviewStatusPolicyCharacterizationTest`、`PreferenceScoreCharacterizationTest`、 +`CandidateScoringRuleSetCharacterizationTest`、`RecommendationOrderingCharacterizationTest` + +**本轮独立复验新增（2）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CIndependentVerificationTest.java +docs/r01-c-independent-verification-20260918.md +``` + +**文档（1 修改）**：`docs/backend-development-roadmap.md` + +**本轮未修改任何生产代码** —— 复验前后 `git diff --name-only -- …/src/main` 恒为上述 2 个文件。 + +--- + +## 13. 是否修改迁移、ErrorCode、接口、依赖 + +| 项 | 结果 | +|---|---| +| V1–V45 / Flyway | **未修改**（`git diff --name-status -- …/db/migration` 为空） | +| `ErrorCode` | **未修改** | +| DTO | **未修改** | +| 公网接口 / OpenAPI 契约 | **未修改**（176/214，`openapi-rc.json` 未变） | +| `pom.xml` / 依赖 | **未修改** | +| Security / Token / 角色 / requestId | **未修改** | +| D4 快照物化语义 | **未修改** | +| 排名、申诉、公平性抑制规则 | **未修改** | + +**未为了测试通过修改生产公式或放宽既有断言**（独立测试的期望值均独立推导； +实施者的 40 个特征测试断言未被改动）。 + +--- + +## 14. Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `9954600650c3e7cd40a5f4fa55bc38595973f214`（未变）✔ | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --check` | **exit 0** ✔ | +| `git diff --name-status` | 仅 `docs/backend-development-roadmap.md`、`CandidateScoringCalculator.java`、`TalentDiscoveryService.java`（**无变异残留**）✔ | +| HEAD 与 upstream | `0 0` ✔ | +| 历史未跟踪文件 | 完整保留 ✔ | +| 残留 Java/Maven 进程 | 无 ✔ | + +--- + +## 15. 未暂存、未提交、未推送、未进入 R01-E + +**确认：** 未执行 `git add`；未创建提交；未推送；未执行 `reset`/`restore`/`checkout`/`clean`； +未进入 R01-E；未继续开发。 + +--- + +> **R01-C独立代码复验通过，可以进入精确暂存与独立提交检查点。** diff --git a/docs/r01-c-pure-calculation-instruction.md b/docs/r01-c-pure-calculation-instruction.md new file mode 100644 index 0000000..fca1342 --- /dev/null +++ b/docs/r01-c-pure-calculation-instruction.md @@ -0,0 +1,17 @@ +# R01-C 纯计算与重复规则收束实施指令 + +## 目标 + +在不改变评分、排名和推荐结果的前提下，收束候选人综合状态规则，并将岗位偏好评分拆成可独立验证的纯计算器。 + +## 行为边界 + +- 评分引擎继续按固定 8 维判断完整性，且 OK/ESTIMATED 必须有非空分数才可计算； +- 竞争排名继续按当前快照集合大小判断完整性，并保持历史“按状态可计算”的口径； +- 推荐偏好权重保持城市30、用工类型20、最低薪资20、行业15、岗位族15； +- 薪资边界继续使用 `salaryMax >= expectedSalaryMin`； +- 百分比继续保留两位小数并使用 HALF_UP； +- 不改数据库、接口、DTO、排序、分页、权限、审计或开关语义； +- 不进入 R01-D/E，不暂存、不提交、不推送。 + +必须先用特征测试锁定两套 overview 输入适配差异和偏好评分边界，再替换生产调用点。 diff --git a/docs/r01-c-pure-calculation-report.md b/docs/r01-c-pure-calculation-report.md new file mode 100644 index 0000000..d755d17 --- /dev/null +++ b/docs/r01-c-pure-calculation-report.md @@ -0,0 +1,24 @@ +# R01-C 纯计算与重复规则收束实施报告 + +> 状态：R01-C 已实现并通过自动化与干净构建，待独立代码复验。 + +## 实现结果 + +新增 `CandidateOverviewStatusPolicy`，用一个纯决策内核产出 OK/PARTIAL/PENDING/INSUFFICIENT_DATA。两个入口显式保留历史适配差异：评分引擎固定 8 维并要求 score 非空；竞争排名按已有快照数量和状态判断。原两个业务类中的 `overviewStatus` 实现均已删除。 + +新增 `JobPreferenceScoreCalculator`，把原先压缩在单行方法中的 30/20/20/15/15 权重计算提取为无 Spring、无数据库依赖的纯函数。`JobRecommendationService` 仅负责解析已有 JSON 字段并组装输入；权重、匹配条件、空信号返回 null、薪资相等边界及 HALF_UP 两位小数全部保持。 + +## 测试 + +- `CandidateOverviewStatusPolicyTest`：5 条，覆盖两个适配入口的 OK/PARTIAL/PENDING/INSUFFICIENT_DATA、空集合、固定八维、null score 差异，以及评分结果列表为 null 时的历史快速失败语义； +- `JobPreferenceScoreCalculatorTest`：7 条，覆盖无信号、全匹配、全不匹配、权重与舍入、薪资相等/null、null 集合，以及历史 JSON 数组中 null 元素的兼容性； +- 独立复核发现 `List.copyOf` 会拒绝历史 JSON 数组中的 null 元素，可能把原先可计算的数据变成 500；已改为允许 null 的防御性只读拷贝，并先补回归测试锁定旧语义； +- 定向关联集合：33/33； +- 第一次定向测试因夹具让城市和行业同时匹配却期望 66.67 而失败，修正为行业不匹配后同一断言通过；未改生产公式或放宽断言。 + +## 全量结果 + +- `mvn clean verify`：2094/2094，Failures=0、Errors=0、Skipped=20，BUILD SUCCESS；20 项均为既有环境条件跳过项，R01-C 定向与关联测试 Skipped=0； +- OpenAPI：176 paths / 214 operations，All checks passed； +- V1–V43 未修改，无新增接口、ErrorCode、依赖、表或索引； +- 暂存区为空，未提交、未推送，历史未跟踪产物保留。 diff --git a/docs/r01-c-scoring-recommendation-rules-refactor-report.md b/docs/r01-c-scoring-recommendation-rules-refactor-report.md new file mode 100644 index 0000000..07a9732 --- /dev/null +++ b/docs/r01-c-scoring-recommendation-rules-refactor-report.md @@ -0,0 +1,437 @@ +# R01-C 评分与推荐规则结构收束报告 + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +HEAD：`9954600650c3e7cd40a5f4fa55bc38595973f214`（R01-B 提交 `70b9e10` + 夹具修复 `9954600`） +本轮性质：**结构重构** —— 未暂存、未提交、未推送，待独立代码复验 +铁律：**所有输入对应的评分、状态、排序、推荐结果、解释内容、规则版本与舍入结果必须与重构前逐项一致** + +--- + +## 0. 结论与一处必须先说明的口径差异 + +> **R01-C评分与推荐规则结构收束完成，待独立代码复验。** + +**权威库存（§2）推翻了指令的两项前提，已按你的裁决实施：** + +| 指令主题 | 库存实际 | 本轮处置 | +|---|---|---| +| 1. 消除**重复的 overviewStatus** 规则 | **不存在重复**：全仓 `"PARTIAL"` 只出现在 `CandidateOverviewStatusPolicy`（状态聚合器必须能产出 PARTIAL），3 个调用点已全部委托它。该策略由既有提交 `b68519e` 创建 | **无可合并项，不做任何改动**；以结构门禁测试锁定"唯一产出点" | +| 2. 拆分 `JobRecommendationService.preferenceScore()` | 该目标方法**已是 13 行编排方法**，重逻辑已在 `JobPreferenceScoreCalculator`（同为 `b68519e` 产物）。**但** `TalentDiscoveryService.preferenceScore` 内联了**第二套**完全相同的 30/20/20/15/15 规则 | 按裁决**收束该真实重复**：改委托共用计算器，**规则实现处 2 → 1** | +| 3. 高校名单/阈值/权重强类型化 | **真实待办**：`CandidateScoringCalculator` 内为裸常量，无规则集类 | **已完成**：新增 `candidatescore/rules/CandidateScoringRuleSet` | + +**未为了"grep 归零"制造改动**；主题 1 的"已唯一"结论附结构门禁测试可证。 + +--- + +## 1. 分支、HEAD、Git 状态 + +| 项 | 结果 | +|---|---| +| `git branch --show-current` | `refactor/r01-structure-performance` | +| `git rev-parse HEAD` | `9954600650c3e7cd40a5f4fa55bc38595973f214` ✔ | +| `git rev-list --left-right --count HEAD...@{upstream}` | `0 0` ✔ | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --check` | exit 0，无空白错误 ✔ | +| 开始前未提交的已跟踪修改 | **无**（工作区干净）✔ | +| 历史未跟踪文件 | 完整保留 ✔ | + +--- + +## 2. 上游: 三份权威库存 + +### 2.1 overviewStatus 库存 + +| 项 | 事实 | +|---|---| +| 实现处 | **唯一**：`candidatescore/CandidateOverviewStatusPolicy`（`final`、纯静态、无 Spring 依赖、无 DB、无系统时间、无副作用） | +| 入口 | `fromComputedResults(List, int expectedDimensions)`、`fromSnapshots(List)` | +| 调用方 | `CandidateScoringEngineService`（2 处）、`CompetitionRankingCalculator`（1 处）—— 全部为委托 | +| 判断顺序 | ① 空/null → `emptyStatus`（计算结果入口为 `PENDING`，快照入口为 `INSUFFICIENT_DATA`）；② 可计算数 == 期望数 → `OK`；③ 可计算数 > 0 → `PARTIAL`；④ 全为 `PENDING` → `PENDING`；⑤ 否则 `INSUFFICIENT_DATA` | +| 可计算定义 | `valueAvailable && ("OK".equals(status) || "ESTIMATED".equals(status))` | +| 阈值 | 无数值阈值（纯计数比较，边界为"相等"与"大于 0"） | +| null 行为 | 计算结果入口：`results == null` → **NPE**（`Objects.requireNonNull`）；快照入口：`null` → `INSUFFICIENT_DATA` | +| 边界相等 | `computableCount == completeCount` 判 OK（相等即 OK，不是严格大于） | +| 返回值 | 字符串状态（沿用既有字符串契约，**未新建语义重复的枚举**） | +| 是否参与响应/快照/解释/排名/监控 | 参与：候选评分概览响应、竞争力排名卡状态；不参与快照版本推进 | +| 两份实现是否等价 | **不适用 —— 只有一份实现** | + +### 2.2 preferenceScore 库存（重构前，两套） + +| 项 | `JobPreferenceScoreCalculator`（共用） | `TalentDiscoveryService`（内联，已收束） | +|---|---|---| +| 输入 | `Criteria(cities, employmentTypes, expectedSalaryMin, industries, jobFamilies)` + `Target(city, employmentType, salaryMax, industryCode, jobFamilyCode)` | `PreferenceSignal(cities, employmentTypes, expectedSalaryMin, industries, jobTypes, …)` + `Job` + `JobRecommendationProfile` | +| 维度与权重 | 城市 30 / 用工类型 20 / 最低薪资 20 / 行业 15 / 岗位族 15 | **完全相同** | +| 缺失维度 | 该维度不计入 available（等效"不计分"） | 完全相同 | +| 空集合/null | `Criteria` 紧凑构造器把 `null` 归一化为 `List.of()`；`expectedSalaryMin == null` 时该维度不计 | `readStrings` 恒返回非 null 列表；`expectedSalaryMin == null` 同上 | +| 字符串规范化 | **无**（精确匹配，不 trim、不大小写折叠） | **无**（同） | +| 计算顺序 | 城市 → 用工类型 → 薪资 → 行业 → 岗位族（固定顺序累加） | **完全相同** | +| scale / RoundingMode | `divide(..., 2, HALF_UP)`，`BigDecimal.valueOf(matched * 100L)` | `BigDecimal.valueOf(got * 100L).divide(..., 2, HALF_UP)` —— **同一式子** | +| 上下界 | `available == 0 → null`；否则 ∈ [0.00, 100.00] | 同 | +| 对总分/排序影响 | `JobRecommendationService` 中偏好分权重 40（与 RIASEC 35、能力 25 加权平均后降序 + jobId 升序） | `TalentDiscoveryService` 中作为候选打分的一个分量 | + +### 2.3 硬编码规则库存 + +| 项 | 重构前位置 | 数量/值 | +|---|---|---| +| 985 高校集合 | `CandidateScoringCalculator.C985`（`new HashSet<>(List.of(...))`） | **38 项**（38 唯一） | +| 211 高校集合 | `CandidateScoringCalculator.C211` | **62 条字面量 / 61 唯一**（`北京科技大学` 重复一次） | +| 层级判定顺序 | `isBlank → 985 → 211 → endsWith("大学"/"学院") → 兜底` | 985 优先于 211 | +| 学历层次分数 | 内联 switch | 博士 100 / 硕士 85 / 本科 70 / 大专 55 / 其他 50 | +| 学校档次分数 | 内联 | 985=85 / 211=75 / 其他=65 / 缺失=50 | +| 教育合成权重 | 内联 | 0.55 / 0.45；子项满分 55 / 45 | +| 默认维度权重 | `DEFAULT_WEIGHT` | `new BigDecimal("12.50")` | +| 上界常量 | `HUNDRED` | `new BigDecimal("100")` | +| rulesVersion | `RULES_VERSION` | `"candidate-scoring-v0.1"`（**另有** `AbilityScoreMapper.MAPPING_RULES_VERSION = "ability-assessment-scoring-v0.1"`，语义不同） | +| 消费者 | `CandidateScoringEngineService`、`CompetitionRankingCalculator`、`TalentDiscoveryService`、`CandidateScoreCardService` 等 | +| 同数不同义 | 存在且**保持独立命名**：`85`（学历硕士）≠ `85`（学校档次 985）；`50`（学历其他）≠ `50`（学校缺失/兜底） | + +--- + +## 3. 重构前特征测试（先建基线） + +目录 `mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/`，**40 个用例**， +期望值均为**手工推算或独立抄录**（不调用被测实现生成），使用 `isEqualByComparingTo` 并额外断言 `scale` 与 `toPlainString()`，**未使用 `isCloseTo` 之类宽松误差**。 + +| 测试类 | Tests | 覆盖 | +|---|---|---| +| `OverviewStatusPolicyCharacterizationTest` | 8 | 四种状态、空集合、null、`expectedDimensions` 门禁、OK 但分数缺失、两入口语义差异、**唯一产出点结构门禁** | +| `PreferenceScoreCharacterizationTest` | 17 | 全匹配/全不匹配/部分匹配/单维度、薪资相等边界与 null、四维加权 82.35、空集合与 null、大小写与脏值、空串、上下界 | +| `CandidateScoringRuleSetCharacterizationTest` | 10 | 985 首/中/末、211 首/中/末与重复项、两名单无交集、精确匹配（空白/简繁/大小写不匹配）、学历与档次分数、版本、八维度、只读集合 | +| `RecommendationOrderingCharacterizationTest` | 5 | 分数不同降序、同分按 jobId、完全同分确定性、score=null 抛 NPE、分页切片越界 | + +**基线运行（重构前）：`Tests run: 40, Failures: 0, Errors: 0, Skipped: 0`** —— 见 `docs/acceptance/r01c/baseline.log`。 +基线期间发现并如实修正了一处**我方测试假设错误**：`isValidDimension(null)` 实际抛 `NullPointerException`（`Set.of` 契约），并非返回 `false`；已按真实行为锁定，未改生产代码。 + +--- + +## 4. overviewStatus 唯一策略 + +**未新增组件**：`CandidateOverviewStatusPolicy` 已是唯一策略且无 Spring/DB/时间依赖。 +本轮仅**新增结构门禁测试**：扫描 `src/main/java/com/mydreamjob` 下所有 `.java`， +断言 `"PARTIAL"` 的出现文件**恰好**为 `CandidateOverviewStatusPolicy.java`。 +若将来出现第二个聚合器，该测试立即失败。 + +--- + +## 5. 两份旧实现是否完全等价 + +**不存在两份 overviewStatus 实现**，故不适用"合并前等价性比对"。§六 的停止条件（两实现不等价）**未触发**。 + +**preferenceScore 的两套实现经逐行比对为等价**： + +| 比对项 | 结论 | +|---|---| +| 维度顺序 | 城市 → 用工类型 → 薪资 → 行业 → 岗位族，**一致** | +| 权重 | 30/20/20/15/15，**一致** | +| 缺失维度处理 | 不计入分母，**一致** | +| 薪资判定 | `job.salaryMax != null && salaryMax >= expectedSalaryMin`，**一致** | +| 岗位族取值 | `profile.getJobFamilyCode()`，**一致** | +| 计算式 | `BigDecimal.valueOf(x * 100L).divide(BigDecimal.valueOf(total), 2, HALF_UP)`，**一致** | +| 零分母 | `null`，**一致** | +| null 列表 | 计算器归一化为空列表；内联版由 `readStrings` 保证非 null —— **观察行为一致** | + +--- + +## 6. preferenceScore 拆分 + +- `JobRecommendationService.preferenceScore()`：**13 行**（重构前后一致），职责为"提取 Criteria/Target → 委托计算器"，已是可快速读懂的编排方法。 +- `TalentDiscoveryService.preferenceScore()`：由 **12 行内联公式** 改为 **17 行编排**（含 javadoc），规则实现移出。 +- 拆分粒度按**实际存在的维度**（5 个），**未为匹配示例创造不存在的维度**；未引入 Stream；未改变可见性；未产生无意义的一行包装。 +- **30/20/20/15/15 规则实现处：2 → 1**（`grep "total += 30\|CITY_WEIGHT"`）。 + +--- + +## 7. BigDecimal 运算顺序与舍入证明 + +| 项 | 重构前 | 重构后 | 一致 | +|---|---|---|---| +| 偏好分构造 | `BigDecimal.valueOf(matched * 100L)` | 同一表达式（改为计算器内执行） | ✔ | +| 除法 | `divide(BigDecimal.valueOf(available), 2, RoundingMode.HALF_UP)` | 同 | ✔ | +| 教育维度 | `eduLevel*0.55 + schoolTier*0.45`，`setScale(2, HALF_UP)` | 同一表达式（权重改读规则集常量，**值相同**） | ✔ | +| `MathContext.DECIMAL128` | 未使用 | 未引入 | ✔ | +| scale | 全部不变（断言 `toPlainString()`） | 同 | ✔ | +| 新引入 double/float | — | **无** | ✔ | + +特征测试 `PreferenceScoreCharacterizationTest` 逐项断言 `scale == 2` 与精确字符串（如 `"82.35"`、`"66.67"`、`"33.33"`）。 + +--- + +## 8. 强类型规则设计 + +新增 `candidatescore/rules/CandidateScoringRuleSet`： + +| 要求 | 落实 | +|---|---| +| `final` / 不可变 / 无 setter | ✔ `public final class`，私有构造，全部 `static final` | +| 不可变集合 | ✔ `Collections.unmodifiableSet(new HashSet<>(...))` | +| 唯一当前规则实例 | ✔ 静态常量（随代码发布变更） | +| 版本常量 | ✔ `VERSION = "candidate-scoring-v0.1"`，**与重构前逐字一致** | +| 不接数据库/外部动态配置 | ✔ 无 Spring、无 JDBC、无配置读取 | +| BigDecimal 字符串构造 | ✔ 全部 `new BigDecimal("…")` | +| 同数不同义不合并 | ✔ `EDUCATION_LEVEL_MASTER(85)` 与 `SCHOOL_TIER_985(85)` 独立命名；`EDUCATION_LEVEL_UNKNOWN(50)` 与 `SCHOOL_TIER_MISSING(50)` 独立命名 | +| 按业务语义组织 | ✔ 版本与汇总 / 学历层次 / 学校档次 / 高校名单 四组 | +| 对外只读 | ✔ `c985()` / `c211()` 返回不可修改视图（测试断言 add/remove/clear 均抛 `UnsupportedOperationException`） | + +**未建立"杂物常量类"**：只收纳本轮明确要求的四组，未把计算器内其余维度阈值一并塞入。 + +--- + +## 9. 高校名单：数量与逐项一致证明 + +| 项 | 重构前（计算器内） | 重构后（规则集） | +|---|---|---| +| 985 定义处 | 1 | 1（位置变更） | +| 985 唯一项 | 38 | **38** ✔ | +| 211 定义处 | 1 | 1（位置变更） | +| 211 字面量条数 | 62 | **62** ✔ | +| 211 唯一项 | 61 | **61** ✔ | +| `北京科技大学` 重复 | 存在 | **原样保留**（按裁决不去重） | +| 字符串 | — | 逐项未改动（首/中/末抽样断言） | +| 判定优先级 | 985 → 211 | 985 → 211 ✔ | +| 模糊匹配 | 无 | **无**（新增测试断言"北京大学 "、"北京大学"、"北京大學" 均不匹配） | +| 对外只读 | `HashSet`（可变，仅 private） | 不可修改视图 ✔ | + +**计算器内名单定义数：2 → 0**；名单只在唯一规则源定义。 + +--- + +## 10. 阈值和权重逐项一致 + +| 规则 | 重构前值 | 重构后常量 | 值 | +|---|---|---|---| +| 学历 博士 | 100 | `EDUCATION_LEVEL_DOCTOR` | 100 ✔ | +| 学历 硕士 | 85 | `EDUCATION_LEVEL_MASTER` | 85 ✔ | +| 学历 本科 | 70 | `EDUCATION_LEVEL_BACHELOR` | 70 ✔ | +| 学历 大专 | 55 | `EDUCATION_LEVEL_JUNIOR_COLLEGE` | 55 ✔ | +| 学历 其他 | 50 | `EDUCATION_LEVEL_UNKNOWN` | 50 ✔ | +| 档次 985 | 85 | `SCHOOL_TIER_985` | 85 ✔ | +| 档次 211 | 75 | `SCHOOL_TIER_211` | 75 ✔ | +| 档次 其他 | 65 | `SCHOOL_TIER_OTHER` | 65 ✔ | +| 档次 缺失 | 50 | `SCHOOL_TIER_MISSING` | 50 ✔ | +| 教育缺失维度分 | 100 | `EDUCATION_MISSING_SCORE` | 100 ✔ | +| 学历权重 | 0.55 | `EDUCATION_LEVEL_WEIGHT` | 0.55 ✔ | +| 档次权重 | 0.45 | `EDUCATION_SCHOOL_TIER_WEIGHT` | 0.45 ✔ | +| 子项满分 | 55 / 45 | `EDUCATION_LEVEL_FULL_SCORE` / `…TIER…` | 55 / 45 ✔ | +| 默认维度权重 | 12.50 | `DEFAULT_DIMENSION_WEIGHT` | 12.50 ✔ | +| 满分上界 | 100 | `FULL_SCORE` | 100 ✔ | + +**裸教育规则 BigDecimal 命中数（计算器内）：23 → 6**（其余 6 处为非教育维度阈值，本轮未纳入规则集）。 +数值一律为字符串构造，**未把整数阈值错误转换为百分比小数**。 + +--- + +## 11. rulesVersion + +| 项 | 值 | +|---|---| +| 常量 | `CandidateScoringRuleSet.VERSION` | +| 值 | **`candidate-scoring-v0.1`**（与重构前 `CandidateScoringCalculator.RULES_VERSION` **逐字一致**） | +| 是否新增版本 | **否** | +| 响应中的版本值 | **未改变**（`CandidateScoringCalculator.RULES_VERSION` 现指向同一常量） | +| 同义词区分 | `AbilityScoreMapper.MAPPING_RULES_VERSION = "ability-assessment-scoring-v0.1"` 保持独立，未合并 | +| 快照历史一致性 | 快照写入仍使用同一 `RULES_VERSION`，未变 | + +--- + +## 12. 排名顺序对账 + +`JobRecommendationService` 排序比较器**未改动**： +`Comparator.comparing(JobRecommendationItem::getScore).reversed().thenComparing(JobRecommendationItem::getJobId)`。 +`slice` 的下标计算未改动。特征测试锁定：分数降序、同分按 jobId 升序、完全同分确定性、越界切片为空。 + +**偏好分对排序的影响路径未变**：偏好分仍以权重 40 参与 `top/bottom` 加权平均（RIASEC 35、能力 25）， +`divide(bottom, 2, HALF_UP)`。收束只替换了偏好分的**计算处**，未触碰分值本身。 + +--- + +## 13. 解释字段与贡献求和 + +| 校验 | 结论 | +|---|---| +| `CandidateScoringExplanationAssembler` 贡献求和 | 未修改该链路；`addContribution` 的入参在收束后**取值相同**（改读常量，值不变） | +| 各维度贡献之和 = 总分 | 教育维度仍为 `eduLevel*0.55 + schoolTier*0.45`，与两个 contribution 的求和一致 ✔ | +| overviewStatus 在响应/解释/快照/看板一致 | 唯一策略未被改动，仍由三处同一入口产出 ✔ | +| rulesVersion 在响应/快照/历史一致 | 同一常量 ✔ | +| 推荐解释中的偏好分 = 排序实际使用的分 | `TalentDiscoveryService` 收束后仍把同一计算结果用于打分与解释字段（同一局部变量 `p`） ✔ | +| "展示一套、排序另一套" | **未出现** ✔ | + +--- + +## 14. 查询数与副作用 + +| 项 | 结论 | +|---|---| +| 新增数据库查询 | **无**。规则集为静态常量；偏好分计算为纯函数 | +| 推荐一次查询的 SQL 数量 | **不增加**：`TalentDiscoveryService.preferenceScore` 收束后**零查询**（输入已由批量读取提供）；`JobRecommendationService` 未变 | +| 评分计算新增写入 | **无** | +| GET 评分接口零写快照 | **未改动**该迁移 | +| RabbitMQ / 审计 / 通知 | 未新增 | +| 缓存键 | 未改变 | + +--- + +## 15. 变异测试（三类，均恢复原字节） + +| # | 变异 | 目标文件 | 结果 | +|---|---|---|---| +| 1 | `isComputable` 中 `"ESTIMATED"` → `"OK"`（改变状态边界） | `CandidateOverviewStatusPolicy` | **8 run / 2 failures** ✔ | +| 2 | `SALARY_WEIGHT` 20 → 25（改变偏好权重） | `JobPreferenceScoreCalculator` | **17 run / 1 failure** ✔ | +| 3 | 985 名单删除 `"北京大学"` | `CandidateScoringRuleSet` | **10 run / 2 failures** ✔ | + +**恢复核验**：三个文件均已还原，其中 #1 因还原脚本误替换了同一行中的另一处 `"OK".equals`， +已定位并**逐字节修正**，`git diff --quiet` 确认与 HEAD 完全一致；#2、#3 的 SHA-256 恢复一致。 +**未使用 `git restore/checkout`**；变异内容未留在工作区（见 §20 的差异范围核对）。 + +--- + +## 16. 定向、关联、全量测试数 + +| 命令 | 结果 | 日志 | +|---|---|---| +| R01-C 定向（4 个特征类） | **40 / 40**，F=0 E=0 S=0 ✔ | `baseline.log` / `after-characterization.log` | +| 关联回归（`*CandidateScoring*Test,*ScoringDashboard*Test,*Fairness*Test,*JobRecommendation*Test,*Recommendation*Test,*CompetitionRanking*Test,*Appeal*Test,*TalentDiscovery*Test`） | **331 / 331**，F=0 E=0，**Skipped=6** | `related.log` | +| `mvn test` | 见 §16.1 | `full-mvntest.log` | +| `mvn clean verify` | 见 §16.1 | `clean-verify.log` | + +### 16.1 全量结果与 Docker 说明（如实记录） + +``` +mvn test → Tests run: 2725, Failures: 0, Errors: 0, Skipped: 26 BUILD SUCCESS +mvn clean verify → Tests run: 2725, Failures: 0, Errors: 0, Skipped: 26 BUILD SUCCESS +``` + +| 项 | 数值 | +|---|---| +| 测试总数 | **2725** = 本轮基线 **2685** + 本轮新增 **40** ✔（**不低于 2685** 的要求满足） | +| Failures / Errors | **0 / 0** ✔ | +| **Skipped** | **26 —— 未达"0"要求**，原因如下 | + +#### Skipped=26 的准确原因 + +26 个跳过**全部**来自 4 个 MySQL / Testcontainers 类（与 R01-B 复验时同一批）： +`JobSearchSpecificationMySqlIntegrationTest`(15)、`CandidateScoringRefreshMySqlIntegrationTest`(6)、 +`JobSearchQuerySideEffectMySqlIntegrationTest`(4)、`JobSearchQueryExplainMySqlIntegrationTest`(1)。 +它们标注 `@Testcontainers(disabledWithoutDocker = true)`，Docker 不可用时按设计跳过。 + +**环境状态变化（非代码原因）**： + +- 本轮**开始时** `docker info` 成功：`ServerVersion=29.6.2`（满足 §三 的"Docker 可用"前置要求）； +- 执行到关联回归时再次检查，Docker 守护进程已停止： + `failed to connect to the docker API at npipe:////./pipe/dockerDesktopLinuxEngine`； +- `wsl -l -v` 显示 `docker-desktop` 发行版为 **Stopped**； + `C:\Program Files\Docker\Docker\Docker Desktop.exe` **不存在**（该目录下仅有 `cli-plugins`）， + `%LOCALAPPDATA%\Docker` 下只有 log/run/tasks/wsl 等运行期目录，**没有可启动的 Desktop 前端**。 + +**处置**：未强行以非受支持方式拉起 Docker（`wsl -d docker-desktop` 明确不被支持）， +**不声称 Skipped=0**。除这 26 个 Docker 条件用例外的 **2699 个测试全部执行且全部通过**。 +**不构成 R01-C 阻断项**。 + +#### 独立复验补齐（2026-09-18，本段为复验追加，不覆盖上述事实） + +独立复验发现了**正确的 Docker Desktop 安装路径**并据此启动： + +| 项 | 结果 | +|---|---| +| 路径 | `D:\DevApps\DockerDesktop\Docker Desktop.exe`（存在，15,142,832 字节） | +| 启动 | `Start-Process -FilePath '…\Docker Desktop.exe' -WindowStyle Hidden`，轮询上限 180 秒 | +| `docker info` | **约 15 秒后成功** → `ServerVersion=29.6.2` | +| 原先跳过的 26 项 | **26 / 26 实际执行**，`Tests run: 26, Failures: 0, Errors: 0, Skipped: 0` | + +**最终全量（复验阶段）**： + +``` +mvn test → Tests run: 2743, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +mvn clean verify → Tests run: 2743, Failures: 0, Errors: 0, Skipped: 0 BUILD SUCCESS +``` + +`2743 = 2725（本报告阶段总数，含 26 项跳过）+ 18（独立复验新增测试）`； +其 **Skipped=0** 正是因为那 26 项已真实执行。**本阶段未改动任何代码即补足了这 26 项。** + +--- + +## 17. OpenAPI + +``` +python ..\docs\verify_openapi.py +→ paths: 176 / operations: 214 +→ All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空** ✔ + +--- + +## 18. 精确修改文件 + +**生产代码变更总数：新增 1 个生产类、修改 2 个生产类，共 3 个生产文件。** + +**新增生产类（1）** + +``` +mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/rules/CandidateScoringRuleSet.java +``` + +**修改生产类（2）** + +``` +candidatescore/CandidateScoringCalculator.java ← 版本/权重改读规则集；删除 C985/C211；教育数值改读常量 +talentdiscovery/TalentDiscoveryService.java ← preferenceScore 委托 JobPreferenceScoreCalculator +``` + +> **独立复验补充（2026-09-18）**：`git status` 会在 Windows 上把 +> `CandidateOverviewStatusPolicy.java` 与 `JobPreferenceScoreCalculator.java` 标为 ` M` +> （变异实验重写过这两个文件、mtime 变化）。经 `git hash-object` 与 `git rev-parse HEAD:` +> 比对，两者 blob **完全相同**，属 **Windows stat 缓存假阳性**，**不在本提交范围内**。 + +**新增测试（4）**：`common/r01c/` 下 4 个特征测试类 + +**文档（2）**：`docs/r01-c-scoring-recommendation-rules-refactor-report.md`（新增）、 +`docs/backend-development-roadmap.md`（更新） + +> **未新增**：`CandidateOverviewStatusPolicy` 相关改动（已唯一）、`JobRecommendationService` 改动（已是编排）。 + +--- + +## 19. Flyway / ErrorCode / DTO / 接口变化 + +| 项 | 结果 | +|---|---| +| Flyway / 迁移 | **未改动** ✔ | +| `ErrorCode` | **未改动** ✔ | +| DTO / 响应结构 | **未改动** ✔ | +| 公网接口 / OpenAPI | **未改动**（176/214，`openapi-rc.json` 未变） ✔ | +| Token / 权限 / requestId | **未改动** ✔ | +| 依赖 / `pom.xml` | **未改动** ✔ | +| 评分公式数值 / 排序 / 同分规则 / 小样本与互补风险抑制 / 申诉回滚 / 快照版本推进 / Fairness / 消息与 Offer 等 | **均未改动** ✔ | + +--- + +## 20. Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 / HEAD | `refactor/r01-structure-performance` / `9954600…`（未变） | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --check` | exit 0 ✔ | +| 生产代码改动范围 | **恰为 2 个文件**，与 §18 一致（变异内容未残留）✔ | +| 已暂存 / 已提交 / 已推送 | **均无** ✔ | +| 历史未跟踪文件 | 未删除 ✔ | + +--- + +## 21. 未暂存、未提交、未推送 + +**确认。** 未执行 `git add`；未创建提交；未推送；未执行 `reset`/`restore`/`checkout`/`clean`； +未进入 R01-E。 + +--- + +## 22. 未进入 R01-E + +**确认。** 本轮未处理 N+1、会话未读数、`overviewStatus` 之外的其他查询收束、 +数据库迁移或任何 R01-E 范围内的主题。 + +--- + +> **R01-C评分与推荐规则结构收束完成，待独立代码复验。** diff --git a/docs/r01-d1-percentile-performance-report.md b/docs/r01-d1-percentile-performance-report.md new file mode 100644 index 0000000..529e780 --- /dev/null +++ b/docs/r01-d1-percentile-performance-report.md @@ -0,0 +1,25 @@ +# R01-D1 百分位性能收束报告 + +> 状态：R01-D1 已实现并通过自动化与干净构建，待独立复验。 + +## 修改范围 + +- 新增纯函数 `CandidatePercentileCalculator`； +- `CompanyScoringDashboardService` 保留原调用位置，仅将百分位计算委托给纯函数； +- 未修改候选人综合分、排序、分页、过滤、披露门槛或响应结构。 + +## 算法与兼容性 + +旧实现对每个候选分数再次扫描全部分数，复杂度为 O(n²)。新实现先排序，再以每个分数第一次出现的位置作为“严格低于该分数的数量”，复杂度为 O(n log n)。分母仍为 `有效分数数 - 1`，仍使用 10 位中间精度、HALF_UP，并最终保留两位小数。 + +等价测试覆盖空集合、单样本、全 null、输入顺序、null 位置、并列分数，以及由 `{null, 0, 1.0, 1.00, 2.5}` 生成的长度 0–6 全组合，并逐项与旧 O(n²) 公式比较。 + +首次实现使用 `HashMap`，测试立即发现 `1.0` 与 `1.00` 被错误视为不同键；改为按 `BigDecimal.compareTo` 排序的 `TreeMap` 后恢复旧语义。另一个首次失败来自手写并列夹具把最高分期望误写为 66.67；旧公式预言机证明应为 100.00，修正夹具期望，未改变生产公式。 + +## 验证 + +- 定向与看板关联测试：28/28，Failures=0、Errors=0、Skipped=0； +- `mvn clean verify`：2099/2099，Failures=0、Errors=0、Skipped=20，BUILD SUCCESS；20 项为既有环境条件跳过项，R01-D1 定向及关联测试 Skipped=0； +- OpenAPI：176 paths / 214 operations，All checks passed； +- 无 Flyway、ErrorCode、公网接口、表、索引或依赖变化； +- 未暂存、未提交、未推送。 diff --git a/docs/r01-d2-personal-data-query-report.md b/docs/r01-d2-personal-data-query-report.md new file mode 100644 index 0000000..9989a3b --- /dev/null +++ b/docs/r01-d2-personal-data-query-report.md @@ -0,0 +1,29 @@ +# R01-D2 个人数据导出查询收束报告 + +> 状态：R01-D2 已完成批量查询整改、自动化验证与干净构建，待独立复验。 + +## 原问题 + +`PersonalDataCollector` 在遍历父记录时逐条查询子记录：投递状态历史、反馈、面试历史、Offer 历史、会话、消息和评分申诉历史均形成 N+1；投递列表还被重复查询两次。 + +## 整改 + +- 每类父记录先收集 ID，再用 Repository `IN` 查询一次性读取子记录； +- 在内存中按父 ID 分组，并继续按原父记录顺序组装，保留时间线内部升序、消息内部降序和每会话最多 10000 条的既有语义； +- 投递列表只读取一次，同时供投递、时间线和反馈三个 section 使用； +- 会话实体改用 `findAllById`，消息按全部 conversationId 一次批量读取； +- 未改变导出 section 名称、字段、脱敏、简历文件读取或 ZIP 构建语义。 + +## 测试证据 + +- `PersonalDataCollectorQueryBudgetTest`：3 条； +- 投递规模 1 与 50 时，投递主查询、状态历史查询、反馈查询均固定各 1 次； +- 面试历史、Offer 历史、会话实体、消息、申诉历史均固定为每类 1 次批量查询；旧逐条 Repository 方法明确断言为 0 次； +- 父记录顺序与每个父记录下的时间线顺序有独立断言； +- 定向及数据导出关联回归：19/19，Failures=0、Errors=0、Skipped=0； +- `mvn clean verify`：2102/2102，Failures=0、Errors=0、Skipped=20，BUILD SUCCESS；20 项为既有环境条件跳过项，R01-D2 定向与关联测试 Skipped=0； +- OpenAPI：176 paths / 214 operations，All checks passed。 + +## 边界 + +无 Flyway、表、索引、ErrorCode、公网接口或依赖变化；未暂存、未提交、未推送。 diff --git a/docs/r01-d3-conversation-unread-query-report.md b/docs/r01-d3-conversation-unread-query-report.md new file mode 100644 index 0000000..80f5344 --- /dev/null +++ b/docs/r01-d3-conversation-unread-query-report.md @@ -0,0 +1,48 @@ +# R01-D3 会话未读数查询收束报告 + +## 结论 + +`MessagingService.listConversations` 已从逐会话查询最近消息和已读状态，收束为一次分组未读统计。会话数量从 1 增长到 20、50 时，消息相关业务 SQL 数保持固定；本次未改变公网接口、响应字段、权限、消息撤回或已读语义。 + +## 修复前问题 + +会话列表先查询成员关系和会话，再对每个会话调用 `countUnread`。每次调用都会查询最近 500 条消息及其已读记录，因此总查询数随会话数线性增长。 + +## 实现 + +- `MessageRepository.countUnreadByConversationIds` 使用一条分组 SQL 批量统计全部会话。 +- 使用 `ROW_NUMBER() OVER (PARTITION BY conversation_id ORDER BY created_at DESC)` 保留每个会话“最近 500 条”的历史窗口。 +- `RECALLED` 消息不计入未读，`status IS NULL` 仍按历史语义计入。 +- 存在当前用户 `message_reads` 的消息不计入未读。 +- 没有未读行的会话由 Service 映射为 `0`。 +- `getConversation` 的单会话路径未改动，避免扩大本批范围。 + +## 查询预算证据 + +`MessageListQueryBudgetIntegrationTest.listConversationsUsesFixedQueriesForOneTwentyAndFiftyConversations` 使用真实 Spring/JPA/H2 数据源代理统计业务 SQL，并混合 DIRECT、TALENT_INVITATION、SENT、RECALLED、已读和未读消息。 + +| 会话数 | 业务查询数 | 结果 | +| ---: | ---: | --- | +| 1 | 3 | PASS | +| 20 | 3 | PASS | +| 50 | 3 | PASS | + +三条查询分别为成员关系、会话批量读取、未读分组统计，查询数不随会话数增长。 + +## 语义边界 + +`groupedUnreadCountKeepsHistoricalLatestFiveHundredWindow` 构造 501 条顺序明确的消息，证明最旧消息位于窗口外时不被统计。测试首次编写时，实体的 `@CreatedDate` 覆盖夹具传入时间，造成 501 条消息时间并列；随后改为保存后按精确消息主键写入确定时间。该失败属于夹具问题，不是生产缺陷，也未通过放宽断言处理。 + +## 验证 + +- 定向边界测试：3/3，Failures=0、Errors=0、Skipped=0。 +- 关联消息测试：此前同批运行 42/42 通过。 +- `mvn clean verify`：2104 项，Failures=0、Errors=0、Skipped=20，BUILD SUCCESS；20 项均为既有环境条件测试。 +- 静态 OpenAPI：176 paths / 214 operations，校验通过。 + +## 边界 + +- 未新增或修改 Flyway、表、索引、ErrorCode、公网接口。 +- 未改变 DIRECT / TALENT_INVITATION 响应隐私语义。 +- 未改变消息发送、撤回、已读、分页和权限语义。 +- 原生窗口 SQL 仍需在独立真实 MySQL 验收中复核执行计划与结果。 diff --git a/docs/r01-d4-1-scoring-materialization-implementation-report.md b/docs/r01-d4-1-scoring-materialization-implementation-report.md new file mode 100644 index 0000000..224cdd5 --- /dev/null +++ b/docs/r01-d4-1-scoring-materialization-implementation-report.md @@ -0,0 +1,87 @@ +# R01-D4-1「候选人评分快照可靠物化基础设施」实施报告 + +日期：2026-09-16 +分支：`refactor/r01-structure-performance`；HEAD 检查点：`b10c4a7 docs: design scoring snapshot materialization`（后于 `b56f792`） +性质：D4-1 实施（**GET 兜底未删除**，三 GET 仍经 upsertSnapshots 写库） + +## 1. Git 基线 +- 分支正确；设计检查点已提交 `b10c4a7`（3 个设计文件）。 +- 暂存区空；未 commit/push 本轮实现；V1–V43 未修改；V44 为唯一新增迁移。 +- `GlobalExceptionHandler.java` 保持行尾符标记现象（内容 diff 为空）未动。 + +## 2. V44 表结构（`V44__candidate_scoring_refresh_tasks.sql`） +`candidate_scoring_refresh_tasks`: id PK、student_user_id、target_period(7)、status、requested_at、processing_started_at、processed_at、next_attempt_at、attempts、last_error_code(40)、version、created_at、updated_at；`uk_refresh_task_student_period(student_user_id,target_period)`、`ck_refresh_task_status`（PENDING/PROCESSING/RETRY/COMPLETED/FAILED）、`idx_refresh_task_claim(status,next_attempt_at)`、FK→users(id) ON DELETE CASCADE。不保存 Token/手机号/简历/评分源数据。 + +## 3. 任务唯一键与状态机 +唯一键 (student_user_id, target_period)。状态机：PENDING→PROCESSING→COMPLETED；失败→RETRY（attempts+1、next_attempt_at 退避）→达上限 FAILED；COMPLETED/FAILED 再登记→PENDING+attempts=0；RETRY 再登记→PENDING（attempts 保留）。 + +## 4. 登记事务语义（`CandidateScoringRefreshRequestService#requestRefresh`） +原生参数化 upsert 合并；REQUIRED 传播——随调用方业务事务，**源业务提交失败则登记一并回滚**；登记不触发线程内计算、不发 RabbitMQ、不写审计、无敏感值；period 取 capturedNow 单次读取。 + +## 5. Worker 领取与并发（`CandidateScoringRefreshWorker`） +数据库条件更新领取（`status IN (PENDING,RETRY) AND next_attempt_at 到期` 置 PROCESSING，0 行即被并发方领取）；无 JVM 锁/Thread.sleep。领取使用独立短事务；计算、8 维 Writer 与完成状态使用另一个 `REQUIRES_NEW` 原子事务；失败状态再用独立事务持久化。因此单维写失败会回滚该任务全部快照，但不会污染同批其他任务。并发双 Worker 仅一次有效物化。 + +## 6. PROCESSING 期间新请求防丢失 +登记对 PROCESSING 保留状态并推进任务 version；Worker 领取时记录 claimedVersion，完成时仅在 version 未变化时置 COMPLETED；处理期间有新请求导致 version 变化时回到 PENDING。另有 10 分钟（可配置）PROCESSING 租约超时回收：置 RETRY/WORKER_TIMEOUT 并允许其他实例重新领取，达到重试上限转 FAILED，避免进程退出造成永久卡死。 + +## 7. 重试与 FAILED +失败捕获→固定分类（COMPUTE_FAILED/WRITE_FAILED/UNKNOWN_REFRESH_FAILURE；租约超时为 WORKER_TIMEOUT）入 last_error_code（不含异常原文/SQL/手机号/堆栈）→独立事务 attempts+1→RETRY+next_attempt_at；达上限 FAILED；失败不回抛、不回滚同批其他任务；补偿扫描可重新登记。 + +## 8. Writer 比较字段（`CandidateScoringSnapshotWriter`） +score、status、sub_scores_json、weight、rules_version 全部相同→version/updated_at 不变；任一变化→version+1；calculated_at 不触发；JSON 写入前 canonical（字段字典序）防伪变化；null-safe 相等用 `(= ? OR (IS NULL AND ? IS NULL))`（MySQL/H2 双兼容）。 + +## 9. version 精确语义 +普通物化：值变才 +1（D4-1 已授权语义收敛——重复相同 GET/重放不再制造版本噪声）；rulesVersion 变化强制 +1。 + +## 10. Governance 强制路径 +`recomputeAndSnapshot`（申诉决定/回滚）委托 `upsertForcingVersion` 无条件 +1，保持 `afterVersion=beforeVersion+1`、snapshot_history 与 scoreAtAppeal/snapshotVersionAtAppeal/回滚限额语义不变；普通物化不写 snapshot_history。 + +## 11. 实际接入的真实输入源（写侧 Service，同事务登记） +ProfileService#updateProfile；ResumeVersionService#createVersion/updateVersion/deleteVersion；PreferenceService#savePreferences；AbilityAttemptService#submit；ApplicationService#apply/withdraw/updateStatus；OfferService#transitionStatus；CandidateFeedbackService#createFeedback；MessagingService#sendMessage（仅 STUDENT 发送者登记）。补偿扫描兜底 audit/时间窗口。 + +## 12. 明确未接入 +RIASEC（AssessmentAttemptService）；InterviewScoreService；JobReviewService；AbilityAttemptService#saveAnswers；ResumeVersionService#setDefault（公式未读默认标记）；消息撤回；只读查询；AuditService 实时登记（防 刷新→审计→刷新 循环，审计变化由补偿扫描覆盖）。 + +## 13. 时间窗口与补偿扫描（`CandidateScoringRefreshCompensationScanner`） +基础版：按 user id 做 keyset 分页（页大小默认 100）遍历近 90 天投递/近 30 天审计活跃学生并登记刷新任务；一次扫描会跨越全部页面，不再反复只处理首批 ID；不直接写快照。rulesVersion 切换由事件/重扫覆盖。**补偿扫描仍是 D4-1 简化版，尚无持久化扫描游标与单轮总预算，完整窗口和大数据量调度规则留待 D4-2 前完善；GET 兜底因此必须保留**。 + +## 14. 修复前失败测试（TDD 证据） +实现前基线即检查点后现状（b10c4a7 上证据测试 5/5 全绿，其中"重复 GET version+1"断言证明旧行为）；实施中 Writer 两次 H2 语法不兼容（`<=>`、VALUES() 表达式）→ Errors=7→4→0 收敛；@InjectMocks 缺新依赖 → Errors=55→30→0；Persistence 旧断言与新契约冲突 → 1 Failure 被改写为幂等断言。最终全绿。 + +## 15. H2 与真实 MySQL 结果 +H2 定向集成已覆盖：登记合并、并发领取、处理中重登记、租约超时恢复、跨三页以上补偿扫描、单任务中途写失败全回滚、失败状态独立提交、同批任务事务隔离及外层业务回滚。2026-09-16 Docker 恢复后新增 `CandidateScoringRefreshMySqlIntegrationTest`，使用独立 `mysql:8.4` Testcontainers、正式 V1–V44 Flyway 与 `ddl-auto=validate`，5/5 通过：V44/schema、Writer 幂等与强制版本、双线程领取唯一胜者、部分写失败全回滚且同批成功任务不受影响、PROCESSING 重登记及超时恢复。未复用或修改开发库。 + +## 16. 查询预算 +登记：1 条 upsert；Worker：到期 ID 查询 + 每任务独立 claim/load + computeAll + 8 维锁定比较/条件写入 + complete；失败另有 1 次独立状态写。补偿扫描每页 1 条 keyset 查询并为命中学生逐条登记；总查询数随符合条件学生数增长，尚未满足最终查询预算，不能据此进入 D4-2。 + +## 17. RabbitMQ 与数据库副作用 +Worker/登记不发布 RabbitMQ、不写 notification、不写 snapshot_history、不写 audit；测试 20/22 验证。快照仅 candidate_dimension_scores 与任务表。 + +## 18. 全量测试 +Docker 恢复后的最终实测 `mvn clean verify`：**2130/2130，Failures=0、Errors=0、Skipped=0，BUILD SUCCESS**。其中既有 Q01 MySQL 20 项与新增 D4-1 MySQL 5 项均真实执行。OpenAPI **176 paths / 214 operations**，校验通过。 + +## 19. OpenAPI +176 paths / 214 operations，Actuator 不进业务契约；无新增公网刷新接口。 + +## 20. 精确修改文件 +新增：V44 迁移；`candidatescore/refresh/`：CandidateScoringRefreshTask、CandidateScoringRefreshRequestService、CandidateScoringSnapshotWriter、CandidateScoringRefreshWorker、CandidateScoringRefreshTaskExecutor、CandidateScoringRefreshCompensationScanner、CandidateScoringRefreshScheduler；测试 `CandidateScoringRefreshInfrastructureTest`、`CandidateScoringRefreshFailureTransactionTest`。 +修改：CandidateScoringCalculator（upsert 委托 Writer + recompute 强制路径）；写侧 8 Service（登记接入）；application.yml（app.scoring.refresh.* 默认关闭）；测试适配：R01D4GetWritesSnapshotEvidenceTest/CandidateScoringPersistenceIntegrationTest（version 幂等契约演进）、CandidateScoringCalculatorTest/ClockConsistencyTest/FairnessMonitoringPersistenceIntegrationTest（构造/委托验证）、6 个 Service 测试补 Mock 依赖（未放宽断言）。 + +## 21. Git 状态 +未 commit/push；暂存区空；V44 唯一新增迁移；历史未跟踪文件未删未移；GlobalExceptionHandler 行尾现象保持。 + +## 22. 进入 D4-2 的网关（当前：**未达到**） +- [x] 唯一 Writer + 幂等 version 语义（H2 验证） +- [x] 任务登记/防丢失/并发领取/重试/failure 分类（H2 验证） +- [x] 写侧 8 类事件登记 + 不接入项确认 +- [x] 真实 MySQL 8.4 核心基础设施验收（V44/validate、Writer、并发领取、事务隔离、重登记与超时恢复） +- [ ] D4-2 前消费者黑盒（GET 零写切换、趋势/申诉/排名/看板/监控、副作用与 RabbitMQ） +- [ ] 补偿扫描完整窗口规则 + 查询预算真实库验证 +- [ ] 写侧覆盖证明（滚动运行期对账） +→ 未满足 → **不得移除 GET 写入** + +## 23. 剩余风险 +补偿扫描仍缺持久化游标与单轮总预算；POST/PUT 申诉决定/回滚在真实库对 version 语义的回归未验（H2 已验）；普通 Writer 的 MySQL 幂等、差异更新、强制版本、`SELECT FOR UPDATE` 与 no-op upsert 已有专用真实库证据。 + +## 最终状态 +> **R01-D4-1 核心基础设施及真实 MySQL 8.4 验证已完成；GET 兜底仍保留。** 进入 D4-2 前仍需把补偿扫描收束为可持续的持久游标/单轮预算，并在 D4-2 同批完成消费者、副作用及 RabbitMQ 黑盒，不得直接删除 GET upsert。 diff --git a/docs/r01-d4-2-blocker-remediation-20260916.md b/docs/r01-d4-2-blocker-remediation-20260916.md new file mode 100644 index 0000000..cf00f4b --- /dev/null +++ b/docs/r01-d4-2-blocker-remediation-20260916.md @@ -0,0 +1,277 @@ +# R01-D4-2 阻断缺陷定向整改报告（F1–F4 及两项次生缺陷） + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b10c4a732740e42353ca826f63141c3dd2a49915`（整改全程未变） +来源：`docs/r01-d4-2-independent-mysql-acceptance-20260916.md` 判定的 4 项 FAIL + 2 项次生缺陷 +整改性质：**仅修复已确认缺陷**，未进入其他 R01 工作 + +--- + +## 1. 结论 + +> **R01-D4-2 阻断缺陷定向整改完成，待最终独立增量复验；GET 评分快照写入迁移尚未冻结。** + +| 缺陷 | 状态 | 修复前失败证据 | 修复后 | +|---|---|---|---| +| F1 Offer 自动过期不登记 | 已修复 | 4 个断言失败 | 全通过 + 真实 MySQL 复验 | +| F2 反馈 update/delete 不登记 | 已修复 | 4 个断言失败 | 全通过 + 真实 MySQL 复验 | +| F3 简历版本与任务提交边界不对称 | 已修复 | 1 个边界断言失败 | 全通过 + 真实 MySQL 复验 | +| F4 ABILITY 敏感字段断言缺失 | 已恢复（并增强） | 原断言已删（本次新增更强版本） | 全通过 | +| 次生：claim fence 缺失 | 已修复 | — | 全通过（含双 Worker 并发） | +| 次生：单任务失败阻断批次 | 已修复 | — | 全通过（含循环隔离单测） | + +--- + +## 2. 修复前失败测试结果（TDD 证据） + +命令： +``` +mvn -Dtest="OfferExpiryRefreshRegistrationTest,CandidateFeedbackRefreshRegistrationTest,ResumeVersionRefreshAtomicityTest,CandidateScoringRefreshClaimFenceTest,CandidateScoringRefreshBatchIsolationTest,CandidateScoringRefreshInfrastructureTest" test +``` +日志：`docs/acceptance/r01-d4-2-20260916/fix-before.log` + +| 测试方法 | 失败信息（节选） | +|---|---| +| `CandidateFeedbackRefreshRegistrationTest.updateFeedback_registersRefreshTask:125` | `expected: <1> but was: <0>` —— updateFeedback 未登记 | +| `CandidateFeedbackRefreshRegistrationTest.deleteFeedback_registersRefreshTask_afterRowRemoved:137` | `expected: <1> but was: <0>` —— deleteFeedback 未登记 | +| `CandidateFeedbackRefreshRegistrationTest.updateFeedback_ratingUnchanged_...:149` | `expected: <1> but was: <0>` | +| `CandidateFeedbackRefreshRegistrationTest.feedbackLifecycle_...:182` | `update 登记 ==> expected: <1> but was: <0>` | +| `ResumeVersionRefreshAtomicityTest.createVersion_outerTransactionRollsBack_...:102` | 外层事务回滚后版本行存在（1）而刷新任务为 0 —— 提交边界不对称 | +| `OfferExpiryRefreshRegistrationTest`（4 个） | 首轮先因夹具 FK 报错，修正夹具后 `expireOne` 未登记 → 断言失败 | + +> 说明：F1/claim-fence 的首轮运行还包含**测试自身夹具缺陷**（H2 不支持 `DATE_FORMAT`、FK 删除顺序、简历文件缺 PDF 签名、offer 夹具缺列）。这些已先行修正，产品缺陷证据以上表为准。 + +--- + +## 3. 各写侧的事务边界 + +| 写侧入口 | 登记位置 | 事务边界 | 原子性依据 | +|---|---|---|---| +| `OfferExpiryWorker#expireOne` | `OfferExpiryWorker.java`（`saveAndFlush` 之后、`notifyExpired` 之前） | 方法自身的 `REQUIRES_NEW` | 状态变更、还价过期标记、刷新登记、历史行同属一个事务；任一步失败全部回滚 | +| `CandidateFeedbackService#createFeedback` | 既有（`:82` 之后） | 方法 `@Transactional` | 与 feedback 插入同事务 | +| `CandidateFeedbackService#updateFeedback` | 新增（`save` 之后） | 方法 `@Transactional` | 与 rating 更新同事务 | +| `CandidateFeedbackService#deleteFeedback` | 新增（`delete` 之后；先固定 `studentUserId`） | 方法 `@Transactional` | 与删除同事务 | +| `ResumeVersionWriter#saveNewVersion` | 新增（`save` 之后） | 组件自身的 `REQUIRES_NEW` | **与版本行同一提交边界**（F3 核心） | +| `ResumeVersionService#createVersion` | 已移除（原 `:71`） | 外层 `@Transactional` | 不再重复登记，避免外层事务耦合 | +| `ResumeVersionService#updateVersion / #deleteVersion` | 既有 | 方法 `@Transactional` | 与版本更新/删除同事务 | + +**F3 设计选择**：保留 `ResumeVersionWriter` 的 `REQUIRES_NEW`（既有并发冲突重试防护，移除会破坏"单次冲突只回滚自身、外层可安全重试"的设计），按任务书推荐把 `requestRefresh` 放入该写事务组件，`CandidateScoringRefreshRequestService` 以 `REQUIRED` 加入。外层不再重复登记。 + +--- + +## 4. 简历版本与任务的原子性证据 + +测试：`ResumeVersionRefreshAtomicityTest#createVersion_outerTransactionRollsBack_versionRowAndTaskCommitTogether` + +场景：用 `TransactionTemplate` 包裹 `createVersion`，返回后抛异常使外层回滚。 + +断言： +- `resume_versions` 行数 = 1（既有设计：`REQUIRES_NEW` 独立提交，外层回滚不使其消失） +- `candidate_scoring_refresh_tasks` 行数 = 1 —— **版本行存在则刷新任务必须同样存在** + +修复前：`expected: <1> but was: <0>`（任务丢失）。 +修复后：通过。 + +真实 MySQL 复验：`F3 createVersion 成功 st=200` → `版本行与任务同时存在（无一半提交）versions=3 tasks=1`（三次调用收敛为一条任务）。 + +**文件系统操作未被纳入数据库原子性承诺**：测试 mock 了 `ResumeStorageService`；生产代码中"存量文件清理"仍由 `createVersion` 既有的 `catch(RuntimeException)` 负责，与数据库事务边界解耦，未做改动。 + +--- + +## 5. claim fence 的字段与 SQL 条件 + +**所有权标识**：`processing_started_at`（每次 claim 写入的领取时刻）。 + +不采用"仅校验 `version`"：同一 claim 期间到达的新请求会合法推进 `version`，此时仍需回到 `PENDING`，所以 `version` 不能单独充当所有权闸门。 + +| 操作 | SQL 条件 | +|---|---| +| `claim` | `WHERE id=? AND status IN ('PENDING','RETRY') AND (next_attempt_at IS NULL OR next_attempt_at <= ?)`；随后 `SELECT ... processing_started_at` 记入 `ClaimedTask.claimedAt` | +| `materialize` → COMPLETED | `WHERE id=? AND status='PROCESSING' AND processing_started_at=? AND version=?` | +| `materialize` → PENDING 回退 | `WHERE id=? AND status='PROCESSING' AND processing_started_at=?`（不带 version：新请求推进 version 正是回退的触发条件） | +| `recordFailure` | `WHERE id=? AND status='PROCESSING' AND processing_started_at=?` | + +API 变更：`ClaimedTask` 新增 `LocalDateTime claimedAt` 字段；`recordFailure(...)` 新增 `claimedAt` 形参。 + +--- + +## 6. stale worker 的处置结果 + +三种情形与处置： + +| 情形 | 条件命中 | 处置 | +|---|---|---| +| 同一 claim，无新请求 | COMPLETED 更新 1 行 | 置 `COMPLETED` | +| 同一 claim，期间有新请求 | COMPLETED 0 行 → PENDING 更新 1 行 | **回到 `PENDING`**，下一轮重算 | +| 已被其他 Worker 重新领取 | COMPLETED 0 行 → PENDING 0 行 | **安静返回**，不覆盖新持有者（不抛异常） | +| 失败登记遇 stale claim | `recordFailure` 更新 0 行 | **安静返回**，不抛异常（原先抛 `IllegalStateException`） | + +`processOne` 的失败登记另加一层保护：`recordFailure` 自身异常仅告警，不向外抛。 + +测试证据（`CandidateScoringRefreshClaimFenceTest`）： +- `staleWorkerCompletion_cannotOverwriteNewWorkerClaim` —— 旧 claim 完成路径 `assertDoesNotThrow`，且任务保持新持有者的 `PROCESSING` 与 `processing_started_at` +- `staleWorkerFailure_cannotOverwriteNewWorkerClaim` —— 旧 claim 失败登记同样安静退出 +- `requestDuringSameClaim_completionFallsBackToPending` —— 同 claim 期间新请求 → 回到 `PENDING` +- `claim_exposesProcessingStartedAtAsOwnershipFence` —— `claimedAt` 已暴露 + +不使用 `sleep`，不使用 JVM 锁。 + +--- + +## 7. 单任务失败是否影响同批后续任务 + +**修复前**：`recordFailure` 在 `updated != 1` 时抛 `IllegalStateException`，异常点位于 Worker 的 catch 块内，而 `processDue` 的 `for` 循环无保护 → 同批剩余任务本轮全部不处理。 + +**修复后**： +- `recordFailure` 的 stale claim 改为安静返回（不再抛） +- `processOne` 捕获失败登记自身异常 +- `processDue` 的循环体增加 `try/catch`（兜底，日志只记录 taskId 与异常类名） + +测试证据： +- `CandidateScoringRefreshWorkerLoopIsolationTest`（纯单元，精确构造"第一项失败且失败登记也抛异常"）： + - `recordFailureThrowing_doesNotAbortRemainingTasksInBatch` —— 后续第 2、3 项仍被 `materialize` + - `recordFailureThrowingInMiddle_doesNotAbortRemainingTasks` —— 中间项失败不阻断前后 + - `claimLosing_skipsTaskWithoutRecordingFailure` —— claim 失败（被并发抢走）不记失败、继续下一项 +- `CandidateScoringRefreshBatchIsolationTest`（真实 H2 + mock 计算器）： + - `firstTaskFails_secondTaskStillProcessed`、`failingTaskInMiddle_doesNotBlockRemainingTasks` + - `lastErrorCode_neverLeaksExceptionMessage` —— 分类为固定值 `COMPUTE_FAILED`，不含手机号/Token/异常原文 + - `batchTerminalState_matchesRealOutcome` —— 批次结束无残留 `PROCESSING` + +--- + +## 8. 恢复后的 ABILITY 敏感字段断言清单 + +位置：`CandidateScoringRefreshInfrastructureTest#abilitySnapshotPayload_hasNoSensitiveFields_andKeepsWhitelistedKeys` +方式：**经真实 `CandidateScoringSnapshotWriter` 写入 → 从真实数据库读回 `sub_scores_json` → 递归断言**（不是检查 DTO 定义，也不复用旧测试文本）。 + +**正向断言（允许字段必须存在且取值正确）**： +`source`（= `V36_ABILITY_ASSESSMENT`）、`sourceResultId`（= 123）、`validUntil`、`questionSetVersion`、`assessmentRulesVersion`、`mappingRulesVersion`、`weights`、`dimensionScores` + +**负向断言（递归、大小写不敏感、覆盖嵌套对象与数组）** —— 以下 key 一律禁止： +``` +answer, answers, rawanswer, rawanswers, +question, questions, questionid, questioncode, questionstem, +option, options, optionid, selectedoption, selectedoptionid, +answerkey, competencytag, stem, +scoringrule, awardedscore, explanation, +phone, email, mobile, token, password, accesstoken +``` +（在任务书要求的 10 项之上，保留了原验收报告中的 `answerKey/questionCode/competencyTag/stem/scoringRule/awardedScore/explanation/phone/email`，并补充 `mobile/token/password/accessToken`） + +**大小写策略**：key 小写化后**精确匹配**（避免白名单字段 `questionSetVersion` 因含子串 `question` 而误报）；另有一层原始 JSON 文本层断言，禁止出现 `""` 形式的 key 字面量。 + +--- + +## 9. 自动化测试数量 + +| 命令 | 结果 | +|---|---| +| 定向（12 个类，含 6 个新增） | **104 / 104**，F=0 E=0 S=0 | +| 关联回归（`*CandidateScoring*Test,*Scoring*Test,*Offer*Test,*Feedback*Test,*ResumeVersion*Test,*Application*Test,*Appeal*Test,*Ranking*Test,*Fairness*Test`） | **558 / 558**，F=0 E=0 S=0，BUILD SUCCESS | +| `mvn clean verify` | **2163 / 2163**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS（3:47） | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | + +较整改前（2131）新增 **32** 个测试（6 个新测试类：Offer 过期登记 7、反馈登记 8、简历原子性 4、claim fence 6、批次隔离 4、循环隔离 3）。 + +> 过程中出现并已修复的**测试自身缺陷**（非产品）：新测试类未清理 H2 共享内存库残留，导致 `InterviewScoreControllerTest` / `MessageRecallPersistenceIntegrationTest` / `MessagingBlockIntegrationTest` 的 tearDown 遇 FK 冲突（23 errors）。已为全部新测试类补 `@AfterEach` 精确清理，复跑全绿。 + +--- + +## 10. 真实 MySQL / Docker 结果 + +实例：最新 JAR（`mvn clean verify` 产出，82,441,449 bytes），`SCORING_REFRESH_ENABLED=true`、`OFFER_EXPIRY_INTERVAL_MS=3000`、compensation-interval 5s、limit 2。PID 2856，验收后已停止。 + +`docs/acceptance/r01-d4-2-20260916/v2-out.txt`：**PASS=18 / FAIL=0 / SKIP=0** + +| 项 | 真实 MySQL 结果 | +|---|---| +| F1 Offer 自动过期 | 夹具 offer（精确 INSERT，id=15）被定时任务置为 `EXPIRED` → **生成刷新任务 1 条** → `COMPLETED`（0.1s） | +| F2 create | `POST /applications/88/feedback` 200 → 任务 `COMPLETED`（0.7s） | +| F2 update | `PUT /applications/88/feedback`（rating 5→2）200 → 任务 `COMPLETED`（1.3s），无失败分类、attempts=0 | +| F2 delete | `DELETE /applications/88/feedback` 200 → 任务 `COMPLETED`（1.3s） | +| F3 简历版本 | `POST /profile/me/resume-versions` 200 → 版本行与任务**同时存在**，三次调用收敛为 1 条任务 | +| 三个 GET 零写 | 审计/通知/消息/申诉/用户/业务表**逐字段零变化**（豁免表仅限后台 Worker 与补偿扫描合法改动的 3 张） | +| 趋势/排名/看板 | 4 个端点全部 200 | +| 快照完整性 | 学生 A 当前周期 **8 维**快照齐备 | +| RabbitMQ 终态 | 4 个队列（`queue.sms.verification` / `queue.notification` / `queue.notification.dlq` / `queue.audit`）**ready=0、unacked=0** | +| 日志与审计 | 未出现手机号、Token、评分原始输入或 SQL 绑定参数；错误分类仅固定枚举值 | + +--- + +## 11. OpenAPI 数量 + +静态 `docs/openapi-rc.json` 与 `docs/verify_openapi.py`：**176 paths / 214 operations**，`All checks passed!` —— 与本轮整改前一致，**未新增公网刷新、任务、补偿或管理接口**。 + +--- + +## 12. 精确修改文件 + +**生产代码（6 个，全部在任务书允许清单内）** + +| 文件 | 改动 | +|---|---| +| `offer/OfferExpiryWorker.java` | 注入 `CandidateScoringRefreshRequestService`；`expireOne` 在状态提交后同事务登记 | +| `feedback/CandidateFeedbackService.java` | `updateFeedback` / `deleteFeedback` 同事务登记（删除前固定 `studentUserId`） | +| `resume/ResumeVersionWriter.java` | 注入登记服务；`saveNewVersion` 在与版本行同一 `REQUIRES_NEW` 事务内登记 | +| `resume/ResumeVersionService.java` | 移除 `createVersion` 中的重复登记（登记已移入 Writer） | +| `candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java` | `ClaimedTask` 增 `claimedAt`；`claim` 读回 `processing_started_at`；`materialize` 的 COMPLETED/PENDING 两分支与 `recordFailure` 全部加所有权闸门；stale claim 改为安静返回 | +| `candidatescore/refresh/CandidateScoringRefreshWorker.java` | `processOne` 失败登记加保护；`processDue` 循环体加 `try/catch` | + +**测试（新增 6 个类；修改 2 个既有类仅补依赖/调用签名）** + +新增：`OfferExpiryRefreshRegistrationTest`、`CandidateFeedbackRefreshRegistrationTest`、`ResumeVersionRefreshAtomicityTest`、`CandidateScoringRefreshClaimFenceTest`、`CandidateScoringRefreshBatchIsolationTest`、`CandidateScoringRefreshWorkerLoopIsolationTest` +修改：`CandidateScoringRefreshInfrastructureTest`（新增 F4 测试 + 增补 `Map` import + `recordFailure` 新签名）、`OfferExpiryWorkerTest`（补 `@Mock` 依赖） + +**未超出允许范围**：无需修改清单外的生产文件（清单中的 `CandidateScoringRefreshTaskRepository.java` 在项目内**不存在** —— D4-1 采用 JdbcTemplate 而非 JPA Repository，属清单笔误，无需报告偏离）。 + +--- + +## 13. 是否修改迁移 / ErrorCode / 接口 + +| 项 | 结论 | +|---|---| +| V1–V44 迁移 | **未修改**（`git diff --name-only -- db/migration` 为空）；V44 仍为唯一新增迁移 | +| 新增迁移 | **无** | +| 表 / 索引 | **未新增** | +| `ErrorCode` 枚举 | **未修改**（0 个文件） | +| 公网接口 | **未新增**（OpenAPI 保持 176/214） | +| 评分公式 / 权重 / 排名规则 / 消费者行为 | **未修改** | +| RabbitMQ 消息 / 通知 | 未引入 | + +--- + +## 14. Git 状态 + +``` +分支：refactor/r01-structure-performance +HEAD：b10c4a732740e42353ca826f63141c3dd2a49915（未变） +暂存区：空 +git add -A / commit / push：均未执行 +删除文件：无 +git diff --check：无空白错误 +``` + +验收数据已按精确主键清理（`users` 残留 0；`offers`/`resume_versions`/`applications`/`jobs`/`companies`/`dimension_scores`/`refresh_tasks` 全部归零）。`audit_logs` 中 actor 为本轮 4 个隔离用户的 **14 行**属 append-only 合规记录，保留并登记（关联 ID：`user_id ∈ {8006, 8007, 8008, 8009}`）。 + +唯一测试夹具（精确 INSERT，已登记并已清理）：`user_roles` 为 8008/8009 各插入 1 行 `COMPANY`（项目无公网接口可授予该角色）；`offers` 插入 1 条已过期 SENT 记录用于触发 F1 定时路径（id=15）。 + +--- + +## 15. 明确声明 + +- **未暂存、未提交、未推送。** +- 未进入其他 R01 工作。 +- 未修改评分公式、权重、状态、规则版本、排名、申诉或公平性语义。 +- 已按要求「先写失败测试 → 保存修复前失败结果 → 再改生产代码」，失败证据见 `fix-before.log`。 + +--- + +## 16. 待最终独立增量复验项 + +1. F1–F4 的修复在**独立复验**中重新验证（本轮为整改方自测）。 +2. `claim fence` 的双 Worker 真实并发复验（本轮已有真实 MySQL 层的 stale claim 单线程构造 + 纯单测并发场景；**真实双 JAR 竞争仍未做**）。 +3. PROCESSING 防丢失的真实 HTTP 窗口复验（沿用 D4-2 验收的方式引用真实 MySQL 并发集成测试）。 +4. 申诉审核/回滚的真实黑盒（本轮未改动申诉路径，仍属 D4-2 遗留 SKIP）。 + +> R01-D4-2 阻断缺陷定向整改完成，待最终独立增量复验；GET 评分快照写入迁移尚未冻结。 diff --git a/docs/r01-d4-2-claim-fence-remediation-20260916.md b/docs/r01-d4-2-claim-fence-remediation-20260916.md new file mode 100644 index 0000000..85ded77 --- /dev/null +++ b/docs/r01-d4-2-claim-fence-remediation-20260916.md @@ -0,0 +1,234 @@ +# R01-D4-2 claim fence 定向整改报告（不可复用 claim token） + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b10c4a732740e42353ca826f63141c3dd2a49915`（整改全程未变） +来源：`docs/r01-d4-2-final-independent-incremental-verification-20260916.md` 的 FAIL 项（R-1） +整改范围：**仅修复 fence 唯一性**，未进入其他 R01 项目 + +--- + +## 1. 结论 + +> **R01-D4-2 claim fence 定向整改完成，待最终独立增量复验；GET 评分快照写入迁移尚未冻结。** + +采用任务书指定的**不可复用 claim token** 方案。`processing_started_at` 秒级精度导致的 fence 可重复问题已消除 —— 所有权判定不再依赖任何时间值、时间精度或配置下界。 + +--- + +## 2. 修复前失败测试（TDD 证据） + +新增 `CandidateScoringRefreshClaimTokenTest`（13 个测试），在**只加入 V45 列、未改 Java**时运行： + +命令：`mvn -Dtest="CandidateScoringRefreshClaimTokenTest" test` +日志：`docs/acceptance/r01-d4-2-20260916/fence-before.log` + +**结果：Tests run: 10, Failures: 6** + +任务书要求复现的三条，全部复现成功： + +| 要求 | 测试方法 | 失败信息 | +|---|---|---| +| ① 两次领取拥有完全相同的 `processing_started_at` | `sameTimestamp_staleWorkerPendingRevert_mustNotTouchNewClaim` | 断言 `assertEquals(SAME_INSTANT, processingStartedAt(taskId))` **通过**，证明两次领取时间值相同 | +| ② Worker B 已重新领取 | 同上 | 断言 `assertEquals("PROCESSING", status(taskId))` **通过** | +| ③ **Worker A 的 PENDING 回退可以错误修改 B 的任务** | 同上 | **`expected: but was: `** ← 核心缺陷复现 | + +同时复现了失败登记的同类覆盖： +`sameTimestamp_staleWorkerFailure_mustNotTouchNewClaim` → **`expected: but was: `** + +其余 4 条失败为 `claim_token` 尚未写入（值为 `null`）。 + +**关键点**：测试使用常量 `SAME_INSTANT = LocalDateTime.of(2026, 9, 16, 12, 0, 0)`，两次领取传入**完全相同**的时间值，**未使用任何 sleep 或跨秒等待**。 + +--- + +## 3. 实现 + +### 3.1 迁移 V45 + +`mydreamjob-server/src/main/resources/db/migration/V45__add_scoring_refresh_claim_token.sql` + +```sql +ALTER TABLE candidate_scoring_refresh_tasks + ADD COLUMN claim_token VARCHAR(36) NULL + COMMENT '本次领取的不可复用令牌（UUID），终态/待处理时清空；仅用于并发所有权判定'; +``` + +- **仅新增列**，未增加索引 —— 查询依据：`claim_token` 只出现在既有的**按主键 `id` 定位**的 UPDATE 中（`WHERE id=? AND ...`），不参与扫描或排序，因此无需新索引。 +- 未修改 V1–V44，未修改业务表数据，未新增公网接口或 ErrorCode。 + +### 3.2 `CandidateScoringRefreshTaskExecutor` + +| 操作 | 关键改动 | +|---|---| +| `claim` | 生成 `java.util.UUID.randomUUID().toString()`，在领取 SQL 中**原子写入** `claim_token`；读回并放入 `ClaimedTask` | +| `materialize` → COMPLETED | `WHERE id=? AND status='PROCESSING' AND claim_token=? AND version=?`；`SET claim_token=NULL` | +| `materialize` → PENDING 回退 | `WHERE id=? AND status='PROCESSING' AND claim_token=?`；`SET claim_token=NULL`；0 行 → 安静返回 | +| `recordFailure` | 参数由 `LocalDateTime claimedAt` 改为 `String claimToken`；`WHERE id=? AND status='PROCESSING' AND claim_token=?`；`SET claim_token=NULL`；0 行 → 安静返回 | +| `recoverStale` | `SET claim_token=NULL`（回收即释放所有权） | +| `ClaimedTask` | 新增 `String claimToken`；保留 `claimedAt` 但**仅用于超时扫描与观测**，不再参与任何 WHERE 条件 | + +`processing_started_at` 的用途收敛为：超时扫描（`WHERE status='PROCESSING' AND processing_started_at < ?`）与观测。所有权证明完全由 `claim_token` 承担。 + +### 3.3 语义保持 + +- 同一 claim 期间出现新请求 → `version` 前进 → COMPLETED 更新 0 行 → **PENDING 回退**（`claim_token` 未变，闸门放行）✔ +- 新 Worker 已重新领取 → `claim_token` 已变 → 完成、失败、回退**全部更新 0 行并安静退出** ✔ +- 进入 PENDING / COMPLETED / RETRY / FAILED 均清空 `claim_token` ✔ +- 不依赖 `Thread.sleep`、时间精度或配置下界 ✔ + +--- + +## 4. 测试覆盖（任务书清单逐项） + +`CandidateScoringRefreshClaimTokenTest`（13 个测试，全部通过）： + +| 任务书要求 | 测试方法 | +|---|---| +| 同一时间戳下两次领取的 claim token 不同 | `twoClaimsAtSameInstant_getDifferentTokens` | +| 旧 Worker 不能完成新 claim | `sameTimestamp_staleWorkerPendingRevert_mustNotTouchNewClaim`（含完成尝试） | +| 旧 Worker 不能将新 claim 回退 PENDING | 同上（核心断言） | +| 旧 Worker 不能记录新 claim 失败 | `sameTimestamp_staleWorkerFailure_mustNotTouchNewClaim` | +| 当前 Worker 可以正常完成 | `currentHolder_canCompleteNormally` | +| 同一 claim 期间 version 前进会正确回到 PENDING | `requestDuringSameClaim_versionAdvances_completionFallsBackToPending` | +| stale recovery 后生成新 token | `staleRecovery_generatesNewTokenOnNextClaim` | +| terminal/PENDING 状态 token 被清空 | `terminalAndPendingStates_clearClaimToken`、`failedTerminalState_clearsClaimToken` | +| 双 Worker 循环至少 100 次无覆盖、无永久 PROCESSING | `doubleWorkerLoop_100Rounds_noOverwrite_noStuckProcessing_noLostRequest` | +| token 不进入日志、审计、响应或错误信息 | `claimToken_doesNotLeakIntoAuditOrNotificationTables`、`claimToken_rowNeverExposedInTaskStatusQueriesUsedByObservability` | + +补充：`claim_repeatedOnDifferentTasks_producesDistinctTokens`、`tokenIsUuidShaped_andNotDerivedFromIds`（UUID 形态、不可复用、不由 ID 派生）。 + +**全部使用固定时间值**，无 sleep、无跨秒等待。 + +--- + +## 5. 回归 + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="*CandidateScoringRefresh*Test" test` 等 7 个 fence 相关类 | **49 / 49**，F=0 E=0 S=0 | +| 关联回归（9 组通配符） | **571 / 571**，F=0 E=0 S=0 | +| `mvn clean verify` | **2176 / 2176**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | + +较整改前（2163）新增 **13** 个测试，全部为 claim token 相关。 + +**过程中修正的测试侧问题（非产品缺陷）**： + +1. `CandidateScoringRefreshMySqlIntegrationTest#v44MigrationAndSchemaValidationAreApplied` 原断言任务表 13 列 —— V45 后为 14 列，同步更新并**新增** V45 成功性、唯一性、`claim_token` 存在性断言（属本次授权迁移的计划内演进，非放宽）。 +2. `OfferExpiryRefreshRegistrationTest#expireOne_refreshTaskCarriesNoSensitiveFields` 原禁止列名含 `TOKEN` —— `claim_token` 是随机 UUID 而非用户凭据，禁止列表改为 `ACCESS_TOKEN/REFRESH_TOKEN/PASSWORD/SECRET` 等真实凭据列，并**新增**断言要求 `claim_token` 必须存在。 +3. 本人新增测试中的两处断言缺陷（UUID 随机字符集几乎必然含任务 ID 数字；`newTask()` 复用同学生导致任务合并），已改为有意义的断言。 + +--- + +## 6. 真实 MySQL 最小增量复验 + +使用本轮 `clean verify` 产出的最新 JAR。物化实例 PID 11104（`SCORING_REFRESH_ENABLED=true`），只读实例 PID 18372（`false`），均已停止，8080/8081 空闲。 + +### 6.1 V45 迁移与 schema validation + +``` +version | description | success +44 | candidate scoring refresh tasks | 1 +45 | add scoring refresh claim token | 1 +v45_rows = 1 failed_migrations = 0 +claim_token | varchar(36) | YES +task_cols = 14 +``` +Hibernate `ddl-auto=validate` 通过，日志中 `schema-validation`/`SchemaManagementException` 命中 **0** ✔ + +### 6.2 claim fence 100 轮竞争（固定相同 processing_started_at） + +脚本 `iv-fence-loop2.py`：使用与生产 `claim`/`recoverStale`/`materialize`/`recordFailure` **逐字一致**的 SQL，两次领取的 `processing_started_at` **固定为 `2026-09-16 12:00:00`**。 + +``` +轮次 = 100（两次领取的 processing_started_at 固定为 2026-09-16 12:00:00） +[PASS] 100 轮：A 的完成/失败/回退全部 0 行、未覆盖 B、B 均完成、无永久 PROCESSING +``` + +每轮断言： +- A 用旧 token 的完成 / 失败 / PENDING 回退 → **受影响行数均为 0** +- A 未改动 B 的 `status`、`claim_token`、`attempts`、`last_error_code` +- B 用新 token 完成 → 1 行 +- 终态无残留 `PROCESSING` + +（脚本首轮运行暴露了自身缺陷：`ROW_COUNT()` 跨 `docker exec` 连接失效、回收步骤的 `WORKER_TIMEOUT` 被误判为污染；已修正后重跑。） + +### 6.3 三个 GET 零写 + +**PASS=24 / FAIL=0 / SKIP=0** —— 三个目标 GET ×3 + 趋势 GET ×3 全部 HTTP 200，**22 张表逐字段零变化** ✔ + +### 6.4 无快照学生 + +新学生 8019：`before=0` → 3 次 GET（均 200）→ `after=0` ✔ + +### 6.5 五条写侧链路 + +**PASS=44 / FAIL=0 / SKIP=0** —— Offer 自动过期、Feedback create/update/delete、简历版本创建；每条均验证「业务变化 → 唯一任务 → 周期正确 → Worker COMPLETED → 无失败分类 → 八维齐备 → 不写 snapshot_history」；相同输入重放不推进 version ✔ + +### 6.6 消费者最小回归 + +**PASS=33 / FAIL=0 / SKIP=0** —— 趋势（当前周期 2026-09）、排名（rank/percentile/cohortSize）、企业看板 4 端点 + 越权 403、公平性 5 端点（抑制语义保留）、申诉取证非空；消费者 GET 逐字段零写 ✔ + +### 6.7 RabbitMQ + +4 个队列（`queue.sms.verification` / `queue.notification` / `queue.notification.dlq` / `queue.audit`）**ready=0、unacked=0** ✔ + +### 6.8 token 不泄露 + +- 测试断言：token 不出现在 `audit_logs` / `notifications` / `messages` / `candidate_dimension_scores.sub_scores_json`；`last_error_code` 仅固定枚举 ✔ +- 运行日志：未出现 token 形态内容；`claim_token` 不参与任何日志输出语句 ✔ +- 数据库：token 仅存于 `candidate_scoring_refresh_tasks.claim_token`，且在终态/PENDING 时被清空 ✔ + +--- + +## 7. 精确修改文件 + +**生产代码（3 个）** + +| 文件 | 改动 | +|---|---| +| `db/migration/V45__add_scoring_refresh_claim_token.sql` | **新增**：仅加 `claim_token VARCHAR(36) NULL` | +| `candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java` | `claim` 生成并原子写入 UUID；COMPLETED / PENDING 回退 / `recordFailure` 的全部 WHERE 由 `processing_started_at` 改为 `claim_token`；四处（含 `recoverStale`）`SET claim_token=NULL`；`ClaimedTask` 增 `claimToken`；`recordFailure` 形参改 `String claimToken` | +| `candidatescore/refresh/CandidateScoringRefreshTask.java` | 实体新增 `claimToken` 映射；`processingStartedAt` 注释标明不再作为所有权证明 | + +**配置/接口/数据**：未修改 `application.yml`；未新增 ErrorCode；未新增公网接口；未修改评分公式、权重、快照内容、任务合并语义；未把 `DATETIME(6)` 当作最终修复（`processing_started_at` 精度保持不变）。 + +**测试（新增 1 个类；适配 4 个既有类）** + +新增：`CandidateScoringRefreshClaimTokenTest`（13 个测试） +适配：`CandidateScoringRefreshMySqlIntegrationTest`（列数 13→14 + V45 断言）、`OfferExpiryRefreshRegistrationTest`（禁止列名调整 + `claim_token` 存在性断言）、`CandidateScoringRefreshClaimFenceTest` 与 `CandidateScoringRefreshInfrastructureTest`（`recordFailure` 传 `claimToken()`）、`CandidateScoringRefreshWorkerLoopIsolationTest`（mock 签名 + `ClaimedTask` 构造） + +--- + +## 8. Git 状态 + +``` +分支：refactor/r01-structure-performance +HEAD：b10c4a732740e42353ca826f63141c3dd2a49915（未变） +暂存区：空 +git add -A / commit / push：均未执行 +V1–V44：未修改 +新增迁移：V45（唯一本轮新增；V44 为 D4-1 产物） +删除文件：无 +git diff --check：无空白错误 +``` + +验收数据已按精确主键清理（`users` 残留 0：8015/8016/8017/8018/8019 均删除；公司 33/34、岗位 50、投递 92/93、offer、简历版本、申诉及关联行全部清除）。`audit_logs` 中 actor 为本轮 5 个隔离用户的 **15 + 2 = 17 行**属 append-only 合规记录，保留并登记（关联 ID：`user_id ∈ {8015, 8016, 8017, 8018, 8019}`）。 + +唯一测试夹具（精确 INSERT，已登记并已清理）：`user_roles` 为 8017/8018 各插入 1 行 `COMPANY`。 + +Docker 保持运行（三容器 healthy）；仅停止本轮记录 PID 的实例；8080/8081 空闲。 + +--- + +## 9. 明确声明 + +- **未暂存、未提交、未推送。** +- 未进入其他 R01 工作。 +- 原始验收产物继续排除在后续提交之外。 +- 已按要求「先补失败测试 → 保存修复前失败结果 → 再改生产代码」。 + +--- + +> R01-D4-2 claim fence 定向整改完成，待最终独立增量复验；GET 评分快照写入迁移尚未冻结。 diff --git a/docs/r01-d4-2-claim-token-final-verification-20260916.md b/docs/r01-d4-2-claim-token-final-verification-20260916.md new file mode 100644 index 0000000..0012277 --- /dev/null +++ b/docs/r01-d4-2-claim-token-final-verification-20260916.md @@ -0,0 +1,188 @@ +# R01-D4-2 claim token 最终独立复验报告（冻结前最后一次） + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b10c4a732740e42353ca826f63141c3dd2a49915`（复验全程未变） +复验对象：`docs/r01-d4-2-claim-fence-remediation-20260916.md` 的 claim token 整改 +性质：**仅复验** —— 未修改生产代码、未修改既有测试、未暂存、未提交、未推送 + +--- + +## 0. 最终结论 + +> **R01-D4-2独立代码复验和真实MySQL/Docker增量黑盒全部通过，GET评分快照写入迁移可以冻结并进入精确暂存检查点。** + +**FAIL = 0，SKIP = 0。** claim token 闸门在代码审查、自动化测试与真实 MySQL 100 轮黑盒三个层面均确证有效：旧 Worker 无法以任何形式修改新持有者。 + +--- + +## 1. 基线 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `b10c4a732740e42353ca826f63141c3dd2a49915` ✔（= b10c4a7） | +| 暂存区 | 空 ✔ | +| `git diff --check` | 无空白错误 ✔ | +| V1–V44 | 未修改 ✔ | +| 新增迁移 | **V45 为唯一本轮新增**（V44 为 D4-1 产物）✔ | +| JAR | `mydreamjob-server-0.0.1-SNAPSHOT.jar`，2026-09-16 **17:26:51**（最新 `clean verify` 产出）✔ | + +--- + +## 2. 独立代码审查 + +`CandidateScoringRefreshTaskExecutor.java`（153 行，逐行核对）： + +| 核查项 | 结论 | 证据 | +|---|---|---| +| token 在领取 SQL 中原子生成并写入 | ✔ | `:53` `UUID.randomUUID().toString()`；`:56` `SET status='PROCESSING', processing_started_at=?, claim_token=?, ...` 同一 UPDATE | +| token 不由调用方复用 | ✔ | `claim(Long, LocalDateTime)` 无 token 形参，每次调用新生成 | +| COMPLETED 条件 = id + PROCESSING + claim_token + version | ✔ | `:92` `WHERE id=? AND status='PROCESSING' AND claim_token=? AND version=?` | +| PENDING 条件 = id + PROCESSING + claim_token | ✔ | `:104` | +| RETRY / FAILED 条件 = id + PROCESSING + claim_token | ✔ | `:135`（`recordFailure` 依 `attempts+1 >= maxAttempts` 落到 RETRY 或 FAILED） | +| 离开 PROCESSING 后 token 全部清空 | ✔ | `recoverStale` `:38`；COMPLETED `:89`；PENDING `:102`；RETRY/FAILED `:133` —— **四处全覆盖** | +| recoverStale 清空旧 token | ✔ | `:38` `claim_token=NULL` | +| 下一次领取生成全新 token | ✔ | `:53` 每次调用重新生成 | +| `processing_started_at` 不再出现在所有权判断 WHERE 中 | ✔ | 全文件唯一 WHERE 用法为 `:40` 的**超时扫描** `WHERE status='PROCESSING' AND processing_started_at < ?`；所有权判定全部使用 `claim_token` | +| 更新 0 行按 stale claim 处理 | ✔ | `claim` `:61-63` 返回 null；`materialize` PENDING 分支 `:106-110` 安静返回；`recordFailure` `:137-140` 安静返回 —— **均不抛异常、不误报成功** | +| 0 行时不覆盖现持有者 | ✔ | 三个更新语句的 WHERE 均含 `claim_token=?` | +| token 不进入日志/审计/响应/通知/消息/快照 JSON | ✔ | 全仓 grep：`claim_token`/`claimToken` 仅出现在实体映射（`CandidateScoringRefreshTask.java:73-74`）、Executor 的 SQL/注释/record、以及 `CandidateScoringRefreshWorker.java:91` 的传参；refresh 包内**无任何含 token 的日志语句** | + +--- + +## 3. 自动化复验 + +| 命令 | 实际 | 预期 | 结论 | +|---|---|---|---| +| `mvn -Dtest="*CandidateScoringRefresh*Test" test` | **49 / 49**，F=0 E=0 **S=0** | ≥ 49 | ✔ | +| 关联回归（9 组通配符） | **571 / 571**，F=0 E=0 **S=0**，BUILD SUCCESS | ≥ 571 | ✔ | +| `mvn clean verify` | **2176 / 2176**，F=0 E=0 **S=0**，BUILD SUCCESS | ≥ 2176 | ✔ | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | 176/214 | ✔ | + +日志：`fv-fence.log`、`fv-regression.log`、`fv-clean-verify.log` + +--- + +## 4. 真实 MySQL 最小黑盒 + +脚本 `fv-fence.py` —— 使用与生产 `claim`/`recoverStale`/`materialize`/`recordFailure` **逐字一致**的 SQL，**所有领取的 `processing_started_at` 固定为 `2026-09-16 12:00:00`**。 + +**结果：PASS** + +### A. 100 轮竞争 + +每轮：A 领取（token_A）→ 回收（token 清空）→ B 在**相同时间值**下重新领取（token_B）→ A 以 token_A 执行四种迟到写 → B 以 token_B 完成。 + +| 断言 | 结果 | +|---|---| +| A 的 **COMPLETED** 更新 0 行 | ✔ 100 轮均为 0 | +| A 的 **PENDING** 更新 0 行 | ✔ | +| A 的 **RETRY** 更新 0 行 | ✔ | +| A 的 **FAILED** 更新 0 行 | ✔ | +| B 的 token / status / version 未被 A 修改 | ✔ 逐轮比对 `status='PROCESSING'`、`claim_token=token_B`、`version=version_B` 均不变 | +| B 正常完成 | ✔ 每轮 B 完成后 `status='COMPLETED'` 且 token 清空 | +| 终态无永久 PROCESSING | ✔ | +| 无重复完成、无任务丢失 | ✔ 终态任务数 = 1 | + +### B. token 生命周期 + +- `recoverStale` 后 `claim_token` 为 **NULL** ✔ +- 再次领取后 token **非空且不同于此前所有 token** ✔ + +### C. 无效 token 不可更新 + +| 场景 | 行数 | +|---|---| +| 空 token（`claim_token=''`） | **0** ✔ | +| 伪造 token（随机新 UUID） | **0** ✔ | +| 旧 token（A 的 token_A） | **0** ✔ | +| NULL token | **0** ✔ | + +且四种尝试后任务状态**完全未变**（前后 `st()` 全等）✔ + +### D. version 推进 → PENDING → 下一轮新 token 完成 + +- 同一 claim 期间新请求推进 `version` → COMPLETED 更新 **0 行**（version 不匹配） +- 当前 Worker 走 PENDING 回退 → **1 行**，`status='PENDING'` 且 token 清空 ✔ +- 下一轮领取使用**新 token** ✔ → 完成 **1 行**，`status='COMPLETED'` ✔ + +--- + +## 5. 最小业务回归 + +实例：最新 JAR；物化实例 PID 11884（`SCORING_REFRESH_ENABLED=true`）、只读实例 PID 6988（`false`），均已停止。 + +| 项 | 结果 | +|---|---| +| **三个 GET 零写** | **PASS=24 / FAIL=0 / SKIP=0** —— 三个目标 GET ×3 + 趋势 GET ×3 全部 200，**22 张表逐字段零变化** ✔ | +| **无快照学生** | 新学生 8024：`before=0` → 3 次 GET（均 200）→ `after=0` ✔ | +| **五条写侧链路** | **PASS=44 / FAIL=0 / SKIP=0** —— Offer 自动过期、Feedback create/update/delete、简历版本创建；每条验证「业务变化 → 唯一任务 → 周期正确 → Worker COMPLETED → 无失败分类 → 八维齐备 → 不写 snapshot_history」；重放不推进 version ✔ | +| **消费者回归** | **PASS=33 / FAIL=0 / SKIP=0** —— 趋势 / 排名 / 企业看板 / 申诉 / 公平性监控；消费者 GET 逐字段零写 ✔ | +| **V45** | `success=1` 且 `v45_rows=1`（唯一）；`failed_migrations=0` ✔ | +| **Hibernate validate** | 通过；日志中 `schema-validation`/`SchemaManagementException` 命中 **0** ✔ | +| **RabbitMQ** | 4 队列（`queue.sms.verification` / `queue.notification` / `queue.notification.dlq` / `queue.audit`）**ready=0、unacked=0** ✔ | +| **token 泄漏扫描** | **PASS** —— 日志非框架 UUID 命中 **0**；HTTP 响应 token 形态命中 **0**；数据库其它载体命中 **0**（当前无活跃 token，终态/PENDING 已全部清空）✔ | +| **扫描器探针** | 临时文件注入 UUID → 正则命中；向 `audit_logs` 插入探针 → DB 命中 1 → 清理后 0 —— **探针 PASS，证明扫描器非空转**；探针文件已删除 ✔ | + +--- + +## 6. 收尾 + +| 项 | 结果 | +|---|---| +| 本轮 Java 实例 | 仅停止本轮记录的两个 PID（11884、6988）；`tasklist` java.exe 计数 = **0** ✔ | +| 8080 / 8081 | 空闲 ✔ | +| Docker | 保持运行，三容器 healthy ✔ | +| 数据清理 | `users` 残留 **0**（8020/8021/8022/8023/8024 及公司、岗位 51、投递 94/95、offer、简历版本全部按精确主键删除）✔ | +| append-only 审计 | `audit_logs` 中 actor 为本轮 5 个隔离用户的 **15 + 2 = 17 行**保留并登记（关联 ID：`user_id ∈ {8020, 8021, 8022, 8023, 8024}`）✔ | +| 测试夹具（精确 INSERT，已登记并已清理） | `user_roles` 为 8022/8023 各插入 1 行 `COMPANY` ✔ | +| Git | 分支未变、HEAD 未变、暂存区空、V1–V44 未改、V45 唯一新增、无删除文件、无空白错误 ✔ | +| 未暂存 / 未提交 / 未推送 | 是 ✔ | + +本轮新增产物（`docs/acceptance/r01-d4-2-20260916/`，未进入暂存区）：`fv-fence.py` + `fv-fence-out.txt`、`fv-tokenscan.py`、`fv-fence.log`、`fv-regression.log`、`fv-clean-verify.log`、`v3-fv-out.txt`、`s1-fv-out.txt`、`s4-fv-out.txt`。 + +--- + +## 7. PASS / FAIL / SKIP 清单 + +**FAIL**：无。 + +**SKIP**：无。 + +**PASS**： + +1. 基线（分支/HEAD/暂存区/V1–V44/V45 唯一/最新 JAR） +2. 代码审查 12 项（token 原子生成、不复用、COMPLETED 四条件、PENDING/RETRY/FAILED 三条件、四处清空、recoverStale 清空、新 token、`processing_started_at` 退出所有权判定、0 行 stale 处理、不覆盖、不泄漏） +3. fence 定向 49/49 +4. 关联回归 571/571 +5. 全量 clean verify 2176/2176（S=0） +6. OpenAPI 176/214 +7. 真实 MySQL 100 轮竞争（四种迟到写全 0 行、B 未被修改、B 均完成、无永久 PROCESSING、无丢失） +8. token 生命周期（回收后 NULL、重领后新值） +9. 空/伪造/旧/NULL token 均无法更新 +10. version 推进 → PENDING → 新 token 完成 +11. 三个 GET 零写 24/24（22 表逐字段） +12. 无快照学生 0 行 +13. 五条写侧 44/44 +14. 消费者 33/33 +15. V45 成功且唯一 +16. Hibernate validate +17. RabbitMQ 四队列为 0 +18. token 泄漏扫描 0 + 探针有效 + +--- + +## 8. 复验过程中的自暴露问题（非产品缺陷） + +| # | 问题 | 处置 | +|---|---|---| +| 1 | `fv-fence.py` 的 `retry_sql`/`failed_sql` 存在两个 `%s` 占位符只传一个参数的 Python 格式化错误 | 改为 `% (TABLE, token)`；已修正 | +| 2 | `fv-tokenscan.py` 的 DB 探针使用 `messages` 表触发外键失败 | 改用无外键依赖的 `audit_logs`，并增加「插入前=0 / 插入后=1 / 清理后=0」三段验证；已修正 | +| 3 | 探针插入的 `audit_logs` 行 | 探针执行后立即删除，已确认清理后计数为 0 | + +以上均为**验收脚本自身**问题，与产品代码无关；修正后重跑全部通过。 + +--- + +> **冻结判定：R01-D4-2独立代码复验和真实MySQL/Docker增量黑盒全部通过，GET评分快照写入迁移可以冻结并进入精确暂存检查点。** diff --git a/docs/r01-d4-2-final-independent-incremental-verification-20260916.md b/docs/r01-d4-2-final-independent-incremental-verification-20260916.md new file mode 100644 index 0000000..b5a5420 --- /dev/null +++ b/docs/r01-d4-2-final-independent-incremental-verification-20260916.md @@ -0,0 +1,275 @@ +# R01-D4-2 最终独立增量复验报告（整改后） + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b10c4a732740e42353ca826f63141c3dd2a49915`（复验全程未变） +复验对象：`docs/r01-d4-2-blocker-remediation-20260916.md` 的 F1–F4 与两项次生缺陷整改 +性质：**只复验**，未修改生产代码与既有测试 + +--- + +## 0. 最终结论 + +> **已复现具体缺陷，R01-D4-2 不可冻结；报告已包含下一轮定向整改指令。** + +判定 **FAIL**。唯一原因是任务书指定的硬性判据 —— **claim fence 的精度不足**： + +> 「特别核查 processing_started_at 的 Java/JDBC/MySQL 精度一致性。若新旧两次领取可能得到相同 fence，直接判 FAIL」 + +实测已证明**可能**（见 §3）。除此之外，**本轮全部核心项均通过**：五条写侧链路、简历事务故障、20 轮 fence 竞争、批次隔离、三个 GET 零写（22 表逐字段）、无快照学生零写、消费者全量回归、V44、RabbitMQ、日志脱敏。 + +--- + +## 1. 开始前基线 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `b10c4a732740e42353ca826f63141c3dd2a49915`（未变）✔ | +| 暂存区 | 空 ✔ | +| `git diff --check` | 无空白错误 ✔ | +| V1–V43 | 未修改 ✔ | +| V44 | 仍为唯一新增迁移 ✔ | +| 删除文件 | 无 ✔ | +| 生产代码改动 | 14 项（13 个 `M` + `refresh/` 目录），与整改后一致 ✔ | +| JAR | `mydreamjob-server-0.0.1-SNAPSHOT.jar`，**2026-09-16 16:43:14**（本轮 `mvn clean verify` 产出，未使用旧 JAR）✔ | + +--- + +## 2. 独立代码复验（六项重点） + +### 2.1 OfferExpiryWorker — **通过** + +- `OfferExpiryWorker.java:51` `saveAndFlush` → `:56` `requestRefresh(saved.getCandidateId(), LocalDateTime.now())` → `:57` `notifyExpired` → `:58` `log.info`，全部位于方法自身的 `@Transactional(REQUIRES_NEW)` 内 ✔ 状态变更与登记同事务。 +- 未变化时不登记：`:45-47` 的幂等早返回（状态非 `SENT`/`NEGOTIATING` 直接 `return`）位于 `:48` 状态改写**之前**，因此不会对已过期的 Offer 重复登记 ✔ +- 真实 MySQL 复验：`offer 17 -> EXPIRED`，任务唯一且 `COMPLETED` ✔ + +### 2.2 CandidateFeedbackService — **通过** + +- `createFeedback`（`:82` 后）、`updateFeedback`（`save` 后）、`deleteFeedback`（`delete` 后）三处均登记 ✔ +- `deleteFeedback` 在 `feedbackRepository.delete(fb)` **之前**取 `Long studentUserId = app.getStudentUserId()`，删除后仍用该局部变量登记 ✔ +- 失败路径不登记：越权（`assertCompanyOwner`）与 `FEEDBACK_NOT_FOUND` 均在任何登记语句之前抛出 ✔ 真实复验 `B3 失败路径不留孤立任务 tasks=[]` ✔ + +### 2.3 ResumeVersionWriter — **通过** + +- `ResumeVersionWriter.java` 的 `saveNewVersion` 为 `@Transactional(propagation = REQUIRES_NEW)`，`:38` `save` 与 `:40` `requestRefresh(userId, LocalDateTime.now())` 处于**同一事务** ✔ +- 外层不重复登记：`ResumeVersionService.createVersion` 中原 `:71` 的登记已移除，改为注释说明 ✔（`grep requestRefresh ResumeVersionService.java` 仅剩 `updateVersion`/`deleteVersion` 两处，二者与各自写操作同事务） +- 保留 `REQUIRES_NEW`：既有「单次唯一键冲突只回滚自身、外层可安全重试」设计未被破坏 ✔ + +### 2.4 ABILITY 脱敏测试 — **通过** + +`CandidateScoringRefreshInfrastructureTest#abilitySnapshotPayload_hasNoSensitiveFields_andKeepsWhitelistedKeys`： +- 经**真实 `CandidateScoringSnapshotWriter.upsertIfChanged`** 写入 → 从**真实数据库** `SELECT sub_scores_json` 读回 → `ObjectMapper.readTree` 后**递归**扫描 ✔ +- 正向：`source` / `sourceResultId` / `validUntil` / `questionSetVersion` / `assessmentRulesVersion` / `mappingRulesVersion` / `weights` / `dimensionScores` 全部存在且取值正确 ✔ +- 负向：`BANNED_KEYS` 共 **26 项**，逐项核对报告清单一致 —— `answer`, `answers`, `rawanswer`, `rawanswers`, `question`, `questions`, `questionid`, `questioncode`, `questionstem`, `option`, `options`, `optionid`, `selectedoption`, `selectedoptionid`, `answerkey`, `competencytag`, `stem`, `scoringrule`, `awardedscore`, `explanation`, `phone`, `email`, `mobile`, `token`, `password`, `accesstoken` ✔ +- 大小写：key 小写化后**精确匹配**（`questionSetVersion` 不会因含子串 `question` 误报）；另有原始 JSON 文本层 `""` 字面量断言 ✔ +- 嵌套对象与数组：`assertNoBannedKeyDeep` 递归处理 `isObject` 与 `isArray` ✔ + +### 2.5 claim fence — **不通过（精度不足，见 §3）** + +- 语义正确性：完成（`CandidateScoringRefreshTaskExecutor.java`）校验 `id + status='PROCESSING' + processing_started_at + version`；失败与 PENDING 回退校验 `id + status='PROCESSING' + processing_started_at` ✔ +- **但** fence 字段本身精度不足，构成 FAIL。 + +### 2.6 批次隔离 — **通过** + +- `recordFailure` 在 `updated != 1` 时 `return`（安静退出），不再抛 `IllegalStateException` ✔ +- `processOne` 的 `catch` 内对 `recordFailure` 再包一层 `try/catch`，避免其异常外泄 ✔ +- `processDue` 的 `for` 循环体加 `try/catch` ✔ +- 真实数据库异常不被伪装成功：`CandidateScoringRefreshBatchIsolationTest#batchTerminalState_matchesRealOutcome` 断言批次结束为 2 个 `COMPLETED` + 1 个 `RETRY`，且无残留 `PROCESSING` ✔ +- 真实 MySQL：`CandidateScoringRefreshMySqlIntegrationTest#mysqlFailureRollsBackPartialSnapshotsAndDoesNotRollbackSibling` ✔ + +--- + +## 3. FAIL 项：claim fence 精度不足 + +### 3.1 事实链 + +| 环节 | 事实 | 证据 | +|---|---|---| +| 列定义 | `processing_started_at DATETIME NULL` —— **无小数秒** | `V44__candidate_scoring_refresh_tasks.sql:11` | +| 实际精度 | `DATETIME_PRECISION = 0` | `information_schema.columns` 查询 | +| 写入截断 | `'2026-09-16 12:00:00.123456'` 存入 `DATETIME` 后变 `'2026-09-16 12:00:00'`（与 `DATETIME(6)` 比较 `equal_after_store = 0`） | `iv-precision.sql` | +| Java 侧 | `LocalDateTime.now()`（纳秒）传入 JDBC | `CandidateScoringRefreshTaskExecutor.java` `claim(...)` | +| 读回 | `rs.getObject("processing_started_at", LocalDateTime.class)` —— 秒级 | 同上 | + +**结论：fence 的比较粒度是 1 秒。** + +### 3.2 最小复现（已在真实 MySQL 执行） + +脚本：`docs/acceptance/r01-d4-2-20260916/iv-fence2.sql`（与生产 `claim`/`recoverStale` SQL **逐字一致**） + +``` +after_claim_1 | 2026-09-16 16:36:09 | PROCESSING +after_recover(sub-second-timeout) | 2026-09-16 16:36:09 | PROCESSING ← 回收后立即被重领 +after_claim_2 | 2026-09-16 16:36:09 | PROCESSING +``` + +**两次领取的 fence 完全相同**（`16:36:09` == `16:36:09`），秒级精度无法区分新旧持有者。 + +同一脚本末段同时给出边界条件： +``` +earliest_new_fence_when_timeout_600s = 2026-09-16 12:10:00 +can_be_equal = 0 +``` + +### 3.3 触发条件 + +`recoverStale` 的条件是 `processing_started_at < now - timeout`，其中 `timeout = processingTimeoutMs`（`CandidateScoringRefreshWorker.java:55`：`processingTimeoutMs <= 0 ? 600_000L : processingTimeoutMs`）。 + +- **timeout ≥ 1000 ms**（含生产默认 600000）：新领取时刻 ≥ 旧 fence + timeout > 旧 fence 所在秒 → **fence 必然不同**，机制可靠。 +- **timeout < 1000 ms**（运维显式配置 `SCORING_REFRESH_PROCESSING_TIMEOUT_MS` 为 1–999）：回收与重领可落在同一秒 → **fence 相同**，闸门失效。 + +代码中**未对该配置做下界约束**，因此「可能得到相同 fence」成立。 + +### 3.4 影响范围（如实界定） + +即使 fence 相同，**COMPLETED 分支仍校验 `version`**，因此旧 Worker 不会把新 Worker 的 `PROCESSING` 误置为 `COMPLETED`。实际失效路径只有 PENDING 回退分支：旧 Worker 把新持有者的 `PROCESSING` 改成 `PENDING`，导致新 Worker 完成时更新 0 行而安静退出。后果是**多算一次**（任务回到 PENDING 待下轮重算），不产生数据损坏，也不会留下永久 `PROCESSING`。 + +但按任务书给定的判据 —— 「若新旧两次领取**可能**得到相同 fence，直接判 FAIL；不能用测试等待规避」—— 判定为 **FAIL**。 + +### 3.5 下一轮定向整改指令 + +**R-1（阻断冻结）**：让 claim fence 具备亚秒分辨力，二选一： + +- **(a) 提升列精度**：新增迁移 `V45` 将 `processing_started_at` 改为 `DATETIME(6)`（**不得修改 V44**），并把 Java 侧传入值统一到微秒；同时确认 `recoverStale` 的比较与索引仍有效。 +- **(b) 改用不依赖时间的 fence**：使用既有 `version` 列的**单调快照**作为所有权标识 —— 在 `claim` 时把 `version` 的当次结果记入 `ClaimedTask`，完成/失败/回退时要求 `version` 属于「本次领取之后、下一次领取之前」的区间。若选此路，需明确区分「同 claim 期间新请求推进 version」（应回退 PENDING）与「被重新领取推进 version」（应安静退出）—— 可借助 `attempts` 或 `processing_started_at` 的组合判定。 + +**R-2（同批处理）**：为 fence 增加**边界测试**：显式构造 `timeout < 1s` 场景，断言旧 Worker 不得覆盖新持有者；或对 `processing-timeout-ms` 增加「必须 ≥ 1000」的配置校验（若选 (a)/(b) 后仍有时间依赖）。 + +**R-3（建议）**：`iv-fence2.sql` 与 `iv-precision.sql` 可作为该轮复验的前置失败证据复用。 + +--- + +## 4. 自动化复验结果 + +| 命令 | 实际 | 任务书预期 | 结论 | +|---|---|---|---| +| 定向（5 组通配符） | **184 / 184**，F=0 E=0 S=0 | 104 | 数量差异见下 | +| 关联回归（9 组通配符） | **558 / 558**，F=0 E=0 S=0 | 558 | 一致 ✔ | +| `mvn clean verify` | **2163 / 2163**，F=0 E=0 **S=0**，BUILD SUCCESS | 2163 | 一致 ✔ | +| `python docs\verify_openapi.py` | **176 paths / 214 operations**，All checks passed | 176/214 | 一致 ✔ | + +**定向数量差异解释（184 vs 104）**：任务书给定的通配符 `*OfferExpiry*Test,*CandidateFeedback*Test,*ResumeVersion*Test,*CandidateScoringRefresh*Test,*CandidateScoringCalculatorTest` 比整改自测时使用的 12 个类名更宽，额外匹配了 `OfferControllerTest`(30)、`OfferServiceTest`(21)、`OfferPersistenceIntegrationTest`(16)、`CandidateFeedbackControllerTest`(8)、`ResumeExportServiceTest`(8)、`ResumeVersionPersistenceIntegrationTest` 等既有类。**差异全部为多覆盖，无遗漏**。 + +逐类（18 个类）：30 / 4 / 6 / 3 / 14 / 6 / 3 / 8 / 7 / 16 / 7 / 7 / 8 / 21 / 6 / 8 / 4 / 26 = 184 ✔ + +--- + +## 5. 真实 MySQL / Docker 增量黑盒 + +实例：本轮 `clean verify` 产出的最新 JAR；物化实例 PID 12592（`SCORING_REFRESH_ENABLED=true`、`OFFER_EXPIRY_INTERVAL_MS=3000`、补偿 5s/limit 2），只读实例 PID 11060（`false`）。二者均已停止，8080/8081 空闲。 + +### 5.1 A. 五条写侧链路 — **PASS=44 / FAIL=0 / SKIP=0** + +每条均断言：业务数据变化 → 同学生同周期唯一任务 → 周期正确 → Worker `COMPLETED` → 无失败分类 → 八维齐备 → 不写 `snapshot_history`。 + +| 写侧 | 业务变化 | 任务 | Worker | 八维 | history | +|---|---|---|---|---|---| +| A1 Feedback create | `active=1` | 1 条 | `COMPLETED` 1.1s | 8 | 0→0 | +| A2 Feedback update | `rating=2` | 1 条 | `COMPLETED` 0.6s | 8 | 0→0 | +| A3 Feedback delete | `active=0` | 1 条 | `COMPLETED` 0.6s | 8 | 0→0 | +| A4 简历版本创建 | `versions=1` | 1 条 | `COMPLETED` 0.7s | 8 | 0→0 | +| A5 Offer 自动过期 | `offer 17 → EXPIRED` | 1 条 | `COMPLETED` 1.1s | 8 | 0→0 | + +**幂等**：完全相同输入重放 → 八维 version 完全一致 +`{ABILITY:0, ACTIVITY:1, COMPLIANCE:0, EDUCATION:0, GROWTH:1, INTEGRITY:4, INTERNSHIP:0, STABILITY:1}` 前后不变，且不写 `snapshot_history` ✔ + +### 5.2 B. 简历事务故障 — **通过** + +| 场景 | 结果 | +|---|---| +| B1 内层成功后外层回滚 → 版本与任务均存在 | `versions=1 tasks=1` ✔（精确断言见 §4 的 `ResumeVersionRefreshAtomicityTest`） | +| B2 版本写入失败（非法文件被 `ResumeFileValidator` 拒绝，st=400） | 版本行 `1→1` 未创建；**未登记任务** `tasks=[]` ✔ | +| B3 失败路径不留孤立任务（学生越权调用企业接口，st=403） | 学生 A `tasks=[]` ✔ | +| 文件补偿与旧文件保护语义 | 未改动 `ResumeVersionService` 的文件生命周期代码（仅移除一行登记），既有 `catch(RuntimeException)` 清理与 `TransactionSynchronization` 逻辑保持不变 ✔ | + +> 注：B 场景中「版本写入失败」与「任务登记失败」在真实 HTTP 下无法分别构造（`ResumeVersionWriter` 是内部组件），前者用非法文件触发校验失败，后者由 `ResumeVersionRefreshAtomicityTest` 的事务回滚用例覆盖。 + +### 5.3 C. Claim fence 竞争（20 轮） — **PASS** + +脚本 `iv-fence-loop.py`，每轮：A 领取 → 期间新请求推进 version → A 完成 → A 回退 PENDING → B 重新领取 → **延迟的 A 再尝试完成/失败/回退**。 + +20 轮全部满足： +- A 未覆盖 B（B 的 `status` 与 `processing_started_at` 均未被改动） +- 无新请求丢失（`requested_at` 已推进） +- 无永久 `PROCESSING` +- 无重复完成 +- B 均正确完成 +- A 的失败登记未污染 `last_error_code` 与 `attempts` + +> **重要限定**：该循环通过是因为运行中 A/B 两次领取**恰好跨秒**（每条 SQL 之间耗时累积）。它验证的是 fence **在值不同时**的语义正确性；**不构成** fence 精度足够的证据 —— 精度不足正是 §3 的 FAIL 项。 + +### 5.4 D. 批次失败隔离 — **通过** + +三个任务「正常 → 故障 → 正常」： +- `failingTaskInMiddle_doesNotBlockRemainingTasks` —— 前后两个正常任务均 `COMPLETED` +- 故障任务状态为 `RETRY`（未伪装成功），`last_error_code = COMPUTE_FAILED` +- Worker 未中断整批；`batchTerminalState_matchesRealOutcome` 断言无残留 `PROCESSING` +- 后续重试：`RETRY` + `next_attempt_at` 由 Worker 正常再处理 +- 真实 MySQL：`mysqlFailureRollsBackPartialSnapshotsAndDoesNotRollbackSibling` ✔ + +--- + +## 6. D4-2 核心回归 + +| 项 | 结果 | +|---|---| +| 三个目标 GET ×3 + 趋势 GET ×3 | 全部 **HTTP 200**，契约稳定，无敏感字段泄露 ✔ | +| **22 张表逐字段零变化** | `[OK] 全部 22 张表逐字段零变化`；`candidate_dimension_scores` 1480 行、`refresh_tasks` 180 行、`checkpoints` 1 行、`audit_logs` 2667 行、`notifications` 164 行、`messages` 8 行、`snapshot_history` 4 行全部不变 ✔ | +| **无快照学生 GET 后仍 0 行** | 新建学生 8014：`before=0` → 3 次 GET（均 200，`overall=30.0`）→ `after=0` ✔ | +| 趋势回归 | 当前周期 `2026-09`、`overallScore=62.55`、多次调用稳定、零写 ✔ | +| 排名回归 | `rank=1`、`cohortSize=2`、`percentile=100.0`；学生 A/B 各 8 维快照 ✔ | +| 企业看板 | overview / job-rankings / candidate-rankings / trend 均 200；越权 403 ✔ | +| 申诉回归 | `appealId=4290`、`scoreAtAppeal=67.75`、`snapshotVersionAtAppeal=0`（非空）；副作用仅限契约表 ✔ | +| 公平性监控 | 5 个端点均 200；`drift`/`ranking-stability` 的 `UNAVAILABLE` 抑制语义保留 ✔ | +| V44 迁移 | `version=44`、`success=1`、`row=1`（唯一）、`failed_migrations=0` ✔ | +| Hibernate validate | 无 `schema-validation` / `SchemaManagementException` 错误 ✔ | +| RabbitMQ | 4 队列（`queue.sms.verification`/`queue.notification`/`queue.notification.dlq`/`queue.audit`）**ready=0、unacked=0** ✔ | +| 日志/响应/审计 | 应用日志（`r01d42-*.log`）手机号、Token、验证码、JWT、SQL 参数、简历路径命中 **均为 0**；222 处「口令」命中全部为 Spring Boot `Using generated security password: `（框架提示，非项目凭据）；3 处手机号命中为既有测试 `AdminBootstrapConcurrencyLoggingTest` 的扫描器探针；响应扫描无 `phone/email/resumeUrl/storagePath/accessToken` ✔ | + +副作用证明方式：全部使用**显式列 + 稳定 ORDER BY 的逐字段行快照比对**（`snap.py`），未使用 `COUNT`/`SUM`/`CRC32` 替代；并附有效性反证（`snap.selftest()` 对单字段内存改动可检出，PASS）。 + +--- + +## 7. 收尾 + +| 项 | 结果 | +|---|---| +| 本轮 Java 实例 | 仅停止本轮记录的两个 PID（12592、11060）；`tasklist` java.exe 计数 = **0** ✔ | +| 8080 / 8081 | 空闲 ✔ | +| Docker | 保持运行，三容器 healthy ✔ | +| 数据清理 | `users` 残留 **0**；本轮用户 8010/8011/8012/8013/8014、公司 31/32、岗位 49、投递 90/91、offer 17、简历版本、申诉 4290 及全部关联行均按精确主键删除 ✔ | +| append-only 保留 | `audit_logs` 中 actor 为本轮 5 个隔离用户的 **15 + 2 = 17 行**保留并登记（关联 ID：`user_id ∈ {8010,8011,8012,8013,8014}`）✔ | +| 测试夹具（精确 INSERT，已登记并已清理） | `user_roles` 为 8012/8013 各插入 1 行 `COMPANY`；`offers` 插入 1 条已过期 SENT 记录（id=17）用于触发 F1 定时路径 ✔ | +| Git | 分支未变、HEAD 未变、暂存区空、V1–V43 未改、V44 唯一新增、无删除文件、`git diff --check` 无空白错误 ✔ | +| 未暂存 / 未提交 / 未推送 | 是 ✔ | + +本轮新增产物（均在 `docs/acceptance/r01-d4-2-20260916/`，未进入暂存区）：`iv-batch1.log`、`iv-batch2.log`、`iv-clean-verify.log`、`iv-precision.sql`、`iv-fence.sql`、`iv-fence2.sql`、`iv-fence-loop.py`、`v3-writeside.py`、`v3-out.txt`、`s1-iv-out.txt`、`s4-iv-out.txt`。 + +--- + +## 8. PASS / FAIL 清单 + +**FAIL（1 项）** + +| # | 项 | 依据 | +|---|---|---| +| 1 | **claim fence 精度不足**：`processing_started_at` 为秒级 `DATETIME`，实测同一秒内新旧领取得到相同 fence | 任务书硬性判据「可能得到相同 fence 直接判 FAIL」；最小复现 `iv-fence2.sql` | + +**PASS（其余全部）** + +OfferExpiryWorker 同事务登记与幂等；Feedback create/update/delete 登记与删除前取标识；ResumeVersionWriter 同一 `REQUIRES_NEW` 边界且外层不重复登记；ABILITY 脱敏 26 项禁止 key 递归断言；批次隔离与 stale claim 安静退出；定向 184/184；关联 558/558；全量 2163/2163（S=0）；OpenAPI 176/214；A 五条写侧；B 简历事务故障；C 20 轮 fence 竞争语义；D 批次隔离；22 表逐字段零写；无快照学生 0 行；趋势/排名/看板/申诉/公平性；V44；validate；RabbitMQ；日志脱敏。 + +**SKIP**：无（本轮无因环境或安全原因跳过项）。 + +--- + +## 9. 剩余风险 + +1. **fence 失效的后果有限但不为零**：即使触发，最坏结果是同一次刷新多算一遍（任务回到 PENDING），不会数据损坏或永久 PROCESSING。但对 SLA 敏感场景仍属正确性瑕疵。 +2. **`processing-timeout-ms` 无下界校验**：当前仅做 `<= 0 → 600000` 兜底，1–999 的取值未被拒绝。 +3. 任务书未要求、本轮也未执行的项：真实双 JAR 的多实例补偿扫描并发、申诉审核/回滚真实黑盒（延续 D4-2 首轮验收的 SKIP 记录，不属于本轮复验范围）。 + +--- + +> **已复现具体缺陷，R01-D4-2 不可冻结；报告已包含下一轮定向整改指令。** diff --git a/docs/r01-d4-2-get-scoring-readonly-implementation-report.md b/docs/r01-d4-2-get-scoring-readonly-implementation-report.md new file mode 100644 index 0000000..4e74a1e --- /dev/null +++ b/docs/r01-d4-2-get-scoring-readonly-implementation-report.md @@ -0,0 +1,57 @@ +# R01-D4-2 GET 评分快照停写实施报告 + +日期：2026-09-16 +状态：实现与自动化复验通过，待独立真实环境黑盒验收。 + +## 1. 变更结论 + +`CandidateScoringEngineService#getOverview`、`getDimensionDetail`、`getCompanyScoring` 已改为 +`@Transactional(readOnly = true)`，并移除 `CandidateScoringCalculator#upsertSnapshots` 调用。 +三个接口仍以同一次 `capturedNow` 实时计算并返回原响应结构，趋势接口继续读取已物化快照。 + +快照更新改由 D4-1 的写侧登记、后台 Worker 和补偿扫描负责。生产配置默认启用刷新与补偿； +test、integration-test、mysql-it profile 显式关闭调度，仅由测试主动驱动，避免后台线程干扰断言。 + +## 2. D4-1 网关补齐 + +V44 同时创建 `candidate_scoring_refresh_scan_checkpoints`。补偿扫描使用持久化游标、固定单轮预算和 +`SELECT ... FOR UPDATE` 串行推进；游标与任务登记同事务提交。扫描到尾部后从 0 开始下一轮，避免首 +页饥饿，也不会单次遍历全量用户。 + +真实 MySQL 8.4 Testcontainers 已验证：V1–V44 迁移和 schema validate、游标持久化、每轮预算、 +Writer 幂等与强制版本、并发唯一领取、处理中重登记、租约恢复、失败事务隔离。 + +## 3. 测试迁移 + +- `R01D4GetWritesSnapshotEvidenceTest` 改为逐字段快照，证明 overview、dimension、trend GET 零写入。 +- `CandidateScoringEngineServiceTest` 与时钟一致性测试显式断言三个 GET 从不调用 upsert。 +- `CandidateScoringPersistenceIntegrationTest` 显式调用 Calculator/Writer 验证物化幂等，不再借 GET 造数据。 +- `V38AbilityRankingIntegrationTest` 显式走真实物化入口，原排名公式和结果断言保持不变。 + +首次干净全量构建据此发现 V38 排名测试仍依赖 GET 副作用（1 Error）；修正夹具后专项测试通过， +再次执行干净全量构建成功。 + +## 4. 实测结果 + +| 项目 | 结果 | +| --- | --- | +| D4-2 + D4-1 H2/MySQL 组合定向 | 38 / 38，0 failure，0 error，0 skip | +| 时钟与持久化定向 | 13 / 13，0 failure，0 error，0 skip | +| V38 排名回归 | 1 / 1，原断言不变 | +| `mvn clean verify` | 2131 / 2131，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS | +| MySQL Testcontainers | Q01 与 V44 用例均真实执行，无跳过 | +| OpenAPI | 176 paths / 214 operations，校验通过 | +| `git diff --check` | 无空白错误，仅既有 LF/CRLF 提示 | + +## 5. 边界 + +V44 是唯一新增迁移，V1–V43 未修改；无新增公网接口、ErrorCode、RabbitMQ 消息或通知；未暂存、 +未提交、未推送；历史未跟踪文件未删除或移动。 + +## 6. 待独立验收 + +仍需使用最新 JAR 与项目真实 MySQL/Docker 环境完成：三条真实 HTTP GET 前后快照逐字段零变化； +写侧事件到任务登记再到快照可见；趋势、申诉、排名、看板、公平性监控不退化；RabbitMQ 队列终态 +为零；并精确清理或记录隔离验收数据。自动化与 Testcontainers 结果不能替代该黑盒步骤。 + +> R01-D4-2 实现及自动化复验完成，待独立真实 MySQL/Docker 黑盒验收。 diff --git a/docs/r01-d4-2-independent-mysql-acceptance-20260916.md b/docs/r01-d4-2-independent-mysql-acceptance-20260916.md new file mode 100644 index 0000000..953d48d --- /dev/null +++ b/docs/r01-d4-2-independent-mysql-acceptance-20260916.md @@ -0,0 +1,656 @@ +# R01-D4-2「GET 评分接口停写与快照可靠物化」独立代码复验与真实 MySQL/Docker/JAR/HTTP 黑盒验收 + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b10c4a7 docs: design scoring snapshot materialization` +验收性质：**最终独立验收**（非开发）。审查正式生产路径 + 项目既有 Docker Compose + 真实 MySQL 8.4 + 最新构建 JAR + 真实 HTTP。 +验收前缀：`R01D42_ACC_20260916_K4GDNT` + +--- + +## 0. 最终结论 + +> **已复现具体缺陷，R01-D4-2 不可冻结；报告已包含下一轮定向整改指令。** + +判定为 **FAIL**。触发任务书第二十节 FAIL 判据中的第 4 条「**写侧成功但任务未登记**」，并另有一处测试断言弱化（触碰「禁止修改或放宽既有测试」红线）。 + +同时必须明确记录：**本次验收的核心目标项全部实测通过** —— 三个评分 GET 在真实 HTTP 下确凿零写、V44 在真实 MySQL 成功、`clean verify` 2131/2131 全绿、补偿扫描游标与预算正确、趋势/排名/看板/申诉/公平性监控均未退化、RabbitMQ 终态正常。FAIL 由**写侧事件覆盖不全**这一独立缺陷触发，与 GET 停写本身无关。 + +--- + +## 1. Git 基线与工作区状态 + +| 检查项 | 结果 | +|---|---| +| 分支 | `refactor/r01-structure-performance` ✔ | +| HEAD | `b10c4a7`（验收全程未变） | +| 暂存区 | 空（`git diff --cached --name-only` 无输出）✔ | +| `git add -A` / `commit` / `push` | 均未执行 ✔ | +| V1–V43 修改 | 无（`git diff --name-only -- db/migration` 为空）✔ | +| V44 | `V44__candidate_scoring_refresh_tasks.sql` 为唯一新增迁移 ✔ | +| 删除文件 | 无 ✔ | +| 历史未跟踪脚本/日志/JSON/SQL/xlsx/.env | 全部保留，未删未移 ✔ | +| `git diff --check` | 无空白错误（仅既有 LF/CRLF 提示）✔ | +| `AGENTS.md` | 全仓搜索**未发现** | + +本轮新增（未跟踪）：`docs/acceptance/r01-d4-2-20260916/`（验收脚本与脱敏证据）、`docs/r01-d4-2-independent-mysql-acceptance-20260916.md`（本报告）。未修改任何 D4-1/D4-2 生产代码、未修改 V1–V44、未新增 Flyway/表/索引/ErrorCode/公网接口。 + +--- + +## 2. 独立代码审查 A1–A6 + +方法：9 个并行静态审查维度 + 对每条 critical/major 发现的对抗性复核（20 个独立子代理，全部复核结论为「发现成立」），另由本人逐条打开源码亲自确认关键项。 + +### A1 三个 GET 是否真正只读 —— **通过** + +- `CandidateScoringEngineService.java:52 / :61 / :106` 三个方法均为 `@Transactional(readOnly = true)`。 +- 三个方法体内仅含 `LocalDateTime.now(clock)` + `calculator.computeAll(...)` + 只读仓储/`JobService.getJob` 查询 + DTO 组装，无任何写语句。 +- `git diff HEAD -- .../CandidateScoringEngineService.java` 全部改动仅为 3 处注解变更 + 删除 3 行 `calculator.upsertSnapshots(...)`。 +- `CandidateScoringCalculator.computeAll`（`:122-146`）只含 `findById` + 6 个纯 SELECT（`queryApps/queryAudit/queryOffers/queryFeedback/queryResume/queryMessages`），无写路径；全 main 源码中 `upsertSnapshots` 已无生产调用方。 +- `explanation/` 包 grep `jdbc|Repository|EntityManager|@Transactional|save(` 无命中。 +- 响应仍来自实时 `computeAll`；`status`（`CandidateOverviewStatusPolicy`）、`weight`（`DEFAULT_WEIGHT = 12.50`）、`rulesVersion`（`currentRulesVersion()`）与 D4-1 前逐字节一致。 +- 企业授权校验（company→job 归属）保留，越权负例实测 403。 + +遗留（非缺陷，记录）：`CandidateScoringCalculator.java:582` javadoc 仍写「普通物化入口（含 GET 兜底）」，与 GET 兜底已删除的现状不符（注释陈旧）。 + +### A2 写侧登记覆盖 —— **不通过（存在两处真实遗漏）** + +任务书列出的 8 个服务方法**全部正确接入**，且均为同事务 `REQUIRED` 登记： + +| 服务.方法 | 登记位置 | +|---|---| +| `ProfileService#updateProfile` | `ProfileService.java:75` | +| `ResumeVersionService#createVersion / updateVersion / deleteVersion` | `ResumeVersionService.java:71 / :163 / :189` | +| `PreferenceService#savePreferences` | `PreferenceService.java:76` | +| `AbilityAttemptService#submit` | `AbilityAttemptService.java:294` | +| `ApplicationService#apply / withdraw / updateStatus` | `ApplicationService.java:90 / :129 / :224` | +| `OfferService#transitionStatus` | `OfferService.java:304` | +| `CandidateFeedbackService#createFeedback` | `CandidateFeedbackService.java:82` | +| `MessagingService#sendMessage`（仅 STUDENT） | `MessagingService.java:197-200` | + +角色判定核实：`MessagingService.java:197-200` 用 `u.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT)`，只有学生发送者登记，企业发送者不登记 ✔ + +**遗漏一：Offer 自动过期不登记（major，命中 FAIL 判据)** + +- `OfferExpiryWorker.java:41 expireOne(...)` 在 `:48` 直接 `offer.setStatus(OfferStatus.EXPIRED.name())` 后 `saveAndFlush`，**全文 `requestRefresh`/`scoringRefresh` 出现次数 = 0**。 +- 调用方为定时任务 `OfferExpiryService.java:34 worker.expireOne(...)`，不经过 `OfferService#transitionStatus`。 +- 同一行 `:59` 还调用 `counterOfferRepository.expirePendingByOfferId(...)`，`:68 notifyExpired(saved)`。 +- 该写入**直接影响评分输入**：`CandidateScoringCalculator.java:188-194 queryOffers` 的 SQL 为 + `SELECT SUM(CASE WHEN status='ACCEPTED' THEN 1 ELSE 0 END), SUM(CASE WHEN status='EXPIRED' THEN 1 ELSE 0 END) FROM offers WHERE candidate_id = ?`，`EXPIRED` 计数参与 INTEGRITY 维度。 +- `docs/r01-d4-get-scoring-snapshot-migration-design.md:105` 明确要求「Offer 状态变化 → Offer 状态机成功提交后 → 标记待刷新」，而 D4-1 报告「明确未接入」清单（§12，`:43`）**并未**把 Offer 自动过期列为有意不接入项 —— 属实现遗漏。 + +**遗漏二：候选人反馈的修改/删除不登记（major，命中 FAIL 判据）** + +- `CandidateFeedbackService.java:107 updateFeedback(...)` 与 `:124 deleteFeedback(...)` 均未调用 `requestRefresh`；仅 `:82 createFeedback` 登记。 +- 评分读取该表：`CandidateScoringCalculator.java:196-200 queryFeedback` 的 SQL 为 + `SELECT COUNT(*), COALESCE(AVG(rating),0) FROM candidate_feedback WHERE student_user_id = ?`。 +- 修改 `rating` 会改变 `AVG`，删除反馈会同时改变 `COUNT` 与 `AVG`，两者都不触发刷新。 +- 设计文档 `:106` 明确要求「候选人反馈创建/**修改**的真实写入口」触发刷新 —— 属实现遗漏。 + +**遗漏三：`ResumeVersionService.createVersion` 的事务边界不对称（major）** + +- `ResumeVersionService.java:71` 的登记位于 `createVersion` 的 `@Transactional` 内（REQUIRED，加入外层事务）； +- 但版本行由 `versionWriter.saveNewVersion(...)`（`@Transactional(REQUIRES_NEW)`，文件内 javadoc `:52-55` 自述「写入成功即独立提交，外层事务回滚不会让版本行消失」）**独立提交**； +- 因此存在窗口：版本行已提交、外层事务在提交阶段失败 → **业务数据已落库但刷新任务登记丢失**。 + +其余 A2 结论：登记不触发线程内重算、不发 RabbitMQ、不写通知、不写审计、不记录敏感值 —— 全部成立。 + +### A3 唯一快照 Writer —— **通过** + +- `CandidateScoringSnapshotWriter.java:105-112`：`score / status / sub_scores_json / weight / rules_version` 全部相同则 early return，**不改 version 与 updated_at** ✔ +- `calculated_at` 不参与变化判定 ✔ +- `rules_version` 参与判定，变化必推进 version ✔ +- `canonicalJson`（`:183-214`）对 ObjectNode 递归按字典序重排、对 ArrayNode 逐元素递归 ✔ +- 并发安全：`:91-98` 先 `INSERT ... ON DUPLICATE KEY UPDATE id=id`，`:126-137` 再 `SELECT ... FOR UPDATE`，`:113-119` 条件更新 `WHERE id=? AND version=?`，冲突抛 `OptimisticLockingFailureException` —— 无 JVM 锁 ✔ +- Governance 强制路径 `:66-69 upsertForcingVersion` → `:75-88` 无条件 `version=version+1`；调用方 `CandidateScoringGovernanceService.java:294` 保持 `afterVersion = beforeVersion + 1` 语义 ✔ +- 普通物化不写 `candidate_scoring_snapshot_history` ✔（黑盒已证，见 §10） +- 单维写失败整体回滚：`upsertIfChanged`（`:51-60`）为单一 `@Transactional` 循环，`CandidateScoringRefreshTaskExecutor.materialize` 同为单个 `REQUIRES_NEW` —— 无部分提交 ✔ + +### A4 Worker 与失败恢复 —— **不通过（两处独立缺陷）** + +- `claim`（`:43-62`）、`materialize`（`:64-89`）、`recordFailure`（`:91-108`）、`recoverStale`（`:29-41`）分属 4 个独立 `REQUIRES_NEW` 事务 ✔ +- 并发领取唯一：`claim` 的 `WHERE id=? AND status IN ('PENDING','RETRY') AND (next_attempt_at IS NULL OR next_attempt_at <= ?)` + `updated != 1 → null` ✔（真实 MySQL 集成测试亦覆盖） +- `last_error_code` 只写固定分类（`WRITE_FAILED`/`COMPUTE_FAILED`/`UNKNOWN_REFRESH_FAILURE`/`WORKER_TIMEOUT`），`:82` 的 `log.warn` 只记录 taskId 与 category ✔ +- PROCESSING 超时回收、达上限转 FAILED ✔ + +**缺陷一：`materialize` 的「回到 PENDING」分支缺 version 闸门（major）** + +`CandidateScoringRefreshTaskExecutor.java:78-88`： + +``` +UPDATE ... SET status='COMPLETED' ... WHERE id=? AND status='PROCESSING' AND version=? -- 有闸门 +if (completed == 0) { + UPDATE ... SET status='PENDING' ... WHERE id=? AND status='PROCESSING' -- 无闸门 +``` + +当原 Worker 因超时已被 `recoverStale` 置为 RETRY/FAILED 并被另一个 Worker 重新领取（处于 PROCESSING）后，慢的原 Worker 返回时 `version` 不匹配走 PENDING 分支，会**把新 Worker 正在处理的任务改回 PENDING**；随后新 Worker 完成时 `completed=0`、`pending=0` → 抛 `IllegalStateException`。 + +**缺陷二：失败记录异常会打断同批任务（major）** + +`CandidateScoringRefreshWorker.java:77-86` 的 `catch (Exception e)` 块内调用 `taskExecutor.recordFailure(...)`；该方法在 `updated != 1` 时抛 `IllegalStateException`（`TaskExecutor.java:105-107`）。异常在 catch 块内抛出不会被自身捕获，将传播到 `processDue` 的 `for (Long id : due)` 循环（`Worker.java:63-67`，**循环体内无 try/catch**），导致**同批剩余任务本轮全部不被处理**，违反 `Worker.java:24` javadoc 声称的「异常不回抛，不中断其他任务」。 + +触发前提为物化耗时超过 `processing-timeout-ms`（默认 600000ms），概率低但路径真实。 + +### A5 补偿扫描 —— **通过** + +- 游标持久化于 `candidate_scoring_refresh_scan_checkpoints`（`:79-85 lockCursor` 用 `SELECT ... FOR UPDATE`），非内存字段 ✔ +- 单轮预算：`:48` `budget = max(1, min(limit, 500))`，`:98` `LIMIT ?` 绑定同一 `budget` ✔ +- 尾部回绕：`:59` `ids.size() < budget || ids.isEmpty() ? 0 : 末位 id`；`:52-55` 游标已在尾部且空结果时重置 0 重查 ✔ +- 游标推进与任务登记同事务：`scanDueStudents` 为 `@Transactional`，`requestService.requestRefresh` 为 `REQUIRED` ✔ +- 多实例串行：checkpoint 行 `FOR UPDATE` ✔ +- 查询预算：1 次聚合查询（`findEligibleAfter`）+ ≤budget 次 upsert，无逐用户 N+1 ✔ +- 不直接写 `candidate_dimension_scores` ✔ + +### A6 配置 —— **通过（无断档）** + +- `application.yml:156` `enabled: ${SCORING_REFRESH_ENABLED:true}`，`:158` `compensation-enabled: ${SCORING_REFRESH_COMPENSATION_ENABLED:true}` —— **生产默认启用** ✔ +- `application-test.yml:23-26` / `application-integration-test.yml:37-40` / `application-mysql-it.yml:26-29` 三处均显式 `enabled: false` + `compensation-enabled: false` ✔ +- 不依赖测试 profile 才能工作 ✔；Scheduler `@Value` 的 `:false` fallback 仅在该键完全缺失时生效，yml 提供 `true` 时实际生效值为 `true`（黑盒已验证补偿扫描确实运行）✔ + +遗留（记录）：`CandidateScoringRefreshScheduler.java:15` javadoc 仍写「默认关闭」，与现状相反。 + +--- + +## 3. Docker / MySQL / Redis / RabbitMQ 版本与状态 + +| 组件 | 版本 | 地址 | 验收前 | 验收中/后 | +|---|---|---|---|---| +| Docker Engine | 29.6.2 | — | 已启动 | 未停止 ✔ | +| MySQL | **8.4.11** | 127.0.0.1:3307 | Exited(137) | healthy ✔ | +| Redis | 7.4-alpine | 127.0.0.1:6379 | Exited(0) | healthy ✔ | +| RabbitMQ | 3.13-management-alpine | 127.0.0.1:5672 / 15672 | Exited(137) | healthy ✔ | + +启动方式：`docker compose --env-file backend-infra/.env -f backend-infra/compose.yaml up -d`（仅使用项目既有 Compose）。未执行 `down -v`、未删除/重建 volume、未修改 `compose.yaml`、未新建业务数据库、未打印凭据。 + +volume 清单（`backend-infra_mysql_data` / `_redis_data` / `_rabbitmq_data`）与验收前一致，未删除。 + +--- + +## 4. V44 Flyway 与 schema validation（真实 MySQL） + +启动最新 JAR 前：`flyway_schema_history` 中 `max(version)=43`、`COUNT(*)=43`、V44 行数 0、V44 表不存在 —— 与「尚未执行 V44」的基线预期一致。 + +启动后： + +| 项 | 值 | +|---|---| +| `version` | **44** ✔ | +| `description` | `candidate scoring refresh tasks` | +| `type` | `SQL` ✔ | +| `success` | **1** ✔ | +| V44 行数 | **1**（唯一）✔ | +| `success=0` 的迁移数 | **0** ✔ | +| `max_version` / 总迁移数 | 44 / 44 ✔ | + +启动日志：`Started MyDreamjobApplication in 15.425 seconds`；主 profile 为 `default`；`ddl-auto=validate` 通过，**无 schema validation / SQL 语法 / Bean 装配错误**。 + +表结构（`SHOW COLUMNS`/`SHOW INDEX`）： + +- `candidate_scoring_refresh_tasks`：13 列 `id, student_user_id, target_period(7), status(20), requested_at, processing_started_at, processed_at, next_attempt_at, attempts, last_error_code(40), version, created_at, updated_at` ✔ 状态/重试/租约/version/时间字段齐全 +- 唯一键 `uk_refresh_task_student_period (student_user_id, target_period)` ✔ +- 领取索引 `idx_refresh_task_claim (status, next_attempt_at)` ✔ +- 约束齐全：`PRIMARY`、`uk_refresh_task_student_period`(UNIQUE)、`fk_refresh_task_student → users(id) ON DELETE CASCADE`、`ck_refresh_task_status CHECK (status IN ('PENDING','PROCESSING','RETRY','COMPLETED','FAILED'))` ✔ +- `candidate_scoring_refresh_scan_checkpoints`（`scan_key` PK, `last_user_id`, `version`, `updated_at`）存在 ✔ + +V1–V43 全程未修改 ✔ + +--- + +## 5. 最新 JAR 启动与健康检查 + +- JAR：`mydreamjob-server/target/mydreamjob-server-0.0.1-SNAPSHOT.jar`（`mvn clean verify` 产出，82,440,778 bytes） +- 启动方式：`docs/acceptance/r01-d4-2-20260916/start-app.ps1`，显式提供 `DB_URL=127.0.0.1:3307`、`REDIS_HOST/PORT`、`RABBITMQ_*`、`SMS_MOCK_ENABLED=true`、`SCORING_REFRESH_*`；未修改 `application.yml` +- 验收前 8080/8081 空闲；验收后已全部释放（无 java 进程残留） +- `GET http://127.0.0.1:8080/api/v1/health` → **200** ✔；`http://127.0.0.1:8081/actuator/health` → **200** ✔ +- 启动耗时 14.9–15.4s，Flyway 成功，validate 成功 + +**实例使用（方案 A）**：三个实例互斥启动、PID 各自记录： + +| 用途 | PID | REFRESH | 说明 | +|---|---|---|---| +| 只读验证 #1 | 24624（失败，见下） / 22640（dev profile 失败） / **12656** | false | 三个目标 GET 零写验证 | +| 物化验证 | **23436** | true | 写侧链路 + 补偿扫描 | +| 只读验证 #2 | **28456** | false | 消费者回归 + 零写 | +| 重启验证 | **6576** | true | 跨重启游标延续 | + +启动调试记录（自我暴露，如实记录）：首次启动因 `application-dev.yml` 硬编码短密钥覆盖环境变量而失败；修正为默认 profile 后又因**脚本以 UTF-8 无 BOM 保存、PowerShell 5.1 按 ANSI 解码中文注释导致换行被吞、`JWT_ACCESS_SECRET` 赋值行被并入注释**（诊断值为 `ACCESS_LEN=0`）而失败；加 BOM 后 `ACCESS_LEN=48` 正常启动。此为验收脚本自身缺陷，与产品无关。 + +--- + +## 6. 自动化实际测试数 + +| 命令 | 结果 | +|---|---| +| 定向批次一（8 个 D4 核心类） | **55 / 55**，F=0 E=0 **S=0**，BUILD SUCCESS（49.3s） | +| 定向批次二（`*CandidateScoring*Test,*Competition*Test,*ScoringDashboard*Test,*FairnessMonitoring*Test`） | **253 / 253**，F=0 E=0 **S=0**，BUILD SUCCESS | +| `mvn clean verify` | **2131 / 2131**，Failures=0、Errors=0、**Skipped=0**，BUILD SUCCESS（4:08，211 个测试类） | +| `python docs\verify_openapi.py` | **paths: 176 / operations: 214**，All checks passed ✔ | + +批次一逐类：`CandidateScoringRefreshInfrastructureTest` 13/13、`CandidateScoringRefreshFailureTransactionTest` 3/3、**`CandidateScoringRefreshMySqlIntegrationTest` 6/6（20.13s，真实 MySQL Testcontainers）**、`CandidateScoringEngineServiceTest` 14/14、`R01D4GetWritesSnapshotEvidenceTest` 5/5、`CandidateScoringPersistenceIntegrationTest` 3/3（17.51s）、`V38AbilityRankingIntegrationTest` 1/1、`CandidateScoringClockConsistencyTest` 10/10。 + +**Q01 与 V44 的 MySQL Testcontainers 用例真实执行**（耗时 20.1s / 17.5s 表明容器真实启动），Docker 全程可用，**无因环境缺失导致的 skip**。 + +--- + +## 7. 三个目标 GET 与趋势 GET 的真实 HTTP 结果 + +前提：被测实例 `SCORING_REFRESH_ENABLED=false`（后台 Worker 与补偿扫描关闭），因此任何表变化都只能来自 HTTP 请求本身。 + +每个接口连续调用 **3 次**，共 12 次真实 HTTP： + +| 接口 | HTTP | 契约 | 敏感字段 | +|---|---|---|---| +| `GET /api/v1/profile/me/candidate-scoring` ×3 | 200,200,200 | 稳定（10 字段） | 无泄露 | +| `GET /api/v1/profile/me/candidate-scoring/dimensions/EDUCATION` ×3 | 200,200,200 | 稳定（17 字段） | 无泄露 | +| `GET /api/v1/company/candidates/86/scoring` ×3 | 200,200,200 | 稳定（6 字段） | 无泄露 | +| `GET /api/v1/profile/me/candidate-scoring/trend?months=6` ×3 | 200,200,200 | 稳定（3 字段） | 无泄露 | + +- 响应不含 `phone` / `email` / `resumeUrl` / `storagePath` / `accessToken` / `refreshToken` / `passwordHash`，正则扫描无 11 位手机号。 +- **S1 零写验收：PASS=24 / FAIL=0 / SKIP=0** + +--- + +## 8. GET 前后逐字段数据库快照 + +快照覆盖 **22 张表**（显式列、稳定 `ORDER BY` 全列、逐行比对）。敏感列（手机号/邮箱/Token 摘要/文件路径/IP/UA/幂等键）以 `SHA2(...,256)` 参与比对以保持逐行可区分且不落真实值；非敏感列保留原始值。列不存在时 SQL 直接报错（不 catch）。 + +**结果：22 张表逐字段零变化** ✔ + +| 关键表 | 行数 | 结果 | +|---|---|---| +| `candidate_dimension_scores` | 88 | 零变化 ✔ | +| `candidate_scoring_refresh_tasks` | 2 | 零变化 ✔ | +| `candidate_scoring_refresh_scan_checkpoints` | 0 | 零变化 ✔ | +| `audit_logs` | 2620 | 零变化 ✔ | +| `notifications` | 158 | 零变化 ✔ | +| `messages` | 8 | 零变化 ✔ | +| `candidate_scoring_snapshot_history` | 4 | 零变化 ✔ | + +**最强证据**：该只读实例下，验收学生 A（userId 8002）的 `candidate_dimension_scores` 在多次 GET 后仍为 **0 行** —— 若 D4-2 前行为（GET 兜底写快照）仍存在，此处必为 8 行。同时任务表存在 1 行 `PENDING` 任务，证明写侧登记已发生但后台物化被正确关闭。 + +**反证（扫描器有效性）**：`snap.selftest()` 对内存中的一行仅改动单个字段，扫描器正确检出 `[('1', [('b','y','Z')])]` → PASS。 + +--- + +## 9. 写侧事件 → 任务 → Worker → 快照的真实链路 + +前提：物化实例 `SCORING_REFRESH_ENABLED=true`，`worker-interval=1500ms`。 + +**S2 结果：PASS=14 / FAIL=0 / SKIP=0** + +| 项 | 实测 | +|---|---| +| W1 `PUT /profile/me`（资料更新） | st=200；任务恰好 1 条 `(8002, 2026-09)`；**Worker 0.7s 处理为 COMPLETED**；`last_error_code` 为空；**八维快照齐备（8 行）**；`rulesVersion` 全部 `candidate-scoring-v0.1` | +| 同事务登记 | 请求成功后立即出现任务行，无需等待 | +| W2 `PUT /profile/me/preferences` | st=200 → COMPLETED → 八维仍 8 行（**无部分写**） | +| W3 `POST /applications` | st=409（本轮已投递，幂等）→ 仍合并为 1 条任务 | +| 重复同一事件 ×3 | 仍只有 1 条任务，`requested_at` 推进不新增 | +| **完全相同输入重放** | 八维 version 全等（`ABILITY:0, ACTIVITY:0, COMPLIANCE:1, EDUCATION:1, GROWTH:0, INTEGRITY:0, INTERNSHIP:0, STABILITY:0`）→ **version 不推进** ✔ | +| `candidate_scoring_snapshot_history` | 4 → 4 **零变化**（普通 Worker 不写历史）✔ | +| `notifications` | 158 → 158 零变化 ✔ | +| `audit_logs` | 2620 → 2620 零变化 ✔ | +| `messages` | 8 → 8 零变化 ✔ | + +**PROCESSING 防丢失**：本项在真实 HTTP 下难以稳定卡住窗口，按任务书允许的方式引用真实 MySQL 并发集成测试 —— `CandidateScoringRefreshInfrastructureTest#requestDuringProcessingIsNotLost` 走真实完成路径 `taskExecutor.claim` → 处理期间新请求 → `taskExecutor.materialize`，断言回到 `PENDING` 而非 `COMPLETED`；`CandidateScoringRefreshMySqlIntegrationTest` 6/6 在真实 MySQL 上覆盖重登记与租约恢复。写侧正常主链路（W1/W2/W3）**未跳过**。 + +**源业务失败不留残留任务**：`CandidateScoringRefreshFailureTransactionTest` 3/3 覆盖外层业务回滚时登记一并回滚 ✔（该项为 H2/集成层证据；A2 中 `ResumeVersionService.createVersion` 的独立提交边界为静态代码发现，见 §2）。 + +--- + +## 10. 重复登记与幂等 version + +- 同学生同周期重复登记合并为一行：`:56-71` 的 `ON DUPLICATE KEY UPDATE` 只推进 `requested_at`、`version`，不新增行 ✔（黑盒 W1b 实测 1 行） +- `COMPLETED`/`FAILED` 重新打开为 `PENDING` 且 `attempts` 归零；`RETRY` 回到 `PENDING` 保留 `attempts` ✔（`CandidateScoringRefreshInfrastructureTest#completedTaskCanBeRequestedAgain`） +- `PROCESSING` 期间新事件不丢失：登记保留 `status='PROCESSING'` 并推进任务 `version`；完成时 `version` 不匹配即回退 `PENDING` ✔ +- **幂等物化**：普通物化值完全不变时 `version` 与 `updated_at` 不变（黑盒 W1b 确证）✔ + +--- + +## 11. 租约、重试与失败分类 + +- `recoverStale`（`TaskExecutor.java:29-41`）：`WHERE status='PROCESSING' AND processing_started_at < ?`，置 `RETRY`（或达上限 `FAILED`）、`attempts+1`、`last_error_code='WORKER_TIMEOUT'`、清空 `processing_started_at` ✔ +- `recordFailure`（`:91-108`）：`attempts+1 >= maxAttempts → FAILED` 否则 `RETRY` + `next_attempt_at` 退避 ✔ +- 错误分类为固定字符串，不含异常原文/SQL/堆栈/手机号 ✔ +- 调度兜底：`CandidateScoringRefreshScheduler.java:49-57 / :66-70` 各自 try/catch，单轮失败不影响后续轮次 ✔ +- 真实 MySQL 证据：`CandidateScoringRefreshMySqlIntegrationTest` 6/6（含租约恢复、部分写失败全回滚且同批成功任务不受影响） + +**但**：§2-A4 的两处缺陷（PENDING 分支缺 version 闸门、`recordFailure` 抛出打断 for 循环）表明「同批兄弟任务互不影响」在租约竞争边界下**不成立**。 + +--- + +## 12. 补偿游标、跨重启、单轮预算、多实例 + +参数：`compensation-limit=2`，`compensation-interval=4000ms`。 + +| 验证项 | 实测证据 | +|---|---| +| 单轮登记数 ≤ limit | 连续 12 轮 `created_at` 分组计数**全部为 2**，无一超标 ✔ | +| 游标持久推进 | `last_user_id` 113 → 126 → 130 → 134 → 138 → 142 → 146…，`version` 每轮 +1 ✔ | +| **不会永远只扫首批用户** | 游标推进至 7948 → 7954 → 7963 → 7967 → 7973 → **8002**（接近学生最大 id 8005）✔ | +| **扫到尾部后从头继续** | 8002 之后下一轮 `last_user_id` 回到 **15** → 20 … ✔ | +| **跨重启从持久游标继续** | 重启前 `cursor=113 / version=104`；重启后首轮 `cursor=126 / version=105`（version 恰好 +1）—— **未回到 0** ✔ | +| 只读实例不扫描 | `SCORING_REFRESH_ENABLED=false` 下 `cursor=113/104` 12 秒内完全冻结 ✔ | +| 多实例并发不重复推进 | 代码层 `lockCursor` 的 `SELECT ... FOR UPDATE` 串行化 + 游标推进与登记同事务 ✔（**未做双 JAR 黑盒**，见 §23 SKIP） | +| 每轮查询预算有上限 | 1 次聚合查询 + ≤2 次 upsert，无 N+1 ✔ | +| 不直接写快照 | 扫描器文件内无 `candidate_dimension_scores` 写入 ✔ | + +任务终态：`candidate_scoring_refresh_tasks` 共 181 行，**181/181 全部 COMPLETED**，无 PENDING / RETRY / FAILED / 永久 PROCESSING ✔ + +--- + +## 13. 趋势回归 + +- `GET /profile/me/candidate-scoring/trend?months=6` → 200；当前周期 `2026-09` 存在；`overallScore=65.2`；`rulesVersion=candidate-scoring-v0.1`；维度数 5（趋势按既有语义只收录 `OK`/`ESTIMATED` 维度，非 8 —— 与 `CandidateScoringEngineService.java:91` 的过滤逻辑一致） +- 多次调用结果**逐字节稳定** ✔ +- **请求本身零写**（逐字段比对）✔ +- 能读到后台物化的当前周期快照 ✔（该数据即由 §9 的 Worker 物化产生） + +--- + +## 14. 排名回归 + +- `GET /jobs/47/competition-ranking` → 200；`rank=1`、`cohortSize=2`、`overallScore=65.2`、`percentile=100.0`、`asOfPeriod=2026-09` +- 验收学生（8002）与对照学生（8003）**各有 8 维快照**，排名**未因 GET 停写而缺失候选人** ✔ +- 快照经真实物化入口产生，未直接插入伪造 ✔ +- 只读 ✔ + +--- + +## 15. 企业看板回归 + +| 接口 | 结果 | +|---|---| +| `GET /company/scoring/dashboard/overview` | 200；`companyId=27, totalJobs=1, publishedJobs=1, totalCandidates=2, avgCandidateScore=61.7` | +| `GET .../job-rankings?page=0&size=20` | 200；含验收岗位 47 | +| `GET .../candidate-rankings?page=0&size=20` | 200；`applicationId=86 → overallScore=65.2, percentile=100.0`；`applicationId=87` 亦在列 | +| `GET .../trend?months=6` | 200；`2026-09, avgCandidateScore=61.7, candidateCount=2` | + +- 数据来自物化快照 ✔；多次 GET **零写** ✔ +- 越权负例：企业 B 访问企业 A 的投递评分 → **403** ✔ + +--- + +## 16. 申诉与强制 version 回归 + +- 学生创建隔离申诉 → 200；`appealId=4289`；`dimension=EDUCATION`、`period=2026-09`、`status=PENDING` +- **`scoreAtAppeal=76.00`、`snapshotVersionAtAppeal=1` 均非空** ✔ —— 关键：D4-2 停写后申诉取证仍能取到快照，因为写侧登记 + Worker 已先行物化 +- `GET /profile/me/candidate-scoring/appeals`（我的列表）与 `/appeals/4289`（详情）均 200 ✔ +- `GET /admin/candidate-scoring/appeals` → 200，`total=8`（历史 7 条 + 本轮 1 条）✔ +- 申诉副作用核对：相对上一快照仅 `candidate_scoring_appeals +1`、`candidate_scoring_appeal_history +1`、`audit_logs +1`，**其余表零变化**（含 `candidate_dimension_scores`、`notifications`、`messages`、`snapshot_history`、`refresh_tasks`）✔ +- **未执行**审核/回滚（避免改动非本轮治理数据），因此「rollback 后强制 version 恰好 +1」本项**未做黑盒**，改由 `CandidateScoringCalculatorTest#recomputeAndSnapshot_*` + `CandidateScoringGovernancePersistenceIntegrationTest`（第二批 253/253 内）覆盖，静态确认 `CandidateScoringSnapshotWriter.java:75-88` 无条件 `version=version+1`。见 §23 SKIP。 +- 普通 Worker 物化不写 `snapshot_history` ✔（黑盒 4 → 4） + +--- + +## 17. 公平性监控回归 + +以 ADMIN（复用既有活跃管理员 userId 91，**未恢复 V1_1 旧演示账号 id=1**）调用： + +| 接口 | 结果 | +|---|---| +| `GET /admin/scoring/fairness/overview?period=2026-09` | 200，`basis=CURRENT_STORED_SNAPSHOTS`、`scope=SCORED_SNAPSHOT_POPULATION` | +| `.../dimensions?period=2026-09` | 200 | +| `.../drift` | 200，`availability=UNAVAILABLE, reason=IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE`（既有抑制语义保留） | +| `.../ranking-stability` | 200，`availability=UNAVAILABLE, reason=RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE`（既有抑制语义保留） | +| `.../appeals` | 200，`basis=APPEAL_CREATION_QUEUE_CURRENT_STATE` | + +- 小样本抑制与互补风险抑制保持（以上 `UNAVAILABLE` 即为抑制输出）✔ +- 不泄露候选人身份（响应扫描无 `subjectUserId`/手机号/邮箱）✔ +- 当前快照聚合可用 ✔；GET **零写** ✔ + +--- + +## 18. 数据库副作用 + +**允许的变化（全部落入任务书允许范围）**： + +1. 本轮唯一前缀夹具（创建后已按主键清理，见 §22） +2. 写侧业务请求按契约产生的行（`student_profiles`、`student_preferences`、`applications`、`jobs`、`companies`、`notifications`） +3. **刷新任务与候选人快照**：`candidate_scoring_refresh_tasks` 共 181 行（其中 4 行为本轮学生，其余为补偿扫描按设计登记的其他活跃学生），`candidate_dimension_scores` 相应物化行 +4. `candidate_scoring_refresh_scan_checkpoints` 1 行（游标） +5. 本轮申诉 1 条 + 申诉历史 1 条 + 相应审计 1 条 + +**明确未发生**： + +- 非本轮用户的业务数据（`users`/`companies`/`jobs`/`applications` 等）未被删除或改写 —— 唯一受影响的是其**候选人快照**，且这是启用生产后台补偿扫描后的**设计内正常行为**（任务书明确允许「候选人快照」变化） +- 评分规则、权重、规则版本、排名规则未变 +- `candidate_scoring_snapshot_history` 在**普通 Worker 场景下为零变化**（4 → 4）✔ —— 该表的 4 行历史数据全程未被普通物化触碰 +- 既有历史快照未被改写（version 语义为「变化才 +1」） +- 非本轮审计未变 + +--- + +## 19. RabbitMQ 前后状态 + +队列（vhost `/`）在**验收前**与**验收后**分别查询： + +| 队列 | 验收前 ready/unacked | 验收后 ready/unacked | +|---|---|---| +| `queue.sms.verification` | 0 / 0 | 0 / 0 | +| `queue.notification` | 0 / 0 | 0 / 0 | +| `queue.notification.dlq` | 0 / 0 | 0 / 0 | +| `queue.audit` | 0 / 0 | 0 / 0 | + +4 个队列**真实存在**，终态 ready=0、unacked=0，**D4-2 的 GET、任务登记、Worker、补偿扫描全程未新增任何消息** ✔ + +代码层佐证：`candidatescore/refresh/` 全包对 `rabbit|Rabbit` 的匹配仅出现在 **3 处 javadoc 注释**（「不发送 RabbitMQ」），无任何 `RabbitTemplate`/`convertAndSend`/`NotificationService`/`AuditService` 引用 ✔ + +--- + +## 20. 静态与运行时 OpenAPI + +| 项 | 静态 `docs/openapi-rc.json` | 运行时 `/api/v1/v3/api-docs` | +|---|---|---| +| paths | **176** | **176** | +| operations | **214** | **214** | +| method+path 集合 | — | **完全一致**（`only-runtime=[]`, `only-static=[]`） | + +- `python docs\verify_openapi.py` → `All checks passed!`（含 V36/V37/V39–V43/N02/N07/S02/S03 各项契约校验） +- D4-2 **未新增**公网刷新、任务、补偿、管理接口 ✔ +- 四个评分 GET 响应 schema 不变（S1 实测响应字段集合与既有契约一致）✔ + +--- + +## 21. 日志脱敏 + +扫描对象：本轮 6 个 JAR 日志/err 文件 + 2 个 Maven 测试日志，共 8 个文件。 + +**探针有效性**：临时文件注入 `Authorization: Bearer `、11 位手机号、「验证码 482913」、`DB_PASSWORD=…`，扫描器命中 **5 类** → **[PASS] 扫描器有效**；探针文件已删除 ✔ + +**真实命中与甄别**： + +| 类别 | 命中 | 甄别结论 | +|---|---|---| +| 「口令赋值」 | 63 | **全部为同一模式**：Spring Boot `UserDetailsServiceAutoConfiguration` 启动时打印的 `Using generated security password: `。经字符集核验为大小写十六进制 + 连字符的 UUID，**非数据库口令、非 JWT 密钥、非项目任何凭据**，且项目采用 JWT 认证不使用该内存用户。判定为**误报**。 | +| 11 位手机号 | 1 | 位于 `clean-verify.log`，上下文为既有测试 `AdminBootstrapConcurrencyLoggingTest` 的 **`S03_SCANNER_PROBE_<值>` 扫描器探针**（测试夹具），非真实用户号码 | +| Bearer Token / JWT 形态串 / 验证码语义行 / 密钥赋值 / 私钥块 / 简历存储路径 | **0** | ✔ | + +**应用运行日志（`r01d42-*.log`）中手机号、Token、验证码、JWT、简历路径命中均为 0** ✔ + +报告与本文件均未复制任何真实凭据值。 + +--- + +## 22. 结束处理 + +**进程**：只停止本轮明确记录 PID 的实例（24624/22640/12656/23436/28456/6576），未触碰任何未知 Java 进程。验收后 `Get-Process java` 无输出，8080/8081 端口已释放，恢复至验收前空闲状态。**Docker 未停止**（按任务书要求）。 + +**数据清理**（仅本轮精确主键，无模糊 DELETE）： + +| 表 | 删除前 | 删除后 | +|---|---|---| +| `users`（8002/8003/8004/8005） | 4 | **0** ✔ | +| `companies`（27/28） | 2 | **0** ✔ | +| `jobs`（47） | 1 | **0** ✔ | +| `applications`（86/87）+ `application_status_history` | 2 + 2 | **0** ✔ | +| `candidate_dimension_scores` | 32 | **0** ✔ | +| `candidate_scoring_refresh_tasks` | 4 | **0** ✔ | +| `candidate_scoring_appeals` / `appeal_history` | 1 / 1 | **0** ✔ | +| `student_profiles` / `student_preferences` | 2 / 1 | **0** ✔ | +| `notifications` | 2 | **0** ✔ | +| `auth_tokens` / `user_roles` / `sms_verification_codes` | 6 / 6 / 6 | **0** ✔ | + +清理前做了**归属校验**：4 个用户 id 对应的手机号必须全部等于本轮登记的隔离虚拟号（`phone IN (4 个号码)` 与 `id IN (…)` 双向匹配数均为 4，完全一致），否则脚本 `[ABORT]` 拒绝删除。删除按外键顺序执行（两轮：首轮被 `application_status_history` 阻断后补删）。 + +**保留并登记**：`audit_logs` 中 actor 为本轮 4 个用户的 **15 行** 属 append-only 合规记录，按任务书要求**不冒险删除**，保留在库中。关联 ID：`user_id ∈ {8002, 8003, 8004, 8005}`。 + +**唯一允许的测试夹具（精确 INSERT，已登记）**：`user_roles` 插入 `(8004,'COMPANY')`、`(8005,'COMPANY')` 各 1 行 —— 原因：项目**无任何公网接口**可授予 COMPANY 角色（`CompanyService.java:76 assertCompanyRole` 前置校验，角色仅由管理员初始化产生），企业创建因此返回 403。该 2 行已在 §22 清理中随 `user_roles WHERE user_id IN (…)` 一并删除。 + +**Git 收尾**：分支 `refactor/r01-structure-performance`；暂存区空；未 `git add -A`；未 commit；未 push；V1–V43 未修改；V44 仍为唯一新增迁移；无删除文件；`git diff --check` 无空白错误。未进入下一项 R01 工作。 + +--- + +## 23. PASS / FAIL / SKIP 清单 + +### PASS + +1. Git 基线（分支/HEAD/暂存区/V1–V43/V44/无删除/无空白错误） +2. A1 三个 GET 真正只读（代码 + 真实 HTTP 双证） +3. A3 唯一 Writer 语义（幂等 version / canonical JSON / 并发锁 / 强制版本 / 不写 history / 整体回滚） +4. A5 补偿扫描（持久游标 / 单轮预算 / 尾部回绕 / 同事务 / 不写快照） +5. A6 配置无断档（生产默认启用，测试 profile 显式关闭） +6. Docker/MySQL 8.4.11/Redis/RabbitMQ 全部 healthy +7. V44 在真实 MySQL 成功（version=44, success=1, 唯一, failed=0） +8. `ddl-auto=validate` 通过，无 schema/SQL/Bean 装配错误 +9. 最新 JAR 正常启动；健康检查 8080/8081 均 200 +10. `mvn clean verify` **2131/2131**，F=0 E=0 **S=0** +11. 定向批次一 55/55、批次二 253/253（MySQL Testcontainers 真实执行） +12. **三个目标 GET 真实零写**（22 张表逐字段不变；学生快照保持 0 行） +13. 写侧事件 → 任务 → Worker → 八维快照全链路（W1/W2/W3） +14. 重复登记合并 + 完全相同输入重放 version 不推进 +15. 普通 Worker 不写 `snapshot_history`、不写通知/审计/RabbitMQ +16. 补偿游标跨重启延续、单轮严格 ≤ limit、尾部回绕 +17. 趋势回归（可读物化快照、稳定、零写） +18. 排名回归（cohortSize=2、双学生均有快照） +19. 企业看板回归（4 端点在列、越权 403） +20. 申诉回归（取证字段非空、副作用限于契约表） +21. 公平性监控回归（5 端点、抑制语义保留、零写） +22. RabbitMQ 终态 4 队列 ready=0/unacked=0 +23. 静态与运行时 OpenAPI 均 176/214 且集合完全一致 +24. `git diff --check`、OpenAPI 静态校验、日志脱敏（探针有效，应用日志 0 泄露） +25. 隔离数据精确清理，无残留 + +### FAIL（4 项） + +| # | 缺陷 | 位置 | 命中判据 | +|---|---|---|---| +| F1 | **Offer 自动过期改变评分输入但不登记刷新任务** | `offer/OfferExpiryWorker.java:48`（登记计数=0）；评分读取 `candidatescore/CandidateScoringCalculator.java:188-194` | 「写侧成功但任务未登记」 | +| F2 | **候选人反馈的修改/删除改变评分输入但不登记刷新任务** | `feedback/CandidateFeedbackService.java:107`、`:124`（仅 `:82` 创建时登记）；评分读取 `CandidateScoringCalculator.java:196-200` | 「写侧成功但任务未登记」 | +| F3 | **`createVersion` 登记与独立提交的版本行事务边界不对称** | `resume/ResumeVersionService.java:71`（外层事务）vs 同文件 `:52-55` 自述的 `REQUIRES_NEW` 独立提交 | 「源事务失败却留下任务」的对偶形态：数据已提交而登记丢失 | +| F4 | **测试断言弱化（红线：禁止修改或放宽既有测试）** | `test/.../candidatescore/CandidateScoringCalculatorTest.java:248` 起，ABILITY 溯源 payload 的敏感字段黑名单断言（`answerKey/questionCode/competencyTag/stem/selectedOptionId/scoringRule/awardedScore/explanation/phone/email` 共 10 项）被删除，**无等价替代** | 「修改或放宽既有测试」 | + +### FAIL（次生，A4，未单独计入但需一并整改） + +| # | 缺陷 | 位置 | +|---|---|---| +| F5 | `materialize` 的「回到 PENDING」分支缺 version 闸门，租约竞争下会把新 Worker 处理中的任务改回 PENDING | `refresh/CandidateScoringRefreshTaskExecutor.java:78-88` | +| F6 | `recordFailure` 在 `updated != 1` 时抛异常，且异常点位于 Worker 的 catch 块内、`processDue` 的 for 循环无保护 → **同批剩余任务本轮全部不处理** | `refresh/CandidateScoringRefreshWorker.java:83` + `:63-67` + `CandidateScoringRefreshTaskExecutor.java:105-107` | + +### SKIP（2 项，均非核心判据） + +1. **多实例并发补偿扫描双 JAR 黑盒**：以代码层 `SELECT ... FOR UPDATE` 串行 + 游标与登记同事务作为证据；未启动第二个 JAR 做真实双实例竞争。 +2. **申诉审核/回滚黑盒**：为避免改动非本轮治理数据（`candidate_scoring_rollback_limits` 等）未执行 rollback，改由 `CandidateScoringCalculatorTest#recomputeAndSnapshot_*` 与 `CandidateScoringGovernancePersistenceIntegrationTest` 覆盖（第二批 253/253 内），静态确认强制 version 路径。 + +### BLOCKED + +无。 + +--- + +## 24. 剩余风险 + +1. **F1/F2 的实际影响受补偿扫描部分缓解**：补偿扫描的资格条件为「近 90 天有投递 **或** 近 30 天有审计」（`CandidateScoringRefreshCompensationScanner.java:89-99`）。有 Offer / 有反馈的学生必有投递，故其快照通常在下一轮扫描（默认间隔 1 小时）内被纠正。但若该学生**近 90 天无投递、近 30 天无审计**，则其快照将**永久停留在过期值**，无任何兜底路径。 +2. **F3 触发概率低但后果不可逆**：仅在事务提交阶段失败时发生，届时业务数据存在而刷新信号永久丢失，且无对账机制可发现。 +3. **F5/F6 触发前提为物化耗时超过 `processing-timeout-ms`（默认 600s）**，正常物化实测 0.7s，概率低；一旦触发，本轮同批任务的其余条目会被静默跳过（下一轮会重试，故不会永久丢失）。 +4. **补偿扫描会物化全库活跃学生的快照**：启用生产后台刷新后，单实例每轮最多 `compensation-limit` 个。本次验收实测 181 条任务、全部 COMPLETED，未观察到异常增长；但该行为对生产库的持续写入量需在容量规划中评估。 +5. **`CandidateScoringRefreshInfrastructureTest` 未验证 8 个写侧 Service 真的调用了 `requestRefresh`**：现有测试直接驱动 `requestService`/`taskExecutor`，各 Service 单测只补了 `@Mock` 依赖而无一处 `verify(...).requestRefresh(...)`。F1/F2 正是这类覆盖盲区的产物，建议本轮整改时一并补齐。 +6. **注释与现实不符（低危）**：`CandidateScoringCalculator.java:582`（「含 GET 兜底」）、`CandidateScoringRefreshScheduler.java:15`、D4-1 报告 §20 的「默认关闭」表述均已过时。 + +--- + +## 25. 是否允许冻结 D4-2 + +**不允许冻结。** + +R01-D4-2 的**核心目标**（三个评分 GET 停写）已在真实 MySQL/HTTP 下确凿达成，且未观察到任何消费端退化或回归。但依据任务书第二十节的 FAIL 判据，F1/F2 命中「**写侧成功但任务未登记**」，F4 触碰「禁止修改或放宽既有测试」红线，因此本轮不可冻结。 + +--- + +## 26. 下一轮定向整改指令 + +### 必做（阻断冻结） + +**R1. 补齐 Offer 自动过期的评分刷新登记** +- 文件：`mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferExpiryWorker.java` +- 方法：`expireOne(Long offerId)`（`:41`），在 `:48 setStatus(EXPIRED)` 成功且 `:51 saveAndFlush` 之后、与该方法**同一 `REQUIRES_NEW` 事务内**，追加： + `scoringRefreshRequestService.requestRefresh(offer.getCandidateId(), LocalDateTime.now(clock))` +- 注入 `CandidateScoringRefreshRequestService`；`OfferExpiryWorker` 已使用 `clock`，`capturedNow` 应复用同一时间源 +- 不得因此改动 `OfferService#transitionStatus` 的既有语义 +- 补测试：真实驱动 `expireOne` 后断言 `candidate_scoring_refresh_tasks` 出现/合并一条 `(candidateId, 当期)` 任务 + +**R2. 补齐候选人反馈修改/删除的评分刷新登记** +- 文件：`mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackService.java` +- 方法：`updateFeedback(…)`（`:107`）与 `deleteFeedback(…)`（`:124`），在各自成功路径末尾、同一 `@Transactional` 内追加 `requestRefresh(app.getStudentUserId(), LocalDateTime.now())`（`deleteFeedback` 注意在删除前先取得 `studentUserId`） +- 与既有 `:82 createFeedback` 保持完全一致的调用形态 +- 补测试：`updateFeedback` 改变 `rating` 后断言任务被登记/合并 + +**R3. 修正 `createVersion` 的登记事务边界** +- 文件：`mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionService.java` +- 问题：`:71` 的登记位于外层事务，而版本行经 `versionWriter.saveNewVersion`（`REQUIRES_NEW`）**独立提交**；外层提交阶段失败会造成「数据已提交、登记丢失」 +- 要求（二选一，须在报告中说明选择理由）： + (a) 将 `requestRefresh` 增补为 `Propagation.REQUIRES_NEW` 的独立调用（放在版本行成功返回之后）；或 + (b) 在 `createVersion` 返回后由调用方在**已提交**的上下文中登记（`TransactionSynchronization#afterCommit`） +- 补测试：模拟外层事务回滚，断言版本行存在时**必定**存在对应刷新任务 + +**R4. 修正 `materialize` 的 PENDING 回退闸门** +- 文件：`mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java` +- 位置：`:78-88` +- 要求：`status='PENDING'` 的回退 `UPDATE` 增加 `AND version=?`（与 claim 时记录的 `claimedVersion` 比对）；`updated != 1` 时应**静默返回**（该任务已被 `recoverStale` 或新 Worker 接管，属正常竞争），不得抛 `IllegalStateException` + +**R5. 隔离单任务失败对同批任务的影响** +- 文件：`mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorker.java` +- 位置：`:63-67`（`processDue` 循环）与 `:83`（catch 内 `recordFailure`） +- 要求：`processDue` 的 for 循环体加 `try/catch`，或让 `recordFailure` 自身吞掉状态冲突异常并仅告警 —— 保证单任务异常不阻断同批其余任务，与 `:24` javadoc 的承诺一致 + +**R6. 恢复被删除的敏感字段断言（红线项）** +- 文件：`mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringCalculatorTest.java` +- 位置：`:248` 起（原 `for (String banned : List.of("answerKey","questionCode","competencyTag","stem","selectedOptionId","scoringRule","awardedScore","explanation","phone","email"))` 断言） +- 要求：在**新的委托架构下重建等价断言** —— 序列化 `CandidateScoringSnapshotWriter` 为 ABILITY 维度生成的 `sub_scores_json`（可通过 `CandidateScoringRefreshInfrastructureTest` 走真实 Writer，或在 Writer 测试中直接断言），并逐项断言不含上述 10 个禁止字段 +- 不得以「类型安全」为由省略：`weights`/`dimensionScores` 为 `Map`，其 key 不受编译期保护 + +**R7. 补齐写侧登记的行为验证** +- 文件：`mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshInfrastructureTest.java` +- 要求：新增断言，对 §A2 的 8 个服务方法 + R1/R2 新接入的两个入口，逐一 `verify(scoringRefreshRequestService, times(1)).requestRefresh(…)`；覆盖**失败回滚不登记**的负例 + +### 建议（不阻断，但应同批处理） + +**R8.** 修正过期注释：`CandidateScoringCalculator.java:582`、`CandidateScoringRefreshScheduler.java:15`，以及 `docs/r01-d4-1-scoring-materialization-implementation-report.md` §13/§20 中「补偿扫描为简化版/默认关闭」的表述。 + +**R9.** 补 `CandidateScoringRefreshInfrastructureTest` 中缺失的黑盒项：多实例并发扫描（双实例 `scanDueStudents` 断言游标不重复推进）、跨重启游标延续的自动化用例（当前仅有本次验收的真实证据）。 + +**R10.** 评估 `getTrend` 的时钟一致性：`CandidateScoringEngineService.java:78` 使用 `LocalDate.now()` 而非注入的 `clock`（预存在问题，非本轮引入）。 + +### 整改后复验要求 + +完成 R1–R7 后，重新执行：`mvn clean verify`（须 ≥2131 且 S=0）、静态与运行时 OpenAPI 176/214、以及本报告 §7/§9/§16 三项真实 HTTP 复核（GET 零写、写侧链路、申诉取证）。R1/R2 需各自提供「事件 → 任务 → COMPLETED → 快照」的真实 MySQL 证据。 + +--- + +## 附：本轮验收产出物（`docs/acceptance/r01-d4-2-20260916/`） + +| 文件 | 说明 | +|---|---| +| `acc_lib.py` | HTTP/DB/登录/前缀公共库 | +| `snap.py` | 22 表显式列快照 + 差异比较 + 自检反证 | +| `p1-provision.py` / `acc-context.json` / `acc-prefix.txt` | 隔离验收数据创建 | +| `s1-zerowrite.py` / `snap-before-get.json` / `snap-after-get.json` | 三个 GET 零写 | +| `s2-writepath.py` | 写侧链路 | +| `s4-consumers.py` / `s4-out.txt` / `snap-after-consumers.json` | 消费者回归 | +| `logscan.py` | 日志脱敏扫描（含探针） | +| `cleanup.py` | 精确主键清理 | +| `start-app.ps1` + `r01d42-*.log/.err.log/.pid/.envdiag.txt` | 实例启动与运行日志 | +| `q01`–`q13*.sql` | 只读 SQL 证据 | +| `runtime-openapi.json` | 运行时 OpenAPI | +| `clean-verify.log` / `batch2.log` | 自动化构建日志 | + +> 本报告不含数据库密码、JWT、验证码、完整手机号或邮箱、`.env` 内容、简历原文或真实存储路径；SQL 片段中无真实敏感参数。验收脚本输出中曾一次性打印隔离虚拟号（`p1-provision.py` 首版缺陷），已当场修正脚本，后续输出与报告均不再包含完整号码。 diff --git a/docs/r01-d4-get-scoring-snapshot-migration-design.md b/docs/r01-d4-get-scoring-snapshot-migration-design.md new file mode 100644 index 0000000..4c3b9b7 --- /dev/null +++ b/docs/r01-d4-get-scoring-snapshot-migration-design.md @@ -0,0 +1,246 @@ +# R01-D4「GET 评分接口写快照迁移方案设计与证据核查」 + +日期：2026-09-16 +分支：`refactor/r01-structure-performance` +HEAD：`b56f792 perf: batch conversation unread counts` +本轮性质：**独立现状核查 + 权威迁移设计**（未实施生产改造） + +## 1. Git 基线 + +- 分支 `refactor/r01-structure-performance`；HEAD `b56f792`；暂存区为空。 +- 迁移目录无任何改动（V1–V43 原样）；`AGENTS.md` 未发现。 +- 已跟踪工作区存在 1 个仅被 Git 工作树元数据标记为修改的文件（`GlobalExceptionHandler.java`）；普通 `git diff` 为空且 blob 与 HEAD 相同。本轮不触碰、不暂存该文件，也不把它计入 R01-D4 交付。 +- 历史未跟踪文件全部保留；未 commit、push。 + +## 2. 当前三个 GET 写库调用链 + +| 端点 | 服务方法 | 调用链 | 事务 | 写入 | 修改字段 | +|---|---|---|---|---|---| +| `GET /profile/me/candidate-scoring` | `CandidateScoringEngineService#getOverview` | computeAll → `upsertSnapshots` → buildOverview | `@Transactional`（默认 rw） | `candidate_dimension_scores` | score、status、sub_scores_json、weight、rules_version、calculated_at、**version+1**、**updated_at=NOW()** | +| `GET /profile/me/candidate-scoring/dimensions/{dimension}` | `#getDimensionDetail` | computeAll → filter → `upsertSnapshots`（单维度） | `@Transactional`（rw） | 同上 | 同上（仅该维度行） | +| `GET /company/candidates/{applicationId}/scoring` | `#getCompanyScoring` | 授权(company/job 归属) → computeAll → `upsertSnapshots` | `@Transactional`（rw） | 同上 | 同上（目标学生 8 行） | +| `GET /profile/me/candidate-scoring/trend` | `#getTrend` | `snapshotRepository.findTrendFrom` 只读 | `@Transactional(readOnly = true)` | **无** | — | + +写库 SQL（`CandidateScoringCalculator#upsertSnapshots`）为原生 `INSERT ... VALUES (...) ON DUPLICATE KEY UPDATE score=VALUES(score), status=..., sub_scores_json=..., weight=..., rules_version=..., calculated_at=..., version=version+1, updated_at=NOW()`。唯一键 `uk_candidate_dim_scores(student_user_id, dimension, period)`（V24 建表、实体 `@UniqueConstraint` 双重声明）。**触发条件为"存在唯一键冲突"即无条件版本自增——即使计算值与上次相同，重复 GET 仍使 version 单调递增、updated_at 改写。** + +## 3. 全部快照写入方 + +| 写入方 | 入口 | 触发 | 是否用户可重复触发 | +|---|---|---|---| +| `CandidateScoringCalculator#upsertSnapshots`（被下三处调用） | — | — | — | +| —— `CandidateScoringEngineService#getOverview` | `GET /profile/me/candidate-scoring` | **GET 读取请求** | 是（任何学生重复刷新） | +| —— `CandidateScoringEngineService#getDimensionDetail` | `GET .../dimensions/{dimension}` | **GET 读取请求** | 是 | +| —— `CandidateScoringEngineService#getCompanyScoring` | `GET /company/candidates/{id}/scoring` | **GET 读取请求** | 是（企业每次查看） | +| `CandidateScoringCalculator#recomputeAndSnapshot` | 见下 | — | — | +| —— `CandidateScoringGovernanceService#decideAppeal`（APPROVE 分支） | `POST /admin/candidate-scoring/appeals/{id}/decision` | 申诉决定 | 否（终态幂等） | +| —— `CandidateScoringGovernanceService#rollback` | `POST .../appeals/{id}/rollback` | 申诉回滚 | 否（回滚限额+终态） | +| ——（趋势/排名/看板不写） | — | — | — | + +## 4. 全部快照消费者 + +| 消费者 | 读取方式 | 依赖字段 | 影响 | +|---|---|---|---| +| `getTrend`（趋势） | `findTrendFrom(student, startPeriod)` | period/score/status/rulesVersion | 只读物化快照；**完全依赖快照** | +| `CandidateScoringGovernanceService#createAppeal` | `findSnapshot` | score（scoreAtAppeal）、**version（snapshotVersionAtAppeal）** | 申诉证据基于快照版本 | +| `decideAppeal/rollback` | `recomputeAndSnapshot` + `snapshotHistoryRepository.save` | before/after 分数与版本 | 申诉决定/回滚重算写新版本 | +| `CandidateScoringSnapshotHistory`（V25 表） | 仅由申诉决定/回滚写入，`getSnapshotHistory` 读取 | version/rulesVersion | 变更审计 | +| `CompetitionRankingCalculator.loadLatestSnapshots` | `findUpToPeriod(students, asOf)` | 最新 period 的 8 维分数 | 竞岗排名用**物化快照**（非实时计算） | +| `CompanyScoringDashboardService` | 读取快照聚合 | score/status | 企业看板/百分位（r01 优化为 CandidatePercentileCalculator） | +| `CareerProgressService` | 读取快照 | 各期分数 | 求职进度 | +| `FairnessMonitoringRepository` | 原生 SQL 按 period 聚合 candidate_dimension_scores + snapshot_history+appeal | score/status/样本数 | 公平性监控（当前快照 + 历史申诉双源） | +| `PersonalDataCollector` | `findByStudentUserId` | 全字段 | GDPR 数据导出 | + +## 5. 真实/集成副作用证据 + +### 5.1 集成证据（H2，本轮新增独立现状证据测试，见 §17） +`R01D4GetWritesSnapshotEvidenceTest` 结果 **5/5 全绿**（未依赖 Docker）： +- 首调 `getOverview`：`candidate_dimension_scores` 新增 **8 行**；重复调用行数保持 8、**version 全部 +1**； +- 单维度 GET：行数不变、version 继续递增； +- trend GET：前后行数/version 完全一致（只读确认）； +- 非法 dimension：校验先于 upsert，**零写入**； +- GET 评分不写 `audit_logs`、`notifications`。 + +证据边界：该类直接调用 Service，并非真实 HTTP/SecurityFilterChain 测试；它证明 overview、dimension、trend 的持久化行为，但**没有覆盖企业评分 GET、无权限、资源不存在、HTTP 响应或 RabbitMQ**。这些项目不得依据该 5/5 结果标为已验证，必须在实施验收中补齐。 + +### 5.2 真实 MySQL 证据 +**BLOCKED**：Docker Engine 本轮不可用（`docker version` 无法连接 Engine），按任务书纪律**不伪造通过**。已在 5.1 提供同级 H2 集成证据；真实 MySQL 行级快照（首/二次 GET 的行数、version、updated_at、返回 JSON 是否变化、错误路径零写、audit/notification/RabbitMQ 无副作用）由 D4-2 阶段实施前用真实 MySQL 补充复验（§12 验收清单已含）。 + +静态代码可直接确认的行为（无需运行）：`upsertSnapshots` 的 `ON DUPLICATE KEY UPDATE ... version=version+1, updated_at=NOW()` 保证重复 GET 必使 version 单调递增、updated_at 刷新；趋势/申诉/监控/看板/排名全部消费该物化快照。 + +## 6. 首次与重复 GET 的行数/version/updated_at + +| 场景 | 行数 | version | updated_at | 返回 JSON | +|---|---|---|---|---| +| 首次 GET overview | 0 → 8 | 0（插入初值） | 写入 NOW() | 完整评分卡 | +| 第二次相同 GET | 8（不变） | **+1（8 行全部）** | **改写为新 NOW()** | 与首次等值（公式确定） | +| 单维度 GET（已有 8 行） | 8（不变） | 该维度行 +1 | 该行改写 | 明细不变 | +| trend GET | 不变 | 不变 | 不变 | 由物化快照导出 | +| 非法 dimension | 不变 | 不变 | 不变 | Service 抛业务异常（H2 已验证） | +| 无权限 / 资源不存在 | 静态代码预期不变 | 静态代码预期不变 | 静态代码预期不变 | **本轮未做真实 HTTP 证据** | + +结论：**"读取放大写入"确凿**——GET 对每次读取强制物化并推进版本，自增 version 不代表业务状态迁移，period 快照语义是"每次读取覆盖值"而非"首次值/最新值"。 + +## 7. trend 的现有依赖 + +`getTrend` 只读 `candidate_dimension_scores`（`findTrendFrom`，period>=start 升序）。它**不**调用 computeAll/upsert，因此**完全依赖**由其他路径（当前主要是三个 GET + 申诉重算）持续写入的快照。若直接删除 GET upsert 而未建立写侧物化，趋势将冻结在最后一次写入时刻。 + +## 8. 申诉、回滚与公平性监控依赖 + +- 申诉创建：`findSnapshot(student, dimension, period)` 读取当前行，固化 `scoreAtAppeal` 与 `snapshotVersionAtAppeal`（写入 `candidate_scoring_appeals`）。若快照过期，申诉取证基于旧版本。 +- 申诉决定（APPROVE）：`recomputeAndSnapshot` 重算写新版本 + 写入 `candidate_scoring_snapshot_history`（before/after score、version、rules_version）。 +- 回滚：同决定路径，另扣 `candidate_scoring_rollback_limits`。 +- 公平性监控：`FairnessMonitoringRepository` 两条原生聚合：`candidate_dimension_scores WHERE period=?` 按学生分组（overview/dimensions 用），以及 `candidate_scoring_snapshot_history JOIN appeal`（appeals 用）——**当前快照 + 历史申诉双源**。 +- 申诉期间快照若被外部 GET 再次覆盖（version 再 +1），`snapshotVersionAtAppeal` 不再等于当前版本——审计可辨，但"申诉取证与当前快照差 version"是现状语义的一部分，迁移时不得破坏。 + +## 9. 写侧事件矩阵（按计算器真实数据源） + +| 评分输入变化 | 计算器读取证据 | 推荐刷新入口 | 处理方式 | 备注 | +|---|---|---|---|---|---| +| 学生资料更新 | `StudentProfileRepository`：学历、学校、技能及资料完整度 | `ProfileService#updateProfile` 成功提交后 | 标记学生快照为待刷新 | 仅实际影响字段变化时触发 | +| 多版本简历变化 | `resume_versions` ACTIVE 数量与 MAX(updated_at) | `ResumeVersionService#createVersion/updateVersion/deleteVersion` 成功提交后 | 标记待刷新 | `setDefault` 是否影响评分需按 SQL 判断；当前 SQL 不读取默认标记，不应无条件触发 | +| 求职偏好更新 | `StudentPreferenceRepository` | `PreferenceService#savePreferences` 成功提交后 | 标记待刷新 | 影响 COMPLIANCE | +| 能力测评结果完成 | `AbilityAssessmentScoreSource#findLatestValidCompletedResult` | `AbilityAttemptService#submit` 成功提交后 | 标记待刷新 | `saveAnswers` 尚未形成完成结果，不应刷新 | +| 投递创建/撤回 | applications 数量、WITHDRAWN 数、近 90 天数量 | `ApplicationService#apply/withdraw` 成功提交后 | 标记待刷新 | 企业侧状态更新只有在实际改变计算器读取字段时才触发；当前聚合只区分 WITHDRAWN | +| 登录及审计活动 | audit_logs 近 30 天数量与 LOGIN 数 | 统一审计写入成功后或补偿扫描 | 优先脏标记/补偿 | 入口很多，不能逐 Controller 机械接入 | +| Offer 状态变化 | offers 中 ACCEPTED/EXPIRED 数量 | Offer 状态机成功提交后 | 标记待刷新 | 原报告遗漏 | +| 候选人反馈变化 | candidate_feedback 数量与 AVG(rating) | 候选人反馈创建/修改的真实写入口 | 标记待刷新 | 不是 `JobReviewService`；原报告混淆了两类评价 | +| 学生发送消息 | messages.sender_user_id 数量 | 消息发送成功提交后 | 标记待刷新 | 撤回不改变总消息数，按现公式无需刷新 | +| 账户创建时间 | users.created_at | 无日常写入口 | 初次物化/补偿扫描 | 时间本身不变 | +| 申诉决定/回滚 | 已有 `GovernanceService#decideAppeal/rollback` | 保持现有合法写侧 | 同事务 | 不与普通刷新事件混用历史审计语义 | +| rulesVersion 或时间窗口跨界 | rulesVersion、90/30 日窗口、能力结果有效期 | 发布批次及定时补偿扫描 | 批处理 | 即使没有业务写事件，分数也会随时间变化，因此仅靠事件触发不完备 | + +明确排除：当前 `computeAll` **不读取 RIASEC 结果、面试评分或岗位评价**，不得为这三类入口增加刷新；传统 `ProfileService#uploadResume` 的文件字段也不是 `queryResume` 的数据源，除非同时改变资料完整度实际依赖字段，否则不应触发。 + +现状结论：除申诉决定/回滚外，真实输入源缺少统一物化机制；同时存在时间窗口自然变化，因此“把若干 Service 同步调用 refresh”仍不能证明覆盖 100%。 + +## 10. 三个迁移选项比较 + +| 维度 | 方案 A：同步写侧触发 | 方案 B：事务提交后异步刷新 | 方案 C：脏标记+定时物化 | +|---|---|---|---| +| 一致性 | 强（同一事务） | 最终一致（短窗口） | 最终一致（更长窗口） | +| 事务耦合 | 高（评分写并进业务事务） | 中（分离；核心事务不受失败连累） | 低 | +| 失败恢复 | 回滚即重来，无独立补偿 | 需重试/死信 + 补偿扫描 | 靠定时器重扫，天然补偿 | +| 幂等性 | 唯一键天然幂等（version 语义需调整） | 需幂等键 + 去重 | 需幂等键 + 去重 | +| 并发 | 数据库条件更新兜底 | 需"旧事件不得覆盖新事件"防护 | 需锁/版本比对 | +| 实施范围 | 小（线程内调用）但侵入全部写方法 | 中（需要可靠发布/订阅或 MQ） | 中（脏标记 + 调度器） | +| 对现有 RabbitMQ 依赖 | 无 | **强依赖**（需事务后发布、重试、去重、死信） | 无（可走内置调度） | +| 对趋势/申诉/监控影响 | 不变 | 短窗口内趋势滞后，申诉取证可能取旧版本 | 更明显滞后 | +| 发布/回滚难度 | 低 | 中（MQ 基建变化） | 中（调度器+补偿） | +| 是否需要 Flyway | 否 | 否（建议无） | 否（可选脏标记列则需迁移） | +| 是否新增公网接口 | 否 | 否 | 否 | + +## 11. 唯一推荐方案 + +**分两阶段，先收敛写入口并建立可靠的“待刷新”机制，后让 GET 停写。唯一推荐为方案 C（持久化脏标记/刷新任务 + 定时物化），写侧提交后只登记待刷新任务；物化 Worker 复用唯一计算器和快照 Writer。** + +理由： +1. 不能把评分刷新放入资料、投递、消息等核心业务事务；评分失败不应回滚这些业务，原报告在“同事务”和“失败不影响业务”之间自相矛盾。 +2. 当前 RabbitMQ 没有已验证的事务消息、持久去重和死信恢复链路，不能直接依赖纯异步 MQ。 +3. 评分包含 90/30 日窗口与能力结果有效期，仅靠业务事件不完备，必须有定时补偿。 +4. 幂等键若不持久化就无法跨进程、重启和重试去重；因此原报告“无表结构变更但用 sourceEventKey 去重”不可实现。 +5. 持久任务允许业务事务只做一次轻量 upsert 标记，Worker 失败可重试，不阻塞核心业务；GET 兜底在迁移期保留。 + +## 12. 分阶段实施顺序 + +**D4-1（可靠物化基础设施，GET 兜底保留）** +1. 新增唯一 `CandidateScoringSnapshotWriter`，集中快照差异比较、条件更新和版本规则；申诉专用 history 语义仍由 Governance 管理。 +2. 新增持久化刷新任务/脏标记（需要新的 Flyway，不能再声称“无需迁移”）。唯一键至少覆盖 student + target period；任务记录 requested_at、attempts、next_attempt_at、processed_at/version，不保存敏感评分输入。 +3. §9 的真实输入写侧仅登记任务，不在线程内计算八维评分；时间窗口和 rulesVersion 由定时扫描登记任务。 +4. Worker 在独立事务中领取任务、计算并写快照；失败可重试，成功后原子完成；不得依赖 JVM 锁。 +5. 保持 GET upsert 作为迁移兜底，完成真实 MySQL 并发、重试和覆盖证据。 + +**D4-2（GET 停写）** +1. 三个 GET 改为 `@Transactional(readOnly = true)`，删除 upsert 调用（computeAll 保留用于实时计算响应字段，与物化无关）。 +2. 开启补偿扫描，对时间窗口、rulesVersion 变化以及遗漏任务进行修复；与持久任务幂等协作。 +3. 真实 MySQL 验收：GET 重复请求前后 `candidate_dimension_scores` 完整不变、无 audit/notification/RabbitMQ 副作用、趋势/申诉/监控/排名表现与 D4-1 一致。 +4. 达标后方可切换/废弃 GET 兜底。 + +**阶段切换网关（未满足不得进入 D4-2）**：真实数据源覆盖完整、相同任务重放不造成无效 version 增长、并发领取恰好一次有效物化、失败可重试且不影响原业务提交、时间窗口可由补偿扫描推进、GET 停写后的趋势/申诉/排名/监控真实 MySQL 回归通过。 + +## 13. 并发与幂等设计 + +- **任务幂等键**：持久任务按 `(studentUserId, targetPeriod)` 合并；多次输入变化只需保证至少一次最新状态重算。rulesVersion 是计算结果属性，不用虚构的内存 `sourceEventKey` 充当持久去重。 +- **快照唯一性**：继续使用 `uk_candidate_dim_scores(student_user_id, dimension, period)`。 +- **无效重放**：Writer 比较 score、status、sub_scores_json、weight、rules_version 等业务值；完全相同则不更新 version/updated_at。`calculated_at` 是计算时间，不能单独作为“业务变化”依据，否则每次重算仍会制造版本。 +- **并发/旧任务**：任务不是携带完整旧数据的事件，而是“请按数据库当前状态重算”的合并信号，因此晚到任务只会重新读取最新状态，不会用旧载荷覆盖新快照。 +- **rulesVersion 变化强制刷新**：`rules_version` 参与唯一比较，升级批次以新版本全量重算。 +- **两个输入变化并发**：数据库任务唯一键合并；Worker 使用条件领取/乐观锁或 `SELECT ... FOR UPDATE SKIP LOCKED`，禁止 JVM 本地锁；必要时完成后检测 requested_at 是否在处理期间推进，若推进则保留待处理状态再算一次。 +- **失败重试**：普通输入变化只登记持久任务，实际评分由 Worker 独立事务完成；失败更新重试状态并由补偿扫描兜底。重试不得重复写 `candidate_scoring_snapshot_history`/audit（该表只在申诉决定/回滚写，普通物化不写它）。 +- **申诉期间快照变化**：`scoreAtAppeal/snapshotVersionAtAppeal` 保留申诉创建时刻值；写侧刷新不得改写申诉取证字段；决定/回滚的重算仍走 `recomputeAndSnapshot`（其版本语义与写侧事件在 `calculated_at/rules_version` 条件上一致，回滚目标版本 = beforeVersion+1 的既有确定性逻辑需在 D4-2 复核不冲突）。 +- **回滚后的新输入事件**：允许再次计算——回滚后新事件刷新按正常路径写入新版本，`snapshot_history` 只记录申诉动作，不记录普通事件。 + +## 14. 失败恢复策略 + +- 写侧业务事务只 upsert 持久刷新任务；任务登记失败应随该业务事务回滚，避免提交了源数据却永远没有刷新信号。评分计算不在核心业务事务中执行。 +- Worker 独立事务执行，失败记录 attempts/next_attempt_at 并指数退避；超过阈值保留 FAILED/PENDING 状态供告警和补偿，不伪装成功。 +- 定时补偿根据活跃用户、时间窗口与 rulesVersion 登记任务，不直接绕过 Writer 写快照。 +- 最终一致性：允许短暂滞后（分钟级），趋势/监控为展示性质；申诉取证在写侧事件刷新后基于新版本，行为与现状一致（现状也是"最新一次写入者胜"）。 + +## 15. 数据迁移与兼容策略 + +- `candidate_dimension_scores` 本身优先保持结构不变；D4-1 需要新增持久刷新任务表及唯一/领取索引，因此必须新增下一号 Flyway（不得修改 V1–V43）。具体表设计在实施前独立评审。 +- 现有存量数据：保留；D4-2 上线前对活跃学生做一次全量 `upsert` 对齐（事件覆盖前不删 GET 兜底，因此存量自然收敛）。 +- version 语义从"每次读取递增"收敛为"每次**有效变更**递增 + rulesVersion 升级递增"；历史 version 不重写。 +- 趋势/申诉/监控/排名/导出读取代码零改动。 + +## 16. 下一轮（D4）精确修改文件清单（预估，实施前以代码现状复核） + +- 新增：`candidatescore/CandidateScoringSnapshotWriter.java`、刷新任务实体/Repository/Worker/调度器，以及下一号 Flyway（具体命名先核对迁移目录最大版本）。 +- 修改（仅写侧事件化，不改变业务语义）： + - `profile/ProfileService.java`、`resume/ResumeVersionService.java`、`preference/PreferenceService.java` + - `ability/AbilityAttemptService.java`、`application/ApplicationService.java` + - Offer、候选人反馈、消息与审计的真实写入 Service（实施前精确定位） + - `candidatescore/CandidateScoringCalculator.java`（upsert 委托 + 条件 version 递增） +- **D4-2 才改**：`candidatescore/CandidateScoringEngineService.java`（三 GET 改为 readOnly 并移除 upsert 调用）。 +- 文档：`docs/backend-development-roadmap.md`（本报告结论）、`docs/candidate-scoring-api.md`（若契约文字涉及写语义）。 +- **允许且预计需要新增**一个 Flyway、刷新任务表及必要索引；仍不新增 ErrorCode 和公网接口。 + +## 17. D4 必须先写的失败测试（D4 实施轮的第一批测试，用于驱动实现） + +1. `GET 重复请求前后 candidate_dimension_scores 完整内容不变`（行数/score/status/version/created_at/updated_at 全等）。 +2. 三个 GET 不写 audit、notification、RabbitMQ（消息计数前置后置相等）。 +3. GET 返回 JSON 与基线一致（黄金 JSON 对比）。 +4. §9 每个真实输入源变化都会登记或合并一条待刷新任务；明确排除的非输入事件不得登记任务。 +5. 同一学生/period 的重复登记合并；完全相同的计算结果不增加快照 version。 +6. 并发登记后最终至少执行一次基于数据库最新状态的重算，任务不丢失且快照行不损坏。 +7. 刷新失败可重试、不写重复历史/审计、不影响原业务事务。 +8. rulesVersion 升级触发全量重算（version 递增）。 +9. 申诉创建取证字段（scoreAtAppeal/snapshotVersionAtAppeal）在写侧刷新后仍正确。 +10. 越权/非法 dimension/资源不存在零写入。 +11. 真实 MySQL 行级副作用快照 + RabbitMQ ready/unacked 归零。 +12. OpenAPI 176 paths / 214 operations 保持；不新增公网刷新接口。 +> 现有 `CandidateScoringPersistenceIntegrationTest#upsertSnapshots_shouldBeIdempotentAndIncrementVersion` 的断言（重复 upsert version+1）在 D4-2 后语义变为"仅有效变更 +1"，届时按新契约更新该既有断言（属于既定契约变更的测试演进，非草率改断言）。 + +## 18. 风险与回滚方案 + +| 风险 | 影响 | 缓解/回滚 | +|---|---|---| +| 写侧事件覆盖不全 → 某学生快照停滞 | 趋势/排名/监控滞后 | D4-1 保留 GET 兜底期间逐步补覆盖；D4-2 依赖补偿扫描兜底；若需开关必须在实施中明确新增并测试，不能假定现有开关存在 | +| 申诉取证版本语义漂移 | 申诉对比失真 | 事件刷新不触碰取证字段；D4-2 前在真实 MySQL 对申诉全链路回归 | +| 异步刷新丢失 | 快照缺失 | 事务后发布 + 死信 + 补偿扫描（幂等键避免重复写） | +| version 语义变化被下游误读 | 审计/导出版本含义差异 | 文档化；规则升级仍强制递增 | +| 回滚难度 | — | D4-1 可停止任务登记和 Worker，但新增表由 Flyway 保留不用；D4-2 可恢复 GET upsert。不得回滚或删除已执行迁移 | + +## 19. 自动化实际结果（本轮） + +| 命令 | 结果 | +|---|---| +| `mvn -Dtest="R01D4GetWritesSnapshotEvidenceTest" test`（新增现状证据） | **5/5**，BUILD SUCCESS | +| `mvn -Dtest="CandidateScoringEngineServiceTest,CandidateScoringPersistenceIntegrationTest,*CandidateScoring*Test,*ScoringMonitoring*Test" test` | **134/134**，F=0 E=0 S=0，BUILD SUCCESS | +| `mvn clean verify` | **2109/2109**（≥2104 预期），Failures=0、Errors=0、**Skipped=20**，BUILD SUCCESS | +| `python docs\verify_openapi.py` | **176 paths / 214 operations，All checks passed** | + +Skipped=20 逐项说明：全部来自 Q01 既有的 `JobSearchQueryExplainMySqlIntegrationTest` 与 `JobSearchQuerySideEffectMySqlIntegrationTest`（`@Testcontainers(disabledWithoutDocker = true)`，分别 15/5 例）。Docker Engine 本轮不可用 → Testcontainers 显式约定跳过，为既有机制而非本轮核心核查，且非"把环境缺失伪装为通过"；R01-D4 核心副作用证据由 H2 集成测试 5/5 提供，真实 MySQL 证据单独标注 BLOCKED（§5.2）。 + +## 20. Git 状态与边界声明 + +- 未修改任何生产代码；未修改既有测试断言；未修改 V1–V43；未新增 Flyway/表/索引/ErrorCode/公网接口。 +- 新增（工作区未提交）：`docs/r01-d4-get-scoring-snapshot-migration-design.md`、`R01D4GetWritesSnapshotEvidenceTest.java`（现状证据测试，非契约断言）。 +- 未 commit、push；未进入 R01-D5。历史未跟踪文件未删除未移动；暂存区为空。 +- 真实 MySQL 副作用证据标注 **BLOCKED（Docker Engine 不可用）**，未伪装通过；H2 集成证据 5/5 已提供。 + +## 21. 最终结论 + +> **R01-D4 GET评分快照写入迁移方案设计完成，待负责人确认后分阶段实施。** + +阻塞/依赖声明：当前 GET 兜底写快照服务多个真实输入域与 6 类消费者（趋势/申诉/监控/排名/看板/导出），且评分会因时间窗口自然变化；因此严禁直接删除 GET upsert。最小可行迁移路径 = D4-1（唯一 Writer + 持久刷新任务 + Worker/补偿扫描 + GET 兜底）→ 真实 MySQL 验证并发、重试与数据源覆盖 → D4-2（GET 转 readOnly）。 diff --git a/docs/r01-e-batch-query-unread-count-performance-report.md b/docs/r01-e-batch-query-unread-count-performance-report.md new file mode 100644 index 0000000..d7a3833 --- /dev/null +++ b/docs/r01-e-batch-query-unread-count-performance-report.md @@ -0,0 +1,352 @@ +# R01-E 既有批量查询与会话未读数性能实现：验收与测试加固报告 + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +HEAD：`b893ed67f078eedb0c4b8a03341311bd79342354`（== upstream） +本轮性质：**验收与测试加固** —— **生产代码 diff = 0**，未暂存、未提交、未推送 + +--- + +## 0. 结论 + +> **R01-E既有批量查询与会话未读数性能实现已完成验收和测试加固，待独立代码复验。** + +**观察项（本轮不改变既有语义）**： + +> **OBS-E01**：当前**本人发送且没有 `message_reads` 记录**的消息也计入**本人**未读数， +> 待产品负责人单独确认；本轮不改变既有语义。 + +**库存前置结论**：E1 与 E2 在 HEAD 上**均已处于目标终态**（分别由 R01-D2、R01-D3 交付）， +故本轮**未修改任何生产代码**，改为以**查询预算特征测试 + 跨库一致性 + EXPLAIN + 副作用快照**做验收加固。 + +--- + +## 1. PersonalDataCollector 修复前调用链（E1） + +**调用链**：`PersonalDataExportWorker.run` → `PersonalDataCollector.collect(userId)` → 12 个 section 构建方法 → `PersonalDataExportBuilder.build(...)` → 落盘。 + +**查询形态（逐处核对）**：全部为**批量**读取 —— `findByStudentUserIdOrderByCreatedAtDesc` / +`findByUserId` / `findAllById` / `...In...OrderBy...`，且批量历史查询 +（`ApplicationStatusHistory` / `InterviewStatusHistory` / `OfferStatusHistory` / `AppealHistory`） +均使用 `findByXxxIdInOrderByXxxIdAscCreatedAtAsc(...)`。 + +**循环内是否再查**：**否**。11 处 `forEach`（行 169/199/241/290/349/368/382/409/420/440/460/472） +只消费**预先批量取回**的数据与 `groupBy(...)` 结果做内存组装，循环体内**零 Repository 调用**。 + +**N 增长公式**：不受记录条数影响（见 §4）。 + +--- + +## 2. 会话未读数修复前调用链（E2） + +**调用链**：`MessagingController` → `MessagingService.listConversations(userId)`： +1. `memberRepository.findByUserId(userId)`（1 条） +2. 空则 `return List.of()` —— **不执行 `IN ()`** +3. `conversationRepository.findAllById(convIds)`（1 条） +4. `messageRepository.countUnreadByConversationIds(convIds, userId)`（**1 条分组查询**） +5. 内存排序（`updatedAt` 降序）后 `getOrDefault(cid, 0L)` 补 0 + +`countUnread(convId, userId)`（私有）**仅被 `getConversation`（单会话详情）调用**； +会话列表路径**不再逐会话 count**。 + +--- + +## 3. 修复前后查询次数公式 + +| 场景 | 修复前（R01-D2/D3 之前） | 当前（HEAD） | +|---|---|---| +| E1 导出 | `O(N)`：每类数据在循环内按 ID 再查 | **`O(1)` 常数**（每个数据类别固定 1 条批量查询） | +| E2 会话列表 | `O(K)`：每会话 1 次 `countUnread` | **`O(1)` 常数 3 条**（成员、会话、分组未读各 1 条） | + +--- + +## 4. 1 / 10 / 50 数据规模下 E1 SQL 数（实测） + +`R01EQueryBudgetAcceptanceTest.personalDataCollectQueryCountIsFlat`， +经 `CountingDataSource` 统计**真实 JDBC 语句**（`prepareStatement`/`createStatement`）： + +| 投递记录数 | 实测 SQL 条数 | +|---|---| +| **1** | **20** | +| **10** | **20** | +| **50** | **20** | + +**恒定 20 条**，与记录数**完全无关**（每次 `mvn` 为全新 JVM + 全新 H2 库；断言为精确相等）。 + +--- + +## 5. 1 / 20 / 100 会话规模下 E2 SQL 数（实测） + +`R01EQueryBudgetAcceptanceTest.unreadQueryCountIsFlat`： + +| 会话数 | 实测 SQL 条数 | 每会话未读 | +|---|---|---| +| **1** | **3** | 1 | +| **20** | **3** | 1（逐会话校验全部为 1） | +| **100** | **3** | 1（逐会话校验全部为 1） | + +**恒定 3 条**，不随会话数增长；三种规模下**逐会话 `unreadCount` 值全部正确**。 + +--- + +## 6. 批量 Repository / 投影契约 + +| 组件 | 契约 | +|---|---| +| E1 | 既有 `...In...` 批量方法 + `groupBy(values, idExtractor)` 内存分组；`Map>` 强类型键 | +| E2 | `MessageRepository.countUnreadByConversationIds(List conversationIds, Long readerUserId)` → `List` 投影（`conversationId` / `unreadCount`）；**原生查询、全参数化**，无字符串拼接用户可控 ID | + +--- + +## 7. 未读数 WHERE / GROUP BY 的准确语义（逐字取自原生查询） + +```sql +SELECT ranked.conversation_id AS conversationId, COUNT(*) AS unreadCount + FROM ( SELECT m.id, m.conversation_id, m.status, + ROW_NUMBER() OVER (PARTITION BY m.conversation_id ORDER BY m.created_at DESC) AS row_no + FROM messages m + WHERE m.conversation_id IN (:conversationIds) ) ranked + LEFT JOIN message_reads mr ON mr.message_id = ranked.id AND mr.reader_user_id = :readerUserId + WHERE ranked.row_no <= 500 + AND (ranked.status IS NULL OR ranked.status <> 'RECALLED') + AND mr.id IS NULL + GROUP BY ranked.conversation_id +``` + +| 语义点 | 事实 | +|---|---| +| 可见范围 | 由**会话成员关系**界定（调用方先取 `findByUserId` 得到 `convIds`），**非**由用户传入 ID 决定 | +| 会话页之外 | **不查询**（只传当前用户的会话 id 列表） | +| 撤回消息 | **排除**（`status <> 'RECALLED'`） | +| 已读消息 | **排除**（`message_reads` 存在该读者的记录） | +| 窗口上限 | 每会话**最近 500 条**（`row_no <= 500`） | +| 发送者过滤 | **无** —— 见 **OBS-E01** | +| 未返回的会话 | Service 侧 `getOrDefault(cid, 0L)` 补 0 | + +**OBS-E01 的实测证据**：同一会话内「本人 1 条 + 对方 2 条、均未读」时 +`unreadCount = 3`（最初按"他人发送才计"预期的 2 被实测纠正）。 +本轮**如实锁定既有语义**，未做任何行为改变。 + +--- + +## 8. H2 / MySQL 逐值一致结果 + +`R01EMySqlQueryCountAndExplainTest`（Testcontainers `mysql:8.4`，**4/4 通过**，耗时 34.94s → 容器真实启动）： + +| 用例 | 结论 | +|---|---| +| `groupedUnreadMatchesPerConversationSemantics` | MySQL 上分组 SQL 与 Service 路径**逐值一致**；`c1`: 3 条 SENT − 1 条 RECALLED − 1 条已读 = **1**；`c2`: **1** | +| `emptyAndForeignConversations` | 空 id 列表与不含该会话的 id 列表**均不返回** | +| `conversationScaleIsFlatAndCorrect` | 1 / 20 / 100 会话下 Service 结果条数与逐会话 `unreadCount`（各 3 条未读 = **3**）**全部正确** | +| `explainUnreadQuery` | 见 §9 | + +**H2 与 MySQL 一致性**：同一组夹具语义（撤回排除、已读排除、多会话聚合、缺失补 0）在两侧 +得到**相同数值**；H2 侧见 §4/§5/§13，MySQL 侧见上表。 + +--- + +## 9. MySQL EXPLAIN 摘要 + +对**与 `countUnreadByConversationIds` 逐字相同**的 SQL、同一批绑定参数执行 +`EXPLAIN FORMAT=JSON`（MySQL 8.4；提交前收口测试增加 10,000 条非目标背景消息， +使 1 个目标会话 × 200 条消息保持高选择性）： + +| 项 | 值 | +|---|---| +| JSON 长度 | 3898 字符 | +| `using_temporary_table` | **true**（位于 `grouping_operation` 层，为 `GROUP BY conversation_id` 的固有代价） | +| `using_filesort` | 提交前实施夹具（1 会话 × 200 条、10,000 条背景）为 **false**；独立复验的 1/20/100/600 四档真实规模均为 **true** | +| 派生表 `ranked` | `access_type = ALL`，即对物化后的派生结果顺序扫描；不能表述成“没有全表扫描” | +| 基础表 `messages`（别名 `m`） | `access_type = ref/range`，命中 `idx_messages_conversation_created`，不是 `ALL` | +| 基础表 `message_reads`（别名 `mr`） | `access_type = eq_ref`，命中 `uk_message_reads` | +| 其它字段 | `possible_keys` / `key` / `cost_info` / `rows_examined_per_scan` 均已出现；摘要落盘 `target/r01e-mysql-explain.txt` | + +**判读**：分组所需的临时表及窗口函数排序属于既有 SQL 的固有代价；最小实施夹具与 +真实规模对 `using_filesort` 的代价选择不同，而独立复验四档真实规模均为 +`using_temporary_table=true`、`using_filesort=true`。`ranked` 的 `ALL` 是派生结果顺序扫描； +必须与基础表区分。基础表 `messages` 在高选择性场景命中既有复合索引且不是 `ALL`， +`message_reads` 以唯一键 `eq_ref` 访问。 + +独立复验发现原实施测试使用 +`doesNotContain("\"table_name\": \"messages\" ...")`，但 MySQL JSON 使用别名 `m`， +因此该断言不具鉴别力。提交前已改为解析 JSON 树，分别定位唯一的 `m`、`mr`、`ranked` +节点，并校验访问类型、索引、临时表和 filesort；错误索引、`m=ALL`、缺失 `mr` 三种变异 +都会使断言失败。 + +--- + +## 10. 使用到的索引 + +`V9__messaging.sql` 中**既有**索引（**本轮未新增任何迁移或索引**）： + +| 索引 | 表 | 列 | +|---|---|---| +| `idx_messages_conversation_created` | `messages` | `(conversation_id, created_at)` | +| `idx_message_reads_message` | `message_reads` | `(message_id)` | +| `idx_message_reads_reader` | `message_reads` | `(reader_user_id)` | +| `idx_conv_members_user` | `conversation_members` | `(user_id)` | +| `idx_conversations_updated` | `conversations` | `(updated_at)` | + +未读查询的 `WHERE m.conversation_id IN (...)` 与 +`ROW_NUMBER() ... ORDER BY m.created_at DESC` 由 +`idx_messages_conversation_created (conversation_id, created_at)` 支撑； +`LEFT JOIN message_reads` 由 `idx_message_reads_message` / `idx_message_reads_reader` 支撑。 + +独立复验还确认：当目标会话消息占全表约 5.45% 时仍使用索引，约 13.63% 时优化器会 +基于代价转为基础表全扫；这是选择性变化，不是索引缺失。窗口排序、派生表物化及高占比 +场景仍是遗留性能风险，但 EXPLAIN 未证明必须新增索引，故本轮未新增 V46。 + +--- + +## 11. 行级副作用快照 + +`R01EQueryBudgetAcceptanceTest` 对 **11 张表**做稳定字段行级快照（按主键排序）并逐字段比对： + +| 表 | 快照列 | +|---|---| +| `users` | id, phone, nickname, role, is_active | +| `user_roles` | user_id, role | +| `conversations` | id, type, created_by, updated_at | +| `conversation_members` | conversation_id, user_id | +| `messages` | id, conversation_id, sender_user_id, status | +| `message_reads` | id, message_id, reader_user_id | +| `notifications` | id, user_id, type, title | +| `audit_logs` | id, user_id, action, entity_type | +| `auth_tokens` | id, user_id, token_type, revoked | +| `applications` | id, job_id, student_user_id, status | +| `job_favorites` | id, job_id, student_user_id | + +| 用例 | 结论 | +|---|---| +| `listConversationsIsReadOnly` | 会话列表 GET 前后 **11 张表逐字段零变化** ✔ | +| `personalDataCollectIsReadOnly` | `collector.collect()` 前后 **11 张表逐字段零变化** ✔ | + +--- + +## 12. RabbitMQ / 通知 / 审计结果 + +| 项 | 结论 | +|---|---| +| 通知 | `notifications` 行数在 `collect()` 前后**完全相等** ✔ | +| 审计 | `audit_logs` 行数在 `collect()` 前后**完全相等** ✔；且快照逐字段零变化 ✔ | +| RabbitMQ | 两条路径（`listConversations`、`collect`）均不发送消息；测试期间无新增 MQ 相关行 ✔ | +| 日志 | 未新增记录消息内容 / 手机号 / Token / 导出内容的日志语句（生产 diff = 0，无新增日志） | + +--- + +## 13. 新增测试及变异/反证 + +| 测试类 | Tests | 内容 | +|---|---|---| +| `common/r01e/R01EQueryBudgetAcceptanceTest` | **11** | E1/E2 查询预算（H2，真实 JDBC 计数）、既有未读语义（含 OBS-E01）、已读/撤回排除、多会话聚合与补 0、跨用户不泄漏、**11 张表行级副作用快照**、通知/审计零新增 | +| `common/r01e/R01EMySqlQueryCountAndExplainTest` | **4** | MySQL 8 上分组 SQL 与逐会话语义**逐值一致**、空列表与不属用户的 id 不返回、1/20/100 会话规模、`EXPLAIN FORMAT=JSON` | + +**反证设计**：查询预算断言为**精确相等**（非"不显著增长"）——若任一实现退化为逐条查询， +`baseline[1] != baseline[0]` 会立即失败；副作用快照为**逐字段相等**，任何写入都会被捕获。 +测试类通过 `CountingDataSource` 统计**真实 JDBC 语句**，**不是** Mockito verify Repository。 + +**本轮自查发现并修复的测试缺陷（诚实记录）**：`R01EQueryBudgetAcceptanceTest` 初版只有 +`@BeforeEach` 清理、**缺 `@AfterEach`**，退场后遗留 `r01e-*` 用户/公司/会话，导致全量运行中 +`PersonalDataExportControllerTest`(15)、`CompetitionRankingControllerTest`(13) 等 **60 项失败**。 +已补 `@AfterEach` 精确清理，复跑 `R01EQueryBudgetAcceptanceTest,PersonalDataExportControllerTest, +CompetitionRankingControllerTest` → **39/39 通过**。**这是本轮新增测试自身的缺陷，非既有实现问题。** + +--- + +## 14. 定向、关联、全量和 clean verify 数量 + +| 命令 | 结果 | +|---|---| +| 关联回归（`*PersonalData*Test,*Export*Test,*Messaging*Test,*Message*Test,*Conversation*Test,*Recall*Test`） | **150 / 150**，F=0 E=0 S=0 ✔ | +| 性能/验收定向 | 见 §14.1 | +| `mvn test` | 见 §14.1 | +| `mvn clean verify` | 见 §14.1 | + +### 14.1 全量与 clean verify + +| 命令 | Tests | Failures | Errors | Skipped | BUILD | +|---|---|---|---|---|---| +| 性能/验收定向（含 MySQL Testcontainers） | **18** | 0 | 0 | **0** | SUCCESS | +| `mvn test` | **2761** | **0** | **0** | **0** | SUCCESS | +| `mvn clean verify` | **2761** | **0** | **0** | **0** | SUCCESS | + +**2761 = 2746（R01-C 阶段二基线）+ 本轮新增 15**（H2 11 + MySQL 4），与要求「不低于 2746 + 新增数」一致。 +**Skipped=0** 且 MySQL 用例耗时 34.94s，证明 **Testcontainers 真实执行、未被跳过**。 + +**关联回归**：`*PersonalData*Test,*Export*Test,*Messaging*Test,*Message*Test,*Conversation*Test,*Recall*Test` +→ **150 / 150**，F=0 E=0 S=0 ✔ + +--- + +## 15. OpenAPI 数量 + +``` +python ..\docs\verify_openapi.py → paths: 176 / operations: 214 / All checks passed! +``` + +`git diff -- docs/openapi-rc.json` → **空** ✔ + +--- + +## 16. 精确修改文件 + +**生产代码：0 个文件。** + +**新增测试（2）** + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EQueryBudgetAcceptanceTest.java +mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EMySqlQueryCountAndExplainTest.java +``` + +**文档（1）**：本报告 + +--- + +## 17. 是否修改迁移、ErrorCode、接口、DTO、依赖 + +| 项 | 结果 | +|---|---| +| V1–V45 / Flyway | **未修改** ✔ | +| `ErrorCode` | **未修改** ✔ | +| 公网接口 / DTO / OpenAPI 契约 | **未修改**（176/214） ✔ | +| `pom.xml` / 依赖 | **未修改** ✔ | +| Security / Token / 权限 / requestId | **未修改** ✔ | +| 评分、排名、推荐、申诉、邀约、Offer、撤回与已读语义 | **未修改** ✔ | +| 分布式缓存 / 冗余未读列 / 异步最终一致未读数 | **未引入** ✔ | + +--- + +## 18. Git 状态 + +| 项 | 结果 | +|---|---| +| 分支 / HEAD | `refactor/r01-structure-performance` / `b893ed67f078eedb0c4b8a03341311bd79342354`（未变） | +| HEAD 与 upstream | **0 0** ✔ | +| `git diff --cached --name-only` | **空** ✔ | +| `git diff --check` | **exit 0** ✔ | +| 生产代码 diff | **0 个文件** ✔ | +| V1–V45 / `openapi-rc.json` / `pom.xml` / `ErrorCode` | **均未修改** ✔ | +| 历史未跟踪文件 | 完整保留 ✔ | +| 本轮新增（未跟踪） | `docs/r01-e-batch-query-unread-count-performance-report.md`、`mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/`（2 个测试类） | + +--- + +## 19. 明确未暂存、未提交、未推送 + +**确认：未执行 `git add`；未创建提交；未推送。** 未执行 `reset`/`restore`/`checkout`/`clean`。 + +--- + +## 20. 遗留风险 + +| # | 风险 | 说明 | +|---|---|---| +| R1 | **OBS-E01 语义** | 本人发送且未读的消息计入本人未读数。当前实现如此，本轮**未改变**；若产品确认应排除，需另立批次（属业务语义变更，不属性能收束） | +| R2 | 500 条窗口 | 未读统计只看每会话**最近 500 条**；超过 500 条的会话其更早未读不计入。属既有设计，本轮未改动 | +| R3 | 派生表物化 | MySQL 8 对 `ROW_NUMBER()` 派生表可能物化；`ranked.row_no <= 500` 的过滤在物化后生效，大会话下存在额外扫描成本。EXPLAIN 证据见 §9 | +| R4 | 测试自污染 | 本轮新增测试的清理为**按前缀精确删除**；若将来有人新增同类夹具而不清理，仍可能污染共享 H2 库（R01-C 已就同类问题建立隔离门禁，本轮范围外） | + +--- + +> **R01-E既有批量查询与会话未读数性能实现已完成验收和测试加固，待独立代码复验。** diff --git a/docs/r01-e-independent-verification-20260918.md b/docs/r01-e-independent-verification-20260918.md new file mode 100644 index 0000000..c22236c --- /dev/null +++ b/docs/r01-e-independent-verification-20260918.md @@ -0,0 +1,412 @@ +# R01-E 批查询与会话未读数：**独立复验报告**（第三～十一节） + +日期：2026-09-18 +分支：`refactor/r01-structure-performance` +HEAD / upstream：`b893ed67f078eedb0c4b8a03341311bd79342354`（ahead/behind = **0 / 0**） +本轮性质：**独立复验** —— 不改生产代码、不改迁移、不暂存、不提交、不推送 +上游依据：`docs/r01-e-batch-query-unread-count-performance-report.md`（实施与测试加固报告） + +--- + +## 0. 结论 + +> **R01-E独立代码与真实MySQL性能复验通过，可以进入精确暂存与独立提交检查点。** + +| 复验项 | 结论 | +|---|---| +| 独立查询预算（E1 = 20/20/20，E2 = 3/3/3） | **通过**（H2 与真实 MySQL 双侧实测） | +| E1 collector 完整输出 H2/MySQL 深比较 | **通过**（逐字段、含 null/时间/集合顺序/关联数据） | +| E2 会话未读 H2/MySQL 深比较（10 项语义） | **通过** | +| MySQL `EXPLAIN FORMAT=JSON` | **通过**（基础表命中既有索引，无需新增 V46） | +| 副作用与隔离（25 张表快照 + 反证 + 零残留） | **通过** | +| OBS-E01 | **保留既有语义**，作为产品负责人待决策项上报 | +| 独立复验时全量 `mvn test` / `mvn clean verify` | **2787 / 0 / 0 / 0** | +| 提交前收口 `mvn clean verify` | **2788 / 0 / 0 / 0**（增加 1 个 EXPLAIN 变异门禁） | +| OpenAPI | **176 paths / 214 operations**，`openapi-rc.json` 未改 | +| 生产代码 diff | **0 个文件** | + +**独立复验新发现（3 项，均如实记录）**： +**F1** 实施测试的 EXPLAIN 断言 `doesNotContain("\"table_name\": \"messages\", ...")` 是**空断言**—— +MySQL 的 EXPLAIN JSON 里 `table_name` 存的是**别名**（本语句为 `m` / `mr`）， +`"table_name": "messages"` 永不出现，故该断言无论如何都会通过。结论本身（当时夹具下确实未全扫）成立， +但**断言不具备鉴别力**。提交前收口已将实施测试改为解析 JSON 树，按别名分别定位 +`m` / `mr` / `ranked`，校验 access_type、key、temporary 与 filesort，并以错误索引、 +基础表 `ALL`、缺失节点三类变异证明断言有效。 +**F2** H2 与 MySQL 对同一 JSON 列的回读**表示不同**（详见 §4.2），已记录原始值并按语义归一后比较。 +**F3** 实施报告 §9 记 `using_filesort=false`；本轮在**真实规模夹具**下实测 `using_filesort=true` +（窗口函数 `ROW_NUMBER()` 的排序代价），详见 §6.4。 + +--- + +## 1. 复验范围与不重叠声明 + +- 从第三～十一节执行，**未重做第一、二节库存**，未修改任何生产代码。 +- 复用既有文件（**未重复创建**）： + - `mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EQueryBudgetAcceptanceTest.java`（实施测试，11 项） + - `mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EMySqlQueryCountAndExplainTest.java`（实施测试，4 项） + - `docs/r01-e-batch-query-unread-count-performance-report.md` +- 独立测试**不复用**实施测试的任何夹具、断言或辅助方法：夹具、快照（25 张表、列集合不同）、 + 计数 DataSource、EXPLAIN 解析均为独立实现。 + +--- + +## 2. 本轮新增文件（未跟踪） + +``` +mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentCrossDatabaseVerificationTest.java 独立测试，16 项 +mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentSideEffectIsolationTest.java 独立测试，10 项 +docs/r01-e-independent-verification-20260918.md 本报告 +``` + +**生产代码：0 个文件**（`git diff --stat` 为空）。 + +--- + +## 3. 独立查询预算验证（任务 1） + +**方法**：独立实现的 `CountingDataSource` 包装真实 `DataSource`，记录**真实 JDBC 语句文本与条数**； +两侧在**夹具灌入完成之后**才 `reset()`，故计数**不含测试准备与清理 SQL**（断言实测语句全部为 `SELECT`）。 + +### 3.1 E1：1 / 10 / 50 条投递 + +| 夹具 | H2 实测 | MySQL 实测 | 目标 | +|---|---|---|---| +| 与实施报告同基线的最小夹具（2 用户 + 1 公司 + N 岗位 + N 投递） | **[20, 20, 20]** | **[20, 20, 20]** | **20/20/20 ✔** | +| 本类丰富夹具（12 个 section 全部有数据）+ N 投递 | [22, 22, 22] | [22, 22, 22] | 恒定 ✔ | + +- 两者都**不随记录数增长**；与实施报告「20/20/20」的结论**独立复现一致**。 +- 丰富夹具为 22（比最小夹具多 2）：多出的是「本人持有公司 → offers 企业侧分支」以及 + 「存在会话 → conversations/messages 两条批量查询」这两个**按分支固定**的查询，仍与 N 无关。 +- 证据：`target/r01e-independent/e1-budget.txt`、`e1-budget-rich.txt`。 + +### 3.2 E2：1 / 20 / 100 会话 + +| 会话数 | H2 实测 | MySQL 实测 | 目标 | +|---|---|---|---| +| 1 | **3** | **3** | 3 ✔ | +| 20 | **3** | **3** | 3 ✔ | +| 100 | **3** | **3** | 3 ✔ | + +- 实测 SQL 文本**恰好为 3 条**，形态固定且可辨认： + 1. `select ... from conversation_members ... where user_id=?` + 2. `select ... from conversations ... where id in (?,...)` + 3. 分组未读查询（含 `ROW_NUMBER()`）——**只出现 1 次** +- 证据：`target/r01e-independent/e2-budget.txt`（含两侧完整 SQL 文本）。 + +### 3.3 空会话页不执行未读查询 + +| 断言 | H2 | MySQL | +|---|---|---| +| `listConversations(无会话用户)` 返回空 | ✔ | ✔ | +| 实测语句数 | **1** | **1** | +| 该语句不含 `ROW_NUMBER` | ✔ | ✔ | +| 含 `row_number` 的语句数 | **0** | **0** | + +即：空会话页只发出一条成员关系查询后短路返回，**不下发未读聚合查询**。 + +--- + +## 4. E1 H2 / MySQL 深比较（任务 2） + +### 4.1 方法 + +同一个 JVM 内同时持有两个 Spring 上下文： + +- **H2 侧**：测试自身上下文，`jdbc:h2:mem:r01e_ind;MODE=MySQL`（**本类独占**的内存库，Flyway 全量迁移）； +- **MySQL 侧**：`@BeforeAll` 手工引导的第二个上下文（Testcontainers `mysql:8.4`，`mysql-it` 配置， + `WebApplicationType.NONE`，命令行参数覆盖数据源），Flyway 在容器内真实执行 45 个迁移。 + +两侧灌入**同一份等价夹具**（显式时间戳、无 `CURRENT_TIMESTAMP` 依赖），覆盖 **全部 12 个 section**， +并额外放入一个「外人」用户的同类数据。 + +**先决条件已实证**：`bothEnginesAreLiveAndFixtureIdsAgree` 断言两侧 27 个自然键 → 主键映射**完全相等** +（同一 JVM、两侧均为全新建库），故后续可直接比较含主键的完整输出。 + +### 4.2 深比较结果 + +`canonicalResult(...)` 把 collector 的**完整 section 输出**规范化为确定性文本：显式呈现 `null`、 +时间按 `LocalDateTime` 呈现、List 保持原序（集合顺序）、Map 按 key 排序、`BigDecimal` 去尾零。 + +``` +e1-h2.txt == e1-mysql.txt （均 6213 字节，逐字符相同） +``` + +**JSON 列的表示差异（F2，如实记录）**——`e1-raw-json.txt` 原文： + +``` +h2: profile.skills="{\"java\":3,\"sql\":2}" | preferences.preferredCities="[\"北京\",\"上海\"]" +mysql: profile.skills={"sql": 2, "java": 3} | preferences.preferredCities=["北京", "上海"] +``` + +- **H2（MODE=MySQL）**把 JSON 列回读为**被转义的 JSON 字符串标量**； +- **MySQL 8**回读为 **JSON 对象字面量**（键重排、冒号后加空格）。 +- 两者**语义相同、表示不同**：比较的是语义。规范化对确实是 JSON 的字符串递归解码后按键排序， + 非 JSON 字符串原样保留（`content`、`coverLetter` 等不受影响）。 + +**反证**：把 dump 中任意一个字段值（`"张三"` → `"张四"`）置换后断言必须不再相等——通过， +说明规范化是**逐字段敏感**的，而不是只比条数、hash 或长度。 + +### 4.3 其他断言 + +| 断言 | 结果 | +|---|---| +| section 顺序 | 精确等于 `profile, preferences, resumes, applications, application-timelines, interviews, interview-timelines, offers, offer-timelines, feedback, favorites, notifications, conversations, messages, candidate-scoring, scoring-appeals` ✔ | +| 关联数据 | 应用↔时间线、面试↔时间线、Offer↔时间线、会话↔消息的分组关系随主键一并跨库一致 ✔ | +| 其他用户数据不得混入 | dump 中不含 `李四 / 外人的简介 / 外人简历 / 外人求职信 / 外人评价 / 外人通知 / 外人会话 / out-m1 / 外人Offer / 外人理由 / 外人面试 / outsider` ✔ | +| 跨库自有行数 | 23 张表的自有行数两侧完全一致 ✔ | +| 非 ACTIVE 简历、`read_at` 为 null / 非 null 的通知、`score` 为 null 的维度分、`tags` 为 null 的评价、`cover_letter` 为 null 的投递 | 均已覆盖并通过 ✔ | + +--- + +## 5. E2 H2 / MySQL 深比较（任务 3） + +10 项语义逐条覆盖，**两侧结果逐值一致**（会话列表完整视图规范化后逐字符相同）： + +| # | 语义 | H2 | MySQL | 结果 | +|---|---|---|---|---| +| 1 | **本人发送未读按现状计入（OBS-E01）** | c1 = 2（本人 1 + 他人 1） | c1 = 2 | ✔ 一致 | +| 1b | 同上，把本人那条标记已读后 | 1 | 1 | ✔ | +| 2 | 他人发送未读计入 | ✔ | ✔ | ✔ | +| 3 | `message_reads` 排除 | 读 1 条后 2 → 1 | 同 | ✔ | +| 3b | 另一读者的已读记录不影响本人 | 不受影响 | 不受影响 | ✔ | +| 4 | `RECALLED` 排除 | 撤回 1 条后 2 → 1 | 同 | ✔ | +| 5 | 多会话分组 | c1=2, c2=1, c3=1 | 同 | ✔ | +| 6 | 非当前用户会话不返回 | 只返回 c1/c2/c3；cOutsider 不在 | 同 | ✔ | +| 7 | 聚合缺失补 0 | 全部撤回/已读时聚合缺行 → 0 | 同 | ✔ | +| 8 | **最近第 500 条计入、第 501 条排除** | 501 条未读 → **500**；把最旧一条标已读 → **仍 500**；把最新一条标已读 → **499** | 同 | ✔ | +| 9 | **`created_at` 相同的排序语义** | 同刻 3 条 → 3；其中 1 条已读 → 2；同刻 501 条 → **500** | 同 | ✔ | +| 10 | **空及重复 `conversationIds`** | 重复 `[c1,c1]` 只产 1 行且与 `[c1]` 逐值相同；空列表由 Service 短路、不下发 `IN ()` | 同 | ✔ | + +**第 8 项证明方式**：不止断言「等于 500」，而是通过「标已读最旧一条 → 不变」证明**最旧一条本就在窗口之外**， +「标已读最新一条 → 499」证明**窗口保留的是最新一侧**。 + +**第 9 项的诚实边界**：`ROW_NUMBER() ... ORDER BY m.created_at DESC` **没有 tiebreaker**， +故当 501 条 `created_at` 完全相同时，「保留哪 500 条」**由引擎决定**； +但**窗口计数与引擎无关，恒为 500**——两侧实测一致。此点已计入遗留风险（R2）。 + +--- + +## 6. MySQL `EXPLAIN FORMAT=JSON`（任务 4） + +**被测语句**与 `MessageRepository.countUnreadByConversationIds` **逐字相同**，绑定同一批参数。 +**夹具**：先铺入 **500 个背景会话 × 20 条 = 10 000 条消息**（不属于查询范围），再替换目标会话—— +否则 `messages` 表几乎只含查询范围内的行，MySQL 选择全扫是**正确**的代价决策， +却会让 EXPLAIN 失去验收意义。 + +### 6.1 逐表结果（`messages` / `message_reads` / 派生结果 `ranked` 分开报告） + +> **注意**：MySQL 的 `EXPLAIN FORMAT=JSON` 中 `table_name` 是**别名**。 +> 被测语句的别名为 `messages m`、`message_reads mr`、派生表 `ranked`， +> 故表节点分别为 `m` / `mr` / `ranked`。 + +| 规模 | selectivity | `ranked`（派生结果） | `messages`（别名 `m`） | `message_reads`（别名 `mr`） | temporary | filesort | +|---|---|---|---|---|---|---| +| 1 会话 × 3 条 | 0.01% | **ALL**（派生结果顺序扫描）· rows=3 | **ref** · `idx_messages_conversation_created` · rows=3 | **eq_ref** · `uk_message_reads` · rows=1 | true | true | +| 20 会话 × 3 条 | 0.27% | **ALL** · rows=60 | **range** · `idx_messages_conversation_created` · rows=60 | **eq_ref** · `uk_message_reads` · rows=1 | true | true | +| 100 会话 × 3 条 | 1.36% | **ALL** · rows=300 | **range** · `idx_messages_conversation_created` · rows=300 | **eq_ref** · `uk_message_reads` · rows=1 | true | true | +| **1 会话 × 600 条（> 500 窗口）** | 2.73% | **ALL** · rows=600 | **ref** · `idx_messages_conversation_created` · rows=600 | **eq_ref** · `uk_message_reads` · rows=1 | true | true | + +**判读**： + +- **派生结果 `ranked` 的 `access_type = ALL` 必须准确表述为「派生结果顺序扫描」**—— + 这是 MySQL 对 `ROW_NUMBER()` 派生表**物化**后顺序读取物化结果的固有形态， + `possible_keys`/`key` 均为 `null`（派生表上不存在索引）。**不得**笼统写成「无全表扫描」。 +- **`messages` 基础表在四个验收断言规模下命中既有索引 `idx_messages_conversation_created`（`ref` / `range`）**； + 更高选择性探测会转为 `ALL`，详见下一节，不能笼统表述为“没有全表扫描” ✔ +- **`message_reads` 基础表在所有规模下均为 `eq_ref` 命中 `uk_message_reads`** ✔ + （`possible_keys` 同时列出 `idx_message_reads_message` / `idx_message_reads_reader`） +- `possible_keys`、`key`、`rows_examined_per_scan`、`filtered`、`using_temporary_table`、`using_filesort` + 均已逐规模记录，原文见 `target/r01e-independent/e2-explain.txt`。 + +### 6.2 代价拐点（选择性探测，只记录不判定） + +| 规模 | selectivity | `messages` 访问方式 | +|---|---|---| +| 2 会话 × 600 条（1 200 行） | 5.45% | **range** · `idx_messages_conversation_created`（命中索引） | +| 5 会话 × 600 条（3 000 行） | 13.63% | **ALL** · key=null · rows=13 093（转为全扫） | +| 20 会话 × 600 条（12 000 行） | 54.53% | **ALL** · key=null · rows=22 016（转为全扫） | + +**结论**：拐点被夹逼在 **5.45% 与 13.63%** 之间。也就是说， +只有当「被查询的会话集合占 `messages` 全表 6% 以上」时，MySQL 才会放弃索引改走全扫—— +这是**代价决策，不是缺索引**。真实场景中一个用户的会话列表远低于此比例， +故本项判定 **PASS**，**不新增 V46**（严格遵守指令）。 + +### 6.3 `using_temporary_table = true` 的归属 + +`true` 出现在 `grouping_operation` 层，是 `GROUP BY ranked.conversation_id` 的固有代价， +与派生表物化同源，**不是**新增索引可以消除的。 + +### 6.4 `using_filesort` 的更正（F3） + +实施报告 §9 记录 `using_filesort=false`（其夹具为 1 会话 × 200 条）。 +本轮在**带背景数据的真实规模夹具**下，1/20/100/600 四档**全部实测 `using_filesort=true`**—— +来源是窗口函数 `ROW_NUMBER() OVER (PARTITION BY conversation_id ORDER BY created_at DESC)` 的排序。 +这是**既有实现的固有代价**，本轮不改动，仅如实更正记录。 + +--- + +## 7. 副作用与隔离（任务 5） + +独立测试 `R01EIndependentSideEffectIsolationTest`，运行在**共享的 integration H2 库**上（与实施测试同库， +因此可以直接观测实施测试的夹具残留）。 + +### 7.1 逐字段快照（**25 张表**，独立于实施测试的 11 张） + +`users`(6 列)、`user_roles`、`companies`、`jobs`、`applications`、`application_status_history`、 +`interviews`、`interview_status_history`、`offers`、`offer_status_history`、`candidate_feedback`、 +`job_favorites`、`notifications`、`audit_logs`、`auth_tokens`、`conversations`、`conversation_members`、 +`messages`(含 `version`)、`message_reads`、`student_profiles`、`student_preferences`、`resume_versions`、 +`candidate_dimension_scores`、`candidate_scoring_appeals`、`candidate_scoring_appeal_history` + +| 用例 | 结论 | +|---|---| +| `collector.collect()` 前后 | **25 张表逐字段零变化** ✔ | +| `listConversations()` 前后 | **25 张表逐字段零变化** ✔ | +| `listConversations + getConversation + collect` 组合 | **25 张表逐字段零变化** ✔ | + +**读取路径零写**：夹具覆盖全部 12 个 section（collect 走满所有分支），快照仍零变化。 + +### 7.2 通知 / 审计 / RabbitMQ + +| 项 | 结论 | +|---|---| +| `notifications` 行数与逐字段内容 | 读前后**完全相等** ✔ | +| `audit_logs` 行数与逐字段内容 | 读前后**完全相等** ✔ | +| **RabbitMQ** | 以 `@MockBean RabbitTemplate` 注入，读路径结束后 `verifyNoInteractions(rabbitTemplate)` **通过**——**零 AMQP 交互** ✔ | +| MQ 配置 | `mysql-it` / `integration-test` 均置 `app.notification.mq-enabled: false`、`spring.rabbitmq.enabled: false`，`NotificationConsumer` 条件装配关闭 ✔ | + +### 7.3 反证：快照必须真的能发现变化 + +| 反证用例 | 期望 | 结果 | +|---|---|---| +| 修改一行（`users.nickname`） | 断言必须失败 | **AssertionError，含 `users`** ✔ | +| 新增一行（`notifications`） | 断言必须失败 | **AssertionError，含 `notifications`** ✔ | +| 删除一行（`message_reads`） | 断言必须失败 | **AssertionError，含 `message_reads`** ✔ | +| **仅单列变化**（`messages.status` → `RECALLED`） | 断言必须失败 | **AssertionError，含 `messages`** ✔ | + +若无此反证，「零变化」可能只是**没在比**。 + +### 7.4 夹具零残留 + +| 检查 | 结果 | +|---|---| +| 本类自有夹具（`r01eiso-%`）退场后残留 | **0**（`@AfterEach` 精确清理 + `@AfterAll` 门禁）✔ | +| **实施测试的夹具（`r01e-%`，排除本类前缀）残留** | **0** ✔ | +| 实施测试遗留的 `messages` / `r01e-co` / `r01e-job` | **0** ✔ | + +**关于此前「缺 `@AfterEach` 导致 60 项失败」的专项复验**：H2 内存库按 JVM 共享， +只有让 `R01EQueryBudgetAcceptanceTest` **先于**独立类运行，残留检查才具备鉴别力。 +为消除运行顺序的不确定性，本轮**追加一次逆序运行**： + +``` +mvn -o -Dsurefire.runOrder=reversealphabetical -Dtest="R01EQueryBudgetAcceptanceTest,R01EMySqlQueryCountAndExplainTest,R01EIndependentCrossDatabaseVerificationTest,R01EIndependentSideEffectIsolationTest" test +→ 实际顺序：R01EQueryBudgetAcceptanceTest(11) → R01EMySqlQueryCountAndExplainTest(4) + → R01EIndependentSideEffectIsolationTest(10) → R01EIndependentCrossDatabaseVerificationTest(16) +→ 独立复验：Tests run: 41, Failures: 0, Errors: 0, Skipped: 0 +→ 提交前收口：Tests run: 42, Failures: 0, Errors: 0, Skipped: 0（新增 EXPLAIN 变异门禁） +``` + +即：实施测试跑完后，独立类的 `implementationFixturesLeaveNoResidue` 与 `@AfterAll` 门禁 +**直接确认其夹具残留为 0**，旧问题已修复且可被独立观测。 + +--- + +## 8. OBS-E01（任务 6） + +**观察项（本轮不改变既有语义，作为产品负责人待决策项上报）**： + +> **本人发送且没有当前用户 `message_reads` 记录的消息，计入本人未读数。** + +| 证据 | H2 | MySQL | +|---|---|---| +| 会话内「本人 1 条 + 他人 2 条，均未读」 | 未读 = **3**（不是 2） | **3** | +| 会话内「他人 1 条 + 本人 1 条 + 1 条撤回」 | 未读 = **2** | **2** | +| 把本人发送的那条写入 `message_reads` | 未读减为 **1** | **1** | + +- 该行为源自未读查询的 `WHERE` 中**没有发送者过滤**（只按 `conversation_id` 与读者 `message_reads` 判定）。 +- 本轮**未修改 SQL、未修改任何生产代码**，仅将既有语义**如实锁定并双侧取证**。 +- 若产品确认应排除本人发送的消息，属**业务语义变更**，需另立批次，不在本次性能收束范围内。 + +--- + +## 9. 门禁结果（任务完成后的规定命令） + +| # | 命令 | Tests | Failures | Errors | Skipped | 结果 | +|---|---|---|---|---|---|---| +| 1 | `mvn -Dtest="R01EQueryBudgetAcceptanceTest,R01EMySqlQueryCountAndExplainTest,R01EIndependentCrossDatabaseVerificationTest,R01EIndependentSideEffectIsolationTest" test` | **41** | 0 | 0 | **0** | SUCCESS | +| 1b | 同上 + `-Dsurefire.runOrder=reversealphabetical`（残留门禁） | **41** | 0 | 0 | **0** | SUCCESS | +| 2 | `mvn -Dtest="*PersonalData*Test,*Export*Test,*Messaging*Test,*Message*Test,*Conversation*Test,*Recall*Test" test` | **150** | 0 | 0 | **0** | SUCCESS | +| 3 | 独立复验 `mvn test` | **2787** | **0** | **0** | **0** | SUCCESS | +| 4 | 独立复验 `mvn clean verify` | **2787** | **0** | **0** | **0** | SUCCESS | +| 5 | 提交前收口 `mvn clean verify` | **2788** | **0** | **0** | **0** | SUCCESS | +| 5 | `python ..\docs\verify_openapi.py` | paths **176** / operations **214** | — | — | — | `All checks passed!` | + +**测试计数对账**：独立复验为 `2761（R01-C 阶段二基线）+ 26（独立新增：16 跨库 + 10 副作用）= 2787`； +提交前收口再增加 1 个 EXPLAIN 变异门禁，最终为 **2788** ✔ +（实施测试的 11 + 4 = 15 已含在 2761 内，本轮未新增实施测试。） + +### 9.1 实施测试 / 独立测试 明细 + +| 类别 | 测试类 | 项数 | 引擎 | +|---|---|---|---| +| **实施测试** | `R01EQueryBudgetAcceptanceTest` | 11 | H2 | +| **实施测试** | `R01EMySqlQueryCountAndExplainTest` | 4 | **MySQL（Testcontainers）** | +| **独立测试** | `R01EIndependentCrossDatabaseVerificationTest` | 16 | **H2 + MySQL（同 JVM 双上下文）** | +| **独立测试** | `R01EIndependentSideEffectIsolationTest` | 10 | H2（共享 integration 库） | +| | **合计** | **41** | | + +### 9.2 Testcontainers / MySQL **实际执行**证据 + +- Docker Server **29.6.2**；`mysql:8.4` 容器日志实测：`Container mysql:8.4 started in PT7.4093471S`。 +- `R01EMySqlQueryCountAndExplainTest` 标注 `@Testcontainers(disabledWithoutDocker = true)`—— + 若 Docker 不可用该类的 4 项会被 **skip**；实测 **Skipped = 0**，故容器**真实启动并执行**。 +- `R01EIndependentCrossDatabaseVerificationTest` 断言 `MySql.container.isRunning()` 为 `true`， + 并在 MySQL 上真实执行了 Flyway 全量迁移、跨库深比较、`ANALYZE TABLE` 与 `EXPLAIN FORMAT=JSON`。 +- 两类 MySQL 用例耗时分别为 **122.5 s** 与 **17.2 s**（`clean verify` 单次运行），与容器冷启动 + 万级夹具灌入相符。 + +--- + +## 10. 生产代码与契约不变性 + +| 项 | 结果 | +|---|---| +| 生产代码 diff | **0 个文件**（`git diff --stat` 空） | +| V1–V45 迁移 / Flyway | **未修改**（目录 `git status` 0 项，仍为 45 个版本文件） ✔ | +| `pom.xml` / 依赖 | **未修改** ✔ | +| `ErrorCode` | **未修改** ✔ | +| 公网接口 / DTO / OpenAPI 契约 | **未修改**（176 / 214） ✔ | +| `docs/openapi-rc.json` | **未修改** ✔ | +| 新增迁移 V46 | **未新增**（EXPLAIN 未发现必须新增索引的情形） ✔ | +| Security / Token / 权限 / requestId | **未修改** | +| 评分、排名、推荐、申诉、邀约、Offer、撤回与已读语义 | **未修改** | +| 分布式缓存 / 冗余未读列 / 异步最终一致未读数 | **未引入** | + +--- + +## 11. Git 状态（未暂存 / 未提交 / 未推送） + +| 项 | 结果 | +|---|---| +| 分支 / HEAD | `refactor/r01-structure-performance` / `b893ed67f078eedb0c4b8a03341311bd79342354`（**未变**） | +| HEAD 与 upstream | **0 / 0** ✔ | +| 暂存区 `git diff --cached --name-only` | **空** ✔ | +| 本轮新增（未跟踪） | 2 个独立测试类 + 本报告 | +| 既有未跟踪文件 | 完整保留，未删除、未移动 | + +**确认：全程未执行 `git add` / `commit` / `push`，未执行 `reset` / `restore` / `checkout` / `clean`。** + +--- + +## 12. 遗留风险 + +| # | 风险 | 说明 | +|---|---|---| +| R1 | **OBS-E01 语义** | 本人发送且无本人 `message_reads` 的消息计入本人未读数。既有实现如此，本轮未改；如需变更属业务语义变更，须另立批次 | +| R2 | **`created_at` 并列无 tiebreaker** | 未读窗口的 `ORDER BY m.created_at DESC` 无二级排序键。并列跨越 500 边界时「保留哪 500 条」由引擎决定（**计数恒为 500**，两侧一致）。`messages.created_at` 为秒级 `DATETIME`，高并发同秒写入可触发 | +| R3 | **派生表物化** | MySQL 对 `ROW_NUMBER()` 派生表物化，`ranked` 为派生结果顺序扫描（`access_type=ALL`），且 `using_temporary_table=true`、`using_filesort=true` 为固有代价。大会话（> 每表 6% 选择性）下 `messages` 转为全扫，属代价决策 | +| R4 | **测试自污染** | 本轮测试均按前缀精确清理；若将来新增同类夹具而不清理，仍可能污染共享 H2 库（R01-C 已建隔离门禁） | +| R5 | **实施测试断言鉴别力（F1）** | 原 EXPLAIN 断言为空断言；提交前收口已改为 JSON 结构断言，并以三类变异证明有效 | + +--- + +> **R01-E独立代码与真实MySQL性能复验通过，可以进入精确暂存与独立提交检查点。** diff --git a/docs/r01-structure-performance-design.md b/docs/r01-structure-performance-design.md new file mode 100644 index 0000000..e60e9fa --- /dev/null +++ b/docs/r01-structure-performance-design.md @@ -0,0 +1,81 @@ +# R01 结构与性能收束权威设计 + +## 1. 目标与边界 + +R01 在 S01、S02、S03、Q01 已冻结行为之上收束重复代码和可证明的性能热点。所有改动必须保持 HTTP 契约、业务错误码、权限、事务、审计、隐私和数据副作用不变。 + +禁止在 R01 中新增业务功能、公开接口、Flyway、表或索引；禁止改变评分公式、推荐权重、百分位定义、消息未读定义、简历权限、Token 语义或岗位搜索语义。索引和全文搜索仅形成后续提案，不在本轮实施。 + +基线：分支 `refactor/r01-structure-performance`，起点 `77dc624`；OpenAPI 176 paths / 214 operations；全量测试 1890/1890。 + +## 2. 已确认问题 + +- 41 个生产文件包含私有身份解析方法；不同实现对匿名主体、非数字主体和溢出主体的处理不一致。 +- 46 个生产文件包含私有 requestId 获取方法；部分直接取请求头，未复用 RequestIdFilter 的规范化结果。 +- 角色断言以 `assertStudentRole`、`requireStudent`、`requireAdmin` 等形式分散，存在重复查用户和语义漂移风险。 +- `GlobalExceptionHandler.resolveHttpStatus` 是大型 if 链，并含重复分支。 +- `overviewStatus` 在评分引擎和竞争力排名中存在两套等价规则。 +- `JobRecommendationService.preferenceScore` 被压缩为单行，权重含义难以评审。 +- `CompanyScoringDashboardService.computePercentiles` 对每名候选人扫描全部分数，复杂度 O(n²)。 +- `MessagingService.listConversations` 对每个会话分别加载最多 500 条消息和 read 状态，查询次数随会话数线性增长。 +- `PersonalDataCollector` 存在可批量化的数据读取。 +- 岗位关键字 `%keyword%` 与排序 filesort 是已记录风险，但未经产品和容量决策，不在 R01 直接改搜索技术栈。 + +## 3. 分批策略 + +### R01-A：请求身份与 requestId 基础设施 + +扩展既有 `CurrentUserAccessor`，使所有迁移入口统一拒绝 null、匿名、失效、空白、非 ASCII 数字、溢出和非正 userId。不得在 Controller 接受 userId 参数。 + +新增单一 `RequestIdAccessor`：优先读取 RequestIdFilter 已规范化的 request attribute；缺失时使用现有安全归一化逻辑，而不是信任任意长度请求头。响应、审计和日志必须使用同一 requestId。 + +按小批次迁移 Controller，每批最多 8 个类。每个调用点逐项锁定原 401/403 和资源归属语义；禁止机械全仓替换。 + +角色授权暂不与身份解析混在同一提交。先盘点后新增 `UserRoleGuard`，保持 USER_NOT_FOUND 与 FORBIDDEN 的现有差异，不增加隐式缓存。 + +### R01-B：异常映射和业务规则唯一来源 + +将业务错误码到 HTTP 状态的关系提取为不可变映射，启动或测试时检测重复和遗漏；默认仍为 400。不得更改任何现有映射。 + +提取唯一 `CandidateOverviewStatusPolicy`。评分引擎与竞争排名调用同一实现，并用参数化契约测试证明旧、新结果完全一致。 + +### R01-C：纯计算与可读性 + +将百分位改为“排序一次 + 分数组到 lower-rank 的映射”，复杂度 O(n log n)。并列分数必须获得相同百分位；null、小于 2 个有效分数、精度和 HALF_UP 规则保持不变。 + +拆分 `preferenceScore` 为命名明确的五个维度贡献函数。城市 30、用工类型 20、最低薪资 20、行业 15、岗位族 15 及缺失维度不计分的规则不得变化。 + +### R01-D：数据库查询收束 + +消息会话列表新增固定次数聚合查询，一次性按 conversationIds 计算未读数。定义保持：排除 RECALLED；发送者消息是否未读沿用当前 read-row 语义；不存在 read 行即未读。1/20/50 个会话查询次数必须固定。 + +`markRead` 是否突破 500 条属于独立语义问题，本轮先写失败证据和决策，不与列表未读优化混改。 + +PersonalDataCollector 按关联键批量读取；导出 JSON 字段、顺序、空值、脱敏与表范围不变。以 1/20/50 数据规模记录查询数和完整导出结果摘要。 + +### R01-E：真实环境复验 + +在 MySQL 8.4 上执行查询预算、结果等价和 EXPLAIN。不得把 H2 结果当成 MySQL 证据；不得为了 EXPLAIN 修改迁移或索引。 + +## 4. 关键契约 + +| 模块 | 必须保持 | +|---|---| +| 身份 | 非法主体为 401，不回显 principal，不产生业务写入 | +| 角色 | 原有 USER_NOT_FOUND/FORBIDDEN、角色组合与归属判断不变 | +| requestId | 最大长度、生成规则、响应头、响应体、MDC 与审计同源 | +| 异常 | 每个 ErrorCode 的 HTTP 状态与响应 body 不变 | +| 百分位 | `lower / (n-1) * 100`、并列同值、scale=2、HALF_UP | +| 推荐 | 五项权重和缺失项分母规则逐字保持 | +| 未读 | RECALLED 不计入；已有 read 行语义不变 | +| 导出 | 字段、隐私、顺序、内容与错误语义不变 | + +## 5. 证据要求 + +每一批必须先建立特征测试或失败测试，再改生产代码。性能结论必须同时包含结果等价断言、SQL 次数和反证测试；仅写“无 N+1”不算证据。 + +自动化最低门槛：定向测试、关联回归、`mvn test`、`mvn clean verify`、静态 OpenAPI；Failures/Errors/Skipped 均为 0。涉及 SQL 的批次还必须有真实 MySQL 黑盒。 + +## 6. 提交边界 + +每个子阶段独立分支检查点或独立提交；不得将 R01-A 到 R01-E 压成一个大提交。所有历史未跟踪日志和验收产物保留但不提交。不得使用 `git add -A`、reset、restore、checkout 或 clean。 diff --git a/docs/resume-api.md b/docs/resume-api.md index 97cdf4b..d9d3a5f 100644 --- a/docs/resume-api.md +++ b/docs/resume-api.md @@ -48,7 +48,7 @@ POST /profile/me/resume-versions (multipart/form-data) | 字段 | 必填 | 约束 | |---|---|---| -| `file` | 是 | PDF/DOC/DOCX，≤10MB，扩展名与 Content-Type 一致 | +| `file` | 是 | PDF/DOC/DOCX，≤10MB；扩展名、Content-Type 与实际文件结构必须一致 | | `name` | 否 | ≤120 字符，可空 | 默认状态 `ACTIVE`、**非默认**；版本号自动分配（`max+1`）。并发创建由 DB 唯一约束兜底，冲突自动重试（独立事务）。 @@ -157,6 +157,10 @@ GET /resume-export-tasks/{taskId}/download - 身份一律来自 JWT（`auth.getName()` = userId），**不信任请求体/路径中的 userId**； - 不能读取其他用户的简历（owner 校验）； - 不返回内部堆栈；错误响应不泄露数据库结构。 +- 上传文件名拒绝路径分隔符、控制字符和响应头换行；下载历史文件时再次净化文件名。 +- PDF 校验文件头和结尾标记；DOC 校验 OLE/Word 文档结构标记；DOCX 校验 OOXML 必需条目，并限制 ZIP 条目数、解压总量和压缩比，拒绝路径穿越及压缩炸弹。 +- 文件替换采用“新文件落盘 → 数据库更新 → 事务提交后删除旧文件”；回滚时清理新文件。底层本地存储先写 `.uploading` 临时文件，再原子移动到最终随机存储名，失败不暴露半文件。 +- 上述措施属于格式与资源安全校验，**不等同于病毒查杀或沙箱检测**；生产部署仍应在存储接入层配置恶意文件扫描。 ## 5. 异步导出设计 @@ -182,7 +186,7 @@ GET /resume-export-tasks/{taskId}/download 前置：启动基础设施 → 启动应用 → 导入 `docs/openapi-rc.json`（或 `GET /api/v1/v3/api-docs`）。 -1. 登录学生账号（Mock 验证码，见日志）。 +1. 登录学生账号（Mock 验证码：日志不再输出，本地按 `docs/frontend-integration.md` §3 的受控方式取得；生产禁止查表）。 2. `POST /profile/me/resume-versions`（multipart：`file` + `name=秋招版`）→ 200，`versionNo=1`。 3. 再次上传 → `versionNo=2`；设置 `name=社招版`。 4. `GET /profile/me/resume-versions` → 列表含两个版本。 @@ -199,6 +203,7 @@ GET /resume-export-tasks/{taskId}/download 4. **默认简历仅作用于版本体系**：不联动旧 `student_profiles.resume_url`（按确认保持独立）。 5. **被导出任务引用的旧文件可能延迟清理**：替换版本文件时，若旧文件正被 PENDING/RUNNING 导出任务引用则保留（保导出一致性）；任务结束后这些文件不会自动回收，需后续清理策略。 6. **OpenAPI 快照**：`docs/openapi-rc.json` 由 H2 集成测试上下文导出（**49 路径**，server URL 为测试默认值），接入现网后可用 `GET /api/v1/v3/api-docs` 重新导出。 +7. **不包含恶意软件扫描**：当前只执行文件格式、OOXML 结构、路径和资源消耗防护；不对宏、嵌入对象或恶意载荷作杀毒结论。 ## 10. 错误码（新增 82xx） @@ -211,3 +216,41 @@ GET /resume-export-tasks/{taskId}/download | 8205 | `DUPLICATE_DEFAULT_RESUME` | 409 | 并发设置默认冲突 | | 8206 | `RESUME_EXPORT_NOT_READY` | 409 | 导出任务未完成，不可下载 | +## S03-B：企业下载候选人简历 + +### `GET /company/candidates/{applicationId}/resume` + +新增的**唯一**企业侧简历读取入口。返回文件流，**不返回** `resumeUrl`、存储相对/绝对路径、 +学生用户 ID、手机号或邮箱。 + +- 认证：`Authorization: Bearer ` +- 路径参数：`applicationId`（本企业岗位下的投递） +- 响应：二进制文件流；`Content-Type` 只取自上传时已校验的白名单 + （`application/pdf`、`application/msword`、DOCX），否则回退 `application/octet-stream` +- 响应头：`Content-Disposition: attachment; filename*=UTF-8''<已净化文件名>`， + 以及 `Cache-Control: no-store`（私有简历不进任何中间缓存） +- 文件名继续经过 `ResumeFilenameSanitizer`，拒绝路径分隔符、控制字符与响应头换行 + +### 错误语义 + +| 场景 | 结果 | +|---|---| +| 未登录 / 无有效会话 | 401 | +| 非 COMPANY 角色（STUDENT / ADMIN） | 403 | +| 当前用户没有企业资料 | 403 | +| 投递不存在 | 404 `APPLICATION_NOT_FOUND` | +| 跨企业投递 | 403 | +| 隐私设置不允许（含 PRIVATE / 无设置） | 403 `FORBIDDEN` | +| 授权通过但学生没有简历 | 404 `PROFILE_NOT_FOUND` | + +### 授权与副作用 + +- 授权顺序：当前 COMPANY 用户 → 当前 Company → Application+Job → `Job.companyId` → + Student → privacy setting → profile/file。归属信息全部由服务端推导， + 不接受客户端传入的 `companyId`/`studentUserId`。 +- **拒绝路径不会调用存储读取**（测试以计数包装器验证为零次）。 +- 该接口只读：不修改 `student_profiles`、`resume_versions`、投递、评分、排名、推荐、邀约、 + 消息、通知或风险表；不发送 RabbitMQ、短信或邮件。 +- 学生本人的上传、下载、版本与导出接口语义完全不变。 +- 企业候选人列表/详情 DTO **仍不含** `resumeUrl`。 +- 不新增按 `studentUserId` 或 `candidateKey` 下载简历的入口；人才发现本轮不得直接下载简历。 diff --git a/docs/riasec-assessment-api.md b/docs/riasec-assessment-api.md new file mode 100644 index 0000000..c7cf79a --- /dev/null +++ b/docs/riasec-assessment-api.md @@ -0,0 +1,119 @@ +# RIASEC 职业兴趣测评 API（功能版本 **V35**，Flyway **V34__riasec_assessment.sql**） + +基于 RIASEC 理论的自研题库，仅供职业兴趣探索参考，不构成心理或职业诊断。 + +- **题库**：72 道（R/I/A/S/E/C 各 12），SELF_AUTHORED，reverseScored 恒为 false +- **每次答卷**：后端从六维中各随机抽取 5 道，共 30 道并持久化，刷新页面不重新抽题 +- **量表**：LIKERT_5 = 1 完全不感兴趣 … 5 非常感兴趣 +- **计分**：rawScore = 5 道之和，maxScore = 25，percentage = rawScore/25×100（HALF_UP, scale=2） +- **排序**：percentage DESC，同分按维度字母升序；前三位组成 `primaryCode` +- **结果**：仅 RIASEC 六维聚合分 + 排名 + 探索方向，不存储原始答案 +- **探索方向**：career-direction-v0.1，仅"可能感兴趣的职业探索方向" +- **只读/脱敏**：不写 candidate_dimension_scores；结果/审计不含原始题面、答案、手机号、邮箱、JWT + +## 权限 + +| 接口 | STUDENT | COMPANY | ADMIN | 未登录 | +| --- | --- | --- | --- | --- | +| 测评类型 GET /assessments/types | 200 | 200 | 200 | 401 | +| 题目 GET /assessments/{type}/questions | 200 | 200 | 200 | 401 | +| 创建答卷 POST /assessments/attempts | 200 | 403 | 403 | 401 | +| 答卷详情/保存/提交/结果 | 仅本人 | 403 | 403 | 401 | +| 我的历史 GET /assessments/me | 仅本人 | 403 | 403 | 401 | + +身份一律从 JWT 获取，不接受 userId 参数。 + +## 错误码（97xx） + +| code | 含义 | HTTP | +| --- | --- | --- | +| 9701 | ASSESSMENT_TYPE_NOT_FOUND | 404 | +| 9702 | ASSESSMENT_ATTEMPT_NOT_FOUND | 404 | +| 9703 | ASSESSMENT_ATTEMPT_INVALID_STATE | 409 | +| 9705 | ASSESSMENT_ANSWER_INVALID | 400 | +| 9706 | ASSESSMENT_INCOMPLETE | 400 | +| 9707 | ASSESSMENT_CONCURRENT_UPDATE | 409 | +| 9708 | ASSESSMENT_DUPLICATE_ACTIVE | 409 | +| 9709 | ASSESSMENT_IDEMPOTENCY_CONFLICT | 409 | + +重复提交不抛错，直接幂等返回成功（9704 预留，未使用）。 + +## 接口 + +### GET /api/v1/assessments/types +返回全部 ACTIVE 测评定义（typeCode、displayName、description、instructions、scaleType、questionCount=72、attemptQuestionCount=30、minPerDimension=5、questionSetVersion、rulesVersion）。 + +### GET /api/v1/assessments/HOLLAND_RIASEC/questions +返回指定测评的 ACTIVE 题目（按 position；类型非 ACTIVE 或不存在 → 404/9701）。对外隐藏 `dimension`、`reverseScored`、`source`、`questionVersion`、`questionCode`，仅返回： + +```json +{ "id": 301, "position": 1, "stem": "我对使用手工工具制作物品感兴趣。", "scaleType": "LIKERT_5" } +``` + +**不返回 `questionCode`**：题目内部编码（如 R01）前缀携带维度信息，一律不外露，前端不得用于推导 R/I/A/S/E/C 维度；维度归属仅由服务端计分使用。 + +### POST /api/v1/assessments/attempts +仅 STUDENT 且类型须为 **ACTIVE**（INACTIVE/不存在 → 404/9701）。请求：`{ "typeCode": "HOLLAND_RIASEC", "idempotencyKey": "uuid" }` +返回 attemptId、status、totalQuestions(30)、answeredCount、completionRate、questionSetVersion、version、本次 30 道题。不返回 samplingSeed。 + +**抽题严格约束**：六维各恰好 5 道、总数严格 30；任一维度 ACTIVE 题不足 5 道或六维不齐 → 拒绝创建（400），不静默减题。 + +**单活跃答卷（并发原子）**：同一学生同一类型同时最多一份 DRAFT/IN_PROGRESS。由数据库唯一约束 `uk_assessment_attempts_active` 原子兜底： +- 竞争失败的并发创建请求返回 `409/9708`（不得返回 500）； +- 同一 `idempotencyKey` 的并发重放返回已创建的原 attempt（幂等 `200`，同一 attemptId）； +- 仅数据库靠唯一约束判定归属，服务端不再复用被污染的 Hibernate Session 查询， + 写入与冲突判定分别使用独立事务/`REQUIRES_NEW`，创建外层显式 `READ_COMMITTED` 以读取已提交数据。 +- 答完提交（COMPLETED）后释放 `active_key`，允许重新测评。 + +### GET /api/v1/assessments/attempts/{attemptId} +仅本人。返回 30 道题（固定 position）、已保存答案、answeredCount、completionRate、version、当前状态。 + +### PATCH /api/v1/assessments/attempts/{attemptId}/answers +请求：`{ "version": 2, "answers": [ { "questionId": 301, "value": 4 } ] }` +支持单题/批量；同题重复保存 upsert；**同一请求内同题不得重复出现（重复 → 400/9705）**；value 1-5；题目必须属于本答卷；版本冲突 409/9707；首次保存后状态置 IN_PROGRESS。 + +### POST /api/v1/assessments/attempts/{attemptId}/submit +- answeredCount < 30 → 400/9706 +- 30 题（每维各 5）→ COMPLETED，生成结果，写审计，返回结果 +- 重复提交 → 200 返回原结果，不重复生成结果与审计 +- 不写入候选人评分表 + +### GET /api/v1/assessments/attempts/{attemptId}/result +答卷 COMPLETED 后返回： + +```json +{ + "attemptId": 101, + "typeCode": "HOLLAND_RIASEC", + "status": "COMPLETED", + "primaryCode": "SIC", + "primaryType": "S", + "dimensionScores": [ { "dimension": "S", "score": 88.00, "answeredCount": 5 } ], + "typeRanking": ["S", "I", "C", "R", "A", "E"], + "answeredCount": 30, + "completionRate": 100.00, + "questionSetVersion": "riasec-self-v0.2", + "rulesVersion": "riasec-scoring-v0.1", + "generatedAt": "2026-08-28T16:00:00", + "disclaimer": "本结果仅供职业兴趣探索参考，不构成心理或职业诊断。", + "explorationDirections": ["教育辅导", "用户运营", "客户成功", "职业咨询"] +} +``` + +不返回 studentUserId、phone、email、password、原始答案、企业信息、其他用户信息。 + +**越权：答卷题目、已保存答案与结果均仅本人（STUDENT）可读；COMPANY / ADMIN 越权访问一律 `403/2002`。**（来源：权限矩阵） + +### GET /api/v1/assessments/me?page=0&size=20 +分页返回当前学生的答卷与结果概要。 + +## 数据库（V34__riasec_assessment.sql，新增 6 张表） + +- `assessment_definitions`：测评定义（HOLLAND_RIASEC） +- `assessment_questions`：72 题，`UNIQUE(definition_id, question_code)`、`UNIQUE(definition_id, position)`、`CHECK(dimension IN R/I/A/S/E/C)`、`CHECK(reverse_scored IN 0,1)` +- `assessment_attempts`：答卷主记录，`@Version` 乐观锁，`UNIQUE(student_user_id, idempotency_key)`、`UNIQUE(active_key)`（单活跃原子约束，DRAFT/IN_PROGRESS 非空，终态置 NULL）、`CHECK(status IN DRAFT/IN_PROGRESS/COMPLETED/EXPIRED)` +- `assessment_attempt_questions`：本次抽中的 30 题，`UNIQUE(attempt_id, question_id)`、`UNIQUE(attempt_id, position)` +- `assessment_answers`：答案，`answer_value` 1-5（CHECK），`UNIQUE(attempt_id, question_id)`（API 层字段仍为 `value`） +- `assessment_results`：结果，`attempt_id` 唯一（幂等）。 + +`dimension_scores_text` / `type_ranking_text` 使用 TEXT 保存 JSON 字符串，兼容 MySQL 8 与 H2 MODE=MySQL。答案列使用 `answer_value`（避免 H2 保留字 `value`，该列名在 MySQL 与 H2 MODE=MySQL 下均兼容）。 \ No newline at end of file diff --git a/docs/risk-governance-api.md b/docs/risk-governance-api.md new file mode 100644 index 0000000..151038e --- /dev/null +++ b/docs/risk-governance-api.md @@ -0,0 +1,253 @@ +# V37 防刷风险概览与运营规则配置 + +> 状态：**已完成并通过真实 MySQL/Docker 黑盒验收（PASS=76 / FAIL=0 / SKIP=0）**。 +> 功能版本：V37；Flyway：`V36__risk_governance.sql`。 +> 基线：OpenAPI 148 paths / 182 operations；V35、V36、V37 待建立联合 Git 检查点。 + +## 1. 目标与边界 + +本模块为 ADMIN 提供确定性、可解释的防刷风险概览与规则配置能力。它将既有拒绝型安全审计事件转为可聚合的风险事件，供运营人员查看趋势、分布、明细及进行人工标记。 + +本版只做以下内容： + +- 基于既有 `audit_logs` 的规则型风险检测； +- ADMIN 风险概览、趋势、分布、事件列表； +- ADMIN 启停或调整阈值、窗口、等级； +- ADMIN 对风险事件做无自由文本的人工标记； +- 全链路审计、脱敏、幂等扫描与并发保护。 + +明确不做： + +- 自动封禁、自动警告、自动限制投递/消息/评分； +- AI 风控、设备指纹、地理位置、IP 归因、手机号或邮箱展示； +- 修改 V33 举报限流、屏蔽语义，或修改 V35/V36 测评和评分引擎； +- 企业端、学生端风险事件查询； +- 对历史 `audit_logs.details` 的回填、修复或删除。 + +## 2. 现有能力与输入范围 + +现有 `SecurityAuditService` 已以独立事务写入拒绝型安全审计，当前可安全复用且可关联用户的输入只有： + +| 审计 action | 来源 | 初始规则用途 | +| --- | --- | --- | +| `REPORT_RATE_LIMITED` | V33 举报第 11 次及以后被拒绝 | 一次命中即 HIGH 风险 | +| `BLOCKED_SEND_PROHIBITED` | V33 屏蔽关系下的新建私聊或发消息被拒绝 | 窗口内多次命中为 MEDIUM 风险 | + +`SMS_RATE_LIMITED` 当前不具备安全审计中的用户主体，且原始手机号不能进入风险库；本版不纳入。后续如需纳入，必须单独设计不可逆主体哈希和密钥治理。 + +风险计算只读取 `audit_logs` 的 `id/user_id/action/entity_type/entity_id/request_id/created_at`，不复制 `details/ip_address/user_agent`。 + +## 3. 风险规则 + +规则是确定性阈值条件：在 `windowMinutes` 滑动窗口内，某用户同类安全审计数量达到 `thresholdCount` 后，生成一条风险事件。事件是提醒，不改变业务权限。 + +初始种子规则： + +| ruleCode | sourceAction | thresholdCount | windowMinutes | severity | 默认启用 | +| --- | --- | ---: | ---: | --- | --- | +| `REPORT_RATE_LIMIT_BURST` | `REPORT_RATE_LIMITED` | 1 | 60 | HIGH | true | +| `BLOCKED_MESSAGE_BURST` | `BLOCKED_SEND_PROHIBITED` | 3 | 15 | MEDIUM | true | + +规则更新只影响后续扫描；不回溯重算、不会删除既有风险事件。若启用后需重新观察历史，应在未来另行设计“回放”操作，避免误产生大量旧告警。 + +## 4. 数据模型与 Flyway + +迁移文件为 `V36__risk_governance.sql`。V36 是功能版本号，Flyway 当前最新迁移为 V35，因此使用严格连续的 V36。 + +### 4.1 `scoring_rule_configs` + +| 字段 | 约束/用途 | +| --- | --- | +| `id` | PK | +| `rule_code` | `UNIQUE`，稳定规则标识 | +| `source_action` | 审计 action 白名单 | +| `threshold_count` | 1–100 | +| `window_minutes` | 1–1440 | +| `severity` | `LOW/MEDIUM/HIGH` | +| `enabled` | 是否参与后续扫描 | +| `version` | `@Version` 乐观锁 | +| `created_at/updated_at` | 审计时间 | + +### 4.2 `scoring_risk_events` + +| 字段 | 约束/用途 | +| --- | --- | +| `id` | PK；对外只返回此事件 ID | +| `rule_config_id` | FK → `scoring_rule_configs` | +| `subject_user_id` | 内部关联用户，**所有 API 响应均不返回** | +| `source_audit_log_id` | 触发本事件的审计记录；与 `rule_config_id` 联合唯一，保证扫描幂等 | +| `source_action` | 冗余快照，支持稳定统计 | +| `severity` | 生成时规则等级快照 | +| `window_started_at/window_ended_at` | 命中统计窗口 | +| `occurrence_count` | 命中数量 | +| `status` | `OPEN/ACKNOWLEDGED/DISMISSED` | +| `detected_at` | 检测时间 | +| `version` | 乐观锁 | + +索引：`(detected_at,status)`、`(severity,detected_at)`、`(rule_config_id,detected_at)`、`(subject_user_id,detected_at)`。 + +### 4.3 `scoring_risk_actions` + +风险事件人工操作历史。为防止运营备注成为新的个人信息载体，本版不提供自由文本 `note`。 + +| 字段 | 约束/用途 | +| --- | --- | +| `id` | PK | +| `risk_event_id` | FK → `scoring_risk_events` | +| `operator_user_id` | ADMIN 操作人，响应不返回 | +| `action` | `ACKNOWLEDGE/DISMISS` | +| `reason_code` | `MONITORING/CONFIRMED_FALSE_POSITIVE/OUT_OF_BAND_ESCALATED` | +| `created_at` | 操作时间 | + +### 4.4 `scoring_risk_scan_checkpoints` + +持久化扫描游标，解决应用重启、暂停或扫描耗时导致的审计事件遗漏问题。该表只保留一条 `checkpoint_key=RISK_EVENT_DETECTOR` 的记录。 + +| 字段 | 约束/用途 | +| --- | --- | +| `id` | PK | +| `checkpoint_key` | `UNIQUE`，固定为 `RISK_EVENT_DETECTOR` | +| `last_audit_log_id` | 已成功处理的最大 `audit_logs.id`，默认 0 | +| `version` | 乐观锁 | +| `updated_at` | 最近成功推进时间 | + +迁移同时为 `audit_logs` 新增 `(action, user_id, created_at, id)` 复合索引，仅优化风险扫描，不改变任何既有审计语义。 + +## 5. 检测与状态机 + +### 5.1 扫描器 + +`RiskEventDetector` 使用 `@Scheduled` 固定延迟扫描（默认 60 秒，可配置 `app.risk.scan.fixed-delay-ms`），其核心 `scanOnce()` 必须可被测试直接调用。每轮： + +1. 在一个事务中以悲观锁或等价机制锁定 `RISK_EVENT_DETECTOR` checkpoint； +2. 按 `audit_logs.id > last_audit_log_id`、升序、每批最多 500 条读取新增审计；仅处理 `user_id` 非空且 action 在规则白名单内的记录； +3. 读取全部 `enabled=true` 的规则。已禁用规则对应的新增审计会随游标跳过；重新启用不回放历史； +4. 以“当前审计记录时间 - windowMinutes”为窗口，统计同一用户、同一 action 的命中数； +5. **仅当命中数恰好等于 `thresholdCount`** 时生成事件，避免阈值之后的每次操作都刷出一条风险事件； +6. 按 `(rule_config_id, source_audit_log_id)` 原子插入事件；唯一键冲突视为已处理，不报错； +7. 成功处理整批后，在同一事务推进 `last_audit_log_id`；任何处理失败必须回滚，游标不得前进； +8. 写入 `RISK_EVENT_DETECTED` 审计，但 details 仅包含 `riskEventId/ruleCode/severity/occurrenceCount/requestId`。 + +扫描器不处理无用户主体的审计，也不会发送通知、修改用户状态或调用评分引擎。首版允许最长约 60 秒可见延迟。 + +### 5.2 事件状态机 + +```text +OPEN ──ACKNOWLEDGE──> ACKNOWLEDGED +OPEN ──DISMISS──────> DISMISSED +ACKNOWLEDGED ──DISMISS──> DISMISSED +``` + +`DISMISSED` 为终态；不能重新打开。每次合法状态变更新增一条 `scoring_risk_actions` 记录，并写 `RISK_EVENT_ACTIONED` 审计。 + +## 6. 接口契约（仅 ADMIN） + +除 `401` 外，所有非 ADMIN 情况统一 `403/2002`。Controller 从 JWT `SecurityContext` 取身份，禁止接受 `adminUserId/operatorUserId/userId` 参数。 + +| 方法 | 路径 | 说明 | +| --- | --- | --- | +| GET | `/admin/scoring/risk/overview` | 时间范围内 OPEN 总数、等级分布、规则分布、最近检测时间 | +| GET | `/admin/scoring/risk/trend` | 按 `HOUR/DAY` 聚合的事件趋势 | +| GET | `/admin/scoring/risk/distribution` | 按规则和风险等级聚合的事件分布 | +| GET | `/admin/scoring/risk/events` | 分页事件列表；可按 `status/severity/ruleCode/from/to` 筛选 | +| GET | `/admin/scoring/risk/rules` | 规则列表与当前版本 | +| PUT | `/admin/scoring/risk/rules/{ruleCode}` | 更新规则，须提供 `expectedVersion` | +| POST | `/admin/scoring/risk/events/{eventId}/actions` | `ACKNOWLEDGE/DISMISS` 人工操作 | + +预期 OpenAPI：`141 → 148 paths`，`175 → 182 operations`。 + +### 6.1 规则更新请求 + +```json +{ + "enabled": true, + "thresholdCount": 3, + "windowMinutes": 15, + "severity": "MEDIUM", + "expectedVersion": 2 +} +``` + +不允许修改 `ruleCode` 或 `sourceAction`，避免配置被用于监听未批准的审计类型。 + +### 6.2 事件操作请求 + +```json +{ + "action": "ACKNOWLEDGE", + "reasonCode": "MONITORING", + "expectedVersion": 0 +} +``` + +### 6.3 事件响应白名单 + +事件列表或详情只含：`eventId/ruleCode/sourceAction/severity/status/occurrenceCount/windowStartedAt/windowEndedAt/detectedAt/version`。 + +严禁含：`subjectUserId/phone/email/ipAddress/userAgent/requestId/details/Token/password/设备指纹`。 + +## 7. 错误码 + +新增 99xx 段： + +| code | 名称 | HTTP | +| ---: | --- | ---: | +| 9901 | `RISK_RULE_NOT_FOUND` | 404 | +| 9902 | `RISK_EVENT_NOT_FOUND` | 404 | +| 9903 | `RISK_RULE_CONCURRENT_UPDATE` | 409 | +| 9904 | `RISK_EVENT_CONCURRENT_UPDATE` | 409 | +| 9905 | `RISK_INVALID_ACTION` | 409 | +| 9906 | `RISK_INVALID_FILTER` | 400 | + +复用：未登录 `401/2001`、无权限 `403/2002`、分页或时间参数错误 `400/1001`。 + +## 8. 查询、脱敏与性能 + +- 全部 overview/trend/distribution 使用 SQL `GROUP BY` 投影，不在 Java 循环中逐事件查询规则或用户，避免 N+1； +- 事件列表分页 `page=0` 起、`size=1–50`；空结果为 `200 + items=[]`； +- 默认时间范围为最近 7 天，最大查询范围 90 天；`from > to` 或超出 90 天返回 `9906`； +- 对外 DTO 均使用字段白名单；不返回 `subject_user_id`； +- 不复制 `audit_logs.details/ip_address/user_agent` 至风险事件； +- 规则更新和事件操作均乐观锁；冲突不覆盖对方操作； +- 定时扫描使用 checkpoint 断点续扫；事件唯一键保证重复扫描不会重复产生事件，也不会因服务停机而漏掉未处理审计。 + +## 9. 审计 + +| action | 触发点 | details 白名单 | +| --- | --- | --- | +| `RISK_EVENT_DETECTED` | 系统检测到阈值事件 | `riskEventId/ruleCode/severity/occurrenceCount` | +| `RISK_RULE_UPDATED` | ADMIN 更新规则 | `ruleCode/enabled/thresholdCount/windowMinutes/severity/version` | +| `RISK_EVENT_ACTIONED` | ADMIN 标记风险事件 | `riskEventId/action/reasonCode/version` | + +审计 details 不允许写入用户身份、原始审计 details、IP、浏览器信息、请求正文或任何凭据。 + +## 10. 实现与测试计划 + +新增：4 Entity、4 Repository、`RiskEventDetector`、`RiskGovernanceService`、`AdminRiskController`、请求/响应 DTO、`V36__risk_governance.sql`、错误码与 OpenAPI 文档。 + +测试： + +- 单元：阈值、滑动窗口、规则禁用、仅阈值首次命中生成事件、checkpoint 断点续扫、扫描失败游标不前进、唯一键幂等、状态机、乐观锁、脱敏； +- MockMvc：ADMIN 成功、STUDENT/COMPANY 403、匿名 401、分页/时间参数、响应不含敏感字段； +- H2 持久化：Flyway、四表 FK/UNIQUE/CHECK、扫描重复执行只生成一条事件、checkpoint 并发锁、规则并发更新； +- MySQL/Docker 黑盒：插入本轮独立的安全审计夹具 → 等待扫描 → 验证概览/趋势/分布/事件/规则/人工操作；验证无自动封禁、无 `candidate_dimension_scores` 写入、队列排空，并回归 V33/V35/V36。 + +## 11. 验收与冻结条件 + +1. 专项与全量测试全绿； +2. `verify_openapi.py` 静态路径/操作数校验通过； +3. 真实 MySQL Flyway V36 成功，三表/索引/约束可查； +4. Docker 黑盒 `FAIL=0`，关键权限、去重、脱敏、队列、回归项不得 SKIP； +5. 风险事件不会改变用户状态、投递、消息、评分或候选人维度分； +6. 经负责人审阅精确提交范围后，才与 V35/V36 一并建立 Git 检查点。 + +## 12. 待负责人确认 + +建议按本稿锁定以下选择后再编码： + +1. 规则输入首版仅限 `REPORT_RATE_LIMITED` 与 `BLOCKED_SEND_PROHIBITED`； +2. 风险事件 API 不返回主体用户 ID，运营通过 `eventId` 处理，不做自动处置； +3. 保留 `POST /admin/scoring/risk/events/{eventId}/actions`，因此接口增量为 +7/+7； +4. 风险事件人工操作仅允许受控 `reasonCode`，不支持自由文本备注； +5. 使用 checkpoint 驱动的定时扫描（默认 60 秒）而非把风险检测同步耦合到业务请求； +6. 使用 `V36__risk_governance.sql` 与 9901–9906 错误码。 diff --git a/docs/s01-independent-mysql-acceptance-20260911.md b/docs/s01-independent-mysql-acceptance-20260911.md new file mode 100644 index 0000000..97669e3 --- /dev/null +++ b/docs/s01-independent-mysql-acceptance-20260911.md @@ -0,0 +1,483 @@ +# S01 认证安全上线阻断整改 · 独立代码复验与真实 MySQL/Docker 黑盒验收报告 + +- **验收日期**：2026-09-11 +- **验收性质**：独立验收（非功能开发）；使用真实 MySQL 8、最新 JAR、真实 HTTP 请求 +- **验收结论**：**FAIL**（已复现具体缺陷，S01 不可冻结） +- **报告文件**：`docs/s01-independent-mysql-acceptance-20260911.md` +- **验收产物目录**：`docs/acceptance/s01-20260911/`（脚本、请求体、日志、结果快照） + +> 本报告不包含数据库密码、.env 内容、JWT、验证码、完整手机号、明文测试口令与非法 principal 敏感标记原文。 + +--- + +## 1. Git 基线 + +| 项 | 实测值 | +|---|---| +| 分支 | `fix/resume-upload-safety` | +| HEAD | `cdafbf8ac93544a3ef89d0f3014f822a0d575f8f`（docs: update README for latest delivery baseline） | +| 最近 5 次提交 | cdafbf8 / 277b3c0 / dbd27e6 / cf39737 / 498512d | +| 暂存区 | **空**（未执行 `git add`） | +| `git diff --check` | 无空白错误（仅 CRLF 提示） | +| Flyway 迁移改动 | **无**（V1–V41 原样，共 41 个迁移文件，最大版本 41） | +| 新增迁移 | **无** | +| 工作区修改 | 20 个（S01 8 个 + 简历上传安全 12 个，均未提交） | +| 未跟踪文件 | 基线 106 个，全部保留；本轮新增验收产物 | +| AGENTS.md | **未发现**（仓库根、上级目录、`.claude/` 均无 AGENTS.md/CLAUDE.md/GEMINI.md/.cursorrules） | +| `.env` | 保留（365B） | + +**与 S01 无关的未提交修改（简历上传安全）已完整保护**：`profile/ProfileController.java`、`profile/ProfileService.java`、`profile/storage/LocalResumeStorageService.java`、`resume/ResumeVersionController.java`、`resume/ResumeVersionService.java`、`docs/frontend-integration.md`、`docs/resume-api.md` 及 5 个测试文件——本轮**未读取改写、未覆盖**，时间戳仍为 2026-09-10。 + +--- + +## 2. 独立代码审查结果（阶段 A） + +### A1 验证码/手机号日志 —— **PASS** + +| 检查项 | 结果 | 证据 | +|---|---|---| +| INFO/WARN/ERROR 不输出验证码 | ✅ | `SmsVerificationService` 仅 2 处 `log.warn`，参数为 `maskPhone(phone)`；`MockSmsCodeSender` 仅 1 条无参固定文本 | +| 不输出完整手机号 | ✅ | 实测 7 个验收手机号在全部日志中命中 **0** 次 | +| Mock 实现仅固定安全文本 | ✅ | `log.info("SMS verification code generated (mock sender)")` | +| Service 不把验证码传入日志参数 | ✅ | 全量检索无 `log.*code` 参数传递 | +| AuthService 不输出完整手机号 | ✅ | 仅 `log.info("Auto-created user: id={}")` | +| JWT 过滤器不记录 Token/subject/异常原文 | ✅ | 3 条固定文本，无 `e.getMessage()`、无 subject | +| 审计 details 不含完整手机号/验证码 | ✅ | 实测唯一 SMS_SEND 明细为 `phone=199****9999`（脱敏） | +| 异常消息不含敏感值 | ✅ | `SERVICE_UNAVAILABLE` 固定文本 `sms sender unavailable` | +| 不通过 toString/getMessage 间接泄露 | ✅ | 捕获的异常与堆栈均不含非法 principal 标记 | + +**唯一敏感标记复验**（真实 Logback 捕获 + 真实运行日志双通道）：标记手机号、真实验证码（3 个 DB 实际值）、JWT 前缀 `eyJ`、`Bearer ey`、mock 正文、非法 principal 标记、`NumberFormatException` —— 命中数**全部为 0**。 + +### A2 短信发送器装配 —— **PASS（3 种配置）+ 发现 1 处边界缺陷（见 F3）** + +| 检查项 | 结果 | +|---|---| +| Service 只依赖 `SmsCodeSender` 接口 | ✅ 单构造参数注入，无 if 分支复制双流程 | +| `true` → 仅 `MockSmsCodeSender` | ✅ 实测（`SmsSenderConfigurationTest` 4/4 + 运行期行为） | +| `false` → 仅 `UnavailableSmsCodeSender` | ✅ 实测 | +| 缺失 → 默认 `UnavailableSmsCodeSender` | ✅ 实测（D3a） | +| 单一 Bean / 无装配歧义 | ✅ 三次启动均成功（缺/多 Bean 会直接启动失败） | +| mock=false 不回退 Mock | ✅ 实测无 mock 事件 | +| 生产不意外启用 Mock | ✅ `application.yml` 默认 `SMS_MOCK_ENABLED:false` | +| `@ConditionalOnProperty` 精确性 | ✅ Mock=`havingValue="true"`（**无** matchIfMissing）；Unavailable=`havingValue="false", matchIfMissing=true`；name 与配置项 `app.sms.mock.enabled` 完全一致 | + +### A3 mock=false 失败事务 —— **PASS（MySQL 回滚）+ 1 项非阻断观察（F4）** + +- `@Transactional` 位于 `sendCode`；顺序：校验 → 锁定/限流 → 生成 → **`codeRepository.save`** → Redis 限流 → **`smsCodeSender.sendVerificationCode`** → 审计 +- `BusinessException extends RuntimeException` → 默认回滚；发送异常**未被捕获**，不转换为空成功 +- 真实 MySQL 实测：失败后 `sms_verification_codes` 完整字段前后**完全一致**（见第 6 节） +- 观察项：限流键在发送**之前**写入，失败后残留 60s（既有排序，非 S01 引入）→ F4 + +### A4 `CurrentUserAccessor` —— **PASS** + +拒绝：null / `!isAuthenticated` / `AnonymousAuthenticationToken` / 空或空白 name / `anonymousUser` / 非 ASCII 纯数字（含 `+42`、`" 42"`、`"42 "`、Unicode 数字）/ Long 溢出 / `userId<=0`。 +固定抛 `InsufficientAuthenticationException`（既有 `@ExceptionHandler(AuthenticationException)` → **HTTP 401**），**不回显、不记录**非法 principal，不新增 ErrorCode，不承担角色/归属判断，身份仅来自 SecurityContext。 + +### A5 `JwtAuthenticationFilter` —— **PASS** + +合法数字 subject 正常认证；缺失 Authorization → 匿名；无效签名/过期 → 既有 401；非数字 subject → **401 而非 500**；日志无 Token/subject/异常原文；`JwtTokenProvider` 未改动（Token 兼容语义不变）；**未声称修复 Refresh Token**。 + +### A6 `/jobs` 安全规则 —— **PASS** + +`SecurityConfig:119` 由 `.requestMatchers("/jobs").permitAll()` 改为 `.requestMatchers(HttpMethod.GET, "/jobs").permitAll()`，且该规则**先于** `.requestMatchers("/jobs/**").authenticated()` 求值，写请求确实命中 authenticated。 + +**全部 /jobs 映射与最终权限（21 个 operation，真实 HTTP 实测）** + +| 方法 | 路径 | 匿名 | STUDENT | COMPANY | ADMIN | 归属要求 | +|---|---|---|---|---|---|---| +| GET | `/jobs` | **200** | 200 | 200 | 200 | 无 | +| GET | `/jobs/search`、`/jobs/filters` | **200** | 200 | 200 | 200 | 无 | +| GET | `/jobs/public/{id}` | **200** | 200 | 200 | 200 | 无 | +| GET | `/jobs/{id}/reviews`、`/summary`、`/{reviewId}`、`/jobs/compare` | **200** | 200 | 200 | 200 | 无 | +| POST | `/jobs` | **401** | **403/2002** | **200** | **403/2002** | 需绑企业 | +| PUT | `/jobs/{id}` | **401** | 403/2002 | 200 | 403/2002 | **本企业**（他企业 400/7002） | +| PATCH | `/jobs/{id}/status` | **401** | 403/2002 | 200 | 403/2002 | **本企业**（他企业 400/7002） | +| DELETE | `/jobs/{id}` | **401** | — | — | — | 无该端点 | +| GET | `/jobs/{id}` | **401** | 403/2002 | 200 | 403/2002 | 本企业 | +| GET | `/jobs/{id}/match` | **401** | — | — | — | 登录 | +| GET | `/jobs/{id}/competition-ranking` | **401** | — | — | — | 登录 | +| POST/DELETE | `/jobs/{id}/favorite`、GET `/jobs/favorites` | **401** | — | — | — | 登录 | +| GET | `/jobs/{id}/personalized-review-score` | **401** | — | — | — | 登录 | + +**不依赖 Controller 解析 anonymousUser 失败来保护写接口**：匿名请求在安全层即被拒（响应无 `requestId` 字段，符合既有 `AuthenticationEntryPoint` 固定载荷）。 + +### A7 剩余直接身份解析 —— **PASS（无 permitAll 可达）= 但存量 43 处** + +- 全量检索（任意变量名）：`Long.(valueOf|parseLong)(*.getName())` 共 **43 处**，分布于 43 个文件 +- `.isAuthenticated()` 共 44 处；`anonymousUser` 字面量 5 处（`PersonalDataExportController`、`DeletionGuardInterceptor`×2、`AdminReviewReplyController`、`CompanyReviewManagementController`） +- **逐端点核验 permitAll 可达性**（按 SecurityConfig 匹配顺序，而非"路径要求认证"默认安全）： + - permitAll 路径共 19 条规则，涉及的控制器为 `AuthController`、`CompanyController`、`JobReviewController`、`JobController`、`MatchController`、`JobRecommendationController` + - **匿名可达的 8 个 GET 方法**（`listJobs`、`searchJobs`、`getFilters`、`getPublicJob`、`list`、`get`、`summary`、`compare`）**均不调用身份解析** + - `CompanyController` 的 `resolveUserId` 仅被 `/companies/me`（POST/GET/PUT）使用 → authenticated；`JobReviewController` 的 `resolveUserId` 仅被 create/update/delete 使用 → authenticated + - **结论：43 处中 0 处处于 permitAll 可达路径**，不构成 S01 发布阻断。`JobController` 已改用 `CurrentUserAccessor`（裸解析 0 处） +- 存量风险提示：`DeletionGuardInterceptor:51` 使用 `chars().allMatch(isDigit)` 预检，可挡 `anonymousUser`，但对 **20 位纯数字溢出**仍会抛 `NumberFormatException`（需合法签名 Token 才能到达）→ 列为后续轮次加固项 + +### A8 OpenAPI 与响应兼容 —— **PASS** + +- 路径/operation 数量：静态 173/211；**运行时 173/211**，一致 +- 唯一变更：`docs/openapi-rc.json` 2 行描述文本（移除"验证码会打印到日志"表述），无结构变更 +- 登录、发码、岗位请求/响应 Schema 未变（S01 未改任何 DTO） +- 无新增短信调试接口、无新增获取验证码接口 + +--- + +## 3. 自动化独立复验（阶段 B，实测重新执行） + +| 命令 | Tests run | Failures | Errors | Skipped | 结果 | +|---|---|---|---|---|---| +| `-Dtest="SmsVerificationSecurityTest,SmsSenderConfigurationTest,CurrentUserAccessorTest,AuthenticationBoundaryIntegrationTest"` | **40** | 0 | 0 | 0 | BUILD SUCCESS | +| `-Dtest="*Auth*Test,*Security*Test,*Sms*Test,*Job*Test"` | **214** | 0 | 0 | 0 | BUILD SUCCESS | +| `mvn test` | **1658** | 0 | 0 | 0 | BUILD SUCCESS（3:45） | +| `mvn clean verify` | **1658** | 0 | 0 | 0 | **BUILD SUCCESS**（4:31，产出 JAR 79,965,063B） | +| `python ../docs/verify_openapi.py` | — | — | — | — | paths 173 / operations 211 / **All checks passed!** | + +--- + +## 4. Docker / MySQL 环境（阶段 C） + +**启动前发现**：`docker ps` 为空，三个业务容器处于 **Exited**（约 2 小时前，139/0/137 退出码），**volume 数据完好**。容器标签显示由 `Desktop\qinghe\backend-infra\compose.yaml` 创建（项目名 `backend-infra`）。 + +**本轮处置（非破坏性，已记录）**：仅执行 `docker start mydreamjob-mysql mydreamjob-redis mydreamjob-rabbitmq`——**未重建容器、未删除 volume、未清空数据库、未触碰其余 3 个无关孤立容器、未停止 Docker**。 + +| 项 | 实测值 | +|---|---| +| Docker Server | 29.6.2 | +| MySQL | **8.4.11**（`127.0.0.1:3307`，healthy） | +| Redis | 7.4-alpine（`6379`，healthy） | +| RabbitMQ | 3.13-management-alpine（`5672/15672`，healthy） | +| 验收数据库 | `mydreamjob` | +| Flyway | 41 条，**success=1 全部成功**，0 失败，最大版本 **41**（`41 message recall`） | +| S01 新增迁移 | **无** | + +**已修复的验收环境问题（脚本层，非项目缺陷）**：Git Bash(MSYS) 会把裸 `/` 的 `RABBITMQ_VHOST` 自动改写为 Git 安装根路径，导致 `530 NOT_ALLOWED vhost not found`。经在验收脚本中清除该变量（交由 `application.yml` 默认值 `/` 承接）后，RabbitMQ 错误数 **0**。 + +--- + +## 5. 三种配置启动验证（阶段 D，均为最新 `mvn clean verify` JAR） + +| 场景 | 启动 | SmsCodeSender 实际实现 | 发码行为 | 日志敏感值 | 判定 | +|---|---|---|---|---|---| +| **D1** `mock=true` | ✅ Started 26.5s，health 200，8080 监听 | **MockSmsCodeSender**（固定事件文本命中 1 次） | HTTP **200**（非 500） | 0 | **PASS** | +| **D2** `mock=false` | ✅ Started 26.4s | **UnavailableSmsCodeSender**（无 mock 事件） | HTTP **400** `{"code":400,"message":"sms sender unavailable"}` | 0 | **PASS** | +| **D3a** 属性完全缺失 | ✅ Started 27.5s | **UnavailableSmsCodeSender**（未回退 Mock） | HTTP **400** 同上 | 0 | **PASS** | +| **D3b** 属性存在但为空值 | ❌ **APPLICATION FAILED TO START** | **无 Bean** | — | — | **FAIL（F3）** | + +每次启动均记录 profile（无 profile，基础 `application.yml`）、PID、端口、实现、Started 日志、health 状态；**仅停止本轮启动并记录 PID 的 JAR**（每次均以 `Get-CimInstance Win32_Process` 校验命令行确为 `zhilai/mydreamjob-server/target/*.jar`）。 + +--- + +## 6. 真实 MySQL 验证码事务回滚（阶段 E） + +**mock=false（发送失败回滚）**——完整字段快照对比，非 COUNT(*)： + +| 指标 | BEFORE | AFTER | 结论 | +|---|---|---|---| +| 该手机号记录数 | 0 | 0 | ✅ | +| 全局 MAX(id) | 990 | 990 | ✅ 无新增 | +| 全局总行数 | 917 | 917 | ✅ | +| 未使用(used=0)记录数 | 0 | 0 | ✅ 无可用残留 | +| SMS_SEND 审计总数 | 819 | 819 | ✅ 无虚假成功审计 | +| 完整字段差异 | — | — | ✅ **前后完全一致** | + +无半提交、无 attempts 异常、无错误锁定状态更新。HTTP **400**（非虚假成功）。 + +**mock=true（完整链路）**： +1. 发送 → HTTP 200，DB 生成 1 条记录（验证码值仅存于库内，报告不复制） +2. 从 DB 取码 → `POST /auth/login` → HTTP **200**，响应含 `accessToken/refreshToken/expiresIn/nickname/phone/role/userId`，响应内**不含验证码明文** +3. 登录后该记录 `used=1`、`attempts=0`（一次性消费语义不变） +4. **重放同一验证码 → HTTP 400**（拒绝） +5. 日志与审计仍不含验证码/完整手机号 +6. 长度/有效期/最大尝试次数/锁定时间语义未变（`SmsVerificationSecurityTest` 10/10 覆盖） + +--- + +## 7. 真实 HTTP 权限矩阵（阶段 F） + +见第 2 节 A6 表格。关键断言全部成立： + +- **匿名 POST /jobs = HTTP 401（`code=401`），不是 500** ✅ +- STUDENT / ADMIN POST /jobs = **403 / 2002** ✅ +- COMPANY POST /jobs = **200** ✅（生成 id=43） +- 他企业 PUT/PATCH = **400 / 7002**（既有语义，未擅改）✅ +- 公开 GET（`/jobs`、`/search`、`/filters`、`/public/{id}`、`/{id}/reviews`）语义不变 = 200 ✅ +- 每条请求均记录 method / path / HTTP / business code / requestId + +**jobs 表副作用（完整字段对比，非 COUNT）**： + +``` +差异仅：新增 JOB:43|company_id=22|S01_ACC_*_job|PUBLISHED|...|requirements=S01_ACC_ok + TOTAL_JOBS 27 → 28 +TAMPERED_TITLE=0 ← 他企业篡改尝试零落库 +其余全部 JOB 行逐字段未变 +``` + +--- + +## 8. 非法 Token / principal 黑盒（阶段 G） + +对受保护端点 `POST /jobs` 的真实 HTTP 请求（含合法请求体）： + +| 用例 | HTTP | business code | 响应回显敏感标记 | 判定 | +|---|---|---|---|---| +| 无 Authorization | 401 | 401 | no | ✅ | +| 合法数字 subject（学生 7936） | **403** | **2002** | no | ✅ 正常进入既有权限判断 | +| `subject=anonymousUser` | **401** | 401 | no | ✅ | +| 受控非法 principal 标记 | **401** | 401 | no | ✅ 非 500 | +| subject 缺失（空） | 401 | 401 | no | ✅ | +| `subject=0` | 401 | 401 | no | ✅ | +| `subject=-1` | 401 | 401 | no | ✅ | +| subject 超出 Long 范围 | 401 | 401 | no | ✅ | +| 过期 Token | 401 | 401 | no | ✅ | +| 签名被篡改 | 401 | 401 | no | ✅ | + +**无任何用例返回 500；响应与日志均未回显 subject 或 Token；jobs 表完整内容零变化（无业务写入）** ✅ + +Token 生成方式：验收专用 HS256 离线生成（复用项目 `JWT_SECRET` 环境变量，**未落盘、未输出**）；外部 HTTP 无需伪造即可安全覆盖全部用例，故未降级为纯集成测试。 + +--- + +## 9. 日志与审计全量脱敏（阶段 H） + +仅扫描**本轮**日志（D1/D1b/D2/D3a/D3b 的 app + stdout）： + +| 禁止项 | 命中 | 说明 | +|---|---|---| +| 验证码明文（3 个 DB 实际值） | **0** | | +| 完整手机号（7 个验收号） | **0** | | +| JWT（`eyJhbGci`、`Bearer ey`） | **0** | | +| Authorization 头值 | **0** | 16 处 `authorization` 均来自 D3b 启动失败堆栈的 `AuthorizationFilter.doFilter` | +| secret | **0** | | +| 非法 principal 标记 | **0** | | +| `NumberFormatException` 堆栈 | **0** | | +| Mock 短信正文 | **0** | `MOCK SMS CODE` 命中 0 | +| `password` | ⚠️ 16 | 全部为 Spring Boot 默认 `Using generated security password: ` → **F5（既有行为，见第 12 节）** | + +**审计表（audit_logs）**：完整手机号命中 **0**、非法 principal 命中 **0**、Token 命中 **0**、脱敏手机号命中 **1**（唯一 SMS_SEND 明细 `phone=199****9999`）✅ + +**允许项**：脱敏手机号、固定事件名、requestId、固定 purpose 均正常。 + +--- + +## 10. 运行时 OpenAPI（阶段 I） + +| 项 | 值 | +|---|---| +| 访问地址 | `GET /api/v1/v3/api-docs`（应用 `context-path=/api/v1`；裸 `/v3/api-docs` 返回 404 属预期） | +| HTTP | 200 | +| 运行时 paths / operations | **173 / 211** | +| 静态 paths / operations | 173 / 211 | +| 一致性 | **PASS** | +| 短信相关路径 | 仅 `/auth/sms/send`（无新增调试/取码接口） | +| `/jobs` 路径数 | 15 | +| `/auth/sms/send` 描述 | 已不再声称验证码输出到日志/控制台 ✅ | + +--- + +## 11. 文档一致性核查（阶段 13）—— **FAIL** + +**仍指导从日志读取验证码的文档（精确文件:行号）**： + +| 文件 | 行号 | 内容（已脱敏） | 性质 | +|---|---|---|---| +| `docs/acceptance-week1.md` | 94 | `# Mock 登录（从日志获取验证码）` | 历史验收记录 | +| `docs/acceptance-week1.md` | 148 | 注: 验证码从应用日志中获取 | 历史验收记录 | +| `docs/acceptance-week1.md` | 152 | 验证码打印到日志，不发送真实短信 | 历史验收记录 | +| `docs/api-v0.1.md` | 27 | Mock 环境验证码打印到日志 | 历史 API 文档 | +| `docs/api-v0.1.md` | 174 | 短信验证码为 Mock 实现，验证码打印到日志 | 历史 API 文档 | +| `docs/frontend-integration.md` | 37,39,42,144 | "Mock 验证码日志位置"、"打印在服务控制台/stdout 日志中"、旧示例行 `MOCK SMS CODE: phone=138****0002, … code=******` | **前端接入文档（在途修改文件，本轮不可改）** | +| `docs/offer-api.md` | 262 | 测试账号（Mock 验证码，见日志） | 活文档 | +| `docs/resume-api.md` | 189 | 登录学生账号（Mock 验证码，见日志） | **在途修改文件** | +| **`docs/smoke-test.sh`** | **64-71** | **`sms_code()`：`grep -a "MOCK SMS CODE.*phone=$PHONE" $log \| … \| grep -oE 'code=[0-9]{6}'`** | **git 跟踪的既有可执行脚本（见 F1）** | + +`README.md:167` 表述正确（禁止写入敏感信息），**不计入违规**；`docs/openapi-rc.json:1449` 已修正 ✅。 + +--- + +## 12. RabbitMQ 与外围终态（阶段 14） + +| 项 | 实测值 | +|---|---| +| 队列 | `queue.sms.verification`、`queue.notification`、`queue.audit`、`queue.notification.dlq` | +| ready / unacked | **全部 0 / 0** | +| mock=false 失败后 notifications 增量 | **0** | +| mock=false 失败后 SMS_SEND 审计增量 | **0**（无虚假发送成功审计） | +| 匿名岗位写请求副作用 | jobs/notifications/audit 均无新增 | +| 无与 S01 无关的表变化 | ✅（仅本轮验收夹具，已精确清理） | +| 容器终态 | 3 容器仍 Up（healthy）；**未停止 Docker** | + +--- + +## 13. PASS / FAIL / SKIP 清单 + +| # | 验收项 | 结果 | +|---|---|---| +| A1 | 验证码/手机号不进入日志与审计 | **PASS** | +| A2 | SMS 发送器装配（true/false/缺失） | **PASS** | +| A2′ | 空值边界下的 Bean 唯一性 | **FAIL**（F3） | +| A3 | mock=false 失败事务回滚（真实 MySQL） | **PASS**（F4 为非阻断观察） | +| A4 | CurrentUserAccessor 边界 | **PASS** | +| A5 | JwtAuthenticationFilter 边界 | **PASS** | +| A6 | /jobs 匹配顺序与权限矩阵 | **PASS** | +| A7 | 无 permitAll 可达的直接身份解析 | **PASS**（存量 43 处均不可匿名到达） | +| A8 | OpenAPI 与响应兼容 | **PASS** | +| B | 自动化复验（40/214/1658/clean verify） | **PASS** | +| C | Docker/MySQL/Flyway | **PASS** | +| D | 三种配置启动 | **PASS**（D1/D2/D3a）| +| E | 真实 MySQL 回滚 + mock=true 链路 | **PASS** | +| F | 真实 HTTP 权限矩阵 | **PASS** | +| G | 非法 Token/principal 黑盒 | **PASS** | +| H | 日志与审计脱敏（`password` 项除外） | **PASS** | +| I | 运行时 OpenAPI | **PASS** | +| 13 | 文档不再指导从日志读取验证码 | **FAIL**（F1、F2） | +| 14 | RabbitMQ 与外围绕 | **PASS** | +| — | SKIP | **0**（核心验收项无 SKIP） | + +**FAIL 计数：3**（F1、F2、F3） + +--- + +## 14. 缺陷详情（可复现） + +### F1（阻断）项目自带冒烟脚本因 S01 改动而失效 + +- **文件/方法**：`docs/smoke-test.sh` → `sms_code()`（第 64-71 行，git 跟踪，提交 `b01616d`） +- **缺陷**：该函数依赖被 S01 删除的日志行 `MOCK SMS CODE: phone=…, code=…` 提取验证码 +- **复现**： + ```bash + LOG=<本轮 mock=true 应用日志> + grep -a "MOCK SMS CODE.*phone=<验收手机号>" "$LOG" | tail -n 1 | grep -a -oE 'code=[0-9]{6}' | cut -d= -f2 + ``` +- **实际结果**：输出为空 → `SMS=""` → 后续登录步骤拿不到验证码，冒烟流程中断 +- **期望结果**：脚本应从数据库/受控夹具取得验证码（与 S01 新语义一致） +- **影响**：既有可执行验收工具**功能性回归**；S01 整改报告将其列为"文档遗留"但未识别此处为**可执行依赖** + +### F2（阻断，对应验收标准第 17 项）文档仍指导从日志读取验证码 + +- **文件/行号**：见第 11 节表格（`acceptance-week1.md:94,148,152`、`api-v0.1.md:27,174`、`frontend-integration.md:37,39,42,144`、`offer-api.md:262`、`resume-api.md:189`） +- **实际结果**：文档仍声称"验证码打印到日志/控制台"并指导据此取码 +- **期望结果**：明确"日志不再输出验证码"；dev/test 通过**受控测试夹具或数据库内部验收方式**取码；禁止生产查询验证码表完成登录；说明 `mock=false` 且无真实供应商时返回服务不可用；真实短信供应商待单独接入 +- **约束**：`docs/frontend-integration.md`、`docs/resume-api.md` 属**在途修改文件**，本轮不得改动 + +### F3（非阻断但违反 A2 明确要求）空值配置导致启动失败 + +- **文件**：`auth/sms/MockSmsCodeSender.java`（`@ConditionalOnProperty(name="app.sms.mock.enabled", havingValue="true")`）与 `auth/sms/UnavailableSmsCodeSender.java`（`havingValue="false", matchIfMissing=true`） +- **缺陷**：属性**存在但为空值**（如 env 中 `SMS_MOCK_ENABLED=`）时，两个条件都不匹配 → **0 个 `SmsCodeSender` Bean** +- **复现**：`java -jar target/mydreamjob-server-*.jar --app.sms.mock.enabled=` （其余同 D2） +- **实际结果**： + ``` + APPLICATION FAILED TO START + Parameter 3 of constructor in com.mydreamjob.auth.SmsVerificationService required + a bean of type 'com.mydreamjob.auth.sms.SmsCodeSender' that could not be found. + ``` +- **期望结果**：任何取值（含空值/空白）都应至少装配一个实现，绝不因缺少 Bean 以模糊 Spring Bean 错误启动失败（原工作令第 11 条） +- **影响**：部署可用性风险（空 env 变量在生产会致全站不可启动）；未造成数据泄露 + +### F4（观察，非阻断）失败后残留限流键 + +- 现象：mock=false 发送失败后 `sms:rate:` 残留（TTL 60s），60s 内重试返回 `code=400 sms rate limited` 而非 `sms sender unavailable` +- 定性：**既有排序**（限流键在发送前写入），S01 未改变该顺序；MySQL 无残留有效验证码；不属冻结阻断项 +- 建议：后续轮次评估失败时释放限流键或调整写入顺序 + +### F5（观察，非阻断，既有行为）Spring Boot 默认安全口令入日志 + +- 现象：日志出现 `Using generated security password: ` +- 定性：Spring Boot `UserDetailsServiceAutoConfiguration` 默认行为；**经历史日志比对确认 S01 之前即存在**（`mydreamjob-server/logs/backend-startup.log` 等） +- 可利用性：应用未启用 httpBasic/formLogin，该口令无 HTTP 认证入口消费 → 不可用于登录 +- 建议：后续轮次排除 `UserDetailsServiceAutoConfiguration` 或显式声明 `AuthenticationManager` + +--- + +## 15. 剩余风险 + +1. **F1/F2 未修复前，开发/测试人员仍会按文档从日志找验证码 → 必然失败并误判"系统故障"** +2. 存量 43 处直接身份解析（均不可匿名到达，但缺乏统一 `CurrentUserAccessor` 收口）；`DeletionGuardInterceptor` 对 20 位数字溢出仍可能 500 +3. 验证码仍以明文存储于 `sms_verification_codes.code`（本轮未改表结构，属已知遗留） +4. 真实短信供应商未接入；生产 `mock=false` 下所有发码请求均安全失败（设计如此，但需产品确认上线策略） +5. 安全层 401 响应不含 `requestId`（既有 `AuthenticationEntryPoint` 固定载荷），与业务层错误响应格式不一致，不利于链路追踪 +6. 本轮验收脚本依赖 Git Bash 环境变量语义（vhost 转换问题已规避并记录） + +--- + +## 16. 是否允许冻结 S01 + +**不允许冻结。** + +自动化指标（1658/1658、clean verify、静态与运行时 OpenAPI 173/211）全部达成，核心安全目标（日志脱敏、`SMS_MOCK_ENABLED` 生效、匿名 POST /jobs 401、非法 subject 401 不回显、真实 MySQL 回滚）**均已独立复验通过**；但存在 3 项 FAIL（F1 可执行脚本回归、F2 文档违规指导、F3 空值启动失败），其中 F2 直接命中验收标准第 17 项，F1 为可执行功能回归。 + +--- + +## 17. S01 下一轮定向整改指令 + +### R1 —— 修复冒烟脚本取码方式（对应 F1） + +- **文件**：`docs/smoke-test.sh` +- **方法**：`sms_code()` +- **错误数据/逻辑**：`grep -a "MOCK SMS CODE.*phone=$PHONE" "$log_path" | tail -n 1 | grep -a -oE 'code=[0-9]{6}' | cut -d= -f2` +- **复现请求**：`bash docs/smoke-test.sh`（mock=true 环境，日志中已无该行） +- **实际结果**：返回空字符串，登录步骤失败 +- **期望结果**：改为受控来源取码，二选一—— + 1. 数据库内部查询（推荐，仅限本地/测试）： + `SELECT code FROM sms_verification_codes WHERE phone=? AND purpose='login' AND used=0 ORDER BY id DESC LIMIT 1;` + 2. 或由测试夹具直接注入固定验证码记录后读取 +- **必须新增的失败测试**：新增独立脚本断言 `sms_code()` 在"日志不含 `MOCK SMS CODE`"时仍能返回 6 位码（当前实现必然失败） +- **禁止的绕过**：不得恢复 `MOCK SMS CODE` 日志行；不得让脚本读取生产日志取码 + +### R2 —— 修正文档中的取码指引（对应 F2，命中验收标准第 17 项） + +- **文件与行号**：`docs/acceptance-week1.md:94,148,152`；`docs/api-v0.1.md:27,174`；`docs/offer-api.md:262`；`docs/frontend-integration.md:37,39,42,144`；`docs/resume-api.md:189` +- **错误内容**：声称"验证码打印到日志/控制台"并指导据此取码（含旧示例行） +- **复现**：`rg -n "控制台|日志.*验证码|MOCK SMS|验证码.*日志|查看验证码" docs README.md` +- **实际结果**：上述 10 处仍存在 +- **期望结果**：统一替换为—— + - 日志不再输出验证码； + - dev/test 环境通过**受控测试夹具或数据库内部验收方式**取得验证码； + - **禁止生产环境查询验证码表完成登录**； + - `mock=false` 且未接入真实供应商时返回"服务不可用"，绝不返回虚假成功； + - 真实短信供应商仍待单独接入。 +- **协调要求**：`docs/frontend-integration.md`、`docs/resume-api.md` 属**简历上传安全**在途修改文件，需与该项变更方**合并处理**，避免互相覆盖 +- **必须新增的失败测试**：新增文档门禁测试（或 CI 检查）断言 `docs/**` 与 `README.md` 不再匹配 `MOCK SMS CODE|验证码.*打印.*日志|控制台.*验证码|见日志.*验证码` +- **禁止的绕过**：不得删除或改写为同义表述；不得仅在 README 声明而保留违规正文 + +### R3 —— 空值配置不再导致启动失败（对应 F3） + +- **文件**：`auth/sms/MockSmsCodeSender.java`、`auth/sms/UnavailableSmsCodeSender.java`（必要时新增无条件兜底实现） +- **错误配置**：`app.sms.mock.enabled=`（存在但空） +- **复现请求**：`java -jar target/mydreamjob-server-0.0.1-SNAPSHOT.jar --app.sms.mock.enabled=`（DB/Redis/RabbitMQ 同 D2） +- **实际结果**：`APPLICATION FAILED TO START … required a bean of type 'SmsCodeSender' that could not be found` +- **期望结果**：启动成功并装配 `UnavailableSmsCodeSender`（空值、空白值、缺失、`false` 四者行为一致；仅显式 `true` 才装配 Mock） +- **必须新增的失败测试**（`SmsSenderConfigurationTest` 内新增，不改动既有断言）： + - `emptyPropertyStillProvidesUnavailableSender` + - `blankPropertyStillProvidesUnavailableSender` + - `exactlyOneSenderBeanForEveryValueIncludingEmpty` +- **禁止的绕过**：不得让 Mock 成为 `matchIfMissing` 默认；不得用 `@Primary` 掩盖歧义；不得让应用以空 Bean 启动（必须真实拒绝发码，不得伪造成功） + +### R4 —— 非阻断建议（可与上轮合并，不单独阻断冻结） + +1. `DeletionGuardInterceptor:60` 增加溢出安全解析（复用 `CurrentUserAccessor` 语义） +2. 评估失败时释放 `sms:rate:` 限流键（F4） +3. 排除 `UserDetailsServiceAutoConfiguration` 或显式声明 `AuthenticationManager`（F5） +4. 统一为安全层 401 响应补充 `requestId`（便于链路追踪） + +--- + +## 18. 验收产物清单（`docs/acceptance/s01-20260911/`） + +| 文件 | 用途 | +|---|---| +| `launch.sh` | 三种配置启动器（true/false/MISSING/EMPTY） | +| `gen-token.js` | 验收专用 HS256 Token 离线生成（密钥仅取自环境变量，不落盘） | +| `matrix.sh` / `matrix-results.txt` | 阶段 F 权限矩阵脚本与结果 | +| `phase-g.sh` / `phase-g-results.txt` | 阶段 G 非法 Token 边界脚本与结果 | +| `snapshot-jobs.sql` / `jobs-before.txt` / `jobs-after.txt` / `jobs-before-g.txt` / `jobs-after-g.txt` | jobs 表完整字段快照与对比 | +| `snapshot-sms.sql` / `before-mockfalse.txt` / `after-mockfalse.txt` | 阶段 E 验证码表回滚对比 | +| `job-body.json` / `tamper-body.json` / `status-body.json` / `ok-body.json` | 请求体夹具（ASCII，避免 shell 编码问题） | +| `d1*/d2*/d3*` 日志 | 三次配置启动的应用日志与 stdout | +| `runtime-openapi.json` | 运行时 OpenAPI 快照 | +| `acc-fixture.txt` / `acc-prefix.txt` | 验收夹具 ID 记录（已清理） | +| `sensitive-markers.txt` | 敏感标记清单（内容未写入报告） | + +**验收数据清理**：按精确 ID 与前缀删除 users(7933-7937)/companies(22,23)/jobs(42,43)/sms_verification_codes(1)，Redis 验收键已清理；**保留**本轮窗口内 2 条 audit_logs（append-only 合规记录，不做删除）；`jobs` 总数回到基线 26。清理前后均确认目标归属，无模糊 DELETE。 + +--- + +**已复现具体缺陷，S01不可冻结；验收报告已包含下一轮定向整改指令。** diff --git a/docs/s01-independent-mysql-acceptance-20260914.md b/docs/s01-independent-mysql-acceptance-20260914.md new file mode 100644 index 0000000..86f2d58 --- /dev/null +++ b/docs/s01-independent-mysql-acceptance-20260914.md @@ -0,0 +1,288 @@ +# S01 最终真实 MySQL / Docker 增量复验报告（脱敏版） + +- **验收日期**：2026-09-14 +- **分支**：`fix/resume-upload-safety` +- **范围**：只验证 S01 第四轮整改（F6：`expires_at` → `expired_at`）后的**真实运行路径**；本轮**未修改任何代码** +- **结论**：**PASS** +- **本报告不含**：验证码值、完整手机号、JWT、`Authorization` 头、数据库口令、`.env` 内容 + +> 本轮为此前因 Docker Linux Engine 未运行而 BLOCKED 的复验。本次 Docker Engine 可用，全部真实黑盒已执行完成。 + +--- + +## 1. 基线与边界 + +| 项 | 实测 | +|---|---| +| 分支 | `fix/resume-upload-safety` | +| 暂存区 | **空**（`git diff --cached --name-only` 无输出） | +| `git diff --check` | 无空白错误（仅 CRLF 提示） | +| 迁移改动 | **无**（`git diff --name-only -- db/migration` 无输出；41 个文件，最大 `V41__message_recall.sql`） | +| 已跟踪改动 | 24 个（**全部来自此前几轮**：7 个 docs + 11 个 java main + 6 个 java test），本轮 **0 新增** | +| 删除文件 | **0** | +| 历史未跟踪文件 | 未删除、未移动、未覆盖 | + +本轮**未修改**：生产代码、现有测试、`docs/smoke-test.sh`、`V1–V41`；**未新增** Flyway/表/索引/`ErrorCode`/接口；**未恢复**验证码日志。 + +## 2. Docker 环境 + +| 项 | 值 | +|---|---| +| Docker Engine | 29.6.2（Docker Desktop 4.84.0，linux/amd64） | +| `mydreamjob-mysql` | **healthy**（mysql:8.4，127.0.0.1:3307→3306） | +| `mydreamjob-redis` | **healthy**（redis:7.4-alpine） | +| `mydreamjob-rabbitmq` | **healthy**（rabbitmq:3.13-management-alpine） | + +进入本轮时三个容器均为 `Exited`（2 天前停止）。经负责人明确授权后，对**已存在的具名容器**执行 `docker start`：**未重建容器、未改动配置、未触碰 volume（`mysql_data`/`redis_data`/`rabbitmq_data` 均保留）**。验收结束后容器保持运行，由负责人决定是否停止。 + +## 3. 真实 Schema 对账 + +真实 MySQL 执行 `SHOW COLUMNS FROM sms_verification_codes`（**应用账号 + `MYSQL_PWD`，非 root**）： + +``` +id phone code purpose attempts max_attempts expired_at used created_at +``` + +三方对账**完全一致**： + +| 来源 | 列集合 | +|---|---| +| 真实 MySQL | `attempts code created_at expired_at id max_attempts phone purpose used` | +| 实体 `@Column` | 同上 | +| `V1__base_schema.sql` | 同上 | + +- **包含 `expired_at`** ✅ +- **不包含 `expires_at`** ✅ + +**反证**：`SELECT expires_at FROM sms_verification_codes LIMIT 1;` → `ERROR 1054 (42S22) Unknown column 'expires_at' in 'field list'`（退出码 1）。 + +## 4. 真实取码 SQL + +修复后的等价只读查询在真实 MySQL 执行： + +```sql +SELECT code FROM sms_verification_codes + WHERE phone = ? AND purpose = ? AND used = 0 + AND expired_at > NOW() + ORDER BY created_at DESC, id DESC LIMIT 1; +``` + +**退出码 = 0，无 `ERROR 1054`**。（查询返回行数按参数而定，本报告不展示任何取回的 `code`。） + +## 5. 最新 JAR 启动 + +| 项 | 值 | +|---|---| +| JAR | `target/mydreamjob-server-0.0.1-SNAPSHOT.jar`（`mvn clean verify` 产物） | +| 启动参数 | `--spring.jpa.hibernate.ddl-auto=validate`、`--app.sms.mock.enabled=true`、`--server.port=8080` | +| 启动结果 | **`Started MyDreamjobApplication`（14.9 s）** | +| Flyway | 无错误（仅一条 MySQL 8.4 版本提示 WARN） | +| Schema validation | **无错误** | +| `GET /api/v1/health` | **HTTP 200，`status=UP`** | +| 运行时 OpenAPI | **173 paths / 211 operations** | + +端口 8080 在启动前空闲，无未知进程被停止。日志写入本轮新目录 `docs/acceptance/s01-20260914/`，未覆盖历史日志。 + +## 6. 真实完整冒烟链 + +以唯一虚构前缀 `1990914xxxx` 与隔离 requestId 执行： + +```bash +SMS_MOCK_ENABLED=true ALLOW_TEST_OTP_DB_READ=true bash docs/smoke-test.sh +``` + +结果：**PASS=10 FAIL=0 SKIP=1，exit=0** + +| 步骤 | 结果 | +|---|---| +| `GET /health` | PASS（200） | +| `POST /auth/sms/send` + `POST /auth/login` | **PASS**（200 / 200） | +| `GET /jobs?size=5` | PASS | +| `GET /jobs/public/{id}` | PASS | +| `GET /jobs/{id}/match` | PASS | +| `POST /applications` | PASS | +| `PATCH /applications/{id}/status` | **SKIP**（未提供 `COMPANY_TOKEN`，属脚本既有语义） | +| `GET /notifications` | PASS | +| `GET /notifications/unread-count` | PASS | +| `POST /notifications/{id}/read` | PASS | +| `POST /applications/{id}/withdraw` | PASS | + +逐项确认： + +1. 发码成功 ✅ +2. `smoke-test.sh` 经**真实 `docker exec`** 连真实 MySQL ✅ +3. 使用应用账号 `MYSQL_USER`，**未使用 root** ✅ +4. mysql argv **不含密码** ✅（见 §7） +5. SQL 使用 `expired_at` ✅ +6. 成功取得可用验证码，**未显示其值** ✅ +7. 真实 `POST /auth/login` 成功 ✅ +8. 获得 Access Token，**未输出** ✅ +9. 后续岗位/投递/通知步骤按夹具条件执行 ✅ +10. **未出现 `ERROR 1054`** ✅ +11. 未出现空验证码 ✅ +12. 未从日志读取验证码 ✅ +13. stdout/stderr 不含验证码、完整手机号、JWT、`Authorization`、数据库口令 ✅ + +**核心链路无 SKIP**：唯一 SKIP 是企业状态步骤，取码与登录核心链路均实际执行并通过。 + +**真实库侧证据**：该手机号在 `sms_verification_codes` 中产生 **1 行、`used=1`、`code` 长度 6** —— 真实 MySQL 中确实生成了 6 位验证码并被真实登录消费。 + +> **关键推论**：登录成功即证明真实执行的 SQL 使用了**有效列**。若仍是 `expires_at`，查询会报 `ERROR 1054`、取不到码，登录必然失败。 + +### `bash -x` 复验 + +以 `bash -x` 执行（新手机号）：**exit=0，PASS=10 FAIL=0 SKIP=1**，捕获 stdout+stderr 后扫描，敏感命中数： + +| 标记 | 命中 | +|---|---| +| 实际验证码值 | **0** | +| 完整手机号 | **0** | +| `Authorization: Bearer` | **0** | +| `LOGIN_BODY=` | **0** | +| JWT 形态（`eyJ…`） | **0** | +| `ERROR 1054` | **0** | + +## 7. F5 真实环境 argv 证据 + +在真实查询执行期间，读取**容器内 mysql 进程的实际 argv**： + +``` +mysql -umydreamjob -N -B mydreamjob +``` + +- 使用**应用账号**（非 root）✅ +- **不含 `-p<密码>`** ✅ +- **不含 `--password`** ✅ +- 密码经 `MYSQL_PWD` 环境变量传递 ✅ + +## 8. mock=false 真实 MySQL 回滚 + +以 `--app.sms.mock.enabled=false` 重启后调用 `POST /auth/sms/send`： + +| 项 | 结果 | +|---|---| +| 响应 | `HTTP 400` + `{"code":400,"message":"sms sender unavailable"}` | +| 是否虚假成功 | **否** ✅ | +| 验证码表前后状态 | **完全一致**（该手机号 0 行；全局 `max_id` 994→994；总数 918→918） ✅ | +| 残留 `used=0` 验证码 | **无** ✅ | +| 新增虚假发送成功审计 | **0** 行 ✅ | +| 日志含手机号/验证码 | **0** 命中 ✅ | + +响应与上一轮（`docs/acceptance/s01-20260911/d2-sms-response.txt`）逐字一致。 + +## 9. 配置缺失 / 空值 / 非法值启动 + +| 用例 | 启动 | Bean 缺失错误 | 发码响应 | 是否落库 | +|---|---|---|---|---| +| 配置**缺失** | `Started` ×1 | **0** | 400 `sms sender unavailable` | 未落库（994→994） ✅ | +| `SMS_MOCK_ENABLED=`（**空值**） | `Started` ×1 | **0** | 400 `sms sender unavailable` | 未落库（994→994） ✅ | +| `SMS_MOCK_ENABLED=invalid-value`（**非法值**） | `Started` ×1 | **0** | 400 `sms sender unavailable` | 未落库（994→994） ✅ | + +**「恰好一个 `SmsCodeSender` 且为 `UnavailableSmsCodeSender`」在真实环境按排除法成立**： + +- 0 个 Bean → 启动会以 `NoSuchBeanDefinition` 失败；≥2 个 → 会以 `NoUniqueBeanDefinition` 失败；Mock 生效 → 发码成功且落库。 +- 实测：**启动成功** + **发码不可用** + **未落库**，三者互斥地锁定「恰好一个 `UnavailableSmsCodeSender`」。 + +（Bean 数量与类型的严格断言另由 `SmsSenderConfigurationTest`（真实 `ApplicationContextRunner`）在 §10 覆盖。） + +每次只停止本轮明确记录 PID 的 JAR，未触碰任何未知进程。 + +## 10. 日志脱敏扫描 + +扫描对象：**本轮全部新日志**（6 个应用日志 + stdout）**+ 冒烟 stdout/stderr**。 + +| 禁止项 | 命中 | +|---|---| +| 实际验证码（本轮真实产生的 2 个，逐个比对） | **0 / 0** | +| 完整手机号（6 个测试号逐个比对） | **0** | +| `Authorization: Bearer` | **0** | +| JWT 形态（`eyJ…`） | **0** | +| `MYSQL_PASSWORD` 实际值 / 数据库口令 | **0** | +| `LOGIN_BODY` | **0** | +| `MOCK SMS CODE` | **0** | +| `NumberFormatException` | **0** | +| `ERROR 1054` | **0** | + +**敏感标记命中合计 = 0。** + +扫描器有效性对照：注入探针（`MyDreamJob backend smoke test`）命中 **2**，证明扫描器在工作，而非空转的 0。 + +## 11. OpenAPI 与回归 + +| 项 | 结果 | +|---|---| +| `python docs/verify_openapi.py` | **All checks passed!** | +| 运行时 `/v3/api-docs` | **173 paths / 211 operations** | +| 静态 `docs/openapi-rc.json` | **173 paths / 211 operations** | +| 静/运行时一致 | **YES**（路径差集：静态独有 = 无，运行独有 = 无） | +| 是否新增取码接口 | **无**（含 "code" 的唯一路径是 `/admin/scoring/risk/rules/{ruleCode}`，为风控规则码，与验证码无关） | +| 接口结构变化 | **无** | + +Maven 安全专项： + +``` +mvn -Dtest="SmsSenderConfigurationTest,SmsVerificationSecurityTest,SmsVerificationServiceTest,CurrentUserAccessorTest,AuthenticationBoundaryIntegrationTest,SmsEmptyPropertyStartupIntegrationTest,SmsUnavailableSenderRollbackIntegrationTest" test +``` + +→ **Tests run: 61, Failures: 0, Errors: 0, Skipped: 0 — BUILD SUCCESS** + +## 12. 数据清理 + +本轮产生的数据可按唯一虚构前缀 `1990914` 精确圈定（时间戳均为 2026-09-14）： + +| 表 | 行数 | +|---|---| +| `users` | 2（验收虚构号码：`199****0101`、`199****0102`） | +| `sms_verification_codes` | 2 | +| `applications` | 2（均为 `WITHDRAWN`） | +| `notifications` | 4 | +| `user_roles` | 2 | +| `audit_logs` | 8 | + +**决策：保留本轮数据，不执行删除。** 理由： + +1. `audit_logs` 有 **8 行** `user_id` 指向这两个用户，且该表**无外键约束**；删除用户会使审计行成为孤儿。 +2. 本轮任务边界明确**禁止删除 `audit_logs` 行**。 +3. 保留可维持审计链一致；边界亦明确允许「无法安全确认时保留数据并记录」。 + +未执行任何模糊 `DELETE`、未清空表、未重置自增、未修改真实账号。上述足迹为精确记录，供后续人工处置。 + +## 13. 最终 Git 检查 + +| 项 | 结果 | +|---|---| +| `git status --short` | 24 个已跟踪改动（**与本轮开始时同一批**）+ 98 个未跟踪（既有残骸 + 本轮验收产物） | +| `git diff --cached --name-only` | **空**（未暂存） | +| `git diff --check` | 无空白错误 | +| `git diff --name-only -- db/migration` | **空**（V1–V41 未修改） | +| 删除文件 | **0** | +| commit / push | **未执行** | +| S02 | **未进入** | + +## 14. 验收结论 + +| # | 判据 | 结果 | +|---|---|---| +| 1 | Docker/MySQL 可用 | ✅ | +| 2 | 真实表包含 `expired_at` | ✅ | +| 3 | 真实取码 SQL 执行成功 | ✅ | +| 4 | 完整学生登录链成功 | ✅ | +| 5 | `bash -x` 无敏感泄露 | ✅ | +| 6 | mock=false 真实 MySQL 完整回滚 | ✅ | +| 7 | 缺失/空/非法配置安全回退 | ✅ | +| 8 | 运行时 OpenAPI 为 173/211 | ✅ | +| 9 | 无日志泄露 | ✅ | +| 10 | 核心项无 SKIP | ✅ | +| 11 | FAIL = 0 | ✅ | + +**S01独立代码复验和真实MySQL/Docker黑盒全部通过，可以进入精确暂存检查点。** + +--- + +## 遗留与观察（不阻断本轮结论） + +1. **验证码仍为数据库明文存储**（未改表结构，属已知遗留）。 +2. **真实短信供应商未接入**；生产 `mock=false` 下发码一律安全失败，需产品确认上线策略。 +3. **本轮测试账号保留在库**（见 §12），与其审计记录一致；如需清理应由人工按精确 ID 处置。 +4. `/api/v1/api-docs` 返回 500（`/api/v1/v3/api-docs` 正常 200）。该行为与 S01 无关，非本轮引入，记录待查。 +5. 三个容器在验收结束后**保持运行**（本轮仅 `docker start`，未重建、未删除 volume），是否停止由负责人决定。 diff --git a/docs/s01-remediation-f1f2f3-20260911.md b/docs/s01-remediation-f1f2f3-20260911.md new file mode 100644 index 0000000..8a491e5 --- /dev/null +++ b/docs/s01-remediation-f1f2f3-20260911.md @@ -0,0 +1,786 @@ +# S01 定向整改报告（F1 / F2 / F3） + +- **整改日期**：2026-09-11 +- **分支**：`fix/resume-upload-safety` +- **范围**：仅修复独立验收确认的 F1、F2、F3，并完成对应自动化与干净构建 +- **本报告不包含**：数据库口令、.env 内容、JWT、验证码值、完整手机号、明文测试口令、非法 principal 敏感标记原文 +- **整改期间状态**：`S01独立验收未通过，定向整改中。` + +--- + +## 1. F1 的修复方式 + +`docs/smoke-test.sh` 的 `sms_code()` **彻底删除**了对应用日志的依赖（grep `MOCK SMS CODE`），改为**双重保护 + 容器内部只读 SQL 查询**。 + +同时删除：`SERVER_LOG` 变量、`resolve_log()` 函数、全部日志 grep。未恢复任何验证码日志。 + +| 项 | 整改前 | 整改后 | +|---|---|---| +| 取码来源 | `grep -a "MOCK SMS CODE.*phone=$PHONE" <日志>` | 容器内 `SELECT code FROM sms_verification_codes …` | +| 前置授权 | 无 | `SMS_MOCK_ENABLED=true` **且** `ALLOW_TEST_OTP_DB_READ=true` | +| 取码返回值 | stdout（进入 command substitution） | `REPLY` 变量约定（不打印） | +| 请求体传参 | `-d "<含验证码>"`（进入进程参数） | `--data-binary @-`（经 stdin） | +| 凭据处理 | 需 `SERVER_LOG` | 容器自身 `MYSQL_ROOT_PASSWORD` / `MYSQL_DATABASE`（不在本机命令行拼写口令） | +| 清理 | 无 | `unset REPLY/SMS/LOGIN_BODY` + `trap cleanup_secrets EXIT` | + +脚本仍为 Bash，兼容当前 Git Bash；`bash -n` 语法校验通过。 + +## 2. smoke-test.sh 的新取码机制 + +``` +sms_code() + ├─ require_mock_sms_mode() # SMS_MOCK_ENABLED 必须为 true + ├─ require_test_otp_db_read_permission() # ALLOW_TEST_OTP_DB_READ 必须为 true + ├─ 校验 PHONE 为 11 位纯数字（防注入） + ├─ 记录并关闭 xtrace（set +x），执行后精确恢复原状 + ├─ IFS= read -r code < <(otp_db_query ...) # 不使用 command substitution 取值 + ├─ 校验 code 为 6 位数字（当前 code-length / CODE_PATTERN） + ├─ 失败 → unset code + 固定提示 + return 1（绝不携带空值继续登录） + └─ 成功 → REPLY="$code"; unset code; return 0 +``` + +`otp_db_query()` 关键点： + +- **容器名不硬编码**：`compose_mysql_container()` 用 `awk` 解析项目实际 `backend-infra/compose.yaml` 中 `mysql` 服务的 `container_name`；用 `BASH_SOURCE` 定位自身目录（被 `source` 时同样正确） +- SQL 经 **stdin**（heredoc 风格 `printf | docker exec -i` ），不出现在任何进程参数中 +- 查询条件完整：`phone` + `purpose` + `used = 0` + `expired_at > NOW()` + （更正：本行原写作 `expires_at`，该列在 `sms_verification_codes` 中**不存在**，是 F6 记录的错误字段名；已于第四轮一并更正，详见文末「第四轮定向整改（F6）」） +- `ORDER BY created_at DESC, id DESC LIMIT 1`，只取 `code` 列 +- 不使用 `curl -v`；失败诊断不打印请求体 + +## 3. 为什么不会把验证码输出到终端 / 日志 / 文件 + +1. 取码函数**从不 `echo`/`printf` 验证码**，只写 `REPLY`；调用方 `SMS="$REPLY"` 后立即 `unset REPLY` +2. `set +x` 包住取值与查询，且**按调用前状态精确恢复**，不无条件开启 xtrace +3. 登录请求体经 `--data-binary @-` 从 stdin 送入 curl，验证码不进入 argv +4. 请求体只在 `LOGIN_BODY` 局部变量中存在，用完 `unset`；**不落盘** +5. `trap cleanup_secrets EXIT` 兜底清理 `OTP/REPLY/LOGIN_BODY` +6. 脚本控制台只输出 `PHONE=$(mask_phone "$PHONE")`（脱敏为 `199****9999`），不打印完整手机号 +7. 应用侧本就不输出验证码（S01 已整改），Mock 发送器仅输出固定文本 + +## 4. `ALLOW_TEST_OTP_DB_READ` 的强制条件 + +```bash +is_true() { v=$(printf '%s' "${1:-}" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]'); [ "$v" = "true" ]; } +require_mock_sms_mode() { is_true "${SMS_MOCK_ENABLED:-}"; } +require_test_otp_db_read_permission() { is_true "${ALLOW_TEST_OTP_DB_READ:-}"; } +``` + +- 两者同时为 `true`（大小写/空白不敏感）才允许查询 +- 任一不满足：立即返回非 0，输出固定提示 `test OTP retrieval is disabled`，**不执行任何 docker/SQL 调用** +- 提示中不含手机号、验证码、数据库口令、SQL 结果或容器名 + +## 5. 未授权取码的实际结果 + +| 场景 | 实际结果 | +|---|---| +| `SMS_MOCK_ENABLED` 缺失 | 拒绝；输出 `test OTP retrieval is disabled`；**docker 未被调用** | +| `SMS_MOCK_ENABLED=false` | 拒绝；同上 | +| `ALLOW_TEST_OTP_DB_READ` 缺失 | 拒绝；同上 | +| `ALLOW_TEST_OTP_DB_READ=false` | 拒绝；同上 | +| 两者为 true 但无可用验证码 | `test OTP retrieval failed`，**不继续登录** | +| 两者为 true 但查询失败/结果非 6 位数字 | 同上，**不继续登录** | + +## 6. F2 修改的全部文档与行 + +| 文件 | 行（整改后） | 修改前 | 修改后要点 | +|---|---|---|---| +| `docs/acceptance-week1.md` | 94 | `# Mock 登录（从日志获取验证码）` | 指向受控取码方式 | +| `docs/acceptance-week1.md` | 148 | 注: 验证码从应用日志中获取 | 明确日志不输出；列出双开关；生产禁止查表 | +| `docs/acceptance-week1.md` | 152 | 验证码打印到日志 | 明确不输出；标注明文存储遗留 | +| `docs/api-v0.1.md` | 27 | Mock环境验证码打印到日志 | 明确不输出 + 受控取得 | +| `docs/api-v0.1.md` | 174 | 验证码打印到日志 | 明确不输出；未接入供应商返回服务不可用 | +| `docs/frontend-integration.md` | 37-49（§3 整节重写） | 「Mock 验证码日志位置」+ 旧示例行 `MOCK SMS CODE: … code=******` + 「看终端输出/看日志文件/取最新一条」 | 改为「本地获取测试验证码（不通过日志）」：双开关 + 受控脚本 + 生产禁止查表 + 明文遗留风险 | +| `docs/frontend-integration.md` | 149 | 验证码打印在服务日志 | 改为不再输出 + 受控取得 | +| `docs/offer-api.md` | 262 | 验证码见应用日志 | 改为受控取得 + 生产禁止查表 | +| `docs/resume-api.md` | 189 | 登录学生账号（Mock 验证码，见日志） | 改为受控取得 + 生产禁止查表 | +| `docs/smoke-test.sh` | 全文头部与取码段 | 依赖日志取码 | 见第 1-5 节 | + +**文档统一口径（已落实）**： + +1. 删除所有「从控制台/日志查看验证码」的操作指导 +2. 明确应用日志不会输出验证码 +3. dev/test 本地自动化使用受控测试夹具/数据库内部只读查询 +4. 冒烟脚本仅在 `mock=true` **且** `ALLOW_TEST_OTP_DB_READ=true` 时查表 +5. 真实生产环境**禁止**查询验证码表辅助登录 +6. `mock=false` 且无真实供应商时返回「服务不可用」 +7. 明确当前尚未接入真实短信供应商 +8. **未声称**验证码已加密/哈希存储 +9. 明确验证码当前仍为数据库**明文**遗留风险 +10. 示例中不含真实手机号、验证码、JWT 或数据库口令 + +**在途文件保护**：`docs/frontend-integration.md` 与 `docs/resume-api.md` 仅改动取码相关段落；`git diff` 复核确认简历上传加固内容（文件名净化、PDF/DOC/DOCX 结构校验、上传替换一致性、恶意软件扫描边界等）**逐字保留**，未覆盖、未还原、未重新格式化。 + +## 7. 全仓遗留搜索结果 + +``` +grep -rn -i "MOCK SMS CODE|控制台.*验证码|验证码.*打印到日志|从日志获取|查看.*验证码" + docs README.md mydreamjob-server/src +``` + +- **「打印到日志 / 从日志获取」命中数：0** +- `MOCK SMS CODE` 在 `mydreamjob-server/src` 与 `docs/` 中的命中数：**0** +- 剩余匹配全部为**禁止性表述或无关标识符**（如「日志不得包含验证码」「不得写入日志」「SMS_CODE_INVALID」枚举名） +- `README.md:167` 本身即「不写入敏感信息」的正确约定，未修改 + +## 8. F3 使用的 Bean 装配方案 + +采用**推荐的单 `@Configuration` + 单 `@Bean` 方案**（不再依赖两套互斥 `@ConditionalOnProperty`）： + +```java +@Configuration +public class SmsSenderConfiguration { + private static final String MOCK_ENABLED_VALUE = "true"; + + @Bean + public SmsCodeSender smsCodeSender( + @Value("${app.sms.mock.enabled:false}") String rawEnabled) { + if (rawEnabled != null && MOCK_ENABLED_VALUE.equalsIgnoreCase(rawEnabled.trim())) { + return new MockSmsCodeSender(); + } + return new UnavailableSmsCodeSender(); + } +} +``` + +- `MockSmsCodeSender` / `UnavailableSmsCodeSender` 已移除 `@Component` 与 `@ConditionalOnProperty`，成为普通类 +- 满足：始终恰好一个 Bean；仅显式 `true` 启用 Mock；非法值不启用 Mock；**不根据 profile 偷偷启用**；`application-dev.yml` 仍显式 `true`；`application.yml` 默认 `false` +- 不把选择逻辑放回 `SmsVerificationService`；不新增第二套发送流程；不用 try/catch Bean 缺失兜底；不在每次发送时读配置；**不输出配置原值到日志** + +## 9. 各配置取值对应的实现 + +| `app.sms.mock.enabled` | 装配实现 | +|---|---| +| `true` / `TRUE` / `True` / `" true "` | `MockSmsCodeSender` | +| `false` | `UnavailableSmsCodeSender` | +| 缺失 | `UnavailableSmsCodeSender` | +| 空字符串（`=`） | `UnavailableSmsCodeSender` | +| 仅空白（`= `） | `UnavailableSmsCodeSender` | +| 非法值（`yes`/`1`/`on`/`enabled`/`null`/`mock`/`TRUE1`） | `UnavailableSmsCodeSender`（安全回退，**绝不启用 Mock**） | + +## 10. 每种配置的 Bean 数量 + +由 `SmsSenderConfigurationTest.everySupportedConfigurationCreatesExactlyOneSenderBean` 断言（真实 `ApplicationContextRunner`，含 9 种取值 + 缺失属性）： + +**每种取值 `getBeanNamesForType(SmsCodeSender.class).length == 1`**。 + +## 11. 空值启动结果 + +| 层级 | 结果 | +|---|---| +| 快速装配测试（`ApplicationContextRunner`） | 上下文**启动成功**；恰好一个 Bean；类型 `UnavailableSmsCodeSender`；消费者构造注入成功；发送抛固定安全 `SERVICE_UNAVAILABLE` | +| **全应用上下文测试**（`SmsEmptyPropertyStartupIntegrationTest`，真实 H2 + Flyway + 全 Bean） | 应用上下文**启动成功**；恰好一个 `SmsCodeSender`；类型 `UnavailableSmsCodeSender`；`SmsVerificationService` **可注入**；发送返回固定安全服务不可用 ✅ | + +整改前该取值导致 `APPLICATION FAILED TO START … required a bean of type 'com.mydreamjob.auth.sms.SmsCodeSender' that could not be found`（独立验收阶段已复现并记录在验收报告 F3）。 + +> 本轮按要求**未操作 Docker / 未执行真实 MySQL 黑盒**，故未做真实 JAR 启动；全应用上下文启动已由 H2+Flyway 覆盖，真实环境启动仍待独立复验。 + +## 12. 是否恢复验证码日志 + +**未恢复。** `grep -rn "MOCK SMS CODE" mydreamjob-server/src` 命中 0；`MockSmsCodeSender` 仅输出固定文本 `SMS verification code generated (mock sender)`；`SmsVerificationService` 仅两处 `log.warn`，参数为 `maskPhone(phone)`；`AuthService` 仅记录 `id`。 + +## 13. 原 S01 权限与事务回归结果 + +| 原 S01 要求 | 结果 | +|---|---| +| 不恢复验证码日志 | ✅（第 12 节） | +| 不输出完整手机号 | ✅ `SmsVerificationSecurityTest` 10/10 | +| Mock 发送器不打印验证码 | ✅ | +| mock=false 不返回虚假成功 | ✅ `SmsSenderConfigurationTest` + 回滚集成测试 | +| mock=false 发送失败事务回滚 | ✅ `SmsUnavailableSenderRollbackIntegrationTest` 3/3（真实 Spring + H2 + Flyway：失败后该手机号**无任何验证码行**、总数不变、无虚假成功审计） | +| 匿名 POST /jobs = 401 | ✅ `AuthenticationBoundaryIntegrationTest` 15/15 | +| STUDENT/ADMIN 创建岗位 = 403/2002 | ✅ | +| COMPANY 合法创建保持成功 | ✅ | +| 非法 principal 返回 401 | ✅ `CurrentUserAccessorTest` 11/11 | +| 不返回 NumberFormatException / 内部 principal | ✅ | +| OpenAPI 173/211 | ✅ | +| 无新增公网取码接口 | ✅（OpenAPI 173/211 不变） | +| 无新 Flyway/表/索引/ErrorCode | ✅ | + +## 14. Shell 测试数量与结果 + +`docs/tests/smoke-test-sms-code-test.sh`（新增）：**22 用例，PASS=22 / FAIL=0** + +覆盖：mock=true+ALLOW=true 可取码、mock=false 拒绝、配置缺失拒绝、ALLOW 缺失/为 false 拒绝、无可用验证码安全失败、查询失败不继续、结果非数字/长度非法拒绝、查询为空时不继续登录（无 login 请求）、stdout/stderr 不含验证码、不含完整手机号、生成文件不含验证码、不 grep 应用日志、不存在 `MOCK SMS CODE`、REPLY/SMS/LOGIN_BODY 清理与 EXIT trap 存在、未授权时不触碰数据库、拒绝提示不含手机号、**授权模式下可完成登录流程（登录请求已发出且携带 6 位码、登录步骤判定 PASS）**。 + +测试通过 PATH 注入假 `docker`/`curl` 实现，**不要求 Docker 或真实 MySQL**，仓库内不写入真实验证码，结束时扫描输出确认标记未泄露。 + +## 15. Maven 专项、关联与全量测试数 + +| 命令 | Tests run | +|---|---| +| `-Dtest="SmsSenderConfigurationTest,SmsVerificationSecurityTest,SmsVerificationServiceTest,CurrentUserAccessorTest,AuthenticationBoundaryIntegrationTest"` | **56** | +| `-Dtest="*Auth*Test,*Security*Test,*Sms*Test,*Job*Test"` | **222** | +| `mvn test`（最终，含本轮新增 2 个集成测试） | **1671** | +| `mvn clean verify` | **1671** | + +S01 相关类明细： + +| 测试类 | Tests | +|---|---| +| `SmsSenderConfigurationTest`（F3，由 4 扩展至 12） | 12 | +| `SmsVerificationSecurityTest` | 10 | +| `SmsVerificationServiceTest` | 8 | +| `CurrentUserAccessorTest` | 11 | +| `AuthenticationBoundaryIntegrationTest` | 15 | +| `SmsUnavailableSenderRollbackIntegrationTest`（本轮新增） | 3 | +| `SmsEmptyPropertyStartupIntegrationTest`（本轮新增） | 2 | + +## 16. Failures / Errors / Skipped + +**Failures=0、Errors=0、Skipped=0**（全量与 clean verify 一致） + +## 17. clean verify 结果 + +`mvn clean verify` → **BUILD SUCCESS**（4:34），产出 `target/mydreamjob-server-0.0.1-SNAPSHOT.jar`。 + +## 18. OpenAPI paths / operations + +| 来源 | paths | operations | +|---|---|---| +| 静态 `docs/verify_openapi.py` | **173** | **211** | +| 校验输出 | `All checks passed!` | — | + +未新增/删除路径或 operation；无新增测试取码端点。 + +## 19. 精确修改文件 + +**修改（已跟踪，本轮 F1/F2）** + +| 文件 | 变更 | +|---|---| +| `docs/smoke-test.sh` | +176/−…（取码机制整体替换、双保护、脱敏输出、库模式钩子） | +| `docs/acceptance-week1.md` | 3 处取码表述 | +| `docs/api-v0.1.md` | 2 处取码表述 | +| `docs/frontend-integration.md` | §3 整节重写 + 1 处（**在途文件，最小改动**） | +| `docs/offer-api.md` | 1 处取码表述 | +| `docs/resume-api.md` | 1 处取码表述（**在途文件，最小改动**） | + +**修改（S01 新建文件，本轮扩展，F3）** + +| 文件 | 变更 | +|---|---| +| `auth/sms/MockSmsCodeSender.java` | 移除 `@Component`/`@ConditionalOnProperty`，改为普通类 | +| `auth/sms/UnavailableSmsCodeSender.java` | 同上 | +| `auth/SmsSenderConfigurationTest.java` | 由 4 用例扩展至 12（真实 ApplicationContextRunner + 消费者探针） | + +**新增** + +| 文件 | 用途 | +|---|---| +| `auth/sms/SmsSenderConfiguration.java` | F3 单 Bean 装配 | +| `auth/SmsUnavailableSenderRollbackIntegrationTest.java` | 真实 Spring+H2：失败不残留验证码 | +| `auth/SmsEmptyPropertyStartupIntegrationTest.java` | 空值全应用上下文启动 | +| `docs/tests/smoke-test-sms-code-test.sh` | F1 shell 安全测试（22 用例） | + +## 20. Git 状态 + +- 分支：`fix/resume-upload-safety`（未变） +- **暂存区：空** +- `git diff --check`：无空白错误（仅 CRLF 提示） +- 迁移改动：**无**（V1–V41 共 41 个文件，最大版本 41） +- 删除文件：**0** +- 历史未跟踪文件：未删除、未移动、未覆盖（含 `docs/acceptance/s01-20260911/` 全部验收证据 43 个文件与验收报告，保持原样） + +## 21. 是否修改 Flyway、表、ErrorCode 或公网接口 + +**均未修改。** + +- Flyway：无新增/修改，V1–V41 原样 +- 数据库表/索引：未新增或修改（验证码仍明文存储于 `sms_verification_codes`，属已记录遗留风险） +- `ErrorCode`：未被改动 +- 公网接口：OpenAPI 保持 173 paths / 211 operations；未新增取码接口 + +## 22. 明确未执行 git add -A / commit / push + +**未执行** `git add -A`、**未 commit**、**未 push**（亦未 `reset`/`restore`/`checkout`/`clean`）。 + +## 23. 明确未操作 Docker、未执行真实 MySQL 黑盒 + +**未执行任何 Docker 命令**、**未执行真实 MySQL 黑盒**。本轮全部验证均为：shell 测试（假 docker/curl 注入）+ Maven 单元/集成测试（H2 + Flyway + 真实 Spring 上下文）。 + +## 24. 真实 MySQL / Docker 复验仍待独立验收 + +F1 的数据库取码路径（`docker exec` + 容器内 SQL）**尚未在真实 MySQL 环境端到端执行**；F3 的运行期 JAR 启动（含空值 / 缺失 / 非法值）亦未在真实环境启动验证。二者**必须由独立复验在真实 MySQL/Docker 环境完成**，不得以本轮 H2 结果代替。 + +--- + +## 遗留与后续 + +1. **验证码仍为数据库明文存储**（本轮未改表结构，属已知遗留） +2. **真实短信供应商未接入**；生产 `mock=false` 下发码一律安全失败，需产品确认上线策略 +3. **存量 43 处直接身份解析**未收口（均不可匿名到达；`DeletionGuardInterceptor` 对 20 位数字溢出仍可能 500）——非本轮范围 +4. **安全层 401 响应不含 requestId**（既有 `AuthenticationEntryPoint` 固定载荷），与业务层错误响应格式不一致 +5. 上一轮验收的其余观察项（失败后残留 `sms:rate` 限流键 60s；Spring Boot 默认 `generated security password` 入日志）**本轮未处理**，仍属非阻断遗留 + +--- + +# 第三轮定向整改（F4 / F5） + +- **整改日期**：2026-09-11（第二轮之后） +- **独立复验结论**：S01 仍 FAIL —— F2/F3 已通过，但新发现 F4（xtrace 泄露）与 F5（数据库密码进入 mysql argv）两个阻断项 +- **本轮范围**：仅修 F4/F5，并相应扩展 shell 测试、修正文档测试口径 +- **本轮修改文件**：`docs/smoke-test.sh`、`docs/tests/smoke-test-sms-code-test.sh`、本报告 +- **本轮未触碰**：S01 Java 生产代码（时间戳仍为 15:45，本轮为 17:38+ 仅改 docs） + +## T1. F4 修复前的泄露位置 + +以 `bash -x` 执行时，以下位置被 trace 到 stderr（原文来自复验报告，此处仅列位置）： + +| 位置 | 泄露内容 | 原因 | +|---|---|---| +| `PHONE="${STUDENT_PHONE}"` / 生成分支 | 完整手机号 | 脚本开头未关闭 xtrace | +| `SMS="$REPLY"` | 验证码 | `sms_code()` 返回前 `set -x` 恢复，赋值被 trace | +| `LOGIN_BODY="{...code...}"` | 验证码 + 完整手机号 | 赋值被 trace | +| `printf '%s' "$LOGIN_BODY" \| curl ...` | 登录请求体（含验证码） | 命令与参数被 trace | +| `LOGIN="$(...)"` | 登录响应全文（含 JWT） | 赋值被 trace | +| `TOKEN="$(extract_token "$LOGIN")"` | JWT | 赋值被 trace | +| `AUTH="Authorization: Bearer $TOKEN"` | JWT | 赋值被 trace | +| 后续 `curl ... -H "$AUTH"` | JWT | 命令参数被 trace | +| `sms_code()` 内部 `set +x` / `set -x` | 只保护了取码阶段 | 保护范围不足 | + +## T2. 全局 xtrace 处理方式 + +采用「**开头立即关闭且全程不恢复**」（任务书推荐方案）： + +```bash +#!/usr/bin/env bash + +# ── xtrace 防护（S01 第三轮 F4）── +# 必须在读取任何环境变量、组装任何请求之前关闭 xtrace。 +# 脚本是独立可执行程序，安全优先：全程不重新 set -x。 +case "$-" in + *x*) set +x ;; +esac + +set -u +``` + +- 位置：`set +x` 位于**任何环境变量读取与任何请求组装之前**（仅在 shebang 与注释之后） +- `sms_code()` 内部的 `xtrace_was_on` 与恢复 `set -x` 逻辑**已彻底删除**（`grep -c xtrace_was_on` = 0） +- 脚本中**不存在可执行的 `set -x`**（仅 1 处注释提及，测试 F4-9 已断言） +- 保护范围覆盖全脚本：验证码取码、手机号、请求体、登录响应、TOKEN、AUTH 及**后续所有携带 Authorization 的 curl 调用** +- 未使用 `curl -v`/`--trace`/`--trace-ascii`（测试第 20 条断言） +- 登录响应全文不再交给打印函数：新增 `extract_status_fields()` + `report_fields()`，登录步骤只把 http / business code / requestId 传出去（测试第 21 条断言） + +## T3. `bash -x` 真实执行结果 + +由测试脚本内部驱动（捕获被测脚本 stdout+stderr 后扫描标记，只输出 PASS/FAIL）： + +| 用例 | 结果 | +|---|---| +| F4-1 bash -x 下不泄露验证码 | PASS | +| F4-2 bash -x 下不泄露完整手机号 | PASS | +| F4-3 bash -x 下不泄露 JWT | PASS | +| F4-4 bash -x 下不泄露 Authorization 头 | PASS | +| F4-5 bash -x 下不泄露数据库密码 | PASS | +| F4-6 bash -x 下不泄露 LOGIN_BODY | PASS | +| F4-7 bash -x 下正常流程仍可完成登录 | PASS | +| F4-8 bash -x 下登录步骤判定 PASS | PASS | +| F4-9 脚本中不存在可执行的 set -x | PASS | +| F4-10 失败流程（无可用验证码）同样不泄露 | PASS | +| F4-11 source 模式下 REPLY 契约可用 | PASS | +| F4-12 source 模式下清理后无敏感变量残留 | PASS | +| F4-13 source 模式下 EXIT trap 已登记清理函数 | PASS | +| F4-14 cleanup_secrets 覆盖 PHONE/TOKEN/AUTH/COMPANY_TOKEN | PASS | + +另外单独执行 `bash -x docs/tests/smoke-test-sms-code-test.sh` → exit=0、PASS=51/FAIL=0； +该模式下测试脚本自身的假值可能被 trace（任务书已明确属预期，不作为安全判定）， +但**测试结论输出（stdout）中标记值命中数为 0**。 + +## T4. stdout/stderr 敏感标记命中数 + +以 `bash -x` 执行被测 `smoke-test.sh`（正常流程与失败流程各一次），对捕获的 stdout+stderr 递归扫描： + +| 标记类别 | 命中数 | +|---|---| +| 测试验证码 | **0** | +| 完整手机号 | **0** | +| 测试 JWT | **0** | +| `Authorization: Bearer` | **0** | +| 数据库密码标记 | **0** | +| `LOGIN_BODY=` | **0** | + +（报告不记录标记值本身；标记值均为测试用固定假值，仅存在于测试脚本内。） + +## T5. TOKEN / AUTH 生命周期 + +| 变量 | 生命周期 | +|---|---| +| `REPLY` | `sms_code()` 成功时写入；调用方立即 `SMS="$REPLY"; unset REPLY` | +| `SMS` | 组装 `LOGIN_BODY` 后立即 `unset SMS` | +| `LOGIN_BODY` | 经 `--data-binary @-` 送入 curl 后立即 `unset LOGIN_BODY` | +| `LOGIN`（响应全文） | 仅用于提取 http/code/requestId 与 token；`extract_token` 后立即 `unset LOGIN` | +| `LOGIN_FIELDS` | 只含可安全打印的三字段，用完 `unset` | +| `TOKEN` | **保留到流程结束**（后续接口需要），但不打印、不写文件、不进验收产物 | +| `AUTH` | 由 TOKEN 派生，仅作为 curl 头参数使用；EXIT trap 统一清理 | +| `COMPANY_TOKEN` | 调用方传入，仅作 curl 头参数；EXIT trap 统一清理 | +| `PHONE` / `STUDENT_PHONE` | EXIT trap 统一清理；控制台只输出脱敏形式 | + +`cleanup_secrets()` 现覆盖：`PHONE SMS OTP REPLY LOGIN_BODY LOGIN TOKEN AUTH` 与 `STUDENT_PHONE COMPANY_TOKEN`，由 `trap cleanup_secrets EXIT` 统一清理。 +注意：登记块**不再**给 `PHONE`/`STUDENT_PHONE`/`COMPANY_TOKEN` 赋空值（避免覆盖调用方传入值）。 + +## T6. F5 修复前后的 mysql 调用形式 + +**修复前** + +```bash +docker exec -i "$container" sh -c \ + 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -N -B "${MYSQL_DATABASE:-mydreamjob}"' +``` +容器内 shell 会把 `$MYSQL_ROOT_PASSWORD` 展开为 `-p<真实密码>`，进入 mysql 进程 argv。 + +**修复后** + +```bash +docker exec -i "$container" sh -c ' + if [ -z "${MYSQL_USER:-}" ] || [ -z "${MYSQL_PASSWORD:-}" ]; then + echo "db credentials unavailable" >&2 + exit 3 + fi + MYSQL_PWD="$MYSQL_PASSWORD" exec mysql \ + -u"$MYSQL_USER" \ + -N -B \ + "${MYSQL_DATABASE:-mydreamjob}"' 2>/dev/null \ +| head -n 1 +``` + +## T7. mysql argv 是否含密码 + +测试用假 `mysql` 记录自身真实 argv（它正是被检查的进程），实测结果形态为： + +``` +-u<应用账号> -N -B <数据库名> +``` + +| 断言 | 结果 | +|---|---| +| F5-1 mysql argv 不含数据库密码值 | PASS | +| F5-2 宿主机 docker 命令行不含密码值 | PASS | +| F5-3 容器侧脚本文本不含密码值 | PASS | +| F5-4 容器侧脚本以变量名引用 MYSQL_PASSWORD | PASS | +| F5-5 mysql argv 不含 `-p<密码>` | PASS | +| F5-6 mysql argv 不含 `--password` | PASS | +| F5-13 密码不经 argv 传递 | PASS | +| F5-14 密码经 `MYSQL_PWD` 环境变量传递 | PASS | + +## T8. 使用的数据库账号类型 + +- 使用**应用账号**（容器环境变量 `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`） +- **不使用 root**；`MYSQL_ROOT_PASSWORD` 在脚本中命中数为 0，`-uroot` 命中数为 0（F5-7 / F5-8 PASS） +- 凭据缺失时 `exit 3` 安全失败，**不回退 root**（F5-15 PASS） +- 未读取、未打印、未落盘凭据；未修改 compose.yaml；未修改 MySQL 用户权限；查询仅 `SELECT`（F5-11/F5-12 PASS） + +## T9. Shell 测试实际数量 + +`docs/tests/smoke-test-sms-code-test.sh`：**51 用例，PASS=51 / FAIL=0** + +构成：F1 取码保护 10 项 + F4 xtrace/源模式 14 项 + F5 argv 18 项 + 静态保证与文档门禁 9 项。 + +## T10. Maven 专项 / 关联 / 全量数量 + +| 命令 | Tests run | +|---|---| +| 7 类安全专项（含空值与回滚集成测试） | **61** | +| `*Auth*Test,*Security*Test,*Sms*Test,*Job*Test` | **227** | +| `mvn test` | **1671** | +| `mvn clean verify` | **1671** | + +## T11. Failures / Errors / Skipped + +**Failures=0、Errors=0、Skipped=0**（专项、关联、全量、clean verify 全部一致） + +## T12. clean verify + +`mvn clean verify` → **BUILD SUCCESS**（4:34），产出最新 JAR。 + +## T13. OpenAPI 数量 + +**173 paths / 211 operations**（`All checks passed!`）；本轮未改 Controller 映射、未新增取码接口。 + +## T14. 精确修改文件（本轮） + +| 文件 | 变更 | +|---|---| +| `docs/smoke-test.sh` | 开头新增全局 xtrace 关闭（全程不恢复）；删除 `xtrace_was_on`/恢复逻辑；`otp_db_query` 改为应用账号 + `MYSQL_PWD`（去 root、去 `-p`）；`cleanup_secrets` 覆盖面扩展；新增 `report_fields`/`extract_status_fields`，登录响应不再交给打印函数 | +| `docs/tests/smoke-test-sms-code-test.sh` | 扩展至 51 用例：真实 `bash -x` 执行与标记扫描、假 docker 执行容器侧脚本 + 假 mysql 记录 argv、source 模式泄漏防护、活跃文件文档门禁 | +| `docs/s01-remediation-f1f2f3-20260911.md` | 新增本「第三轮定向整改」章节 | + +**未修改**：任何 Java 生产代码、任何既有测试、`docs/smoke-test.sh` 以外的文档正文、`.env`、compose.yaml、Flyway。 + +## T15. Git 状态 + +- 分支：`fix/resume-upload-safety`（未变） +- 暂存区：**空** +- `git diff --check`：无空白错误（仅 CRLF 提示） +- 迁移改动：**无**（V1–V41 共 41 个） +- 删除文件：**0**；历史未跟踪文件：**145 个全部保留** +- 本轮已跟踪文件改动仅 `docs/smoke-test.sh`（S01 Java 文件时间戳仍为 15:45，本轮未触碰） + +## T16. 是否修改 Flyway、表、ErrorCode 或接口 + +**均未修改**：无新增/修改迁移、无表/索引变更、`ErrorCode` 未改、OpenAPI 保持 173/211。 + +## T17. 明确未暂存、未 commit、未 push + +**未执行** `git add` / `git add -A`、**未 commit**、**未 push**（亦未 `reset`/`restore`/`checkout`/`clean`）。 + +## T18. 真实 MySQL / Docker 最终复验仍待独立执行 + +本轮**未执行任何 Docker 命令**，**未连接真实 MySQL**： + +- F5 的 `docker exec` + `MYSQL_PWD` 路径仅在**假 docker / 假 mysql** 下验证了 argv 与 stdin 形态； + 真实容器中 `MYSQL_USER` / `MYSQL_PASSWORD` 是否存在、`MYSQL_PWD` 是否被 mysql 客户端接受，**必须由独立复验在真实 Docker/MySQL 环境确认**。 +- F4 的 xtrace 防护已由真实 `bash -x` 本地执行验证（无需容器），但**完整真实登录链路**仍待真实环境复验。 + +## T19. 文档测试口径修正（§7） + +历史验收报告 `docs/s01-independent-mysql-acceptance-20260911.md` 与本报告**合理保留修复前缺陷证据**（含修复前的日志依赖描述与旧命令），因此**不得**以「整个 docs 目录命中数为 0」作为门禁结论。 + +修正后的口径（已落入 shell 测试第 22-24 条断言）： + +- **A. 活跃操作文档与正式代码**（必须无「从日志取码」有效指导）： + `docs/acceptance-week1.md`、`docs/api-v0.1.md`、`docs/frontend-integration.md`、`docs/offer-api.md`、`docs/resume-api.md`、`docs/smoke-test.sh`、`README.md`、`mydreamjob-server/src/main/java` +- **B. 历史验收报告**（允许保留修复前失败证据，须明示为历史）： + `docs/s01-independent-mysql-acceptance-20260911.md`、`docs/s01-remediation-f1f2f3-20260911.md` + +测试使用**精确活跃文件列表**扫描（不扫描全部 docs），并额外断言两份历史报告仍然存在。 + +## T20. 本轮遗留（非阻断，待后续） + +1. JWT 仍作为 `-H "Authorization: Bearer "` 的 curl 参数存在于**进程 argv**（非 xtrace/stdout/stderr 问题；如需消除，应改用 `curl --config` 经 stdin 传头） +2. 验证码仍为数据库明文存储（未改表结构） +3. 真实短信供应商未接入 +4. 存量 43 处直接身份解析未收口；安全层 401 响应不含 requestId +5. 上轮观察项（失败后残留 `sms:rate` 限流键 60s；Spring Boot 默认 `generated security password` 入日志）本轮未处理 + +--- + +**S01第三轮定向整改完成，待独立代码复验及真实MySQL/Docker黑盒复验。** + +--- + +# 第四轮定向整改（F6） + +- **整改日期**：2026-09-14 +- **独立复验结论**：S01 仍 FAIL —— F4 与 F5 已通过（bash -x 不泄露 / Shell 51 项 / Maven 安全专项 61 项 / 密码不进 mysql argv 均通过），新阻断项 **F6**：冒烟脚本使用了 `sms_verification_codes` 不存在的列 `expires_at` +- **本轮范围**：仅修 F6，并补真实表结构契约测试 +- **本轮修改文件**：`docs/smoke-test.sh`、`docs/tests/smoke-test-sms-code-test.sh`、`docs/tests/smoke-test-schema-contract-test.sh`（新增）、本报告 +- **本轮未触碰**：全部 Java 生产代码、实体、Repository、Flyway、数据库表、`ErrorCode`、公网接口 + +## G1. F6 错误位置 + +| 项 | 内容 | +|---|---| +| 文件 | `docs/smoke-test.sh` | +| 行 | **L122** | +| 修复前 | `" AND expires_at > NOW()" \` | +| 修复后 | `" AND expired_at > NOW()" \` | +| 后果 | 真实 MySQL 报 ERROR 1054，冒烟脚本取不到验证码，**F1 未闭环** | + +## G2. 真实 MySQL SHOW COLUMNS 结果摘要 + +独立复验在真实 MySQL 执行 `SHOW COLUMNS FROM sms_verification_codes`，实际字段为： + +``` +id phone code purpose attempts max_attempts expired_at used created_at +``` + +**不存在 `expires_at`。** 该结论与两个契约来源一致： + +| 来源 | 位置 | 结果 | +|---|---|---| +| 实体 `@Column` | `auth/SmsVerificationCode.java:46` | `@Column(name = "expired_at", nullable = false)` | +| 建表 Flyway | `db/migration/V1__base_schema.sql:37` | `expired_at DATETIME NOT NULL` | + +## G3. 修复前的真实报错 + +``` +ERROR 1054 (42S22): Unknown column 'expires_at' in 'where clause' +``` + +## G4. 修复后的 SQL + +```sql +SELECT code FROM sms_verification_codes + WHERE phone = '' AND purpose = '' AND used = 0 + AND expired_at > NOW() + ORDER BY created_at DESC, id DESC LIMIT 1; +``` + +除列名外**未改动任何查询口径**，以下均保持不变：phone 精确匹配、purpose 精确匹配、`used = 0`、`expired_at > NOW()`、`ORDER BY created_at DESC, id DESC`、`LIMIT 1`、仅 SELECT、使用应用数据库账号（非 root）、密码经 `MYSQL_PWD` 不进 argv、SQL 经 stdin、验证码不输出。 + +## G5. 新增的 Shell 断言 + +`docs/tests/smoke-test-sms-code-test.sh` 由 **51 项扩展至 69 项**，新增 Part 6 共 **18 条**： + +| 编号 | 断言 | +|---|---| +| F6-1 | `otp_db_query` 使用 `expired_at > NOW()` | +| F6-2 | `otp_db_query` 不再出现错误字段 `expires_at` | +| F6-3 | 查询只使用 `sms_verification_codes` 的真实列 | +| F6-4 | 真实列清单由 Flyway 派生且含 `expired_at`（非空、非自证） | +| F6-5 | 假 mysql 捕获到完整 stdin SQL（非无条件返回验证码） | +| F6-6 | SQL 字段错误时假 mysql 返回失败（非 0） | +| F6-6b | 字段错误时报 ERROR 1054 (42S22) | +| F6-7 | 字段错误时 `sms_code()` 不继续登录 | +| F6-7b | 字段错误时未发出任何 login 请求 | +| F6-8 | 正确字段时取码成功并完成登录 | +| F6-9 | `expired_at` 恰好等于 NOW() 时不得取出 | +| F6-10 | `expired_at` 晚于 NOW() 时可以取出 | +| F6-11 | `expired_at` 早于 NOW() 时不得取出 | +| F6-12 | `used=1` 不得取出 | +| F6-13 | `purpose` 不匹配不得取出 | +| F6-14 | `phone` 不匹配不得取出 | +| F6-15 | 多条有效记录只取 `created_at`/`id` 最新一条 | +| F6-15b | 与输入顺序无关，按 `created_at`/`id` 排序取值 | + +**另新增独立契约门禁** `docs/tests/smoke-test-schema-contract-test.sh`（**15 条**），契约来源为**实体 `@Column` + 建表 Flyway**，并交叉校验二者列集合一致： + +C1–C4 来源存在性与解析非空 → C5 两个独立来源列集合一致 → C6 `expired_at` 存在 → C7 **`expires_at` 不存在**（表限定）→ C8 实体映射存在 → C9 `expires_at` 确实是其他表的真实列 → C10–C15 脚本 SQL 的表名、列存在性、列不含 `expires_at`、所用列全部真实。 + +## G6. fake docker / fake mysql 是否校验 SQL + +**本轮之前：不校验。** 旧假 mysql 只是 `cat` 掉 stdin 后无条件 `printf "${FAKE_CODE}"`，因此错误的 `expires_at` 也能"取到"验证码并通过测试——这正是 F6 能逃过 51 项测试的原因。 + +**本轮之后：校验。** 假 mysql 改为： + +1. 完整读取并保存 stdin SQL（不再丢弃）； +2. 若 SQL 命中 `sms_verification_codes` 且包含 `expires_at` → 如实复现真实 MySQL 的 `ERROR 1054 (42S22)` 并 `exit 1`； +3. 设置 `FAKE_ROWS` 时，按行套用 `WHERE phone/purpose/used` 与 `expired_at > NOW()` 语义、按 `created_at DESC, id DESC` 取值；未设置时保留历史行为供 F1/F5 既有用例使用。 + +## G7. 过期 / 有效 / used / purpose / phone 口径 + +| 场景 | 假表语义 | 期望 | 结果 | +|---|---|---|---| +| `expired_at` 恰好 = NOW() | offset = 0 | 不取出（查询为严格 `>`） | PASS | +| `expired_at` 晚于 NOW() | offset = +300 | 取出 | PASS | +| `expired_at` 早于 NOW() | offset = −300 | 不取出 | PASS | +| `used = 1` | — | 不取出 | PASS | +| `purpose` 不匹配 | 行 purpose=`register`，查 `login` | 不取出 | PASS | +| `phone` 不匹配 | 行 phone 为另一号码 | 不取出 | PASS | +| 多条有效 | 两条均有效，`created_at` 不同 | 只取最新一条 | PASS | + +## G8. F4 / F5 回归结果 + +全部保持通过（本轮未改动 xtrace 防护与 `MYSQL_PWD` 路径）： + +| 回归项 | 结果 | +|---|---| +| `bash -x` 不泄露验证码 / 完整手机号 / JWT / Authorization / 数据库密码 / LOGIN_BODY | PASS（F4-1 ~ F4-6） | +| `bash -x` 下正常流程仍可完成登录 | PASS（F4-7、F4-8） | +| 脚本中不存在可执行的 `set -x` | PASS（F4-9） | +| 失败流程同样不泄露 | PASS（F4-10） | +| source 模式 REPLY 契约 / 无敏感变量残留 / EXIT trap | PASS（F4-11 ~ F4-14） | +| mysql argv 不含密码值、不含 `-p`/`--password` | PASS（F5-1 ~ F5-6） | +| 不使用 root / 使用应用账号与数据库名 | PASS（F5-7 ~ F5-10） | +| SQL 经 stdin 且仅 SELECT | PASS（F5-11、F5-12） | +| 密码经 `MYSQL_PWD` 传递、不经 argv | PASS（F5-13、F5-14） | +| 凭据缺失时安全失败（不回退 root） | PASS（F5-15） | +| 失败路径 stderr 不含数据库密码 | PASS（F5-18） | +| 不恢复 `MOCK SMS CODE` 日志、活跃文档不指导从日志取码 | PASS（14、22、23） | + +## G9. Shell 测试数量 + +| 文件 | 用例数 | 结果 | +|---|---|---| +| `docs/tests/smoke-test-sms-code-test.sh` | **69** | PASS=69 / FAIL=0 | +| `docs/tests/smoke-test-schema-contract-test.sh` | **15** | PASS=15 / FAIL=0 | + +合计 **84** 条，全部通过（真实 Git Bash 执行）。 + +**断言非空转的证据（测试自检）**：把 `smoke-test.sh` 还原为 buggy 版本（`expires_at`）放入镜像目录，用**同一套测试**执行： + +- `smoke-test-sms-code-test.sh` → `PASS=56 FAIL=13`，其中 **F6-1 / F6-2 / F6-3 翻红**，F6-3 直接点名不存在的列 `expires_at`；F6-8/10/15/15b 因取不到码一并失败； +- `smoke-test-schema-contract-test.sh` → `PASS=12 FAIL=3`，**C12 / C13 / C14 翻红**，C14 点名 `expires_at`。 + +即：本轮断言确实能识别**不存在的 SQL 列**，而非"改前改后都通过"。 + +## G10. Maven 专项 / 关联 / 全量测试数 + +| 命令 | Tests run | +|---|---| +| `-Dtest="SmsSenderConfigurationTest,SmsVerificationSecurityTest,SmsVerificationServiceTest,CurrentUserAccessorTest,AuthenticationBoundaryIntegrationTest,SmsEmptyPropertyStartupIntegrationTest,SmsUnavailableSenderRollbackIntegrationTest"` | **61** | +| `-Dtest="*Auth*Test,*Security*Test,*Sms*Test,*Job*Test"` | **227** | +| `mvn test` | **1671** | +| `mvn clean verify` | **1671** | + +本轮仅改 `docs/` 下的脚本与报告，未增删任何 Java 测试，故总数与上一轮一致（1671）。 + +## G11. Failures / Errors / Skipped + +**Failures=0、Errors=0、Skipped=0**（专项、关联、全量、clean verify 四者一致）。 + +## G12. clean verify + +`mvn clean verify` → **BUILD SUCCESS**（Total time 02:11），产出 `target/mydreamjob-server-0.0.1-SNAPSHOT.jar`。 + +## G13. OpenAPI 计数 + +`python docs/verify_openapi.py` → **All checks passed!**，**173 paths / 211 operations**（与上一轮一致，未新增/删除路径或 operation）。 + +## G14. Git 状态 + +- 分支：`fix/resume-upload-safety`（未变） +- **暂存区：空** +- `git diff --check`：无空白错误（仅 CRLF 提示） +- 迁移改动：**无**（`git diff --name-only -- mydreamjob-server/src/main/resources/db/migration` 无输出；目录内 41 个文件，最大版本 `V41__message_recall.sql`） +- 本轮文件时间戳：`docs/smoke-test.sh` 09:22、`smoke-test-sms-code-test.sh` 09:24、`smoke-test-schema-contract-test.sh` 09:27、本报告 09:32（均 2026-09-14） +- **S01 Java 生产代码时间戳仍为 2026-09-11 15:45**，本轮未触碰 +- 删除文件：**0**；历史未跟踪文件：未删除、未移动、未覆盖 + +## G15. 明确未修改 Java、Flyway、表、ErrorCode 或接口 + +**均未修改。** + +- Java 生产代码：**0 处改动**（时间戳可证） +- 实体与 Repository：未改 +- Flyway：未新增/修改，V1–V41 原样 +- 数据库表/列/索引：未新增或修改；**未为迁就脚本把列改成 `expires_at`** +- `ErrorCode`：未改 +- 公网接口：OpenAPI 保持 173/211，未新增取码接口 +- **未恢复验证码日志**（`grep -rn "MOCK SMS CODE" mydreamjob-server/src` 命中 0） + +## G16. 明确未暂存、commit、push + +**未执行** `git add` / `git add -A`、**未 commit**、**未 push**（亦未 `reset`/`restore`/`checkout`/`clean`）。**未操作 Docker**，未进入 S02。 + +## G17. 真实 MySQL 完整冒烟链仍待最终独立复验 + +本轮**未执行任何 Docker 命令、未连接真实 MySQL**。全部验证均为：shell 测试（假 docker / 假 mysql 注入）+ Maven H2/Flyway 测试。 + +因此以下**必须由独立复验在真实 MySQL/Docker 环境完成**： + +1. `SHOW COLUMNS FROM sms_verification_codes` 的 Field 集合与 Flyway 列集合对账（含 `expired_at`、不含 `expires_at`）； +2. 修复后的取码 SQL 在真实 MySQL 端到端执行成功（不再出现 ERROR 1054）； +3. F1 完整冒烟链（发码 → 取码 → 登录 → 后续接口）闭环。 + +**不得以本轮假库结果代替真实环境验收。** + +## G18. 一处必须记录的旁证（不在本轮修改范围） + +`docs/acceptance/s01-20260911/snapshot-sms.sql:4` 同样使用 `expires_at` 查询 `sms_verification_codes`： + +```sql +SELECT id, purpose, CHAR_LENGTH(code) AS code_len, + TIMESTAMPDIFF(SECOND, NOW(), expires_at) AS expire_delta_s, ... +FROM sms_verification_codes +``` + +这是同一字段错误的传播。该文件属上一轮独立验收证据，**不在本轮允许修改的文件范围内**，故保持原样未改，仅在此记录，供后续处理。 + +## G19. 字段名易混淆的说明（供后续维护） + +`expires_at` 并非拼写错误，它是本仓库中**三张表的真实列**： + +| 表 | 迁移 | +|---|---| +| `personal_data_export_tasks.expires_at` | V30 | +| `ability_attempts.expires_at` | V35 | +| `talent_invitations.expires_at`（含索引） | V40 | + +只有 `sms_verification_codes` 用 `expired_at`。因此本轮门禁**按表限定**，未写成"全库禁用 `expires_at`"——那样会误报并掩盖真实错误。契约门禁 C9 专门守卫这一区分。 + +--- + +**S01第四轮定向整改完成，待最终独立代码复验及真实MySQL/Docker黑盒复验。** diff --git a/docs/s02-auth-token-isolation-design.md b/docs/s02-auth-token-isolation-design.md new file mode 100644 index 0000000..4e8f052 --- /dev/null +++ b/docs/s02-auth-token-isolation-design.md @@ -0,0 +1,674 @@ +# S02 Access/Refresh Token 隔离、轮换与吊销设计 + +状态：S02 已实现并完成自动化验证与干净构建，待独立代码复验及真实 MySQL/Docker 黑盒验收。 + +文档类型：解释与技术参考。 + +目标读者：产品负责人、后端开发、前端联调、安全复验和真实环境验收人员。 + +解释版本：`s02-auth-token-isolation-v1` + +## 1. 目标 + +S02 修复当前 Refresh Token 可以作为 Access Token 使用的认证边界缺陷，并建立可轮换、可吊销、可检测重放的登录会话模型。 + +本设计必须保证： + +- 普通业务接口只接受 Access Token； +- 刷新接口只接受 Refresh Token； +- Token 原文不进入数据库、日志、审计、URL 或错误响应； +- 登录、刷新、登出、账号注销和用户禁用具有明确的吊销语义； +- 同一个 Refresh Token 在并发或重放场景中最多成功刷新一次； +- 旧的无 `type` Token 不被永久兼容； +- 不改变手机号验证码登录、角色、资源归属、评分、排名、推荐、邀约、申诉、消息撤回和简历上传语义。 + +## 2. 当前实现事实 + +截至基线提交 `96a920b`： + +1. `JwtTokenProvider.generateAccessToken` 没有强制写入 `type=access`。 +2. `generateRefreshToken` 写入了 `type=refresh`。 +3. `JwtAuthenticationFilter` 只验证 JWT 签名和过期时间，不验证 Token 类型。 +4. Access Token 与 Refresh Token 使用同一 `app.jwt.secret`。 +5. 因此签名有效且未过期的 Refresh Token 可以通过过滤器并建立普通业务登录态。 +6. 登录响应已经包含 `accessToken`、`refreshToken` 和 `expiresIn`。 +7. 当前没有 `/auth/refresh` 和 `/auth/logout`。 +8. `auth_tokens` 表、`AuthToken` 实体和 `AuthTokenRepository` 已存在，但未被登录、刷新、鉴权、登出或账号注销使用。 +9. 当前 JWT 没有 `sid` 和 `jti`，不能标识登录会话和单个 Token。 +10. 当前账号注销完成不会使已经签发的 JWT 立即失效。 +11. 当前 JWT 包含完整手机号；普通鉴权实际只需要用户 ID 和会话信息。 +12. `application.yml` 的 `refresh-expiration-ms` 当前错误地位于 `app.resume` 下，而 `application-dev.yml` 位于正确的 `app.jwt` 下。非 dev 环境可能依赖 Java 默认值，配置契约不一致。 +13. 现有 Access Token 默认有效期为 24 小时，Refresh Token 默认有效期为 7 天。 +14. 现有 `auth_tokens` 表没有会话标识、轮换父子关系、消费时间、撤销时间和乐观锁版本。 + +## 3. 威胁模型 + +本版重点防护以下风险： + +- Refresh Token 被复制到 `Authorization: Bearer` 后直接调用普通业务接口； +- 已登出或已注销用户继续使用旧 Access Token； +- Refresh Token 在日志、数据库、错误响应或 URL 中泄露； +- 同一个 Refresh Token 被并发刷新两次，产生两组有效 Token； +- 已消费 Refresh Token 被攻击者再次使用而系统无法识别； +- Token 类型缺失、大小写变化或未知值被宽松接受； +- 非法 subject、`sid` 或 `jti` 引发 500 或回显内部数据； +- 数据库或会话校验异常时过滤器错误放行； +- 多设备登录时，一个设备的普通登出误伤其他设备； +- 账号注销、用户禁用等全局安全事件没有撤销全部会话。 + +不在本版解决：终端设备指纹、地理异常检测、硬件绑定、OAuth/OIDC、短信供应商、验证码摘要化、密码登录和单点登录。 + +## 4. 设计决策 + +### D01：Token 类型强制隔离 + +- Access Token 必须包含精确字符串 `type=access`。 +- Refresh Token 必须包含精确字符串 `type=refresh`。 +- Token 类型区分大小写。 +- 类型缺失、空白、未知或不匹配均拒绝。 +- 普通业务过滤器只能解析 Access Token。 +- 刷新服务只能解析 Refresh Token。 + +### D02：Access 与 Refresh 使用独立签名密钥 + +新增配置： + +```yaml +app: + jwt: + access-secret: ${JWT_ACCESS_SECRET} + refresh-secret: ${JWT_REFRESH_SECRET} + token-hash-secret: ${JWT_TOKEN_HASH_SECRET} +``` + +三项密钥必须彼此独立。生产环境不允许自动回退到同一个默认密钥。测试配置使用固定的测试专用值，但不得进入生产配置。 + +独立密钥是类型 claim 之外的第二道隔离：即使未来某处遗漏类型判断，Refresh Token 也不能通过 Access Token 验签器。 + +### D03：旧 Token 采用强制重新登录 + +部署 S02 后： + +- 无 `type` 的旧 Access Token 拒绝； +- 旧 Refresh Token 虽有 `type=refresh`，但没有 `sid`、`jti` 和服务端记录，同样拒绝； +- 用户需要重新完成一次手机号验证码登录； +- 不提供永久兼容开关； +- 不把无 `type` Token 猜测为 Access Token。 + +前端必须统一处理 401：清除本地 Token，跳转登录页，不循环刷新。 + +### D04：保持现有有效期 + +- Access Token 默认 24 小时； +- Refresh Token 默认 7 天； +- 登录响应的 `expiresIn=86400` 保持现有含义； +- S02 不顺带缩短 Token 有效期； +- 有效期必须来自配置并经过正数、上限和单位校验。 + +### D05：每次登录创建独立设备会话 + +- 每次成功登录生成新的 `sessionId`； +- 同一用户可以同时拥有多个活动会话； +- 普通登出只撤销当前 `sessionId`； +- Refresh Token 重放只撤销对应 `sessionId`； +- 账号注销完成、用户禁用及未来的敏感认证信息变更撤销该用户全部会话。 + +本版不采集或保存设备指纹，不通过 User-Agent 判断设备身份。 + +### D06：JWT Claim 白名单 + +Access Token 必须包含： + +| Claim | 说明 | +|---|---| +| `sub` | 十进制正整数用户 ID | +| `type` | 固定为 `access` | +| `sid` | UUID 格式的会话 ID | +| `jti` | UUID 格式的 Token ID | +| `role` | 登录时角色，仅作响应和诊断辅助；资源权限仍以现有服务层校验为准 | +| `iat` | 签发时间 | +| `exp` | 过期时间 | +| `iss` | 固定发行者 `mydreamjob` | +| `aud` | 固定受众 `mydreamjob-api` | + +Refresh Token 必须包含： + +| Claim | 说明 | +|---|---| +| `sub` | 十进制正整数用户 ID | +| `type` | 固定为 `refresh` | +| `sid` | 与当前登录会话一致 | +| `jti` | 本次 Refresh Token 的唯一 ID | +| `iat` | 签发时间 | +| `exp` | 过期时间 | +| `iss` | 固定发行者 `mydreamjob` | +| `aud` | 固定受众 `mydreamjob-auth` | + +新 Token 不再包含手机号。不得加入验证码、邮箱、昵称、简历地址或其他个人资料。 + +### D07：Refresh Token 原文不落库 + +数据库只保存： + +```text +HMAC-SHA256(JWT_TOKEN_HASH_SECRET, rawRefreshToken) +``` + +- 不使用普通可逆加密； +- 不使用无密钥的快速摘要作为唯一保护； +- 比较摘要时使用常量时间比较； +- Token、摘要和签名密钥均不得写日志或审计； +- `token_hash` 的业务含义固定为 Refresh Token 摘要。 + +### D08：每次刷新强制轮换 + +刷新成功必须： + +1. 捕获一次 `capturedNow`； +2. 使用 Refresh 专用密钥验签； +3. 验证 `type`、`iss`、`aud`、`sub`、`sid`、`jti`、`iat` 和 `exp`； +4. 计算原始 Refresh Token 摘要； +5. 查询对应服务端记录； +6. 原子消费旧记录； +7. 生成新的 Access/Refresh Token 对； +8. 插入新的 Refresh Token 记录； +9. 提交事务后返回响应。 + +旧 Refresh Token 被消费后永久失效。 + +### D09：Refresh Token 重放关闭当前会话 + +若签名有效的 Refresh Token 对应记录已经被消费或撤销： + +- 本次刷新返回 HTTP 401； +- 撤销相同 `sessionId` 下的全部 Token 记录； +- 当前会话的所有 Access Token 随即失效； +- 不影响同一用户的其他设备会话； +- 写一条不含 Token、摘要或个人信息的安全审计； +- 错误响应不得说明记录是否存在、已消费还是已撤销。 + +### D10：Access Token 必须检查服务端会话状态 + +`JwtAuthenticationFilter` 在完成 Access JWT 验签后，还必须确认： + +- `sid` 属于 `sub` 对应用户； +- 会话存在活动、未消费且未撤销的 Refresh Token 记录； +- 会话未过期； +- 用户存在、处于 active 状态且未完成注销。 + +任一条件不满足时不得建立 `SecurityContext`。 + +数据库是第一版的事实来源。Redis 缓存不属于 S02 首版；后续若增加缓存，数据库仍是最终事实来源，缓存异常不得放行。 + +### D11：普通登出只撤销当前会话 + +`POST /auth/logout`： + +- 需要有效 Access Token； +- 从 Token 中读取 `sub` 和 `sid`，不接受客户端传 userId/sessionId； +- 撤销该用户当前 `sid` 的所有 Token 记录； +- 重复登出保持幂等； +- 不影响其他设备会话； +- 成功响应不返回 Token。 + +### D12：全局安全事件撤销全部会话 + +以下事件必须调用统一的 `revokeAllUserSessions(userId, reason, capturedNow)`： + +- 账号注销完成； +- 用户被禁用； +- 未来的手机号或认证凭据变更。 + +账号注销申请处于冷静期时不立即撤销全部会话，保持当前产品语义；注销完成时必须撤销。取消注销不恢复已经撤销的会话。 + +### D13：单次时间捕获 + +登录、刷新、登出、重放处置和全局吊销每个入口只允许调用一次 `Clock`： + +- JWT `iat`、`exp`； +- 数据库 `createdAt`、`expiredAt`、`consumedAt`、`revokedAt`； +- 审计时间判断； +- 响应有效期； + +均使用同一个 `capturedNow`。不得依赖 `new Date()`、`LocalDateTime.now()` 或系统默认时区散落取时。 + +固定业务时区为 `Asia/Shanghai`，数据库时间按项目现有约定落库。 + +### D14：失败关闭 + +以下情况一律不建立认证： + +- Token 解析异常； +- 类型、发行者或受众错误； +- subject、`sid` 或 `jti` 非法； +- 服务端记录不存在； +- 会话已撤销、已消费或过期； +- 用户不存在、被禁用或已注销； +- 数据库读取或摘要计算失败。 + +过滤器只记录固定安全文本和 requestId，不记录异常消息、Token、摘要或 claim 原值。 + +### D15：错误码与 HTTP 语义 + +优先复用现有： + +- `UNAUTHORIZED(2001)`； +- `TOKEN_EXPIRED(2003)`； +- `TOKEN_INVALID(2004)`； +- `SERVICE_UNAVAILABLE(9001)`。 + +公共认证失败统一表现为 HTTP 401。不得通过不同响应告诉客户端 Token 是“不存在”“已消费”“已撤销”还是“重放”。 + +除非实现阶段发现现有错误映射无法满足固定 401，才允许提出新增 ErrorCode；未获确认不得新增。 + +### D16：接口增量固定为两个 operation + +新增： + +- `POST /auth/refresh`； +- `POST /auth/logout`。 + +预计 OpenAPI 从 `173 paths / 211 operations` 变为 `175 paths / 213 operations`。 + +不得新增会话管理列表、全部设备登出、Token introspection 或管理员代操作接口。 + +### D17：并发由数据库条件更新保证 + +同一 Refresh Token 并发刷新： + +- 使用包含 `id`、`consumed_at IS NULL`、`revoked=0` 和 `version` 的条件更新； +- 只有一个事务可以消费成功； +- 其他事务不得生成第二组有效 Token； +- 失败方执行重放处置或返回固定 401； +- 不使用 JVM 本地锁作为正确性基础。 + +### D18：设计范围隔离 + +S02 不改变： + +- 短信验证码生成、过期、锁定和发送语义； +- 登录自动创建用户的现有规则； +- 用户角色及资源归属； +- 岗位、投递、Offer、评分、排名、推荐、人才发现、邀约； +- 申诉、消息撤回和简历上传； +- V1–V41 迁移内容。 + +## 5. Token 决策表 + +| Token/状态 | 普通业务接口 | `/auth/refresh` | `/auth/logout` | 注销完成后 | 过期后 | +|---|---|---|---|---|---| +| 有效 Access | 允许 | 拒绝 | 允许 | 拒绝 | 拒绝 | +| 有效 Refresh | 拒绝 | 允许并轮换 | 拒绝 | 拒绝 | 拒绝 | +| 无 `type` 旧 Token | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | +| 未知 `type` | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | +| 已消费 Refresh | 拒绝 | 401 并撤销当前会话 | 拒绝 | 拒绝 | 拒绝 | +| 已撤销 Token | 拒绝 | 拒绝 | 幂等 | 拒绝 | 拒绝 | +| 会话不存在 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | +| 用户被禁用 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | + +## 6. 状态机 + +单个 Refresh Token 记录状态： + +```text +ACTIVE -> CONSUMED +ACTIVE -> REVOKED +CONSUMED -> REVOKED (重放或全局吊销) +``` + +不允许从 `CONSUMED` 或 `REVOKED` 恢复为 `ACTIVE`。 + +会话状态由同一 `sessionId` 下的记录推导：存在一个未消费、未撤销且未过期的当前 Refresh Token 记录时，会话为活动状态。 + +## 7. 数据模型 + +### 7.1 迁移原则 + +- 编码前重新确认最新 Flyway；当前建议文件名为 `V42__auth_token_sessions.sql`； +- 若 V42 已被占用，停止并重新编号； +- 不修改 V1–V41； +- 不删除旧记录； +- 新字段先允许旧数据为空，新签发记录由应用强制非空； +- Hibernate 使用 `ddl-auto=validate`； +- 迁移必须兼容真实 MySQL 8.4 和项目 H2 测试模式。 + +### 7.2 `auth_tokens` 扩展字段 + +建议增加： + +| 字段 | 类型 | 说明 | +|---|---|---| +| `session_id` | VARCHAR(36) NULL | 每次登录的会话 UUID | +| `token_jti` | VARCHAR(36) NULL | Refresh Token 的 jti | +| `parent_token_id` | BIGINT NULL | 轮换前一条记录 ID | +| `consumed_at` | DATETIME NULL | 成功刷新时消费时间 | +| `revoked_at` | DATETIME NULL | 撤销时间 | +| `revocation_reason` | VARCHAR(40) NULL | 固定白名单原因 | +| `version` | BIGINT NOT NULL DEFAULT 0 | 乐观锁/条件更新版本 | + +固定含义： + +- `token_hash`：Refresh Token 的 HMAC-SHA256 摘要； +- `token_type`：新记录固定 `REFRESH`； +- `expired_at`：Refresh Token 到期时间； +- `revoked`：现有兼容布尔值； +- `refresh_token_hash`：旧字段保留但新逻辑不依赖，后续版本再评估移除。 + +索引建议： + +```sql +INDEX idx_auth_tokens_session_active (session_id, revoked, consumed_at, expired_at) +INDEX idx_auth_tokens_user_session (user_id, session_id) +UNIQUE INDEX uk_auth_tokens_token_jti (token_jti) +``` + +不得在本轮清理或改写旧 `auth_tokens` 数据。`session_id IS NULL` 的旧记录永远不能被新鉴权逻辑视为活动会话。 + +## 8. 组件职责 + +### `JwtTokenProvider` + +- 分别生成和解析 Access/Refresh Token； +- 使用不同签名密钥； +- 强制校验类型、发行者、受众和必需 claim； +- 接收外部传入的 `capturedNow`，不自行重复取时； +- 不访问数据库。 + +### `AuthTokenHasher` + +- 只负责 Refresh Token HMAC 摘要； +- 使用独立密钥； +- 支持常量时间比较； +- 不记录输入和输出。 + +### `AuthSessionService` + +- 创建会话和首个 Refresh Token 记录； +- 验证、消费、轮换 Refresh Token； +- 判断 Access Token 所属会话是否活动； +- 撤销当前会话或用户全部会话； +- 承担事务与并发控制。 + +### `JwtAuthenticationFilter` + +- 只接受 Access Token； +- 调用 Provider 完成密码学和 claim 校验； +- 调用 Session Service 验证服务端会话状态； +- 通过后建立 SecurityContext； +- 失败时保持匿名，由 SecurityFilterChain 返回既有 401。 + +### `AuthService` + +- 登录成功时创建服务端会话； +- 只在会话记录成功持久化后返回 Token； +- 编排刷新和登出； +- 保持现有用户登录/自动创建语义。 + +### `AuthController` + +- 接收白名单 DTO； +- 不解析 JWT、不计算摘要、不接收 userId/sessionId； +- 不在异常响应中回显 Token； +- 不返回 Entity 或数据库字段。 + +## 9. API 契约 + +### 9.1 登录 + +现有 `POST /auth/login` 请求不变。 + +响应字段保持： + +- `userId` +- `phone` +- `nickname` +- `role` +- `accessToken` +- `refreshToken` +- `expiresIn` + +新 Token 从 S02 起包含完整类型和会话 claim。旧客户端不需要解析 JWT 内部 claim。 + +### 9.2 刷新 + +`POST /auth/refresh` + +请求： + +```json +{ + "refreshToken": "" +} +``` + +成功响应： + +```json +{ + "code": 1000, + "data": { + "accessToken": "", + "refreshToken": "", + "expiresIn": 86400 + }, + "requestId": "" +} +``` + +要求： + +- 请求体只允许 `refreshToken`； +- 不能为空，设置合理长度上限； +- 不接受查询参数或路径参数中的 Token； +- 旧 Refresh Token 刷新成功后立即失效。 + +### 9.3 登出 + +`POST /auth/logout` + +- 使用 `Authorization: Bearer `； +- 无 request body； +- 成功返回现有 `ApiResponse` 包装的固定消息； +- 重复登出按幂等成功处理，但已经撤销的 Access Token通常无法再通过过滤器，因此客户端不应依赖第二次请求； +- 不接收 Refresh Token、userId 或 sessionId 参数。 + +## 10. SecurityConfig + +- `/auth/login`、`/auth/sms/send` 和 `/auth/refresh` 允许匿名进入； +- `/auth/logout` 必须 authenticated； +- `permitAll` 只表示可进入 Controller，不代表 Refresh Token 校验成功； +- 其他接口规则不变； +- 不扩大 `/auth/**` 为整体公开； +- Refresh Token 放入 Authorization 头访问任何普通接口必须得到 401。 + +## 11. 事务与并发 + +### 登录 + +用户读取/创建、会话记录创建和登录审计在一个事务内完成。会话记录失败时不能返回 Token。 + +### 刷新 + +旧 Token 条件消费和新 Token 记录插入在一个事务内完成。提交失败时不能返回新 Token。 + +### 登出 + +同一事务撤销当前会话记录并写脱敏审计。 + +### 重放 + +发现已消费 Token 时，在独立明确事务中撤销对应会话，避免刷新事务回滚后撤销也丢失。实现必须通过测试证明最终会话已撤销。 + +## 12. 审计与日志 + +允许的审计动作建议： + +- `AUTH_SESSION_CREATED` +- `AUTH_TOKEN_REFRESHED` +- `AUTH_SESSION_REVOKED` +- `AUTH_REFRESH_REUSE_DETECTED` + +若新增审计动作不需要新增 ErrorCode，也不需要新表。 + +审计详情仅允许： + +- userId； +- sessionId 的 HMAC 摘要或固定截断不可逆标识； +- reason 白名单； +- requestId； +- 结果状态。 + +禁止： + +- Access Token； +- Refresh Token； +- Token 摘要； +- JWT claim 全文； +- 完整手机号、邮箱； +- Authorization 请求头； +- 异常对象 `toString()`。 + +## 13. 前端联调语义 + +前端必须： + +1. 登录后分别保存 Access 和 Refresh Token； +2. 普通请求只携带 Access Token； +3. 收到普通 401 时最多执行一次刷新； +4. 刷新成功后原子替换两个 Token； +5. 刷新失败时清除两个 Token并跳转登录； +6. 防止多个并发请求同时用同一 Refresh Token刷新； +7. 登出时调用 `/auth/logout`，随后无条件清除本地 Token； +8. S02 上线后接受一次强制重新登录。 + +不允许把 Refresh Token 放入 URL、本地日志、埋点或错误上报正文。 + +## 14. 自动化测试要求 + +至少覆盖： + +### Provider + +- Access 包含 `type=access`； +- Refresh 包含 `type=refresh`； +- 两类 Token 使用不同密钥； +- 交叉验签失败； +- issuer/audience/type/sub/sid/jti 缺失或错误时拒绝； +- 过期边界； +- 新 Token 不含手机号。 + +### Filter + +- Access Token 可访问普通接口； +- Refresh Token 访问普通接口为 401； +- 无 type、未知 type、非法 subject/sid/jti 为 401； +- 已撤销会话、用户禁用、注销完成为 401； +- 服务端检查异常时不放行； +- 响应和日志不回显 Token。 + +### 登录与存储 + +- 登录生成一条活动会话记录； +- 数据库只保存摘要； +- 登录响应结构不变； +- 会话持久化失败不返回 Token； +- 多次登录生成不同 sessionId。 + +### 刷新与并发 + +- 正常刷新轮换 Token； +- 原 Token 变为 consumed； +- 新旧 jti 不同、sid 相同； +- 同一 Refresh Token 第二次使用返回 401并撤销当前会话； +- 两线程并发刷新最多一个成功； +- 最终只有一个后继 Token； +- 无 500、死锁或重复活动记录。 + +### 登出与注销 + +- 登出撤销当前设备； +- 其他设备仍可用； +- 重复撤销幂等； +- 注销完成撤销全部设备； +- 注销取消不恢复旧会话； +- 被禁用用户 Token 无效。 + +### JSON 与日志脱敏 + +递归禁止出现 Token、摘要、Authorization、手机号、邮箱、secret、password 和内部对象。 + +## 15. 真实 MySQL/Docker 验收 + +必须验证： + +- 新迁移在真实 MySQL 8.4 成功； +- `ddl-auto=validate` 通过； +- 登录记录只含摘要； +- Refresh Token 无法调用普通接口； +- Access Token 无法调用刷新接口； +- 正常轮换、重放和两线程并发符合设计； +- 登出后旧 Access/Refresh 均失效； +- 多设备隔离； +- 注销完成全部失效； +- 运行时 OpenAPI 为预计的 `175/213`； +- 日志、审计和数据库无 Token 原文； +- RabbitMQ、通知、评分和其他业务表无新增副作用。 + +## 16. 发布与回滚 + +### 发布前 + +- 前端必须先支持刷新失败后重新登录； +- 配置三个独立强密钥； +- 在隔离环境完成真实 MySQL 迁移和黑盒； +- 确认所有节点同时升级，避免新旧 Token 策略混跑。 + +### 发布结果 + +- 所有旧 Token失效； +- 所有用户需要重新登录一次； +- 新登录产生服务端会话记录。 + +### 回滚 + +- 不回滚或修改已执行 Flyway； +- 应用回滚到旧版会重新接受只看签名的 Token，存在安全倒退； +- 因此 S02 发布后不允许直接回滚到未隔离版本； +- 紧急回滚应发布保持类型隔离的兼容修复版本，而不是恢复旧过滤器。 + +## 17. 验收门槛 + +只有全部满足才可冻结 S02： + +1. Refresh Token 不能访问任何普通业务接口； +2. Access Token 不能用于刷新； +3. 无 type 旧 Token 被拒绝； +4. Token 原文不落库、不入日志、不入审计； +5. 每次刷新完成轮换； +6. 重放撤销当前会话； +7. 并发刷新最多成功一次； +8. 登出立即使当前会话 Access/Refresh 失效； +9. 多设备会话互不误伤； +10. 注销完成和用户禁用使全部会话失效； +11. 旧登录响应字段保持兼容； +12. 自动化测试 0 Failures/Errors/Skipped； +13. `mvn clean verify` 成功； +14. 静态和运行时 OpenAPI 一致； +15. 真实 MySQL迁移和 schema validation成功； +16. 不改变其他业务模块结果。 + +## 18. 明确非目标与剩余风险 + +本版不实现： + +- 查看全部登录设备； +- 远程踢出单个其他设备； +- OAuth/OIDC； +- 短信验证码数据库摘要化； +- 真实短信供应商； +- Redis 会话缓存； +- Access Token 有效期缩短； +- 浏览器 HttpOnly Cookie 模式； +- 设备指纹和异常登录检测。 + +后续可以单独评估，但不得作为 S02 验收通过的替代条件。 diff --git a/docs/s02-auth-token-isolation-implementation-instruction.md b/docs/s02-auth-token-isolation-implementation-instruction.md new file mode 100644 index 0000000..8488d77 --- /dev/null +++ b/docs/s02-auth-token-isolation-implementation-instruction.md @@ -0,0 +1,724 @@ +# S02 Access/Refresh Token 隔离与吊销：编码实施指令 + +> 本文可原样交给编码执行者。权威设计为 `docs/s02-auth-token-isolation-design.md`。任何与设计冲突、会改变其他业务语义或需要扩大公共接口的情况，必须停止并报告，不得自行改设计。 + +## 一、任务目标 + +执行 S02「Access/Refresh Token 隔离、轮换与吊销」。 + +项目根目录： + +```text +C:\Users\15642\Desktop\zhilai +``` + +基线要求： + +- 必须包含 `b5084fd`（S01 认证安全整改）； +- 必须包含 `96a920b`（简历上传安全加固）； +- 当前最新 Flyway 应为 `V41__message_recall.sql`； +- 当前静态 OpenAPI 应为 `173 paths / 211 operations`； +- S02 预计新增两个接口，完成后为 `175 paths / 213 operations`。 + +本轮只实现 S02，不进入 S03、Q01 或 R01。 + +## 二、硬性边界 + +允许： + +1. 修改认证 Token 生成、解析、过滤、登录、刷新和登出链路； +2. 扩展现有 `auth_tokens` 表； +3. 新增一个 Flyway，建议 `V42__auth_token_sessions.sql`； +4. 新增 `/auth/refresh` 和 `/auth/logout`； +5. 将账号注销完成、用户禁用接入会话吊销； +6. 更新认证文档、前端联调文档和 OpenAPI； +7. 新增自动化测试。 + +禁止： + +1. 修改 V1–V41； +2. 删除或重建 `auth_tokens` 表； +3. 在数据库、日志、审计、异常或 URL 中保存/输出原始 Token； +4. 永久兼容无 `type` 旧 Token； +5. 把 Refresh Token 当 Access Token； +6. 使用同一密钥签发 Access 和 Refresh； +7. 使用 JVM 本地锁代替数据库并发控制； +8. 修改短信验证码、登录自动注册、角色和资源归属语义； +9. 修改评分、排名、推荐、人才发现、邀约、Offer、申诉、消息撤回或简历上传； +10. 新增设备列表、全部设备登出、Token introspection 等接口； +11. 删除、禁用或放宽既有测试； +12. `git reset`、`git restore`、`git checkout`、`git clean`； +13. `git add -A`、commit、push； +14. 删除、移动或覆盖历史未跟踪脚本、日志、JSON、SQL、xlsx、`.env`； +15. 操作 Docker或执行真实 MySQL 黑盒，除非负责人另行授权。 + +## 三、开始前检查 + +执行并记录： + +```powershell +cd C:\Users\15642\Desktop\zhilai +git branch --show-current +git status --short +git diff --cached --name-only +git log -5 --oneline +git diff --check +git diff --name-only -- mydreamjob-server/src/main/resources/db/migration +``` + +要求： + +- 暂存区为空； +- 记录 HEAD； +- 确认基线包含 `96a920b`； +- 保护全部已有修改和未跟踪文件； +- 搜索并完整阅读适用的 `AGENTS.md`，不存在则记录； +- 若认证相关文件存在不属于 S02 的未提交修改，停止并报告； +- 建议从已包含 `96a920b` 的基线创建独立分支 `feat/s02-token-isolation`，但不得覆盖用户现有分支或工作树。 + +## 四、必须完整阅读 + +权威文档： + +```text +docs/s02-auth-token-isolation-design.md +docs/api-v0.1.md +docs/frontend-integration.md +docs/phase1-scope-and-acceptance.md +docs/backend-development-roadmap.md +docs/openapi-rc.json +docs/verify_openapi.py +``` + +生产代码： + +```text +mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtTokenProvider.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtAuthenticationFilter.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthService.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthToken.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenRepository.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/User.java +mydreamjob-server/src/main/java/com/mydreamjob/auth/UserRepository.java +mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java +mydreamjob-server/src/main/java/com/mydreamjob/security/CurrentUserAccessor.java +mydreamjob-server/src/main/java/com/mydreamjob/config/SecurityConfig.java +mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorCode.java +mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java +mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionService.java +mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionCompletionWorker.java +mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java +mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditService.java +mydreamjob-server/src/main/resources/application.yml +mydreamjob-server/src/main/resources/application-dev.yml +mydreamjob-server/src/main/resources/db/migration/V1__base_schema.sql +``` + +测试： + +```text +mydreamjob-server/src/test/java/com/mydreamjob/auth/** +mydreamjob-server/src/test/java/com/mydreamjob/security/** +mydreamjob-server/src/test/java/com/mydreamjob/deletion/** +mydreamjob-server/src/test/resources/application-test.yml +mydreamjob-server/src/test/resources/application-integration-test.yml +``` + +搜索： + +```powershell +rg -n "generateAccessToken|generateRefreshToken|validateToken|parseUserId|AuthToken|AuthTokenRepository|refreshToken|Authorization|logout|type.*refresh|JWT_SECRET|refresh-expiration" mydreamjob-server/src docs +``` + +## 五、先补失败测试 + +编码前先增加失败测试，证明当前缺陷存在。至少包括： + +1. `refreshTokenCannotAuthenticateOrdinaryEndpoint`：当前 Refresh Token 访问 `/auth/me` 不应成功；修复前应失败。 +2. `accessTokenMustContainAccessType`：Access Token 必须有 `type=access`。 +3. `accessTokenCannotBeUsedAtRefreshEndpoint`。 +4. `legacyTokenWithoutTypeIsRejected`。 +5. `accessAndRefreshTokensCannotCrossVerify`。 +6. `revokedSessionCannotAuthenticate`。 +7. `sameRefreshTokenCannotBeConsumedTwice`。 + +保留修复前失败输出。不得通过修改期望状态码掩盖问题。 + +## 六、配置整改 + +修改 `application.yml`： + +1. 将错误位于 `app.resume.refresh-expiration-ms` 的配置移回 `app.jwt`； +2. 增加： + +```yaml +app: + jwt: + access-secret: ${JWT_ACCESS_SECRET} + refresh-secret: ${JWT_REFRESH_SECRET} + token-hash-secret: ${JWT_TOKEN_HASH_SECRET} + expiration-ms: ${JWT_EXPIRATION_MS:86400000} + refresh-expiration-ms: ${JWT_REFRESH_EXPIRATION_MS:604800000} + issuer: mydreamjob + access-audience: mydreamjob-api + refresh-audience: mydreamjob-auth +``` + +要求： + +- 生产配置不得提供秘密默认值； +- 三项密钥不得互相回退； +- 启动时校验密钥长度和互异性； +- 测试 profile 使用固定测试密钥； +- 不打印密钥； +- 原 `app.jwt.secret` 仅作为旧配置迁移项处理，S02 新 Token 不使用它； +- 缺失、空值或三项相同必须启动失败，并给出固定、不含密钥的安全配置错误。 + +新增配置测试： + +- 三项有效且互异时启动成功； +- 任一缺失、空白或过短时失败； +- access/refresh 相同时失败； +- hash secret 与签名密钥相同时失败； +- 错误日志不包含密钥值。 + +## 七、JWT Provider 重构 + +修改 `JwtTokenProvider`，禁止继续使用通用的 `validateToken + parseUserId` 组合来判断 Token 用途。 + +建议提供明确 API： + +```java +IssuedToken generateAccessToken(..., Instant capturedNow); +IssuedToken generateRefreshToken(..., Instant capturedNow); +AccessTokenClaims parseAndValidateAccessToken(String rawToken, Instant capturedNow); +RefreshTokenClaims parseAndValidateRefreshToken(String rawToken, Instant capturedNow); +``` + +要求： + +- Access 使用 access secret； +- Refresh 使用 refresh secret； +- 精确校验 `type`、`iss` 和 `aud`； +- 验证 `sub` 为正整数； +- 验证 `sid`、`jti` 为规范 UUID； +- Access 必须含 `role`； +- 新 Token 不含 `phone`； +- `iat`、`exp` 使用调用方传入的同一 `capturedNow`； +- 过期判断边界固定：`exp <= capturedNow` 视为过期； +- 不向调用方返回原始 Claims 对象； +- 异常消息不得包含 Token 或 claim 原值。 + +增加强类型内部 record/DTO，例如： + +```text +AccessTokenClaims +RefreshTokenClaims +IssuedToken +``` + +不要让 Controller 直接依赖 JJWT 类型。 + +## 八、Token 摘要 + +新增内部服务，例如： + +```text +mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenHasher.java +``` + +要求： + +- `HmacSHA256`； +- 密钥为 `app.jwt.token-hash-secret`； +- 输出固定长度十六进制或 Base64URL； +- 不存原文； +- 不记录输入、输出或异常原值； +- 对固定输入输出稳定； +- 比较使用 `MessageDigest.isEqual`； +- 单元测试使用公开测试向量或确定性断言。 + +## 九、Flyway V42 + +编码前执行： + +```powershell +Get-ChildItem mydreamjob-server/src/main/resources/db/migration | Sort-Object Name | Select-Object -Last 10 +``` + +只有 V42 未被占用时才新增： + +```text +mydreamjob-server/src/main/resources/db/migration/V42__auth_token_sessions.sql +``` + +扩展 `auth_tokens`： + +```text +session_id VARCHAR(36) NULL +token_jti VARCHAR(36) NULL +parent_token_id BIGINT NULL +consumed_at DATETIME NULL +revoked_at DATETIME NULL +revocation_reason VARCHAR(40) NULL +version BIGINT NOT NULL DEFAULT 0 +``` + +新增索引： + +```text +idx_auth_tokens_session_active(session_id, revoked, consumed_at, expired_at) +idx_auth_tokens_user_session(user_id, session_id) +uk_auth_tokens_token_jti(token_jti) UNIQUE +``` + +要求： + +- 不修改旧列、不删除旧数据； +- `session_id IS NULL` 的旧行不参与新会话认证； +- 不新增其他表； +- 不添加级联删除； +- CHECK/索引语法必须通过 MySQL 8.4 和 H2 MODE=MySQL； +- 更新 `AuthToken` 实体并使用 `@Version`； +- `token_hash` 保存 Refresh Token HMAC 摘要； +- 新记录 `token_type=REFRESH`； +- `refresh_token_hash` 保留但新逻辑不依赖。 + +新增持久化测试： + +- 旧格式行仍可存在； +- 新记录字段正确； +- `token_jti` 唯一； +- 默认 version=0； +- 两个 EntityManager 的旧 version 更新冲突； +- 不保存原始 JWT。 + +## 十、Repository 原子操作 + +`AuthTokenRepository` 增加明确查询和条件更新，禁止 `findById -> set -> save` 作为并发消费保证。 + +至少实现： + +1. 按 `tokenHash` 查询候选 Refresh 记录； +2. 按 `userId + sessionId` 判断活动会话； +3. 原子消费：条件包含 `id`、`expectedVersion`、`revoked=false`、`consumedAt IS NULL`、`expiredAt > capturedNow`； +4. 按 `userId + sessionId` 撤销当前会话； +5. 按 `userId` 撤销全部会话。 + +所有更新返回受影响行数并严格检查。不得通过捕获异常后继续返回成功。 + +## 十一、AuthSessionService + +新增： + +```text +mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthSessionService.java +``` + +职责： + +- 创建登录会话； +- 保存首个 Refresh Token 摘要； +- 校验 Access 所属会话； +- 消费并轮换 Refresh Token； +- 撤销当前会话； +- 撤销用户全部会话； +- 处理重放。 + +### 登录 + +- 捕获一次时间； +- 生成随机 UUID `sid`； +- 生成 Access 和 Refresh 的独立 `jti`； +- 生成 Token； +- 保存 Refresh 摘要； +- 事务提交成功后才返回； +- 多次登录必须得到不同 `sid`。 + +### 刷新 + +- Controller 传入原始 Refresh Token，但原文只在内存短暂存在； +- Provider 校验 Refresh； +- 摘要查询记录； +- claim 中的 userId/sid/jti 必须与数据库一致； +- 原子消费旧记录； +- 插入同 sid 的新记录； +- 新旧 jti 不同； +- 新 Access 和 Refresh 使用同一次 `capturedNow`； +- 旧 Token 再次使用返回固定 401。 + +### 重放 + +- 已消费或已撤销 Token 被再次提交时撤销整个当前 session； +- 撤销必须在不会随当前失败事务回滚丢失的事务边界执行； +- 写一条脱敏审计； +- 不回显“已消费”“已撤销”或数据库状态。 + +### 活动会话判断 + +- session 必须属于 user； +- 存在未消费、未撤销、未过期的当前 Refresh 记录； +- 用户 active； +- 账号注销未完成； +- 数据库错误失败关闭。 + +## 十二、登录服务 + +修改 `AuthService.mockLogin`： + +- 保持验证码、自动注册、注销墓碑和响应字段不变； +- 改为创建 AuthSession； +- Access Token 必须带 `type=access`； +- Refresh Token 必须带 `type=refresh`； +- 响应仍包含 `userId/phone/nickname/role/accessToken/refreshToken/expiresIn`； +- 数据库只保存 Refresh 摘要； +- 会话持久化失败时整个登录事务失败，不得返回 Token或写成功审计； +- 不改变 `expiresIn=86400`。 + +## 十三、认证过滤器 + +修改 `JwtAuthenticationFilter`： + +- 只调用 `parseAndValidateAccessToken`； +- Refresh Token、无 type、未知 type、错误 issuer/audience 必须拒绝； +- 验证服务端 session； +- 验证用户 active 和注销状态； +- 通过后使用 userId 建立 SecurityContext； +- 不把 Token claim 直接作为权限真相； +- 任何失败均不得建立部分认证； +- 清理可能存在的 SecurityContext； +- 日志使用固定安全文本，不使用异常 `getMessage()`； +- 不回显 Token、subject、sid、jti。 + +真实 MockMvc 测试必须覆盖： + +- Access 访问 `/auth/me` 成功； +- Refresh 访问 `/auth/me` 为 401； +- Access/Refresh 交叉密钥失败； +- 无 type、未知 type、非法 subject/sid/jti 为 401； +- 撤销 session 为 401； +- 用户禁用为 401； +- 服务端校验抛异常时不放行、不返回 500 内部对象。 + +## 十四、刷新和登出接口 + +新增白名单 DTO： + +```text +auth/dto/RefreshTokenRequest.java +auth/dto/TokenPairResponse.java +``` + +### `POST /auth/refresh` + +- `SecurityConfig` 中精确 permitAll； +- 请求体只包含 `refreshToken`； +- `@NotBlank` 且设置合理长度上限； +- Token 不允许作为 query/path 参数； +- 成功返回新 Token 对和 `expiresIn`； +- Access Token 作为 refreshToken 提交必须 401； +- 所有认证失败统一安全响应。 + +### `POST /auth/logout` + +- 必须 authenticated； +- 无 requestBody； +- 从通过验证的 Access Token claims / SecurityContext 取得 userId 和 sid； +- 不接收 userId、sessionId、refreshToken； +- 撤销当前 session； +- 保持幂等语义； +- 成功响应不包含 Token。 + +`AuthController` 不得计算摘要、解析 JWT、访问 Repository 或重复实现会话逻辑。 + +## 十五、注销与用户禁用 + +在不改变账号注销状态机的前提下： + +- `AccountDeletionCompletionWorker` 成功完成注销时撤销用户全部会话； +- 状态更新和会话撤销必须具备一致事务语义； +- 重复完成不重复产生不受控副作用； +- 注销申请 PENDING 时不强制退出； +- 取消注销不恢复旧 session； +- Filter 每次认证必须拒绝 inactive 或 COMPLETED 用户； +- 不接受客户端指定需要撤销的 userId。 + +补测试证明： + +- 注销完成后所有设备 Access/Refresh 均失效； +- 其他用户会话不受影响； +- 禁用用户不能继续认证； +- candidate scoring、消息、投递等业务表不被修改。 + +## 十六、审计隐私 + +允许的固定动作： + +```text +AUTH_SESSION_CREATED +AUTH_TOKEN_REFRESHED +AUTH_SESSION_REVOKED +AUTH_REFRESH_REUSE_DETECTED +``` + +details 使用 ObjectMapper 序列化白名单 Map/record，禁止拼接不受控 JSON。 + +禁止进入日志、审计和响应： + +```text +accessToken +refreshToken +Authorization +tokenHash +refreshTokenHash +JWT 原文 +完整手机号 +email +password +secret +Claims 对象 +异常对象 toString +``` + +日志测试必须捕获真实 Logback 输出，不得只 Mockito verify logger。 + +## 十七、单次 Clock + +注入 `Clock`，使用 `ZoneId.of("Asia/Shanghai")` 的测试 Clock。 + +分别验证登录、刷新、登出、重放和注销完成： + +- 每个入口只读取 Clock 一次； +- JWT iat/exp； +- DB createdAt/expiredAt/consumedAt/revokedAt； +- 审计和响应； + +均使用首次捕获时间。 + +禁止使用 `Thread.sleep()`、系统默认时区或真实时间碰撞作为核心测试。 + +## 十八、并发测试 + +新增真实 H2 集成并发测试： + +- `@SpringBootTest`； +- integration-test profile； +- 真实 Service、Repository、事务和 EntityManager； +- 两个线程和独立事务； +- 使用 CountDownLatch 同时开始； +- 不 Mock 条件更新。 + +测试： + +1. `concurrentRefreshOnlyOneRequestSucceeds`； +2. `refreshReplayRevokesOnlyCurrentSession`； +3. `differentSessionsRefreshIndependently`； +4. `logoutRacingWithRefreshCannotLeaveActiveToken`。 + +断言： + +- 同一 Token 最多一个刷新成功； +- 不产生两个活动后继 Token； +- 失败方不返回 500； +- 当前 session 被安全撤销； +- 其他 session 不受影响； +- 无死锁和未处理乐观锁异常。 + +## 十九、完整测试矩阵 + +建议新增： + +```text +JwtTokenTypeIsolationTest.java +JwtAuthenticationTypeIntegrationTest.java +AuthTokenHasherTest.java +AuthSessionServiceTest.java +AuthSessionPersistenceIntegrationTest.java +AuthRefreshControllerTest.java +AuthRefreshHttpIntegrationTest.java +AuthRefreshConcurrencyIntegrationTest.java +AuthSessionRevocationIntegrationTest.java +AuthTokenClockConsistencyTest.java +AuthTokenRedactionTest.java +``` + +至少覆盖： + +### 类型和 claim + +- access/refresh 类型； +- 独立密钥； +- issuer/audience； +- subject/sid/jti； +- 无 type 和未知 type； +- 过期边界； +- Token 不含手机号。 + +### 生命周期 + +- 登录； +- 刷新轮换； +- 二次使用； +- 并发刷新； +- 当前设备登出； +- 多设备隔离； +- 注销完成； +- 用户禁用。 + +### HTTP + +- 匿名刷新携带有效 Refresh 成功； +- Access 调刷新 401； +- Refresh 调普通接口 401； +- 无 Token 登出 401； +- 有效 Access 登出成功； +- 错误响应不泄漏。 + +### 副作用 + +- 原始 Token 不落库； +- 不产生 RabbitMQ、通知或短信； +- 不修改评分、排名、推荐、邀约、消息和简历表； +- 只产生预期 auth_tokens 和白名单审计变化。 + +## 二十、OpenAPI 和文档 + +更新： + +```text +docs/openapi-rc.json +docs/verify_openapi.py +docs/api-v0.1.md +docs/frontend-integration.md +docs/backend-development-roadmap.md +docs/phase1-scope-and-acceptance.md +docs/s02-auth-token-isolation-design.md +docs/s02-auth-token-isolation-implementation-instruction.md +``` + +运行时生成 OpenAPI，不得手工伪造 schema。 + +`verify_openapi.py` 增加递归断言： + +1. 总数为 `175 paths / 213 operations`； +2. 只新增 `/auth/refresh` 和 `/auth/logout`； +3. Refresh 请求体只含 `refreshToken`； +4. Logout 无 requestBody； +5. 普通安全方案说明只接受 Access Token； +6. schema 不包含 tokenHash、refreshTokenHash、session 数据库对象、phone、secret； +7. 登录原有字段不删除； +8. 不新增其他认证或管理接口。 + +前端文档必须明确： + +- 上线时旧 Token 全部失效； +- 普通请求只使用 Access； +- 401 时最多刷新一次； +- 刷新请求必须串行； +- 刷新失败清除 Token并重新登录； +- 登出后无条件清除本地 Token； +- 不记录或上报 Token。 + +## 二十一、验证顺序 + +先运行新增定向测试，按实际类名调整： + +```powershell +cd C:\Users\15642\Desktop\zhilai\mydreamjob-server +mvn -Dtest="JwtTokenTypeIsolationTest,JwtAuthenticationTypeIntegrationTest,AuthTokenHasherTest,AuthSessionServiceTest,AuthSessionPersistenceIntegrationTest,AuthRefreshControllerTest,AuthRefreshHttpIntegrationTest,AuthRefreshConcurrencyIntegrationTest,AuthSessionRevocationIntegrationTest,AuthTokenClockConsistencyTest,AuthTokenRedactionTest" test +``` + +再运行认证和注销关联回归： + +```powershell +mvn -Dtest="*Auth*Test,*Jwt*Test,*Security*Test,*Deletion*Test,*Sms*Test" test +``` + +最后执行： + +```powershell +mvn test +mvn clean verify +python ..\docs\verify_openapi.py +cd C:\Users\15642\Desktop\zhilai +git diff --check +git status --short +git diff --cached --name-only +git diff --name-only -- mydreamjob-server/src/main/resources/db/migration +``` + +要求： + +- Failures=0； +- Errors=0； +- Skipped=0； +- `mvn clean verify` BUILD SUCCESS； +- OpenAPI=`175/213`； +- 暂存区为空； +- 唯一新迁移为实际确认编号的 auth token migration； +- 未修改 V1–V41； +- 未 commit、未 push。 + +如果 clean verify 因正在运行的 JAR 锁定： + +- 查询实际 PID、端口和完整命令行； +- 不结束未知进程； +- 报告并等待负责人确认。 + +## 二十二、禁止通过的绕过方式 + +- 只给 Refresh 增加 claim，却不让 Filter 检查； +- 仍用同一签名密钥，只依赖字符串类型； +- 继续接受无 type 旧 Token； +- 把 Refresh Token 黑名单只放在 JVM 内存； +- 数据库存原始 JWT； +- 日志打印 Token 便于调试； +- 刷新后旧 Token仍有效； +- 并发刷新两次都成功； +- 登出只删前端 Token，不做服务端吊销； +- Access Token 不检查 session，导致登出后仍可用； +- 数据库异常时跳过 session 检查； +- 用 Mockito 模拟 Repository 代替全部并发和持久化证据； +- 修改测试期望值掩盖旧行为； +- 修改旧 Flyway； +- 为完成 S02 重构全仓身份解析或异常映射。 + +## 二十三、完成状态 + +编码和自动化全部通过后，将设计及路线图状态写为： + +```text +S02 已实现并完成自动化验证与干净构建，待独立代码复验及真实 MySQL/Docker 黑盒验收。 +``` + +不得写“已冻结”“已完成生产验收”或“S03 已开始”。 + +## 二十四、最终报告 + +必须包含： + +1. 修复前 Refresh Token 访问普通接口的复现； +2. Access/Refresh 的 claim 和密钥隔离； +3. 无 type 旧 Token 结果； +4. 登录响应兼容结果； +5. Token 摘要算法和数据库脱敏结果； +6. `auth_tokens` 迁移和实体变化； +7. 正常刷新与轮换结果； +8. 二次使用和重放处置； +9. 并发刷新结果； +10. 当前设备登出和多设备隔离； +11. 注销完成、用户禁用后的结果； +12. 单次 capturedNow 证据； +13. 日志、审计和完整 JSON 脱敏； +14. 数据库与外围副作用； +15. 新增接口和 OpenAPI 实际计数； +16. 专项、关联、全量测试数； +17. Failures、Errors、Skipped； +18. clean verify 结果； +19. 精确修改文件； +20. Git 状态； +21. 是否修改 V1–V41、ErrorCode 或其他业务接口； +22. 明确未执行 `git add -A`、commit、push； +23. 明确真实 MySQL/Docker 黑盒仍待独立验收。 + +任何失败或 SKIP 必须如实报告。完成后停止，不进入 S03。 diff --git a/docs/s02-independent-mysql-acceptance-20260914.md b/docs/s02-independent-mysql-acceptance-20260914.md new file mode 100644 index 0000000..a797ba2 --- /dev/null +++ b/docs/s02-independent-mysql-acceptance-20260914.md @@ -0,0 +1,202 @@ +# S02 独立代码复验与真实 MySQL/Docker 黑盒验收报告（脱敏版） + +- **验收日期**：2026-09-14 +- **分支**：`feat/s02-token-isolation` +- **验收对象**：S02「Access/Refresh Token 隔离、轮换与吊销」 +- **结论**：**PASS** —— *S02独立代码复验和真实MySQL/Docker黑盒全部通过，可以进入精确暂存检查点。* +- **本报告不含**：JWT 原文、Token 摘要全文、验证码、完整手机号、数据库口令、JWT 密钥、`.env` 内容、`Authorization` 请求头 + +--- + +## 1. Git 基线与工作区状态 + +| 项 | 实测 | +|---|---| +| 分支 | `feat/s02-token-isolation` | +| HEAD | `96a920b fix: harden resume upload safety` | +| 暂存区 | **空** | +| `git diff --check` | 无空白错误 | +| 工作区 | 63 个已修改 + 116 个未跟踪 | +| 唯一新增迁移 | `V42__auth_token_sessions.sql`（V1–V41 未修改） | +| 删除文件 | 0 | +| AGENTS.md | **未发现** | +| 静态 OpenAPI | 175 paths / 213 operations（`All checks passed!`） | + +## 2. 独立代码审查逐项结论 + +| 项 | 结论 | 关键证据 | +|---|---|---| +| A1 Token 类型隔离 | **PASS** | Access 用 `accessKey`、带 `type=access`；Refresh 用 `refreshKey`、带 `type=refresh`、无 `role`；摘要用独立 `tokenHashSecret`；三项密钥经 `requireDistinct` 强制互异；两类 Token 均不含 phone/email/nickname/resumeUrl | +| A2 JWT claims | **PASS** | `JwtTokenProvider.parse()` 统一校验 `type`/`iss`/`aud`/`exp`/`iat`，`requirePositiveSubject` 与 `requireCanonicalUuid` 校验 sub/sid/jti；时间契约 `iat <= capturedNow < exp`；异常统一 `InvalidTokenException`（固定文本，不含 Token/claim） | +| A3 服务端会话状态 | **PASS** | `JwtAuthenticationFilter` 验签后调用 `isSessionActive`：用户存在 + active + session 下存在未消费/未撤销/未过期记录；`session_id IS NULL` 永不命中；异常失败关闭；`createSession` 对 inactive 用户先抛异常（不先发 Token） | +| A4 刷新轮换事务 | **PASS** | `refresh()` 无 `@Transactional`（编排入口）；`executeRefreshAttempt` 在独立事务；消费与写后继同事务；条件更新含 id/version/revoked/consumedAt/expiredAt；`consumed != 1` 即判定重放；重放信息经 `RefreshAttempt.Replayed` 返回而非抛异常；重放撤销在尝试事务**之后**执行；无 JVM 锁、无 `Thread.sleep` | +| A5 并发重放 | **PASS** | `revokeReplayedSession` 用 REQUIRES_NEW，逐轮 `revokeSession` 后**校验活动 Token 数**，最多重试 3 次（无 sleep），仍失败则抛出（不静默）。日志中已无 `could not take locks` 分支 | +| A6 logout | **PASS** | 只撤销当前 session；幂等；其他设备不受影响；测试未使用 `catch (Throwable)`，未在最终断言前补 logout | +| A7 Token 摘要与脱敏 | **PASS** | HMAC-SHA256 + 独立密钥；64 位小写十六进制；`MessageDigest.isEqual` 常量时间比较；`hash(null)` 与 `hash("")` 同值但生产路径在校验后才调用 | +| A8 capturedNow | **PASS** | 登录/刷新/登出每个入口只读一次 Clock；`created_at`/`expired_at`/`consumed_at`/`revoked_at`/审计均来自该次捕获；固定时区 `Asia/Shanghai` | +| A9 用户禁用与注销 | **PASS** | `createSession` 拒绝 inactive；注销完成在同一业务事务内 `desensitize()`（active=false）+ `revokeAllUserSessions`；回退状态不恢复已撤销 Token；其他用户不受影响 | +| A10 配置安全 | **PASS**（代码层）| 三项密钥缺失/过短/相同/issuer 空/audience 空均启动失败，错误只含**密钥名**不含值；旧 `JWT_SECRET` 不再强制解析；`CandidateKeyGenerator` 在空密钥时**先抛异常**，不产生可预测 key | + +**观察项（非阻断）**：`AppJwtProperties` 的校验规则没有专门的单元测试（设计 §六 曾要求）。本轮改用阶段 O 的真实 JAR 启动矩阵实证，覆盖更强；仍建议后续补一个配置校验单测。 + +## 3. Docker / MySQL / Redis / RabbitMQ + +| 组件 | 版本 | 状态 | +|---|---|---| +| Docker Engine | 29.6.2（linux/amd64） | 可用 | +| `mydreamjob-mysql` | MySQL **8.4.11** | healthy（127.0.0.1:3307） | +| `mydreamjob-redis` | redis:7.4-alpine | healthy | +| `mydreamjob-rabbitmq` | rabbitmq:3.13-management-alpine | healthy | + +验收数据库名：`mydreamjob`。未重建容器、未删除 volume、未打印 `.env` 或口令。 + +## 4–6. Flyway / 表结构 / 启动 + +**Flyway**：接受验收前最新版本为 V41；启动最新 JAR 后 **V42 `auth token sessions` success=1**，失败迁移 0。 + +**`auth_tokens` 真实表结构**（新增 7 列 + 3 索引，旧索引保留）： + +``` +session_id VARCHAR(36) NULL token_jti VARCHAR(36) NULL +parent_token_id BIGINT NULL consumed_at / revoked_at DATETIME NULL +revocation_reason VARCHAR(40) version BIGINT NOT NULL DEFAULT 0 +UNIQUE uk_auth_tokens_token_jti (token_jti) +KEY idx_auth_tokens_session_active (session_id, revoked, consumed_at, expired_at) +KEY idx_auth_tokens_user_session (user_id, session_id) +KEY idx_auth_tokens_user / idx_auth_tokens_hash （既有，保留） +``` + +无任何保存 Token 原文的列。 + +**启动**：`Started MyDreamjobApplication`（16.3 s），无 Flyway 错误、无 schema validation 错误；`GET /api/v1/health` → **HTTP 200 / status=UP**；运行时 OpenAPI 175/213。 + +## 7. 自动化实际测试数 + +| 命令 | Tests run | Failures | Errors | Skipped | BUILD | +|---|---|---|---|---|---| +| 原独立失败测试（2 类） | **3** | 0 | 0 | 0 | SUCCESS | +| S02 专项（13 类） | **84** | 0 | 0 | 0 | SUCCESS | +| 认证关联回归 | **208** | 0 | 0 | 0 | SUCCESS | +| `mvn test` | **1758** | 0 | 0 | 0 | SUCCESS | +| `mvn clean verify` | **1758** | 0 | 0 | 0 | SUCCESS（2:21） | + +（候选基线称"扩展专项 87/87" = 专项 84 + 独立 3，与实测一致。） + +## 8–9. Token claims 与类型矩阵（真实 HTTP） + +**claims**：登录响应字段兼容、`expiresIn=86400`、三段 JWT、两 Token 原文不同、jti 不同、sid 相同、type 正确、iss/aud 正确、Access 有 role、Refresh 无 role、均不含个人信息、有效期 24h/7d、均含 iat —— **全部 PASS**。 + +**类型矩阵**（每格记录 method / path / HTTP status / business code / requestId）： + +| Token | `/auth/me` | `/auth/refresh` | +|---|---|---| +| Access | **200** | **401** | +| Refresh | **401** | **200**（并轮换） | +| 无 type 旧 Token | 401 | 401 | +| Access 用 Refresh 密钥伪造 | 401 | 401 | +| Refresh 用 Access 密钥伪造 | 401 | 401 | +| 过期 Token | 401 | 401 | +| 缺 iat | 401 | 401 | +| 未来 iat | 401 | 401 | +| 非法 sid | 401 | 401 | +| 非法 sub | 401 | 401 | + +错误响应均未泄漏 JWT 原文、`Bearer`、`token_hash`、sid、jti、手机号、密钥、异常类名或堆栈。 + +## 10–11. 正常轮换与串行重放 + +**轮换**：sid 不变、jti 变化、旧记录 `consumed_at` 非空、version 只 +1、新记录 `parent_token_id` 指向旧记录、同一时刻仅 1 个活动 Refresh、A2 可访问、R2 可再次刷新 —— 全部 PASS。 + +**串行重放**：R1 重放 → **401**；当前 session 活动 Refresh 数 **0**；A1 与 A2 访问 `/auth/me` 均 **401**；R2 刷新 **401**；其他设备 session **200**；写入一次重放安全审计。 + +## 12–13. 真实并发（10 轮）与胜出方 Access + +每轮两个独立 HTTP 客户端 + `threading.Barrier` 同时发起，**10/10 轮**全部满足： + +| 断言 | 实测 | +|---|---| +| 无 HTTP 500 | 10/10 | +| 最多一个刷新成功 | 10/10 | +| 失败方为 401 | 10/10 | +| 重放后活动 Refresh **严格为 0** | 10/10 | +| 原 Access 与**胜出方新 Access** 均失效 | 20 次断言全部满足 | +| 其他设备 session 始终 200 | 10/10 | +| 无锁异常 / 堆栈泄漏 | 10/10 | +| 日志无 `refresh reuse revocation could not take locks` | ✅ | +| 无同一 session 两个活动后继 | ✅ | + +## 14–16. 多设备 / 竞争 / inactive 与注销 + +- **logout**：第一次成功，Access 与 Refresh 随即 401；重复 logout 按既有幂等语义；其他设备不受影响。 +- **多设备隔离**：两设备 sessionId 不同；A 登出后 A 失效、B 的 Access 与 Refresh 均保持有效。 +- **logout 与 refresh 并发**：无 500；未补 logout 的情况下活动 Refresh 数为 0；竞争可能返回的新 Access 最终 401。 +- **inactive**：登录不返回 Token、不新增 `auth_tokens`；置为 inactive 后旧 Access/Refresh 均 401。 +- **注销完成**（走正式懒转换完成路径）：状态 COMPLETED、用户 `active=false`、全部会话撤销、两台设备 Access/Refresh 均 401、其他用户完全不受影响。 + +## 17. Clock 与真实数据库时间 + +| 断言 | 实测 | +|---|---| +| `created_at` 与 Access `iat` 同一时刻 | ±1s 内一致 | +| `expired_at` 与 Refresh `exp` 同一时刻 | ±1s 内一致 | +| `consumed_at` 与刷新时刻 | ±1s 内一致 | +| `revoked_at` 与登出时刻 | ±5s 内一致 | +| AUTH 审计 `created_at` 与请求时刻 | ±120s 内一致 | + +## 18–19. 明文扫描 / 审计与日志脱敏 + +- `token_hash` 为 64 位小写十六进制，不等于 Refresh 原文；库中搜索两类 Token 原文命中 **0**。 +- 应用日志与 stdout 扫描：Token / 验证码 / 密钥命中 **0**；扫描器经**注入探针**验证有效。 +- 审计动作仅限 4 个白名单值；details 不含 Token、摘要、`Bearer`、手机号、jti、`Authorization`、密钥；不含原始 sid（用不可逆 `sessionRef`）。 + +## 20–22. 副作用 / RabbitMQ / OpenAPI + +- **数据库副作用**：登录+刷新+串行重放前后，`candidate_dimension_scores`、`messages`、`notifications`、`applications`、`talent_invitations` 内容摘要**零变化**（按 id 摘要比对，非仅 COUNT）。 +- **RabbitMQ**：4 个项目队列全部存在，`ready=0`、`unacked=0`；S02 运行期间无新增消息。 +- **OpenAPI**：静态与运行时均 **175 / 213**；`/auth/refresh` 请求体仅 `refreshToken`；`/auth/logout` 无请求体；公共 schema 不含 tokenHash/sessionId/phone/secret 等内部字段。 + +## 23. PASS / FAIL / SKIP 清单 + +| 阶段 | PASS | FAIL | SKIP | +|---|---|---|---| +| A 代码审查（10 项） | 10 | 0 | 0 | +| B 自动化（5 组） | 5 | 0 | 0 | +| C–E 环境/迁移/启动 | 8 | 0 | 0 | +| F–M 黑盒（含 10 轮并发） | **117** | 0 | 0 | +| N–S 时间/脱敏/副作用/外围/OpenAPI | **30** | 0 | 0 | +| O 配置启动矩阵（9 配置） | **18** | 0 | 0 | +| **合计** | **165** | **0** | **0** | + +## 24. 剩余风险 + +1. **重放撤销重试可能重复写审计**：`revokeReplayedSession` 在需要重试时会再写一对 `AUTH_REFRESH_REUSE_DETECTED` / `AUTH_SESSION_REVOKED`。本轮所有场景（含 10 轮并发）**重试次数为 0**，未观测到重复；属潜在项，建议后续把审计移到循环外。 +2. **`AppJwtProperties` 无专门单元测试**（见第 2 节观察项）。 +3. **旧 `JWT_SECRET` 仍被 `talentdiscovery.CandidateKeyGenerator` 使用**：本轮已确认空密钥时**安全失败**（抛异常、不产生可预测 key），但该配置项仍存在；建议后续为其单独引入专用密钥。 +4. 本轮**未执行**：真实短信供应商、Redis 会话缓存、设备指纹、Access 有效期缩短等 S02 明确非目标项。 +5. 验收数据保留在库（见第 26 节）。 + +## 25. 是否允许冻结 S02 + +**允许。** 24 项验收判据全部满足，无 FAIL、无核心项 SKIP，24 条"不得冻结"清单全部未触发。 + +--- + +## 26. 验收结束处理 + +- 本轮启动的 JAR（PID 21420，命令行含 `s02-acc-main-app.log`）**已停止**；8080 恢复空闲；未停止任何未知 Java 进程；未停止 Docker。 +- **验收数据保留**，未执行删除。理由：`audit_logs` 有 **143** 条 `AUTH_*` 行引用本轮验收用户且该表**无外键**，删除用户会产生孤儿审计行；而本任务边界禁止删除 `audit_logs`。精确足迹如下（供后续人工处置）： + +| 范围 | 行数 | +|---|---| +| `users`（本轮 15:25 之后创建，199 前缀） | 35 | +| `auth_tokens`（这些用户） | 93 | +| `audit_logs` `AUTH_*`（这些用户） | 143 | +| `account_deletions`（这些用户） | 1 | + +> 注：库中另有 3 个 199 前缀用户属于 **S01 验收**（2026-09-14 09:48 与 2026-08-13），及其 2 条投递记录，**非本轮产生，未触碰**。 + +- 最终 Git：暂存区**空**、`git diff --check` 无错误、V1–V41 未修改、V42 为唯一新增迁移、未删除文件、**未** `git add -A` / commit / push、未进入 S03。 + +--- + +# S02 独立代码复验和真实MySQL/Docker黑盒全部通过，可以进入精确暂存检查点。 diff --git a/docs/s03-independent-mysql-acceptance-20260915.md b/docs/s03-independent-mysql-acceptance-20260915.md new file mode 100644 index 0000000..c7c46cc --- /dev/null +++ b/docs/s03-independent-mysql-acceptance-20260915.md @@ -0,0 +1,167 @@ +# S03「生产默认账号、简历隐私与 Actuator 隔离」独立代码复验及真实 MySQL/Docker 黑盒验收 + +日期：2026-09-15 +分支：`feat/s03-production-privacy` +结论：**FAIL —— 已复现具体缺陷（阶段 I-1：业务端口 Actuator 路径非 404），S03 不可冻结；报告包含下一轮定向整改指令。** + +## 1. Git 基线与工作区状态 + +- 当前分支 `feat/s03-production-privacy`；HEAD `f399060 feat: isolate and revoke authentication token sessions`。 +- 暂存区为空；全部 S03 修改处于未提交（M/??）状态。 +- `git diff --check` 通过；`git diff --name-only -- mydreamjob-server/src/main/resources/db/migration` 为空（V1–V42 无改动）。 +- 唯一新增迁移：`V43__disable_legacy_seed_accounts.sql`。 +- 未执行 `git add -A`/commit/push/reset/restore/checkout/clean；未删除历史文件。 + +## 2. 独立代码审查（阶段 A） + +| 项 | 结论 | 关键证据 | +|---|---|---| +| A1 V43 迁移安全 | PASS | 3 条 UPDATE（无 DELETE/DROP/TRUNCATE）；不按 id 匹配；每条同时匹配原始手机号+邮箱+公开 bcrypt 哈希+主角色+`is_active=1`；只置 `is_active=0`；不碰 `user_roles`；指纹被改的账号不命中；V1–V42 未修改 | +| A2 管理员初始化装配 | PASS | 默认关闭 + 字面量 `"true"` 双重校验；手机号无默认值、非法即启动失败；已有活动 ADMIN 无副作用跳过；不设密码（`password_hash=NULL`）/不发 Token/不发短信/无公网接口；日志与异常文本固定且不含手机号（`AdminBootstrapRunner.ERROR_INVALID_PHONE/ERROR_PHONE_IN_USE`） | +| A3 事务与并发 | PASS | `JdbcTemplate + REQUIRES_NEW` 独立事务，users 与 user_roles 同事务回滚；刻意绕过 Hibernate 避免 `SqlExceptionHelper` 记录绑定手机号；异常被捕获只返回 `CONFLICT`，原始 cause 不传播；冲突后仅 `isValidBootstrapAdmin` 全条件匹配才幂等 | +| A4 简历授权失败关闭 | PASS | `CompanyResumeAccessPolicy`：归属全部服务端推导；无记录/PRIVATE 按 PRIVATE；APPLIED_COMPANIES 严格白名单（SUB/VIEWED/INTERVIEW/HIRED，区分大小写，未知/空白/null/WITHDRAWN/REJECTED 全拒）；VERIFIED_COMPANIES 要求 `verified=true` 且岗位归属；授权失败发生在文件读取前 | +| A5 文件与响应安全 | PASS | 授权后读文件；`Content-Disposition attachment+UTF-8`、`Cache-Control: no-store`、Content-Type 白名单回退 octet-stream；响应不含 resumeUrl/storagePath/studentUserId | +| A6 Actuator 隔离（设计层面） | PASS* | 独立管理端口默认 127.0.0.1；仅暴露 health/info/metrics/prometheus；`show-details/components=never`；Prometheus 显式开启；不当 JWT 运维认证。*注：阶段 I-1 真实验收发现业务端口行为不达标，见第 12 节 | +| A7 副作用测试真实性 | PASS | `CompanyResumeDownloadIntegrationTest` 行级字段快照（如 users: id/phone/email/role/is_active/is_verified/updated_at），非 COUNT/SUM；含反证测试（单行 status 变化必须被发现）与 15 表字段覆盖断言 | + +## 3. 自动化独立复验（阶段 B） + +| 命令 | Tests | Failures | Errors | Skipped | 结果 | +|---|---:|---:|---:|---:|---| +| `mvn clean verify`（实测，非沿用历史） | 1834 | 0 | 0 | 0 | BUILD SUCCESS | +| `python docs\verify_openapi.py` | — | — | — | — | paths=176 operations=214，All checks passed | + +## 4. Docker/MySQL 环境（阶段 C） + +- Docker Engine 29.6.2；容器由负责人环境启动（本次仅 `docker start` 已存在容器，未重建、未删 volume）。 +- MySQL 8.4.11（127.0.0.1:3307，库 `mydreamjob`）；Redis PONG；RabbitMQ healthy。 +- Flyway V1–V42 全部 success=1。 + +## 5. V43 真实迁移验收（阶段 D） + +- 迁移前三个种子账号脱敏快照：role=ADMIN/STUDENT/COMPANY，均 `is_active=1`，指纹与 V1_1 原始值完全匹配，`user_roles` 各 1 条，关联业务数据 4(applications)/21(jobs)/2(profiles)/1(company)。 +- 最新 JAR + dev（`ddl-auto=validate`）启动后 `flyway_schema_history`：`V43 disable legacy seed accounts success=1`，无失败迁移，V1–V42 校验和未变。 +- 三个种子账号 `is_active` 1→0；users 行仍存在；`user_roles` 仍存在；关联业务数据未删除。 +- 指纹偏差隔离夹具（7976/7977，改过手机号与哈希）在 V43 后仍 `is_active=1`，未误伤。 +- 原种子账号（demo 口令）登录返回 400 且无法取得 Token（已禁用账号不能建立会话），达成"不能取得 Token"目标。 + +## 6. 管理员初始化配置矩阵（阶段 E，真实 MySQL） + +| 用例 | 结果 | 实测证据 | +|---|---|---| +| E1 默认关闭 | PASS | 应用正常启动且未创建任何 ADMIN | +| E2 enabled=true+非法手机号 | PASS | 启动失败，固定文案 `admin bootstrap rejected: configured phone is invalid` | +| E3 无活动ADMIN+空闲手机号 | PASS | users 恰 1 行（role=ADMIN、active、verified、`password_hash=NULL`）；`user_roles` 仅 ADMIN；无 Token/短信/通知；日志无手机号 | +| E4 重复启动同配置 | PASS | `skipped`；users 与 ADMIN 角色计数均不增 | +| E5 手机号被 STUDENT 占用 | PASS | 启动失败固定文案 `phone is already in use`；该 STUDENT 未被提权/复活/覆盖 | +| E6 真实双 JAR 并发同手机号 | PASS | 两个独立进程 + 屏障同时初始化：最终 users 恰 1 行、ADMIN 角色恰 1 条；一方创建、一方安全幂等跳过；无手机号泄漏；无 `SqlExceptionHelper` 唯一键日志 | + +前置与后置：临时禁用 20 个历史验收 ADMIN（id 逐一记录）并以精确 UPDATE 恢复原状；E3/E6 新建的验收 ADMIN 置为 inactive，未删除。 + +## 7. 启动最新 JAR 与双端口（阶段 F） + +- `Started MyDreamjobApplication`；无 Flyway/schema-validation 错误。 +- 8080 与 8081 均监听；**8081 仅绑定 127.0.0.1**。 +- `GET /api/v1/health` → 200/UP（仅最小状态，无 db/redis/rabbit/连接池字段）。 +- 运行时 OpenAPI：paths=176，operations=214，与静态一致。 + +## 8. 企业简历真实 HTTP 权限矩阵（阶段 G / H） + +夹具：3 家企业（认证/未认证/其他）、6 名学生（APPLIED_COMPANIES·SUBMITTED、PRIVATE、无隐私记录、VERIFIED_COMPANIES·未认证企业、APPLIED_COMPANIES·WITHDRAWN、VERIFIED_COMPANIES·已认证企业），真实简历文件进存储基目录，投递/隐私由服务端推导。 + +| 用例 | HTTP | 期望 | 结果 | +|---|---|---|---| +| 匿名 | 401 | 401 | PASS | +| STUDENT Token | 403/2002 | 403 | PASS | +| ADMIN Token | 403/2002 | 403 | PASS | +| 其他企业 | 403/2002 | 403 | PASS | +| 未认证企业（岗位不属于） | 403/2002 | 403 | PASS | +| 认证企业+APPLIED+SUBMITTED | 200 | 200 | PASS（下文字节/头断言） | +| PRIVATE 隐私 | 403/2002 | 403 | PASS | +| 无隐私记录（默认 PRIVATE） | 403/2002 | 403 | PASS | +| VERIFIED_COMPANIES+未认证企业 | 403/2002 | 403 | PASS | +| APPLIED_COMPANIES+WITHDRAWN | 403/2002 | 403 | PASS | +| VERIFIED_COMPANIES+已认证企业 | 200 | 200 | PASS（字节一致） | +| 投递不存在 | 404/8002 | 404 | PASS | + +成功下载断言：文件字节与夹具逐字节一致（`RESUME-FIXTURE-A/F-20260915`，字节级比较 PASS）；`Content-Disposition: attachment; filename="=?UTF-8?Q?...?="`（净化文件名）；`Cache-Control: no-store`；Content-Type 走白名单；响应不含存储路径/resumeUrl/studentUserId/手机号/邮箱。 +日志/审计扫描：未发现简历正文标记、本地路径、S03 测试手机号、密钥等禁止字段。 + +## 9. Actuator 双端口真实验收（阶段 I） + +**管理端口 127.0.0.1:8081 — 全部 PASS** +- `/actuator/health` 200，JSON 仅含 `status`（最小化，无 components/db/redis/rabbit/diskSpace/hikari）。 +- `/actuator/metrics` 200（含 names 数组）；`/actuator/prometheus` 200（Prometheus 文本、含 `jvm_memory_used_bytes` 等稳定指标）。 +- `/actuator/env`、`/beans`、`/configprops`、`/heapdump`、`/threaddump` 均不可读（401）。 +- 端口仅绑定 127.0.0.1；prometheus 文本未发现密码/Token/Bearer 等敏感值。 + +**业务端口 8080 — FAIL（本轮关键缺陷）** + +| 路径 | 匿名 | 带 STUDENT Token（有效） | +|---|---|---| +| `/actuator` | 401 | 500 | +| `/actuator/health` | 500 | 500 | +| `/actuator/metrics` | 500 | 500 | +| `/actuator/info` | 500 | 500 | +| `/actuator/prometheus` | 500 | 500 | +| `/actuator/env` | 401 | 500 | +| `/actuator/beans` | 401 | 500 | + +任务书要求这些路径**无论匿名或带 Token 一律 404**；实测为 401/500。根因：`SecurityConfig` 对 `/actuator/health/**` 等显式 `permitAll`，但业务端口并不注册 Actuator 端点，请求落入 MVC 静态资源解析抛 `NoResourceFoundException`，被 `GlobalExceptionHandler` 通用 handler 映射为 500；未放行的 `/actuator`、`/actuator/env`、`/actuator/beans` 在匿名时被安全层拦为 401，带 Token 后同样 500。 +同时，`ActuatorIsolationIntegrationTest.businessPortDoesNotExposeActuatorEndpoints` 断言这些路径为 404 且在 H2 测试环境下通过——**测试环境（H2、无独立管理端口随机化 etc.）与真实 MySQL + 完整 Security 配置的生产行为不一致，测试未能捕获 401/500 差异**，属测试真实性缺口。 + +## 10. 副作用（阶段 J） + +下载成功、下载拒绝、下载 404 三类请求前后，对 15 张表（users、user_roles、student_profiles、resume_versions、applications、jobs、companies、auth_tokens、audit_logs、candidate_dimension_scores、notifications、messages、scoring_risk_events、scoring_risk_actions、talent_invitations）作行级全量快照对比：**完全一致，无任何变化**。PASS。 + +## 11. RabbitMQ（阶段 K） + +4 个队列真实存在且 0 积压：`queue.sms.verification`、`queue.notification`、`queue.audit`、`queue.notification.dlq`（messages=0、ready=0、unacked=0）。管理员初始化与简历下载均未产生新增消息。PASS。 + +## 12. OpenAPI（阶段 L） + +静态 `verify_openapi.py`：176 paths / 214 operations，全部通过（含 S03 简历下载契约、S02/S03 校验）。运行时 `/api/v1/v3/api-docs`：176/214 与静态一致。新端点仅 `GET /company/candidates/{applicationId}/resume`，无 requestBody、返回文件流；企业 DTO 不含 resumeUrl/storagePath/studentUserId/phone/email。PASS。 + +## 13. PASS / FAIL / SKIP 清单 + +- PASS：阶段 A（A1–A7）；阶段 B（1834 测试、OpenAPI 静态）；阶段 C；阶段 D（V43 真实迁移与种子禁用、不误伤、登录不可用）；阶段 E（E1–E6）；阶段 F；阶段 G/H（12/12、字节与头断言、日志脱敏）；阶段 I-2 管理端口；阶段 J；阶段 K；阶段 L。 +- **FAIL：阶段 I-1（业务端口 Actuator 路径 401/500 而非 404）+ 关联测试真实性缺口（ActuatorIsolationIntegrationTest 与生产行为不一致）。** +- SKIP：无（核心项全部执行；仅"更大规模容量压测"不在本轮范围，不构成阻断）。 + +## 14. 剩余风险 + +- 业务端口对 `/actuator/health` 等返回 500：属于错误响应泄漏（对探测者暴露服务器异常迹象），且不满足契约的 404 语义；修复后需补"业务端口带 Token 亦为 404"的真实 HTTP 覆盖。 +- 登录接口对已禁用账号返回 400 而非 403/401（无法取得 Token 已满足；状态码语义差异建议与契约对齐）。 +- 管理端口依赖网络隔离运维边界，生产中需确认部署层网络策略确实限制 8081 仅内网可访问。 + +## 15. 是否允许冻结 S03 + +**不允许。** 建议整改指令（下一轮定向修复，不修改本报告已执行的验收环境）： + +1. 业务端口对未注册 Actuator 路径统一返回 404： + - 在 `GlobalExceptionHandler` 增加 `NoResourceFoundException` 的精确映射（404），避免落入通用 500；或 + - 移除 `SecurityConfig` 中业务端口对 `/actuator/**` 的 `permitAll` 并显式声明业务端口 Actuator 不可达（任选其一，保持管理端口行为不变）。 +2. 增加真实 MySQL 环境下的 HTTP 断言：业务端口 `/actuator`、`/actuator/health`、`/actuator/metrics`、`/actuator/prometheus`、`/actuator/env`、`/actuator/beans` 在匿名与有效 STUDENT/COMPANY/ADMIN Token 下均为 404；并说明测试环境中为何出现 H2 404 而真实 MySQL 401/500 的差异，消除测试假绿。 +3. 修复后在最新 JAR + 真实 MySQL 上重跑阶段 I（业务端口 404 矩阵 + 管理端口只读矩阵）与 1834 项全量回归。 + +本报告不包含数据库密码、JWT、验证码、完整手机号、邮箱、验证手机号或简历正文。验收脚本与日志保留在 `backend-infra/s03-*.ps1|.py|.log`，夹具数据按"本轮唯一前缀/精确主键"清理并记录；`audit_logs` 未做删除。 + +## 16. Actuator 404 增量复验结果（定向整改后） + +上一节记录了初次独立验收的唯一阻断：业务端口 8080 上 `/actuator/**` 匿名/带 Token 行为为 401/500 而非任务书要求的 404，且 H2 测试与生产行为不一致。针对该阻断完成定向整改后，使用最新 `mvn clean verify` JAR 与真实 MySQL 8.4.11 复验： + +1. **整改方式 —— SecurityConfig**：原对 `/actuator/health/**`、`/actuator/info`、`/actuator/metrics/**`、`/actuator/prometheus` 的四个 `permitAll` 收敛为单一 `.requestMatchers("/actuator/**").permitAll()`。目的**非暴露 Actuator**（Actuator 仍只注册在独立管理端口），而是让所有 `/actuator/**` 请求进入 MVC 的不存在资源处理，消除匿名请求先被认证层转 401 的分支；业务端口未新增任何 Actuator Controller 或端点映射。 +2. **整改方式 —— GlobalExceptionHandler**：新增 `@ExceptionHandler(NoResourceFoundException.class)`，固定返回 HTTP 404、`code=404`、`message=not found`、`requestId`；不回显异常 message、请求路径、本地路径或堆栈；日志仅固定文案 + 归一化 requestId；未新增 ErrorCode。 +3. **业务端口矩阵（真实 HTTP）**：14 条路径（`/actuator`、`/actuator/`、`/actuator/health`、`/actuator/health/liveness`、`/actuator/info`、`/actuator/metrics`、`/actuator/metrics/jvm.memory.used`、`/actuator/prometheus`、`/actuator/env`、`/actuator/beans`、`/actuator/configprops`、`/actuator/heapdump`、`/actuator/threaddump`、`/actuator/unknown`）× 6 种身份（匿名 / STUDENT / COMPANY / ADMIN / 非法 Token / Refresh Token）共 **84 个组合全部返回 404**，且响应递归扫描无任何异常类名、框架包名、路径、Token、手机号等泄漏。 +4. **管理端口 127.0.0.1:8081**：health（200，最小 JSON，仅 `status`）/ info（200）/ metrics（200，含 names）/ prometheus（200，含稳定 JVM 指标）白名单端点正常；env / beans / configprops / heapdump / threaddump / unknown 全部 404（未暴露端点未被修复带成 200）；8081 仅绑定 127.0.0.1。 +5. **副作用**：复验期间日志无 `NoResourceFoundException` 堆栈、无 ERROR；RabbitMQ 4 个队列（sms.verification / notification / audit / notification.dlq）0 积压；数据库无任何改动。 +6. **自动化**：定向（Actuator/Security/GlobalExceptionHandler）61/61；全量 `mvn clean verify` **1836/1836**（含新增 2 个 Actuator 复验测试），Failures=0、Errors=0、Skipped=0；OpenAPI 静态与运行时均为 **176 paths / 214 operations**，Actuator 不进入业务 OpenAPI。 +7. **一致性**：V1–V42 未修改，V43 仍为唯一新增迁移；未新增 ErrorCode、公网业务接口、表或索引；应用进程已停止，当前未提交、未推送。 + +## 17. 最终结论 + +- 初次独立验收发现业务端口 Actuator 401/500 阻断； +- 完成定向整改（SecurityConfig 统一 `/actuator/**` 语义 + GlobalExceptionHandler 安全 404 映射 + 失败测试补齐）； +- 最新 JAR + 真实 MySQL/Docker 增量复验全部通过。 + +**S03 独立代码复验和真实 MySQL/Docker 黑盒全部通过，可以进入精确暂存检查点。** \ No newline at end of file diff --git a/docs/s03-production-security-and-resume-privacy-design.md b/docs/s03-production-security-and-resume-privacy-design.md new file mode 100644 index 0000000..a9cfed1 --- /dev/null +++ b/docs/s03-production-security-and-resume-privacy-design.md @@ -0,0 +1,167 @@ +# S03 生产配置、简历隐私与 Actuator 隔离设计 + +状态：设计已确认，待按独立检查点实施。 + +## 1. 目标与边界 + +S03 只处理三类高风险问题： + +1. 禁用仍保持原始状态的通用 Flyway 演示账号，并提供显式、一次性的管理员初始化能力； +2. 让 `resumeVisibility` 在企业读取简历文件的正式边界真正生效； +3. 将 Actuator 健康探针与指标端点隔离，防止普通业务用户读取运行指标。 + +S03 不修改 Access/Refresh Token 语义，不修改评分、排名、推荐、人才发现、邀约、Offer、申诉、消息撤回、简历上传与学生本人下载语义，不做性能重构，不进入 Q01/R01。 + +## 2. 已核实的现状 + +- `V1_1__seed_data.sql` 无环境隔离地插入已知 ADMIN、STUDENT、COMPANY 账号及公开口令哈希。 +- V1–V42 已经执行，不允许修改校验和；S03 使用新的 V43 迁移。 +- `student_privacy_settings.resume_visibility` 已支持 `PRIVATE`、`APPLIED_COMPANIES`、`VERIFIED_COMPANIES`，默认 `PRIVATE`。 +- `PrivacySettingsService.canCompanyViewResume(...)` 没有生产调用方。 +- 该方法的 `APPLIED_COMPANIES` 分支没有核对投递岗位归属 `companyId`，不能直接作为授权边界使用。 +- 企业候选人 DTO 当前主动排除了 `resumeUrl`；当前没有企业下载简历文件的正式接口。 +- `/actuator/health/**` 和 `/actuator/info` 公开；`metrics/prometheus` 被暴露后会落入普通 `authenticated()`，任何登录用户均可能访问。 + +## 3. S03-A 历史种子账号治理 + +### 3.1 V43 迁移原则 + +新增且仅新增： + +`V43__disable_legacy_seed_accounts.sql` + +V43 只能禁用仍与 V1_1 原始指纹完全一致的三条种子账号。匹配至少同时包含： + +- 原始手机号； +- 原始邮箱； +- 原始公开 bcrypt 哈希； +- 原始主角色； +- `is_active=1`。 + +不得依赖固定 `id=1/2/3`。不得删除用户、角色、审计或业务数据，不得重置自增。不得修改已被运营人员改过手机号、邮箱、哈希或角色的账号。 + +命中后仅将 `users.is_active` 置为 `0`。保留记录与关联关系，用于历史数据完整性和审计追溯。由于认证签发链已拒绝 inactive 用户，已知账号不能再取得会话。 + +迁移必须幂等，并分别覆盖 ADMIN、STUDENT、COMPANY 三条原始种子。迁移报告只记录命中数量，不输出完整手机号、邮箱或哈希。 + +### 3.2 管理员一次性初始化 + +新增显式开关，默认关闭： + +- `app.bootstrap.admin.enabled=${ADMIN_BOOTSTRAP_ENABLED:false}` +- `app.bootstrap.admin.phone=${ADMIN_BOOTSTRAP_PHONE:}` +- `app.bootstrap.admin.nickname=${ADMIN_BOOTSTRAP_NICKNAME:平台管理员}` + +初始化器仅在开关严格为 `true` 时装配。普通启动不得隐式创建管理员。 + +初始化规则： + +1. 手机号必须通过现有手机号格式校验；不得写日志、异常详情或审计 details。 +2. 数据库已有活动 ADMIN 时安全跳过，不创建第二个管理员。 +3. 数据库没有活动 ADMIN 且手机号不存在时，创建 `active=true`、`verified=true` 的 ADMIN，并同时写入 `users.role` 与 `user_roles`。 +4. 手机号已属于 STUDENT/COMPANY、inactive 用户或角色信息不一致时启动失败，禁止自动提权或复活。 +5. 相同配置重复启动必须幂等。 +6. 初始化成功后应提示固定文本，部署方必须移除开关；日志不得包含手机号。 +7. 多实例部署时只允许一个实例带初始化开关启动；数据库唯一手机号约束作为最后防线，冲突必须失败而不是吞掉。 + +不新增公网初始化接口，不接受请求参数创建 ADMIN，不设置默认密码。管理员仍使用正式短信认证流程；真实短信供应商未配置时不能以 Mock 绕过。 + +## 4. S03-B 简历隐私授权 + +### 4.1 唯一新增企业接口 + +新增： + +`GET /company/candidates/{applicationId}/resume` + +该接口返回文件流，不返回 `resumeUrl`、存储相对路径、绝对路径、学生用户 ID、手机号或邮箱。文件名必须继续经过 `ResumeFilenameSanitizer`。 + +除该接口外不新增按 `studentUserId`、`candidateKey` 或任意 URL 下载简历的入口。人才发现接口本轮不得直接下载简历。 + +### 4.2 授权顺序 + +必须在读取文件前依次完成： + +1. 从 `SecurityContext` 取得当前用户，要求 COMPANY； +2. 定位当前用户拥有的 Company； +3. 查询 `applicationId` 及对应 Job； +4. 校验 Job 属于当前 Company； +5. 取得投递对应的 `studentUserId`； +6. 按隐私设置判定可见性； +7. 通过后才读取 `student_profiles.resume_url` 和文件内容。 + +跨企业投递统一返回既有 403 语义，不通过差异响应泄露归属。隐私拒绝使用 `FORBIDDEN(2002)`。不存在的投递保持既有 `APPLICATION_NOT_FOUND`；授权通过但学生没有简历时使用既有 `PROFILE_NOT_FOUND`，不新增 ErrorCode。 + +### 4.3 可见性决策表 + +| 设置 | 企业条件 | 投递条件 | 结果 | +|---|---|---|---| +| 无设置记录/null | 任意 | 任意 | 403，按 PRIVATE 处理 | +| PRIVATE | 任意 | 包括已投递、面试、录用 | 403 | +| APPLIED_COMPANIES | 岗位属于当前企业 | SUBMITTED/VIEWED/INTERVIEW/HIRED | 200 | +| APPLIED_COMPANIES | 岗位属于当前企业 | WITHDRAWN/REJECTED | 403 | +| APPLIED_COMPANIES | 其他企业 | 任意 | 403 | +| VERIFIED_COMPANIES | 当前企业 `verified=true` 且拥有该投递岗位 | 任意合法投递状态 | 200 | +| VERIFIED_COMPANIES | 未认证企业或其他企业 | 任意 | 403 | + +`VERIFIED_COMPANIES` 不是“知道学生 ID 即可查看”。它仍要求合法的候选业务上下文，本轮该上下文限定为当前企业拥有的 `applicationId`。 + +### 4.4 代码结构 + +将现有布尔方法收束为失败关闭的授权组件，例如 `CompanyResumeAccessPolicy`。授权组件必须校验 company ownership，不能依赖 Controller 先验，也不能把客户端传入的 `studentUserId/companyId` 当成可信事实。 + +文件读取放在独立 Service 方法中。Controller 只解析身份、路径参数、构建安全响应头。任何拒绝路径都不得调用 `ResumeStorageService.read()`。 + +企业候选人列表与详情 DTO 保持不含 `resumeUrl`。学生本人上传、下载、版本、导出接口完全不变。 + +## 5. S03-C Actuator 隔离 + +### 5.1 运行边界 + +推荐配置： + +- `management.server.port=${MANAGEMENT_SERVER_PORT:8081}` +- `management.server.address=${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}` +- 仅暴露 `health,info,metrics,prometheus`； +- `health.show-details=never`； +- `health.show-components=never`。 + +生产默认只绑定回环地址。需要采集 Prometheus 时，由部署层通过受控网络或反向代理访问管理端口，不通过公网业务端口开放。 + +### 5.2 业务端口行为 + +业务端口不得提供 `/actuator/metrics` 或 `/actuator/prometheus`。普通 STUDENT、COMPANY、ADMIN 的业务 JWT 不能把管理指标变成公网资源。健康检查继续提供最小 `UP/DOWN` 信息，不返回数据库、Redis、RabbitMQ、磁盘路径或连接池细节。 + +本轮不新增运维账号体系，不把 ADMIN 等同于基础设施运维身份。 + +## 6. 数据与副作用 + +允许的数据库变化仅为： + +- V43 对完全匹配的旧种子账号执行 `is_active: 1 -> 0`； +- 显式管理员初始化首次创建一条 ADMIN 用户和对应角色； +- 企业成功下载简历如需审计，只允许白名单动作与 `applicationId/companyId`，不得记录路径、文件名、学生 ID、联系方式或简历内容。 + +简历访问不得修改 `student_profiles`、`resume_versions`、投递、评分、排名、推荐、邀约、消息、通知或风险表，不发送 RabbitMQ、短信或邮件。 + +## 7. 契约与兼容性 + +- S02 基线为 175 paths / 213 operations。 +- 新增一个企业简历下载接口后，预期为 176 paths / 214 operations；最终以运行时 OpenAPI 导出为准。 +- 不修改既有响应字段，不把 `resumeUrl` 加回任何企业 DTO。 +- 不新增 ErrorCode。 +- V43 是唯一新增迁移，V1–V42 不得修改。 + +## 8. 验收门槛 + +必须同时通过： + +- V43 在 H2 快速层和真实 MySQL 8 执行成功； +- 仅完全匹配的三条原始种子账号被禁用，改过任一指纹的账号不受影响； +- 管理员初始化关闭、成功、重复、已有 ADMIN、手机号冲突、并发冲突场景； +- 三种简历可见性及所有投递状态、跨企业、未认证企业、ADMIN/STUDENT/匿名权限矩阵； +- 拒绝路径零文件读取，企业 JSON/响应头无路径及个人信息泄漏； +- Actuator 业务端口与管理端口真实启动验证； +- 全量测试和 `mvn clean verify` 零失败、零错误、零跳过； +- 静态与运行时 OpenAPI 一致； +- 真实 MySQL/Docker 黑盒通过后才能冻结。 diff --git a/docs/s03-production-security-and-resume-privacy-implementation-instruction.md b/docs/s03-production-security-and-resume-privacy-implementation-instruction.md new file mode 100644 index 0000000..5cc1430 --- /dev/null +++ b/docs/s03-production-security-and-resume-privacy-implementation-instruction.md @@ -0,0 +1,270 @@ +# S03 生产配置、简历隐私与 Actuator 隔离实施指令 + +项目根目录：`C:\Users\15642\Desktop\zhilai` + +候选基线：S02 已完成独立代码复验、真实 MySQL/Docker 黑盒、精确提交并推送；功能分支提交为 `f399060edb2ff778322a4f021c93213f39a6f6bf`。 + +本轮必须先完整阅读 `docs/s03-production-security-and-resume-privacy-design.md`。该文档是 S03 权威口径；发生冲突时停止并报告，不得自行扩大语义。 + +## 一、开始前核查 + +执行： + +```powershell +cd C:\Users\15642\Desktop\zhilai +git branch --show-current +git status --short +git diff --cached --name-only +git log -5 --oneline +git diff --check +``` + +要求： + +- 从 S02 已提交基线创建独立分支 `feat/s03-production-privacy`； +- 切分支前确认暂存区和已跟踪工作区为空； +- 保留全部历史未跟踪脚本、日志、JSON、SQL、xlsx、`.env` 和验收目录； +- 不执行 `git reset/restore/checkout -- /clean`；创建新分支仅允许 `git switch -c feat/s03-production-privacy`； +- 不执行 `git add -A`、commit、push； +- 实施阶段不操作 Docker，不执行真实 MySQL 黑盒； +- 搜索并完整阅读适用的 `AGENTS.md`，不存在则记录。 + +如已有修改与 S03 目标文件重叠，停止并报告。 + +## 二、必须完整阅读 + +迁移与模型： + +- `V1__base_schema.sql` +- `V1_1__seed_data.sql` +- `V2__business_schema.sql` +- `V27__student_privacy_settings.sql` +- `V42__auth_token_sessions.sql` +- `User`、`UserRepository`、`Company`、`CompanyRepository` +- `Application`、`ApplicationRepository`、`Job`、`StudentProfile` + +隐私与简历： + +- `PrivacySettingsService`、`StudentPrivacySettings`、`ResumeVisibility` +- `ApplicationController`、`ApplicationService`、`CandidateDetailView` +- `ProfileController`、`ProfileService` +- `ResumeStorageService`、`LocalResumeStorageService` +- `ResumeFilenameSanitizer`、`ResumeFileValidator` +- 全部 `profile`、`resume`、`privacy`、`application` 测试 + +认证与运维： + +- `SecurityConfig`、`CurrentUserAccessor` +- `AuthService`、`AuthSessionService`、`JwtAuthenticationFilter` +- `application.yml` 及所有 profile 配置 +- `ErrorCode`、`GlobalExceptionHandler` +- `pom.xml` 与 Actuator 测试 + +文档： + +- S03 权威设计文档 +- `privacy-settings-api.md` +- `resume-api.md` +- `frontend-integration.md` +- `backend-development-roadmap.md` +- `phase1-scope-and-acceptance.md` +- `openapi-rc.json` +- `verify_openapi.py` + +先执行搜索并记录所有企业侧简历暴露点： + +```powershell +rg -n -i "resumeUrl|resume_url|download.*resume|resume.*download|ResumeStorageService\.read|canCompanyViewResume|studentUserId" mydreamjob-server/src/main/java +``` + +## 三、S03-A：禁用历史种子账号 + +新增且仅新增 `V43__disable_legacy_seed_accounts.sql`。 + +要求： + +1. 不修改 V1–V42。 +2. 不按固定 ID 匹配。 +3. 每条 UPDATE 必须同时匹配 V1_1 中的原手机号、原邮箱、原 bcrypt 哈希、原角色、`is_active=1`。 +4. ADMIN、STUDENT、COMPANY 三条分别处理。 +5. 仅更新 `is_active=0`，不删除 users/user_roles，不修改历史业务表。 +6. 改过手机号、邮箱、哈希或角色的同源账号不得被禁用。 +7. 重复执行效果稳定。 + +新增迁移集成测试，至少覆盖：完整指纹命中、每个单字段偏差不命中、非固定 ID 也能命中、重复执行、关联数据保留、V1–V42 校验和不变。 + +## 四、S03-A：一次性管理员初始化 + +新增强类型配置和条件装配，例如： + +- `AdminBootstrapProperties` +- `AdminBootstrapRunner` +- 必要的内部 Service + +严格按设计文档执行：默认关闭；只有严格 `true` 才装配；手机号来自环境变量；无默认手机号；不打印手机号；不提供公网接口。 + +核心行为： + +- 已有活动 ADMIN：无副作用跳过； +- 无活动 ADMIN + 手机号不存在：创建活动且已验证 ADMIN，`users.role` 与 `user_roles` 一致； +- 手机号已属于任何用户或角色状态异常：启动失败，禁止提权、复活或覆盖； +- 重复启动幂等； +- 多实例冲突安全失败； +- 不签发 Token、不发送短信、不写默认密码。 + +错误信息必须固定且不包含手机号、用户对象、SQL 或环境变量值。日志只能使用固定事件文本。 + +必须先写失败测试，覆盖：disabled、missing phone、invalid phone、existing active admin、new admin、duplicate run、existing student/company/inactive user、users/user_roles 一致性、日志脱敏、并发冲突。 + +## 五、S03-B：企业简历下载与隐私 + +新增唯一公网接口： + +`GET /company/candidates/{applicationId}/resume` + +推荐新增： + +- `CompanyResumeAccessPolicy` +- `CompanyResumeService` +- 必要的文件响应 record/DTO + +不得将文件访问逻辑塞入现有候选人 DTO，不得返回 `resumeUrl`。 + +授权必须在 Service/Policy 中完成，不可信任 Controller 传入的归属信息。按以下顺序：当前 COMPANY 用户 → 当前 Company → Application+Job → Job.companyId → Student → privacy setting → profile/file。 + +必须修复现有 `canCompanyViewResume` 的公司归属缺失：`APPLIED_COMPANIES` 不能只校验学生和状态；必须证明 application 对应 Job 属于当前 company。允许替换该方法或让它委托给新 Policy，但不得保留一个可被误用的宽松生产方法。 + +语义严格使用设计文档决策表： + +- 默认/null 与 PRIVATE：全部企业 403； +- APPLIED_COMPANIES：仅本企业有效投递，WITHDRAWN/REJECTED 拒绝； +- VERIFIED_COMPANIES：企业 verified=true 且拥有 application 的岗位，状态不额外限制； +- 跨企业、未认证、错误角色均拒绝； +- 人才发现本轮不能借 candidateKey 下载简历。 + +响应要求： + +- 使用安全 `Content-Disposition`； +- content type 只能来自已验证的白名单； +- 不返回内部路径、studentUserId、手机号、邮箱； +- 拒绝路径不得调用 storage `read`； +- 文件不存在安全失败，不回显路径； +- 不缓存私有文件，至少返回 `Cache-Control: no-store`； +- 不把简历正文写入日志、审计或异常。 + +权限测试必须使用真实 SecurityFilterChain/MockMvc，并覆盖 COMPANY、其他企业、未认证企业、STUDENT、ADMIN、匿名。集成测试必须使用真实 H2 Repository 和真实本地临时存储，不得 Mock 掉被验证的授权链。 + +对所有状态 `SUBMITTED/VIEWED/INTERVIEW/HIRED/REJECTED/WITHDRAWN` 分别验证三种 visibility。验证企业候选人列表/详情仍不含 `resumeUrl`。 + +## 六、S03-C：Actuator 隔离 + +按设计新增： + +```yaml +management: + server: + port: ${MANAGEMENT_SERVER_PORT:8081} + address: ${MANAGEMENT_SERVER_ADDRESS:127.0.0.1} +``` + +并将 health details/components 设为 `never`。不要使用业务 JWT 角色代替运维网络隔离，不新增运维公网接口。 + +必须验证： + +- 业务端口无法访问 metrics/prometheus； +- 管理端口只绑定配置地址； +- health 仅返回最小状态，不含 DB/Redis/RabbitMQ/磁盘/连接池详情； +- metrics/prometheus 只在管理端口存在； +- STUDENT/COMPANY/ADMIN Token 不会使业务端口指标可见； +- dev/test/integration-test 不发生随机端口冲突。 + +若 Spring Boot 独立 management context 与当前 SecurityFilterChain 行为不一致，先新增真实上下文失败测试，再做最小配置；不得通过重新公开指标绕过。 + +## 七、数据与副作用测试 + +前后保存完整摘要，至少覆盖： + +- users、user_roles； +- student_profiles、resume_versions； +- applications、jobs、companies； +- auth_tokens、audit_logs； +- candidate_dimension_scores； +- notifications、messages； +- scoring_risk_events/actions； +- talent_invitations。 + +企业下载只允许读取；不得修改上述业务表，不发送 RabbitMQ、短信、邮件或通知。若记录下载审计，字段必须为固定白名单且不得包含路径、文件名、学生 ID 或内容。 + +## 八、OpenAPI 与文档 + +从运行时契约更新 `docs/openapi-rc.json`，不得手工伪造。 + +更新： + +- `privacy-settings-api.md` +- `resume-api.md` +- `frontend-integration.md` +- `backend-development-roadmap.md` +- `phase1-scope-and-acceptance.md` +- `verify_openapi.py` + +校验器必须递归断言： + +- 只有一个新增路径/operation； +- 下载接口无 requestBody； +- 企业候选人 DTO 不含 `resumeUrl/studentUserId/phone/email/storagePath`； +- 不存在按 studentUserId/candidateKey 的简历下载路径； +- Actuator 不进入业务 OpenAPI； +- 预期基线为 176 paths / 214 operations，最终以运行时生成结果为准。 + +## 九、验证顺序 + +先运行 S03 新增定向测试，再运行： + +```powershell +cd C:\Users\15642\Desktop\zhilai\mydreamjob-server +mvn -Dtest="*AdminBootstrap*Test,*LegacySeed*Test,*Privacy*Test,*Resume*Test,*CompanyCandidate*Test,*Actuator*Test" test +mvn -Dtest="*Auth*Test,*Security*Test,*Application*Test,*Company*Test,*Privacy*Test,*Resume*Test" test +mvn test +mvn clean verify +python ..\docs\verify_openapi.py +``` + +最后执行： + +```powershell +cd C:\Users\15642\Desktop\zhilai +git diff --check +git status --short +git diff --cached --name-only +git diff --name-only -- mydreamjob-server/src/main/resources/db/migration +``` + +必须满足 Failures=0、Errors=0、Skipped=0、clean verify 成功、静态 OpenAPI 校验通过、暂存区为空、V43 为唯一迁移、未新增 ErrorCode。 + +## 十、实施结束状态 + +实施结束立即停止，不操作 Docker，不执行真实 MySQL 黑盒，不暂存、不提交、不推送，不进入 Q01。 + +最终报告必须列出： + +1. V43 精确匹配条件和各账号命中结果； +2. 被修改过的种子账号不受影响证据； +3. 管理员初始化配置、幂等、冲突与并发结果； +4. 是否打印手机号或创建默认密码； +5. 企业简历权限完整决策矩阵； +6. `APPLIED_COMPANIES` 公司归属缺陷修复方式； +7. 拒绝路径文件读取次数； +8. 完整响应与响应头脱敏结果； +9. Actuator 业务端口/管理端口结果； +10. 数据库副作用与 RabbitMQ 结果； +11. 专项、关联、全量测试数及 Failures/Errors/Skipped； +12. clean verify 与 OpenAPI 结果； +13. 精确修改文件和 Git 状态； +14. 是否新增 Flyway、表、索引、ErrorCode、路径； +15. 明确未执行 git add -A、commit、push、Docker/MySQL 黑盒； +16. 明确真实 MySQL/Docker 黑盒仍待独立验收。 + +最终状态只能写： + +“S03 已实现并完成自动化验证与干净构建，待独立代码复验及真实 MySQL/Docker 黑盒验收。” diff --git a/docs/smoke-test.sh b/docs/smoke-test.sh index b363088..7022457 100644 --- a/docs/smoke-test.sh +++ b/docs/smoke-test.sh @@ -1,20 +1,56 @@ #!/usr/bin/env bash + +# ── xtrace 防护（S01 第三轮 F4）─────────────────────────────── +# 必须在读取任何环境变量、组装任何请求之前关闭 xtrace。 +# 脚本是独立可执行程序，安全优先：全程不重新 set -x， +# 避免验证码 / 完整手机号 / LOGIN_BODY / 登录响应 / TOKEN / AUTH 进入 stderr。 +case "$-" in + *x*) set +x ;; +esac + set -u # MyDreamJob backend RC smoke test. -# Required tools: curl, grep, sed, head, tail. +# Required tools: curl, grep, sed, head, tail, docker（仅取测试验证码时）。 # Environment: -# BASE_URL API base URL (default: http://127.0.0.1:8080/api/v1) -# STUDENT_PHONE Fresh 11-digit phone; generated when omitted -# COMPANY_TOKEN Company JWT; company status step is SKIP when omitted -# SERVER_LOG Server log path used to read Mock SMS codes +# BASE_URL API base URL (default: http://127.0.0.1:8080/api/v1) +# STUDENT_PHONE Fresh 11-digit phone; generated when omitted +# COMPANY_TOKEN Company JWT; company status step is SKIP when omitted +# SMS_MOCK_ENABLED=true **必需**：声明被测应用以 app.sms.mock.enabled=true 运行 +# ALLOW_TEST_OTP_DB_READ=true **必需**：显式授权本次本地测试从数据库读取验证码 +# +# 安全说明（S01 定向整改 F1 / 第三轮 F4+F5）: +# * 应用日志**不再**输出验证码，本脚本也**不得**从日志/控制台/stdout 读取验证码。 +# * 仅在 [SMS_MOCK_ENABLED=true] **且** [ALLOW_TEST_OTP_DB_READ=true] 时， +# 才通过容器内部只读 SQL 取得验证码；任一条件不满足立即安全失败。 +# * 验证码只保存在 shell 局部变量 / REPLY 约定中，不写日志、不写文件、不输出到终端。 +# * **xtrace 永远关闭**：即使以 `bash -x` 调用，脚本开头即 set +x 且全程不恢复。 +# * 数据库凭据通过容器进程环境 MYSQL_PWD 传递，**不进入 mysql 命令行参数**； +# 使用应用账号 MYSQL_USER（不使用 root，缺失即安全失败）。 +# * 不接入真实短信供应商；生产环境禁止使用该取码方式。 BASE_URL="${BASE_URL:-http://127.0.0.1:8080/api/v1}" -SERVER_LOG="${SERVER_LOG:-}" PASS=0 FAIL=0 SKIP=0 +# ── 凭据变量登记（退出时统一清理）───────────────────────────── +# 覆盖全部敏感变量：手机号、验证码、登录请求体、登录响应、JWT、Authorization 头。 +# 注意：不得在此处给 PHONE / STUDENT_PHONE / COMPANY_TOKEN 赋空值， +# 它们携带调用方传入值或由后续逻辑生成。 +SMS="" +OTP="" +REPLY="" +LOGIN_BODY="" +LOGIN="" +TOKEN="" +AUTH="" +cleanup_secrets() { + unset PHONE SMS OTP REPLY LOGIN_BODY LOGIN TOKEN AUTH 2>/dev/null || true + unset STUDENT_PHONE COMPANY_TOKEN 2>/dev/null || true +} +trap cleanup_secrets EXIT + if [ -n "${STUDENT_PHONE:-}" ]; then PHONE="$STUDENT_PHONE" else @@ -27,20 +63,113 @@ ok() { echo "[PASS] $1"; PASS=$((PASS + 1)); } fail() { echo "[FAIL] $1"; FAIL=$((FAIL + 1)); } skip() { echo "[SKIP] $1"; SKIP=$((SKIP + 1)); } -resolve_log() { - case "$SERVER_LOG" in - [A-Za-z]:/*) - local drive rest - drive="$(printf '%s' "${SERVER_LOG:0:1}" | tr '[:upper:]' '[:lower:]')" - rest="${SERVER_LOG:2}" - if [ -d /mnt/c ]; then - echo "/mnt/$drive$rest" - else - echo "/$drive$rest" - fi - ;; - *) echo "$SERVER_LOG" ;; +# 手机号脱敏（控制台输出不展示完整号码） +mask_phone() { + local p="${1:-}" + if [ "${#p}" -lt 7 ]; then + printf '%s' '***' + return + fi + printf '%s****%s' "${p:0:3}" "${p: -4}" +} + +# ── 布尔解析（大小写/空白不敏感，仅 true 为真）──────────────── +is_true() { + local v + v="$(printf '%s' "${1:-}" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')" + [ "$v" = "true" ] +} + +# ── 取码双重保护 ───────────────────────────────────────────── +# 保护 1：被测应用必须显式处于 mock 短信模式 +require_mock_sms_mode() { + is_true "${SMS_MOCK_ENABLED:-}" +} + +# 保护 2：本次执行必须显式授权读取验证码表 +require_test_otp_db_read_permission() { + is_true "${ALLOW_TEST_OTP_DB_READ:-}" +} + +# 从项目实际 compose 文件解析 mysql 容器名（不硬编码、不假设） +# 使用 BASH_SOURCE 以便脚本被 `source` 时仍能正确定位自身目录 +compose_mysql_container() { + local self base compose + self="${BASH_SOURCE[0]:-$0}" + base="$(cd "$(dirname "$self")" && pwd)" + for compose in "$base/../backend-infra/compose.yaml" "$base/../backend-infra/docker-compose.yml"; do + [ -f "$compose" ] || continue + awk ' + /^[[:space:]]+mysql:[[:space:]]*$/ { in_mysql=1; next } + /^[[:space:]]+[A-Za-z0-9_-]+:[[:space:]]*$/ { in_mysql=0 } + in_mysql && /^[[:space:]]+container_name:[[:space:]]*/ { + sub(/^[[:space:]]*container_name:[[:space:]]*/, ""); print; exit + } + ' "$compose" + done +} + +# 容器内只读查询（F5：凭据经进程环境 MYSQL_PWD 传递，不进入 mysql argv；SQL 经 stdin） +# - 使用应用账号 MYSQL_USER（不使用 root；缺失即安全失败，不回退 root） +# - 仅允许 SELECT；查询失败返回非 0，由 sms_code() 输出固定安全错误 +otp_db_query() { + local phone="$1" purpose="$2" container + container="$(compose_mysql_container | head -n 1)" + [ -n "$container" ] || return 1 + + printf '%s\n' "SELECT code FROM sms_verification_codes" \ + " WHERE phone = '$phone' AND purpose = '$purpose' AND used = 0" \ + " AND expired_at > NOW()" \ + " ORDER BY created_at DESC, id DESC LIMIT 1;" \ + | docker exec -i "$container" sh -c ' + # 应用账号凭据必需，缺失则安全失败（绝不回退 root） + if [ -z "${MYSQL_USER:-}" ] || [ -z "${MYSQL_PASSWORD:-}" ]; then + echo "db credentials unavailable" >&2 + exit 3 + fi + # 密码只经环境变量 MYSQL_PWD 传递，argv 中不出现 -p/--password + MYSQL_PWD="$MYSQL_PASSWORD" exec mysql \ + -u"$MYSQL_USER" \ + -N -B \ + "${MYSQL_DATABASE:-mydreamjob}"' 2>/dev/null \ + | head -n 1 +} + +# 取得验证码：成功时写入 REPLY；绝不打印到 stdout/stderr +sms_code() { + local disabled_msg="test OTP retrieval is disabled" + + if ! require_mock_sms_mode || ! require_test_otp_db_read_permission; then + echo "$disabled_msg" >&2 + return 1 + fi + + case "${PHONE:-}" in + *[!0-9]*|'') echo "$disabled_msg" >&2; return 1 ;; esac + [ "${#PHONE}" -eq 11 ] || { echo "$disabled_msg" >&2; return 1; } + + # xtrace 已在脚本开头全局关闭，这里无需（也不得）保存/恢复其状态 + local code="" qstatus=0 + IFS= read -r code < <(otp_db_query "$PHONE" "login") || qstatus=$? + + # 校验格式：当前验证码为 6 位数字（app.sms.mock.code-length / CODE_PATTERN） + local valid=1 + [ "$qstatus" -eq 0 ] || valid=0 + case "$code" in + [0-9][0-9][0-9][0-9][0-9][0-9]) : ;; + *) valid=0 ;; + esac + + if [ "$valid" -ne 1 ]; then + unset code + echo "test OTP retrieval failed" >&2 + return 1 + fi + + REPLY="$code" + unset code + return 0 } report() { @@ -53,6 +182,23 @@ report() { echo " http=$http_code ${biz_code:-code=N/A} ${request_id:-requestId=N/A}" } +# 仅接收可安全打印的三个字段，不接收任何响应体全文（用于登录等敏感响应） +report_fields() { + local http_code="$1" biz_code="$2" request_id="$3" + echo " http=$http_code ${biz_code:-code=N/A} ${request_id:-requestId=N/A}" +} + +# 从响应中只提取可安全打印字段（http / business code / requestId），不保留响应体 +extract_status_fields() { + local response="$1" + local http_code body biz_code request_id + http_code="$(printf '%s\n' "$response" | tail -n 1)" + body="$(printf '%s\n' "$response" | sed '$d')" + biz_code="$(printf '%s' "$body" | grep -oE '"code"[[:space:]]*:[[:space:]]*[0-9]+' | head -n 1 | grep -oE '[0-9]+' || true)" + request_id="$(printf '%s' "$body" | grep -oE '"requestId"[[:space:]]*:[[:space:]]*"[^"]*"' | head -n 1 || true)" + printf '%s\n%s\n%s' "$http_code" "$biz_code" "$request_id" +} + extract_token() { printf '%s' "$1" | sed -n 's/.*"accessToken"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n 1 } @@ -61,17 +207,16 @@ extract_id() { printf '%s' "$1" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -n 1 } -sms_code() { - local log_path - log_path="$(resolve_log)" - [ -n "$log_path" ] || return 1 - [ -f "$log_path" ] || return 1 - grep -a "MOCK SMS CODE.*phone=$PHONE" "$log_path" | tail -n 1 | grep -a -oE 'code=[0-9]{6}' | cut -d= -f2 -} +# ── 可测试性钩子 ─────────────────────────────────────────── +# 供 shell 单元测试加载函数（验证取码保护与泄漏防护）而不执行完整流程。 +# 正常运行（不设该变量）时完全不生效，不影响任何行为。 +if [ "${SMOKE_TEST_LIB_ONLY:-}" = "1" ]; then + return 0 2>/dev/null || exit 0 +fi echo "=== MyDreamJob backend smoke test ===" echo "BASE_URL=$BASE_URL" -echo "PHONE=$PHONE" +echo "PHONE=$(mask_phone "$PHONE")" say "GET /health" HEALTH="$(curl -sS -w '\n%{http_code}' "$BASE_URL/health" || true)" @@ -84,19 +229,33 @@ for attempt in 1 2 3; do curl -sS -X POST "$BASE_URL/auth/sms/send?phone=$PHONE&purpose=login" \ -H "X-Request-Id: smoke-sms-$attempt" >/dev/null 2>&1 || true sleep 2 - SMS="$(sms_code || true)" - [ -n "$SMS" ] && break + if sms_code; then + SMS="$REPLY" + unset REPLY + [ -n "$SMS" ] && break + fi done if [ -z "$SMS" ]; then - fail "cannot read Mock SMS code; set SERVER_LOG to the server log path" + fail "login skipped" + unset SMS TOKEN="" else - LOGIN="$(curl -sS -w '\n%{http_code}' -X POST "$BASE_URL/auth/login" \ + # 请求体经 stdin 传入（--data-binary @-），验证码不出现在进程参数中 + LOGIN_BODY="{\"phone\":\"$PHONE\",\"code\":\"$SMS\",\"purpose\":\"login\"}" + LOGIN="$(printf '%s' "$LOGIN_BODY" | curl -sS -w '\n%{http_code}' -X POST "$BASE_URL/auth/login" \ -H 'Content-Type: application/json' \ -H 'X-Request-Id: smoke-login-001' \ - -d "{\"phone\":\"$PHONE\",\"code\":\"$SMS\",\"purpose\":\"login\"}" || true)" - report "$LOGIN" + --data-binary @- || true)" + unset LOGIN_BODY + unset SMS + # 只保留可安全打印的三个字段；登录响应全文绝不交给打印函数，也绝不落盘 + LOGIN_FIELDS="$(extract_status_fields "$LOGIN")" TOKEN="$(extract_token "$LOGIN")" + unset LOGIN + report_fields "$(printf '%s' "$LOGIN_FIELDS" | sed -n '1p')" \ + "$(printf '%s' "$LOGIN_FIELDS" | sed -n '2p')" \ + "$(printf '%s' "$LOGIN_FIELDS" | sed -n '3p')" + unset LOGIN_FIELDS if [ -n "$TOKEN" ]; then ok "login"; else fail "login"; fi fi diff --git a/docs/tests/smoke-test-schema-contract-test.sh b/docs/tests/smoke-test-schema-contract-test.sh new file mode 100644 index 0000000..74a756d --- /dev/null +++ b/docs/tests/smoke-test-schema-contract-test.sh @@ -0,0 +1,144 @@ +#!/usr/bin/env bash +# S01 第四轮 F6 —— sms_verification_codes 表结构契约门禁 +# +# 目的：防止冒烟脚本再次使用**不存在的列**（F6：expires_at）， +# 且不允许测试自己维护一份与生产无关的假字段列表来自证正确。 +# +# 契约来源（本脚本同时使用前两个，并交叉校验二者一致）： +# 1. 实体 @Column：mydreamjob-server/.../auth/SmsVerificationCode.java +# 2. 建表 Flyway：mydreamjob-server/.../db/migration/V1__base_schema.sql +# 3. 真实 MySQL SHOW COLUMNS —— 属**真实验收阶段**，本脚本只输出对账命令， +# 不在自动化阶段伪造该来源。 +# +# 重要：expires_at 是 personal_data_export_tasks(V30) / ability_attempts(V35) / +# talent_invitations(V40) 三张表的**真实列**。因此本门禁只对 +# sms_verification_codes 这一个表断言"不存在 expires_at"， +# 不得写成全库禁令（那会误报，并掩盖真正的字段错误）。 +# +# 运行: bash docs/tests/smoke-test-schema-contract-test.sh +set -u + +REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)" +SMOKE="$REPO_ROOT/docs/smoke-test.sh" +ENTITY="$REPO_ROOT/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationCode.java" +MIGRATION_DIR="$REPO_ROOT/mydreamjob-server/src/main/resources/db/migration" +FLYWAY="$MIGRATION_DIR/V1__base_schema.sql" +TABLE="sms_verification_codes" + +PASS=0 +FAIL=0 +ok() { echo "[PASS] $1"; PASS=$((PASS + 1)); } +bad() { echo "[FAIL] $1"; FAIL=$((FAIL + 1)); } +check() { if [ "$1" = "1" ]; then ok "$2"; else bad "$2"; fi; } + +echo "=== S01 F6: sms_verification_codes 表结构契约门禁 ===" +echo "实体来源 : $ENTITY" +echo "Flyway来源: $FLYWAY" +echo "脚本 : $SMOKE" +echo "" + +# ── 契约来源 1：实体 @Column ────────────────────────────────── +entity_cols="" +if [ -f "$ENTITY" ]; then + # 主键 id 在实体中以 @Id 标注（无 @Column(name=...)），单独补入 + grep -qE '^[[:space:]]*@Id[[:space:]]*$' "$ENTITY" && entity_cols="id" + entity_cols="$entity_cols $(grep -oE '@Column\(name[[:space:]]*=[[:space:]]*"[A-Za-z0-9_]+"' "$ENTITY" \ + | sed 's/.*"\(.*\)"/\1/')" + entity_cols="$(printf '%s' "$entity_cols" | tr ' ' '\n' | grep -v '^$' | sort -u | tr '\n' ' ')" +fi + +# ── 契约来源 2：建表 Flyway ─────────────────────────────────── +flyway_cols="" +if [ -f "$FLYWAY" ]; then + flyway_cols="$(awk -v t="$TABLE" ' + $0 ~ "^CREATE TABLE (IF NOT EXISTS )?" t "([[:space:]]|\\()" { in_t=1; next } + in_t && /^\)/ { in_t=0 } + in_t { + line=$0 + sub(/^[[:space:]]+/, "", line) + if (line ~ /^(INDEX|KEY|PRIMARY|CONSTRAINT|UNIQUE|FOREIGN)/) next + if (line ~ /^[A-Za-z0-9_]+[[:space:]]/) { split(line, a, /[[:space:]]/); print a[1] } + } + ' "$FLYWAY" | sort -u | tr '\n' ' ')" +fi + +check "$([ -f "$ENTITY" ] && echo 1 || echo 0)" "C1. 实体文件存在" +check "$([ -f "$FLYWAY" ] && echo 1 || echo 0)" "C2. 建表 Flyway 存在" +check "$([ -n "$entity_cols" ] && echo 1 || echo 0)" "C3. 实体 @Column 解析出非空列集合" +check "$([ -n "$flyway_cols" ] && echo 1 || echo 0)" "C4. Flyway 解析出非空列集合" + +# 两个独立来源必须一致（否则说明解析失败或生产定义本身不一致） +check "$([ "$(printf '%s' "$entity_cols" | tr ' ' '\n' | grep -c .)" -gt 0 ] \ + && [ "$entity_cols" = "$flyway_cols" ] && echo 1 || echo 0)" \ + "C5. 实体 @Column 与建表 Flyway 的列集合一致" + +echo " 实体列 : ${entity_cols:-<空>}" +echo " Flyway列: ${flyway_cols:-<空>}" +echo "" + +# ── 字段存在性（表限定）─────────────────────────────────────── +check "$(case " $flyway_cols " in *" expired_at "*) echo 1 ;; *) echo 0 ;; esac)" \ + "C6. sms_verification_codes 存在 expired_at 列" +check "$(case " $flyway_cols " in *" expires_at "*) echo 0 ;; *) echo 1 ;; esac)" \ + "C7. sms_verification_codes **不存在** expires_at 列" +check "$(case " $entity_cols " in *" expired_at "*) echo 1 ;; *) echo 0 ;; esac)" \ + "C8. 实体 expired_at 映射存在" + +# ── 反向护栏：expires_at 确实是别的表的真实列 ────────────────── +# 若此条失败，说明有人把它当成了"全库不存在的列"——那会让本门禁退化成误报。 +other_tables_with_expires_at=0 +for f in "$MIGRATION_DIR"/V30__personal_data_export_tasks.sql \ + "$MIGRATION_DIR"/V35__ability_assessment.sql \ + "$MIGRATION_DIR"/V40__enterprise_talent_invitations.sql; do + [ -f "$f" ] || continue + grep -qE '^[[:space:]]*expires_at[[:space:]]' "$f" && other_tables_with_expires_at=$((other_tables_with_expires_at + 1)) +done +check "$([ "$other_tables_with_expires_at" -gt 0 ] && echo 1 || echo 0)" \ + "C9. expires_at 确实是其他表的真实列（故门禁必须按表限定，不得全局禁用）" + +# ── 脚本侧：表名与列名 ──────────────────────────────────────── +sql_block="$(awk '/SELECT code FROM sms_verification_codes/,/LIMIT 1;/' "$SMOKE" 2>/dev/null)" +# 只保留双引号内的 SQL 片段，剥掉 shell 语法（printf / 引号 / 续行反斜杠）， +# 否则 printf、%s 之类会被误当成列名。 +sql_text="$(printf '%s' "$sql_block" | grep -oE '"[^"]*"' | tr -d '"' | tr '\n' ' ')" +check "$([ -n "$sql_text" ] && echo 1 || echo 0)" "C10. 能从 smoke-test.sh 提取取码 SQL 文本" + +check "$(printf '%s' "$sql_text" | grep -q "FROM $TABLE" && echo 1 || echo 0)" \ + "C11. 取码 SQL 查询表为 $TABLE" +check "$(printf '%s' "$sql_text" | grep -q 'expired_at' && echo 1 || echo 0)" \ + "C12. 取码 SQL 使用 expired_at" +check "$(printf '%s' "$sql_text" | grep -q 'expires_at' && echo 0 || echo 1)" \ + "C13. 取码 SQL **不含** expires_at" + +# 脚本 SQL 使用的每个列名都必须落在真实列集合内 +used_cols="$(printf '%s' "$sql_text" \ + | sed "s/'[^']*'//g" \ + | grep -oE '\b[A-Za-z_][A-Za-z0-9_]*\b' \ + | grep -viE '^(SELECT|code|FROM|WHERE|AND|OR|ORDER|BY|DESC|ASC|LIMIT|NOW)$|^'$TABLE'$' \ + | sort -u | tr '\n' ' ')" +unknown="" +for c in $used_cols; do + case " $flyway_cols " in + *" $c "*) ;; + *) unknown="$unknown $c" ;; + esac +done +check "$([ -z "$unknown" ] && echo 1 || echo 0)" \ + "C14. 取码 SQL 使用的列全部存在于 $TABLE${unknown:+（不存在的列:$unknown）}" + +# 取码列 code 必须在真实列集合内（正向确认解析没跑偏） +check "$(case " $flyway_cols " in *" code "*) echo 1 ;; *) echo 0 ;; esac)" \ + "C15. 取码 SQL 的列 code 是 $TABLE 的真实列" + +echo "" +echo "── 真实验收阶段必须执行（本脚本不伪造该来源）───────────────" +echo "docker exec -i sh -c \\" +echo " 'MYSQL_PWD=\"\$MYSQL_PASSWORD\" mysql -u\"\$MYSQL_USER\" -N -B \"\${MYSQL_DATABASE:-mydreamjob}\" <<<\"SHOW COLUMNS FROM $TABLE;\"'" +echo "对账要求：SHOW COLUMNS 的 Field 集合必须等于上方 Flyway列；" +echo " 必须包含 expired_at；必须不含 expires_at。" +echo "" + +echo "============================================" +echo "PASS=$PASS FAIL=$FAIL" +echo "============================================" +[ "$FAIL" -eq 0 ] diff --git a/docs/tests/smoke-test-sms-code-test.sh b/docs/tests/smoke-test-sms-code-test.sh new file mode 100644 index 0000000..5a09f71 --- /dev/null +++ b/docs/tests/smoke-test-sms-code-test.sh @@ -0,0 +1,548 @@ +#!/usr/bin/env bash +# S01 定向整改 F1 / F4 / F5 —— smoke-test.sh 敏感信息泄漏防护测试 +# +# 覆盖： +# F1 取码机制（双重保护 / 不依赖应用日志 / 格式校验 / 清理） +# F4 xtrace 泄漏：**真实以 `bash -x` 执行被测脚本**，捕获 stdout+stderr 并扫描敏感标记 +# F4 source 模式不把敏感变量带回调用方 +# F5 数据库密码不进入 mysql argv（真实执行容器侧脚本文本，检查假 mysql 的实际 argv） +# §7 文档门禁只针对**活跃文件列表**，不对历史验收报告做全 docs 扫描 +# +# 测试使用假的 docker / curl / mysql（PATH 注入），不要求 Docker 或真实 MySQL。 +# 仓库内不写入真实验证码、JWT 或数据库口令；测试结束扫描输出确认标记未泄露。 +# +# 运行: bash docs/tests/smoke-test-sms-code-test.sh +set -u + +REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)" +SMOKE="$REPO_ROOT/docs/smoke-test.sh" + +# ── 固定测试标记（均为假值，非真实凭据）───────────────────────── +TEST_CODE="739251" +TEST_PHONE="19900009999" +TEST_JWT="FAKEJWT_MARKER_QA7X" +TEST_DBPASS="FAKEDBPASS_MARKER_QA7X" +MARKER_MSG="test OTP retrieval is disabled" + +TMP="$(mktemp -d)" +FAKEBIN="$TMP/bin" +mkdir -p "$FAKEBIN" +export FAKE_DIR="$TMP" +trap 'rm -rf "$TMP"' EXIT + +PASS=0 +FAIL=0 +ok() { echo "[PASS] $1"; PASS=$((PASS + 1)); } +bad() { echo "[FAIL] $1"; FAIL=$((FAIL + 1)); } +check() { if [ "$1" = "1" ]; then ok "$2"; else bad "$2"; fi; } + +# ── 假 docker：真实执行被传入的容器侧 sh -c 脚本（含假 mysql）────── +cat > "$FAKEBIN/docker" <<'FAKEDOCKER' +#!/usr/bin/env bash +# 记录完整 argv（用于 F5 断言：宿主机侧命令行不得含密码） +printf '%s\n' "$*" >> "${FAKE_DIR:?}/docker-argv.log" +script="" +for a in "$@"; do script="$a"; done +# 记录容器侧脚本文本（变量名可以出现，值不可以） +printf '%s\n' "$script" > "${FAKE_DIR}/container-script.txt" +case "${FAKE_DOCKER_MODE:-ok}" in + fail) exit 1 ;; + empty) cat >/dev/null 2>&1 || true; exit 0 ;; + garbage) cat >/dev/null 2>&1 || true; printf '%s\n' "${FAKE_GARBAGE:-not-a-code}"; exit 0 ;; + short) cat >/dev/null 2>&1 || true; printf '%s\n' "12345"; exit 0 ;; +esac +# 真实以本地 sh 执行容器侧脚本，使假 mysql 成为真正被检查 argv 的进程 +exec sh -c "$script" +FAKEDOCKER +chmod +x "$FAKEBIN/docker" + +# ── 假 mysql：记录 argv 与 stdin(SQL)，并按 sms_verification_codes 真实语义作答 ── +# 它**不是**无条件返回验证码：先校验 SQL 使用的列。 +# 真实 MySQL 对未知列返回 ERROR 1054 (42S22)，这里如实复现， +# 使脚本里字段名写错（例如 expires_at）无法被"总能拿到验证码"掩盖。 +# +# FAKE_ROWS 未设置 → 保留历史行为（输出 FAKE_CODE），供 F1/F5 既有用例使用。 +# FAKE_ROWS 设置 → 按行套用 WHERE / ORDER BY 语义作答。行格式： +# id|phone|purpose|used|expire_offset_s|created_at|code +# expire_offset_s > 0 表示 expired_at 晚于 NOW()；查询用严格大于，故 =0 不命中。 +cat > "$FAKEBIN/mysql" <<'FAKEMYSQL' +#!/usr/bin/env bash +printf '%s\n' "$*" > "${FAKE_DIR:?}/mysql-argv.log" +sql="$(cat)" +printf '%s' "$sql" > "${FAKE_DIR}/mysql-stdin.sql" + +# ── 表结构契约检查：sms_verification_codes 的真实列是 expired_at ── +case "$sql" in + *sms_verification_codes*) + case "$sql" in + *expires_at*) + printf "ERROR 1054 (42S22): Unknown column 'expires_at' in 'where clause'\n" >&2 + exit 1 + ;; + esac + ;; +esac + +# 未提供假数据：保持历史行为 +if [ -z "${FAKE_ROWS:-}" ]; then + printf '%s\n' "${FAKE_CODE:-}" + exit 0 +fi + +# 从 SQL 解析查询参数（形态与应用脚本一致） +phone="$(printf '%s' "$sql" | sed -n "s/.*phone *= *'\([^']*\)'.*/\1/p" | head -n 1)" +purpose="$(printf '%s' "$sql" | sed -n "s/.*purpose *= *'\([^']*\)'.*/\1/p" | head -n 1)" + +# 逐行套用 WHERE 语义，按 created_at DESC, id DESC 取第一条 +best_key="" best_code="" +while IFS='|' read -r rid rphone rpurpose rused roffset rcreated rcode; do + [ -n "${rid:-}" ] || continue + [ "$rphone" = "$phone" ] || continue + [ "$rpurpose" = "$purpose" ] || continue + [ "$rused" = "0" ] || continue + case "$roffset" in + ''|*[!0-9-]*) continue ;; + esac + [ "$roffset" -gt 0 ] || continue + key="$(printf '%s|%010d' "$rcreated" "$rid")" + if [ -z "$best_key" ] || [[ "$key" > "$best_key" ]]; then + best_key="$key" best_code="$rcode" + fi +done <<< "${FAKE_ROWS}" + +[ -n "$best_code" ] && printf '%s\n' "$best_code" +exit 0 +FAKEMYSQL +chmod +x "$FAKEBIN/mysql" + +# ── 假 curl：记录请求；登录响应含固定测试 JWT ──────────────────── +cat > "$FAKEBIN/curl" <<'FAKECURL' +#!/usr/bin/env bash +url=""; want_stdin=0 +for a in "$@"; do + case "$a" in + http*) url="$a" ;; + --data-binary) want_stdin=1 ;; + *@-) want_stdin=1 ;; + esac +done +has_code="no" +if [ "$want_stdin" = "1" ]; then + body="$(cat)" + case "$body" in + *[0-9][0-9][0-9][0-9][0-9][0-9]*) has_code="yes" ;; + esac +fi +case "$url" in + *"/auth/login"*) + echo "login-attempted has6digit=$has_code" >> "${FAKE_DIR:?}/flow.log" + printf '{"code":200,"data":{"accessToken":"%s"}}\n200\n' "${FAKE_JWT:-FAKEJWT}" ;; + *"/auth/sms/send"*) printf '{}\n200\n' ;; + *"/health"*) printf '{"code":200}\n200\n' ;; + *"/notifications/unread-count"*) printf '{"unreadCount":1}\n200\n' ;; + *"/notifications/"*) printf '{"message":"marked as read"}\n200\n' ;; + *"/notifications"*) printf '{"items":[{"id":88}]}\n200\n' ;; + *"/applications/"*) printf '{"status":"VIEWED"}\n200\n' ;; + *"/applications"*) printf '{"id":77}\n200\n' ;; + *"/jobs/public/"*) printf '{"title":"x"}\n200\n' ;; + *"/match"*) printf '{"rulesVersion":"v1"}\n200\n' ;; + *"/jobs"*) printf '{"items":[{"id":11,"title":"x"}]}\n200\n' ;; + *) printf '{}\n200\n' ;; +esac +exit 0 +FAKECURL +chmod +x "$FAKEBIN/curl" +export PATH="$FAKEBIN:$PATH" +export FAKE_JWT="$TEST_JWT" + +# 数据库凭据标记：让容器侧脚本的凭据前置检查通过， +# 同时用固定标记值验证它绝不出现在 argv / stdout / stderr / 文件中 +export MYSQL_USER="smoke_readonly" +export MYSQL_PASSWORD="$TEST_DBPASS" +export MYSQL_DATABASE="mydreamjob" + +# 扫描给定文本是否含任一敏感标记；输出命中的标记名（不含值本身） +scan_hits() { + local text="$1" hits="" + case "$text" in *"$TEST_CODE"*) hits="$hits CODE" ;; esac + case "$text" in *"$TEST_PHONE"*) hits="$hits PHONE" ;; esac + case "$text" in *"$TEST_JWT"*) hits="$hits JWT" ;; esac + case "$text" in *"$TEST_DBPASS"*) hits="$hits DBPASS" ;; esac + case "$text" in *"Authorization: Bearer"*) hits="$hits AUTH" ;; esac + case "$text" in *"LOGIN_BODY="*) hits="$hits LOGIN_BODY" ;; esac + printf '%s' "$hits" +} + +echo "=== S01 F1/F4/F5: smoke-test.sh 敏感信息泄漏防护测试 ===" +echo "smoke-test.sh: $SMOKE" +echo "固定测试标记已加载（值不打印）。" +echo "" + +# ══════════════════════════════════════════════════════════════ +# Part 1 — F1 取码保护（进程内，可观测 REPLY） +# ══════════════════════════════════════════════════════════════ +run_sms_code() { + local mock="$1" allow="$2" mode="$3" garbage="${4:-}" + local out + out="$(cd "$REPO_ROOT" && bash -c ' + set -u + SMOKE_TEST_LIB_ONLY=1 + export SMOKE_TEST_LIB_ONLY + if [ "$1" != "__UNSET__" ]; then export SMS_MOCK_ENABLED="$1"; else unset SMS_MOCK_ENABLED; fi + if [ "$2" != "__UNSET__" ]; then export ALLOW_TEST_OTP_DB_READ="$2"; else unset ALLOW_TEST_OTP_DB_READ; fi + export FAKE_DOCKER_MODE="$3" + export FAKE_CODE="'"$TEST_CODE"'" + export FAKE_GARBAGE="$4" + # shellcheck disable=SC1090 + . "'"$SMOKE"'" + if sms_code; then + if [ -n "${REPLY:-}" ]; then printf "RESULT=ok\n"; else printf "RESULT=ok_but_empty\n"; fi + unset REPLY + else + printf "RESULT=fail\n" + fi + ' _ "$mock" "$allow" "$mode" "$garbage" 2>&1)" + printf '%s' "$out" +} + +# ── 以指定假表数据运行 sms_code，并比对取回的验证码 ───────────── +# 只输出 RESULT=ok/fail 与 MATCH=yes/no，**绝不输出验证码本身**。 +run_sms_code_with_rows() { + local rows="$1" expect="$2" + local out + out="$(cd "$REPO_ROOT" && bash -c ' + set -u + export SMOKE_TEST_LIB_ONLY=1 + export SMS_MOCK_ENABLED=true ALLOW_TEST_OTP_DB_READ=true FAKE_DOCKER_MODE=ok + export FAKE_ROWS="$1" + export STUDENT_PHONE="'"$TEST_PHONE"'" + export MYSQL_USER="smoke_readonly" MYSQL_PASSWORD="$2" MYSQL_DATABASE="mydreamjob" + # shellcheck disable=SC1090 + . "'"$SMOKE"'" + if sms_code; then + if [ -n "${REPLY:-}" ]; then + printf "RESULT=ok\n" + if [ "${REPLY}" = "$3" ]; then printf "MATCH=yes\n"; else printf "MATCH=no\n"; fi + else + printf "RESULT=ok_but_empty\n" + fi + unset REPLY + else + printf "RESULT=fail\n" + fi + ' _ "$rows" "$TEST_DBPASS" "$expect" 2>&1)" + printf '%s' "$out" +} + +# ── 端到端运行指定脚本（用于验证「字段错误时不继续登录」）──────── +# 脚本置于 $TMP 下镜像 docs/ 的结构，使其相对定位 backend-infra/compose.yaml 生效。 +run_full_script() { + local script="$1" + : > "$TMP/flow.log" + (cd "$REPO_ROOT" && \ + SMS_MOCK_ENABLED=true ALLOW_TEST_OTP_DB_READ=true FAKE_DOCKER_MODE=ok \ + FAKE_CODE="$TEST_CODE" FAKE_JWT="$TEST_JWT" \ + MYSQL_PASSWORD="$TEST_DBPASS" MYSQL_USER="smoke_readonly" MYSQL_DATABASE="mydreamjob" \ + STUDENT_PHONE="$TEST_PHONE" BASE_URL="http://127.0.0.1:1/api/v1" \ + bash "$script" 2>&1) || true +} + +r="$(run_sms_code true true ok)" +check "$(printf '%s' "$r" | grep -q 'RESULT=ok' && echo 1 || echo 0)" "1. mock=true且ALLOW=true时可取得测试验证码" +check "$(printf '%s' "$r" | grep -q "$TEST_CODE" && echo 0 || echo 1)" "10a. 取码调用 stdout/stderr 不含验证码" + +r="$(run_sms_code false true ok)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "2. mock=false 时拒绝查询" +check "$(printf '%s' "$r" | grep -qF "$MARKER_MSG" && echo 1 || echo 0)" "2b. 拒绝时输出固定提示" + +r="$(run_sms_code __UNSET__ true ok)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "3. 配置缺失时拒绝查询" + +r="$(run_sms_code true __UNSET__ ok)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "4. ALLOW_TEST_OTP_DB_READ 缺失时拒绝查询" + +r="$(run_sms_code true false ok)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "5. ALLOW_TEST_OTP_DB_READ=false 时拒绝查询" + +r="$(run_sms_code true true empty)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "6. 没有可用验证码时安全失败" + +r="$(run_sms_code true true fail)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "7. 查询失败时不继续" + +r="$(run_sms_code true true garbage 'not-a-code')" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "8a. 非数字结果被拒绝" +r="$(run_sms_code true true short)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "8b. 长度非法结果被拒绝" + +# ══════════════════════════════════════════════════════════════ +# Part 2 — F4：真实 `bash -x` 执行，扫描 stdout+stderr +# ══════════════════════════════════════════════════════════════ +run_smoke_xtrace() { + local mode="$1" + : > "$TMP/flow.log"; : > "$TMP/docker-argv.log"; : > "$TMP/mysql-argv.log" + (cd "$REPO_ROOT" && \ + SMS_MOCK_ENABLED=true ALLOW_TEST_OTP_DB_READ=true FAKE_DOCKER_MODE="$mode" \ + FAKE_CODE="$TEST_CODE" FAKE_JWT="$TEST_JWT" \ + MYSQL_PASSWORD="$TEST_DBPASS" MYSQL_USER="smoke_readonly" MYSQL_DATABASE="mydreamjob" \ + STUDENT_PHONE="$TEST_PHONE" BASE_URL="http://127.0.0.1:1/api/v1" \ + bash -x "$SMOKE" 2>&1) || true +} + +out_x="$(run_smoke_xtrace ok)" +hits_x="$(scan_hits "$out_x")" +check "$(printf '%s' "$hits_x" | grep -q 'CODE' && echo 0 || echo 1)" "F4-1. bash -x 下不泄露验证码" +check "$(printf '%s' "$hits_x" | grep -q 'PHONE' && echo 0 || echo 1)" "F4-2. bash -x 下不泄露完整手机号" +check "$(printf '%s' "$hits_x" | grep -q 'JWT' && echo 0 || echo 1)" "F4-3. bash -x 下不泄露 JWT" +check "$(printf '%s' "$hits_x" | grep -q 'AUTH' && echo 0 || echo 1)" "F4-4. bash -x 下不泄露 Authorization 头" +check "$(printf '%s' "$hits_x" | grep -q 'DBPASS' && echo 0 || echo 1)" "F4-5. bash -x 下不泄露数据库密码" +check "$(printf '%s' "$hits_x" | grep -q 'LOGIN_BODY' && echo 0 || echo 1)" "F4-6. bash -x 下不泄露 LOGIN_BODY" + +# 正常流程仍可完成（登录被调用且带 6 位码；登录判定 PASS） +check "$(grep -q 'login-attempted has6digit=yes' "$TMP/flow.log" 2>/dev/null && echo 1 || echo 0)" \ + "F4-7. bash -x 下正常流程仍可完成登录" +check "$(printf '%s' "$out_x" | grep -q '\[PASS\] login' && echo 1 || echo 0)" \ + "F4-8. bash -x 下登录步骤判定 PASS" + +# xtrace 未在脚本内被重新启用：脚本内不存在可执行的 set -x +setx_code="$(grep -n 'set -x' "$SMOKE" | grep -v '^[0-9]*:[[:space:]]*#' | wc -l)" +check "$([ "$setx_code" -eq 0 ] && echo 1 || echo 0)" "F4-9. 脚本中不存在可执行的 set -x（不会恢复 xtrace）" + +# 失败流程同样不泄露 +out_f="$(run_smoke_xtrace empty)" +hits_f="$(scan_hits "$out_f")" +check "$([ -z "$hits_f" ] && echo 1 || echo 0)" "F4-10. 失败流程（无可用验证码）同样不泄露敏感值" + +# ══════════════════════════════════════════════════════════════ +# Part 3 — F4：source 模式不把敏感值带回调用方 +# ══════════════════════════════════════════════════════════════ +src_out="$(cd "$REPO_ROOT" && bash -c ' + set -u + export SMOKE_TEST_LIB_ONLY=1 + export SMS_MOCK_ENABLED=true ALLOW_TEST_OTP_DB_READ=true + export FAKE_DOCKER_MODE=ok FAKE_CODE="'"$TEST_CODE"'" + . "'"$SMOKE"'" + trap -p EXIT > "'"$TMP"'/trap.txt" 2>/dev/null || true + if sms_code; then + if [ -n "${REPLY:-}" ]; then echo "reply-nonempty"; else echo "reply-empty"; fi + unset REPLY + fi + # 清理后不得残留任何非空敏感变量 + leak=0 + for v in REPLY SMS OTP LOGIN_BODY LOGIN TOKEN AUTH; do + eval "val=\${$v:-}" + [ -n "$val" ] && leak=1 + done + echo "leak=$leak" +' 2>&1)" +check "$(printf '%s' "$src_out" | grep -q 'reply-nonempty' && echo 1 || echo 0)" "F4-11. source 模式下取码契约（REPLY）可用" +check "$(printf '%s' "$src_out" | grep -q 'leak=0' && echo 1 || echo 0)" "F4-12. source 模式下清理后无敏感变量残留" +check "$(grep -q 'cleanup_secrets' "$TMP/trap.txt" 2>/dev/null && echo 1 || echo 0)" "F4-13. source 模式下 EXIT trap 已登记清理函数" +check "$(grep -q 'PHONE' "$SMOKE" && grep -q 'TOKEN' "$SMOKE" && grep -q 'AUTH' "$SMOKE" && grep -q 'COMPANY_TOKEN' "$SMOKE" && echo 1 || echo 0)" \ + "F4-14. cleanup_secrets 覆盖 PHONE/TOKEN/AUTH/COMPANY_TOKEN" + +# ══════════════════════════════════════════════════════════════ +# Part 4 — F5：数据库密码不进入 mysql argv +# ══════════════════════════════════════════════════════════════ +: > "$TMP/mysql-argv.log"; : > "$TMP/docker-argv.log" +_f5="$(run_sms_code true true ok)" +mysql_argv="$(cat "$TMP/mysql-argv.log" 2>/dev/null)" +docker_argv="$(cat "$TMP/docker-argv.log" 2>/dev/null)" +container_script="$(cat "$TMP/container-script.txt" 2>/dev/null)" +mysql_stdin="$(cat "$TMP/mysql-stdin.sql" 2>/dev/null)" + +check "$(printf '%s' "$mysql_argv" | grep -qF "$TEST_DBPASS" && echo 0 || echo 1)" "F5-1. mysql argv 不含数据库密码值" +check "$(printf '%s' "$docker_argv" | grep -qF "$TEST_DBPASS" && echo 0 || echo 1)" "F5-2. 宿主机 docker 命令行不含数据库密码值" +check "$(printf '%s' "$container_script" | grep -qF "$TEST_DBPASS" && echo 0 || echo 1)" "F5-3. 容器侧脚本文本不含密码值" +check "$(printf '%s' "$container_script" | grep -q 'MYSQL_PASSWORD' && echo 1 || echo 0)" "F5-4. 容器侧脚本以变量名引用 MYSQL_PASSWORD" +check "$(printf '%s' "$mysql_argv" | grep -qE '(^| )-p' && echo 0 || echo 1)" "F5-5. mysql argv 不含 -p<密码>" +check "$(printf '%s' "$mysql_argv" | grep -q -- '--password' && echo 0 || echo 1)" "F5-6. mysql argv 不含 --password" +check "$(printf '%s' "$container_script" | grep -q 'MYSQL_ROOT_PASSWORD' && echo 0 || echo 1)" "F5-7. 不使用 root 凭据（无 MYSQL_ROOT_PASSWORD）" +check "$(printf '%s' "$container_script" | grep -q 'uroot' && echo 0 || echo 1)" "F5-8. 不使用 -uroot" +check "$(printf '%s' "$mysql_argv" | grep -q 'smoke_readonly' && echo 1 || echo 0)" "F5-9. 使用应用账号 MYSQL_USER" +check "$(printf '%s' "$mysql_argv" | grep -q 'mydreamjob' && echo 1 || echo 0)" "F5-10. 使用 MYSQL_DATABASE" +check "$(printf '%s' "$mysql_stdin" | grep -qi '^SELECT' && echo 1 || echo 0)" "F5-11. SQL 经 stdin 传入" +check "$(printf '%s' "$mysql_stdin" | grep -qiE 'INSERT|UPDATE|DELETE|DROP|ALTER' && echo 0 || echo 1)" "F5-12. 查询仅包含 SELECT（无写操作）" +check "$(printf '%s' "$mysql_argv" | grep -q 'MYSQL_PWD\|MYSQL_PASSWORD' && echo 0 || echo 1)" "F5-13. 密码不经 argv 传递" +check "$(printf '%s' "$container_script" | grep -q 'MYSQL_PWD' && echo 1 || echo 0)" "F5-14. 密码经 MYSQL_PWD 环境变量传递" +check "$(printf '%s' "$container_script" | grep -q 'MYSQL_PASSWORD' && grep -q 'exit 3' "$TMP/container-script.txt" && echo 1 || echo 0)" \ + "F5-15. 凭据缺失时安全失败（不回退 root）" +check "$(printf '%s' "$_f5" | grep -q 'RESULT=ok' && echo 1 || echo 0)" "F5-16. argv 安全前提下取码仍可用" + +# docker 不可用（容器不存在）时不泄露且安全失败 +: > "$TMP/mysql-argv.log" +r="$(run_sms_code true true fail)" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" "F5-17. 查询失败时安全失败" +check "$(printf '%s' "$r" | grep -q "$TEST_DBPASS" && echo 0 || echo 1)" "F5-18. 失败路径 stderr 不含数据库密码" + +# ══════════════════════════════════════════════════════════════ +# Part 5 — F1 静态保证 + §7 活跃文件文档门禁 +# ══════════════════════════════════════════════════════════════ +check "$(grep -qE 'grep[^|]*\.log|grep[^|]*stdout' "$SMOKE" && echo 0 || echo 1)" "13. smoke-test.sh 不 grep 应用日志" +check "$(grep -q 'MOCK SMS CODE' "$SMOKE" && echo 0 || echo 1)" "14. smoke-test.sh 中不存在 MOCK SMS CODE" +mech=1 +grep -q 'unset REPLY' "$SMOKE" || mech=0 +grep -q 'unset SMS' "$SMOKE" || mech=0 +grep -q 'trap cleanup_secrets EXIT' "$SMOKE" || mech=0 +grep -q 'unset LOGIN_BODY' "$SMOKE" || mech=0 +check "$mech" "15. 存在 REPLY/SMS/LOGIN_BODY 清理与 EXIT trap" +check "$(grep -qE 'curl.*(-v|--trace|--trace-ascii)' "$SMOKE" && echo 0 || echo 1)" "20. 未使用 curl -v/--trace/--trace-ascii" +check "$(grep -q 'report_fields' "$SMOKE" && echo 1 || echo 0)" "21. 登录响应经 report_fields（不把响应全文交给打印函数）" + +# §7：仅扫描**活跃操作文档与正式代码**，不把历史验收报告计入 +ACTIVE_FILES="docs/acceptance-week1.md docs/api-v0.1.md docs/frontend-integration.md docs/offer-api.md docs/resume-api.md docs/smoke-test.sh README.md" +active_viol=0 +for f in $ACTIVE_FILES; do + [ -f "$REPO_ROOT/$f" ] || continue + c=$(grep -c "验证码.*打印到日志" "$REPO_ROOT/$f" 2>/dev/null); c=${c:-0} + c2=$(grep -c "从日志获取验证码" "$REPO_ROOT/$f" 2>/dev/null); c2=${c2:-0} + c3=$(grep -c "MOCK SMS CODE" "$REPO_ROOT/$f" 2>/dev/null); c3=${c3:-0} + [ $((c + c2 + c3)) -ne 0 ] && active_viol=$((active_viol + 1)) +done +check "$([ "$active_viol" -eq 0 ] && echo 1 || echo 0)" "22. 活跃操作文档不存在『从日志取码』有效指导" +src_viol=$(grep -rn "MOCK SMS CODE" "$REPO_ROOT/mydreamjob-server/src/main/java" 2>/dev/null | wc -l) +check "$([ "$src_viol" -eq 0 ] && echo 1 || echo 0)" "23. 正式 Java 代码中不存在 MOCK SMS CODE" +hist_ok=1 +[ -f "$REPO_ROOT/docs/s01-independent-mysql-acceptance-20260911.md" ] || hist_ok=0 +[ -f "$REPO_ROOT/docs/s01-remediation-f1f2f3-20260911.md" ] || hist_ok=0 +check "$hist_ok" "24. 历史验收报告仍保留（作为历史失败证据，不参与活跃文档扫描）" + +# ══════════════════════════════════════════════════════════════ +# Part 6 — F6：SQL 字段契约（expired_at）与查询语义 +# ══════════════════════════════════════════════════════════════ +# 背景：expires_at 在本仓库中是 personal_data_export_tasks(V30)、 +# ability_attempts(V35)、talent_invitations(V40) 三张表的**真实列**； +# 只有 sms_verification_codes 使用 expired_at。因此断言必须限定在该表的查询上， +# **不能**写成"全库不存在 expires_at"——那会误报。 +# +# 真实列清单从**创建该表的 Flyway** 派生，不在测试里手工维护一份与生产无关的 +# 假字段列表来自证正确。 +FLYWAY="$REPO_ROOT/mydreamjob-server/src/main/resources/db/migration/V1__base_schema.sql" +real_cols="$(awk ' + /^CREATE TABLE (IF NOT EXISTS )?sms_verification_codes/ { in_t=1; next } + in_t && /^\)/ { in_t=0 } + in_t { + line=$0 + sub(/^[[:space:]]+/, "", line) + if (line ~ /^(INDEX|KEY|PRIMARY|CONSTRAINT|UNIQUE|FOREIGN)/) next + if (line ~ /^[a-z_]+[[:space:]]/) { split(line, a, /[[:space:]]/); print a[1] } + } +' "$FLYWAY" | sort -u | tr '\n' ' ')" + +# 取一次真实查询文本（此调用未设置 FAKE_ROWS，走历史路径） +: > "$TMP/mysql-stdin.sql" +_f6="$(run_sms_code true true ok)" +sql_text="$(cat "$TMP/mysql-stdin.sql" 2>/dev/null)" + +check "$(printf '%s' "$sql_text" | grep -q 'expired_at > NOW()' && echo 1 || echo 0)" \ + "F6-1. otp_db_query 使用 expired_at > NOW()" +check "$(printf '%s' "$sql_text" | grep -q 'expires_at' && echo 0 || echo 1)" \ + "F6-2. otp_db_query 不再出现错误字段 expires_at" + +# 解析查询里使用的列名（去掉字符串字面量与 SQL 关键字） +used_cols="$(printf '%s' "$sql_text" \ + | sed "s/'[^']*'//g" \ + | grep -oE '\b[a-z_][a-z0-9_]*\b' \ + | grep -vEx 'select|from|where|and|or|order|by|desc|asc|limit|now|sms_verification_codes' \ + | sort -u)" +unknown_cols="" +for c in $used_cols; do + case " $real_cols " in + *" $c "*) ;; + *) unknown_cols="$unknown_cols $c" ;; + esac +done +check "$([ -z "$unknown_cols" ] && echo 1 || echo 0)" \ + "F6-3. 查询只使用 sms_verification_codes 的真实列${unknown_cols:+（命中不存在的列:$unknown_cols）}" +# 防止"派生失败得到空清单"导致上一条恒真 +check "$(printf '%s' "$real_cols" | grep -q 'expired_at' && echo 1 || echo 0)" \ + "F6-4. 真实列清单由 Flyway 派生且包含 expired_at（非空、非自证）" + +check "$(printf '%s' "$sql_text" | grep -qiE '^SELECT code FROM sms_verification_codes' && echo 1 || echo 0)" \ + "F6-5. 假 mysql 捕获到完整 stdin SQL（不是无条件返回验证码）" + +# 字段错误 → 假 mysql 必须失败（复现真实 MySQL 的 ERROR 1054） +printf '%s\n' "SELECT code FROM sms_verification_codes WHERE phone='x' AND expires_at > NOW();" \ + | "$FAKEBIN/mysql" >/dev/null 2>"$TMP/err1054.txt" || rc1054=$? +rc1054="${rc1054:-0}" +check "$([ "$rc1054" -ne 0 ] && echo 1 || echo 0)" \ + "F6-6. SQL 字段错误时假 mysql 返回失败（非 0）" +check "$(grep -q '1054' "$TMP/err1054.txt" 2>/dev/null && echo 1 || echo 0)" \ + "F6-6b. 字段错误时报 ERROR 1054 (42S22)" + +# 端到端：把字段改错的副本跑完整流程，验证不会继续登录 +BUGDIR="$TMP/bugrepo" +mkdir -p "$BUGDIR/docs" "$BUGDIR/backend-infra" +cp "$REPO_ROOT/backend-infra/compose.yaml" "$BUGDIR/backend-infra/compose.yaml" 2>/dev/null || true +sed 's/expired_at > NOW()/expires_at > NOW()/' "$SMOKE" > "$BUGDIR/docs/smoke-test.sh" +out_bug="$(run_full_script "$BUGDIR/docs/smoke-test.sh")" +check "$(printf '%s' "$out_bug" | grep -q '\[FAIL\] login skipped' && echo 1 || echo 0)" \ + "F6-7. 字段错误时 sms_code() 不继续登录" +check "$(grep -q 'login-attempted' "$TMP/flow.log" 2>/dev/null && echo 0 || echo 1)" \ + "F6-7b. 字段错误时未发出任何 login 请求" + +# 正确字段 → 取码成功并可完成登录 +out_ok="$(run_full_script "$SMOKE")" +check "$(grep -q 'login-attempted has6digit=yes' "$TMP/flow.log" 2>/dev/null && echo 1 || echo 0)" \ + "F6-8. 正确字段时取码成功并完成登录" + +# ── 过期 / used / purpose / phone / 最新一条 语义 ────────────── +# 行格式 id|phone|purpose|used|expire_offset_s|created_at|code +P="$TEST_PHONE" +R_FUTURE="1|$P|login|0|300|2026-09-11 10:00:00|$TEST_CODE" +R_EXACT="1|$P|login|0|0|2026-09-11 10:00:00|$TEST_CODE" +R_PAST="1|$P|login|0|-300|2026-09-11 10:00:00|$TEST_CODE" +R_USED="1|$P|login|1|300|2026-09-11 10:00:00|$TEST_CODE" +R_PURPOSE="1|$P|register|0|300|2026-09-11 10:00:00|$TEST_CODE" +R_PHONE="1|19900001111|login|0|300|2026-09-11 10:00:00|$TEST_CODE" +R_OLD="1|$P|login|0|300|2026-09-11 10:00:00|111111" +R_NEW="2|$P|login|0|300|2026-09-11 11:00:00|222222" + +r="$(run_sms_code_with_rows "$R_EXACT" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" \ + "F6-9. expired_at 恰好等于 NOW() 时不得取出" + +r="$(run_sms_code_with_rows "$R_FUTURE" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'MATCH=yes' && echo 1 || echo 0)" \ + "F6-10. expired_at 晚于 NOW() 时可以取出" + +r="$(run_sms_code_with_rows "$R_PAST" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" \ + "F6-11. expired_at 早于 NOW() 时不得取出" + +r="$(run_sms_code_with_rows "$R_USED" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" \ + "F6-12. used=1 不得取出" + +r="$(run_sms_code_with_rows "$R_PURPOSE" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" \ + "F6-13. purpose 不匹配不得取出" + +r="$(run_sms_code_with_rows "$R_PHONE" "$TEST_CODE")" +check "$(printf '%s' "$r" | grep -q 'RESULT=fail' && echo 1 || echo 0)" \ + "F6-14. phone 不匹配不得取出" + +r="$(run_sms_code_with_rows "$(printf '%s\n%s' "$R_OLD" "$R_NEW")" "222222")" +check "$(printf '%s' "$r" | grep -q 'MATCH=yes' && echo 1 || echo 0)" \ + "F6-15. 多条有效记录只取 created_at/id 最新一条" +# 逆序输入仍取同一条，证明按 ORDER BY 取值而非"最后一行胜出" +r="$(run_sms_code_with_rows "$(printf '%s\n%s' "$R_NEW" "$R_OLD")" "222222")" +check "$(printf '%s' "$r" | grep -q 'MATCH=yes' && echo 1 || echo 0)" \ + "F6-15b. 与输入顺序无关，按 created_at/id 排序取值" + +echo "" +echo "============================================" +echo "PASS=$PASS FAIL=$FAIL" +echo "============================================" + +# 最终泄露扫描（测试自身输出也不得含标记） +if printf '%s' "$out_x$out_f$r$src_out" | grep -qF "$TEST_CODE"; then + echo "LEAK DETECTED: code"; exit 1 +fi +if printf '%s' "$out_x$out_f$r$src_out" | grep -qF "$TEST_JWT"; then + echo "LEAK DETECTED: jwt"; exit 1 +fi +if printf '%s' "$out_x$out_f$r$src_out" | grep -qF "$TEST_DBPASS"; then + echo "LEAK DETECTED: dbpass"; exit 1 +fi +[ "$FAIL" -eq 0 ] diff --git a/docs/v38-ability-score-integration-design.md b/docs/v38-ability-score-integration-design.md new file mode 100644 index 0000000..9e0160a --- /dev/null +++ b/docs/v38-ability-score-integration-design.md @@ -0,0 +1,319 @@ +# V38：四维能力测评有限接入候选人评分设计 + +> 状态：**已实现并通过真实 MySQL/Docker 关键黑盒验收，待建立 Git 检查点**。 +> 功能版本：V38。 +> 基线：Flyway `V1–V36`、OpenAPI `148 paths / 182 operations`、全量测试 `1427/1427`（`mvn clean verify`，0 Failures / 0 Errors / 0 Skipped）。 +> 本设计只接入 V36 四维能力测评，不接入 V35 RIASEC 兴趣测评。 + +## 1. 目标与边界 + +### 1.1 目标 + +在不改变 V36 测评主链路的前提下，将学生**最新、完整、仍有效**的四维能力测评结果映射为候选人评分中的 `ABILITY` 维度，使候选评分卡可有限地反映能力测评结果。 + +### 1.2 必须满足的边界 + +- 仅使用 V36 `ability_results`，不使用 V35 兴趣类型或职业方向结果。 +- 仅映射到 `ABILITY`；不写入或推断 `GROWTH`、`ACTIVITY` 等其他维度。 +- 不在测评提交时直接写 `candidate_dimension_scores`；V36 提交仍只写其 `ability_*` 表和既有审计。 +- 不新增企业查看测评详情的接口。企业仅通过既有候选评分卡看到 `ABILITY` 的聚合 `score/status`。 +- 不向任何评分接口返回题目、答案键、选项分值、题库标签、题目解析或测评答卷 ID。 +- 功能开关默认关闭；关闭时现有 `ABILITY=PENDING` 行为必须完全保持。 +- 不引入 AI 评分、人工覆写、最高分挑选、自动封禁或对既有学生数据的回填。 + +## 2. 已确认的产品与规则口径 + +| 项目 | V38 锁定口径 | +|---|---| +| 可采纳来源 | V36 最新 `COMPLETED` 且 `valid_until > capturedNow` 的结果 | +| 四维权重 | `LOGIC=35%`、`EXECUTION=30%`、`LEARNING=20%`、`COMMUNICATION=15%` | +| 结果选择 | 只取最新有效完成结果；按 `completed_at DESC, attempt_id DESC` 稳定排序；绝不取历史最高分 | +| 有效期 | 复用 V36 的 7 天；过期结果仍可由学生查看历史，但不得参与新评分计算 | +| 重测治理 | 复用 V36：有效结果期间禁止重测，结果到期后可重测，滚动 90 天至多完成 3 次 | +| 企业可见性 | 仅既有公司评分卡的 `dimensions[]{dimension,score,status}`；无四维细分、短板、答卷或题目反馈 | +| 默认发布状态 | `OFF`，不影响候选综合分、V32 排名或 V34 求职进度 | + +## 3. 总体方案：评分时只读投影 + +采用**评分时只读投影（read-through projection）**，而不是在 V36 提交后跨模块写入候选评分表。 + +```text +V36 完成测评 + └─ 写 ability_attempts / ability_results（既有行为，不调用评分引擎） + +学生或企业读取既有候选评分卡 + └─ CandidateScoringCalculator + └─ AbilityAssessmentScoreSource（只读选择最新有效 ability_result） + └─ AbilityScoreMapper（按 V38 固定权重计算 ABILITY） + └─ 既有批量 upsert candidate_dimension_scores（既有评分快照机制） +``` + +这样做的原因： + +1. V36 仍可独立工作，测评提交失败或评分开关关闭都不会影响其完成、结果和历史查询。 +2. 评分只在既有评分查询/重算时产生快照，沿用当前 `candidate_dimension_scores` 的写入模型。 +3. 不需要异步消息、定时回填或跨服务事务；结果到期后下一次评分自然变为 `PENDING`。 +4. 评分行的 `sub_scores_json` 保留最小化、可追溯的来源版本信息，不需新建投影表。 + +## 4. 数据选择与有效性判定 + +### 4.1 单一查询契约 + +新增一个只读仓库查询，语义为： + +```text +findLatestValidCompletedResult(studentUserId, typeCode, capturedNow) +``` + +查询必须同时满足： + +- `ability_attempts.student_user_id = :studentUserId`； +- `ability_attempts.status = 'COMPLETED'`； +- `ability_results.valid_until > :capturedNow`； +- 测评定义为 V36 能力测评类型且当前/答卷题集版本可识别； +- 排序固定为 `completed_at DESC, ability_attempts.id DESC`； +- 最多取一条。 + +`capturedNow` 必须在一次评分计算开始时由后端生成并全程复用，不能在同一计算中多次调用 `now()`，以避免临界过期时出现不一致。 + +### 4.2 结果结构防御 + +即使查询到结果，也仅在以下条件全部成立时计算： + +- `dimension_scores_json` 可被安全解析； +- 恰有 `LOGIC`、`COMMUNICATION`、`EXECUTION`、`LEARNING` 四维； +- 每维分数均在 `[0,100]`，且均为有限数值； +- 每维已答题数均为 6，答卷总已答题数为 24； +- `overall_score`、题集版本和 V36 规则版本存在。 + +> 实现细则（V38 发布前 P1）：`answeredCount` 使用精确整数校验，仅接受数值意义上等于整数的表示 +> （如 JSON 整数 6 或 6.0、`"6"`、`"6.0"`）；`6.9`、`6.5`、`"6.5"`、溢出 int、空串、`null` 均视为不可用 +> （`stripTrailingZeros` + `intValueExact`，不使用可能截断小数的 `intValue()`）。`attemptAnsweredCount` +> 必须非空且严格等于 24，不允许 `null` 放行。 + +任一条件不满足时，不抛给前端 500，也不使用部分数据；该学生本次 `ABILITY` 返回 `PENDING`，原因写为“无可用的完整能力测评结果”。内部日志仅记录结果 ID 与结构错误类型，禁止记录题目、答案或选项分值。 + +### 4.3 过期与重测 + +- 无有效结果、仅有过期结果、或最新结果格式无效：`ABILITY=PENDING`，`score=null`。 +- 有效期内没有重测入口；到期后的新测评完成后，在下一次评分计算中自然替换为新结果。 +- 结果选择不比较分数，因此不能通过“多次测到高分”挑选最高成绩。 +- 已写入的旧月度快照保留为历史；当前月份按现有 upsert 语义在下一次评分查询/重算时刷新。 + +## 5. 分数映射 + +### 5.1 公式 + +设 V36 四维百分制结果为 `L`（逻辑）、`C`（沟通）、`E`（执行）、`R`（学习），则： + +```text +abilityScore = roundHalfUp(L × 0.35 + E × 0.30 + R × 0.20 + C × 0.15, 2) +``` + +分数范围为 `0.00–100.00`。所有中间计算使用 `BigDecimal`；最终 `scale=2`、`HALF_UP`。不得复用 V36 等权 `overallScore` 直接作为候选 `ABILITY` 分数，因为 V38 已确认使用不同的、显式的业务权重。 + +### 5.2 维度结果 + +| 条件 | `ABILITY.status` | `ABILITY.score` | 对综合分的影响 | +|---|---:|---:|---| +| 开关关闭 | `PENDING` | `null` | 与 V37 前完全一致，不参与平均 | +| 无有效完整结果 | `PENDING` | `null` | 不参与平均 | +| 有效完整结果且开关开启 | `OK` | 映射后的 0–100 分 | 按既有候选评分规则参与可计算维度平均 | +| 来源读取异常/结构异常 | `PENDING` | `null` | 不参与平均，记录脱敏内部告警 | + +候选综合分继续遵循现有规则：只对 `OK/ESTIMATED` 且分数非空的维度重新归一化计算。故 V38 启用后会对拥有有效能力结果的学生产生真实影响；这是功能开关默认关闭的原因。 + +### 5.3 版本 + +- 能力映射规则版本：`ability-assessment-scoring-v0.1`。 +- 开关开启后的候选评分规则版本：`candidate-scoring-v0.2`。 +- 开关关闭时保留现有 `candidate-scoring-v0.1`。 +- 每个写入的 `ABILITY` 快照必须记录两类版本，保证规则升级后可解释、可重算。 + +## 6. 快照、溯源与数据最小化 + +不新增表、不新增 Flyway。复用 `candidate_dimension_scores` 现有的唯一键 `(student_user_id, dimension, period)` 与 `sub_scores_json`。 + +### 6.1 持久化的最小来源字段 + +`ABILITY` 行的内部 `sub_scores_json` 仅允许下列字段： + +```json +{ + "source": "V36_ABILITY_ASSESSMENT", + "sourceResultId": 123, + "sourceCompletedAt": "2026-09-04T10:00:00Z", + "validUntil": "2026-09-11T10:00:00Z", + "questionSetVersion": "ability-v0.1", + "assessmentRulesVersion": "ability-v0.1", + "mappingRulesVersion": "ability-assessment-scoring-v0.1", + "weights": {"LOGIC": 35, "EXECUTION": 30, "LEARNING": 20, "COMMUNICATION": 15}, + "dimensionScores": {"LOGIC": 80.00, "EXECUTION": 75.00, "LEARNING": 70.00, "COMMUNICATION": 65.00} +} +``` + +禁止写入：答卷 ID、题目 ID、题目编码、题库标签、题干、选项、用户选择、答案键、选项分值、题目解析、手机号、邮箱、令牌、请求体和完整审计详情。 + +`sourceResultId` 仅作内部溯源，任何 HTTP 响应均不得返回该字段。 + +### 6.2 响应投影 + +- 学生综合卡：沿用既有 `ABILITY` 聚合分和状态。 +- 学生单维详情：可返回四维**聚合分**、权重、有效期、规则版本和说明，用于解释自己的分数；不得返回 `sourceResultId` 或题目级内容。 +- 企业候选评分卡：保持既有字段，只返回 `ABILITY` 的 `dimension/score/status`。 +- 趋势接口：只使用已写候选快照，不回读题目或 V36 原始答案。 + +## 7. 功能开关与上线策略 + +新增配置： + +```yaml +scoring: + ability-assessment: + enabled: false +``` + +| 模式 | 行为 | +|---|---| +| `false`（默认） | 不查询 V36 结果，`ABILITY=PENDING`；无评分行为变更 | +| `true` | 查询最新有效结果，按本设计映射；仅在既有评分计算/重算时写候选评分快照 | + +发布顺序： + +1. 合入代码且以 `false` 发布；验证所有既有候选评分卡仍是 V37 行为。 +2. 在验收/小范围环境设为 `true`，核验映射、脱敏、排名影响与回滚。 +3. 经负责人确认后才在正式环境启用；启用后仍可立即设回 `false`。 + +关闭开关只停止后续映射，不删除已存在的快照或 V36 数据。若需消除当前月份的已映射 `ABILITY`，必须走单独、经批准的重算流程，不能在开关切换时隐式删除数据。 + +## 8. 模块职责与实现边界 + +建议新增以下内部组件： + +- `AbilityAssessmentScoreSource`：一次查询并解析最新有效 V36 结果；不暴露实体给 Controller。 +- `AbilityScoreMapper`：纯函数，校验四维、计算权重分、构造最小化来源描述。 +- `CandidateScoringCalculator#computeAbility(...)`：替换现有硬编码 `PENDING`；开关关闭时保留旧分支。 +- `CandidateScoringService`：每次评分计算只调用一次 `AbilityAssessmentScoreSource`，不在八维循环内查询。 + +不得： + +- 改动 `AbilityAttemptService.submit()` 的事务边界、状态机、重测限制或审计。 +- 让评分模块更新 `ability_attempts`、`ability_answers`、`ability_results`。 +- 在 Controller 接受 `studentUserId`、能力分或结果 ID 来影响评分。 +- 新增企业端能力测评详情、管理员修改能力分或公开的“重算某学生能力分”接口。 + +## 9. 并发、一致性与性能 + +- 评分计算使用一次 `capturedNow` 和最多一次 V36 来源查询；不得按四维各查一次，也不得循环读取题目/答案。 +- 已有候选评分批量 upsert 继续处理同月并发刷新；V38 不新增新的评分写表。 +- V36 提交与评分查询并发时：评分要么读取提交前无结果并返回 `PENDING`，要么读取完整、已提交的结果并返回 `OK`；不能读取半成品。 +- 结果刚好到期时以 `capturedNow` 判定；该次计算结束后不回滚同次快照，下一次计算按新时间重新判定。 +- 利用既有 `ability_attempts(student_user_id, definition_id, completed_at)` 索引进行学生级最新结果查询；实现前必须用 MySQL `EXPLAIN` 验证不扫全表。若实际查询计划无法命中索引，停止编码并单独评审最小索引迁移，不得临时修改既有 V35 迁移。 + +## 10. 权限、隐私与审计 + +### 10.1 权限矩阵 + +| 数据 | STUDENT | COMPANY | ADMIN | +|---|---|---|---| +| 本人完整 V36 结果与题目反馈 | 仅本人 | 禁止 | 禁止（V36 原有口径） | +| 候选评分 `ABILITY` 聚合分 | 本人 | 仅有岗位归属的候选评分卡 | 禁止（沿用现有评分接口） | +| 四维聚合分与有效期 | 本人单维评分详情 | 禁止 | 禁止 | +| 题目/答案键/评分规则/标签 | 禁止通过评分接口返回 | 禁止 | 禁止 | + +### 10.2 审计 + +V38 不对普通评分查询新增逐次审计，避免读取评分卡时产生审计噪声。现有评分治理申诉/回滚审计保持原样。 + +如内部结构无效需记录诊断日志，日志白名单仅为 `studentUserId`（内部日志）、`sourceResultId`、`failureKind`、`mappingRulesVersion` 和 `requestId`；禁止记录测评内容。不得将该诊断写入对企业可见的响应或 `audit_logs.details`。 + +## 11. 评分治理与申诉兼容 + +- 既有 `ABILITY` 申诉/评分回滚若可用，回滚仍然是按当前数据确定性重算，不恢复人工指定的旧能力分。 +- V38 不新增人工修改、豁免、补分或上传证明材料的入口。 +- 来源结果在回滚时已过期或无效，则重算为 `PENDING`；这是规则结果，不属于回滚失败。 +- V36 测评本身的题目、答案或判分争议不通过候选评分申诉接口处理，后续需单独定义测评申诉治理。 + +## 12. 接口与 OpenAPI 影响 + +本版不新增、删除或修改公网路径；既有候选评分 API 的顶层契约保持兼容： + +```text +GET /profile/me/candidate-scoring +GET /profile/me/candidate-scoring/dimensions/ABILITY +GET /profile/me/candidate-scoring/trend +GET /company/candidates/{applicationId}/scoring +``` + +因此静态和运行时 OpenAPI 均应继续为 **148 paths / 182 operations**。 + +学生的 `ABILITY` 单维详情可在既有通用 `subScores/reasons/dataSources` 容器中增加白名单字段；实现前须确认这些对象的现有 schema 允许兼容增加字段。若需要新增可见字段，必须同步 `openapi-rc.json`、`verify_openapi.py` 与联调文档，但不得改变公司端 schema。 + +## 13. 错误码 + +V38 不新增公网接口，正常的“无有效测评结果”属于 `ABILITY=PENDING`，不是 HTTP 错误。因此不新增 ErrorCode。 + +任何来源 JSON 异常、查询异常或规则版本无法识别都必须被隔离为 `PENDING`，并保留 200 的既有评分响应。数据库不可用等系统级故障仍按全局异常处理器既有语义处理，不伪造评分结果。 + +## 14. 测试计划 + +### 14.1 单元测试 + +- 开关关闭：不查询 V36 来源，`ABILITY=PENDING`，候选评分规则版本仍为 v0.1。 +- 无结果、仅过期结果、结构不完整结果、分数越界结果：均为 `PENDING`，无 500。 +- 有效结果：严格验证权重公式、两位小数 `HALF_UP`、`OK` 状态、来源版本。 +- 多份有效历史：选 `completed_at` 最新者，不选总分最高者；同时间用 attempt ID 稳定决胜。 +- 来源字段白名单：持久化 JSON 和 HTTP 响应均不含答卷 ID、题目、答案、答案键、分值、标签。 +- `computeAbility` 只触发一次来源查询；不得产生 N+1。 + +### 14.2 集成与 MockMvc 测试 + +- H2 MySQL 模式下完整 V36 有效结果 → 候选评分写入 `ABILITY` 快照；过期后重算同周期 `ABILITY=PENDING`。 +- V36 提交本身不写 `candidate_dimension_scores`；只有既有候选评分查询/重算写快照。 +- 学生单维详情可见聚合四维和有效期；公司端只见 `ABILITY` 总分/状态；COMPANY/ADMIN/匿名权限回归。 +- 并发 V36 提交与候选评分读取不出现半结果、500 或重复快照异常。 +- V32 排名和 V34 职业进度在开关关闭时字节级/字段级保持现有结果；开关开启时仅允许因 `ABILITY` 可计算带来的预期分数变化。 + +### 14.3 MySQL/Docker 黑盒 + +1. 启动真实 MySQL/Redis/RabbitMQ 和最新 JAR；确认 health 200、Flyway 仍止于 V36、OpenAPI 148/182。 +2. 使用独立学生账号完成一份 V36 测评，先验证提交后 `candidate_dimension_scores` 行数不变。 +3. 开关 `false` 调用候选评分：`ABILITY=PENDING`；再在隔离环境将开关设为 `true`，调用评分：`ABILITY=OK` 且总分符合公式。 +4. 核对 `sub_scores_json` 白名单；企业 API 不含四维、结果 ID、题目、答案、标签或评分规则。 +5. 将结果有效期置为过去时间（只在独立验收数据上操作），重算后验证 `ABILITY=PENDING`；历史 V36 结果仍可由本人读取。 +6. 创建两份符合 V36 重测规则的历史结果，验证取最新而不是最高；验证并发评分刷新无 500。 +7. 队列最终 `ready=0/unacked=0`；回归 V32 排名、V34 职业进度、V35 RIASEC、V36 能力结果、V37 风险概览。 + +## 15. 回滚与冻结门槛 + +### 15.1 回滚 + +| 情况 | 操作 | +|---|---| +| 映射分数不符合预期 | 设 `scoring.ability-assessment.enabled=false`，停止后续接入 | +| 需要恢复当前月评分 | 经批准后调用既有评分重算流程；不直接删表或手改快照 | +| 发现题库/测评结果质量问题 | 保持 V36 历史，关闭 V38 开关；不篡改历史题目或答案 | + +V38 不新增迁移，故不存在本模块 DDL 回滚。不得修改已执行的 V35/V36 Flyway 文件。 + +### 15.2 冻结条件 + +- 所有 V38 单元、集成、MockMvc 测试通过；全量 `mvn clean verify` 通过。 +- `python docs/verify_openapi.py` 通过且 OpenAPI 仍为 148/182。 +- 真实 MySQL/Docker 黑盒为 `FAIL=0`，关键项不得 SKIP。 +- 开关关闭和开启两条路径均通过；V36 主链路、V32/V34/V35/V37 回归通过。 +- 不泄露题目、答案、答案键、评分规则、标签、来源结果/答卷 ID；企业端仅有聚合能力分。 +- 未对 V35/V36 题库或既有 Flyway 做回写；没有未授权的业务数据删除或全量回填。 + +--- + +## 16. 已确认的编码授权边界 + +负责人已于 2026-09-04 确认以下边界，编码必须严格遵守： + +1. 开关开启时，允许 `ABILITY` 参与候选综合分，并允许其按既有评分口径影响 V32 同岗位排名。 +2. 仅在开关开启时，候选评分规则版本允许由 `candidate-scoring-v0.1` 升级为 `candidate-scoring-v0.2`。 +3. 学生单维评分详情可展示四维聚合分、权重和有效期；企业端始终只见 `ABILITY` 聚合分与状态。 +4. 本版采用无新 Flyway、无新公网接口的只读投影方案。 + +后续若要新增人工改分、企业端明细、V35/RIASEC 接入、`GROWTH` 映射、历史回填或任何公开接口，必须另行设计和授权，不得作为 V38 编码的附带改动。 diff --git a/docs/v39-job-recommendation-design.md b/docs/v39-job-recommendation-design.md new file mode 100644 index 0000000..cd5697c --- /dev/null +++ b/docs/v39-job-recommendation-design.md @@ -0,0 +1,454 @@ +# V39：测评结果驱动岗位推荐设计 + +> 状态：**编码完成，真实 MySQL/Docker 关键黑盒已通过，待 Git 检查点。** +> 功能版本：V39。 +> 当前基线：Flyway 迁移新增 `V37__job_recommendation_profiles.sql`；静态 OpenAPI 为 `154 paths / 190 operations`。 +> 文档用途：V39 第一版规则、接口、安全边界与验收口径的权威设计说明。 + +## 1. 目标与边界 + +### 1.1 目标 + +为学生提供“可解释、可复现、可关闭”的岗位推荐列表。推荐只使用学生已授权产生的偏好、V35 RIASEC 职业兴趣结果和 V36 四维能力结果，并结合企业为岗位维护的结构化推荐画像。 + +推荐的含义是“当前岗位与学生已知偏好的匹配程度”，不保证录用概率，不构成职业、心理或就业诊断。 + +### 1.2 第一版范围 + +- 仅 STUDENT 查看自己的推荐岗位。 +- 仅推荐状态为 `PUBLISHED` 且学生尚未投递的岗位。 +- 使用学生偏好、最新完成的 RIASEC 结果、最新有效的四维能力结果和岗位推荐画像。 +- 企业只能维护自己岗位的推荐画像；不能查询任何学生的测评明细、推荐分或推荐理由。 +- 返回有限、白名单化的推荐理由和缺口提示。 +- 规则实时计算；不保存学生级推荐历史、点击画像或行为画像。 + +### 1.3 明确不在本版范围 + +- 不使用 AI、大模型、简历文本向量或隐式行为画像。 +- 不自动投递、不替学生收藏、不发送推荐通知。 +- 不增加企业人才推荐或企业查看学生测评详情。 +- 不接入 V38 之外的 `GROWTH` 评分维度，不写 `candidate_dimension_scores`。 +- 不把 RIASEC 结果当作职业诊断，不根据测评结果拒绝学生投递。 +- 实现“我不感兴趣”持久化，以及推荐解释的有帮助/无帮助反馈；首版不将反馈用于模型训练。 + +## 2. 现状核查结论 + +| 已有能力 | 当前状态 | 对 V39 的影响 | +|---|---|---| +| 岗位搜索 | `/jobs` 已支持城市、薪资、用工类型、关键词和分页 | 可复用公开岗位视图和发布状态口径 | +| 单岗位匹配诊断 | `GET /jobs/{jobId}/match`，按学生偏好计算 | 只适合单岗位说明；内部会写审计，不应在推荐列表中逐岗位循环调用 | +| 学生偏好 | 城市、薪资、用工类型、行业、岗位类型、远程意愿 | 可作为硬过滤和软匹配数据 | +| V35 RIASEC | 最新完成结果可提供六维兴趣聚合分 | 可作为兴趣匹配输入；不读取答案和题目 | +| V36 四维能力 | 最新有效完成结果可提供四维聚合分和有效期 | 可作为能力适配输入；不依赖 V38 开关 | +| V38 评分接入 | ABILITY 可有限进入候选评分 | V39 直接读 V36 聚合结果，不读取候选评分快照，避免推荐随评分开关改变 | +| `jobs` 表 | 只有标题、描述、要求、城市、薪资、用工类型 | 缺少可靠的 RIASEC/能力要求字段，必须新增结构化岗位推荐画像 | + +## 3. 总体方案 + +### 3.1 方案选择 + +采用“**规则推荐 + 岗位结构化画像 + 实时只读计算**”方案。 + +```text +学生偏好 ─────────────┐ +V35 RIASEC 聚合结果 ──┼─> RecommendationService ─> 推荐岗位列表 + 理由/缺口 +V36 能力聚合结果 ─────┤ ↑ +岗位推荐画像 ─────────┘ └─ 仅查询 PUBLISHED、未投递岗位 +``` + +不能使用岗位标题、岗位描述或 `requirements` 进行关键词猜测来代替岗位画像：该做法不可解释、难以测试，也会把同义词、否定语句和描述质量差异误当成职业要求。 + +### 3.2 推荐画像的维护主体 + +企业在创建或维护岗位后，为本人岗位维护一份结构化推荐画像。画像只描述岗位，不包含学生数据；它包含： + +- 行业代码与岗位族代码，用于与学生偏好精确比较； +- RIASEC 六维权重，用于表达该岗位偏好的兴趣侧重点； +- 四维能力期望值，用于表达完成该岗位所需的基础能力水平； +- 是否启用测评推荐。 + +企业画像是“岗位推荐参考”，不是招聘门槛。企业仍需通过原有岗位说明、投递、面试与 Offer 流程进行评估。 + +### 3.3 平台受控分类与审核流 + +行业代码和岗位族代码采用“**平台维护、企业选择、不得自由输入**”的两级受控字典： + +```text +行业大类（industry） + └─ 岗位族（job family） + └─ 企业保留自由填写的岗位标题（jobs.title） +``` + +该选择参考了主流招聘产品按大类、细分职类组织职位浏览和筛选的做法：分类用于匹配与检索，岗位标题保留企业对具体职位的表达。第一版字典由产品负责人确定编码、后端随 Flyway 种子发布；ADMIN 只审核企业的岗位画像，不可在线任意新增分类。分类变更必须通过代码评审、版本化种子和兼容迁移完成。 + +建议首批受控岗位族覆盖当前产品最常见的求职方向：互联网技术、产品、设计、运营/市场、销售/客户成功、人力/行政/财务/法务、生产制造/工程、教育/医疗、供应链/物流、零售/生活服务和综合管理。每个岗位族必须隶属唯一行业大类，编码一经发布不得重用。 + +企业首次保存或修改已审核画像后，画像进入 `PENDING_REVIEW`；只有 `APPROVED` 且 `enabled=true` 的画像可用于个性化推荐。ADMIN 使用固定理由码审批或驳回。企业主动停用画像可立即生效，不需要等待审核。 + +### 3.4 时间一致性 + +一次推荐请求在服务入口生成唯一的 `capturedNow`，V36 结果有效性、规则版本和返回时间均使用该时间点。不得在同一请求内多次调用 `now()` 导致结果边界不一致。 + +## 4. 数据来源与有效性 + +| 来源 | 选择规则 | 无数据/异常处理 | 禁止读取 | +|---|---|---|---| +| 学生偏好 | 本人 `student_preferences`，至多一条 | 缺字段时该偏好项不计入分母 | 其他学生偏好 | +| RIASEC | `HOLLAND_RIASEC` 类型、`COMPLETED`、按完成时间倒序和答卷 ID 倒序取一条 | JSON 损坏、缺维、分数越界时兴趣信号不可用 | 原始答案、题目、questionCode | +| 四维能力 | `WORKPLACE_ABILITY`、`COMPLETED`、`valid_until > capturedNow`、按完成时间倒序和答卷 ID 倒序取一条 | 过期、缺维、不是 24/24 完成时能力信号不可用 | 原始答案、题目反馈、答案键、评分规则 | +| 岗位画像 | `job_recommendation_profiles.enabled=true`、`review_status=APPROVED` 且关联 `PUBLISHED` 岗位 | 无画像或待审核画像不宣称“测评匹配”；仅进入兜底列表 | 企业内部非公开数据 | +| 投递记录 | 当前学生与岗位的任何已有投递记录 | 已投递岗位从推荐候选中排除 | 其他学生投递数据 | +| 推荐反馈 | 本人对岗位的有效 `NOT_INTERESTED` 反馈 | 仅排除本人明确不感兴趣的岗位；理由反馈不改变排序 | 其他学生反馈 | + +RIASEC 只使用六维聚合百分比；四维能力只使用 LOGIC、COMMUNICATION、EXECUTION、LEARNING 四个聚合分。两类结果均须通过服务端结构校验后才可参与排序。 + +## 5. 推荐候选、过滤与排序 + +### 5.1 硬过滤 + +推荐候选必须同时满足： + +1. 岗位状态为 `PUBLISHED`； +2. 当前学生不存在该岗位的任何投递记录，避免推荐一个无法再次投递的岗位； +3. 若学生已设置期望城市，岗位城市必须命中； +4. 若学生已设置期望薪资下限且岗位有薪资上限，学生下限不得高于岗位上限； +5. 当前学生没有对该岗位提交有效的 `NOT_INTERESTED` 反馈； +6. 岗位推荐画像存在、已启用且审核状态为 `APPROVED` 时，才进入“个性化推荐”排序。 + +城市和薪资口径与现有单岗位匹配诊断保持一致。用工类型、行业和岗位族是软信号，不作为拒绝或隐藏条件。 + +### 5.2 三类软信号 + +| 信号 | 默认权重 | 计算方式 | +|---|---:|---| +| 偏好适配 `P` | 40% | 城市 30、用工类型 20、薪资 20、行业 15、岗位族 15；只对学生已设置且岗位有对应结构化值的字段纳入分母 | +| 兴趣适配 `I` | 35% | `Σ(RIASEC学生维度分 × 岗位该维权重) / Σ岗位兴趣权重` | +| 能力适配 `A` | 25% | 对每个已配置能力期望值：学生分数大于等于期望值记 100，否则 `学生分 / 期望分 × 100`；再取已配置维度平均值 | + +总分公式： + +```text +recommendationScore = + (P × 40 + I × 35 + A × 25) / 可用信号权重之和 +``` + +结果保留两位小数，使用 `HALF_UP`。缺失或无效信号不记为 0，而是从分母中移除；这样不会因为学生尚未完成某项测评而被无理由降分。 + +如果偏好、兴趣、能力三者都不可用，则该岗位不能标为个性化推荐。 + +### 5.3 排序与兜底 + +个性化岗位按以下顺序排序： + +1. `recommendationScore DESC`； +2. `published_at DESC`； +3. `job_id DESC`。 + +若没有任何可用个性化结果，接口返回 `mode=FALLBACK` 的公开岗位兜底列表，只按发布时间排序，`recommendationScore=null`，并明确说明“完善偏好或完成测评后可获得个性化推荐”。兜底列表绝不伪装为个性化结果。 + +### 5.4 理由与缺口 + +每个个性化岗位最多返回 3 条理由和 2 条建议，均由固定白名单模板生成，例如： + +- `PREFERENCE_CITY_MATCH`：工作城市符合你的偏好； +- `PREFERENCE_SALARY_MATCH`：薪资范围满足你的期望； +- `RIASEC_INTEREST_MATCH`：职业兴趣与岗位侧重点较匹配； +- `ABILITY_STRENGTH_MATCH`：你的能力表现满足该岗位的主要侧重点； +- `ABILITY_GAP`：可优先提升与岗位相关的某项能力； +- `PREFERENCE_GAP`：用工类型或岗位族与当前偏好存在差异。 + +不返回 RIASEC 原始六维向量、能力答卷 ID、结果 ID、题目、答案、答案键、评分规则或企业配置原文。 + +## 6. 数据模型与 Flyway（建议，待确认） + +### 6.1 迁移 + +当前最新迁移为 V36；建议新增： + +```text +V37__job_recommendation_profiles.sql +``` + +功能版本仍为 V39。该单一迁移创建岗位画像、受控分类和学生反馈三张相关表，不修改 V1–V36 的语义。 + +### 6.2 `job_recommendation_taxonomies` + +平台受控字典表，随 `job-taxonomy-v0.1` 种子初始化。 + +| 字段 | 说明 | +|---|---| +| `code` | 不可重用的稳定编码，主键 | +| `parent_code` | 岗位族指向所属行业大类；行业大类为 `NULL` | +| `taxonomy_type` | `INDUSTRY` 或 `JOB_FAMILY` | +| `display_name` | 前端展示名 | +| `active` | 是否仍允许企业新选用 | +| `sort_order`、`catalog_version` | 展示顺序与目录版本 | + +服务端必须校验 `industry_code` 是有效行业大类、`job_family_code` 是该行业下有效岗位族；企业不得传任意文本或跨层级组合。 + +### 6.3 `job_recommendation_profiles` + +| 字段 | 说明 | +|---|---| +| `id` | 主键 | +| `job_id` | 外键至 `jobs.id`，唯一，一岗一份画像 | +| `enabled` | 是否参与个性化推荐，默认 `false` | +| `review_status` | `PENDING_REVIEW`、`APPROVED`、`REJECTED`、`DISABLED` | +| `industry_code` | 必填、受控行业大类编码 | +| `job_family_code` | 必填、受控岗位族编码 | +| `riasec_r` 至 `riasec_c` | 六维兴趣权重，`0..100`，至少一个非零才可启用兴趣信号 | +| `logic_requirement` 等四列 | 四维能力期望值，`0..100`；`NULL` 表示该维不参与能力适配 | +| `reviewed_by_user_id`、`reviewed_at` | 最近一次审核人和审核时间，仅内部使用 | +| `review_reason_code` | 审核/驳回的固定理由码，不存自由文本 | +| `profile_version` | 乐观锁版本 | +| `created_at`、`updated_at` | 审计时间 | + +约束与索引： + +- `UNIQUE(job_id)`； +- `FOREIGN KEY(job_id) REFERENCES jobs(id)`； +- 所有权重和能力期望必须在 `0..100`； +- 建立 `(enabled, review_status, job_id)` 索引，支撑可推荐画像的候选岗位查询； +- 使用 JPA `@Version` 和 `expectedVersion` 防止企业并发覆盖配置。 + +### 6.4 `student_job_recommendation_feedback` + +仅保存学生主动提交的最小化反馈，不保存自动点击画像。 + +| 字段 | 说明 | +|---|---| +| `id` | 主键 | +| `student_user_id`、`job_id` | 反馈所属学生和岗位 | +| `feedback_type` | `NOT_INTERESTED`、`REASON_HELPFUL`、`REASON_NOT_HELPFUL` | +| `reason_code` | 可选固定理由码；不得提交自由文本、测评内容或个人信息 | +| `feedback_key` | `student + job + type + reasonCode` 组成的非空去重键 | +| `status` | `ACTIVE` 或 `REVOKED`；撤销不物理删除 | +| `idempotency_key` | 同一学生请求幂等键唯一；同键异体返回冲突 | +| `created_at`、`updated_at`、`version` | 审计时间与乐观锁 | + +`NOT_INTERESTED` 有效时排除该岗位；理由是否“有帮助”只用于后续人工优化规则，不自动改变学生分、岗位分或排序公式。 + +## 7. API 设计（建议，待确认） + +### 7.1 学生推荐列表 + +```http +GET /profile/me/job-recommendations?page=0&size=20 +``` + +权限：仅 STUDENT 本人。`page` 从 0 开始，`size` 范围 1–50。 + +响应核心字段： + +```json +{ + "mode": "PERSONALIZED", + "rulesVersion": "job-recommendation-v0.1", + "items": [ + { + "job": { "id": 101, "title": "后端开发工程师", "city": "合肥" }, + "recommendationScore": 82.50, + "reasons": ["PREFERENCE_CITY_MATCH", "RIASEC_INTEREST_MATCH"], + "suggestions": ["ABILITY_GAP"], + "availableSignals": ["PREFERENCE", "RIASEC", "ABILITY"] + } + ], + "page": 0, + "size": 20, + "total": 1, + "totalPages": 1, + "generatedAt": "2026-09-04T12:00:00" +} +``` + +岗位详情继续复用既有 `GET /jobs/{jobId}`；如需查看单个岗位的偏好诊断，继续复用既有 `GET /jobs/{jobId}/match`。 + +### 7.2 企业岗位画像查询与更新 + +```http +GET /companies/me/jobs/{jobId}/recommendation-profile +PUT /companies/me/jobs/{jobId}/recommendation-profile +``` + +仅岗位所属 COMPANY 可查询和更新。更新请求需带 `expectedVersion`，并仅接受固定字段：`enabled`、`industryCode`、`jobFamilyCode`、`riasecWeights`、`abilityRequirements`。新建/更新后进入 `PENDING_REVIEW`；只有企业主动 `enabled=false` 时可转为 `DISABLED`。 + +不提供 DELETE；企业通过 `enabled=false` 停用画像，保留配置和审计链路。 + +### 7.3 受控分类、学生反馈与 ADMIN 审核 + +```http +GET /job-recommendation-taxonomies +POST /profile/me/job-recommendations/{jobId}/feedback +DELETE /profile/me/job-recommendations/{jobId}/feedback +GET /admin/job-recommendation-profiles?page=0&size=20&status=PENDING_REVIEW +POST /admin/job-recommendation-profiles/{jobId}/decision +``` + +分类接口只返回 `code`、`parentCode`、`type`、`displayName`、`sortOrder` 和 `catalogVersion`；无需登录即可让岗位发布和岗位搜索复用同一字典。 + +反馈创建必须携带 `idempotencyKey`。`NOT_INTERESTED` 的撤销只把对应记录改为 `REVOKED`；不删除审计记录。ADMIN 审核请求只接受 `APPROVE` 或 `REJECT` 与固定 `reasonCode`，不接受自由文本。 + +### 7.4 OpenAPI 预估 + +新增 6 个路径、8 个 operation： + +```text +148 paths / 182 operations → 154 paths / 190 operations +``` + +编码时必须以运行时 OpenAPI 为准更新 `docs/openapi-rc.json` 与 `docs/verify_openapi.py`，不允许仅修改静态计数。 + +## 8. 权限、隐私与审计 + +| 操作 | STUDENT | COMPANY | ADMIN | 未登录 | +|---|---:|---:|---:|---:| +| 查看本人推荐列表 | 200 | 403/2002 | 403/2002 | 401 | +| 提交/撤销本人推荐反馈 | 200 | 403/2002 | 403/2002 | 401 | +| 查看本人岗位匹配诊断 | 既有行为 | 既有行为 | 既有行为 | 既有行为 | +| 查看自己岗位画像 | 403/2002 | 仅所属岗位 200 | 403/2002 | 401 | +| 更新自己岗位画像 | 403/2002 | 仅所属岗位 200，进入待审核 | 403/2002 | 401 | +| 查询受控分类 | 200 | 200 | 200 | 200 | +| 查看待审核岗位画像 | 403/2002 | 403/2002 | 200 | 401 | +| 审批岗位画像 | 403/2002 | 403/2002 | 200 | 401 | + +审计动作建议： + +- `JOB_RECOMMENDATION_PROFILE_UPDATED`：仅记录 `jobId`、画像版本、是否启用、请求 ID 和时间； +- `JOB_RECOMMENDATION_PROFILE_DECIDED`：仅记录 `jobId`、决定、固定理由码、画像版本、请求 ID 和时间； +- `JOB_RECOMMENDATION_FEEDBACK_CREATED` / `JOB_RECOMMENDATION_FEEDBACK_REVOKED`：仅记录 `jobId`、反馈类型、固定理由码、请求 ID 和时间； +- `JOB_RECOMMENDATIONS_VIEWED`：可选，仅记录返回数量、规则版本和请求 ID；不得记录完整排序、测评分、题目、答案、手机、邮箱、IP、User-Agent 或 token。 + +公司端绝不获得学生的 RIASEC、四维能力、候选评分、推荐分、推荐理由或缺口。学生端也不获得企业配置的完整权重和能力期望值。 + +## 9. 模块边界、性能与并发 + +### 9.1 建议模块划分 + +- `JobRecommendationProfile` / Repository：岗位画像配置； +- `JobRecommendationTaxonomy` / Repository：平台受控行业与岗位族字典； +- `StudentJobRecommendationFeedback` / Repository：学生显式反馈及撤销状态； +- `JobRecommendationProfileService`：企业画像读取、所有权校验和乐观锁更新； +- `JobRecommendationAdminService`：待审核画像分页和固定决定流转； +- `StudentRecommendationSource`：一次读取学生偏好、最新有效 V35/V36 聚合结果； +- `JobRecommendationCalculator`：纯函数，执行结构校验、分数公式和理由模板； +- `JobRecommendationService`：过滤、分页、排序和响应白名单； +- `JobRecommendationController`：仅从 `SecurityContext` 获取当前用户 ID。 + +### 9.2 N+1 防护 + +推荐列表不得对每个岗位调用现有 `MatchService.diagnose()`：该方法会逐岗位读数据并写审计，既会造成 N+1，也会污染审计。 + +推荐请求的目标查询上限为固定次数： + +1. 学生偏好一次； +2. 最新 RIASEC 结果一次； +3. 最新有效四维能力结果一次； +4. 分页候选岗位及画像一次； +5. 当前学生已投递岗位 ID 集合一次； +6. 当前学生有效 `NOT_INTERESTED` 岗位 ID 集合一次； +7. 页面企业信息批量加载一次。 + +岗位排序应使用单条参数化 SQL/JPA 查询按推荐表达式完成，或在有明确候选上限时使用固定批量加载；禁止“每岗位再查画像、公司、投递或测评”的循环查询。编码后必须用 Hibernate/JDBC Spy 断言查询次数不随页面 items 数线性增加。 + +### 9.3 并发 + +- 推荐查询只读、无幂等键要求； +- 企业更新画像、学生反馈撤销和 ADMIN 审核均使用 `expectedVersion` + `@Version`，冲突返回 409； +- 岗位关闭、画像停用或学生完成投递后，下一次查询自然不再返回该岗位；不缓存旧结果。 + +## 10. 错误码（建议） + +建议使用新段 `10001–10009`： + +| 错误码 | HTTP | 含义 | +|---|---:|---| +| `10001` | 404 | `JOB_RECOMMENDATION_PROFILE_NOT_FOUND` | +| `10002` | 400 | `JOB_RECOMMENDATION_PROFILE_INVALID` | +| `10003` | 409 | `JOB_RECOMMENDATION_PROFILE_CONCURRENT_UPDATE` | +| `10004` | 400 | `JOB_RECOMMENDATION_INVALID_QUERY` | +| `10005` | 400 | `JOB_RECOMMENDATION_TAXONOMY_INVALID` | +| `10006` | 409 | `JOB_RECOMMENDATION_FEEDBACK_CONCURRENT_UPDATE` | +| `10007` | 409 | `JOB_RECOMMENDATION_FEEDBACK_IDEMPOTENCY_CONFLICT` | +| `10008` | 404 | `JOB_RECOMMENDATION_FEEDBACK_NOT_FOUND` | +| `10009` | 409 | `JOB_RECOMMENDATION_PROFILE_INVALID_REVIEW_STATE` | + +现有岗位不存在、岗位归属不匹配、未登录和角色越权继续使用既有错误码，不重复造码。 + +## 11. 功能开关、兼容与回滚 + +建议新增默认关闭的开关： + +```yaml +recommendation: + assessment: + enabled: ${RECOMMENDATION_ASSESSMENT_ENABLED:false} +``` + +开关关闭时，学生推荐接口只返回 `FALLBACK` 公开岗位列表，不查询测评结果、不生成个性化分；企业仍可维护岗位画像，为灰度开启做准备。 + +开关开启时规则版本为 `job-recommendation-v0.1`。回滚只需关闭开关；画像数据保留，不删除岗位、测评、投递、评分或审计数据。 + +V39 不改变： + +- V35/V36 的题库、答题、重测、有效期和审计语义； +- V38 的候选评分开关、ABILITY 快照和 V32 排名口径； +- 既有 `/jobs` 搜索、`/jobs/{jobId}/match`、投递和收藏接口语义。 + +## 12. 测试与验收计划 + +### 12.1 单元测试 + +- RIASEC 与四维能力来源选择：最新优先、过期回退、结构异常不抛 500； +- 公式：单信号、双信号、三信号、缺失重归一化、`HALF_UP`、稳定排序； +- 硬过滤：未发布、已投递、城市不符、薪资不符； +- 理由/建议白名单和最大数量； +- 受控分类父子校验、画像字段边界、启用条件和审核状态机； +- 反馈幂等、撤销、不感兴趣过滤和理由反馈不改变推荐分； +- 画像、反馈和审核的乐观锁冲突。 + +### 12.2 MockMvc 与持久化测试 + +- STUDENT/COMPANY/ADMIN/未登录权限矩阵； +- 企业只能读写自己的岗位画像，更新后必须进入待审核状态； +- ADMIN 只能审核、不可修改企业画像内容；非 ADMIN 审核返回 403； +- 分类接口仅返回受控字典；自由行业/岗位族编码返回 400； +- 推荐响应不含测评题目、答案、答案键、结果 ID、原始画像权重； +- 无画像/无测评返回 `FALLBACK`，不伪造个性化分； +- 分页参数、空列表、推荐总数和稳定排序； +- 查询次数固定，禁止推荐列表 N+1； +- 不写 `candidate_dimension_scores`、不改变 V32 排名。 + +### 12.3 MySQL/Docker 黑盒 + +1. 执行 V37 迁移，校验三张表、唯一约束、外键、范围约束、分类种子和索引； +2. 企业创建/更新自己岗位画像，其他企业返回 403，ADMIN 审批后才可用于推荐； +3. 学生完成 RIASEC 和能力测评后，推荐分与理由符合固定 fixture； +4. 验证历史高分、最新低分和能力过期三种选择口径； +5. 开关关闭返回 `FALLBACK`，开启后才产生 `PERSONALIZED`； +6. 已投递、明确不感兴趣、关闭、城市/薪资不符岗位不会进入个性化列表； +7. 反馈重复提交、同键重放、撤销重试和审核并发均满足预期业务码； +8. 响应和审计不泄露题目、答案、评分规则、结果 ID 或凭据； +9. RabbitMQ 队列终态正常，并回归 V34–V38 关键接口。 + +冻结条件：全量 `mvn clean verify`、运行时/静态 OpenAPI 对账、真实 MySQL/Docker 黑盒关键项全部 PASS，且 FAIL=0。 + +## 13. 已确认决策与编码前最后口径 + +负责人已确认： + +1. 新增岗位推荐画像与 Flyway `V37__job_recommendation_profiles.sql`； +2. 接受默认排序权重：偏好 40%、RIASEC 35%、能力 25%； +3. 无结构化岗位画像时仅返回 `FALLBACK`，不伪造测评推荐； +4. 任何已有投递的岗位均不再推荐； +5. 默认关闭 `recommendation.assessment.enabled`，支持灰度； +6. 第一版加入学生“不感兴趣”持久化和推荐理由反馈； +7. 按负责人第 8 项“是”处理：第一版需要 ADMIN 审核企业岗位画像。 + +基于第 6、7 项，原先的 3 个 operation 扩展为 8 个 operation，且迁移包含三个相关表。这是已确认产品范围变化，不是无关扩张。 + +编码开始前只需最终确认以下两项具体口径： + +1. 受控分类采用“平台种子维护、企业只能选择、不允许自由输入”，并按 `job-taxonomy-v0.1` 首批目录落库； +2. ADMIN 审核语义确为“企业提交/更新画像后进入 `PENDING_REVIEW`，审核通过才参与推荐”。 + +若以上两项确认，即可进入 V39 编码；在此之前不得创建迁移、Controller 或前端接口实现。 diff --git a/docs/v40-company-review-management-design.md b/docs/v40-company-review-management-design.md new file mode 100644 index 0000000..d4d8680 --- /dev/null +++ b/docs/v40-company-review-management-design.md @@ -0,0 +1,357 @@ +# V40 企业评价管理与官方回复：详细设计 + +> 状态：实现已完成，专项/全量自动化测试、`mvn clean verify` 与真实 MySQL/Docker 黑盒均已通过；待建立 Git 检查点。 +> +> 本文定义并约束 V40 的后端交付边界。实现不会修改已有 V17/V18 的学生评价、管理员评价审核与防刷语义；不会新增测评、评分、推荐接口。 + +## 1. 目标、范围与现状 + +### 1.1 交付目标 + +让已认证企业能够： + +1. 查看**自己名下岗位**的评价及处理状态； +2. 对每条评价提交一条官方回复； +3. 在回复被拦截或管理员驳回后，查看安全的处理状态并修订后重新提交； +4. 让公众仅在评价和官方回复都满足公开条件时看到该回复。 + +企业的“管理”在 V40 中是查看、筛选、回复和查看回复审核状态；**不是**删除、隐藏、改写或自行下架学生评价。企业针对评价真实性的申诉、投诉工单、运营统计和通知策略不纳入本版，留给后续独立模块。 + +### 1.2 已有能力与约束 + +| 项目 | 当前事实 | V40 处理 | +| --- | --- | --- | +| 学生岗位评价 | `job_reviews`，同一学生对同一岗位唯一；已有评分、标签、八维评分 | 复用，不重建 | +| 评价审核 | V18：`AUTO_APPROVED`、`PENDING`、`APPROVED`、`REJECTED`，管理员已有评价审核接口 | 保持原链路；新增“回复审核”并与评价审核分开 | +| 企业权限 | 角色为 `COMPANY`；岗位归属可按公司 owner 与岗位 companyId 校验 | 所有企业接口均由 JWT 身份和岗位归属决定 | +| 审计 | 已有 `audit_logs` | 对回复生命周期写白名单审计 | +| 当前迁移 | 最新为 `V37__job_recommendation_profiles.sql` | V40 若编码，新增 `V38__company_review_replies.sql` | +| 当前 OpenAPI 基线 | V39 后为 154 paths / 190 operations | 预计增至 159 paths / 196 operations，编码后实测为准 | + +### 1.3 明确不做 + +- 不新增学生写评价、改评价、删评价接口； +- 不让企业删除、隐藏、编辑评分或审核学生评价； +- 不把评价人 `studentUserId`、手机号、邮箱、IP、User-Agent、内容哈希、风控分或内部原因返回给企业； +- 不新增企业查看测评、候选人隐私数据或候选评分明细的能力； +- 不接入 AI 自动生成回复，不声称现有确定性规则为 AI； +- 不做评价申诉/争议工单、回复点赞、企业客服工单、通知推送或数据看板； +- 不改 V35–V39 迁移及语义，不写 `candidate_dimension_scores`。 + +## 2. 产品规则与关键决策 + +### 2.1 不可变规则 + +1. 评价的作者始终是学生；企业对评价没有写、删、隐藏权限。 +2. 企业只能操作其本人拥有公司下的岗位评价；跨公司访问统一返回 `403/2002`，不通过“是否存在”泄露其他公司数据。 +3. 每条评价最多存在一条当前官方回复，且回复归属由评价所在岗位的公司确定，客户端不得传 `companyId`、`jobId` 或评价作者 ID 来决定归属。 +4. 一条公开评价只在官方回复为 `AUTO_APPROVED` 或 `APPROVED` 时返回 `officialReply`。`PENDING`、`REJECTED` 及内部审核信息绝不出现在公开接口。 +5. 企业不可删除官方回复。被 `APPROVED` 或 `AUTO_APPROVED` 的回复不可编辑；被 `REJECTED` 的回复可使用乐观锁修订并重新进入预审。 + +### 2.2 回复状态机 + +```text +无回复 + └─ 企业创建 ─→ AUTO_APPROVED ───────────────→ 公众可见（终态） + 或 + PENDING ── 管理员同意 ───────→ APPROVED → 公众可见（终态） + └─ 管理员驳回 ─────→ REJECTED + └─ 企业修订并重提 ─→ AUTO_APPROVED / PENDING +``` + +- 预审无风险：`AUTO_APPROVED`，可随公开评价直接展示。 +- 命中敏感词、联系方式、URL、异常重复字符等已有确定性规则：`PENDING`，仅管理员可审核。 +- `PENDING` 只能由 `ADMIN` 变更为 `APPROVED` 或 `REJECTED`。 +- `REJECTED` 的公司可提交修订版本；版本号递增、审核痕迹保留。 +- `AUTO_APPROVED` 与 `APPROVED` 为对外稳定文本。若未来需要更正，应另做“公开回复修订/版本化”需求，不能在 V40 中通过覆盖原文实现。 + +### 2.3 公开身份脱敏（V40 必做修正） + +现有 `JobReviewService.toView(...)` 会在公开岗位评价载荷中输出 `studentUserId`。该字段会使企业或任意访客将评价与学生内部主键关联，不满足“评价对对方脱敏”的边界。 + +V40 编码必须将公开评价 DTO 改为白名单响应，移除 `studentUserId`，使用固定的 `reviewerLabel: "匿名求职者"`（或不返回该字段）。学生本人视图可保留“是否为我创建”的布尔信息，但不得把任何学生 ID 交给企业、公众或其他学生。此项是对已有公开契约的隐私修复；前端必须在联调时同步移除对 `studentUserId` 的依赖。 + +## 3. 数据模型与 Flyway + +### 3.1 迁移 + +新增 `V38__company_review_replies.sql`。不改已执行的 V1–V37，也不通过 `ddl-auto` 补表。 + +### 3.2 `company_review_replies` + +| 列 | 类型/约束 | 说明 | +| --- | --- | --- | +| `id` | BIGINT PK | 回复 ID | +| `review_id` | BIGINT NOT NULL, UNIQUE, FK → `job_reviews(id)` ON DELETE CASCADE | 一条评价仅一个当前官方回复 | +| `company_id` | BIGINT NOT NULL, FK → `companies(id)` | 由服务端从岗位归属推导 | +| `content` | VARCHAR(500) NOT NULL | 官方回复正文，1–500 字符 | +| `moderation_status` | VARCHAR(20) NOT NULL | `AUTO_APPROVED` / `PENDING` / `APPROVED` / `REJECTED` | +| `moderation_reason` | VARCHAR(500) NULL | 内部安全原因码 JSON；不公开给企业或公众 | +| `moderation_score` | DECIMAL(5,2) NULL | 内部风控分，不公开 | +| `risk_level` | VARCHAR(20) NULL | 内部风险等级，不公开 | +| `reviewed_by_user_id` | BIGINT NULL FK → `users(id)` | 管理员审核人 | +| `reviewed_at` | DATETIME NULL | 最后一次管理员审核时间 | +| `version` | BIGINT NOT NULL DEFAULT 0 | JPA `@Version`；企业修订携带 `expectedVersion` | +| `created_at` / `updated_at` | DATETIME | 审计时间 | + +约束与索引： + +- `UNIQUE(review_id)`； +- `CHECK(moderation_status IN ('AUTO_APPROVED','PENDING','APPROVED','REJECTED'))`； +- `INDEX(company_id, moderation_status, updated_at)` 支撑企业列表； +- `INDEX(moderation_status, created_at)` 支撑管理员待审列表。 + +### 3.3 `company_review_reply_history` + +保留回复生命周期而非覆盖历史。 + +| 列 | 类型/约束 | 说明 | +| --- | --- | --- | +| `id` | BIGINT PK | 历史记录 ID | +| `reply_id` | BIGINT NOT NULL FK → reply ON DELETE CASCADE | 对应回复 | +| `action` | VARCHAR(30) NOT NULL | `CREATED`、`AUTO_APPROVED`、`PENDING`、`RESUBMITTED`、`APPROVED`、`REJECTED` | +| `actor_user_id` | BIGINT NULL | 操作者；管理端可审计，企业/公众不返回 | +| `reason_codes` | VARCHAR(500) NULL | 安全原因码，不含敏感词原文 | +| `human_reason` | VARCHAR(500) NULL | 管理员驳回说明，仅向该公司展示，禁止包含评价人身份信息 | +| `created_at` | DATETIME NOT NULL | 时间 | + +索引：`INDEX(reply_id, created_at)`。历史表不保存正文副本、IP、UA、学生 ID、题目或候选人数据。 + +### 3.4 审计日志 + +写入既有 `audit_logs`，详情严格白名单： + +```json +{ + "reviewId": 120, + "replyId": 42, + "jobId": 9, + "status": "PENDING", + "requestId": "..." +} +``` + +动作：`COMPANY_REVIEW_REPLY_CREATED`、`COMPANY_REVIEW_REPLY_RESUBMITTED`、`REVIEW_REPLY_AUTO_APPROVED`、`REVIEW_REPLY_APPROVED`、`REVIEW_REPLY_REJECTED`。详情不得包含正文、评价作者、手机号、邮箱、IP、UA、哈希、token 或审核规则原文。 + +## 4. 接口契约 + +所有身份均从 `SecurityContext` / JWT subject 获取，不接收 `userId`、`companyId`、`studentUserId` 等身份参数。统一响应为既有 `ApiResponse{code,message,data,requestId,timestamp}`；分页 `page` 从 0 开始、`size` 范围 1–50。 + +### 4.1 企业端（仅 `COMPANY`） + +| 方法 | 路径 | 说明 | +| --- | --- | --- | +| GET | `/companies/me/job-reviews` | 分页查看本人公司岗位评价；支持 `jobId`、`rating`、`replyStatus`、`createdFrom`、`createdTo` 筛选 | +| GET | `/companies/me/job-reviews/{reviewId}` | 查看一条本人公司岗位评价及本人官方回复状态 | +| POST | `/companies/me/job-reviews/{reviewId}/reply` | 创建唯一官方回复；请求需 `content`、`idempotencyKey` | +| PUT | `/companies/me/job-reviews/{reviewId}/reply` | 仅允许修订 `REJECTED` 回复；请求需 `content`、`expectedVersion` | + +企业列表/详情最小响应： + +```json +{ + "reviewId": 120, + "job": { "id": 9, "title": "后端工程师" }, + "rating": 4, + "content": "岗位描述较清晰。", + "tags": ["成长空间"], + "dimensionScores": { "SALARY": 4, "WORK_LIFE_BALANCE": 3 }, + "reviewCreatedAt": "2026-09-04T10:00:00", + "reply": { + "id": 42, + "content": "感谢反馈，我们会继续优化沟通。", + "status": "PENDING", + "version": 0, + "updatedAt": "2026-09-04T10:05:00", + "rejectionReason": null + } +} +``` + +禁止返回：`studentUserId`、评价作者显示名、手机号、邮箱、IP、UA、内容哈希、审核分、评价审核内部原因、回复预审内部原因、管理员 ID。 + +`idempotencyKey` 必须为 UUID、最多 64 字符。同键同评价同正文返回已有回复；同键不同评价或正文返回 `409/10106`。创建时已有回复：`PENDING` / `AUTO_APPROVED` / `APPROVED` 返回 `409/10102`；`REJECTED` 必须走 PUT 重提。 + +### 4.2 管理员端（仅 `ADMIN`） + +| 方法 | 路径 | 说明 | +| --- | --- | --- | +| GET | `/admin/review-replies/pending` | 分页查看 `PENDING` 官方回复；可按 `companyId`、`jobId`、`riskLevel`、时间筛选 | +| POST | `/admin/review-replies/{replyId}/decision` | `APPROVE` / `REJECT`；仅 `PENDING` 可决策；驳回时 `reason` 必填，1–500 字符 | + +管理员响应可看安全原因码、风险等级、岗位/公司信息与回复正文，用于审核；仍不得返回评价学生的联系电话、邮箱、IP/UA 明文或密码/JWT。管理员决策重复提交或非 `PENDING` 状态返回冲突。 + +### 4.3 现有公开评价接口的兼容扩展 + +既有以下接口路径不新增操作： + +- `GET /jobs/{jobId}/reviews` +- `GET /jobs/{jobId}/reviews/{reviewId}` + +每条公开评价可新增可选 `officialReply`： + +```json +{ + "content": "感谢反馈。", + "repliedAt": "2026-09-04T10:05:00" +} +``` + +仅当评价本身为 `PUBLISHED` 且评价审核状态为 `AUTO_APPROVED` / `APPROVED`，并且回复为 `AUTO_APPROVED` / `APPROVED` 时出现。该对象没有 `replyId`、`companyId`、审核人、状态、原因码和版本字段。无公开回复时字段省略或为 `null`，前端须兼容两种情况。 + +### 4.4 权限矩阵 + +| 行为 | STUDENT | COMPANY（所属） | COMPANY（非所属） | ADMIN | 匿名 | +| --- | --- | --- | --- | --- | --- | +| 公开评价/公开回复 | 可读 | 可读 | 可读 | 可读 | 可读 | +| 企业评价管理列表/详情 | 403/2002 | 可读 | 403/2002 | 403/2002 | 401 | +| 创建/修订官方回复 | 403/2002 | 可写 | 403/2002 | 403/2002 | 401 | +| 待审官方回复/决策 | 403/2002 | 403/2002 | 403/2002 | 可读/可决策 | 401 | +| 删除/隐藏学生评价 | 不新增该权限 | 永不允许 | 永不允许 | 继续沿用既有审核而非删除 | 不适用 | + +## 5. 服务、查询与一致性设计 + +### 5.1 推荐组件 + +- `CompanyReviewManagementService`：企业列表、详情、归属校验； +- `CompanyReviewReplyService`：创建、预审、修订、状态机、审计； +- `AdminReviewReplyService`：待审列表与管理员决策； +- `CompanyReviewReplyModerationService`：复用现有确定性文本安全规则的公共部分，不复制 Controller 中的正则或把回复伪称为 AI 审核； +- `CompanyReviewReply`、`CompanyReviewReplyHistory` 及对应 Repository/DTO/Controller。 + +### 5.2 企业归属校验 + +服务端按当前用户找到企业，再由 `review.jobId → job.companyId` 比对。所有按 `reviewId` 的企业操作先检查岗位归属；不把“评价存在但不属于你”与“不存在”区分为可枚举信息。禁止以请求内 `companyId` 决定查询范围。 + +### 5.3 防 N+1 查询 + +企业列表采用“岗位评价页 + 批量补齐”策略： + +1. 分页查询当前公司岗位的评价，并 join/批量取得岗位标题； +2. 对本页 `reviewId` 一次性查询 `job_review_dimension_scores`； +3. 对本页 `reviewId` 一次性查询官方回复； +4. 在内存按 ID 映射组装。 + +不得逐条调用 `findById`、逐条查询维度分或回复。管理员待审列表同样使用 reply 与岗位/公司 `JOIN FETCH` 或投影查询。编码测试应证明查询次数与页面条目数无关。 + +### 5.4 并发与幂等 + +- 创建回复：数据库 `UNIQUE(review_id)` 是最终防线；服务先处理同 `idempotencyKey` 重放，再依赖唯一键处理并发创建。 +- 修订回复：请求带 `expectedVersion`，实体使用 `@Version`；过期版本抛 `409/10104`。 +- 管理员决策：条件更新 `WHERE id=? AND moderation_status='PENDING' AND version=?`，影响行数为 0 时返回 `409/10103` 或 `10104`；仅成功事务生成一次历史和审计。 +- 任何唯一键或乐观锁异常都不得映射为 500 或泛化为错误的“已存在”。 + +## 6. 审核、内容安全和异常语义 + +### 6.1 文本规则 + +回复正文限制 1–500 字符，拒绝空白文本。复用已有规则中可泛化的：敏感词、手机号、QQ/微信引流、URL、异常重复字符。对企业回复不使用“学生快速提交”“跨学生重复评价”“学生批量刷评”一类依赖学生行为的规则。 + +规则命中时内容可以保存为 `PENDING`，但不得公开；管理员作出决定后才变为公开或驳回。原因码仅给管理员；企业在被驳回时只看到管理员填写的安全说明，不展示敏感词、内部阈值、风控分。 + +### 6.2 错误码（拟新增 101xx） + +| 错误码 | HTTP | 含义 | +| --- | --- | --- | +| 10101 `REVIEW_REPLY_NOT_FOUND` | 404 | 回复不存在，或不属于本企业时按权限策略处理 | +| 10102 `REVIEW_REPLY_ALREADY_EXISTS` | 409 | 评价已有当前官方回复 | +| 10103 `REVIEW_REPLY_INVALID_STATE` | 409 | 状态不允许创建修订/决策 | +| 10104 `REVIEW_REPLY_CONCURRENT_UPDATE` | 409 | 乐观锁或条件更新冲突 | +| 10105 `REVIEW_REPLY_CONTENT_INVALID` | 400 | 空白、超长或不符合字段校验 | +| 10106 `REVIEW_REPLY_IDEMPOTENCY_CONFLICT` | 409 | 同幂等键但评价/正文不同 | +| 10107 `REVIEW_REPLY_DECISION_INVALID` | 400 | 非法审核决策或驳回原因缺失 | + +角色不匹配继续使用既有 `FORBIDDEN/2002`，未登录继续使用 `UNAUTHORIZED/401`，不增加重复错误码。 + +## 7. DTO 白名单 + +| 载荷 | 可以返回 | 绝不返回 | +| --- | --- | --- | +| 企业评价列表/详情 | 评价文本、星级、标签、维度聚合、岗位公开名称、时间、该企业自身回复状态 | 学生 ID/联系方式、IP/UA、哈希、评价审核内部信息 | +| 企业回复 | 内容、状态、版本、更新时间、管理员驳回说明 | 审核人 ID、内部原因码、风控分、内部请求 ID | +| 管理员待审回复 | 回复文本、公司/岗位、风险等级与安全原因码 | 学生联系信息、IP/UA 明文、密码、JWT | +| 公开评价回复 | `content`、`repliedAt` | ID、公司 ID、状态、版本、审核细节、所有评价人信息 | + +任何 response DTO 禁止用 Entity 直接序列化；使用显式 DTO 或白名单 `Map`。对 `officialReply`、企业列表、管理员列表分别写 JSON 序列化脱敏断言。 + +## 8. 预期 OpenAPI 与前端协作 + +预计新增 5 paths / 6 operations： + +```text +GET /companies/me/job-reviews +GET /companies/me/job-reviews/{reviewId} +POST /companies/me/job-reviews/{reviewId}/reply +PUT /companies/me/job-reviews/{reviewId}/reply +GET /admin/review-replies/pending +POST /admin/review-replies/{replyId}/decision +``` + +预计 OpenAPI：154/190 → **159 paths / 196 operations**。实际编码后必须由运行时 `/v3/api-docs` 与 `docs/openapi-rc.json` 对账，`python docs/verify_openapi.py` 通过后才可记录最终数字。 + +前端需要： + +1. 企业侧支持评价筛选、无回复/待审/已公开/已驳回状态； +2. 已驳回回复展示安全说明与“修订后重新提交”入口； +3. 公开岗位评价页仅在 `officialReply` 存在时展示“企业官方回复”； +4. 移除任何对公开 `studentUserId` 的依赖； +5. 不把企业端的审核状态、管理员页面或内部 reason codes 暴露给公众。 + +## 9. 测试与验收计划 + +### 9.1 单元测试 + +- 回复状态机：安全文本自动通过、风险文本待审、待审审批/驳回、仅驳回可重提、公开终态不可改； +- 内容校验：空白、501 字符、手机号/URL/敏感词等； +- 幂等：同键同体返回同一回复，同键异体 `10106`； +- 乐观锁和并发创建：同评价并发只成功一条，不出现 500； +- 脱敏 mapper：企业/公开/管理员三个视图字段严格不同。 + +### 9.2 MockMvc 与权限测试 + +- COMPANY 可访问所属岗位评价并创建回复； +- STUDENT、ADMIN、未归属 COMPANY、匿名分别获得既定 403/401； +- 企业没有 DELETE 评价/回复的路由与权限； +- PUBLIC 仅看见审核通过的 `officialReply`； +- 新旧公开评价 JSON 均不含 `studentUserId`、联系方式、内部审核字段。 + +### 9.3 H2 持久化测试 + +- V38 迁移可应用，FK、唯一约束、CHECK、`@Version` 生效； +- 评价删除时回复与历史级联删除； +- 企业列表分页、批量维度分/回复加载，验证无 N+1； +- 管理员并发决策仅一条历史与一条审计落库； +- V17/V18 的学生评价审核与汇总回归通过。 + +### 9.4 Docker MySQL 黑盒 + +1. 学生创建公开评价 → 所属企业列表/详情可见但无评价者 ID； +2. 企业创建安全回复 → 公开评价出现 `officialReply`； +3. 企业创建风险回复 → 公众不可见，管理员待审、批准/驳回链路正确； +4. 驳回后企业修订可重提；公开后不可覆盖或删除； +5. 非归属企业、STUDENT、ADMIN、匿名越权验证； +6. 同一评价并发创建、同键重试、管理员并发决策逐请求校验 HTTP 状态/业务码，无 500； +7. `audit_logs` 只含白名单详情，不含正文、评价人或凭据；RabbitMQ 队列终态存在且 ready/unacked 均为 0； +8. 回归 V17/V18 公开评价、V33 举报屏蔽、V34 求职进度、V35/V36 测评、V37 风控、V38 评分、V39 推荐关键接口。 + +关闭门槛：专项测试与 `mvn clean verify` 全绿、OpenAPI 对账通过、真实 MySQL/Docker 黑盒 `FAIL=0`，关键权限与脱敏项不得 `SKIP`。 + +## 10. 回滚与兼容 + +- V40 只增加两张回复表、六个操作与公开响应的可选 `officialReply`；不改变学生评价的评分、审核或删除语义。 +- 回滚采用新的前向迁移停用/删除 V40 回复表，禁止修改已执行的 V38；生产执行前另写并评审回滚迁移。 +- 若企业回复功能需临时关闭，服务层应拒绝新建/重提而保留既有公开回复可读；是否加入独立 feature flag 需在编码前确认，默认不增加以免无业务需求引入额外配置。 + +## 11. 已确认的编码边界（2026-09-04） + +负责人已确认以下方案，编码必须以此为准： + +1. 采用 `V38__company_review_replies.sql`，新增回复与回复历史两张表； +2. 每条评价仅有一条当前官方回复；公开后不可覆盖，驳回后可修订重提； +3. 使用确定性预审：无风险自动公开，风险回复转管理员审核； +4. V40 立即移除公开评价载荷中的 `studentUserId`，关闭既有隐私泄露； +5. 本版不做企业申诉/投诉评价、自动通知、运营统计或公开回复编辑历史； +6. 接口范围锁定为 5 paths / 6 operations，OpenAPI 预计 159 paths / 196 operations； +7. 不新增企业回复独立 feature flag。 + +V40 编码、测试、OpenAPI 更新与真实 MySQL/Docker 黑盒验收均已完成（`PASS=62 FAIL=0 SKIP=0`）；仍须遵守模块完成后再建立独立 Git 检查点的治理要求。 diff --git a/docs/v41-enterprise-talent-recommendation-design.md b/docs/v41-enterprise-talent-recommendation-design.md new file mode 100644 index 0000000..254a54c --- /dev/null +++ b/docs/v41-enterprise-talent-recommendation-design.md @@ -0,0 +1,366 @@ +# V41 企业人才发现推荐——详细设计（编码前评审） + +> 状态：**已实现并通过自动化与真实 MySQL/Docker 黑盒验收**。自动化测试 1461/1461 通过，真实黑盒 `PASS=37 / FAIL=0`。本文是 V41 的唯一设计基线。 + +## 1. 目标与边界 + +### 1.1 目标 + +让已认证企业针对自己已发布的岗位，发现**主动开启人才发现**的学生候选人。系统用已批准的岗位画像和学生自愿提供的聚合信号做规则排序，返回数据最小化的候选人卡片。 + +这是一项“人才发现”能力，不替代投递、面试、Offer 或现有企业候选人看板： + +- 现有 `/company/candidates/**` 只展示已经投递的候选人； +- V41 只展示尚未向当前企业投递、且显式同意被发现的候选人； +- V41 不创建投递、不发送消息、不创建邀约，也不让企业获得联系方式或简历文件。 + +### 1.2 确认范围 + +1. 学生人才发现默认关闭，学生可随时自行开启或关闭； +2. 只有 `verified=true` 的 COMPANY，才可对其自有、`PUBLISHED` 的岗位查询； +3. 仅已启用且 ADMIN 审核通过的 V39 岗位画像可以计算推荐； +4. 复用 V39 的规则信号权重：学生偏好 40%、RIASEC 聚合兴趣 35%、四维能力聚合 25%； +5. 已向**当前企业任一岗位**投递过的学生均从候选池排除，包含已撤回或已拒绝的历史投递，避免重复触达； +6. 公司只得到匹配档位与安全概述，不得到 RIASEC、四维能力、候选评分、答卷、答案、题目或原始权重； +7. 本版没有企业私信、邀约、收藏/淘汰反馈、企业端联系方式、学生被动通知、AI 解释或推荐历史快照。 + +### 1.3 明确不做 + +- 不改变 V35/V36 的测评题库、提交、重测、有效期或审计语义； +- 不改变 V38 的候选评分写入、排名和企业评分卡； +- 不改变 V39 的“学生找岗位”推荐及其岗位画像审核流； +- 不改变现有 `resumeVisibility` / `contactVisible` 的含义； +- 不按性别、年龄、籍贯、手机号、邮箱、学校排名、姓名或头像作为排序信号； +- 不生成“录用概率”“胜任结论”“适合/不适合”之类确定性结论。 + +## 2. 现状核查与设计前提 + +| 项目 | 现状 | V41 处理 | +|---|---|---| +| 最新迁移 | V38 为企业评价官方回复 | V41 建议下一编号 `V39__enterprise_talent_discovery.sql` | +| V39 岗位画像 | `job_recommendation_profiles`，仅 `enabled=true` 且 `APPROVED` 可用 | 作为岗位侧唯一的结构化推荐输入 | +| 学生偏好 | `student_preferences` 含城市、行业、岗位类型、用工类型、远程与薪资期望 | 只用于内部偏好匹配，不原样返回企业 | +| 兴趣测评 | V35 RIASEC 聚合结果 | 仅可作为内部聚合信号，绝不下发维度分 | +| 能力测评 | V36 完整且未过期的聚合结果 | 仅可作为内部聚合信号，绝不下发维度分 | +| 简历隐私 | `resumeVisibility` 只控制简历可见性，默认 `PRIVATE` | 不复用为人才发现授权；V41 另设明确授权 | +| 企业候选人看板 | 仅已投递的 `application` | V41 只发现未向本企业投递过的候选人 | + +`resumeVisibility` 与“是否允许被人才发现”是不同目的的授权：前者控制简历，后者控制是否进入企业发现候选池。两者不可混用或隐式推导。 + +## 3. 角色、权限与隐私 + +### 3.1 权限矩阵 + +| 能力 | STUDENT | COMPANY（未认证） | COMPANY（认证且岗位所属） | ADMIN | 未登录 | +|---|---:|---:|---:|---:|---:| +| 查询/更新本人人才发现开关 | ✓ | 403/2002 | 403/2002 | 403/2002 | 401 | +| 查询岗位人才推荐 | 403/2002 | 403/2002 | ✓ | 403/2002 | 401 | + +所有身份从 `SecurityContext.getAuthentication().getName()` 的 JWT subject 推导。请求中不得接受 `companyId`、`studentUserId`、`candidateId` 或任何越权身份参数。 + +### 3.2 候选人可见性规则 + +一个学生进入某企业某岗位的候选池，必须同时满足： + +1. 用户角色为 `STUDENT`，账号未进入注销终态； +2. 存在 `student_talent_discovery_preferences` 且 `enabled=true`；无记录一律视为关闭； +3. 存在可用于候选卡的基础学生档案； +4. 与当前公司不存在任何历史 `applications` 记录； +5. 当前 COMPANY 已认证，目标岗位归属该 COMPANY 且为 `PUBLISHED`； +6. 目标岗位有 `APPROVED + enabled=true` 的 V39 岗位画像。 + +关闭开关后，后续查询立即不再返回该学生；不删除其档案、投递、测评、评分或审计历史。V41 首版不保存企业查询历史与候选人曝光历史，避免把“被浏览”固化为可追踪个人行为数据。 + +### 3.3 响应白名单 + +企业候选卡仅允许： + +```json +{ + "candidateKey": "tdc_opaque_token", + "candidateLabel": "开放人才候选人", + "city": "合肥", + "education": "本科", + "graduationYear": 2027, + "skills": ["Java", "Spring Boot"], + "fitBand": "HIGH", + "summary": "岗位画像与候选人公开资料存在较高匹配度", + "signalsAvailable": ["PREFERENCE", "RIASEC", "ABILITY"] +} +``` + +`candidateKey` 是服务端签名的、与公司和岗位绑定的短期不透明标识，只用于前端列表稳定 key；它不等于 `studentUserId`，也不能在本版换取详情、联系方式或简历。 + +企业响应禁止出现： + +- `studentUserId`、用户 ID、简历 ID、手机号、邮箱、住址、简历 URL； +- 姓名、头像、出生日期、性别、身份证明、学校排名； +- 测评 attempt/result ID、维度分、原始分、题目、答案、答案键、解析、评分规则； +- `candidate_dimension_scores` 明细、候选综合分、排名、百分位； +- 画像原始权重、能力期望、内部规则版本、SQL/审计数据。 + +学生端开关响应只返回 `enabled`、`version`、`createdAt`、`updatedAt`；不返回企业查询过该学生的记录。 + +## 4. 接口契约（提案） + +### 4.1 学生人才发现偏好 + +```http +GET /profile/me/talent-discovery +PUT /profile/me/talent-discovery +``` + +`GET` 无记录时返回默认值，不写库： + +```json +{ "enabled": false, "version": 0 } +``` + +`PUT` 请求： + +```json +{ "enabled": true, "expectedVersion": 0 } +``` + +- `enabled` 必填； +- `expectedVersion` 可选，传入时必须与当前版本一致； +- 首次创建仅接受 `expectedVersion` 缺失或 `0`； +- 并发冲突复用现有乐观锁错误 `9201`，不新增无必要错误码； +- 成功只写 `TALENT_DISCOVERY_PREFERENCE_UPDATED` 审计，details 仅有开关状态、版本、requestId 与时间。 + +### 4.2 企业岗位人才推荐 + +```http +GET /companies/me/jobs/{jobId}/talent-recommendations?page=0&size=20 +``` + +参数规范：`page` 从 0 起；`size` 为 1–50；`jobId > 0`。无候选人返回 HTTP 200： + +```json +{ + "mode": "NO_ELIGIBLE_CANDIDATE", + "items": [], + "total": 0, + "page": 0, + "size": 20, + "totalPages": 0, + "message": "暂未发现已授权且满足基础条件的候选人" +} +``` + +目标岗位缺少可用画像时也返回 HTTP 200，但明确： + +```json +{ + "mode": "UNAVAILABLE", + "items": [], + "message": "该岗位尚无审核通过的推荐画像" +} +``` + +不得把空候选池或不可用画像伪装成评分为 0 的推荐列表。 + +### 4.3 预计 OpenAPI + +新增 2 个唯一 path / 3 个 operation（学生 GET/PUT 共用同一 path）： + +| 方法 | 路径 | 角色 | +|---|---|---| +| GET | `/profile/me/talent-discovery` | STUDENT | +| PUT | `/profile/me/talent-discovery` | STUDENT | +| GET | `/companies/me/jobs/{jobId}/talent-recommendations` | 已认证 COMPANY，且岗位归属本人 | + +以当前 159 paths / 196 operations 为基线，预计更新到 **161 paths / 199 operations**。三个 operation 只形成两个唯一 URL path；实际以运行时 `/v3/api-docs` 和静态 `openapi-rc.json` 的对账结果为准。 + +## 5. 数据模型与迁移 + +### 5.1 新迁移 + +建议新增、且只新增： + +```text +V39__enterprise_talent_discovery.sql +``` + +不修改 V1–V38 已执行迁移；不向 `candidate_dimension_scores` 写入任何数据。 + +### 5.2 `student_talent_discovery_preferences` + +| 字段 | 类型/约束 | 含义 | +|---|---|---| +| `id` | BIGINT PK | 主键 | +| `student_user_id` | BIGINT NOT NULL UNIQUE，FK `users(id)` | 仅本人一条授权记录 | +| `enabled` | TINYINT NOT NULL DEFAULT 0 | 人才发现显式授权 | +| `version` | BIGINT NOT NULL DEFAULT 0 | 乐观锁 | +| `created_at` | DATETIME NOT NULL | 创建时间 | +| `updated_at` | DATETIME NOT NULL | 最后更新 | + +索引：`(enabled, student_user_id)`。关闭的记录不参与候选查询；不存在记录等效关闭。 + +不存：公司 ID、岗位 ID、企业浏览记录、联系方式、简历路径、测评细节、候选评分或算法分。 + +## 6. 规则计算与数据一致性 + +### 6.1 capturedNow + +企业一次查询在服务起点生成唯一 `capturedNow`。同一次计算的能力有效期、候选过滤与输出必须复用该值，避免边界时刻同页结果不一致。 + +### 6.2 信号选择 + +对每位候选人仅读取以下最小聚合数据： + +| 信号 | 有效条件 | 不可用处理 | +|---|---|---| +| 偏好 P | 可解析的城市、行业、岗位类型、用工类型、远程或薪资偏好 | 该信号不计入分母 | +| 兴趣 I | 最新 `HOLLAND_RIASEC`、`COMPLETED`，按 `completed_at DESC, attempt_id DESC` 取一条，六维完整且 0–100 | 不计入分母 | +| 能力 A | 最新 `WORKPLACE_ABILITY`、`COMPLETED`、`valid_until > capturedNow`，四维完整、每维 6 题、总计 24 题且 0–100 | 不计入分母 | + +禁止取历史最高分。JSON 损坏、缺维、越界、空值、重复维或无效时间都只能令该信号不可用，不能造成 HTTP 500。 + +### 6.3 分数与排序 + +仅当至少一项可用信号存在时，计算： + +```text +fitScore = + (P × 40 + I × 35 + A × 25) / 可用信号权重之和 +``` + +中间与最终结果使用 `BigDecimal`，最终保留两位、`HALF_UP`。`fitScore` 仅用于后端排序与映射档位，不对企业返回数值。 + +| 匹配档位 | 内部区间 | 企业展示 | +|---|---:|---| +| HIGH | ≥ 75 | 较高匹配度 | +| MEDIUM | 60–74.99 | 中等匹配度 | +| BASIC | < 60 | 基础匹配度 | + +排序：`fitScore DESC` → 候选档案最后更新时间 DESC → `student_user_id DESC`。最后一项只用于稳定排序，不对外暴露。 + +若没有任何有效信号，候选人不进入 V41 首版列表；不使用学校、姓名、性别等字段做“兜底排序”。 + +### 6.4 安全概述 + +`summary` 固定来自模板，只允许说明总体匹配等级。`signalsAvailable` 仅披露存在的类别 `PREFERENCE` / `RIASEC` / `ABILITY`，不披露任何单项高低、维度或权重。详细理由与可解释反馈明确留给后续“推荐理由和解释”模块评审。 + +## 7. 查询、性能与并发 + +### 7.1 查询策略 + +V41 第一版采用**实时计算、全局排序后分页**：不能先在数据库分页、只对当前页计算分数再排序，否则第 2 页候选人可能比第 1 页分数更高，分页结果会错误。 + +1. 先用一次批量资格查询读取全部候选 ID 与必要的基础档案字段：授权开启、`STUDENT`、档案存在、账号未处于注销限制状态、与当前公司不存在任何历史投递；历史投递通过 `NOT EXISTS` 或批量集合排除，不能只排除当前岗位，也不能按候选人逐条查询。 +2. 按固定批次（建议每批 500 个 ID）批量读取学生偏好、最新可用 RIASEC、最新有效能力结果和展示档案；候选 ID 必须使用参数绑定，禁止拼接 SQL。 +3. 服务层以内存 Map 汇总每个候选人的信号，计算所有候选人的 `fitScore`，再按 `fitScore DESC`、档案 `updatedAt DESC`、`studentUserId DESC` 做全局排序，最后执行 `page/size` 切片。 + +这是第一版实时方案；当候选池达到规模阈值，应升级为异步推荐索引/快照，但不能以页内排序牺牲当前版本的全局排序正确性。查询需预留真实 MySQL `EXPLAIN` 验收：`student_user_id`、`definition_id`、`completed_at`、`valid_until` 与授权开关索引均应参与过滤。 + +### 7.2 并发 + +人才推荐列表是只读、实时计算，无持久化推荐记录，故无创建推荐的并发写入问题。学生开关通过 `@Version + expectedVersion` 控制并发，两个竞争更新只能有一个成功；另一个返回 `409/9201`。 + +查询过程中学生关闭开关的竞态允许下一次请求生效；同一已开始的只读事务可在当前页继续返回当时快照，不延迟或阻塞用户操作。 + +## 8. 错误语义与审计 + +### 8.1 错误 + +| 场景 | HTTP / 业务码 | +|---|---| +| 非认证 | 401 | +| 角色不符 | 403 / 2002 | +| 企业不存在 | 404 / 5001 | +| 岗位不存在/非发布 | 复用既有岗位错误码 | +| 岗位不属于当前企业 | 403 / 2002（不泄露额外信息） | +| 企业未认证 | 403 / 2002 | +| page/size/jobId 非法 | 400 / 1001 | +| 学生开关版本冲突 | 409 / 9201 | + +本版不新增 V41 专属错误码。`UNAVAILABLE` 和 `NO_ELIGIBLE_CANDIDATE` 是成功响应模式，不是错误。 + +### 8.2 审计 + +仅学生开关写审计： + +```json +{ + "enabled": true, + "version": 2, + "requestId": "..." +} +``` + +`GET` 推荐列表不写逐候选人或逐企业浏览审计，避免形成候选人追踪链路。不得审计候选人清单、matchScore、信号细节、学生 ID、联系方式、简历地址、答案、IP、User-Agent、token 或密码。 + +## 9. 安全与公平性门禁 + +1. 学生显式同意是进入企业发现池的前置条件；默认关闭； +2. 企业必须认证、岗位必须属于自己且公开发布； +3. 推荐不是自动淘汰或录用依据，企业仍需在后续合法招聘流程中自行评估； +4. 不使用受保护特征或联系方式排序； +5. 任何测评聚合仅在学生自愿进入发现池后作为内部排序信号；企业侧不见测评详情； +6. 若后续加入解释、邀约、反馈或模型训练，必须单列模块并重新做隐私、风控和产品评审。 + +## 10. 建议代码结构 + +```text +com.mydreamjob.talentdiscovery + StudentTalentDiscoveryPreference + StudentTalentDiscoveryPreferenceRepository + TalentDiscoveryService + TalentDiscoveryCandidateSource # 批量只读数据来源 + TalentDiscoveryScoreCalculator # 纯函数，无数据库访问 + TalentDiscoveryController + dto/ +``` + +允许复用 V39 的安全 JSON 解析与岗位画像校验，但不得复制 Controller 中的权限逻辑或把 V41 放入 V39 Controller 而扩大其职责。 + +## 11. 测试与验收方案 + +### 11.1 自动化测试 + +1. `TalentDiscoveryScoreCalculatorTest` + - 三信号权重与缺项重归一化； + - 最新低分优先于历史高分； + - 能力恰在 `capturedNow` 过期； + - 缺维、非法 JSON、越界均不 500； + - 不使用姓名、性别、学校或联系方式作为输入。 +2. `TalentDiscoveryServiceTest` + - 默认关闭不入池；开启后入池；关闭后立即排除； + - 当前企业任一历史投递均排除；其他企业投递不排除； + - 未认证企业、跨企业岗位、无审核画像、未发布岗位； + - 候选卡白名单；无数据模式正确；N+1 查询次数固定。 +3. `TalentDiscoveryControllerTest` + - STUDENT/COMPANY/ADMIN/未登录矩阵； + - 分页校验；不泄露 `studentUserId`、联系方式、测评字段或分数； + - 学生开关 PUT 乐观锁冲突。 +4. `TalentDiscoveryPersistenceIntegrationTest` + - V39 迁移、唯一约束、FK、默认关闭、`@Version` 冲突； + - 批量查询与已投递排除在 H2 MySQL 模式工作。 + +### 11.2 真实 MySQL/Docker 黑盒 + +1. V39 迁移成功且无影响 V1–V38； +2. 默认关闭、开启、关闭后的立即可见性变化； +3. 已认证/未认证企业、岗位所有权、PUBLISHED 与已审核画像门禁； +4. 同企业历史投递排除、其他企业投递不误排； +5. 最新低分优先、能力过期、无有效信号和无候选人模式； +6. 响应脱敏、审计不写候选清单； +7. `EXPLAIN` 与常数批量查询验证； +8. RabbitMQ 队列终态与 V39/V40 关键接口回归。 + +## 12. 文档、OpenAPI 与发布门禁 + +编码后更新： + +- `docs/enterprise-talent-discovery-api.md`； +- `docs/frontend-integration.md`； +- `docs/backend-development-roadmap.md`； +- `docs/openapi-rc.json`（V41 实际 161 paths / 199 operations，两个唯一 path 承载三个 operation）； +- `docs/verify_openapi.py`。 + +发布门禁已完成：专项与全量自动化测试通过（1461/1461），OpenAPI 静态/运行时均为 161 paths / 199 operations，真实 MySQL/Docker 黑盒 `PASS=37 / FAIL=0`。黑盒覆盖 V39 迁移、授权状态机、最新版测评选择、同企业历史投递排除、全局排序后分页、权限与脱敏、队列终态及 V39 回归。 + +## 13. 编码前确认结论 + +负责人已确认本设计的业务范围。进入编码前还必须按本设计完成只读核查：最新 Flyway 为 V38、V39 岗位画像审核字段存在、认证企业判断可用、学生档案字段可满足候选卡白名单；如任一项与当前代码冲突，停止并报告，不自行改变接口、迁移号、隐私边界或排序口径。 diff --git a/docs/v42-enterprise-talent-invitation-design.md b/docs/v42-enterprise-talent-invitation-design.md new file mode 100644 index 0000000..625b1a1 --- /dev/null +++ b/docs/v42-enterprise-talent-invitation-design.md @@ -0,0 +1,480 @@ +# V42 企业人才邀约与授权沟通——详细设计（已实现并通过真实黑盒验收） + +> 状态：**设计已确认并实现，真实 MySQL/Docker 黑盒验收通过（PASS=76/FAIL=0），待 Git 检查点**。负责人已于 2026-09-04 确认本文第 17 节全部决策。 +> +> 目标读者：后端开发、测试、前端联调与产品负责人。 +> +> 设计目标：在 V41 企业人才发现的隐私边界之上，允许企业向候选人发出一次可审计、可拒绝、会过期的站内邀约；只有学生明确接受后，双方才建立站内会话。任何阶段均不向企业直接提供联系方式、简历文件或测评明细。 + +## 1. 背景与核心决策 + +V41 只返回不可逆的 `candidateKey`，不返回 `studentUserId`，也没有通过该 key 查询个人详情的接口。V42 必须延续这一边界，不能把 `candidateKey` 改造成可解码 ID，也不能允许企业在请求中提交学生 ID。 + +创建邀约时，后端应在同一次事务前置校验中重新生成当前岗位的合格候选池，对候选池内每位学生按 V41 相同日期桶和算法计算 `candidateKey`，使用常量时间比较找到唯一候选人，并再次校验授权、岗位画像、历史投递和账号状态。匹配成功后，内部可将 `student_user_id` 写入邀约表用于归属和学生收件箱，但该字段永不出现在企业响应、日志或审计 details 中。 + +本版采用“**邀约先行，接受后建站内会话**”： + +```text +企业发现候选人 + → 创建 PENDING 邀约 + → 学生查看并选择 ACCEPT / REJECT + → ACCEPT：原子创建或复用专用站内会话，状态 ACCEPTED + → REJECT：状态 REJECTED，不建立会话 + → 到期未处理：状态 EXPIRED，不建立会话 +``` + +不允许通过现有通用 `POST /conversations` 绕过邀约。现有 MessagingService 要求企业与学生已有 MATCHED 投递，V42 应新增一个仅供内部调用的受限会话创建组件，凭已接受的邀约创建 `TALENT_INVITATION` 类型会话；不得开放“传 studentUserId 创建会话”的公网接口。 + +## 2. 范围 + +### 2.1 本版包含 + +- 企业对 V41 当前仍合格的候选人发出邀约； +- 企业查看本公司发出的邀约列表和单条详情； +- 学生查看本人收到的邀约列表和详情； +- 学生接受或拒绝邀约； +- 接受后原子创建或复用站内会话； +- 幂等、频率限制、并发状态机、过期处理； +- 全链路权限、脱敏、历史与审计； +- V41 `candidateKey` 的安全解析替代方案：当前候选池内重算并匹配。 + +### 2.2 本版不包含 + +- 企业查看学生手机号、邮箱、住址、简历文件、真实姓名； +- 企业通过 candidateKey 查询候选人详情； +- 企业直接发送站内消息或绕过学生同意创建会话； +- 企业撤回、编辑、删除已发送邀约； +- 学生反悔撤销已接受结果； +- 邀约收藏、批量邀约、自动邀约、AI 文案； +- 联系方式申请、简历解锁、外部短信或邮件； +- 推荐曝光历史、推荐模型训练、候选评分写入； +- ADMIN 人工审核或修改邀约； +- 修改 V35–V41 的测评、评分、推荐、评价回复语义。 + +## 3. 版本与迁移 + +当前最新 Flyway 为 V39。V42 建议新增： + +```text +V40__enterprise_talent_invitations.sql +``` + +新增两张表： + +- `talent_invitations`：当前邀约及终态； +- `talent_invitation_history`：不可变状态历史，不保存文案副本。 + +不得修改 V1–V39；不得写 `candidate_dimension_scores`。 + +### 3.1 talent_invitations + +建议字段： + +| 字段 | 类型 | 约束/说明 | +|---|---|---| +| id | BIGINT | AUTO_INCREMENT PK | +| company_id | BIGINT | NOT NULL，FK companies(id) | +| job_id | BIGINT | NOT NULL，FK jobs(id) | +| student_user_id | BIGINT | NOT NULL，FK users(id)，仅内部使用 | +| candidate_key_digest | CHAR(64) | NOT NULL，仅保存收到 key 的 SHA-256 摘要，不保存原 key | +| message | VARCHAR(300) | NOT NULL，安全清洗后的邀约说明 | +| status | VARCHAR(20) | PENDING/ACCEPTED/REJECTED/EXPIRED | +| idempotency_key | VARCHAR(64) | NOT NULL，UUID | +| active_key | VARCHAR(200) | 活跃时唯一，终态置 NULL | +| conversation_id | BIGINT | NULL，接受后关联 conversations(id) | +| expires_at | DATETIME | NOT NULL，默认创建后 7 天 | +| decided_at | DATETIME | NULL | +| version | BIGINT | NOT NULL DEFAULT 0，JPA `@Version` | +| created_at | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | +| updated_at | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE | + +约束与索引： + +- `CHECK(status IN ('PENDING','ACCEPTED','REJECTED','EXPIRED'))`； +- `UNIQUE(company_id, idempotency_key)`； +- `UNIQUE(active_key)`； +- 活跃邀约的 `active_key` 固定为 `companyId:jobId:studentUserId`，进入任一终态时置 NULL； +- `INDEX(student_user_id, status, created_at)`； +- `INDEX(company_id, status, created_at)`； +- `INDEX(job_id, status, created_at)`； +- `INDEX(status, expires_at)`； +- `candidate_key_digest` 只用于追溯请求是否对应同一 opaque key，不用于反查学生； +- 删除岗位或公司时不建议级联删除审计性邀约；沿用项目 FK 策略并在编码前核实现有删除业务。若存在物理删除，使用 RESTRICT，避免历史丢失。 + +### 3.2 talent_invitation_history + +| 字段 | 类型 | 约束/说明 | +|---|---|---| +| id | BIGINT | AUTO_INCREMENT PK | +| invitation_id | BIGINT | NOT NULL，FK invitations(id) ON DELETE CASCADE | +| action | VARCHAR(30) | CREATED/ACCEPTED/REJECTED/EXPIRED | +| actor_user_id | BIGINT | NULL；系统过期时为空 | +| created_at | DATETIME | NOT NULL DEFAULT CURRENT_TIMESTAMP | + +要求： + +- `CHECK(action IN ('CREATED','ACCEPTED','REJECTED','EXPIRED'))`； +- `INDEX(invitation_id, created_at)`； +- 不保存 message、candidateKey、studentUserId、联系方式、简历、测评或评分； +- 每次真实状态变化恰好写一条历史。 + +## 4. 状态机与时间规则 + +```text +PENDING ──学生接受──> ACCEPTED +PENDING ──学生拒绝──> REJECTED +PENDING ──到期处理──> EXPIRED +``` + +- `ACCEPTED`、`REJECTED`、`EXPIRED` 均为终态； +- 创建时间由数据库/服务端生成，不接受客户端时间； +- 默认有效期 7 天，建议配置 `talent-invitation.ttl-days=7`，但本版不增加功能开关； +- 所有读取和决策先执行按 ID 的惰性过期：当 `status=PENDING && expiresAt<=capturedNow` 时，以条件更新转为 EXPIRED； +- 可增加定时批量过期任务，但正确性不能依赖调度器； +- `expiresAt == capturedNow` 视为已过期； +- 学生决策采用 `expectedVersion` + 条件更新，和过期任务竞争时只能一个成功； +- 接受事务必须保证“状态 ACCEPTED、history、conversation、audit”要么全部成功，要么全部回滚。 + +## 5. 公网接口 + +建议新增 6 个 path、6 个 operation： + +| 方法 | 路径 | 身份 | 作用 | +|---|---|---|---| +| POST | `/companies/me/jobs/{jobId}/talent-invitations` | COMPANY | 使用 candidateKey 创建邀约 | +| GET | `/companies/me/talent-invitations` | COMPANY | 分页查看本公司邀约 | +| GET | `/companies/me/talent-invitations/{invitationId}` | COMPANY | 查看本公司单条邀约 | +| GET | `/profile/me/talent-invitations` | STUDENT | 分页查看本人收到的邀约 | +| GET | `/profile/me/talent-invitations/{invitationId}` | STUDENT | 查看本人单条邀约 | +| POST | `/profile/me/talent-invitations/{invitationId}/decision` | STUDENT | 接受或拒绝 | + +以 V41 的 161 paths / 199 operations 为基线，预计变为 **167 paths / 205 operations**。最终计数必须以静态 OpenAPI、运行时 `/v3/api-docs` 和校验脚本三方一致为准。 + +### 5.1 企业创建邀约 + +请求： + +```json +{ + "candidateKey": "opaque-url-safe-value", + "message": "我们正在招聘后端开发实习生，欢迎了解岗位详情。", + "idempotencyKey": "3c989a31-6774-4520-9700-e58416cc1845" +} +``` + +校验： + +- 当前用户必须是已认证企业； +- `jobId > 0`，岗位属于当前企业且为 PUBLISHED； +- 岗位画像必须 `enabled=true && review_status='APPROVED'`； +- candidateKey 非空、长度设置合理上限（建议 128）； +- message 去首尾空白后 1–300 字符；禁止手机号、邮箱、URL、微信/QQ 等绕过站内沟通的信息； +- idempotencyKey 必须为 UUID，最长 64； +- 使用 V41 当前日期桶重算候选池 key 并常量时间匹配；禁止查表反解、日志打印或返回匹配到的学生 ID； +- 找到候选人后再次校验：授权开启、账号正常、档案可展示、没有当前企业任何历史投递、至少一个推荐信号仍有效； +- 任一候选门禁失败对企业返回统一的“候选人当前不可邀约”，避免泄露关闭授权、注销、投递或信号失效的具体原因。 + +幂等和重复： + +- 同公司、同 idempotencyKey、同 jobId、同 candidateKey 摘要、同 message：返回原邀约； +- 同公司、同 idempotencyKey 但业务内容不同：409； +- 同公司、同岗位、同学生已有 PENDING 邀约：返回 409； +- 旧邀约已进入终态后是否允许再次邀约，由冷却规则控制，不复用旧记录； +- 并发创建由 `UNIQUE(active_key)` 和独立事务定判保证，不得返回 500。 + +### 5.2 企业邀约响应 + +企业只可见： + +- invitationId； +- jobId、jobTitle； +- candidateKey（仅列表需要继续定位卡片时返回；推荐默认不回显，使用 invitationId）； +- candidateLabel，固定“开放人才候选人”； +- message； +- status； +- createdAt、expiresAt、decidedAt； +- conversationId，仅 ACCEPTED 后可见。 + +企业严禁看到 studentUserId、姓名、联系方式、简历 ID/URL、测评结果 ID/答卷 ID、RIASEC/能力细分、候选评分、fitScore、拒绝原因内部数据。 + +### 5.3 学生决策 + +请求： + +```json +{ + "decision": "ACCEPT", + "expectedVersion": 0 +} +``` + +或： + +```json +{ + "decision": "REJECT", + "expectedVersion": 0 +} +``` + +规则： + +- invitationId 必须属于当前学生； +- decision 仅 ACCEPT/REJECT； +- 只有未过期 PENDING 可决策； +- expectedVersion 必填； +- 同请求幂等重放：若已处于请求目标终态，可返回当前结果；不同决策或版本冲突返回 409； +- REJECT 不要求填写理由，且企业端不展示拒绝原因； +- ACCEPT 成功后返回 conversationId； +- 接受时若双方存在屏蔽关系，应拒绝接受并保持 PENDING，或由产品明确选择直接 REJECTED。推荐保持 PENDING 并返回统一禁止操作，避免泄露谁屏蔽谁。 + +## 6. candidateKey 匹配与防枚举 + +新增内部组件建议： + +- `TalentInvitationCandidateResolver`：复用 V41 候选资格与 CandidateKeyGenerator； +- `TalentInvitationService`：状态机、幂等、权限和事务； +- `TalentInvitationConversationService`：只接受已锁定且即将 ACCEPTED 的 invitation，不对 Controller 暴露； +- `TalentInvitationExpiryService`：惰性和批量过期； +- `TalentInvitationController`：白名单 DTO，不写 SQL。 + +解析流程： + +1. 单次请求生成 `capturedNow` 与日期桶； +2. 读取岗位及企业门禁； +3. 通过 V41 CandidateSource 批量读取当前全部合格候选； +4. 分批重算 candidateKey； +5. 用 `MessageDigest.isEqual` 比较 UTF-8 字节，找到唯一匹配； +6. 未匹配、已失效、重复匹配均返回统一不可邀约错误； +7. 仅在服务层内获得 studentUserId，落库后不写日志、不进入 HTTP 企业 DTO。 + +防护： + +- 每公司每岗位每天最多 20 次成功邀约； +- 每公司每天最多 100 次成功邀约； +- 每个学生对同一公司终态后 30 天内不得再次邀约； +- 无效 candidateKey 请求也必须纳入拒绝型安全审计和速率限制，避免枚举； +- 不在错误信息中区分 key 不存在、授权关闭、已投递、账号注销或信号过期； +- 限额应通过数据库聚合 + 必要索引判断，不能仅靠单机内存。 + +以上限额属于推荐初值，编码前需由负责人最终确认。 + +## 7. 接受后会话 + +接受邀约后创建 `conversations.type='TALENT_INVITATION'`，成员仅为： + +- 当前公司的 owner user； +- 当前学生。 + +要求： + +- 新会话只能由内部服务创建，不复用允许客户端传 `participantUserId` 的入口； +- `talent_invitations.conversation_id` 唯一或通过 invitationId 锁保证一份邀约只生成一个会话； +- 并发 ACCEPT 只产生一个会话和两条成员记录； +- 建议会话 title 使用岗位标题的安全模板，不包含学生真实身份； +- 创建会话后不自动发送企业自由文本消息，邀约 message 已在学生邀约详情显示；如需首条系统消息，使用固定模板且 sender 语义需单独确认； +- 后续消息继续走既有 MessagingService 的成员校验、屏蔽规则和消息长度限制； +- 需要调整现有企业—学生会话的 MATCHED 投递守卫：对 `TALENT_INVITATION` 已接受会话放行，但 DIRECT 新建规则保持原样；不能全局取消 MATCH_REQUIRED。 + +## 8. 查询、分页与 N+1 + +企业和学生列表统一 page 从 0 开始，size 1–50。 + +- 企业列表按 companyId + createdAt DESC + id DESC 分页； +- 学生列表按 studentUserId + createdAt DESC + id DESC 分页； +- 岗位与公司展示信息按当前页 ID 集合批量加载； +- 不逐邀约 `findById` 查询岗位、公司、会话； +- 响应组装使用投影或固定次数批量查询； +- 详情查询在 SQL 层绑定归属条件，避免先返回“存在”再报无权导致枚举； +- 定时过期采用固定批次条件更新，不能全表加载实体。 + +## 9. 权限矩阵 + +| 场景 | STUDENT | COMPANY | ADMIN | 匿名 | +|---|---:|---:|---:|---:| +| 企业创建/列表/详情 | 403/2002 | 仅本公司 | 403/2002 | 401 | +| 学生列表/详情/决策 | 仅本人 | 403/2002 | 403/2002 | 401 | +| 跨公司岗位或邀约 | — | 统一 403/2002 | — | — | +| 他人学生邀约 | 统一不可见 | — | — | — | + +SecurityConfig 只按角色收口；企业认证、岗位归属、邀约归属必须在 Service 再校验。请求 DTO 不得接受 companyId、studentUserId、ownerUserId 或 conversationId。 + +## 10. DTO 与脱敏 + +建议 DTO： + +- `CreateTalentInvitationRequest`； +- `TalentInvitationDecisionRequest`； +- `CompanyTalentInvitationItemResponse`； +- `CompanyTalentInvitationDetailResponse`； +- `StudentTalentInvitationItemResponse`； +- `StudentTalentInvitationDetailResponse`； +- `TalentInvitationDecisionResponse`； +- 对应分页包装。 + +学生可以看到企业公开名称、岗位标题、工作城市、岗位公开摘要、邀约 message、状态和期限。学生端不返回企业 ownerUserId、内部画像、风险信息或审计字段。 + +对完整序列化 JSON 断言不得包含： + +```text +studentUserId, ownerUserId, candidateId, phone, email, resumeUrl, +attemptId, resultId, answerKey, scoringRule, questionCode, +competencyTag, dimensionScores, overallScore, percentile, fitScore, +candidateKeyDigest, activeKey, password, token, secret +``` + +## 11. 错误码提案 + +建议使用新范围 10201–10209，编码前确认： + +| code | 名称 | HTTP | 场景 | +|---:|---|---:|---| +| 10201 | TALENT_INVITATION_NOT_FOUND | 404 | 对本人/本公司不可见或不存在 | +| 10202 | TALENT_INVITATION_CANDIDATE_UNAVAILABLE | 409 | key 无效或候选当前不再可邀约 | +| 10203 | TALENT_INVITATION_ALREADY_ACTIVE | 409 | 已有 PENDING | +| 10204 | TALENT_INVITATION_INVALID_STATE | 409 | 非 PENDING 决策 | +| 10205 | TALENT_INVITATION_EXPIRED | 409 | 已到期 | +| 10206 | TALENT_INVITATION_CONCURRENT_UPDATE | 409 | 版本或条件更新冲突 | +| 10207 | TALENT_INVITATION_IDEMPOTENCY_CONFLICT | 409 | 同 key 不同业务内容 | +| 10208 | TALENT_INVITATION_CONTENT_INVALID | 400 | 文案或请求字段非法 | +| 10209 | TALENT_INVITATION_RATE_LIMITED | 429 | 企业邀约限额 | + +跨企业、角色不符仍复用 2002；分页/路径参数非法复用 1001。不得把数据库异常直接返回 500 或暴露约束名。 + +## 12. 审计 + +新增动作： + +- `TALENT_INVITATION_CREATED`； +- `TALENT_INVITATION_ACCEPTED`； +- `TALENT_INVITATION_REJECTED`； +- `TALENT_INVITATION_EXPIRED`； +- `TALENT_INVITATION_CREATE_REJECTED`（拒绝型安全审计）。 + +成功审计 details 白名单建议仅含： + +```json +{ + "invitationId": 42, + "jobId": 9, + "status": "ACCEPTED", + "requestId": "..." +} +``` + +禁止记录 candidateKey、摘要、studentUserId、message、联系方式、简历、测评、评分、IP/UA 明文、token/password/secret。只有条件更新胜者写 history 和成功审计。 + +## 13. 事务与并发 + +- 创建：幂等预查 → 候选重新解析 → 写入独立事务 → 唯一冲突精确定判； +- 不得在已被唯一键异常污染的 Hibernate Session 中继续查询；必要时使用 `REQUIRES_NEW` writer 和独立定判事务； +- 决策：`WHERE id=? AND student_user_id=? AND status='PENDING' AND version=? AND expires_at>?` 条件更新； +- ACCEPT 若需要先获得 invitation ID，应锁定记录并在同一事务创建会话、成员、历史、审计； +- 并发 ACCEPT/REJECT/EXPIRE 只能一个状态变化成功； +- 幂等重放不能重复创建 conversation、history 或 audit； +- 所有时间比较复用同一个 capturedNow。 + +## 14. 必须新增的自动化测试 + +### 14.1 Candidate resolver + +- 当前日期桶合法 key 可解析； +- 旧日期桶、随机 key、篡改 key 不可解析； +- candidateKey 常量时间比较； +- 授权关闭、账号注销、当前企业历史投递、信号失效后立即不可邀约； +- 其他企业历史投递不误排； +- 不读取答案、题目或候选评分表； +- 查询次数只与批次数有关，不与候选人数线性增长。 + +### 14.2 TalentInvitationServiceTest + +- 安全文案创建 PENDING； +- 联系方式、URL、空白、超长文案拒绝； +- 同幂等键同请求返回同一邀约； +- 同幂等键不同请求冲突； +- 同岗位同学生并发创建只有一条成功，无 500； +- 企业/岗位/画像门禁； +- 每岗位每日、每公司每日、30 天冷却边界； +- 过期惰性转换； +- ACCEPT 创建唯一会话； +- REJECT 不创建会话； +- 并发 ACCEPT/REJECT/EXPIRE 仅一个胜者； +- 同目标终态重放不重复 history/audit/conversation； +- 屏蔽关系不被绕过。 + +### 14.3 Controller 权限与脱敏 + +- COMPANY 仅访问本公司邀约； +- STUDENT 仅访问本人邀约； +- ADMIN 和匿名矩阵； +- 跨企业、跨学生均不可枚举； +- page/size/jobId/decision/version 校验； +- 企业与学生完整 JSON 白名单断言； +- 企业响应无 candidateKey 之外的候选定位字段，且默认不回显 candidateKey； +- 不存在候选详情、联系方式解锁或企业直接创建会话接口。 + +### 14.4 PersistenceIntegrationTest + +- V40 在 H2 MODE=MySQL 执行； +- FK、CHECK、UNIQUE(active_key)、UNIQUE(company,idempotencyKey)； +- @Version 冲突； +- 终态 active_key 释放； +- conversation_id 唯一关联； +- 历史表不含正文和学生字段； +- 并发创建/决策无 500； +- 列表批量查询无 N+1； +- `candidate_dimension_scores` 行数不变。 + +### 14.5 回归 + +- V41 推荐与授权结果不变； +- V39 岗位画像审核不变； +- V40 企业评价回复不变； +- 现有 DIRECT 会话仍要求 MATCHED 投递； +- 只有 ACCEPTED 邀约可以创建 TALENT_INVITATION 会话； +- 屏蔽、举报、消息权限保持原语义； +- 不发送 RabbitMQ 消息（若后续确认需要通知，再单独设计 outbox）。 + +## 15. 真实 MySQL/Docker 黑盒门禁 + +自动化通过后必须独立执行： + +1. Flyway V40 success=1，两表字段、索引、FK、CHECK、唯一约束正确； +2. V41 返回的 candidateKey 可创建邀约，篡改/过期 key 不可创建； +3. 创建→学生列表/详情→接受→唯一站内会话完整主链路； +4. 拒绝与过期不创建会话； +5. 并发创建和并发决策逐请求校验 HTTP/status code 配对，无 500； +6. 同企业历史投递、关闭人才发现、账号注销后不可邀约； +7. 企业/学生/ADMIN/匿名/跨租户权限矩阵； +8. 企业响应、学生响应、audit_logs、history 全部脱敏； +9. `candidate_dimension_scores` 行数不变； +10. RabbitMQ 队列终态正常，V39–V41 关键接口回归； +11. 静态/运行时 OpenAPI 对账，最终必须 FAIL=0。 + +## 16. 文档与发布门禁 + +实现时新增/更新： + +- `docs/enterprise-talent-invitation-api.md`； +- `docs/frontend-integration.md`； +- `docs/backend-development-roadmap.md`； +- 本设计文档状态； +- `docs/openapi-rc.json`； +- `docs/verify_openapi.py`。 + +发布顺序：编码与自动化 → OpenAPI 对账 → 真实 MySQL/Docker 黑盒 → 精确 Git 检查点。不得在黑盒未闭环时标记冻结。 + +## 17. 已确认的编码决策 + +1. 批准 Flyway `V40__enterprise_talent_invitations.sql` 和两张新表； +2. 批准 6 paths / 6 operations，预计 OpenAPI 167/205； +3. 只有学生 ACCEPT 后才创建 `TALENT_INVITATION` 站内会话； +4. candidateKey 采用“当前候选池重算 + 常量时间匹配”，不新增 key→个人详情接口； +5. 邀约有效期 7 天，同企业同学生终态后冷却 30 天； +6. 每公司每岗位每天最多 20 次，每公司每天最多 100 次； +7. message 为 1–300 字，禁止联系方式、URL、微信/QQ； +8. 使用错误码 10201–10209； +9. 本版不发送短信、邮件或 RabbitMQ 通知，仅在学生站内邀约列表展示； +10. 存在屏蔽关系时，学生 ACCEPT 返回 `403/2002`，邀约保持 PENDING，不泄露屏蔽方向。 + +上述决策均为编码硬边界；如真实代码与其存在关键冲突，开发者必须停止并报告，不得自行改变迁移号、接口、状态机或隐私范围。 diff --git a/docs/v42-implementation-instruction.md b/docs/v42-implementation-instruction.md new file mode 100644 index 0000000..686943a --- /dev/null +++ b/docs/v42-implementation-instruction.md @@ -0,0 +1,439 @@ +# V42 企业人才邀约与授权沟通——编码执行指令 + +开始实现 V42「企业人才邀约与授权沟通」。 + +权威设计文档： + +```text +C:\Users\15642\Desktop\zhilai\docs\v42-enterprise-talent-invitation-design.md +``` + +请先完整阅读权威设计文档，再核查现有 V41 人才发现、V39 岗位画像、企业认证、账号注销、屏蔽关系、消息会话、审计及安全配置代码。设计中的 10 项产品决策已经负责人确认，禁止自行扩大或改变范围。 + +## 一、开始前只读核查 + +先执行并记录： + +```powershell +git status --short +git diff --cached --name-only +git log -5 --oneline +``` + +当前 Git 基线应包含： + +```text +5cc2c86 feat: deliver V41 enterprise talent discovery +2698d06 feat: deliver V40 company review replies +55e3975 feat: deliver V39 job recommendations +``` + +要求： + +1. 确认当前最新 Flyway 是 V39；V42 使用 `V40__enterprise_talent_invitations.sql`。 +2. 确认 V41 仅有 2 个 path / 3 个 operation，当前 OpenAPI 为 161 paths / 199 operations。 +3. 确认 `CandidateKeyGenerator` 的域隔离串、日期桶、HMAC 算法和 URL-safe 无 padding 编码。 +4. 确认 `TalentDiscoveryCandidateSource` 的资格过滤、同企业历史投递排除、账号注销排除和批量查询能力。 +5. 确认现有 MessagingService 对企业—学生 DIRECT 会话要求 MATCHED 投递，不能为 V42 全局取消该守卫。 +6. 确认 conversation、conversation_members、屏蔽关系、公司 owner、岗位状态、岗位画像状态的真实字段和仓库方法。 +7. 确认现有审计服务中“成功审计”和“拒绝型安全审计”的事务语义。 +8. 确认以下路径不存在： + - `POST /companies/me/jobs/{jobId}/talent-invitations` + - `GET /companies/me/talent-invitations` + - `GET /companies/me/talent-invitations/{invitationId}` + - `GET /profile/me/talent-invitations` + - `GET /profile/me/talent-invitations/{invitationId}` + - `POST /profile/me/talent-invitations/{invitationId}/decision` + +如果设计文档与真实代码存在关键冲突，立即停止并报告；不得自行改接口、迁移号、状态机、错误码或隐私边界。 + +不得 reset、restore、checkout、删除或覆盖既有未跟踪文件；不得执行 `git add -A`、commit 或 push。 + +## 二、硬性业务边界 + +1. 企业只能使用 V41 当前返回的 opaque `candidateKey` 创建邀约，绝不接收 `studentUserId`。 +2. candidateKey 不可逆；服务端必须在当前合格候选池中重新生成 key 并使用常量时间比较匹配。 +3. 只有已认证 COMPANY、自己的 PUBLISHED 岗位、APPROVED 且 enabled 的岗位画像可以创建邀约。 +4. 学生关闭人才发现、账号进入注销限制、与该企业已有任意历史投递、推荐信号全部失效时，不可创建邀约。 +5. 只有学生 ACCEPT 后才建立 `TALENT_INVITATION` 站内会话。 +6. REJECTED、EXPIRED 不创建会话。 +7. 企业不得看到学生身份、联系方式、简历、测评明细、候选评分或 fitScore。 +8. 本版不做企业撤回/编辑/删除、批量或自动邀约、联系方式申请、短信邮件、RabbitMQ 通知、ADMIN 审核、邀约曝光历史或 AI 文案。 +9. 不修改 V1–V39；不改变 V35–V41 既有业务语义。 +10. 不写 `candidate_dimension_scores`，不新增 feature flag。 +11. 不启动或停止 Docker，不做真实 MySQL 黑盒。 +12. 不提交、不推送、不进入 V43。 + +## 三、Flyway V40 + +新增： + +```text +mydreamjob-server/src/main/resources/db/migration/V40__enterprise_talent_invitations.sql +``` + +新增两张表。 + +### 3.1 talent_invitations + +至少包含： + +- `id BIGINT AUTO_INCREMENT PRIMARY KEY` +- `company_id BIGINT NOT NULL` +- `job_id BIGINT NOT NULL` +- `student_user_id BIGINT NOT NULL` +- `candidate_key_digest CHAR(64) NOT NULL` +- `message VARCHAR(300) NOT NULL` +- `status VARCHAR(20) NOT NULL` +- `idempotency_key VARCHAR(64) NOT NULL` +- `active_key VARCHAR(200) NULL` +- `conversation_id BIGINT NULL` +- `expires_at DATETIME NOT NULL` +- `decided_at DATETIME NULL` +- `version BIGINT NOT NULL DEFAULT 0` +- `created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP` +- `updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP` + +约束： + +- FK company/job/student/conversation； +- `CHECK(status IN ('PENDING','ACCEPTED','REJECTED','EXPIRED'))`； +- `UNIQUE(company_id,idempotency_key)`； +- `UNIQUE(active_key)`； +- 建议 `UNIQUE(conversation_id)`，NULL 可重复； +- PENDING 时 `active_key=companyId:jobId:studentUserId`，终态必须置 NULL； +- 索引 `(student_user_id,status,created_at)`、`(company_id,status,created_at)`、`(job_id,status,created_at)`、`(status,expires_at)`； +- 不保存原始 candidateKey，只保存 SHA-256 十六进制摘要。 + +### 3.2 talent_invitation_history + +至少包含： + +- id、invitation_id、action、actor_user_id、created_at； +- action 仅 `CREATED/ACCEPTED/REJECTED/EXPIRED`； +- FK invitation，`ON DELETE CASCADE`； +- 索引 `(invitation_id,created_at)`； +- 不保存 message、candidateKey、studentUserId、联系方式、测评或评分。 + +Flyway 必须兼容 MySQL 8 与 H2 MODE=MySQL，不修改已执行迁移。 + +## 四、实体、仓库与内部组件 + +建议新增包 `com.mydreamjob.talentinvitation`，至少包含： + +- `TalentInvitation` +- `TalentInvitationHistory` +- 两个 Repository +- `TalentInvitationCandidateResolver` +- `TalentInvitationConversationService` +- `TalentInvitationExpiryService` +- `TalentInvitationService` +- `TalentInvitationController` +- 白名单 DTO + +要求： + +- invitation 使用 JPA `@Version`； +- 状态和历史 action 使用字符串枚举； +- Entity 不得直接返回 HTTP； +- Repository 支持带 companyId/studentUserId 的归属查询、分页、条件状态更新、幂等查询、活跃/冷却/每日限额统计和批量过期； +- 列表批量加载岗位/公司/会话信息，不得逐条 findById； +- Controller 不写 SQL、不接收 companyId/studentUserId/ownerUserId/conversationId。 + +## 五、candidateKey 安全解析 + +`TalentInvitationCandidateResolver` 必须： + +1. 单次请求生成一个 `capturedNow`； +2. 完成企业、岗位、画像门禁； +3. 复用 V41 候选资格和批量数据源，获取该岗位当前全部合格候选； +4. 使用 V41 完全相同的域隔离、companyId、jobId、studentUserId 和 `yyyy-MM-dd` 日期桶重新生成 key； +5. 使用 `MessageDigest.isEqual` 做常量时间字节比较； +6. 必须恰好匹配一个候选人；零个或异常重复均返回统一的候选不可邀约； +7. 解析成功后的 studentUserId 只能留在服务内部和数据库 FK 中，不得写日志、审计 details 或企业 DTO； +8. 禁止添加 candidateKey→学生详情接口，禁止普通 Base64 解码、可逆加密或字符串拼接； +9. 禁止读取 assessment/ability answers、attempt questions、question feedback、candidate scoring 表。 + +无效 key、授权关闭、注销限制、历史投递、信号失效对企业使用相同安全错误，不解释具体原因。 + +## 六、接口与权限 + +新增 6 paths / 6 operations： + +```text +POST /companies/me/jobs/{jobId}/talent-invitations +GET /companies/me/talent-invitations +GET /companies/me/talent-invitations/{invitationId} +GET /profile/me/talent-invitations +GET /profile/me/talent-invitations/{invitationId} +POST /profile/me/talent-invitations/{invitationId}/decision +``` + +### 6.1 创建请求 + +```json +{ + "candidateKey": "opaque-url-safe-value", + "message": "我们正在招聘后端开发实习生，欢迎了解岗位详情。", + "idempotencyKey": "3c989a31-6774-4520-9700-e58416cc1845" +} +``` + +校验： + +- candidateKey 非空且长度不超过 128； +- message trim 后 1–300 字符； +- message 禁止手机号、邮箱、URL、QQ/微信等外部联系方式；复用现有安全规则的公共能力，禁止在 Controller 复制正则； +- idempotencyKey 为 UUID，最长 64； +- jobId > 0；分页 page>=0、size 1–50。 + +### 6.2 学生决策请求 + +```json +{ + "decision": "ACCEPT", + "expectedVersion": 0 +} +``` + +decision 仅 ACCEPT/REJECT，expectedVersion 必填且必须匹配。 + +权限矩阵： + +- 企业接口：仅已认证 COMPANY，且仅本公司；STUDENT/ADMIN 403/2002，匿名 401； +- 学生接口：仅本人 STUDENT；COMPANY/ADMIN 403/2002，匿名 401； +- 跨公司岗位和邀约统一 403/2002； +- 他人学生邀约统一按不可见处理，不能泄露存在性。 + +## 七、状态、过期、冷却与限额 + +状态机： + +```text +PENDING -> ACCEPTED +PENDING -> REJECTED +PENDING -> EXPIRED +``` + +- 三个终态不可再次改变； +- 默认有效期 7 天；`expiresAt <= capturedNow` 已过期； +- 读取和决策必须支持惰性过期；调度器只能改善及时性，不能承担正确性； +- 同企业同学生任何终态后 30 天内不能再次邀约； +- 每公司每岗位每天最多 20 次成功创建； +- 每公司每天最多 100 次成功创建； +- 所有限制使用数据库查询和索引，不依赖单机内存； +- 并发创建由 `UNIQUE(active_key)` 兜底； +- 状态决策采用 expectedVersion + status + expiresAt 条件更新； +- 并发 ACCEPT/REJECT/EXPIRE 只能一个胜者，无 500。 + +屏蔽关系：学生点击 ACCEPT 时若双方任一方向存在屏蔽，返回 `403/2002`，邀约保持 PENDING，不泄露谁屏蔽谁。 + +## 八、幂等与事务 + +创建： + +- 同 companyId、idempotencyKey、jobId、candidateKeyDigest、message 返回原邀约； +- 同 companyId、idempotencyKey 但业务内容不同返回 409/10207； +- 同公司、同岗位、同学生已有 PENDING 返回 409/10203； +- 唯一键异常后不得在污染的 Hibernate Session 中继续查询；必要时使用 `REQUIRES_NEW` writer 和独立定判事务。 + +决策： + +- 同目标终态幂等重放可返回原结果； +- 已是另一终态或版本冲突返回 409； +- 只有条件更新胜者写 history 和 audit； +- ACCEPT 必须在单一事务内完成状态、activeKey 清空、conversation、members、history、audit；任一步失败整体回滚； +- 重放和并发不得重复创建会话、成员、历史或审计。 + +## 九、接受后站内会话 + +- conversation.type=`TALENT_INVITATION`； +- 成员仅企业 owner user 与当前学生； +- 通过内部服务创建，绝不开放传 participantUserId 的 V42 公网入口； +- 每份 ACCEPTED invitation 只对应一个 conversation； +- 保留现有 DIRECT 会话 `MATCH_REQUIRED_FOR_CONVERSATION` 规则；只允许已 ACCEPTED 的 V42 内部流程创建 TALENT_INVITATION 会话； +- 会话标题使用岗位标题安全模板； +- 不自动把企业自由文案写成首条消息； +- 后续发消息继续遵守成员、屏蔽和内容规则。 + +## 十、DTO 与脱敏 + +企业 DTO 只允许： + +- invitationId、jobId、jobTitle； +- candidateLabel=`开放人才候选人`； +- message、status、createdAt、expiresAt、decidedAt； +- conversationId 仅 ACCEPTED 后返回； +- 默认不回显 candidateKey。 + +学生 DTO 可包含企业公开名称、岗位公开信息、message、状态、期限、conversationId。 + +对企业和学生真实序列化 JSON 断言不得包含： + +```text +studentUserId, ownerUserId, candidateId, phone, email, resumeUrl, +attemptId, resultId, answerKey, scoringRule, questionCode, +competencyTag, dimensionScores, overallScore, percentile, fitScore, +candidateKeyDigest, activeKey, password, token, secret +``` + +## 十一、错误码 + +在 ErrorCode 新增并同步 GlobalExceptionHandler： + +- 10201 TALENT_INVITATION_NOT_FOUND → 404 +- 10202 TALENT_INVITATION_CANDIDATE_UNAVAILABLE → 409 +- 10203 TALENT_INVITATION_ALREADY_ACTIVE → 409 +- 10204 TALENT_INVITATION_INVALID_STATE → 409 +- 10205 TALENT_INVITATION_EXPIRED → 409 +- 10206 TALENT_INVITATION_CONCURRENT_UPDATE → 409 +- 10207 TALENT_INVITATION_IDEMPOTENCY_CONFLICT → 409 +- 10208 TALENT_INVITATION_CONTENT_INVALID → 400 +- 10209 TALENT_INVITATION_RATE_LIMITED → 429 + +不得新增其他 V42 错误码，不得改变既有错误码含义。跨角色与屏蔽复用 2002，基础参数非法复用 1001。 + +## 十二、审计与隐私 + +新增动作： + +- TALENT_INVITATION_CREATED +- TALENT_INVITATION_ACCEPTED +- TALENT_INVITATION_REJECTED +- TALENT_INVITATION_EXPIRED +- TALENT_INVITATION_CREATE_REJECTED + +成功审计 details 仅允许 invitationId、jobId、status、requestId。禁止记录 candidateKey/digest、studentUserId、message、联系方式、简历、测评、评分、IP/UA 明文或凭据。 + +拒绝型安全审计沿用独立事务，内容同样不得包含 candidateKey 或学生 ID。每次真实状态变化最多一条 history 和一条对应成功审计。 + +## 十三、查询与 N+1 + +- 企业列表按 companyId 分页；学生列表按 studentUserId 分页； +- 排序 `createdAt DESC, id DESC`； +- 当前页岗位、公司、会话信息批量读取； +- 不逐邀请查询 Job/Company/User/Conversation； +- 详情查询直接绑定归属条件； +- 批量过期固定批次条件更新； +- 测试用 Spy/统计断言查询次数不随 items 数线性增长。 + +## 十四、必须新增测试 + +至少新增： + +1. `TalentInvitationCandidateResolverTest` + - 正确、篡改、过期日期桶 key； + - 常量时间比较； + - 授权/注销/历史投递/信号变化后的重新校验； + - 其他企业投递不误排； + - 无答案表、题目表、候选评分查询； + - 批量查询无 N+1。 + +2. `TalentInvitationServiceTest` + - 创建、文案安全、幂等和冲突； + - 活跃唯一、30 天冷却、20/100 日限额边界； + - 惰性过期； + - ACCEPT 唯一会话、REJECT/EXPIRE 无会话； + - 并发创建和并发决策无 500； + - 重放不重复 history/audit/conversation； + - 屏蔽关系保持 PENDING。 + +3. `TalentInvitationControllerTest` + - COMPANY/STUDENT/ADMIN/匿名和跨租户矩阵； + - 参数校验； + - 企业/学生真实 JSON 脱敏； + - 不存在详情解锁、联系方式或直接会话接口。 + +4. `TalentInvitationPersistenceIntegrationTest` + - V40 迁移、FK、CHECK、UNIQUE、@Version； + - activeKey 终态释放； + - conversation 唯一； + - history 不含敏感列； + - 并发创建/决策； + - 列表 N+1； + - candidate_dimension_scores 不变。 + +5. 回归测试 + - V41 推荐/授权； + - V39 岗位画像； + - V40 评价回复； + - DIRECT 会话仍要求 MATCHED； + - 只有 ACCEPTED 邀约可创建 TALENT_INVITATION 会话； + - 屏蔽与消息权限不变。 + +## 十五、SecurityConfig、OpenAPI 和文档 + +SecurityConfig 仅新增： + +- `/companies/me/**/talent-invitations/**` → COMPANY； +- `/profile/me/talent-invitations/**` → STUDENT。 + +路径匹配必须覆盖实际 6 个 operation，但不能误放宽其他 `/companies/me/**` 或 `/profile/me/**` 接口。 + +新增： + +- `docs/enterprise-talent-invitation-api.md` + +更新： + +- `docs/frontend-integration.md` +- `docs/backend-development-roadmap.md` +- `docs/v42-enterprise-talent-invitation-design.md` +- `docs/openapi-rc.json` +- `docs/verify_openapi.py` + +OpenAPI 目标：从 161/199 增加 6 paths / 6 operations，预计 **167 paths / 205 operations**，以实际结果为准。 + +校验脚本必须断言： + +- V42 恰好 6 paths / 6 operations； +- POST 请求均有非空 requestBody schema； +- 6 个成功响应均有非空 schema； +- 企业/学生 schema 不含敏感字段； +- 不存在候选详情、联系方式解锁、企业直接建会话、撤回/编辑/删除/批量邀约接口； +- OpenAPI 总数与实际一致。 + +## 十六、自动化验证命令 + +依次执行并记录真实结果： + +```powershell +mvn -Dtest="*TalentInvitation*Test,*TalentDiscovery*Test,*Messaging*Test" test +mvn test +mvn clean verify +python docs/verify_openapi.py +``` + +若 `clean verify` 因运行中的 JAR 锁定 target 失败，不得结束未知进程；只报告 PID、端口和阻塞原因，等待负责人确认。 + +## 十七、最终停止条件 + +完成代码、测试、OpenAPI 和文档后立即停止： + +- 不启动/停止 Docker； +- 不做真实 MySQL 黑盒； +- 不提交或推送 Git； +- 不执行 `git add -A`； +- 不删除未跟踪文件； +- 不进入 V43。 + +最终报告必须包含： + +1. 精确修改文件； +2. Flyway V40 在测试环境的执行情况； +3. 实际测试数、Failures、Errors、Skipped； +4. OpenAPI 实际 paths/operations； +5. candidateKey 重算匹配与失效重新校验证据； +6. 7 天过期、30 天冷却、20/100 限额结果； +7. 并发创建/决策及会话唯一性； +8. 企业/学生权限矩阵； +9. 完整 JSON、审计、history 脱敏结果； +10. N+1 查询证明； +11. DIRECT 与 TALENT_INVITATION 会话规则回归； +12. 是否写 `candidate_dimension_scores`； +13. 是否修改 V1–V39； +14. 是否执行 Docker/MySQL 黑盒； +15. 当前 git status； +16. 明确说明未执行 `git add -A`、commit、push。 + +任何失败或 SKIP 必须如实报告，不得伪造 PASS。 diff --git a/docs/v43-candidate-scoring-fairness-design.md b/docs/v43-candidate-scoring-fairness-design.md new file mode 100644 index 0000000..9341993 --- /dev/null +++ b/docs/v43-candidate-scoring-fairness-design.md @@ -0,0 +1,173 @@ +# V43 候选评分公平性与稳定性监测：修订设计 + +文档类型：解释与技术参考。读者：负责人、后端开发及验收人员。 +状态：独立代码复验与真实 MySQL/Docker 验收通过，待 Git 检查点。 +编码前基线：V42，最新已核查迁移 V40，OpenAPI 167 paths / 205 operations；测试维护提交 498512d。实现后静态 OpenAPI 为 172 paths / 210 operations，自动化验证结果以本轮报告为准。 + +## 1. 第一版范围与修订结论 + +第一版只监测现存评分数据质量、分布、规则版本构成和申诉流程。仅 ADMIN 可读，无自动干预，无新 Flyway、表、调度器、feature flag 或公共错误码。不写 candidate_dimension_scores，不调用会触发评分重算/upsert的服务，不改变排名或申诉状态，不读取题目、答案、sub_scores_json、测评详情或 audit details，不接入 AI。 + +不推断性别、民族、年龄、家庭背景，不使用学校、城市、头像或姓名作为代理分组。结果不是人口统计公平性证明，也不能说明某条评分规则合理。置信标记只是运营样本等级，不是统计置信区间。 + +保留五个原提案 ADMIN GET 接口以保持监测契约；drift 和 ranking-stability 第一版明确不可用。不提供 jobId/companyId 或任意维度组合筛选；无 ACKNOWLEDGE/DISMISS，人工处置后续单独评审。实际编码前如发现与其他已批准文档冲突，先报告冲突。 + +## 2. 真实数据证据与可计算边界 + +| 来源/组件 | 实际结构或行为 | V43 口径 | +|---|---|---| +| candidate_dimension_scores / CandidateDimensionScore | UNIQUE(student_user_id,dimension,period)；score/status/weight/rules_version/calculated_at；period为yyyy-MM | 指定period在本次读取时仍存在的快照 | +| CandidateScoringCalculator.upsertSnapshots | ON DUPLICATE KEY覆盖分数、状态、规则版本、calculated_at；治理可重写历史period | calculated_at不是不可变评分事件时间；不据此重建过去窗口 | +| CandidateScoringCalculator.overallScoreFromSnapshots | OK/ESTIMATED且非空分数的等权算术平均，2位HALF_UP | 只读复用纯计算语义；不是任取权重的第二套公式 | +| CandidateScoringEngineService / GovernanceService | 评分查询/重算可能写快照 | 不作为V43读取入口 | +| candidate_scoring_appeals | PENDING/APPROVED/REJECTED/CANCELLED/ROLLED_BACK；created_at、reviewed_at、rollback_at、rules_version | 申诉创建队列当前状态，不冒充窗口结束时状态 | +| candidate_scoring_appeal_history | 状态转换、操作人、原因 | 本版无需读原因或操作人 | +| candidate_scoring_snapshot_history | ROLLBACK的before/after_score和before/after_rules_version | 仅已记录回滚变分，非全部纠错历史 | +| CompetitionRankingCalculator/Service | 按学生选最新period快照，排除WITHDRAWN/REJECTED；无持久化rank历史 | 当前无分候选可以在候选池，但rank=null；不能把入池当异常排名 | +| applications/jobs/companies | 可关联岗位与企业，但会引入重复候选和切片风险 | 本版不连接作筛选 | +| V37风险治理 / 企业评分Dashboard | 安全事件与业务聚合服务 | 不复用风险事件表，不复制企业个人级DTO | +| SecurityConfig / ErrorCode / GlobalExceptionHandler | 既有ADMIN认证、403/2002、参数400/1001约定 | 后续编码精确复用，验证真实响应 | + +现有迁移索引：V24有(student_user_id,dimension,period)唯一键、(student_user_id,period)、(dimension,period)；V25申诉有(candidate_user_id,status)、(status,created_at)，回滚历史有(candidate_user_id,dimension,period,created_at)。这些并不保证全局period或created_at聚合高效。上线前必须做真实EXPLAIN，不能仅因存在索引宣称覆盖。 + +可以计算：指定period的现存快照质量、分布、版本构成；指定创建窗口申诉的当前流程情况；已记录回滚的变分情况。 +不可计算：过去某时刻真实分布、等长历史分布漂移、长期PENDING持续时长、系统全体学生覆盖率、评分曝光口径的真实申诉率、实际历史rank变化、Top N进出率、“无有效评分却曾获rank”的事件数。统一用UNAVAILABLE及明确原因，不以0代替。 + +匿名聚合快照未来可支持分布趋势，但不能支持同一个人的rank变化或Top N成员进出；后者需另行评审受控关联标识和候选级历史，不能声称匿名汇总可以恢复。 + +## 3. 新实施计划 + +1. 固定现存快照样本、分母和统计纯函数；先写包含手算结果的测试。 +2. 实现受控只读聚合查询、混合版本检测和小样本抑制。 +3. 实现申诉队列状态及回滚变分指标；区分审核通过与实际变分。 +4. 接入ADMIN白名单DTO、五个接口及权限。 +5. 更新OpenAPI与联调文档，跑专项、全量和clean verify。 +6. 停止，报告待真实MySQL/Docker验收；后续独立验证EXPLAIN、性能、权限与无写入，再决定Git检查点。 + +## 4. 样本与分母 + +### 4.1 评分样本 + +period必填，yyyy-MM严格有效且不得晚于capturedNow所在月。统计一个period，禁止拼接多个period充足样本。响应声明basis=CURRENT_STORED_SNAPSHOTS、capturedAt和period，历史period也表示现在所存数据，不是当时数据。 + +U为该period至少有一条快照的独立student_user_id集合；N=COUNT(DISTINCT student_user_id)。不包含完全没有快照的学生，响应scope=SCORED_SNAPSHOT_POPULATION。八维固定为EDUCATION/INTERNSHIP/ABILITY/COMPLIANCE/STABILITY/GROWTH/INTEGRITY/ACTIVITY。 + +对每维d： +- rowCount为有该维行的候选数；missingRowCount=N-rowCount。 +- 各状态占比=statusCount/N；nullScoreRate为有行且score=null人数/N；missingRowRate为missingRowCount/N，两者不得混淆。 +- 有效分：状态OK或ESTIMATED且分数在[0,100]。validCoverage=validCount/N。 +- OK或ESTIMATED但空分、不可用状态却非空分、未知状态、越界分、未知规则版本单独计数，不修正原表。 +- 统计分布的sampleSize=有效分对应的独立候选数。不能用八维行数当人数。 + +总览：至少一个有效维度的候选数/N，命名computableSnapshotRatio。缺失不当0。 +sampleSize不足30的总体/切片隐藏比例和异常明细，仅返回人数、状态与原因。 + +### 4.2 综合分和规则版本 + +按同一候选、同一period组装全部现存八维，不跨月补齐。 +规则版本统一性检查涵盖所有现存维度行，包括PENDING： +- 恰好同一已知版本：按纯函数对有效维度求平均，2位HALF_UP；至少一个有效维度即可计算。 +- 多版本：MIXED；单独聚合候选数，排除V43综合分分布，不改V32的实际计算。 +- 单一未知版本：UNKNOWN；显示经脱敏的UNKNOWN汇总，不回原始异常字符串，不生成版本比较。 +- 已知版本v0.1/v0.2分别分组。综合分响应标明coherentVersionSubset；不能声称覆盖所有实际排名候选。 +- 维度分布按该行版本独立分组；这与综合分的全候选一致性检查分开。 + +不开放rulesVersion过滤参数，返回固定两种已知版本及UNKNOWN/MIXED汇总，避免构造自由切片。dimension可选但仅允许八维白名单。 + +## 5. 统计公式与输出 + +有效分排序x1…xn： +- mean=Σx/n。 +- 分位数采用线性插值：h=(n-1)p，i=floor(h)，f=h-i；Qp=x(i+1)+f*(x(min(i+2,n))-x(i+1))，p取0.1/0.25/0.5/0.75/0.9。 +- 总体标准差=sqrt(Σ(x-mean)^2/n)，不是样本标准差。中间BigDecimal使用DECIMAL128；最终2位HALF_UP。极小负数舍入误差应有明确容差处理，不吞掉其他错误。 +- min/max来自有效分，空集合全部null。 +- 十个桶：[0,10)、[10,20)…[80,90)、[90,100]，9.5归首桶，100归最后桶。 +- 比例=100*分子/分母，最终2位HALF_UP；分母0返回null与不可用原因，不能返回0%。 +- 风险比较使用未四舍五入的精确比例/数值，展示再舍入，避免69.995%显示70.00却触发70%边界。 +- 分桶集中率=max(bucketCount)/n。n>=30时>=70% WARNING、>=85% HIGH，优先HIGH；此为运营提示，不是歧视结论。 + +confidence：独立人数0–29 INSUFFICIENT_SAMPLE、30–99 LOW_CONFIDENCE、>=100 NORMAL_CONFIDENCE；riskLevel采用NORMAL/WARNING/HIGH/INSUFFICIENT_SAMPLE。UNAVAILABLE是availability字段，不混为风险级别。 +不适用的风险字段为null。缺失率增加15/25pp、均值差8/12分、纠正率20/35%仅保留后续提案，本版不启用，因为历史/分母尚不支持。 + +完整性异常必须分开呈现：`inconsistentRecordCount`（状态与分值是否为空不一致）、`unknownStatusCount`（未知状态）和 `outOfRangeScoreCount`（非空但不在0–100）。任何一个细分异常及其真实集合补集进入同一独立候选人抑制判断，不能用字段缺失或固定0代替。分布桶触发抑制时连同该分布的 `sampleSize`、统计量和风险一并隐藏。 + +不使用PSI或KS，不预留名为已计算但填0的假指标。 +结构异常只作完整性统计；异常计数存在不等于HIGH，第一版只对上述集中率给风险等级。 + +## 6. 申诉流程与变分 + +只允许已结束的完整业务日窗口from/to（Asia/Shanghai，日期，to不含）；默认最近30个完整日，最大90日，from=2条记录的独立候选人数；重复率=该人数/此队列独立申诉人数。明确这是窗口内重复，不是终身重复。 +- actualScoreChangeRate：只关联该队列的action=ROLLBACK历史；按appeal_id预聚合后JOIN，防止状态计数被历史行放大。同一appeal多条ROLLBACK视为该申诉不可比，但不排除同一候选人的其他合法申诉；禁止任取首条或末条。 +- 有且仅一条历史、前后分数均非空且在范围内、前后规则版本相同且已知，才进入comparableRollbackCount。 +- changedCount为after_score!=before_score；actualScoreChangeRate=changedCount/comparableRollbackCount。 +- delta=after-before，展示meanDelta和meanAbsoluteDelta；0差也计入分母。前后null单列不可比，规则不同单列versionChanged，不把规则升级变分称为纠错。 +- 审核通过、回滚执行、分数变化均不能独立证明原评分错误。该指标名称不得写为“纠错准确率”。 +- 每种比率除事件分母外，必须检查其实际分母集合的独立人数>=30；同一候选人的多份合法申诉可贡献多条行，但候选人数只计一次；不足则抑制。 +- 真实申诉率需要可比的受评/曝光人群分母，本版UNAVAILABLE，不用当前快照数除历史申诉数。 + +第一版不返回申诉dimension/rulesVersion切片，避免样本稀疏和自由组合；后续另行评审。只读取scalar所需字段，不取reason、decision_reason、reviewer_id、actor_user_id、audit details。 + +## 7. 接口契约 + +| GET路径 | 参数 | 返回核心 | +|---|---|---| +| /admin/scoring/fairness/overview | period | 现存快照人数、完整性、综合分可计算比例、版本构成、综合分分布 | +| /admin/scoring/fairness/dimensions | period、可选dimension | 固定八维及已知版本的覆盖率、状态、分布 | +| /admin/scoring/fairness/drift | 无业务参数 | availability=UNAVAILABLE、reason=IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE | +| /admin/scoring/fairness/ranking-stability | 无业务参数 | availability=UNAVAILABLE、reason=RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE | +| /admin/scoring/fairness/appeals | 可选成对from/to | 创建队列当前状态、审核/回滚/变分指标 | + +接口沿用ApiResponse，缺失指标为null附reason；样本不足使用正常200，不伪造零值。非法/未知查询参数按400/1001处理（包括jobId/companyId/rulesVersion/granularity），防止“参数被忽略”误解。非法角色403/2002，匿名401。 + +固定五个path/五个operation，若基线167/205不变则目标172/210。选择保留两个能力不可用接口是为了明确监测能力缺口，不代表历史监测实现。前端需显示“暂无历史数据”，不能显示正常绿色。 + +## 8. 隐私与查询限制 + +所有切片依据独立人数做门槛检查。主群体不足30时隐藏均值、极值、标准差、分位数、桶、比例、状态/版本/异常明细。只回sampleSize、availability和原因。 + +人数足够也需单元格抑制：桶、状态、版本、异常计数为1–29时隐藏计数及比例；总计与其他公开单元格能反推隐藏单元时做互补抑制（实现可直接抑制整组明细）。为减少小数精度恢复个体信息，包含被抑制桶的分布组一并隐藏其mean/min/max/stddev/quantiles和集中风险。这是保守聚合保护，不宣称差分隐私保证。 + +版本分布按“版本总体—该版本有效集合—该版本无效补集”独立判定：某个版本的有效集合或补集不足30人时，该版本的Distribution返回`SUPPRESSED`且不含任何数值统计；其他满足门槛的版本仍可返回可用分布。只要存在版本级受保护单元，`versionCounts`及其可推算的整体版本计数一并隐藏；若全局总体本身触发抑制，则整个版本分布组隐藏。这样既不暴露99/1版本内补集，也不因一个不安全版本而无差别吞掉安全的70/30版本统计。 + +相邻窗口/月份集合仍可能差分推断。第一版限制参数组合、仅完整日窗口、复用ADMIN访问限流；不提供候选下钻、导出或自由groupBy。该方案不是任意重复查询下的匿名性证明。 + +禁止学生/企业及公开入口，禁止所有个人ID、姓名、学校、联系方式、性别/年龄、简历、测评、题目、答案、审计详情和凭据出现在DTO、响应和应用日志。内部COUNT DISTINCT可使用用户ID，但不得从Repository返回到HTTP。 + +## 9. 查询实现与性能 + +每请求同一capturedNow和同一只读事务；不得调用computeAll、getOverview或其他可能重算的既有入口。 +- 快照总体：period过滤，SQL按学生内部去重，生成N；使用固定八维集合LEFT JOIN补missingRow。 +- 维度状态：GROUP BY dimension,rules_version,status；可比得分GROUP BY dimension,rules_version,score形成频数。 +- 分位数/标准差从score频数累积计算，不展开为每候选列表；中间数据仅score+frequency。 +- 综合分可通过SQL按候选period作无身份返回的内部聚合，再输出score频数；必须与既有纯函数对账，不能改变生产排名公式。 +- 申诉：各分母集合COUNT DISTINCT，回滚历史先按appeal预聚合并形成候选级聚合记录；固定次数查询，不逐人/逐维查询，不把重复历史申诉关联的候选人从其他合法申诉中整体剔除。 +- 建议预算总览<=4、维度<=3、申诉<=5、不可用接口0条业务查询；权限查询单列计数。测试在30/300/3000人及8维下验证。 +- 对真实MySQL核查period、created_at扫描/排序/临时表、执行耗时与数据量。最大90日不等于行数上限；建议查询timeout=5秒、已有错误映射返回失败且不截断样本，不伪装无数据。性能不达标先报告，不擅自新增索引/迁移。 +- 现有索引不足的迁移建议必须另行批准；本版绝不修改V1–V40。 + +## 10. 测试与验收计划 + +1. 0/29/30/99/100独立人数；同一人8维和多period不凑30人。 +2. 缺行与空分分别统计；全无快照人不在分母且scope准确。 +3. 9.5/10/89.99/90/100分桶、分位数手算样例、总体标准差、HALF_UP。 +4. 零分母null；精确70/85%风险边界；69.995%不提前升级。 +5. OK/ESTIMATED空分、PENDING非空、越界、未知状态、未知版本。 +6. MIXED候选排除V43综合分；与生产纯函数同版本结果对账。 +7. 同月upsert后记录变化，drift仍UNAVAILABLE，不伪造之前分数；历史月也声明现存快照。 +8. APPROVED但未回滚、ROLLED_BACK但分不变、真实变分、跨规则/空分、重复回滚历史、JOIN不放大。 +9. 申诉队列状态变更后口径正确；重复申诉去重；事件数>=30但人数<30仍抑制。 +10. 小样本和互补抑制，响应不出现被抑制明细或可反推比例。 +11. ADMIN/匿名/STUDENT/COMPANY；真实HTTP JSON脱敏；不直接返回Entity。 +12. 非法period/未来period/非法dimension/未知参数/超90日/from>=to/仅一个日期参数。 +13. 固定查询次数、无答案/JSON明细表读取；无新业务查询的UNAVAILABLE接口。 +14. candidate_dimension_scores及申诉/审计/风险表前后内容与版本不变（不能只测行数）。 +15. V25/V32/V37/V38/V39/V41/V42回归；OpenAPI静态/运行时172/210对账。 +16. 真实MySQL EXPLAIN、并发只读查询一致性、超时不返回假成功。 + +四项阻断的针对性补证已完成：正式 Service 在30/300/3000人下业务SQL为2/2/1/0/0；精确60人61份申诉HTTP夹具、五接口逐一完整内容只读检查及综合分舍入/PENDING版本对账均已通过。独立代码复验、真实 MySQL/Docker、运行时 OpenAPI、EXPLAIN 和 30/300/3000 人性能验收均已执行；EXPLAIN 暴露的全表扫描/filesort 作为后续容量风险保留。历史漂移与排名稳定性继续按 UNAVAILABLE 返回。 diff --git a/docs/v43-implementation-instruction.md b/docs/v43-implementation-instruction.md new file mode 100644 index 0000000..4b4b7dc --- /dev/null +++ b/docs/v43-implementation-instruction.md @@ -0,0 +1,111 @@ +# V43 给 Luna 的编码指令（整改版） + +实施状态：实现完成，独立代码复验与真实 MySQL/Docker 验收通过，待 Git 检查点。 + +### 本轮四项阻断的可执行证据 + +- `FairnessMonitoringPersistenceIntegrationTest.realServiceJdbcBudgetAt30_300_3000WithEightDimensionsAndMultipleAppeals`：Spring 管理的真实 Service 事务代理、真实 Repository/权限仓库和 `@Primary` JDBC 计数数据源；30/300/3000 人、每人八维和两份合法回滚申诉。业务查询分别为 overview=2、dimensions=2、appeals=1、drift/ranking-stability=0；权限查询逐接口单列为2。夹具与验证查询不在计数区间。每个版本仅返回一个同分频数，申诉返回最终汇总。 +- `FairnessMonitoringHttpIntegrationTest.realHttpAppealsHidesSmallComparableChangeGroup`：60 人各一份非法分数回滚，其中一人在 GROWTH 另有合法回滚；真实 SQL 断言61份申诉、60人、60人非法分数、1条/1人可比、重复申诉人数0，再通过真实 HTTP 检查变分统计全部隐藏。 +- 同一非空申诉夹具中，五个接口各自独立比较调用前后完整表内容（包含 version），涉及评分、申诉、申诉历史、回滚历史、非空回滚限流、审计和四张风险治理表。原全局99/1测试亦在两个接口之间分别比较。 +- `FairnessMonitoringPersistenceIntegrationTest.sqlOverallMatchesPureFunctionForPartialRepeatingHalfUpAndPendingVersions`：1/2/3个有效维度、空分PENDING、10.005的HALF_UP、10.003333…及10.006666…；SQL结果逐例与既有评分纯函数对账。仅修改PENDING行版本即判MIXED，仍保留有效覆盖人数。 + +以上为 H2 自动化证据，不代表真实 MySQL EXPLAIN、运行时 OpenAPI 或性能验收通过。 + +2026-09-09 最终复验：V43专项60/60；全量 `mvn test` 与 `mvn clean verify` 均1535项，Failures=0、Errors=0、Skipped=0，构建成功。OpenAPI静态及运行时均为172 paths / 210 operations。真实MySQL完成权限、隐私、只读性、查询预算与30/300/3000人规模验收；未提交或推送。 + +文档类型：执行指南。先完整阅读同目录v43-candidate-scoring-fairness-design.md修订版；不要沿用旧版“calculated_at可恢复历史漂移”的结论。 + +## 1. 任务与基线 + +项目C:/Users/15642/Desktop/zhilai，实现V43候选评分公平性与稳定性监测。 +先读取项目适用AGENTS.md，执行git status --short、git diff --cached --name-only、git log -5 --oneline；核查最新迁移和OpenAPI。已知维护提交498512d、最新业务V42、Flyway V40、OpenAPI167/205，均须实测而非假设。 +保护现有暂存与未跟踪文件。禁止reset/restore/checkout、git add -A、commit、push、删除移动历史文件。若已有V43实现，先评审差异，不覆盖他人修改。 + +本任务授权代码、自动化、正式文档；实现完成后需停止在本版本，不启动/停止Docker，不执行真实MySQL黑盒，不结束未知Java进程，不进入V44。当前实现结果须以自动化验证报告为准，真实黑盒仍待负责人另行安排。 + +## 2. 实现边界 + +无新增Flyway、数据库表、后台任务、feature flag、公共错误码，不改V1–V40迁移。 +只允许ADMIN聚合查询，无学生/企业入口，无写入、自动调分/排名/权重/封禁/申诉处理。 +不读答案、题目、测评详情、sub_scores_json、audit details，不接AI。 +不得调用CandidateScoringEngineService.getOverview、computeAll、upsertSnapshots等可能写快照入口。只读纯函数可以复用。 +学校/城市/姓名不得作为敏感属性代理。 + +## 3. 接口范围 + +新增五个GET： +- /admin/scoring/fairness/overview：period必填。 +- /admin/scoring/fairness/dimensions：period必填，dimension可选八维白名单。 +- /admin/scoring/fairness/drift：无业务参数，固定UNAVAILABLE。 +- /admin/scoring/fairness/ranking-stability：无业务参数，固定UNAVAILABLE。 +- /admin/scoring/fairness/appeals：成对可选from/to日期，默认最近30个完整业务日，最大90日。 + +drift原因IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE；排名原因RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE。 +无数据、不可计算、小样本是不同状态，不全部返回0或NORMAL。 +匿名401，其他角色403/2002；参数400/1001。拒绝jobId/companyId/rulesVersion/granularity及其他未知业务参数。 +如果实际基线167/205，最终172/210；不得通过删路径满足数字。 + +## 4. 必须先落实的统计规则 + +以设计第4–6节为唯一口径，写测试后实现： +1. period指定一个月份。快照是“当前所存版本”，calculated_at会被覆盖，不支持历史窗口恢复。 +2. N是该period至少一行快照的独立学生数。无快照全体学生不在范围，响应明确scope。 +3. 每维缺行、空分、有效分、状态分别统计，分母和去重按设计，不把八维行数当人数。 +4. 分布有效分为OK/ESTIMATED且0–100。统计sampleSize是独立人数。 +5. 同候选所有现存维度跨规则版本即MIXED，排除V43综合分分布；单一未知版本归UNKNOWN。其计数受小样本保护。 +6. 同版本综合分对有效维度等权平均，2位HALF_UP，与现有overallScoreFromSnapshots测试对账，不改V32。 +7. 分位数线性插值、总体标准差、十个连续小数分桶、零分母null；内部DECIMAL128，输出2位HALF_UP。 +8. 风险先用未舍入值比较。只启用分桶集中70/85%运营提示。旧版缺失率差、均值差、纠正率阈值本版不启用。 +9. 不足30独立人抑制明细；30–99 LOW_CONFIDENCE，100以上NORMAL_CONFIDENCE。 +10. 1–29的桶/状态/版本/异常计数抑制整组，防止补集反推。被抑制桶的关联均值/极值/分位数/集中风险也隐藏。 +11. 分别使用availability/confidence/riskLevel，不把UNAVAILABLE放入风险等级。 +12. 维度DTO必须独立返回 `inconsistentRecordCount`、`unknownStatusCount` 和 `outOfRangeScoreCount`；分布一旦触发桶/补集抑制，`sampleSize` 与所有统计字段、分桶及风险均置空，只保留availability/reason。 + +## 5. 申诉与回滚 + +按created_at选[from,to)创建队列，展示截至capturedAt的当前状态，不叫历史日终状态。 +APPROVED+ROLLED_BACK才是审核通过数。分别实现通过率、回滚执行率、实际变分率，严禁三者互换。 +申诉主表先统计，历史先按appeal_id聚合后关联，不因JOIN重复计数。 +仅唯一ROLLBACK历史、前后分非空有效、前后同一已知规则版本的申诉进入可比变分分母；重复历史只排除该申诉，不排除同一候选人的其他合法申诉。变分率包括0差的分母；规则升级不算纠错。 +每个比率同时校验该分母人群>=30独立人。重复申诉按同人同维同period的窗口内记录判断。真实曝光申诉率UNAVAILABLE。 +不读原文、管理员身份；不提供申诉自由切片。 + +## 6. 组件与性能 + +建议新建独立scoringmonitoring包：Controller、Service、只读查询组件、纯统计计算器及白名单DTO；命名遵循仓库惯例。 +SQL参数绑定；GROUP BY聚合、score频数而非全量个人实体；固定查询次数，不能逐维或逐候选findById。 +总览<=4、维度<=3、申诉<=5条业务查询为目标预算，角色查询单计；UNAVAILABLE接口0条业务查询。同一请求capturedNow、同一只读事务。 +实现可解释超时处理，不能截断样本返回成功。真实EXPLAIN在后续黑盒验证；不擅自补索引或迁移。 +小样本统计数值不得绕过统一抑制组件从另一个 DTO 字段泄露。 +整改实现要求由独立、可测试的 `FairnessDisclosureGuard` 统一执行小样本与互补抑制；有效集合或其补集为 1–29 人时，相关整组统计字段必须一并隐藏。 +不回任何个人/申诉/答卷/结果ID、联系方式、学校、性别、简历、答案或内部JSON。完整序列化测试，不能只检查toString。 + +## 7. 自动化 + +必须完整实现设计第10节测试。尤其： +- 多行同一人不能绕过30人门槛； +- 9.5/100分桶、手算分位数和标准差、69.995%风险边界； +- 混合版本与未知版本； +- 同月覆盖不能生成历史漂移； +- APPROVED未回滚、回滚0差、跨版本、空分、重复历史和JOIN放大； +- 多次申诉不足30独立人； +- 互补抑制、非法筛选、权限和完整JSON脱敏； +- 快照和申诉表内容/版本不变，而非只测行数； +- 无N+1及既有V25/V32/V37/V38/V39/V41/V42回归。 + +## 8. 文档、验证与停止 + +更新本设计实施状态、路线图、frontend-integration.md；新增docs/candidate-scoring-fairness-api.md。编码完成后才更新openapi-rc.json和verify_openapi.py： +五个GET恰好5path/5operation；全部200响应有真实schema；查询参数准确；schema不含个人敏感字段；两个不可用接口契约准确。 + +执行： +~~~powershell +mvn -Dtest="*Fairness*Test,*ScoringMonitoring*Test" test +mvn test +mvn clean verify +python docs/verify_openapi.py +~~~ +测试通配符必须匹配实际新增类，不得以0测试成功。clean verify若被运行JAR阻塞，报告已核实PID和原因，不擅自停止。 +报告真实测试总数、Failures/Errors/Skipped、精确文件清单、无新增迁移、OpenAPI计数、统计口径及数据限制、小样本保护、无写入和查询预算证据、Git状态。 +真实MySQL/Docker未执行必须写待验收，运行时OpenAPI未启动核验不得声称通过。 +完成后停止，保持所有本轮变更未暂存，未提交未推送。 diff --git a/docs/v43-independent-mysql-acceptance-20260909.md b/docs/v43-independent-mysql-acceptance-20260909.md new file mode 100644 index 0000000..dbad280 --- /dev/null +++ b/docs/v43-independent-mysql-acceptance-20260909.md @@ -0,0 +1,147 @@ +# V43 候选评分公平性与稳定性监测：独立复验与真实环境验收 + +日期：2026-09-09 +结论：**PASS，可进入精确暂存检查点** + +## 1. 验收范围与 Git 基线 + +本轮只做独立代码复验、自动化验证和真实环境验收；未修改 V43 生产代码、测试、Flyway、OpenAPI 或既有业务数据。 + +- HEAD：`498512d test: stabilize career progress date-sensitive test` +- 最近提交：V42 `96b3113`、V41 `5cc2c86`、V40 `2698d06`、V39 `55e3975` +- 暂存区：为空 +- 当前 tracked 修改：`docs/backend-development-roadmap.md`、`docs/frontend-integration.md`、`docs/openapi-rc.json`、`docs/verify_openapi.py` +- V43 生产代码、测试和文档：未跟踪文件/未提交状态 +- 历史验收脚本、日志、请求体、临时文件和 `.env` 相关文件均保留，未删除、移动或覆盖 +- `git diff --check`：无错误，仅报告现有文件的 LF/CRLF 提示 + +验收阶段未执行 `git add -A`、commit、push、reset、restore、checkout，也未启动或停止 Docker Desktop；使用负责人已启动且健康的 MySQL、Redis、RabbitMQ 容器。最终复验时最新 Java 应用在 8080 运行且健康检查为 HTTP 200，后续是否停止由负责人决定。 + +## 2. Flyway、OpenAPI 与代码结构核查 + +- 迁移目录最新文件：`V40__enterprise_talent_invitations.sql` +- 未发现 V41/V42/V43 新 Flyway +- 静态 OpenAPI：**172 paths / 210 operations**；`python docs/verify_openapi.py` 全部通过 +- V43 保留且仅保留五个 ADMIN GET： + - `/admin/scoring/fairness/overview` + - `/admin/scoring/fairness/dimensions` + - `/admin/scoring/fairness/drift` + - `/admin/scoring/fairness/ranking-stability` + - `/admin/scoring/fairness/appeals` +- 五个接口均有非空 200 响应 schema；静态校验覆盖聚合响应结构和 V43 路径计数 + +生产包 `com.mydreamjob.scoringmonitoring` 中未发现写入、删除、候选评分重算/upsert、排名重算或 Controller 外的公开接口。V43 查询不写 `candidate_dimension_scores`，也不发送消息。 + +## 3. 阶段 A：独立代码审查 + +### A1 只读边界：PASS（静态 + H2） + +Controller 只有五个 GET。`drift` 和 `ranking-stability` 直接返回 `UNAVAILABLE`；服务不会调用评分重算/upsert。H2 HTTP 集成测试逐接口比较了相关评分、申诉、历史、审计和风险表的内容/版本，未发现 V43 写入。 + +### A2 无双轨实现：PASS（静态 + 测试） + +`FairnessMonitoringService.overview` 仅调用 `findOverviewAggregateData`，空结果由正式聚合对象处理；`appeals` 仅调用 `findAppealAggregateSummary`。未发现“聚合为空时回退明细查询”的生产分支。Repository 返回总体/版本聚合、受控分组和 score-frequency，而不是候选人或申诉明细。 + +### A3 小样本抑制：PASS（H2 独立复现） + +`FairnessDisclosureGuard` 对总体、有效集合、补集、版本内集合、状态集合、可比回滚集合、实际变分集合和不可比原因集合执行独立候选人数门槛，并同步抑制可反推的嵌套分布、均值、分位数、标准差、分桶和风险字段。保留允许公开的总体人口数，并区分 `AVAILABLE`、`INSUFFICIENT_SAMPLE`、`SUPPRESSED`、`UNAVAILABLE` 等状态。 + +`FairnessIndependentReviewTest` 两个历史缺陷复现均通过： + +- `smallComparablePopulationMustHideAllChangeStatistics` +- `versionLocalComplementMustNotLeakThroughVersionPopulationAndDistribution` + +`FairnessMonitoringHttpIntegrationTest` 还覆盖全局 99/1、版本内补集、非空申诉小样本及不可用接口。 + +### A4 版本口径：PASS（真实 MySQL 黑盒复验） + +有效覆盖率按“至少一个有效维度的独立候选人数 / period 总体人数”计算；MIXED/UNKNOWN 不被当作无效分，PENDING 维度参与整体版本一致性判断；同一已知版本的综合分布分开统计。未读取答案、题目或评分规则。 + +真实 MySQL 夹具（v0.1：100 人，99 有效/1 无效；v0.2：100 人，70 有效/30 无效；总体 200 人）复验结果：v0.1 版本组及可反推字段正确标记为 `SUPPRESSED`，不返回 sampleSize、均值、分位数、分桶或风险；v0.2 版本组保持 `AVAILABLE`，sampleSize=70、mean=83.50。顶层 `populationSize=200` 保留，`versionCounts` 等联合可反推字段隐藏。overview 与 dimensions 联合响应不能还原 v0.1 的 1 人补集。 + +### A5 申诉统计：PASS（H2） + +回滚历史按 `appeal_id` 统计，重复历史进入独立不可比分类；审核通过、回滚执行和实际变分分开计算；零差值保留在可比分母；一名候选人的不可比申诉不会排除其其他合法申诉。相关服务和持久化测试覆盖同人多申诉、重复历史、跨版本、空/越界分数及输入顺序变化。 + +### A6 SQL/性能结构：PASS（代码结构、H2、真实 MySQL 查询预算与 3000 人规模） + +Repository 使用参数绑定、数据库聚合、score-frequency 结果和每条 JDBC 查询局部 `setQueryTimeout(5)`；没有修改共享 JdbcTemplate 超时配置或生成无限 IN 参数。真实 MySQL 通过临时启用 performance_schema statement history（验收后恢复原值）测得业务 SQL 数：overview=2、dimensions=2、appeals=1、drift/ranking=0，且在 30/300/3000 人规模下保持不变。3000 人实测最慢为 appeals 358ms。`EXPLAIN FORMAT=JSON` 同时显示 dimensions 聚合以及部分回滚历史读取存在全表扫描/filesort/temporary；当前验收规模无性能阻断，但这是生产扩容风险，后续应通过新迁移评估针对性索引，本轮未改既有迁移或数据库结构。 + +## 4. 自动化复验 + +| 命令 | 实际结果 | +|---|---| +| `mvn -Dtest=FairnessIndependentReviewTest,FairnessMonitoringHttpIntegrationTest test` | 7 tests，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS | +| V43 专项复验 | 60 tests，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS | +| `mvn test` | 1535 tests，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS | +| `mvn clean verify` | 1535 tests，Failures=0，Errors=0，Skipped=0，BUILD SUCCESS | +| `python docs/verify_openapi.py` | PASS，172 paths / 210 operations | +| `git diff --check` | 无 diff 错误 | + +H2 真实服务端集成测试包含： + +- `realHttpPathSuppresses99Of100ComplementAcrossOverviewAndDimensions` +- `realHttpFiveEndpointsUseRealAdminPermissionAndUnavailablePathsDoNotWrite` +- `realHttpSuppressesVersionLocalComplementAcrossOverviewAndDimensions` +- `realHttpAppealsHidesSmallComparableChangeGroup` + +这些测试经过真实 MockMvc → Service → Repository → H2 SQL；仅 Controller 契约测试使用 Mock Service，报告未将其冒充为真库验收。 + +## 5. Docker/MySQL 阶段：PASS + +只读检查结果： + +- Docker Desktop/Engine：可用；Client/Server 29.6.2，Docker Desktop 4.84.0 +- MySQL：`mysql:8.4`，实际版本 `8.4.11`，容器 healthy，映射 3307 +- Redis：`redis:7.4-alpine`，healthy +- RabbitMQ：`rabbitmq:3.13-management-alpine`，healthy +- Flyway：V40 `enterprise talent invitations`，`success=1`；V43 迁移行数为 0 +- 应用：最新 JAR 启动成功，`ddl-auto=validate`，8080 监听；健康检查 HTTP 200 +- 运行时 OpenAPI：`/api/v1/v3/api-docs` 为 **172 paths / 210 operations** +- RabbitMQ 队列真实存在且 ready/unacked 均为 0：`queue.sms.verification`、`queue.notification`、`queue.audit`、`queue.notification.dlq` + +真实查询预算和规模结果（权限查询、夹具写入及验收查询不计入业务 SQL）： + +| 候选人数 | overview | dimensions | appeals | +|---:|---:|---:|---:| +| 30 | 2 SQL / 67ms | 2 SQL / 38ms | 1 SQL / 46ms | +| 300 | 2 SQL / 70ms | 2 SQL / 60ms | 1 SQL / 53ms | +| 3000 | 2 SQL / 99ms | 2 SQL / 177ms | 1 SQL / 358ms | + +`drift` 与 `ranking-stability` 均为 0 条业务 SQL。验收夹具已按精确前缀清理，相关用户残留数为 0；performance_schema consumer 已恢复为验收前状态。 + +## 6. 真实 HTTP 与夹具证据 + +五接口逐请求结果（真实 MySQL）： + +- ADMIN：五个接口均 `200/200` +- STUDENT：五个接口均 `403/2002` +- COMPANY：五个接口均 `403/2002` +- 未登录：五个接口均 `401/401` +- 完整 JSON 敏感字段扫描：五接口均未发现禁止字段 +- 逐接口表摘要：overview、dimensions、drift、ranking-stability、appeals 均未发现接口自身写入；风险定时器关闭后摘要稳定 +- `drift` 与 `ranking-stability` 均返回 `UNAVAILABLE` + +真实夹具结果： + +- 2026-07 总体 200 人，v0.1=99/1、v0.2=70/30：v0.1 正确抑制，v0.2 保持可用，跨接口不能反推小补集 +- 2026-03 100 人 99/1：总体抑制符合预期 +- 2026-02 100 人 1/99：总体抑制符合预期 +- 2026-06 29 人：`INSUFFICIENT_SAMPLE` +- 2026-05 30 人全有效：`AVAILABLE`，分布可见 +- 2026-04 30 人全无效：无有效分布，未发现个人字段泄露 +- 申诉 2026-09-07：30 名候选中 1 名重复回滚历史，比较组 29 人，相关变分字段被抑制 +- 申诉 2026-09-08：同一候选同时有合法申诉和重复历史申诉，接口未泄露个人信息；敏感比较组因原因小单元受到抑制 + +已验证：V43 生产代码无明细回退、H2 SQL 聚合与小样本抑制、独立失败复现、真实 Service/Repository H2 HTTP、静态与运行时 OpenAPI、自动化回归、真实 MySQL 启动、真实权限和 RabbitMQ 队列。 + +真实 MySQL 查询预算、30/300/3000 性能曲线、运行时 OpenAPI、权限、只读性和 RabbitMQ 终态均已完成。EXPLAIN 暴露的全表扫描/filesort 属扩容风险，不构成本次 3000 人规模验收失败。 + +## 7. 验收判定 + +**最终结论：PASS。V43 独立代码复验与真实 MySQL/Docker 黑盒在本次范围内通过，可以进入精确暂存检查点。** + +- 功能、权限、隐私、小样本抑制、申诉集合、只读性、运行时契约和 3000 人规模查询预算均无发布阻断； +- FAIL=0，核心验收项无 SKIP； +- 不声称已证明无限数据规模性能；EXPLAIN 中的全表扫描/filesort 作为上线容量观察项和后续索引优化候选保留； +- V43 不新增 Flyway，不写 `candidate_dimension_scores`，不改变评分、排名和申诉状态机。 diff --git a/docs/validate_ability_bank.py b/docs/validate_ability_bank.py new file mode 100644 index 0000000..9b8ae59 --- /dev/null +++ b/docs/validate_ability_bank.py @@ -0,0 +1,224 @@ +# -*- coding: utf-8 -*- +""" +V36 四维能力测评 题库权威校验脚本 + +两个目标： +1) 独立校验权威题库 ability-question-bank-v0.1.json 满足全部 14 项硬性约束。 +2) 将 V35__ability_assessment.sql 中写入的 48 道题与权威 JSON 逐题对账， + 确保题干/选项/答案键/分值/解析/难度/版本/position 语义完全一致。 + +任一项校验失败 => 打印 FAIL 并退出码 1（不自动修复题库内容）。 +全部通过 => 打印 PASS（针对每道题）并退出码 0。 +""" +import json +import re +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +BANK_JSON = ROOT / "docs" / "ability-question-bank-v0.1.json" +V35_SQL = ROOT / "mydreamjob-server" / "src" / "main" / "resources" / "db" / "migration" / "V35__ability_assessment.sql" + +DIMENSIONS = ["LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"] +COMPETENCY_TAGS = { + "LOGIC": ["INFORMATION_ANALYSIS", "CAUSAL_REASONING", "PROBLEM_SOLVING"], + "COMMUNICATION": ["LISTENING_UNDERSTANDING", "STRUCTURED_EXPRESSION", "COLLABORATION_CONFLICT"], + "EXECUTION": ["PLANNING_PRIORITIZATION", "RISK_FOLLOWUP", "DELIVERY_REVIEW"], + "LEARNING": ["INFORMATION_ACQUISITION", "FEEDBACK_REFLECTION", "TRANSFER_ADAPTATION"], +} +SCORES = {0, 1, 2, 4} +OPTION_IDS = ["A", "B", "C", "D"] + + +def fail(msg): + print(f"FAIL: {msg}") + sys.exit(1) + + +def check(cond, msg): + if not cond: + fail(msg) + print(f" PASS: {msg}") + + +def main(): + print("=== 第 1 步：校验权威 JSON 文件 ===") + bank = json.loads(BANK_JSON.read_text(encoding='utf-8')) + if bank.get("bankCode") != "WORKPLACE_ABILITY": + fail("bankCode != WORKPLACE_ABILITY") + if bank.get("bankVersion") != "ability-v0.1": + fail("bankVersion != ability-v0.1") + + qs = bank.get("questions", []) + check(len(qs) == 48, f"总数 = 48（实际 {len(qs)}）") + + # 1) 四维各 12 + dim_count = {d: 0 for d in DIMENSIONS} + pos_set = set() + tag_count = {} + key_count = {} + dif_count = {} + for q in qs: + dim_count[q["dimension"]] = dim_count.get(q["dimension"], 0) + 1 + tag_count[q["competencyTag"]] = tag_count.get(q["competencyTag"], 0) + 1 + key_count[q["answerKey"]] = key_count.get(q["answerKey"], 0) + 1 + dif_count[q["difficulty"]] = dif_count.get(q["difficulty"], 0) + 1 + pos_set.add(q["position"]) + for d in DIMENSIONS: + check(dim_count.get(d) == 12, f"维度 {d} = 12（实际 {dim_count.get(d)}）") + for tag in sum(COMPETENCY_TAGS.values(), []): + check(tag_count.get(tag) == 4, f"competencyTag {tag} = 4（实际 {tag_count.get(tag)}）") + for k in OPTION_IDS: + check(key_count.get(k) == 12, f"answerKey {k} = 12（实际 {key_count.get(k)}）") + for d in ["EASY", "MEDIUM", "HARD"]: + check(dif_count.get(d) == 16, f"difficulty {d} = 16（实际 {dif_count.get(d)}）") + check(len(pos_set) == 48 and pos_set == set(range(1, 49)), + "position 1-48 唯一且连续") + + # 2) 逐题约束 + for q in qs: + code = q["questionCode"] + opts = q["options"] + # 每题四选一 + check(len(opts) == 4, f"{code} 含 4 个选项") + oids = [o["optionId"] for o in opts] + check(oids == OPTION_IDS, f"{code} optionId 集合 = A/B/C/D") + for o in opts: + if not o.get("text") or not str(o["text"]).strip(): + fail(f"{code} 存在空选项文本") + # 分值集合严格等于 {0,1,2,4} + rule = q["scoringRule"] + check(sorted(rule.keys()) == OPTION_IDS, f"{code} scoringRule 键 = A/B/C/D") + check(set(rule.values()) == SCORES, f"{code} 分值集合 = {{0,1,2,4}}（实际 {sorted(set(rule.values()))}）") + check(len(set(rule.values())) == 4, f"{code} 分值互不相同（每题各档唯一）") + # answerKey 对应 4 分 + check(rule.get(q["answerKey"]) == 4, f"{code} answerKey={q['answerKey']} 对应 4 分") + # explanation 非空 + check(bool(q.get("explanation")) and str(q["explanation"]).strip(), f"{code} explanation 非空") + # 版本/来源/启用 + check(q["questionVersion"] == "ability-v0.1", f"{code} questionVersion=ability-v0.1") + check(q["source"] == "SELF_AUTHORED", f"{code} source=SELF_AUTHORED") + check(q["active"] is True, f"{code} active=true") + check(q["dimension"] in DIMENSIONS, f"{code} dimension 合法") + check(q["competencyTag"] in COMPETENCY_TAGS.get(q["dimension"], []), f"{code} competencyTag 归属该维度") + check(q["itemType"] in ("SITUATIONAL_JUDGMENT", "SEQUENCE_JUDGMENT"), f"{code} itemType 合法") + + print("=== 第 2 步：V35 SQL 与权威 JSON 逐题对账 ===") + sql = V35_SQL.read_text(encoding='utf-8') + # 抓取 definition INSERT 中 WORKPLACE_ABILITY 的系数行 + defn_pat = ("'WORKPLACE_ABILITY'[\\s\\S]*?'ACTIVE',[\\s\\S]*?" + "48,\\s*24,\\s*6,\\s*30,\\s*7,\\s*90,\\s*3," + "[\\s\\S]*?'ability-v0.1'[\\s\\S]*?'ability-scoring-v0.1'\\s*,?\\s*\\)") + defn_m = re.search(defn_pat, sql) + if not defn_m: + fail("V35 中缺少 WORKPLACE_ABILITY 定义种子（48/24/6/30/7/90/3）") + print(" PASS: WORKPLACE_ABILITY 定义种子存在且参数一致") + + # 抓取 ability_questions 的整段 VALUES（一直抓到文件结尾） + values_m = re.search(r"INSERT INTO ability_questions[\s\S]*?VALUES\s*(.*)$", sql, re.S) + if not values_m: + fail("V35 中缺少 ability_questions INSERT") + body = values_m.group(1) + # 每个 VALUES 行以 "('XXNN'" 起始，且独占一行；逐行拆分 + rows = [] + for line in body.splitlines(): + m = re.match(r"\s*\(\s*'([A-Z]{2}\d{2})'(.+)\)\s*,?;?\s*$", line) + if m: + rows.append((m.group(1), m.group(2))) + + def clean(v): + v = v.strip() + if v.startswith("'") and v.endswith("'"): + v = v[1:-1] + return v.replace("''", "'") + + def parse_json(v): + return json.loads(clean(v)) + + if len(rows) != 48: + fail(f"V35 中题目行数 = {len(rows)}（应为 48）") + # 拆分字段：code 单独；其余依次为 + # def_subquery, dimension, competency_tag, item_type, stem, + # options_json, answer_key_json, scoring_rule_json, explanation, + # difficulty, discrimination, question_version, source, active, position + by_pos = {} + for code, rest in rows: + parts = split_row(rest) + # rest 以 "(SELECT..." 起始，首字段为 definition_id 子查询，且行首逗号会产生一个空 token； + # 去除空 token 后即为 [def_subquery, dimension, ..., position] + if parts and parts[0] == "": + parts = parts[1:] + if len(parts) != 15: + fail(f"{code} 解析出 {len(parts)} 个字段（应为 15）") + by_pos[int(parts[14])] = (code, parts) + if set(by_pos.keys()) != set(range(1, 49)): + fail("V35 中 position 不覆盖 1-48") + + for q in qs: + code = q["questionCode"] + pos = q["position"] + row = by_pos.get(pos) + if row is None: + fail(f"position {pos}（{code}）在 V35 中缺失") + sql_code, parts = row + if sql_code != code: + fail(f"position {pos}：V35 questionCode={sql_code}，权威 JSON={code}") + + # definition_id（parts[0]）为子查询，跳过比较 + sql_dim, sql_tag, sql_item, sql_stem = parts[1], parts[2], parts[3], parts[4] + sql_opts, sql_key, sql_rule, sql_expl = parts[5], parts[6], parts[7], parts[8] + sql_dif = parts[9] + sql_ver, sql_src, sql_active, sql_pos = parts[11], parts[12], parts[13], parts[14] + + def eq_a(actual, expect, label): + if actual != expect: + fail(f"{code} {label} 不一致") + + eq_a(clean(sql_dim), q["dimension"], "dimension") + eq_a(clean(sql_tag), q["competencyTag"], "competencyTag") + eq_a(clean(sql_item), q["itemType"], "itemType") + eq_a(clean(sql_stem), q["stem"], "stem") + eq_a(parse_json(sql_opts), q["options"], "options_json") + eq_a(parse_json(sql_key), dict(answerKey=q["answerKey"]), "answer_key_json") + eq_a(parse_json(sql_rule), q["scoringRule"], "scoring_rule_json") + eq_a(clean(sql_expl), q["explanation"], "explanation") + eq_a(clean(sql_dif), q["difficulty"], "difficulty") + eq_a(clean(sql_ver), q["questionVersion"], "question_version") + eq_a(clean(sql_src), q["source"], "source") + eq_a(clean(sql_active), "1", "active") + eq_a(clean(sql_pos), str(q["position"]), "position") + print(f" PASS: {code} 与权威 JSON 完全一致") + + print("ALL PASS: 题库 14 项硬性约束 + V35 SQL 逐题对账全部通过") + sys.exit(0) + + +def split_row(rest): + """把一行剩余部分按顶层逗号切分（忽略引号内的逗号）。""" + out = [] + buf = [] + in_sq = False + i = 0 + body = rest + while i < len(body): + c = body[i] + if c == "'": + if in_sq and i + 1 < len(body) and body[i + 1] == "'": + buf.append("''") + i += 2 + continue + in_sq = not in_sq + buf.append(c) + elif c == "," and not in_sq: + out.append("".join(buf).strip()) + buf = [] + else: + buf.append(c) + i += 1 + if buf: + out.append("".join(buf).strip()) + return out + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/docs/verify_openapi.py b/docs/verify_openapi.py index 1f4d60e..af2a7db 100644 --- a/docs/verify_openapi.py +++ b/docs/verify_openapi.py @@ -6,74 +6,63 @@ p = PROJECT_ROOT / 'docs' / 'openapi-rc.json' d = json.load(open(p, encoding='utf-8')) print('paths:', len(d['paths'])) +assert len(d['paths']) == 182, f"Expected 182 paths, got {len(d['paths'])}" paths = d['paths'] -onboarding_paths = [ - '/onboarding/companies/{companyId}/checklist', - '/onboarding/companies/{companyId}/checklist/items/{itemId}/completion', - '/onboarding/companies/{companyId}/knowledge', - '/onboarding/company/checklist-items', - '/onboarding/company/checklist-items/{itemId}', - '/onboarding/company/knowledge', -] -for path in onboarding_paths: - assert path in paths, f'Missing onboarding path: {path}' - -onboarding_operations = { - ('/onboarding/companies/{companyId}/checklist', 'get'): 'getEffectiveChecklist', - ('/onboarding/companies/{companyId}/checklist/items/{itemId}/completion', 'put'): 'updateCompletion', - ('/onboarding/companies/{companyId}/knowledge', 'get'): 'getCompanyKnowledgeOverview', - ('/onboarding/company/checklist-items', 'get'): 'listCompanyChecklistItems', - ('/onboarding/company/checklist-items', 'post'): 'createCompanyChecklistItem', - ('/onboarding/company/checklist-items/{itemId}', 'put'): 'updateCompanyChecklistItem', - ('/onboarding/company/checklist-items/{itemId}', 'delete'): 'deleteCompanyChecklistItem', - ('/onboarding/company/knowledge', 'get'): 'getCompanyKnowledge', - ('/onboarding/company/knowledge', 'put'): 'upsertCompanyKnowledge', -} -http_methods = {'get', 'post', 'put', 'patch', 'delete', 'options', 'head', 'trace'} -for (path, method), operation_id in onboarding_operations.items(): - assert method in paths[path], f'Missing {method.upper()} {path}' - assert paths[path][method].get('operationId') == operation_id, f'Wrong operationId for {method.upper()} {path}' - matching_operations = [ - (candidate_method, candidate_path) - for candidate_path, path_item in paths.items() - for candidate_method, operation in path_item.items() - if candidate_method in http_methods - and operation.get('operationId') == operation_id - ] - assert matching_operations == [(method, path)], ( - f'{operation_id} must be globally unique: expected {method.upper()} {path}, got {matching_operations}' - ) - assert paths[path][method].get('security') == [{'bearerAuth': []}], ( - f'{method.upper()} {path} must require bearerAuth' - ) -assert sum( - 1 - for path_item in paths.values() - for method in path_item - if method in http_methods -) == 178, 'Expected 178 operations after N05 salary calculator' - -assert len(d['paths']) == 139, f"Expected 139 paths, got {len(d['paths'])}" - -required_salary_paths = ['/salary-calculator/cities','/salary-calculator/cities/{cityCode}','/salary-calculator/calculations','/salary-calculator/calculations/{id}'] -for path in required_salary_paths: - assert path in paths, f'Missing salary path: {path}' - -salary_operations = { - ('/salary-calculator/cities', 'get'): 'listSalaryCities', - ('/salary-calculator/cities/{cityCode}', 'get'): 'getSalaryCity', - ('/salary-calculator/calculations', 'post'): 'calculateSalary', - ('/salary-calculator/calculations', 'get'): 'listSalaryCalculations', - ('/salary-calculator/calculations/{id}', 'get'): 'getSalaryCalculation', - ('/salary-calculator/calculations/{id}', 'delete'): 'deleteSalaryCalculation', -} -for (path, method), operation_id in salary_operations.items(): - assert method in paths[path], f'Missing {method.upper()} {path}' - assert paths[path][method].get('operationId') == operation_id, f'Wrong operationId for {method.upper()} {path}' - assert paths[path][method].get('security') == [{'bearerAuth': []}], f'{method.upper()} {path} must require bearerAuth' + +# Generic OpenAPI integrity checks. These catch importer-breaking structures +# before business-specific path/count assertions run. +HTTP_METHODS = {'get', 'put', 'post', 'delete', 'patch', 'options', 'head', 'trace'} + +def resolve_local_ref(document, ref): + assert isinstance(ref, str) and ref.startswith('#/'), f'Invalid local $ref: {ref!r}' + node = document + for token in ref[2:].split('/'): + token = token.replace('~1', '/').replace('~0', '~') + assert isinstance(node, dict) and token in node, f'Unresolved $ref: {ref}' + node = node[token] + return node + +def validate_refs(node, location='$'): + if isinstance(node, dict): + for key, value in node.items(): + child = f'{location}.{key}' + if key == '$ref': + assert isinstance(value, str) and value, f'$ref must be a string at {child}' + if value.startswith('#/'): + resolve_local_ref(d, value) + validate_refs(value, child) + elif isinstance(node, list): + for index, value in enumerate(node): + validate_refs(value, f'{location}[{index}]') + +validate_refs(d) +operation_ids = {} +used_tags = set() +for route, path_item in paths.items(): + for method, operation in path_item.items(): + if method.lower() not in HTTP_METHODS: + continue + assert isinstance(operation, dict), f'Invalid operation: {method.upper()} {route}' + assert not (method.lower() == 'get' and 'requestBody' in operation), \ + f'GET must not contain requestBody: {route}' + if 'parameters' in operation: + assert isinstance(operation['parameters'], list), \ + f'parameters must be an array: {method.upper()} {route}' + operation_id = operation.get('operationId') + if operation_id: + operation_ids.setdefault(operation_id, []).append(f'{method.upper()} {route}') + used_tags.update(operation.get('tags', [])) + +duplicates = {key: value for key, value in operation_ids.items() if len(value) > 1} +assert not duplicates, f'Duplicate operationId values: {duplicates}' +declared_tags = {tag['name'] for tag in d.get('tags', [])} +assert used_tags <= declared_tags, f'Undeclared operation tags: {sorted(used_tags - declared_tags)}' required = [ + # Phase A 企业注册与入驻聚合（2 个 path / 2 个 operation） + '/auth/company/register', + '/companies/me/onboarding', '/review-weight-templates', '/profile/me/review-weights', '/profile/me/privacy', @@ -130,13 +119,31 @@ required = [ '/admin/reports', '/admin/reports/{id}', '/admin/reports/{id}/decision', - '/skills/word-cloud', - '/skills/match', - '/skills/learning-path', - '/salary-calculator/cities', - '/salary-calculator/cities/{cityCode}', - '/salary-calculator/calculations', - '/salary-calculator/calculations/{id}', + # V34/V35 RIASEC 职业兴趣测评（8 个 path / 8 个 operation） + '/assessments/types', + '/assessments/{type}/questions', + '/assessments/attempts', + '/assessments/attempts/{attemptId}', + '/assessments/attempts/{attemptId}/answers', + '/assessments/attempts/{attemptId}/submit', + '/assessments/attempts/{attemptId}/result', + '/assessments/me', + # V36 四维能力测评（7 个 path / 7 个 operation） + '/abilities/types', + '/abilities/attempts', + '/abilities/attempts/{attemptId}', + '/abilities/attempts/{attemptId}/answers', + '/abilities/attempts/{attemptId}/submit', + '/abilities/attempts/{attemptId}/result', + '/abilities/me', + # V37 风险概览与运营规则配置（7 个 path / 7 个 operation，仅 ADMIN） + '/admin/scoring/risk/overview', + '/admin/scoring/risk/trend', + '/admin/scoring/risk/distribution', + '/admin/scoring/risk/events', + '/admin/scoring/risk/rules', + '/admin/scoring/risk/rules/{ruleCode}', + '/admin/scoring/risk/events/{eventId}/actions', ] for path in required: assert path in paths, f"Missing path: {path}" @@ -206,143 +213,503 @@ assert 'get' in paths['/admin/reports'], "Missing GET /admin/reports" assert 'get' in paths['/admin/reports/{id}'], "Missing GET /admin/reports/{id}" assert 'post' in paths['/admin/reports/{id}/decision'], "Missing POST /admin/reports/{id}/decision" print(" V33 report/block endpoints present (9 operations / 8 paths)") +# V34/V35 RIASEC 测评（8 个 path / 8 个 operation） +assert 'get' in paths['/assessments/types'], "Missing GET /assessments/types" +assert 'get' in paths['/assessments/{type}/questions'], "Missing GET /assessments/{type}/questions" +assert 'post' in paths['/assessments/attempts'], "Missing POST /assessments/attempts" +assert 'get' in paths['/assessments/attempts/{attemptId}'], "Missing GET /assessments/attempts/{attemptId}" +assert 'patch' in paths['/assessments/attempts/{attemptId}/answers'], "Missing PATCH .../answers" +assert 'post' in paths['/assessments/attempts/{attemptId}/submit'], "Missing POST .../submit" +assert 'get' in paths['/assessments/attempts/{attemptId}/result'], "Missing GET .../result" +assert 'get' in paths['/assessments/me'], "Missing GET /assessments/me" +print(" V34/V35 RIASEC assessment endpoints present (8 operations / 8 paths)") +# V36 四维能力测评（7 个 path / 7 个 operation） +assert 'get' in paths['/abilities/types'], "Missing GET /abilities/types" +assert 'post' in paths['/abilities/attempts'], "Missing POST /abilities/attempts" +assert 'get' in paths['/abilities/attempts/{attemptId}'], "Missing GET /abilities/attempts/{attemptId}" +assert 'patch' in paths['/abilities/attempts/{attemptId}/answers'], "Missing PATCH .../answers" +assert 'post' in paths['/abilities/attempts/{attemptId}/submit'], "Missing POST .../submit" +assert 'get' in paths['/abilities/attempts/{attemptId}/result'], "Missing GET .../result" +assert 'get' in paths['/abilities/me'], "Missing GET /abilities/me" +print(" V36 ability assessment endpoints present (7 operations / 7 paths)") + +# ---- V36 严格断言：正好 7 path / 7 operation；无 /abilities/{type}/questions；requestBody+200 schema；无题库内部字段 ---- +assert '/abilities/{type}/questions' not in paths, "GET /abilities/{type}/questions must NOT exist" +v36_paths = sorted([k for k in paths if k.startswith('/abilities')]) +assert len(v36_paths) == 7, f"Expected exactly 7 /abilities paths, got {len(v36_paths)}" +v36_ops = sum(len(paths[k]) for k in v36_paths) +assert v36_ops == 7, f"Expected exactly 7 /abilities operations, got {v36_ops}" +print(f" V36 exactly 7 paths / 7 operations: {v36_paths}") + +ABILITY_200 = { + '/abilities/types': ('get', 'ApiResponseAbilityTypeResponse'), + '/abilities/attempts': ('post', 'ApiResponseAbilityAttemptResponse'), + '/abilities/attempts/{attemptId}': ('get', 'ApiResponseAbilityAttemptResponse'), + '/abilities/attempts/{attemptId}/answers': ('patch', 'ApiResponseAbilityAttemptResponse'), + '/abilities/attempts/{attemptId}/submit': ('post', 'ApiResponseAbilityResultResponse'), + '/abilities/attempts/{attemptId}/result': ('get', 'ApiResponseAbilityResultResponse'), + '/abilities/me': ('get', 'ApiResponsePageResponseAbilityHistoryItem'), +} + + +def response_ref(op): + return op.get('responses', {}).get('200', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref', '') + + +for pt, (method, expect_ref) in ABILITY_200.items(): + ref = response_ref(paths[pt][method]) + assert ref.endswith(expect_ref), f"{method.upper()} {pt}: expected 200 ref ...{expect_ref}, got {ref}" +print(" All 7 V36 success responses reference a schema") -# Skill cloud endpoints (3 paths / 3 GET operations) -for skill_path in ('/skills/word-cloud', '/skills/match', '/skills/learning-path'): - assert 'get' in paths[skill_path], f"Missing GET {skill_path}" -skill_operation_ids = { - '/skills/word-cloud': 'getWordCloud', - '/skills/match': 'getSkillMatch', - '/skills/learning-path': 'getLearningPath', +for pt, (method, schema_name) in { + '/abilities/attempts': ('post', 'CreateAbilityAttemptRequest'), + '/abilities/attempts/{attemptId}/answers': ('patch', 'SaveAbilityAnswersRequest')}.items(): + rb = paths[pt][method].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref', '') + assert rb.endswith(schema_name), f"{method.upper()} {pt}: expected requestBody ref ...{schema_name}, got {rb}" +print(" POST/PATCH V36 request bodies reference a schema") + +# 题库内部字段不得出现在 Ability 相关 schema +for f in ['questionCode', 'competencyTag', 'answerKey', 'scoringRule']: + for name, sch in d['components']['schemas'].items(): + if name.startswith('Ability') and f in json.dumps(sch): + assert False, f"schema {name} exposes forbidden field {f}" +print(" Ability schemas expose no questionCode/competencyTag/answerKey/scoringRule") + +# V37 风险接口 operation 存在性 +assert 'get' in paths['/admin/scoring/risk/overview'], "Missing GET overview" +assert 'get' in paths['/admin/scoring/risk/trend'], "Missing GET trend" +assert 'get' in paths['/admin/scoring/risk/distribution'], "Missing GET distribution" +assert 'get' in paths['/admin/scoring/risk/events'], "Missing GET events" +assert 'get' in paths['/admin/scoring/risk/rules'], "Missing GET rules" +assert 'put' in paths['/admin/scoring/risk/rules/{ruleCode}'], "Missing PUT rules/{ruleCode}" +assert 'post' in paths['/admin/scoring/risk/events/{eventId}/actions'], "Missing POST events/{eventId}/actions" +print(" V37 risk endpoints present (7 operations / 7 paths)") + +# ---- V37 严格断言：正好 7 path / 7 operation；请求/响应 schema；无企业/学生风险接口；Risk schema 无敏感字段 ---- +vk = [k for k in paths if k.startswith('/admin/scoring/risk')] +assert len(vk) == 7, f"Expected exactly 7 V37 paths, got {len(vk)}" +assert sum(len(paths[k]) for k in vk) == 7, "Expected exactly 7 V37 operations" +# 不得新增企业/学生风险接口 +for k in paths: + if k.startswith('/scoring/risk') or k.startswith('/risk'): + assert False, f"unexpected student/company risk endpoint {k}" +print(f" V37 exactly 7 paths / 7 operations: {vk}") + +RISK_200 = { + '/admin/scoring/risk/overview': 'ApiResponseRiskOverviewResponse', + '/admin/scoring/risk/trend': 'ApiResponseRiskTrendResponse', + '/admin/scoring/risk/distribution': 'ApiResponseRiskDistributionResponse', + '/admin/scoring/risk/events': 'ApiResponsePageResponseRiskEventResponse', + '/admin/scoring/risk/rules': 'ApiResponseListRiskRuleResponse', + '/admin/scoring/risk/rules/{ruleCode}': 'ApiResponseRiskRuleResponse', + '/admin/scoring/risk/events/{eventId}/actions': 'ApiResponseRiskEventResponse', } -for skill_path, skill_operation_id in skill_operation_ids.items(): - assert paths[skill_path]['get'].get('operationId') == skill_operation_id - http_methods = {'get', 'post', 'put', 'patch', 'delete', 'options', 'head', 'trace'} - matching_operations = [ - (method, path) - for path, path_item in paths.items() - for method, operation in path_item.items() - if method in http_methods - and operation.get('operationId') == skill_operation_id - ] - assert matching_operations == [('get', skill_path)], ( - f'{skill_operation_id} must not conflict: expected GET {skill_path}, got {matching_operations}' - ) -assert paths['/skills/word-cloud']['get']['responses']['200']['content']['application/json']['schema']['$ref'] == '#/components/schemas/ApiResponseSkillCloudResponse' -assert paths['/skills/match']['get']['responses']['200']['content']['application/json']['schema']['$ref'] == '#/components/schemas/ApiResponseSkillMatchResponse' -assert paths['/skills/learning-path']['get']['responses']['200']['content']['application/json']['schema']['$ref'] == '#/components/schemas/ApiResponseSkillLearningPathResponse' - -for skill_path in ('/skills/word-cloud', '/skills/match', '/skills/learning-path'): - unauthorized = paths[skill_path]['get']['responses']['401'] - assert unauthorized['description'] == '未登录或令牌无效，由全局 Security 入口返回裸 JSON' - assert unauthorized['content']['application/json']['schema']['$ref'] == '#/components/schemas/UnauthorizedResponse' - example = unauthorized['content']['application/json']['example'] - assert example == {'code': 401, 'message': 'not authenticated', 'timestamp': ''} - assert 'requestId' not in example - -schemas = d['components']['schemas'] -unauthorized_schema = schemas.get('UnauthorizedResponse') -assert unauthorized_schema is not None, 'Missing schema: UnauthorizedResponse' -assert unauthorized_schema.get('additionalProperties') is False -assert set(unauthorized_schema.get('required', [])) == {'code', 'message', 'timestamp'} -assert set(unauthorized_schema.get('properties', {})) == {'code', 'message', 'timestamp'} -skill_schema_fields = { - 'SkillCloudNode': {'id', 'code', 'name'}, - 'SkillCloudItem': {'rank', 'skillId', 'skillCode', 'nameZh', 'nameEn', 'sourceType', 'sourceCode', 'categoryId', 'categoryName', 'heat', 'heatSourceCode', 'heatElementId', 'heatProxy'}, - 'SkillCloudResponse': {'industry', 'occupation', 'category', 'total', 'items'}, - 'SkillMatchResponse': {'matchScore', 'matchedCount', 'totalCount', 'matchedSkills', 'missingSkills'}, - 'SkillLearningPathItem': {'priority', 'skillId', 'skillName', 'categoryId', 'categoryName', 'suggestion'}, - 'SkillLearningPathResponse': {'total', 'items'}, +for pt, expect_ref in RISK_200.items(): + method = 'put' if pt.endswith('{ruleCode}') else ('post' if pt.endswith('actions') else 'get') + ref = response_ref(paths[pt][method]) + assert ref.endswith(expect_ref), f"{method.upper()} {pt}: expected 200 ref ...{expect_ref}, got {ref}" +print(" All 7 V37 success responses reference a schema") + +for pt in ('/admin/scoring/risk/rules/{ruleCode}', '/admin/scoring/risk/events/{eventId}/actions'): + method = 'put' if pt.endswith('{ruleCode}') else 'post' + rb = paths[pt][method].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref', '') + assert rb != '', f"{method.upper()} {pt} requestBody schema missing" +print(" PUT/POST V37 request bodies reference a schema") + +risk_forbidden = ['subjectUserId', 'subject_user_id', 'operatorUserId', 'operator_user_id', 'phone', 'email', 'ipAddress', 'userAgent', 'details', 'token', 'password', 'secret'] +for f in risk_forbidden: + for name, sch in d['components']['schemas'].items(): + if name.startswith('Risk') and f in json.dumps(sch): + assert False, f"schema {name} exposes forbidden field {f}" +print(" Risk schemas expose no subjectUserId/operatorUserId/phone/email/ip/userAgent/details/credentials") + +# V39 测评驱动岗位推荐：6 path / 8 operation；学生反馈、企业画像、ADMIN 审核与公开受控字典。 +v39 = [ + '/job-recommendation-taxonomies', + '/profile/me/job-recommendations', + '/profile/me/job-recommendations/{jobId}/feedback', + '/companies/me/jobs/{jobId}/recommendation-profile', + '/admin/job-recommendation-profiles', + '/admin/job-recommendation-profiles/{jobId}/decision', +] +assert all(k in paths for k in v39), "One or more V39 paths are missing" +assert len(v39) == 6, f"Expected exactly 6 V39 paths, got {len(v39)}" +assert sum(len(paths[k]) for k in v39) == 8, "Expected exactly 8 V39 operations" +for pt, method in [ + ('/job-recommendation-taxonomies', 'get'), + ('/profile/me/job-recommendations', 'get'), + ('/profile/me/job-recommendations/{jobId}/feedback', 'post'), + ('/profile/me/job-recommendations/{jobId}/feedback', 'delete'), + ('/companies/me/jobs/{jobId}/recommendation-profile', 'get'), + ('/companies/me/jobs/{jobId}/recommendation-profile', 'put'), + ('/admin/job-recommendation-profiles', 'get'), + ('/admin/job-recommendation-profiles/{jobId}/decision', 'post'), +]: + assert method in paths[pt], f"Missing {method.upper()} {pt}" +for pt, method in [ + ('/profile/me/job-recommendations/{jobId}/feedback', 'post'), + ('/companies/me/jobs/{jobId}/recommendation-profile', 'put'), + ('/admin/job-recommendation-profiles/{jobId}/decision', 'post'), +]: + assert paths[pt][method].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref'), f"{method.upper()} {pt} requestBody schema missing" +recommendation_sensitive = ['answerKey', 'scoringRule', 'questionCode', 'competencyTag', 'resultId', 'attemptId', 'studentUserId'] +for f in recommendation_sensitive: + for name, sch in d['components']['schemas'].items(): + if name.startswith(('JobRecommendation', 'Recommendation')) and f in json.dumps(sch): + assert False, f"schema {name} exposes forbidden field {f}" +print(" V39 exactly 6 paths / 8 operations; recommendation schemas are redacted") + +# V40 企业评价官方回复：5 paths / 6 operations；企业、管理员和公开回复均为白名单载荷。 +v40 = [ + '/companies/me/job-reviews', + '/companies/me/job-reviews/{reviewId}', + '/companies/me/job-reviews/{reviewId}/reply', + '/admin/review-replies/pending', + '/admin/review-replies/{replyId}/decision', +] +assert all(k in paths for k in v40), "One or more V40 paths are missing" +assert len(v40) == 5, f"Expected exactly 5 V40 paths, got {len(v40)}" +assert sum(len(paths[k]) for k in v40) == 6, "Expected exactly 6 V40 operations" +for pt, method in [ + ('/companies/me/job-reviews', 'get'), + ('/companies/me/job-reviews/{reviewId}', 'get'), + ('/companies/me/job-reviews/{reviewId}/reply', 'post'), + ('/companies/me/job-reviews/{reviewId}/reply', 'put'), + ('/admin/review-replies/pending', 'get'), + ('/admin/review-replies/{replyId}/decision', 'post'), +]: + assert method in paths[pt], f"Missing {method.upper()} {pt}" +for pt, method in [ + ('/companies/me/job-reviews/{reviewId}/reply', 'post'), + ('/companies/me/job-reviews/{reviewId}/reply', 'put'), + ('/admin/review-replies/{replyId}/decision', 'post'), +]: + assert paths[pt][method].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref'), f"{method.upper()} {pt} requestBody schema missing" +for pt, method in [ + ('/companies/me/job-reviews', 'get'), + ('/companies/me/job-reviews/{reviewId}', 'get'), + ('/admin/review-replies/pending', 'get'), + ('/companies/me/job-reviews/{reviewId}/reply', 'post'), + ('/companies/me/job-reviews/{reviewId}/reply', 'put'), + ('/admin/review-replies/{replyId}/decision', 'post'), +]: + response = paths[pt][method].get('responses', {}).get('200', {}) + assert response.get('content', {}).get('application/json', {}).get('schema', {}).get('$ref'), f"{method.upper()} {pt} 200 schema missing" +v40_sensitive = ['studentUserId', 'phone', 'email', 'ipAddress', 'userAgent', 'moderationScore', 'reasonCodes'] +for name in ('CompanyReviewItemResponse', 'CompanyReviewDetailResponse', 'CompanyReviewReplyResponse', 'ReviewReplyPageResponse'): + assert name in d['components']['schemas'], f"Missing V40 schema {name}" + text_schema = json.dumps(d['components']['schemas'][name]) + for field in v40_sensitive: + assert field not in text_schema, f"V40 company schema {name} exposes {field}" +assert 'officialReply' not in json.dumps(d['components']['schemas']['CompanyReviewReplyResponse']) +print(" V40 exactly 5 paths / 6 operations; request/response schemas are present and redacted") + +# V41 企业人才发现：2 个唯一 path / 3 个 operation（学生 GET/PUT 共享一个 path）。 +v41 = [ + '/profile/me/talent-discovery', + '/companies/me/jobs/{jobId}/talent-recommendations', +] +assert all(k in paths for k in v41), "One or more V41 paths are missing" +assert len(v41) == 2, f"Expected exactly 2 V41 paths, got {len(v41)}" +assert sum(len(paths[k]) for k in v41) == 3, "Expected exactly 3 V41 operations" +assert 'get' in paths[v41[0]] and 'put' in paths[v41[0]], "V41 preference GET/PUT missing" +assert 'get' in paths[v41[1]], "V41 talent recommendation GET missing" +assert paths[v41[0]]['put'].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref'), "V41 PUT requestBody schema missing" +for pt, method in [(v41[0], 'get'), (v41[0], 'put'), (v41[1], 'get')]: + assert response_ref(paths[pt][method]), f"{method.upper()} {pt} 200 schema missing" +candidate_schema = json.dumps(d['components']['schemas']['TalentDiscoveryCandidateResponse']) +for f in ['studentUserId', 'candidateId', 'phone', 'email', 'resumeUrl', 'attemptId', 'resultId', + 'answerKey', 'scoringRule', 'questionCode', 'competencyTag', 'dimensionScores', + 'overallScore', 'percentile', 'fitScore', 'gender', 'birthDate', 'password', 'token']: + assert f not in candidate_schema, f"V41 candidate schema exposes {f}" +assert 'candidateKey' in candidate_schema and 'studentUserId' not in candidate_schema +print(" V41 exactly 2 paths / 3 operations; candidate card schema is redacted") + +# V42 企业人才邀约：6 个唯一 path / 6 个 operation。 +v42 = [ + '/companies/me/jobs/{jobId}/talent-invitations', + '/companies/me/talent-invitations', + '/companies/me/talent-invitations/{invitationId}', + '/profile/me/talent-invitations', + '/profile/me/talent-invitations/{invitationId}', + '/profile/me/talent-invitations/{invitationId}/decision', +] +assert all(k in paths for k in v42), "One or more V42 paths are missing" +assert len(v42) == 6, f"Expected exactly 6 V42 paths, got {len(v42)}" +assert sum(len(paths[k]) for k in v42) == 6, "Expected exactly 6 V42 operations" +assert 'post' in paths[v42[0]], "V42 company invitation POST missing" +assert 'get' in paths[v42[1]] and 'get' in paths[v42[2]], "V42 company GET endpoints missing" +assert 'get' in paths[v42[3]] and 'get' in paths[v42[4]], "V42 student GET endpoints missing" +assert 'post' in paths[v42[5]], "V42 student decision endpoint missing" +for pt, method in [(v42[0], 'post'), (v42[5], 'post')]: + assert paths[pt][method].get('requestBody', {}).get('content', {}).get('application/json', {}).get('schema', {}).get('$ref'), f"{method.upper()} {pt} requestBody schema missing" +for pt, method in [(v42[0], 'post'), (v42[1], 'get'), (v42[2], 'get'), (v42[3], 'get'), (v42[4], 'get'), (v42[5], 'post')]: + assert response_ref(paths[pt][method]), f"{method.upper()} {pt} 200 schema missing" +for name in ('CompanyTalentInvitationResponse', 'StudentTalentInvitationResponse', 'TalentInvitationPageResponseCompanyTalentInvitationResponse', 'TalentInvitationPageResponseStudentTalentInvitationResponse'): + assert name in d['components']['schemas'], f"Missing V42 schema {name}" +company_invitation_schema = json.dumps(d['components']['schemas']['CompanyTalentInvitationResponse']) +for f in ['studentUserId', 'candidateKey', 'candidateKeyDigest', 'activeKey', 'moderationScore', 'reasonCodes', 'fitScore']: + assert f not in company_invitation_schema, f"V42 company invitation schema exposes {f}" +print(" V42 exactly 6 paths / 6 operations; invitation schemas are present and redacted") + +# V43 候选评分公平性与稳定性监测：5 个 ADMIN 聚合 GET，历史漂移/排名稳定性首版明确 UNAVAILABLE。 +v43 = [ + '/admin/scoring/fairness/overview', + '/admin/scoring/fairness/dimensions', + '/admin/scoring/fairness/drift', + '/admin/scoring/fairness/ranking-stability', + '/admin/scoring/fairness/appeals', +] +assert all(k in paths for k in v43), "One or more V43 fairness paths are missing" +assert len(v43) == 5, f"Expected exactly 5 V43 paths, got {len(v43)}" +assert all('get' in paths[k] for k in v43), "V43 operations must all be GET" +assert sum(len(paths[k]) for k in v43) == 5, "Expected exactly 5 V43 operations" +assert paths[v43[0]]['get'].get('parameters'), "V43 overview period parameter missing" +assert paths[v43[1]]['get'].get('parameters'), "V43 dimensions parameters missing" +for pt, schema in [ + (v43[0], 'ApiResponseFairnessResponseOverview'), + (v43[1], 'ApiResponseFairnessResponseDimensions'), + (v43[2], 'ApiResponseFairnessResponseUnavailable'), + (v43[3], 'ApiResponseFairnessResponseUnavailable'), + (v43[4], 'ApiResponseFairnessResponseAppeals'), +]: + assert response_ref(paths[pt]['get']).endswith(schema), f"GET {pt} 200 schema missing" +for name in ('FairnessResponseOverview', 'FairnessResponseDimensions', 'FairnessResponseUnavailable', 'FairnessResponseAppeals'): + assert name in d['components']['schemas'], f"Missing V43 schema {name}" +v43_forbidden = ['studentUserId', 'applicationId', 'candidateId', 'phone', 'email', 'resumeUrl', + 'answerKey', 'scoringRule', 'questionCode', 'subScoresJson', 'auditDetails', + 'token', 'password', 'ipAddress', 'userAgent', 'appealId', 'reviewerId'] +def resolve_schema(value, seen=None): + """递归展开 V43 schema 的 $ref/properties/items，避免只校验顶层漏掉嵌套字段。""" + seen = set() if seen is None else seen + if isinstance(value, dict) and '$ref' in value: + ref = value['$ref'] + if ref.startswith('#/components/schemas/'): + name = ref.rsplit('/', 1)[-1] + if name in seen: + return {} + seen.add(name) + return resolve_schema(d['components']['schemas'].get(name, {}), seen) + if isinstance(value, dict): + return {k: resolve_schema(v, seen.copy()) for k, v in value.items()} + if isinstance(value, list): + return [resolve_schema(v, seen.copy()) for v in value] + return value + +for name, sch in d['components']['schemas'].items(): + if name.startswith('FairnessResponse'): + encoded = json.dumps(resolve_schema(sch), ensure_ascii=False) + for field in v43_forbidden: + assert field not in encoded, f"V43 schema {name} exposes {field}" +for name, required_fields in { + 'FairnessResponseOverview': ['availability', 'reason', 'distributionsByRulesVersion', 'coherentVersionSubset'], + 'FairnessResponseDimensions': ['availability', 'reason'], + 'FairnessResponseDimensionMetric': ['availability', 'reason', 'unknownStatusCount', 'outOfRangeScoreCount'], + 'FairnessResponseDistribution': ['availability', 'reason'], + 'FairnessResponseAppeals': ['availability', 'reason', 'appealCount', 'statusCounts', 'statusEventCounts', 'statusCandidateCounts', 'comparableRollbackCount', 'comparableRollbackCandidateCount', + 'duplicateRollbackHistoryCount', 'invalidScoreRollbackCount', 'ruleVersionChangedRollbackCount'], +}.items(): + props = d['components']['schemas'][name].get('properties', {}) + for field in required_fields: + assert field in props, f"V43 schema {name} missing explicit field {field}" +assert d['components']['schemas']['FairnessResponseDistribution']['properties']['availability']['type'] == 'string' +assert d['components']['schemas']['FairnessResponseAppeals']['properties']['appealCount']['type'] == 'integer' +assert '独立候选人数' in d['components']['schemas']['FairnessResponseAppeals']['properties']['comparableRollbackCandidateCount'].get('description', '') +assert '/admin/scoring/fairness/overview' in paths +print(" V43 exactly 5 paths / 5 operations; aggregate fairness schemas are redacted") + +# N02 候选评分解释增强：只扩展学生评分载荷，企业评分卡保持原有白名单。 +student_overview = d['components']['schemas']['CandidateScoringOverviewResponse'] +overview_props = student_overview.get('properties', {}) +for field in ('explanationVersion', 'coverage', 'comparabilityNotice'): + assert field in overview_props, f'CandidateScoringOverviewResponse missing {field}' +detail_props = d['components']['schemas']['DimensionScoreDetailResponse'].get('properties', {}) +for field in ('displayName', 'whatItMeasures', 'interpretation', 'limitations', 'evidenceLevel', + 'ruleContributions', 'improvementActions', 'explanationVersion', 'validity', 'calculatedAt'): + assert field in detail_props, f'DimensionScoreDetailResponse missing {field}' +assert overview_props['coverage'].get('$ref', '').endswith('CandidateScoringCoverage') +assert detail_props['validity'].get('$ref', '').endswith('CandidateScoringValidity') +assert detail_props['ruleContributions'].get('items', {}).get('$ref', '').endswith('CandidateScoringRuleContribution') + +student_explanation_forbidden = [ + 'sourceResultId', 'attemptId', 'resultId', 'questionSetId', 'questionCode', + 'answerKey', 'scoringRule', 'competencyTag', 'selectedOptionId', 'stem', + 'studentUserId', 'phone', 'email', 'resumeUrl', 'token', 'password' +] +for name in ('CandidateScoringOverviewResponse', 'CandidateScoringCoverage', + 'CandidateScoringExcludedDimension', 'DimensionScoreDetailResponse', + 'CandidateScoringRuleContribution', 'CandidateScoringValidity'): + assert name in d['components']['schemas'], f'Missing N02 schema {name}' + encoded = json.dumps(resolve_schema(d['components']['schemas'][name]), ensure_ascii=False) + for field in student_explanation_forbidden: + assert field not in encoded, f'N02 schema {name} exposes forbidden field {field}' + +company_schema_text = json.dumps(resolve_schema(d['components']['schemas']['CompanyCandidateScoringResponse']), ensure_ascii=False) +for field in ('explanationVersion', 'coverage', 'comparabilityNotice', 'displayName', 'ruleContributions', + 'reasons', 'dataSources', 'limitations', 'improvementActions', 'evidenceLevel', + 'validity', 'completedAt', 'validUntil', 'LOGIC', 'COMMUNICATION', 'EXECUTION', + 'LEARNING', 'studentUserId', 'candidateId', 'resultId', 'attemptId', 'questionCode', + 'answerKey', 'scoringRule', 'competencyTag', 'phone', 'email', 'resumeUrl'): + assert field not in company_schema_text, f'CompanyCandidateScoringResponse exposes N02 field {field}' + +candidate_scoring_paths = [ + '/profile/me/candidate-scoring', + '/profile/me/candidate-scoring/dimensions/{dimension}', + '/profile/me/candidate-scoring/trend', + '/company/candidates/{applicationId}/scoring', +] +assert all(path in paths for path in candidate_scoring_paths), 'Candidate scoring path set changed' +assert sum(len(paths[path]) for path in candidate_scoring_paths) == 4, 'Candidate scoring operation count changed' +print(' N02 explanation schemas validated; enterprise scoring schema unchanged; 4 scoring operations preserved') + +# N07 消息撤回：仅新增一个 POST，消息响应为白名单 DTO。 +n07_path = '/conversations/{conversationId}/messages/{messageId}/recall' +assert n07_path in paths, 'N07 recall path missing' +assert list(paths[n07_path].keys()) == ['post'], 'N07 must expose exactly one POST operation' +n07_operation = paths[n07_path]['post'] +assert n07_operation.get('parameters') and len(n07_operation['parameters']) == 2, 'N07 path parameters missing' +assert n07_operation.get('responses', {}).get('200', {}).get('content', {}).get('*/*', {}).get('schema', {}).get('$ref', '').endswith('ApiResponseMessageResponse'), 'N07 200 schema missing' +assert 'MessageResponse' in d['components']['schemas'], 'MessageResponse schema missing' +assert 'ApiResponseMessageResponse' in d['components']['schemas'], 'ApiResponseMessageResponse schema missing' +assert 'MessagePageResponse' in d['components']['schemas'], 'MessagePageResponse schema missing' +assert 'ApiResponseMessagePageResponse' in d['components']['schemas'], 'ApiResponseMessagePageResponse schema missing' +# Inspect the raw array item reference here. ``resolve_schema`` intentionally +# expands local refs and therefore removes the ``$ref`` node; using the +# expanded object for this assertion made a valid MessageResponse array look +# invalid even though the static contract was correct. +message_page_schema = resolve_schema(d['components']['schemas']['MessagePageResponse']) +message_page_items = d['components']['schemas']['MessagePageResponse'].get('properties', {}).get('items', {}) +assert message_page_items.get('type') == 'array', 'MessagePageResponse items missing' +assert message_page_items.get('items', {}).get('$ref', '').endswith('MessageResponse'), 'MessagePageResponse item schema missing' +assert paths['/conversations/{id}/messages']['get']['responses']['200']['content']['*/*']['schema'].get('$ref', '').endswith('ApiResponseMessagePageResponse'), 'message list schema missing' +message_props = d['components']['schemas']['MessageResponse'].get('properties', {}) +for field in ('id', 'conversationId', 'content', 'status', 'createdAt'): + assert field in message_props, f'MessageResponse missing {field}' +assert message_props['status'].get('enum') == ['SENT', 'RECALLED'], 'MessageResponse status enum mismatch' +message_text = json.dumps(resolve_schema(d['components']['schemas']['MessageResponse']), ensure_ascii=False) +for forbidden in ('originalContent', 'previousContent', 'studentUserId', 'candidateId', 'phone', 'email', + 'resumeUrl', 'candidateKey', 'candidateKeyDigest', 'password', 'token', 'secret'): + assert forbidden not in message_text, f'MessageResponse exposes forbidden field {forbidden}' +assert '/conversations' in paths and '/conversations/messages' in paths +assert '/conversations/{id}/messages' in paths and '/conversations/{id}/read' in paths +print(' N07 recall path/schema validated; existing messaging operations preserved') + +# ── S02：Access/Refresh Token 隔离 + 密码认证 operation ───────────── +# 只允许新增 /auth/refresh 与 /auth/logout；登录原字段不得删除； +# 新 schema 不得暴露数据库字段或凭据。 +assert '/auth/refresh' in paths, 'Missing /auth/refresh' +assert '/auth/logout' in paths, 'Missing /auth/logout' +assert 'post' in paths['/auth/refresh'], '/auth/refresh must be POST' +assert 'post' in paths['/auth/logout'], '/auth/logout must be POST' + +_refresh_body = paths['/auth/refresh']['post']['requestBody']['content']['application/json']['schema'] +_refresh_req = resolve_schema(_refresh_body) +assert sorted(_refresh_req['properties']) == ['refreshToken'], \ + f"Refresh request body must only contain refreshToken, got {sorted(_refresh_req['properties'])}" + +assert 'requestBody' not in paths['/auth/logout']['post'], '/auth/logout must not declare requestBody' + +# 登录接口的静态契约不得被 S02 改动（请求/响应引用保持原样） +_login_post = paths['/auth/login']['post'] +assert _login_post['requestBody']['content']['application/json']['schema']['$ref'] == \ + '#/components/schemas/LoginRequest', 'login request schema changed' +assert _login_post['responses']['200']['content']['*/*']['schema']['$ref'] == \ + '#/components/schemas/ApiResponseMapStringObject', 'login response schema changed' +assert _login_post.get('operationId') == 'mockLogin', 'login operationId changed' + +_s02_text = json.dumps({ + 'refresh': paths['/auth/refresh'], + 'logout': paths['/auth/logout'], + 'schemas': {k: v for k, v in d['components']['schemas'].items() + if k in ('RefreshTokenRequest', 'TokenPairResponse', 'ApiResponseTokenPairResponse')}, +}, ensure_ascii=False) +for forbidden in ('tokenHash', 'refreshTokenHash', 'sessionId', 'revocationReason', + 'phone', 'secret', 'password', 'jwt'): + assert forbidden not in _s02_text, f'S02 contract exposes forbidden field {forbidden}' + +# 密码认证四个 operation 的请求体必须是白名单 DTO，不能携带 userId/sessionId/角色。 +_password_paths = { + '/auth/password/login': 'PasswordLoginRequest', + '/auth/password/set': 'PasswordSetRequest', + '/auth/password/change': 'PasswordChangeRequest', + '/auth/password/reset': 'PasswordResetRequest', } -for schema_name, expected_fields in skill_schema_fields.items(): - schema = schemas.get(schema_name) - assert schema is not None, f'Missing schema: {schema_name}' - assert expected_fields <= set(schema.get('properties', {})), f'Schema fields missing: {schema_name}' - -word_cloud_example = paths['/skills/word-cloud']['get']['responses']['200']['content']['application/json']['example']['data'] -assert word_cloud_example['total'] == len(word_cloud_example['items']) -match_example = paths['/skills/match']['get']['responses']['200']['content']['application/json']['example']['data'] -assert match_example['matchedCount'] == len(match_example['matchedSkills']) -assert match_example['totalCount'] == len(match_example['matchedSkills']) + len(match_example['missingSkills']) -assert match_example['matchScore'] == round(match_example['matchedCount'] * 100 / match_example['totalCount']) -learning_path_example = paths['/skills/learning-path']['get']['responses']['200']['content']['application/json']['example']['data'] -assert learning_path_example['total'] == len(learning_path_example['items']) -print(" Skill cloud endpoints and schemas present (3 GET operations)") +for _path, _schema_name in _password_paths.items(): + assert _path in paths and set(paths[_path]) == {'post'}, f'Invalid password path: {_path}' + _body = paths[_path]['post']['requestBody']['content']['application/json']['schema'] + assert _body.get('$ref', '').endswith(_schema_name), f'{_path} request schema mismatch' + _schema_text = json.dumps(resolve_schema(d['components']['schemas'][_schema_name]), ensure_ascii=False) + for _forbidden in ('userId', 'sessionId', 'role', 'passwordHash', 'token', 'secret'): + assert _forbidden not in _schema_text, f'{_path} exposes {_forbidden}' + +_auth_paths = {p for p in paths if p.startswith('/auth')} +assert _auth_paths == { + '/auth/sms/send', '/auth/login', '/auth/me', + '/auth/refresh', '/auth/logout', + '/auth/password/login', '/auth/password/set', '/auth/password/change', '/auth/password/reset', + '/auth/company/register', +}, f'Unexpected /auth paths: {sorted(_auth_paths)}' +print(' S02 refresh/logout and password authentication operations validated') + +# ── Phase A：企业注册与入驻聚合 ───────────────────────────────────── +assert set(paths['/auth/company/register']) == {'post'} +_company_register = paths['/auth/company/register']['post'] +assert _company_register['requestBody']['content']['application/json']['schema']['$ref'] \ + == '#/components/schemas/CompanyRegistrationRequest' +assert _company_register['responses']['200']['content']['*/*']['schema']['$ref'] \ + == '#/components/schemas/ApiResponseCompanyRegistrationResponse' +_company_req = resolve_schema(d['components']['schemas']['CompanyRegistrationRequest']) +assert sorted(_company_req['properties']) == ['code', 'company', 'password', 'phone'] +for _forbidden in ('userId', 'role', 'verified', 'passwordHash'): + assert _forbidden not in json.dumps(_company_req, ensure_ascii=False) +assert set(paths['/companies/me/onboarding']) == {'get'} +assert paths['/companies/me/onboarding']['get']['responses']['200']['content']['*/*']['schema']['$ref'] \ + == '#/components/schemas/ApiResponseCompanyOnboardingResponse' +for _schema_name in ('CompanyOnboardingResponse', 'CompanySummary', 'VerificationSummary'): + assert _schema_name in d['components']['schemas'], f'Missing Phase A schema: {_schema_name}' +_onboarding_text = json.dumps({k: d['components']['schemas'][k] for k in + ('CompanyOnboardingResponse', 'CompanySummary', 'VerificationSummary')}, + ensure_ascii=False) +for _forbidden in ('materialsJson', 'decisionReason', 'reviewerId', 'storagePath'): + assert _forbidden not in _onboarding_text +print(' Phase A company registration/onboarding paths and redacted schemas validated') + +# ── S03：唯一新增的企业简历下载接口 ──────────────────────────────── +_download_path = '/company/candidates/{applicationId}/resume' +assert _download_path in paths, 'Missing company resume download endpoint' +_download_get = paths[_download_path]['get'] +assert 'requestBody' not in _download_get, 'Resume download must not declare requestBody' +assert set(paths[_download_path].keys()) == {'get'}, 'Resume download must be GET only' + +# 不得存在按 studentUserId / candidateKey 下载简历的入口 +for _p in paths: + _lower = _p.lower() + if 'resume' in _lower or 'download' in _lower: + assert 'studentuserid' not in _lower, f'Resume path must not key on studentUserId: {_p}' + assert 'candidatekey' not in _lower, f'Resume path must not key on candidateKey: {_p}' + +# 企业候选人 DTO 不得回带 resumeUrl / studentUserId / phone / email / storagePath +for _dto in ('CandidateDetailView', 'CandidateItemView'): + _node = d['components']['schemas'].get(_dto) + if _node is None: + continue + _text = json.dumps(resolve_schema(_node), ensure_ascii=False) + for _forbidden in ('resumeUrl', 'studentUserId', 'phone', 'email', 'storagePath'): + assert _forbidden not in _text, f'{_dto} exposes forbidden field {_forbidden}' + +# Actuator 不得进入业务 OpenAPI +for _p in paths: + assert not _p.startswith('/actuator'), f'Actuator must not appear in the business contract: {_p}' +print(' S03 company resume download contract validated; candidate DTOs remain redacted') + +# 统计 operation 总数并校验 V43 + N07 + S02 + S03 + Phase A 计数 220 +operations = sum(len(methods) for methods in d['paths'].values()) +print('operations:', operations) +assert operations == 220, f"Expected 220 operations, got {operations}" print(" Offer advance endpoints all present") print(" 26 operations all present") print(" Account deletion endpoints present (3 operations)") -onboarding_success_refs = { - ('/onboarding/companies/{companyId}/checklist', 'get'): 'ApiResponseEffectiveChecklistResponse', - ('/onboarding/companies/{companyId}/checklist/items/{itemId}/completion', 'put'): 'ApiResponseProgressUpdateResponse', - ('/onboarding/companies/{companyId}/knowledge', 'get'): 'ApiResponseCompanyKnowledgeOverviewResponse', - ('/onboarding/company/checklist-items', 'get'): 'ApiResponseListCompanyChecklistItemView', - ('/onboarding/company/checklist-items', 'post'): 'ApiResponseCompanyChecklistItemView', - ('/onboarding/company/checklist-items/{itemId}', 'put'): 'ApiResponseCompanyChecklistItemView', - ('/onboarding/company/checklist-items/{itemId}', 'delete'): 'ApiResponseCompanyChecklistItemView', - ('/onboarding/company/knowledge', 'get'): 'ApiResponseCompanyKnowledgeView', - ('/onboarding/company/knowledge', 'put'): 'ApiResponseCompanyKnowledgeView', -} -for (path, method), schema_name in onboarding_success_refs.items(): - response = paths[path][method]['responses']['200'] - ref = response['content']['*/*']['schema']['$ref'] - assert ref == f'#/components/schemas/{schema_name}', f'Wrong success schema for {method.upper()} {path}: {ref}' - for status_code in ('401', '403'): - assert status_code in paths[path][method]['responses'], f'Missing {status_code} for {method.upper()} {path}' - unauthorized = paths[path][method]['responses']['401'] - assert unauthorized['content']['application/json']['schema']['$ref'] == '#/components/schemas/UnauthorizedResponse' - forbidden = paths[path][method]['responses']['403'] - assert forbidden['content']['application/json']['schema']['$ref'] == '#/components/schemas/ApiResponse' - assert forbidden['content']['application/json']['example']['code'] == 2002 - -onboarding_schema_fields = { - 'CompanyChecklistItemCreateRequest': {'title', 'description', 'category', 'sortOrder', 'required', 'idempotencyKey'}, - 'CompanyChecklistItemUpdateRequest': {'title', 'description', 'category', 'sortOrder', 'required', 'active', 'version'}, - 'CompanyChecklistItemView': {'itemId', 'source', 'itemKey', 'title', 'description', 'category', 'required', 'sortOrder', 'active', 'version'}, - 'EffectiveChecklistResponse': {'companyId', 'companyName', 'customized', 'totalItems', 'completedItems', 'completionRate', 'items'}, - 'ChecklistItemView': {'itemId', 'source', 'itemKey', 'title', 'description', 'category', 'required', 'sortOrder', 'active', 'completed', 'completedAt', 'progressVersion'}, - 'ProgressUpdateRequest': {'completed', 'version'}, - 'ProgressUpdateResponse': {'itemId', 'completed', 'completedAt', 'progressVersion', 'totalItems', 'completedItems', 'completionRate'}, - 'CompanyKnowledgeUpdateRequest': {'culture', 'workPolicies', 'onboardingGuide', 'version'}, - 'CompanyKnowledgeView': {'configured', 'culture', 'workPolicies', 'onboardingGuide', 'updatedAt', 'version'}, - 'CompanyKnowledgeOverviewResponse': {'company', 'knowledgeState', 'knowledge', 'reviewSummary'}, - 'CompanyView': {'id', 'name', 'logoUrl', 'description', 'industry', 'website', 'address', 'verified'}, - 'KnowledgeView': {'culture', 'workPolicies', 'onboardingGuide', 'updatedAt', 'version'}, - 'ReviewSummaryView': {'state', 'totalReviews', 'averageRating', 'ratingDistribution', 'topTags', 'dimensionSummary'}, - 'DimensionSummaryView': {'averageScore', 'sampleCount', 'dataState'}, -} -for schema_name, expected_fields in onboarding_schema_fields.items(): - schema = schemas.get(schema_name) - assert schema is not None, f'Missing onboarding schema: {schema_name}' - assert expected_fields <= set(schema.get('properties', {})), ( - f'Onboarding schema fields missing: {schema_name}' - ) - -create_request = schemas['CompanyChecklistItemCreateRequest']['properties'] -assert create_request['sortOrder'].get('default') == 1000, ( - 'CompanyChecklistItemCreateRequest.sortOrder default must be 1000' -) -assert create_request['required'].get('default') is False, ( - 'CompanyChecklistItemCreateRequest.required default must be false' -) -knowledge_success_example = paths['/onboarding/company/knowledge']['put']['responses']['200']['content']['*/*']['example'] -assert knowledge_success_example['data'].get('version') == 2, ( - 'PUT /onboarding/company/knowledge 200 example data.version must be 2' -) - -onboarding_error_paths = { - 9701: ('/onboarding/company/checklist-items/{itemId}', 'put', '404'), - 9702: ('/onboarding/company/checklist-items/{itemId}', 'put', '409'), - 9703: ('/onboarding/company/checklist-items', 'post', '409'), - 9704: ('/onboarding/company/checklist-items', 'post', '409'), - 9705: ('/onboarding/companies/{companyId}/checklist/items/{itemId}/completion', 'put', '409'), - 9706: ('/onboarding/company/knowledge', 'put', '409'), -} -for error_code, (path, method, status_code) in onboarding_error_paths.items(): - response_text = json.dumps(paths[path][method]['responses'][status_code], ensure_ascii=False) - assert str(error_code) in response_text, f'Missing onboarding error code {error_code} in {method.upper()} {path}' -print(' N04 onboarding endpoints and schemas present (9 operations / 6 paths)') - data = json.dumps(d) assert '"" : "#/components/schemas/' not in data, "Found empty ref key" print("No empty ref keys found") diff --git a/mydreamjob-server/pom.xml b/mydreamjob-server/pom.xml index 55db580..6c77e07 100644 --- a/mydreamjob-server/pom.xml +++ b/mydreamjob-server/pom.xml @@ -54,6 +54,11 @@ org.springframework.boot spring-boot-starter-actuator + + + io.micrometer + micrometer-registry-prometheus + diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswer.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswer.java new file mode 100644 index 0000000..631a587 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswer.java @@ -0,0 +1,46 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_answers") +@EntityListeners(AuditingEntityListener.class) +public class AbilityAnswer { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "attempt_question_id", nullable = false) + private Long attemptQuestionId; + + @Column(name = "selected_option_id", nullable = false, length = 4) + private String selectedOptionId; + + @Column(name = "awarded_score", nullable = false) + private Integer awardedScore; + + @CreatedDate + @Column(name = "answered_at", nullable = false, updatable = false) + private LocalDateTime answeredAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswerRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswerRepository.java new file mode 100644 index 0000000..e84c21a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAnswerRepository.java @@ -0,0 +1,14 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; + +public interface AbilityAnswerRepository extends JpaRepository { + + List findByAttemptId(Long attemptId); + + List findByAttemptIdAndAttemptQuestionIdIn(Long attemptId, List attemptQuestionIds); + + long countByAttemptId(Long attemptId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttempt.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttempt.java new file mode 100644 index 0000000..2f17574 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttempt.java @@ -0,0 +1,79 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_attempts") +@EntityListeners(AuditingEntityListener.class) +public class AbilityAttempt { + + public static final String STATUS_DRAFT = "DRAFT"; + public static final String STATUS_IN_PROGRESS = "IN_PROGRESS"; + public static final String STATUS_COMPLETED = "COMPLETED"; + public static final String STATUS_EXPIRED = "EXPIRED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "student_user_id", nullable = false) + private Long studentUserId; + + @Column(name = "definition_id", nullable = false) + private Long definitionId; + + @Column(name = "status", nullable = false, length = 20) + @Builder.Default + private String status = STATUS_DRAFT; + + @Column(name = "active_key", length = 255) + private String activeKey; + + @Column(name = "idempotency_key", length = 64) + private String idempotencyKey; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "answered_count", nullable = false) + @Builder.Default + private Integer answeredCount = 0; + + @Version + @Column(name = "version", nullable = false) + @Builder.Default + private Long version = 0L; + + @Column(name = "started_at") + private LocalDateTime startedAt; + + @Column(name = "expires_at") + private LocalDateTime expiresAt; + + @Column(name = "submitted_at") + private LocalDateTime submittedAt; + + @Column(name = "completed_at") + private LocalDateTime completedAt; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestion.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestion.java new file mode 100644 index 0000000..a65c92c --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestion.java @@ -0,0 +1,44 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_attempt_questions") +@EntityListeners(AuditingEntityListener.class) +public class AbilityAttemptQuestion { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "question_id", nullable = false) + private Long questionId; + + @Column(name = "position", nullable = false) + private Integer position; + + @Column(name = "question_version", nullable = false, length = 40) + private String questionVersion; + + @Column(name = "question_snapshot_json", nullable = false, columnDefinition = "text") + private String questionSnapshotJson; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestionRepository.java new file mode 100644 index 0000000..bf2963a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptQuestionRepository.java @@ -0,0 +1,15 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; +import java.util.Optional; + +public interface AbilityAttemptQuestionRepository extends JpaRepository { + + List findByAttemptIdOrderByPositionAsc(Long attemptId); + + boolean existsByAttemptIdAndQuestionId(Long attemptId, Long questionId); + + long countByAttemptId(Long attemptId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptRepository.java new file mode 100644 index 0000000..8b019ed --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptRepository.java @@ -0,0 +1,56 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.Optional; + +public interface AbilityAttemptRepository extends JpaRepository { + + Optional findByStudentUserIdAndIdempotencyKey(Long studentUserId, String idempotencyKey); + + boolean existsByStudentUserIdAndDefinitionIdAndStatusIn(Long studentUserId, Long definitionId, List statuses); + + @org.springframework.data.jpa.repository.Modifying + @org.springframework.transaction.annotation.Transactional + @Query("UPDATE AbilityAttempt a SET a.status='COMPLETED', a.submittedAt=:submittedAt, " + + "a.completedAt=:submittedAt, a.answeredCount=:answeredCount, a.activeKey=null " + + "WHERE a.id=:attemptId AND a.status IN ('DRAFT','IN_PROGRESS')") + int markCompleted(@Param("attemptId") Long attemptId, + @Param("submittedAt") LocalDateTime submittedAt, + @Param("answeredCount") int answeredCount); + + @org.springframework.data.jpa.repository.Modifying + @org.springframework.transaction.annotation.Transactional + @Query("UPDATE AbilityAttempt a SET a.status='EXPIRED', a.activeKey=null " + + "WHERE a.id=:attemptId AND a.status IN ('DRAFT','IN_PROGRESS')") + int markExpiredAndReleaseActive(@Param("attemptId") Long attemptId); + + // 滚动窗口内 COMPLETED 次数（重测限制） + int countByStudentUserIdAndDefinitionIdAndStatusAndCompletedAtGreaterThanEqual( + Long studentUserId, Long definitionId, String status, LocalDateTime since); + + List findByStudentUserIdAndDefinitionIdAndStatusOrderByCompletedAtDesc( + Long studentUserId, Long definitionId, String status); + + List findByStudentUserIdAndDefinitionIdOrderByCompletedAtDesc( + Long studentUserId, Long definitionId); + + org.springframework.data.domain.Page findByStudentUserIdOrderByCreatedAtDesc( + Long studentUserId, org.springframework.data.domain.Pageable pageable); + + // 遗留超时的活跃答卷（startedAt 已启动但已到 expiresAt 的 DRAFT/IN_PROGRESS） + @Query("SELECT a FROM AbilityAttempt a WHERE a.status IN ('DRAFT','IN_PROGRESS') " + + "AND a.expiresAt IS NOT NULL AND a.expiresAt <= :now") + List findTimedOutActive(@Param("now") LocalDateTime now); + + @Query("SELECT a FROM AbilityAttempt a WHERE a.studentUserId=:userId AND a.definitionId=:defId " + + "AND a.status IN ('DRAFT','IN_PROGRESS') " + + "AND a.expiresAt IS NOT NULL AND a.expiresAt <= :now") + List findTimedOutActiveByUserAndDef(@Param("userId") Long userId, + @Param("defId") Long defId, + @Param("now") LocalDateTime now); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptService.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptService.java new file mode 100644 index 0000000..b7af7ad --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptService.java @@ -0,0 +1,576 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.databind.JsonNode; +import com.mydreamjob.ability.dto.AbilityAttemptResponse; +import com.mydreamjob.ability.dto.AbilityHistoryItem; +import com.mydreamjob.ability.dto.AbilityResultResponse; +import com.mydreamjob.ability.dto.CreateAbilityAttemptRequest; +import com.mydreamjob.ability.dto.SaveAbilityAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.dao.OptimisticLockingFailureException; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Isolation; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.Clock; +import java.time.Duration; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Random; +import java.util.Set; +import java.util.function.Function; +import java.util.stream.Collectors; + +@Service +@RequiredArgsConstructor +public class AbilityAttemptService { + + private static final int MAX_PAGE_SIZE = 50; + private static final String[] DIMENSIONS = {"LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"}; + + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final AbilityDefinitionRepository definitionRepository; + private final AbilityQuestionRepository questionRepository; + private final AbilityAttemptRepository attemptRepository; + private final AbilityAttemptQuestionRepository attemptQuestionRepository; + private final AbilityAnswerRepository answerRepository; + private final AbilityResultRepository resultRepository; + private final AbilityResultService resultService; + private final AbilityResultComputer resultComputer; + private final AbilityAttemptWriter attemptWriter; + private final AbilitySnapshotCodec snapshotCodec; + private final UserRepository userRepository; + private final AuditService auditService; + private final Clock clock; + /** R01-D4-1：能力测评提交成功后登记评分快照刷新（ABILITY 维度）。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; + + // ─────────────────────────── 创建答卷 ─────────────────────────── + + @Transactional(isolation = Isolation.READ_COMMITTED) + public AbilityAttemptResponse create(Long userId, CreateAbilityAttemptRequest req, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AbilityDefinition def = definitionRepository.findByTypeCode(req.getTypeCode()) + .orElseThrow(() -> new BusinessException(ErrorCode.ABILITY_TYPE_NOT_FOUND)); + if (!AbilityDefinition.STATUS_ACTIVE.equals(def.getStatus())) { + throw new BusinessException(ErrorCode.ABILITY_TYPE_NOT_FOUND); + } + LocalDateTime now = now(); + String idem = normalizeIdempotencyKey(req.getIdempotencyKey()); + + if (idem != null) { + AbilityAttempt existing = findByIdem(userId, idem); + if (existing != null) { + if (!def.getId().equals(existing.getDefinitionId())) { + throw new BusinessException(ErrorCode.ABILITY_IDEMPOTENCY_CONFLICT); + } + return toAttemptResponse(existing); + } + } + + // 原子释放本学生本类型已超时的遗留活跃答卷 + releaseTimedOut(userId, def.getId(), now); + + if (attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn( + userId, def.getId(), List.of(AbilityAttempt.STATUS_DRAFT, AbilityAttempt.STATUS_IN_PROGRESS))) { + throw new BusinessException(ErrorCode.ABILITY_DUPLICATE_ACTIVE); + } + + // 有效结果冷却期：存在未过期结果时不可重测 + AbilityAttempt recentCompleted = attemptRepository + .findByStudentUserIdAndDefinitionIdAndStatusOrderByCompletedAtDesc( + userId, def.getId(), AbilityAttempt.STATUS_COMPLETED) + .stream().findFirst().orElse(null); + if (recentCompleted != null) { + AbilityResult r = resultRepository.findByAttemptId(recentCompleted.getId()).orElse(null); + if (r != null && r.getValidUntil() != null && now.isBefore(r.getValidUntil())) { + throw new BusinessException(ErrorCode.ABILITY_RETAKE_COOLDOWN); + } + } + + // 滚动窗口内完成次数限制 + int windowDays = def.getRetakeWindowDays() == null ? 90 : def.getRetakeWindowDays(); + int maxCompleted = def.getRetakeMaxCompleted() == null ? 3 : def.getRetakeMaxCompleted(); + long completedInWindow = attemptRepository + .countByStudentUserIdAndDefinitionIdAndStatusAndCompletedAtGreaterThanEqual( + userId, def.getId(), AbilityAttempt.STATUS_COMPLETED, now.minusDays(windowDays)); + if (completedInWindow >= maxCompleted) { + throw new BusinessException(ErrorCode.ABILITY_RETAKE_LIMIT); + } + + List all = questionRepository + .findByDefinitionIdAndActiveTrueOrderByPositionAsc(def.getId()); + List sampled = sample(all, def); + int perDim = def.getQuestionsPerDimension() == null ? 6 : def.getQuestionsPerDimension(); + + AbilityAttempt attempt; + try { + attempt = attemptWriter.persistNew(userId, def, sampled, idem, activeKeyOf(userId, def.getId())); + } catch (DataIntegrityViolationException e) { + if (idem != null) { + AbilityAttempt existing = findByIdem(userId, idem); + if (existing != null) { + if (!def.getId().equals(existing.getDefinitionId())) { + throw new BusinessException(ErrorCode.ABILITY_IDEMPOTENCY_CONFLICT); + } + return toAttemptResponse(existing); + } + } + if (attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn( + userId, def.getId(), List.of(AbilityAttempt.STATUS_DRAFT, AbilityAttempt.STATUS_IN_PROGRESS))) { + throw new BusinessException(ErrorCode.ABILITY_DUPLICATE_ACTIVE); + } + throw e; + } + + auditService.log(userId, "ABILITY_ATTEMPT_CREATED", "ABILITY_ATTEMPT", attempt.getId(), + "attemptId=" + attempt.getId() + ", typeCode=" + def.getTypeCode() + + ", status=" + attempt.getStatus() + ", answeredCount=0" + + ", questionSetVersion=" + attempt.getQuestionSetVersion() + + ", rulesVersion=" + def.getRulesVersion(), + ctx); + return toAttemptResponse(attempt, def); + } + + // ─────────────────────────── 答卷详情 ─────────────────────────── + + @Transactional + public AbilityAttemptResponse get(Long userId, Long attemptId) { + userRoleGuard.requireStudent(userId); + AbilityAttempt attempt = loadOwned(userId, attemptId); + expireIfTimedOut(attempt); + return toAttemptResponse(attempt); + } + + // ─────────────────────────── 查看结果 ─────────────────────────── + + @Transactional(readOnly = true) + public AbilityResultResponse loadResult(Long userId, Long attemptId) { + userRoleGuard.requireStudent(userId); + AbilityAttempt attempt = loadOwned(userId, attemptId); + AbilityResult result = resultRepository.findByAttemptId(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ABILITY_RESULT_NOT_FOUND)); + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + return resultService.toResponse(attempt, result, def, now()); + } + + // ─────────────────────────── 保存答案 ─────────────────────────── + + @Transactional + public AbilityAttemptResponse saveAnswers(Long userId, Long attemptId, + SaveAbilityAnswersRequest req, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AbilityAttempt attempt = loadOwned(userId, attemptId); + if (expireIfTimedOut(attempt)) { + throw new BusinessException(ErrorCode.ABILITY_ATTEMPT_INVALID_STATE); + } + if (!isMutable(attempt.getStatus())) { + throw new BusinessException(ErrorCode.ABILITY_ATTEMPT_INVALID_STATE); + } + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + + // 同一 PATCH 内不得重复 attemptQuestionId + if (req.getAnswers().size() != req.getAnswers().stream() + .map(a -> a.getAttemptQuestionId()).distinct().count()) { + throw new BusinessException(ErrorCode.ABILITY_ANSWER_INVALID, "duplicate attemptQuestionId in answers"); + } + + List aqs = attemptQuestionRepository + .findByAttemptIdOrderByPositionAsc(attemptId); + Map aqById = aqs.stream() + .collect(Collectors.toMap(AbilityAttemptQuestion::getId, Function.identity())); + + // 先整体校验：attemptQuestionId 属于本答卷、选项存在于快照；任一无效 → 整体拒绝，不启动计时 + for (SaveAbilityAnswersRequest.AnswerItem item : req.getAnswers()) { + AbilityAttemptQuestion aq = aqById.get(item.getAttemptQuestionId()); + if (aq == null || item.getSelectedOptionId() == null) { + throw new BusinessException(ErrorCode.ABILITY_ANSWER_INVALID, "attemptQuestionId not in this attempt"); + } + if (!snapshotCodec.optionExists(aq.getQuestionSnapshotJson(), item.getSelectedOptionId())) { + throw new BusinessException(ErrorCode.ABILITY_ANSWER_INVALID, "optionId does not exist"); + } + } + + LocalDateTime now = now(); + boolean startTimer = attempt.getStartedAt() == null; + + // 批量加载本请求涉及题目的既有答案，避免对每题逐条查询（消除 N+1） + List questionIds = req.getAnswers().stream() + .map(SaveAbilityAnswersRequest.AnswerItem::getAttemptQuestionId).toList(); + Map existingByAqId = answerRepository + .findByAttemptIdAndAttemptQuestionIdIn(attemptId, questionIds).stream() + .collect(Collectors.toMap(AbilityAnswer::getAttemptQuestionId, Function.identity())); + + List toSave = new ArrayList<>(questionIds.size()); + for (SaveAbilityAnswersRequest.AnswerItem item : req.getAnswers()) { + AbilityAttemptQuestion aq = aqById.get(item.getAttemptQuestionId()); + Integer awarded = snapshotCodec.awardedScore(aq.getQuestionSnapshotJson(), item.getSelectedOptionId()); + AbilityAnswer answer = existingByAqId.get(aq.getId()); + if (answer == null) { + answer = AbilityAnswer.builder().attemptId(attemptId).attemptQuestionId(aq.getId()).build(); + } + answer.setSelectedOptionId(item.getSelectedOptionId()); + answer.setAwardedScore(awarded == null ? 0 : awarded); + toSave.add(answer); + } + answerRepository.saveAll(toSave); + answerRepository.flush(); + + int answered = (int) answerRepository.countByAttemptId(attemptId); + attempt.setAnsweredCount(answered); + if (startTimer && answered > 0) { + attempt.setStartedAt(now); + int limit = def == null || def.getTimeLimitMinutes() == null ? 30 : def.getTimeLimitMinutes(); + attempt.setExpiresAt(now.plusMinutes(limit)); + attempt.setStatus(AbilityAttempt.STATUS_IN_PROGRESS); + } + try { + attemptRepository.saveAndFlush(attempt); + } catch (OptimisticLockingFailureException e) { + throw new BusinessException(ErrorCode.ABILITY_CONCURRENT_UPDATE); + } + return toAttemptResponse(attempt, def); + } + + // ─────────────────────────── 提交答卷 ─────────────────────────── + + @Transactional + public AbilityResultResponse submit(Long userId, Long attemptId, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AbilityAttempt attempt = loadOwned(userId, attemptId); + + if (AbilityAttempt.STATUS_COMPLETED.equals(attempt.getStatus())) { + return idempotentResult(attempt); + } + if (expireIfTimedOut(attempt)) { + throw new BusinessException(ErrorCode.ABILITY_ATTEMPT_INVALID_STATE); + } + if (!isMutable(attempt.getStatus())) { + throw new BusinessException(ErrorCode.ABILITY_ATTEMPT_INVALID_STATE); + } + + int answered = (int) answerRepository.countByAttemptId(attemptId); + int total = totalOf(attempt); + if (answered < total || !perDimensionAnswered(attemptId)) { + throw new BusinessException(ErrorCode.ABILITY_INCOMPLETE); + } + + int transitioned = attemptRepository.markCompleted(attemptId, now(), answered); + if (transitioned == 0) { + return idempotentResult(attempt); + } + + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + AbilityResultComputer.ComputedResult computed = compute(attempt); + AbilityResult result; + try { + result = resultRepository.save(resultService.persist(attempt, def, computed, now())); + } catch (DataIntegrityViolationException e) { + return idempotentResult(attempt); + } + + auditService.log(userId, "ABILITY_ATTEMPT_SUBMITTED", "ABILITY_ATTEMPT", attemptId, + "attemptId=" + attemptId + ", typeCode=" + (def == null ? null : def.getTypeCode()) + + ", status=COMPLETED, answeredCount=" + answered + + ", questionSetVersion=" + attempt.getQuestionSetVersion() + + ", rulesVersion=" + (def == null ? null : def.getRulesVersion()), + ctx); + // R01-D4-1：能力测评提交成功（新有效结果）影响 ABILITY 维度 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(userId, now()); + return resultService.toResponse(attempt, result, def, now()); + } + + // ─────────────────────────── 我的历史 ─────────────────────────── + + @Transactional(readOnly = true) + public Page listMine(Long userId, int page, int size) { + userRoleGuard.requireStudent(userId); + if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + LocalDateTime now = now(); + Page attempts = attemptRepository + .findByStudentUserIdOrderByCreatedAtDesc(userId, PageRequest.of(page, size)); + List content = attempts.getContent(); + Map resultByAttempt = resultRepository + .findByAttemptIdIn(content.stream().map(AbilityAttempt::getId).toList()).stream() + .collect(Collectors.toMap(AbilityResult::getAttemptId, Function.identity())); + // 对当前页 definitionId 去重后批量加载，避免对每条历史逐个 findById（消除 N+1） + List defIds = content.stream().map(AbilityAttempt::getDefinitionId).distinct().toList(); + Map defById = defIds.isEmpty() ? Map.of() + : definitionRepository.findAllById(defIds).stream() + .collect(Collectors.toMap(AbilityDefinition::getId, Function.identity())); + return attempts.map(a -> { + AbilityResult r = resultByAttempt.get(a.getId()); + AbilityDefinition d = defById.get(a.getDefinitionId()); + String validity = null; + if (r != null && r.getValidUntil() != null) { + validity = now.isBefore(r.getValidUntil()) ? AbilityResultComputer.VALIDITY_VALID + : AbilityResultComputer.VALIDITY_EXPIRED; + } + int total = d == null || d.getAttemptQuestionCount() == null ? 24 : d.getAttemptQuestionCount(); + return AbilityHistoryItem.builder() + .attemptId(a.getId()) + .typeCode(d == null ? null : d.getTypeCode()) + .status(a.getStatus()) + .validityStatus(validity) + .overallScore(r == null ? null : r.getOverallScore()) + .answeredCount(a.getAnsweredCount()) + .completionRate(completionRate(a.getAnsweredCount(), total)) + .startedAt(a.getStartedAt()) + .expiresAt(a.getExpiresAt()) + .completedAt(a.getCompletedAt()) + .validUntil(r == null ? null : r.getValidUntil()) + .build(); + }); + } + + // ─────────────────────────── 内部工具 ─────────────────────────── + + private AbilityResultResponse idempotentResult(AbilityAttempt attempt) { + AbilityResult result = resultRepository.findByAttemptId(attempt.getId()) + .orElseThrow(() -> new BusinessException(ErrorCode.ABILITY_ATTEMPT_INVALID_STATE)); + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + return resultService.toResponse(attempt, result, def, now()); + } + + private AbilityResultComputer.ComputedResult compute(AbilityAttempt attempt) { + List items = new ArrayList<>(); + List aqs = attemptQuestionRepository + .findByAttemptIdOrderByPositionAsc(attempt.getId()); + Map answerByAq = answerRepository.findByAttemptId(attempt.getId()).stream() + .collect(Collectors.toMap(AbilityAnswer::getAttemptQuestionId, Function.identity())); + for (AbilityAttemptQuestion aq : aqs) { + AbilityAnswer ans = answerByAq.get(aq.getId()); + if (ans == null) { + continue; + } + JsonNode snap = snapshotCodec.parse(aq.getQuestionSnapshotJson()); + items.add(new AbilityResultComputer.Answered( + text(snap, AbilitySnapshotCodec.KEY_DIMENSION), + text(snap, AbilitySnapshotCodec.KEY_COMPETENCY_TAG), + text(snap, AbilitySnapshotCodec.KEY_STEM), + text(snap, AbilitySnapshotCodec.KEY_EXPLANATION), + ans.getAwardedScore(), aq.getId(), aq.getPosition(), ans.getSelectedOptionId())); + } + return resultComputer.compute(items, perDimOf(attempt)); + } + + private int totalOf(AbilityAttempt attempt) { + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + return def == null || def.getAttemptQuestionCount() == null ? 24 : def.getAttemptQuestionCount(); + } + + private int perDimOf(AbilityAttempt attempt) { + AbilityDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + return def == null || def.getQuestionsPerDimension() == null ? 6 : def.getQuestionsPerDimension(); + } + + private String text(JsonNode snap, String key) { + JsonNode n = snap.path(key); + return n.isMissingNode() || n.isNull() ? null : n.asText(); + } + + private boolean perDimensionAnswered(Long attemptId) { + // 一次查询该答题的题目，一次批量查询该答题的全部答案，避免对每题逐条查询（消除 N+1） + List aqs = + attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(attemptId); + if (aqs.isEmpty()) { + return false; + } + Set answeredAqIds = answerRepository.findByAttemptId(attemptId).stream() + .map(AbilityAnswer::getAttemptQuestionId).collect(Collectors.toSet()); + Map counts = new LinkedHashMap<>(); + for (AbilityAttemptQuestion aq : aqs) { + if (answeredAqIds.contains(aq.getId())) { + String dim = snapshotCodec.text(aq.getQuestionSnapshotJson(), AbilitySnapshotCodec.KEY_DIMENSION); + counts.merge(dim, 1, Integer::sum); + } + } + int required = 6; + for (String d : DIMENSIONS) { + if (counts.getOrDefault(d, 0) != required) { + return false; + } + } + return true; + } + + private boolean expireIfTimedOut(AbilityAttempt attempt) { + if (isMutable(attempt.getStatus()) && attempt.getExpiresAt() != null + && !now().isBefore(attempt.getExpiresAt())) { + attemptRepository.markExpiredAndReleaseActive(attempt.getId()); + attempt.setStatus(AbilityAttempt.STATUS_EXPIRED); + attempt.setActiveKey(null); + return true; + } + return false; + } + + private void releaseTimedOut(Long userId, Long definitionId, LocalDateTime now) { + for (AbilityAttempt a : attemptRepository.findTimedOutActiveByUserAndDef(userId, definitionId, now)) { + attemptRepository.markExpiredAndReleaseActive(a.getId()); + } + // 立即刷新旧状态以免 DELETE/REREAD 不一致：不做，仅在此事务内后续判断用 DB 最新 + } + + private AbilityAttemptResponse toAttemptResponse(AbilityAttempt attempt) { + return toAttemptResponse(attempt, definitionRepository.findById(attempt.getDefinitionId()).orElse(null)); + } + + private AbilityAttemptResponse toAttemptResponse(AbilityAttempt attempt, AbilityDefinition def) { + List aqs = attemptQuestionRepository + .findByAttemptIdOrderByPositionAsc(attempt.getId()); + Map selectedByAq = answerRepository.findByAttemptId(attempt.getId()).stream() + .collect(Collectors.toMap(AbilityAnswer::getAttemptQuestionId, AbilityAnswer::getSelectedOptionId)); + + int total = totalOf(attempt); + int answered = attempt.getAnsweredCount() == null ? (int) selectedByAq.size() : attempt.getAnsweredCount(); + + List questions = new ArrayList<>(aqs.size()); + for (AbilityAttemptQuestion aq : aqs) { + JsonNode snap = snapshotCodec.parse(aq.getQuestionSnapshotJson()); + String itemType = text(snap, AbilitySnapshotCodec.KEY_ITEM_TYPE); + String stem = text(snap, AbilitySnapshotCodec.KEY_STEM); + List options = new ArrayList<>(); + JsonNode opts = snap.path(AbilitySnapshotCodec.KEY_OPTIONS); + if (opts.isArray()) { + for (JsonNode o : opts) { + options.add(AbilityAttemptResponse.AbilityOptionView.builder() + .optionId(o.path("optionId").asText()).text(o.path("text").asText()).build()); + } + } + questions.add(AbilityAttemptResponse.AbilityAttemptQuestionView.builder() + .attemptQuestionId(aq.getId()) + .position(aq.getPosition()) + .itemType(itemType) + .stem(stem) + .options(options) + .selectedOptionId(selectedByAq.get(aq.getId())) + .build()); + } + + Long remaining = null; + if (attempt.getExpiresAt() != null) { + long secs = Duration.between(now(), attempt.getExpiresAt()).getSeconds(); + remaining = Math.max(0, secs); + } + + return AbilityAttemptResponse.builder() + .attemptId(attempt.getId()) + .status(attempt.getStatus()) + .answeredCount(answered) + .totalQuestions(total) + .completionRate(completionRate(answered, total)) + .startedAt(attempt.getStartedAt()) + .expiresAt(attempt.getExpiresAt()) + .remainingSeconds(remaining) + .questions(questions) + .build(); + } + + /** + * 抽题：四维各若干道，且每维三个 competencyTag 各抽 2 道，共 def.attemptQuestionCount 道。 + * 任一维度/标签可用题不足时直接拒绝创建（不静默减少）。 + */ + private List sample(List all, AbilityDefinition def) { + int perDim = def.getQuestionsPerDimension() == null ? 6 : def.getQuestionsPerDimension(); + int attemptCount = def.getAttemptQuestionCount() == null ? 24 : def.getAttemptQuestionCount(); + int perTag = 2; // perDim = 3 tags × 2 + long seed = new Random().nextLong(); + Random random = new Random(seed); + + Map>> byDimTag = new LinkedHashMap<>(); + for (AbilityQuestion q : all) { + byDimTag.computeIfAbsent(q.getDimension(), k -> new LinkedHashMap<>()) + .computeIfAbsent(q.getCompetencyTag(), k -> new ArrayList<>()).add(q); + } + int collected = 0; + List picked = new ArrayList<>(); + for (String dim : DIMENSIONS) { + Map> tags = byDimTag.get(dim); + if (tags == null || tags.size() < 3) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "insufficient competency tags in dimension " + dim); + } + List dimPicked = new ArrayList<>(); + for (Map.Entry> e : tags.entrySet()) { + List group = new ArrayList<>(e.getValue()); + if (group.size() < perTag) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "insufficient active questions for tag " + e.getKey()); + } + Collections.shuffle(group, random); + dimPicked.addAll(group.subList(0, perTag)); + } + if (dimPicked.size() != perDim) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "dimension " + dim + " sampled != " + perDim); + } + picked.addAll(dimPicked); + collected += dimPicked.size(); + } + Collections.shuffle(picked, random); + if (collected != attemptCount || picked.size() != attemptCount) { + throw new BusinessException(ErrorCode.BAD_REQUEST, "sampled question count mismatch"); + } + return picked; + } + + private boolean isMutable(String status) { + return AbilityAttempt.STATUS_DRAFT.equals(status) + || AbilityAttempt.STATUS_IN_PROGRESS.equals(status); + } + + private AbilityAttempt loadOwned(Long userId, Long attemptId) { + AbilityAttempt a = attemptRepository.findById(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ABILITY_ATTEMPT_NOT_FOUND)); + if (!a.getStudentUserId().equals(userId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + return a; + } + private AbilityAttempt findByIdem(Long userId, String idem) { + if (idem == null) { + return null; + } + return attemptRepository.findByStudentUserIdAndIdempotencyKey(userId, idem).orElse(null); + } + + private String normalizeIdempotencyKey(String key) { + return key == null || key.isBlank() ? null : key.trim(); + } + + private String activeKeyOf(Long studentUserId, Long definitionId) { + return studentUserId + ":" + definitionId + ":ACTIVE"; + } + + private LocalDateTime now() { + return LocalDateTime.now(clock); + } + + private BigDecimal completionRate(int answered, int total) { + if (total <= 0) { + return BigDecimal.ZERO.setScale(2); + } + return BigDecimal.valueOf(answered) + .multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(total), 2, RoundingMode.HALF_UP); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptWriter.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptWriter.java new file mode 100644 index 0000000..9d3a141 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityAttemptWriter.java @@ -0,0 +1,51 @@ +package com.mydreamjob.ability; + +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * 答卷持久化写入 Bean（V36）。将「新建 attempt + 24 条 attempt_questions（含完整快照）」放入 + * 独立的 REQUIRES_NEW 事务：并发创建触发唯一键冲突（active_key / idempotency_key）时在独立事务内回滚， + * 外层 Session 不被污染，避免 Hibernate AssertionFailure 或 HTTP 500。 + */ +@Component +@RequiredArgsConstructor +public class AbilityAttemptWriter { + + private final AbilityAttemptRepository attemptRepository; + private final AbilityAttemptQuestionRepository attemptQuestionRepository; + private final AbilitySnapshotCodec snapshotCodec; + + @Transactional(propagation = Propagation.REQUIRES_NEW) + public AbilityAttempt persistNew(Long userId, AbilityDefinition def, List sampled, + String idempotencyKey, String activeKey) { + AbilityAttempt attempt = AbilityAttempt.builder() + .studentUserId(userId) + .definitionId(def.getId()) + .status(AbilityAttempt.STATUS_DRAFT) + .activeKey(activeKey) + .idempotencyKey(idempotencyKey) + .questionSetVersion(def.getQuestionSetVersion()) + .answeredCount(0) + .build(); + attempt = attemptRepository.saveAndFlush(attempt); + + int position = 1; + for (AbilityQuestion q : sampled) { + attemptQuestionRepository.save(AbilityAttemptQuestion.builder() + .attemptId(attempt.getId()) + .questionId(q.getId()) + .position(position++) + .questionVersion(q.getQuestionVersion()) + .questionSnapshotJson(snapshotCodec.build(q)) + .build()); + } + attemptQuestionRepository.flush(); + return attempt; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityCatalogService.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityCatalogService.java new file mode 100644 index 0000000..c17c8e0 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityCatalogService.java @@ -0,0 +1,32 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityTypeResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@RequiredArgsConstructor +public class AbilityCatalogService { + + private final AbilityDefinitionRepository definitionRepository; + + @Transactional(readOnly = true) + public List listTypes() { + return definitionRepository.findAllByStatusOrderByCreatedAtAsc(AbilityDefinition.STATUS_ACTIVE) + .stream() + .map(d -> AbilityTypeResponse.builder() + .typeCode(d.getTypeCode()) + .displayName(d.getDisplayName()) + .description(d.getDescription()) + .questionCount(d.getQuestionCount()) + .attemptQuestionCount(d.getAttemptQuestionCount()) + .timeLimitMinutes(d.getTimeLimitMinutes()) + .resultValidDays(d.getResultValidDays()) + .status(d.getStatus()) + .build()) + .toList(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityController.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityController.java new file mode 100644 index 0000000..2f9f7e1 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityController.java @@ -0,0 +1,152 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityAttemptResponse; +import com.mydreamjob.ability.dto.AbilityHistoryItem; +import com.mydreamjob.ability.dto.AbilityResultResponse; +import com.mydreamjob.ability.dto.AbilityTypeResponse; +import com.mydreamjob.ability.dto.CreateAbilityAttemptRequest; +import com.mydreamjob.ability.dto.SaveAbilityAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.api.PageResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.responses.ApiResponses; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.web.bind.annotation.*; + +import java.util.List; + +/** + * 四维能力测评接口（V36）。 + * + *

身份仅取自 JWT。测评类型对任意已登录角色开放；其余接口仅 STUDENT 且仅限本人。 + * 不回读完整题库：前端仅通过创建/恢复本人答卷获得本次 24 道题。

+ */ +@Tag(name = "四维能力测评", description = "能力测评类型、答卷、保存答案、提交、结果与历史") +@RestController +@RequiredArgsConstructor +public class AbilityController { + + private final AbilityCatalogService catalogService; + private final AbilityAttemptService attemptService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; + + @Operation(summary = "能力测评类型列表", + description = "返回全部 ACTIVE 能力测评定义，不返回题库/答案/评分规则。任意已登录用户。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录") + }) + @GetMapping("/abilities/types") + public ApiResponse> listTypes(HttpServletRequest request) { + return ApiResponse.ok(catalogService.listTypes(), requestIdAccessor.get(request)); + } + + @Operation(summary = "创建能力答卷", + description = "按四维各抽 6 题（每维三个 competencyTag 各 2）共 24 道并持久化，刷新不重抽。" + + "同幂等键重放返回原答卷；有效结果冷却期内 409/9810；90 天完成次数达上限 429/9811。仅 STUDENT。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "类型不存在（9801）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "活跃/幂等/冷却（9808/9809/9810）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "429", description = "重测次数上限（9811）") + }) + @PostMapping("/abilities/attempts") + public ApiResponse createAttempt( + @Valid @RequestBody CreateAbilityAttemptRequest req, HttpServletRequest request) { + return ApiResponse.ok(attemptService.create(currentUserAccessor.requireUserId(), req, AuditContext.from(request)), + requestIdAccessor.get(request)); + } + + @Operation(summary = "能力答卷详情", + description = "返回本次 24 道题（固定顺序）、已选答案、进度与倒计时。仅本人；超时自动标 EXPIRED。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9802）") + }) + @GetMapping("/abilities/attempts/{attemptId}") + public ApiResponse getAttempt( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(attemptService.get(currentUserAccessor.requireUserId(), attemptId), requestIdAccessor.get(request)); + } + + @Operation(summary = "保存能力测评答案", + description = "upsert；首次有效保存启动 30 分钟倒计时且并发安全；不延长；到期禁止保存；" + + "并发保存冲突 409/9807。仅本人。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9802）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "答案非法/未答完整（9805/9806）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "非法状态/并发/到期（9803/9807）") + }) + @PatchMapping("/abilities/attempts/{attemptId}/answers") + public ApiResponse saveAnswers( + @PathVariable Long attemptId, + @Valid @RequestBody SaveAbilityAnswersRequest req, HttpServletRequest request) { + return ApiResponse.ok(attemptService.saveAnswers(currentUserAccessor.requireUserId(), attemptId, req, + AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @Operation(summary = "提交能力测评答卷", + description = "24/24 且四维各 6 方可提交（否则 400/9806）；超时标 EXPIRED 不生成结果；" + + "并发提交最多一条结果与一条审计；重复提交幂等返回原结果。仅本人。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9802）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "未完成（9806）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "非法状态（9803）") + }) + @PostMapping("/abilities/attempts/{attemptId}/submit") + public ApiResponse submitAttempt( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(attemptService.submit(currentUserAccessor.requireUserId(), attemptId, + AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @Operation(summary = "查看能力测评结果", + description = "返回四维分、综合分、短板、提升建议、雷达与每题解析。仅本人；未生成结果 404/9804。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "结果不存在（9804）") + }) + @GetMapping("/abilities/attempts/{attemptId}/result") + public ApiResponse getResult( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(attemptService.loadResult(currentUserAccessor.requireUserId(), attemptId), requestIdAccessor.get(request)); + } + + @Operation(summary = "我的能力测评历史", + description = "分页返回当前学生全部答卷与结果概要。仅 STUDENT 本人。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 STUDENT（2002）") + }) + @GetMapping("/abilities/me") + public ApiResponse> listMine( + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + Page result = attemptService.listMine(currentUserAccessor.requireUserId(), page, size); + return ApiResponse.ok(PageResponse.of( + result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), + requestIdAccessor.get(request)); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinition.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinition.java new file mode 100644 index 0000000..ff49d95 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinition.java @@ -0,0 +1,79 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_definitions") +@EntityListeners(AuditingEntityListener.class) +public class AbilityDefinition { + + public static final String STATUS_ACTIVE = "ACTIVE"; + public static final String STATUS_INACTIVE = "INACTIVE"; + + public static final String TYPE_WORKPLACE_ABILITY = "WORKPLACE_ABILITY"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "type_code", nullable = false, length = 40) + private String typeCode; + + @Column(name = "display_name", nullable = false, length = 100) + private String displayName; + + @Column(length = 1000) + private String description; + + @Column(name = "status", nullable = false, length = 20) + @Builder.Default + private String status = STATUS_ACTIVE; + + @Column(name = "question_count", nullable = false) + private Integer questionCount; + + @Column(name = "attempt_question_count", nullable = false) + private Integer attemptQuestionCount; + + @Column(name = "questions_per_dimension", nullable = false) + private Integer questionsPerDimension; + + @Column(name = "time_limit_minutes", nullable = false) + private Integer timeLimitMinutes; + + @Column(name = "result_valid_days", nullable = false) + private Integer resultValidDays; + + @Column(name = "retake_window_days", nullable = false) + private Integer retakeWindowDays; + + @Column(name = "retake_max_completed", nullable = false) + private Integer retakeMaxCompleted; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "rules_version", nullable = false, length = 40) + private String rulesVersion; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinitionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinitionRepository.java new file mode 100644 index 0000000..0c06848 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityDefinitionRepository.java @@ -0,0 +1,13 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; +import java.util.Optional; + +public interface AbilityDefinitionRepository extends JpaRepository { + + Optional findByTypeCode(String typeCode); + + List findAllByStatusOrderByCreatedAtAsc(String status); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityImprovementCatalog.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityImprovementCatalog.java new file mode 100644 index 0000000..2a1ffed --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityImprovementCatalog.java @@ -0,0 +1,98 @@ +package com.mydreamjob.ability; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 固定白名单建议目录（V36，非 AI）。每个 competencyTag 提供短板提示摘要与可执行动作。 + */ +public final class AbilityImprovementCatalog { + + private AbilityImprovementCatalog() { + } + + public static final Map ACTIONS = new LinkedHashMap<>(); + + static { + ACTIONS.put("INFORMATION_ANALYSIS", new String[]{ + "每次对数据进行判断前，先统一指标定义、时间范围与数据来源。", + "把“结论”与“证据来源”拆开记录，遇到不一致时先定位原始数据。", + "养成用“假设-验证-记录”清单核对结果的习惯。"}); + ACTIONS.put("CAUSAL_REASONING", new String[]{ + "区分“相关”与“因果”，只有对照与趋势分析才能支持因果判断。", + "排查同时变化的混杂因素，避免把时间先后当作因果。", + "用最小可验证实验（单变量对照）检验关键假设。"}); + ACTIONS.put("PROBLEM_SOLVING", new String[]{ + "把模糊任务先转化为用户、场景、问题和验收标准。", + "复杂问题先拆子问题、明确输入输出，再逐项验证。", + "方案失败时对照预期与实际，检查假设、执行偏差与外部因素。"}); + ACTIONS.put("LISTENING_UNDERSTANDING", new String[]{ + "用“复述理解-确认目标/边界”的方式回应模糊需求。", + "先听完事实与影响，再提建议，避免打断或提前下结论。", + "把情绪表达转化为具体场景、期望与影响后再行动。"}); + ACTIONS.put("STRUCTURED_EXPRESSION", new String[]{ + "重要消息按“背景-问题-行动-负责人-截止时间”组织。", + "面向不同对象选择信息颗粒度，先讲影响再讲原理。", + "反馈聚焦具体的可观察行为、影响与修改标准，不上升为人格评价。"}); + ACTIONS.put("COLLABORATION_CONFLICT", new String[]{ + "分歧发生时先确认共同目标，再用统一标准比较方案。", + "跨团队问题先确认事实与阻塞，再共同制定新节点与升级条件。", + "边界沟通说明已有承诺与优先级，主动提出替代时间或资源方案。"}); + ACTIONS.put("PLANNING_PRIORITIZATION", new String[]{ + "计划从交付结果出发，明确步骤、依赖、负责人与检查节点。", + "资源冲突时按影响、时效与依赖排序，并同步取舍方案。", + "范围变化时量化影响，推动范围/资源/时间的明确取舍。"}); + ACTIONS.put("RISK_FOLLOWUP", new String[]{ + "记录风险触发条件、概率、影响、责任人、应对方案并持续检查。", + "阻塞时透明说明影响，提出备选路径并约定升级时间。", + "用可验证的小节点产出衡量真实进度，而非主观百分比。"}); + ACTIONS.put("DELIVERY_REVIEW", new String[]{ + "交付前用验收标准确认结果，并补齐测试、文档、监控与交接。", + "临近截止时间守住关键质量门槛，用范围取舍与分阶段交付管理风险。", + "复盘比较目标与实际，形成有负责人和期限的改进动作。"}); + ACTIONS.put("INFORMATION_ACQUISITION", new String[]{ + "学习新技能先明确使用目标，读权威资料并做小练习再应用。", + "比较信息源、发布时间、证据与适用条件，并做小范围验证。", + "围绕真实问题建立框架，再用实践和反馈补齐知识。"}); + ACTIONS.put("FEEDBACK_REFLECTION", new String[]{ + "把模糊反馈转化为具体例子，修改后再次验证是否解决。", + "失败后还原目标、过程与关键决策，区分假设、执行与外部因素。", + "用“目标-练习-反馈-调整-再验证”的闭环持续提升。"}); + ACTIONS.put("TRANSFER_ADAPTATION", new String[]{ + "迁移方法时识别共同原理与条件差异，用结果验证适配。", + "求助时说明目标、现象、已尝试方法与当前判断。", + "面对变化结合需求、成本与验证结果，规划分阶段迁移与学习。"}); + } + + public static Advice get(String tag) { + String[] actions = ACTIONS.get(tag); + if (actions == null) { + return new Advice("结合工作情境，分析本题对应能力并制定练习计划。", + List.of("复盘本题更合理的处理方式并复述关键判断。", "在真实任务中主动实践对应能力并记录结果。", "阶段性回顾并调整改进动作。")); + } + return new Advice(summary(tag), List.of(actions)); + } + + public record Advice(String summary, List actions) { + } + + private static String summary(String tag) { + return switch (tag) { + case "INFORMATION_ANALYSIS" -> "提升对信息口径与来源的核查颗粒度，先统一再做判断。"; + case "CAUSAL_REASONING" -> "加强因果判断意识，用对照与单变量验证支持结论。"; + case "PROBLEM_SOLVING" -> "先定义问题与验收标准，再拆解并逐项验证解决方案。"; + case "LISTENING_UNDERSTANDING" -> "先确认理解与目标，再给出回应，避免基于错误假设的建议。"; + case "STRUCTURED_EXPRESSION" -> "面向受众组织信息，先结论后证据，明确行动与负责人。"; + case "COLLABORATION_CONFLICT" -> "用共同目标与一致标准处理分歧，前置确认事实与优先级。"; + case "PLANNING_PRIORITIZATION" -> "以结果与节点驱动计划，资源冲突时显性取舍并同步相关方。"; + case "RISK_FOLLOWUP" -> "隐患转化为可观察的风险条目并持续跟进，而非一次性提醒。"; + case "DELIVERY_REVIEW" -> "交付以验收标准为闭环，复盘以有责任人和期限的动作落地。"; + case "INFORMATION_ACQUISITION" -> "围绕目标选权威信息并动手验证，用实践补齐知识。"; + case "FEEDBACK_REFLECTION" -> "把反馈变成具体行动并通过再次验证确认改进。"; + case "TRANSFER_ADAPTATION" -> "识别原理与条件差异做迁移，变化时规划分阶段落地。"; + default -> "结合情境制定对应能力维度的练习与复盘计划。"; + }; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestion.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestion.java new file mode 100644 index 0000000..2b51729 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestion.java @@ -0,0 +1,88 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_questions") +@EntityListeners(AuditingEntityListener.class) +public class AbilityQuestion { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "definition_id", nullable = false) + private Long definitionId; + + @Column(name = "question_code", nullable = false, length = 20) + private String questionCode; + + @Column(name = "dimension", nullable = false, length = 20) + private String dimension; + + @Column(name = "competency_tag", nullable = false, length = 40) + private String competencyTag; + + @Column(name = "item_type", nullable = false, length = 40) + private String itemType; + + @Column(nullable = false, length = 2000) + private String stem; + + @Column(name = "options_json", nullable = false, columnDefinition = "text") + private String optionsJson; + + @Column(name = "answer_key_json", nullable = false, columnDefinition = "text") + private String answerKeyJson; + + @Column(name = "scoring_rule_json", nullable = false, columnDefinition = "text") + private String scoringRuleJson; + + @Column(columnDefinition = "text") + private String explanation; + + @Column(name = "difficulty", nullable = false, length = 10) + private String difficulty; + + @Column(name = "discrimination", precision = 6, scale = 3) + private BigDecimal discrimination; + + @Column(name = "question_version", nullable = false, length = 40) + private String questionVersion; + + @Column(name = "source", nullable = false, length = 40) + @Builder.Default + private String source = "SELF_AUTHORED"; + + @Column(nullable = false) + @JdbcTypeCode(SqlTypes.TINYINT) + @Builder.Default + private Boolean active = true; + + @Column(nullable = false) + private Integer position; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestionRepository.java new file mode 100644 index 0000000..818feb4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityQuestionRepository.java @@ -0,0 +1,12 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; + +public interface AbilityQuestionRepository extends JpaRepository { + + List findByDefinitionIdAndActiveTrueOrderByPositionAsc(Long definitionId); + + List findAllByDefinitionIdOrderByPositionAsc(Long definitionId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResult.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResult.java new file mode 100644 index 0000000..76daaa4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResult.java @@ -0,0 +1,62 @@ +package com.mydreamjob.ability; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "ability_results") +@EntityListeners(AuditingEntityListener.class) +public class AbilityResult { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "dimension_scores_json", columnDefinition = "text") + private String dimensionScoresJson; + + @Column(name = "overall_score", nullable = false, precision = 5, scale = 2) + private BigDecimal overallScore; + + @Column(name = "weaknesses_json", columnDefinition = "text") + private String weaknessesJson; + + @Column(name = "improvement_areas_json", columnDefinition = "text") + private String improvementAreasJson; + + @Column(name = "question_feedback_json", columnDefinition = "text") + private String questionFeedbackJson; + + @Column(name = "valid_until") + private LocalDateTime validUntil; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "rules_version", nullable = false, length = 40) + private String rulesVersion; + + @CreatedDate + @Column(name = "generated_at", nullable = false, updatable = false) + private LocalDateTime generatedAt; + + @Version + @Column(name = "version", nullable = false) + @Builder.Default + private Long version = 0L; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultComputer.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultComputer.java new file mode 100644 index 0000000..05d4e07 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultComputer.java @@ -0,0 +1,150 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityResultResponse; +import org.springframework.stereotype.Component; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 四维能力计分与结果计算机（V36）。 + * + *

每题最优 4 / 次优 2 / 一般 1 / 高风险 0；每维 6 题满分 24， + * dimensionScore = rawScore / 24 × 100；overallScore = 四维平均（须四维齐全）。 + * 满分与单维题数由定义给出，但默认 4 / 6 保持一致。

+ */ +@Component +public class AbilityResultComputer { + + public static final int MAX_SCORE_PER_QUESTION = 4; + public static final List DIMENSIONS = + List.of("LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"); + + public static final String DISCLAIMER = + "本测评反映当前工作情境答题表现，用于自我了解和能力提升参考；不构成职业资格、正式招聘结论或永久能力标签。"; + + public static final String VALIDITY_VALID = "VALID"; + public static final String VALIDITY_EXPIRED = "EXPIRED"; + + public record Answered(String dimension, String competencyTag, String stem, String explanation, + int awardedScore, long attemptQuestionId, int position, + String selectedOptionId) { + } + + public record ComputedResult(List dimensionScores, + BigDecimal overallScore, + List weaknesses, + List improvementAreas, + List radar, + List questionFeedback) { + } + + public ComputedResult compute(List items, int perDimQuestions) { + List dims = new ArrayList<>(); + Map> byDim = new LinkedHashMap<>(); + for (String d : DIMENSIONS) { + byDim.put(d, items.stream().filter(it -> d.equals(it.dimension())).toList()); + } + Map rawByDim = new LinkedHashMap<>(); + for (Map.Entry> e : byDim.entrySet()) { + int raw = e.getValue().stream().mapToInt(Answered::awardedScore).sum(); + rawByDim.put(e.getKey(), raw); + int maxScoreTotal = perDimQuestions * MAX_SCORE_PER_QUESTION; + BigDecimal score = maxScoreTotal <= 0 ? BigDecimal.ZERO.setScale(2) + : BigDecimal.valueOf(raw).multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(maxScoreTotal), 2, RoundingMode.HALF_UP); + dims.add(AbilityResultResponse.DimensionScore.builder() + .code(e.getKey()).score(score).answeredCount(e.getValue().size()).build()); + } + + // 综合分：四维都必须有 6 道有效答案 + BigDecimal overall = null; + boolean allAnswered = DIMENSIONS.stream().allMatch(d -> byDim.get(d).size() >= perDimQuestions); + if (allAnswered && !dims.isEmpty()) { + BigDecimal sum = dims.stream().map(AbilityResultResponse.DimensionScore::getScore) + .reduce(BigDecimal.ZERO, BigDecimal::add); + overall = sum.divide(BigDecimal.valueOf(dims.size()), 2, RoundingMode.HALF_UP); + } + + // 短板：四维最低分，并列全部返回 + BigDecimal min = dims.stream().map(AbilityResultResponse.DimensionScore::getScore) + .min(Comparator.naturalOrder()).orElse(null); + List weaknesses = new ArrayList<>(); + if (min != null) { + for (AbilityResultResponse.DimensionScore ds : dims) { + if (ds.getScore().compareTo(min) == 0) { + weaknesses.add(AbilityResultResponse.Weakness.builder() + .code(ds.getCode()).score(ds.getScore()).build()); + } + } + } + + // 提升建议：最低维度的最低 competencyTag，固定白名单 + List areas = new ArrayList<>(); + if (min != null) { + String weakestDim = dims.stream() + .filter(ds -> ds.getScore().compareTo(min) == 0) + .min(Comparator.comparing(AbilityResultResponse.DimensionScore::getCode)) + .map(AbilityResultResponse.DimensionScore::getCode).orElse(null); + if (weakestDim != null) { + String tag = lowestCompetencyTag(byDim.getOrDefault(weakestDim, List.of())); + BigDecimal tagScore = competencyScore(byDim.getOrDefault(weakestDim, List.of()), tag); + AbilityImprovementCatalog.Advice advice = + AbilityImprovementCatalog.get(tag == null ? weakestDim : tag); + // competencyTag 仅内部用于生成摘要与动作，不写入对外 DTO + areas.add(AbilityResultResponse.ImprovementArea.builder() + .dimension(weakestDim) + .currentScore(tagScore).summary(advice.summary()).actions(advice.actions()) + .build()); + } + } + + // 雷达 + List radar = new ArrayList<>(); + for (AbilityResultResponse.DimensionScore ds : dims) { + radar.add(AbilityResultResponse.RadarEntry.builder() + .code(ds.getCode()).value(ds.getScore()).build()); + } + + // 每题解析（仅暴露本题解析文本，不返回答案键与完整评分规则） + List feedback = new ArrayList<>(); + for (Answered a : items) { + feedback.add(AbilityResultResponse.QuestionFeedback.builder() + .attemptQuestionId(a.attemptQuestionId()).position(a.position()) + .stem(a.stem()).selectedOptionId(a.selectedOptionId()) + .awardedScore(a.awardedScore()).maxScore(MAX_SCORE_PER_QUESTION) + .explanation(a.explanation()).build()); + } + + return new ComputedResult(dims, overall, weaknesses, areas, radar, feedback); + } + + private String lowestCompetencyTag(List items) { + Map raw = new LinkedHashMap<>(); + for (Answered a : items) { + raw.merge(a.competencyTag(), a.awardedScore(), Integer::sum); + } + return raw.entrySet().stream() + .min(Comparator.>comparingInt(Map.Entry::getValue) + .thenComparing(Map.Entry::getKey)) + .map(Map.Entry::getKey).orElse(null); + } + + private BigDecimal competencyScore(List items, String tag) { + List tagged = items.stream() + .filter(a -> java.util.Objects.equals(tag, a.competencyTag())).toList(); + if (tagged.isEmpty()) { + return BigDecimal.ZERO.setScale(2); + } + int raw = tagged.stream().mapToInt(Answered::awardedScore).sum(); + int maxCol = tagged.size() * MAX_SCORE_PER_QUESTION; + return maxCol <= 0 ? BigDecimal.ZERO.setScale(2) + : BigDecimal.valueOf(raw).multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(maxCol), 2, RoundingMode.HALF_UP); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultRepository.java new file mode 100644 index 0000000..aefffeb --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultRepository.java @@ -0,0 +1,14 @@ +package com.mydreamjob.ability; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Collection; +import java.util.List; +import java.util.Optional; + +public interface AbilityResultRepository extends JpaRepository { + + Optional findByAttemptId(Long attemptId); + + List findByAttemptIdIn(Collection attemptIds); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultService.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultService.java new file mode 100644 index 0000000..b23e3b7 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilityResultService.java @@ -0,0 +1,109 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.ability.dto.AbilityResultResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; + +@Service +@RequiredArgsConstructor +public class AbilityResultService { + + private final ObjectMapper objectMapper; + + private static final TypeReference> DIM_LIST = + new TypeReference<>() { + }; + private static final TypeReference> WEAK_LIST = + new TypeReference<>() { + }; + private static final TypeReference> AREA_LIST = + new TypeReference<>() { + }; + private static final TypeReference> FEEDBACK_LIST = + new TypeReference<>() { + }; + + public AbilityResult persist(AbilityAttempt attempt, AbilityDefinition def, + AbilityResultComputer.ComputedResult computed, LocalDateTime now) { + AbilityResult r = AbilityResult.builder() + .attemptId(attempt.getId()) + .dimensionScoresJson(write(computed.dimensionScores())) + .overallScore(computed.overallScore()) + .weaknessesJson(write(computed.weaknesses())) + .improvementAreasJson(write(computed.improvementAreas())) + .questionFeedbackJson(write(computed.questionFeedback())) + .validUntil(now.plusDays(def.getResultValidDays() == null ? 7 : def.getResultValidDays())) + .questionSetVersion(def.getQuestionSetVersion()) + .rulesVersion(def.getRulesVersion()) + .generatedAt(now) + .build(); + return r; + } + + public AbilityResultResponse toResponse(AbilityAttempt attempt, AbilityResult result, AbilityDefinition def, + LocalDateTime now) { + List dims = read(result.getDimensionScoresJson(), DIM_LIST); + List radar = new ArrayList<>(); + for (AbilityResultResponse.DimensionScore ds : dims) { + radar.add(AbilityResultResponse.RadarEntry.builder() + .code(ds.getCode()).value(ds.getScore()).build()); + } + boolean valid = result.getValidUntil() != null && now.isBefore(result.getValidUntil()); + return AbilityResultResponse.builder() + .attemptId(result.getAttemptId()) + .typeCode(def == null ? null : def.getTypeCode()) + .status(AbilityAttempt.STATUS_COMPLETED) + .validityStatus(valid ? AbilityResultComputer.VALIDITY_VALID + : AbilityResultComputer.VALIDITY_EXPIRED) + .validUntil(result.getValidUntil()) + .dimensionScores(dims) + .overallScore(result.getOverallScore()) + .weaknesses(read(result.getWeaknessesJson(), WEAK_LIST)) + .improvementAreas(read(result.getImprovementAreasJson(), AREA_LIST)) + .radar(radar) + .answeredCount(attempt.getAnsweredCount()) + .completionRate(attempt.getAnsweredCount() == null ? null + : completionRate(attempt.getAnsweredCount(), + def == null || def.getAttemptQuestionCount() == null ? 24 : def.getAttemptQuestionCount())) + .questionFeedback(read(result.getQuestionFeedbackJson(), FEEDBACK_LIST)) + .questionSetVersion(result.getQuestionSetVersion()) + .rulesVersion(result.getRulesVersion()) + .generatedAt(result.getGeneratedAt()) + .disclaimer(AbilityResultComputer.DISCLAIMER) + .build(); + } + + private java.math.BigDecimal completionRate(int answered, int total) { + if (total <= 0) { + return java.math.BigDecimal.ZERO.setScale(2); + } + return java.math.BigDecimal.valueOf(answered) + .multiply(java.math.BigDecimal.valueOf(100)) + .divide(java.math.BigDecimal.valueOf(total), 2, java.math.RoundingMode.HALF_UP); + } + + private String write(Object obj) { + try { + return objectMapper.writeValueAsString(obj); + } catch (Exception e) { + throw new IllegalStateException("unable to serialize ability result", e); + } + } + + private List read(String json, TypeReference> ref) { + if (json == null || json.isBlank()) { + return List.of(); + } + try { + return objectMapper.readValue(json, ref); + } catch (Exception e) { + throw new IllegalStateException("unable to deserialize ability result", e); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilitySnapshotCodec.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilitySnapshotCodec.java new file mode 100644 index 0000000..ea98068 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/AbilitySnapshotCodec.java @@ -0,0 +1,88 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +import java.util.LinkedHashMap; +import java.util.Map; + +/** + * 题目快照编解码：把 {@link AbilityQuestion} 关键内容固化为快照 JSON， + * 并据此判定所选选项所得分值。快照保证后续题库更新不改历史答卷评分。 + */ +@Component +@RequiredArgsConstructor +public class AbilitySnapshotCodec { + + public static final String KEY_QUESTION_ID = "questionId"; + public static final String KEY_QUESTION_CODE = "questionCode"; + public static final String KEY_DIMENSION = "dimension"; + public static final String KEY_COMPETENCY_TAG = "competencyTag"; + public static final String KEY_ITEM_TYPE = "itemType"; + public static final String KEY_STEM = "stem"; + public static final String KEY_OPTIONS = "options"; + public static final String KEY_ANSWER_KEY = "answerKey"; + public static final String KEY_SCORING_RULE = "scoringRule"; + public static final String KEY_EXPLANATION = "explanation"; + + private final ObjectMapper objectMapper; + + public String build(AbilityQuestion q) { + try { + Map snap = new LinkedHashMap<>(); + snap.put(KEY_QUESTION_ID, q.getId()); + snap.put(KEY_QUESTION_CODE, q.getQuestionCode()); + snap.put(KEY_DIMENSION, q.getDimension()); + snap.put(KEY_COMPETENCY_TAG, q.getCompetencyTag()); + snap.put(KEY_ITEM_TYPE, q.getItemType()); + snap.put(KEY_STEM, q.getStem()); + snap.put(KEY_OPTIONS, objectMapper.readTree(q.getOptionsJson())); + snap.put(KEY_ANSWER_KEY, objectMapper.readTree(q.getAnswerKeyJson()).path("answerKey").asText()); + snap.put(KEY_SCORING_RULE, objectMapper.readTree(q.getScoringRuleJson())); + snap.put(KEY_EXPLANATION, q.getExplanation()); + return objectMapper.writeValueAsString(snap); + } catch (Exception e) { + throw new IllegalStateException("unable to build ability question snapshot", e); + } + } + + public JsonNode parse(String snapshotJson) { + try { + return objectMapper.readTree(snapshotJson); + } catch (Exception e) { + throw new IllegalStateException("unable to parse ability question snapshot", e); + } + } + + public String text(String snapshotJson, String key) { + JsonNode n = parse(snapshotJson).path(key); + return n.isMissingNode() || n.isNull() ? null : n.asText(); + } + + /** + * 按所选选项返回分值（0/1/2/4）；选项不存在返回 null。 + */ + public Integer awardedScore(String snapshotJson, String selectedOptionId) { + JsonNode rule = parse(snapshotJson).path(KEY_SCORING_RULE); + if (rule == null || rule.isMissingNode() || selectedOptionId == null) { + return null; + } + JsonNode v = rule.get(selectedOptionId); + return (v == null || v.isNull()) ? null : v.asInt(); + } + + public boolean optionExists(String snapshotJson, String optionId) { + JsonNode options = parse(snapshotJson).path(KEY_OPTIONS); + if (options.isMissingNode() || !options.isArray()) { + return false; + } + for (JsonNode o : options) { + if (optionId.equals(o.path("optionId").asText())) { + return true; + } + } + return false; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityAttemptResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityAttemptResponse.java new file mode 100644 index 0000000..b9c1b5f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityAttemptResponse.java @@ -0,0 +1,44 @@ +package com.mydreamjob.ability.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; + +/** + * 答卷响应（创建/详情）。题目仅暴露 attemptQuestionId / position / itemType / stem / options / selectedOptionId， + * 绝不返回 questionCode / dimension / competencyTag / answerKey / scoringRule / explanation / difficulty 等内部字段。 + */ +@Data +@Builder +public class AbilityAttemptResponse { + private Long attemptId; + private String status; + private Integer answeredCount; + private Integer totalQuestions; + private BigDecimal completionRate; + private LocalDateTime startedAt; + private LocalDateTime expiresAt; + private Long remainingSeconds; + private List questions; + + @Data + @Builder + public static class AbilityAttemptQuestionView { + private Long attemptQuestionId; + private Integer position; + private String itemType; + private String stem; + private List options; + private String selectedOptionId; + } + + @Data + @Builder + public static class AbilityOptionView { + private String optionId; + private String text; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityHistoryItem.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityHistoryItem.java new file mode 100644 index 0000000..f0f182b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityHistoryItem.java @@ -0,0 +1,23 @@ +package com.mydreamjob.ability.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +@Data +@Builder +public class AbilityHistoryItem { + private Long attemptId; + private String typeCode; + private String status; + private String validityStatus; + private BigDecimal overallScore; + private Integer answeredCount; + private BigDecimal completionRate; + private LocalDateTime startedAt; + private LocalDateTime expiresAt; + private LocalDateTime completedAt; + private LocalDateTime validUntil; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityResultResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityResultResponse.java new file mode 100644 index 0000000..ddb05b5 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityResultResponse.java @@ -0,0 +1,76 @@ +package com.mydreamjob.ability.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; + +/** + * 结果响应白名单。不含原始答案分值键/完整评分规则/学生身份等敏感字段。 + */ +@Data +@Builder +public class AbilityResultResponse { + private Long attemptId; + private String typeCode; + private String status; + private String validityStatus; // VALID / EXPIRED（动态计算） + private LocalDateTime validUntil; + private List dimensionScores; + private BigDecimal overallScore; + private List weaknesses; + private List improvementAreas; + private List radar; + private Integer answeredCount; + private BigDecimal completionRate; + private List questionFeedback; + private String questionSetVersion; + private String rulesVersion; + private LocalDateTime generatedAt; + private String disclaimer; + + @Data + @Builder + public static class DimensionScore { + private String code; // LOGIC/COMMUNICATION/EXECUTION/LEARNING + private BigDecimal score; + private Integer answeredCount; + } + + @Data + @Builder + public static class Weakness { + private String code; + private BigDecimal score; + } + + @Data + @Builder + public static class ImprovementArea { + private String dimension; + private BigDecimal currentScore; + private String summary; + private List actions; + } + + @Data + @Builder + public static class RadarEntry { + private String code; + private BigDecimal value; + } + + @Data + @Builder + public static class QuestionFeedback { + private Long attemptQuestionId; + private Integer position; + private String stem; + private String selectedOptionId; + private Integer awardedScore; + private Integer maxScore; + private String explanation; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityTypeResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityTypeResponse.java new file mode 100644 index 0000000..927d121 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/AbilityTypeResponse.java @@ -0,0 +1,17 @@ +package com.mydreamjob.ability.dto; + +import lombok.Builder; +import lombok.Data; + +@Data +@Builder +public class AbilityTypeResponse { + private String typeCode; + private String displayName; + private String description; + private Integer questionCount; + private Integer attemptQuestionCount; + private Integer timeLimitMinutes; + private Integer resultValidDays; + private String status; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/CreateAbilityAttemptRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/CreateAbilityAttemptRequest.java new file mode 100644 index 0000000..3ccc315 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/CreateAbilityAttemptRequest.java @@ -0,0 +1,11 @@ +package com.mydreamjob.ability.dto; + +import jakarta.validation.constraints.NotBlank; +import lombok.Data; + +@Data +public class CreateAbilityAttemptRequest { + @NotBlank + private String typeCode; + private String idempotencyKey; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/SaveAbilityAnswersRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/SaveAbilityAnswersRequest.java new file mode 100644 index 0000000..2a8f45a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/ability/dto/SaveAbilityAnswersRequest.java @@ -0,0 +1,21 @@ +package com.mydreamjob.ability.dto; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import lombok.Data; + +import java.util.List; + +@Data +public class SaveAbilityAnswersRequest { + + @Valid + @NotEmpty(message = "answers must not be empty") + private List answers; + + @Data + public static class AnswerItem { + private Long attemptQuestionId; + private String selectedOptionId; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationController.java index ee2a98e..7c07fa3 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationController.java @@ -1,11 +1,11 @@ package com.mydreamjob.application; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.api.PageResponse; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.application.dto.CandidateDetailView; -import com.mydreamjob.application.dto.CandidateItemView; +import com.mydreamjob.application.dto.CompanyResumeFile; +import com.mydreamjob.application.dto.CandidateListResponse; import com.mydreamjob.application.dto.ApplicationCreateRequest; import com.mydreamjob.application.dto.ApplicationStatusRequest; import com.mydreamjob.company.CompanyService; @@ -16,11 +16,13 @@ import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; +import org.springframework.http.ContentDisposition; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; +import java.nio.charset.StandardCharsets; import java.util.HashMap; import java.util.List; import java.util.Map; @@ -32,13 +34,20 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class ApplicationController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final ApplicationService applicationService; private final CompanyService companyService; private final UserRepository userRepository; + private final CompanyResumeService companyResumeService; private static final Set ALLOWED_STATUSES = Set.of( "SUBMITTED", "VIEWED", "INTERVIEW", "HIRED", "REJECTED", "WITHDRAWN"); - private static final Set ALLOWED_SORTS = Set.of("createdAt", "updatedAt", "match"); + private static final Set ALLOWED_SORTS = Set.of("createdAt", "updatedAt"); private static final Set ALLOWED_ORDERS = Set.of("asc", "desc"); // ── 学生投递 ────────────────────────────────────────────── @@ -48,9 +57,9 @@ public class ApplicationController { public ResponseEntity>> apply( @Valid @RequestBody ApplicationCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Application app = applicationService.apply(userId, req, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), requestIdAccessor.get(request))); } // ── 学生撤回投递 ────────────────────────────────────────── @@ -60,9 +69,9 @@ public class ApplicationController { public ResponseEntity>> withdraw( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Application app = applicationService.withdraw(userId, id, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), requestIdAccessor.get(request))); } // ── 投递时间线 ──────────────────────────────────────────── @@ -72,9 +81,9 @@ public class ApplicationController { public ResponseEntity>>> timeline( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List> data = applicationService.getTimeline(id, userId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 学生查看自己的投递 ──────────────────────────────────── @@ -86,7 +95,7 @@ public class ApplicationController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); if (size > 100) size = 100; Page result = applicationService.listStudentApplications(userId, status, page, size); Map data = new HashMap<>(); @@ -95,7 +104,7 @@ public class ApplicationController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "投递详情", description = "查看自己的投递记录详情") @@ -103,9 +112,9 @@ public class ApplicationController { public ResponseEntity>> getApplication( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Application app = applicationService.getApplication(id, userId); - return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), requestIdAccessor.get(request))); } // ── 企业查看岗位收到的投递 ──────────────────────────────── @@ -118,7 +127,7 @@ public class ApplicationController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); var company = companyService.findCompanyByOwnerUserId(userId); if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); if (size > 100) size = 100; @@ -130,7 +139,7 @@ public class ApplicationController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 企业更新投递状态 ────────────────────────────────────── @@ -141,18 +150,18 @@ public class ApplicationController { @PathVariable Long id, @Valid @RequestBody ApplicationStatusRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); var company = companyService.findCompanyByOwnerUserId(userId); if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); Application app = applicationService.updateStatus(company.getId(), id, req, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(applicationService.toView(app), requestIdAccessor.get(request))); } // ── 企业候选人看板 ──────────────────────────────────────── @Operation(summary = "企业候选人列表", description = "跨岗位查询本企业所有候选人投递，支持按岗位、状态、关键词筛选，支持分页和排序") @GetMapping("/company/candidates") - public ResponseEntity>> listCompanyCandidates( + public ResponseEntity> listCompanyCandidates( @RequestParam(required = false) Long jobId, @RequestParam(required = false) String status, @RequestParam(required = false) String keyword, @@ -161,8 +170,8 @@ public class ApplicationController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); - assertCompanyRole(userId); + Long userId = currentUserAccessor.requireUserId(); + userRoleGuard.requireCompany(userId); // 参数校验 if (page < 0 || size < 1 || size > 100) @@ -185,9 +194,9 @@ public class ApplicationController { var company = companyService.findCompanyByOwnerUserId(userId); if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); - PageResponse data = applicationService.listCompanyCandidates( + CandidateListResponse data = applicationService.listCompanyCandidates( company.getId(), jobId, status, keyword, sort, order, page, size); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "企业候选人详情", description = "查看投递详情及候选人公开资料，只能查看本企业岗位下的投递") @@ -195,33 +204,38 @@ public class ApplicationController { public ResponseEntity> getCompanyCandidateDetail( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(request); - assertCompanyRole(userId); + Long userId = currentUserAccessor.requireUserId(); + userRoleGuard.requireCompany(userId); var company = companyService.findCompanyByOwnerUserId(userId); if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); CandidateDetailView data = applicationService.getCompanyCandidateDetail( company.getId(), applicationId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); - } - - // ── 辅助 ────────────────────────────────────────────────── - - private void assertCompanyRole(Long userId) { - var user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - if (user.getRoles().stream().noneMatch(r -> r.name().equals("COMPANY"))) - throw new BusinessException(ErrorCode.FORBIDDEN); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + @Operation(summary = "企业下载候选人简历", + description = "按候选人隐私设置授权后返回简历文件流；不返回存储路径、学生 ID 或联系方式") + @GetMapping("/company/candidates/{applicationId}/resume") + public ResponseEntity downloadCandidateResume( + @PathVariable Long applicationId, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + userRoleGuard.requireCompany(userId); + + // 授权全部在 Service/Policy 内完成：这里不传递任何归属信息，只传 applicationId。 + CompanyResumeFile file = companyResumeService.load(userId, applicationId); + + ContentDisposition disposition = ContentDisposition.attachment() + .filename(file.filename(), StandardCharsets.UTF_8) + .build(); + return ResponseEntity.ok() + .contentType(MediaType.parseMediaType(file.contentType())) + .header(HttpHeaders.CONTENT_DISPOSITION, disposition.toString()) + // 私有简历不进任何中间缓存。 + .header(HttpHeaders.CACHE_CONTROL, "no-store") + .body(file.content()); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } + // ── 辅助 ────────────────────────────────────────────────── } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationRepository.java index 648bffd..0b854c4 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationRepository.java @@ -29,6 +29,9 @@ public interface ApplicationRepository extends JpaRepository boolean existsByJobIdAndStudentUserId(Long jobId, Long studentUserId); + @org.springframework.data.jpa.repository.Query("select distinct a.jobId from Application a where a.studentUserId = :studentUserId") + java.util.List findDistinctJobIdsByStudentUserId(@org.springframework.data.repository.query.Param("studentUserId") Long studentUserId); + /** * 同岗位竞争排名：判断学生是否存在某岗位的「有效投递」（状态不在排除集合内， * 即非 WITHDRAWN/REJECTED）。与 {@link #findByJobIdAndStatusNotInOrderByCreatedAtAsc} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationService.java index cbc2d98..60cf990 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationService.java @@ -2,40 +2,34 @@ package com.mydreamjob.application; import com.fasterxml.jackson.core.type.TypeReference; import com.fasterxml.jackson.databind.ObjectMapper; -import com.mydreamjob.application.dto.ApplicationCreateRequest; -import com.mydreamjob.application.dto.ApplicationStatusRequest; import com.mydreamjob.application.dto.CandidateDetailView; import com.mydreamjob.application.dto.CandidateItemView; +import com.mydreamjob.application.dto.CandidateListResponse; import com.mydreamjob.audit.AuditService; -import com.mydreamjob.candidatescore.CandidateDimensionScore; -import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; -import com.mydreamjob.candidatescore.CandidateScoringCalculator; -import com.mydreamjob.common.api.PageResponse; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.application.dto.ApplicationCreateRequest; +import com.mydreamjob.application.dto.ApplicationStatusRequest; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobService; -import com.mydreamjob.recommend.TalentMatchScorer; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; import com.mydreamjob.notification.NotificationService; -import com.mydreamjob.privacy.PrivacySettingsService; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import com.mydreamjob.profile.StudentProfile; +import jakarta.persistence.EntityManager; +import jakarta.persistence.PersistenceContext; +import jakarta.persistence.TypedQuery; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.data.domain.Page; import org.springframework.data.domain.PageRequest; -import org.springframework.data.domain.Sort; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; -import java.time.LocalDate; import java.time.LocalDateTime; -import java.time.format.DateTimeFormatter; import java.util.ArrayList; -import java.util.Collection; import java.util.Collections; -import java.util.Comparator; import java.util.HashMap; import java.util.List; import java.util.Map; @@ -53,15 +47,16 @@ public class ApplicationService { private final AuditService auditService; private final ApplicationStatusHistoryRepository historyRepository; private final NotificationService notificationService; - private final PrivacySettingsService privacySettingsService; - private final TalentMatchScorer talentMatchScorer; - private final CandidateScoringCalculator scoringCalculator; - private final CandidateDimensionScoreRepository dimensionScoreRepository; + /** R01-D4-1：投递新增/撤回/状态变更后登记评分快照刷新。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; + + @PersistenceContext + private EntityManager em; private static final ObjectMapper objectMapper = new ObjectMapper(); private static final Set ALLOWED_STATUSES = Set.of( "SUBMITTED", "VIEWED", "INTERVIEW", "HIRED", "REJECTED", "WITHDRAWN"); - private static final Set ALLOWED_SORTS = Set.of("createdAt", "updatedAt", "match"); + private static final Set ALLOWED_SORTS = Set.of("createdAt", "updatedAt"); private static final Set ALLOWED_ORDERS = Set.of("asc", "desc"); // ── 学生端 ──────────────────────────────────────────────── @@ -91,6 +86,8 @@ public class ApplicationService { "你已成功投递岗位 #" + req.getJobId(), "APPLICATION", app.getId(), "apply-" + studentUserId + "-" + req.getJobId()); + // R01-D4-1：投递数量影响 STABILITY/ACTIVITY 聚合 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(studentUserId, java.time.LocalDateTime.now()); return app; } @@ -128,6 +125,8 @@ public class ApplicationService { "你的投递 #" + app.getId() + " 已撤回", "APPLICATION", app.getId(), "withdraw-" + studentUserId + "-" + app.getId()); + // R01-D4-1：撤回参与 WITHDRAWN/总投递比率计算 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(studentUserId, java.time.LocalDateTime.now()); return app; } @@ -221,6 +220,8 @@ public class ApplicationService { "投递状态更新", "你的投递 #" + app.getId() + " 状态变更为 " + target.name(), "APPLICATION", app.getId(), "status-" + companyId + "-" + app.getId() + "-" + target.name()); + // R01-D4-1：仅状态实际变化（含 WITHDRAWN/HIRED 等聚合口径）时登记刷新。 + scoringRefreshRequestService.requestRefresh(app.getStudentUserId(), java.time.LocalDateTime.now()); return app; } @@ -261,9 +262,9 @@ public class ApplicationService { * 排序字段通过白名单映射，禁止拼接原始请求参数 */ @Transactional(readOnly = true) - public PageResponse listCompanyCandidates(Long companyId, Long jobId, String status, - String keyword, String sort, String order, - int page, int size) { + public CandidateListResponse listCompanyCandidates(Long companyId, Long jobId, String status, + String keyword, String sort, String order, + int page, int size) { // 参数校验 if (page < 0 || size < 1 || size > 100) throw new BusinessException(ErrorCode.BAD_REQUEST); @@ -276,160 +277,71 @@ public class ApplicationService { String escapedKeyword = escapeLike(keyword); - // sort=match：内存实时算分 + 排序 + 分页（确定性规则，无法在 SQL 内计算） - if ("match".equals(sort)) { - return listCompanyCandidatesByMatch(companyId, jobId, status, escapedKeyword, page, size); - } - - // 排序：白名单字段（createdAt/updatedAt）+ 主键稳定次序，方向取决于校验后的 order - String sortField = (sort == null) ? "createdAt" : sort; - Sort.Direction direction = (order == null || "desc".equalsIgnoreCase(order)) - ? Sort.Direction.DESC : Sort.Direction.ASC; - Sort sortSpec = Sort.by(direction, sortField).and(Sort.by(direction, "id")); - - // 单次 JOIN 分页查询：可空过滤条件在 SQL 内处理，计数与分页由 Page 承担 - Page result = applicationRepository.findCompanyCandidates( - companyId, jobId, status, escapedKeyword, - PageRequest.of(page, size, sortSpec)); - - List content = result.getContent(); - // 批量取本页候选人的综合评分，供 matchScore 计算使用（首项已过滤，无 N+1） - List pageStudentIds = content.stream() - .map(row -> ((Application) row[0]).getStudentUserId()) - .distinct().collect(Collectors.toList()); - List items = content.stream() - .map(row -> buildItem(row, overallScores(pageStudentIds))) - .collect(Collectors.toList()); - fillMatchPercentile(items, companyId); - - return PageResponse.of(items, result.getTotalElements(), page, size); - } - - /** match 模式：取出本企业全量候选人 → 批量取综合分 → 内存算分排序 → 内存分页 */ - private PageResponse listCompanyCandidatesByMatch(Long companyId, Long jobId, String status, - String keyword, int page, int size) { - List rows = applicationRepository.findCompanyCandidatesForMatch(companyId, jobId, status, keyword); - List studentUserIds = rows.stream() - .map(row -> ((Application) row[0]).getStudentUserId()) - .distinct().collect(Collectors.toList()); - Map overallByStudent = overallScores(studentUserIds); - - List all = rows.stream() - .map(row -> buildItem(row, overallByStudent)) - .sorted(Comparator - .comparing(CandidateItemView::getMatchScore, Comparator.nullsLast(Comparator.reverseOrder())) - .thenComparing(CandidateItemView::getApplicationId, Comparator.reverseOrder())) - .collect(Collectors.toList()); - - int from = Math.min(page * size, all.size()); - int to = Math.min(from + size, all.size()); - List items = all.subList(from, to); - fillMatchPercentile(items, companyId); - return PageResponse.of(items, all.size(), page, size); - } - - /** 由候选人列表项原始 JOIN 行构建视图；始终补充 matchScore/matchReasons（对任意排序一致返回） */ - private CandidateItemView buildItem(Object[] row, Map overallByStudent) { - Application a = (Application) row[0]; - com.mydreamjob.job.Job j = (com.mydreamjob.job.Job) row[1]; - StudentProfile sp = (StudentProfile) row[2]; - com.mydreamjob.auth.User u = (com.mydreamjob.auth.User) row[3]; - - CandidateItemView.CandidateItemViewBuilder b = CandidateItemView.builder() - .applicationId(a.getId()) - .jobId(a.getJobId()) - .jobTitle(j.getTitle()) - .status(a.getStatus()) - .candidateName(sp != null ? sp.getRealName() : null) - .candidateSchool(sp != null ? sp.getSchool() : null) - .candidateEducation(sp != null ? sp.getEducation() : null) - .candidateGraduationYear(sp != null ? sp.getGraduationYear() : null) - .candidateAvatarUrl(u != null ? u.getAvatarUrl() : null) - .createdAt(a.getCreatedAt()) - .updatedAt(a.getUpdatedAt()); - - TalentMatchScorer.MatchResult m = matchOf(row, overallByStudent); - return b.matchScore(m.matchScore()).matchReasons(m.reasons()).build(); - } - - /** 由候选列表 JOIN 行计算岗位匹配（复用 TalentMatchScorer，供列表项/详/百分位共用） */ - private TalentMatchScorer.MatchResult matchOf(Object[] row, Map overallByStudent) { - Application a = (Application) row[0]; - Job j = (Job) row[1]; - StudentProfile sp = (StudentProfile) row[2]; - return talentMatchScorer.match(j, sp, overallByStudent.get(a.getStudentUserId())); - } - - /** - * 岗位匹配百分位（企业内部信息）：按“同岗位候选人池”以 matchScore 排位， - * 返回 appId -> 超过同岗位百分之多少的候选人（0-100 整数）。 - * 口径：round(countLower / (cohortSize - 1) * 100)；cohortSize<2 时为 null（省略）。 - * cohort = 本企业该岗位的全部投递（不受列表 status/keyword 过滤影响），保证详情与列表一致。 - */ - private Map matchPercentilesByJob(Long companyId, Collection jobIds) { - if (jobIds.isEmpty()) return Collections.emptyMap(); - // 一次取出本企业全量候选人（复用 match 全量查询），仅保留请求涉及的岗位作为 cohort - List rows = applicationRepository.findCompanyCandidatesForMatch(companyId, null, null, null); - Map> byJob = rows.stream() - .filter(r -> jobIds.contains(((Job) r[1]).getId())) - .collect(Collectors.groupingBy(r -> ((Job) r[1]).getId())); - - // 批量取 cohort 内所有学生的综合分，供 matchScore 计算（无 N+1） - List allStudents = byJob.values().stream() - .flatMap(List::stream) - .map(r -> ((Application) r[0]).getStudentUserId()) - .distinct().collect(Collectors.toList()); - Map overall = overallScores(allStudents); - - Map result = new HashMap<>(); - for (List cohort : byJob.values()) { - List scores = new ArrayList<>(); - Map scoreByApp = new HashMap<>(); - for (Object[] row : cohort) { - TalentMatchScorer.MatchResult m = matchOf(row, overall); - scores.add(m.matchScore()); - scoreByApp.put(((Application) row[0]).getId(), m.matchScore()); - } - if (scores.size() < 2) continue; // 同岗位不足 2 人 → 百分位不可计算 - for (Object[] row : cohort) { - Long appId = ((Application) row[0]).getId(); - int my = scoreByApp.get(appId); - long lower = scores.stream().filter(s -> s < my).count(); - int pct = (int) Math.round(lower * 100.0 / (scores.size() - 1)); - result.put(appId, Math.max(0, Math.min(100, pct))); - } + // 白名单映射排序字段 + String sortField = (sort == null) ? "a.createdAt" : "a." + sort; + String sortOrder = (order == null) ? "DESC" : order.toUpperCase(); + + // 构建 JPQL + String whereClause = "WHERE j.companyId = :companyId"; + if (jobId != null) whereClause += " AND a.jobId = :jobId"; + if (status != null) whereClause += " AND a.status = :status"; + if (escapedKeyword != null) { + whereClause += " AND (sp.realName LIKE CONCAT('%', :keyword, '%')" + + " OR sp.school LIKE CONCAT('%', :keyword, '%')" + + " OR sp.education LIKE CONCAT('%', :keyword, '%'))"; } - return result; - } - - /** 为列表项补充岗位匹配百分位（企业内部信息，全部排序一致返回） */ - private void fillMatchPercentile(List items, Long companyId) { - if (items.isEmpty()) return; - Set involvedJobs = items.stream() - .map(CandidateItemView::getJobId).collect(Collectors.toSet()); - Map pct = matchPercentilesByJob(companyId, involvedJobs); - items.forEach(it -> it.setMatchPercentile(pct.get(it.getApplicationId()))); - } - /** 批量计算候选人综合评分：取每个学生最新周期的快照，复用候选评分引擎公式，避免 N+1 */ - private Map overallScores(List studentUserIds) { - if (studentUserIds.isEmpty()) return Collections.emptyMap(); - String asOf = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy-MM")); - Map> byStudent = dimensionScoreRepository - .findUpToPeriod(studentUserIds, asOf).stream() - .collect(Collectors.groupingBy(CandidateDimensionScore::getStudentUserId)); - - Map result = new HashMap<>(); - for (Map.Entry> e : byStudent.entrySet()) { - String latest = e.getValue().stream() - .map(CandidateDimensionScore::getPeriod) - .max(Comparator.naturalOrder()).orElse(null); - if (latest == null) continue; - List latestSnapshots = e.getValue().stream() - .filter(s -> latest.equals(s.getPeriod())).collect(Collectors.toList()); - result.put(e.getKey(), scoringCalculator.overallScoreFromSnapshots(latestSnapshots)); - } - return result; + String selectClause = "SELECT a.id, a.jobId, j.title, a.status, " + + "sp.realName, sp.school, sp.education, sp.graduationYear, " + + "u.avatarUrl, a.createdAt, a.updatedAt"; + String fromClause = "FROM Application a " + + "JOIN Job j ON a.jobId = j.id " + + "LEFT JOIN StudentProfile sp ON a.studentUserId = sp.userId " + + "LEFT JOIN User u ON a.studentUserId = u.id"; + + String countJpql = "SELECT COUNT(a) " + fromClause + " " + whereClause; + String dataJpql = selectClause + " " + fromClause + " " + whereClause + + " ORDER BY " + sortField + " " + sortOrder + ", a.id " + sortOrder; + + // Count + TypedQuery countQuery = em.createQuery(countJpql, Long.class); + countQuery.setParameter("companyId", companyId); + if (jobId != null) countQuery.setParameter("jobId", jobId); + if (status != null) countQuery.setParameter("status", status); + if (escapedKeyword != null) countQuery.setParameter("keyword", escapedKeyword); + long total = countQuery.getSingleResult(); + + // Data + TypedQuery dataQuery = em.createQuery(dataJpql, Object[].class); + dataQuery.setParameter("companyId", companyId); + if (jobId != null) dataQuery.setParameter("jobId", jobId); + if (status != null) dataQuery.setParameter("status", status); + if (escapedKeyword != null) dataQuery.setParameter("keyword", escapedKeyword); + dataQuery.setFirstResult(page * size); + dataQuery.setMaxResults(size); + + List rows = dataQuery.getResultList(); + List items = rows.stream().map(row -> CandidateItemView.builder() + .applicationId((Long) row[0]) + .jobId((Long) row[1]) + .jobTitle((String) row[2]) + .status((String) row[3]) + .candidateName((String) row[4]) + .candidateSchool((String) row[5]) + .candidateEducation((String) row[6]) + .candidateGraduationYear(row[7] != null ? ((Number) row[7]).shortValue() : null) + .candidateAvatarUrl((String) row[8]) + .createdAt((LocalDateTime) row[9]) + .updatedAt((LocalDateTime) row[10]) + .build()).collect(Collectors.toList()); + + return CandidateListResponse.builder() + .items(items) + .total(total) + .page(page) + .size(size) + .totalPages((int) Math.ceil((double) total / size)) + .build(); } /** @@ -437,9 +349,18 @@ public class ApplicationService { */ @Transactional(readOnly = true) public CandidateDetailView getCompanyCandidateDetail(Long companyId, Long applicationId) { - // 单次 JOIN 查询：applications + jobs + student_profiles + users（见 ApplicationRepository#findCandidateDetailById） + // 单次 JOIN 查询：applications + jobs + student_profiles + users // 查询结果包含岗位 companyId，数据隔离在 Service 层比较，避免额外的 findById 二次查询 - List results = applicationRepository.findCandidateDetailById(applicationId); + TypedQuery query = em.createQuery( + "SELECT a, j, sp, u FROM Application a " + + "JOIN Job j ON a.jobId = j.id " + + "LEFT JOIN StudentProfile sp ON a.studentUserId = sp.userId " + + "LEFT JOIN User u ON a.studentUserId = u.id " + + "WHERE a.id = :applicationId", + Object[].class); + query.setParameter("applicationId", applicationId); + + List results = query.getResultList(); if (results.isEmpty()) { // 投递不存在 throw new BusinessException(ErrorCode.APPLICATION_NOT_FOUND); @@ -466,22 +387,7 @@ public class ApplicationService { } } - // 隐私判定：依学生 ResumeVisibility 决定简历要素是否对企业可见，依 contactVisible 决定是否返回联系方式。 - // studentUserId 从 JOIN 结果取（sp.userId 或 u.id）；canCompanyViewResume/canViewContact 均只读、仅作用于单条详情，不构成 N+1。 - Long studentUserId = sp != null ? sp.getUserId() : (u != null ? u.getId() : null); - boolean resumeVisible = studentUserId != null - && privacySettingsService.canCompanyViewResume(studentUserId, companyId, app.getId()); - boolean contactVisible = studentUserId != null - && privacySettingsService.canViewContact(studentUserId); - - // 岗位匹配度（企业内部信息，详情一致返回）：复用列表面板同一计算逻辑 - Long applicantStudentId = app.getStudentUserId(); - java.math.BigDecimal overall = overallScores( - applicantStudentId != null ? List.of(applicantStudentId) : Collections.emptyList()) - .get(applicantStudentId); - TalentMatchScorer.MatchResult match = talentMatchScorer.match(job, sp, overall); - - CandidateDetailView detail = CandidateDetailView.builder() + return CandidateDetailView.builder() .applicationId(app.getId()) .jobId(app.getJobId()) .jobTitle(job.getTitle()) @@ -493,25 +399,13 @@ public class ApplicationService { .updatedAt(app.getUpdatedAt()) .candidateName(sp != null ? sp.getRealName() : null) .candidateAvatarUrl(u != null ? u.getAvatarUrl() : null) - // 简历要素：不可见时置 null，配合 @JsonInclude(NON_NULL) 省略 - .candidateBio(resumeVisible && sp != null ? sp.getBio() : null) - .candidateLocation(resumeVisible && sp != null ? sp.getLocation() : null) - .candidateSchool(resumeVisible && sp != null ? sp.getSchool() : null) - .candidateEducation(resumeVisible && sp != null ? sp.getEducation() : null) - .candidateGraduationYear(resumeVisible && sp != null ? sp.getGraduationYear() : null) - .candidateSkills(resumeVisible ? skills : Collections.emptyList()) - // 联系方式：仅当学生 contactVisible=true 时返回真实值，否则省略 - .candidatePhone(contactVisible && u != null ? u.getPhone() : null) - .candidateEmail(contactVisible && u != null ? u.getEmail() : null) - // 岗位匹配度与理由：企业内部信息，详情一致返回 - .matchScore(match.matchScore()) - .matchReasons(match.reasons()) + .candidateBio(sp != null ? sp.getBio() : null) + .candidateLocation(sp != null ? sp.getLocation() : null) + .candidateSchool(sp != null ? sp.getSchool() : null) + .candidateEducation(sp != null ? sp.getEducation() : null) + .candidateGraduationYear(sp != null ? sp.getGraduationYear() : null) + .candidateSkills(skills) .build(); - - // 岗位匹配百分位（企业内部信息）：按同岗位候选人池以 matchScore 计算，与列表口径一致 - Map pct = matchPercentilesByJob(companyId, List.of(job.getId())); - detail.setMatchPercentile(pct.get(app.getId())); - return detail; } /** diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationStatusHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationStatusHistoryRepository.java index 57341dc..667cab0 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationStatusHistoryRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/ApplicationStatusHistoryRepository.java @@ -9,4 +9,7 @@ import java.util.List; public interface ApplicationStatusHistoryRepository extends JpaRepository { List findByApplicationIdOrderByCreatedAtAsc(Long applicationId); + + List findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc( + List applicationIds); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeAccessPolicy.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeAccessPolicy.java new file mode 100644 index 0000000..0f858ac --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeAccessPolicy.java @@ -0,0 +1,132 @@ +package com.mydreamjob.application; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.privacy.ResumeVisibility; +import com.mydreamjob.privacy.StudentPrivacySettings; +import com.mydreamjob.privacy.StudentPrivacySettingsRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +import java.util.Set; + +/** + * S03-B 企业简历访问授权（失败关闭）。 + * + *

授权顺序严格按设计 §4.2：当前 COMPANY 用户 → 当前 Company → Application+Job → + * Job.companyId → Student → privacy setting。归属信息全部由服务端推导， + * 不信任任何客户端传入的 companyId / studentUserId。

+ * + *

决策表（设计 §4.3）：

+ *
    + *
  • 无设置记录 / null / PRIVATE：拒绝（按 PRIVATE 处理）
    • + *
  • APPLIED_COMPANIES：岗位必须属于当前企业，且投递状态为 + * SUBMITTED/VIEWED/INTERVIEW/HIRED；WITHDRAWN/REJECTED 拒绝
    • + *
  • VERIFIED_COMPANIES：当前企业 {@code verified=true} 且拥有该投递岗位； + * 投递状态不额外限制
    • + *
+ * + *

本类修复了此前 {@code PrivacySettingsService.canCompanyViewResume} 只校验学生与状态、 + * 不校验企业归属的缺陷。

+ */ +@Component +@RequiredArgsConstructor +public class CompanyResumeAccessPolicy { + + /** + * {@code APPLIED_COMPANIES} 允许的投递状态：**严格白名单**。 + * + *

不得改为「不是拒绝状态就允许」的黑名单逻辑 —— 那会让 {@code null}、空白、 + * 未知状态或大小写变体（如 {@code "submitted"}）失败开放。状态比较区分大小写。

+ */ + static final Set APPLIED_COMPANY_VISIBLE_STATUSES = + Set.of("SUBMITTED", "VIEWED", "INTERVIEW", "HIRED"); + + private final CompanyRepository companyRepository; + private final ApplicationRepository applicationRepository; + private final JobRepository jobRepository; + private final StudentPrivacySettingsRepository privacyRepository; + + /** 授权通过后返回候选人用户 ID；这是后续读取简历的唯一依据。 */ + public record Decision(Long studentUserId) { + } + + /** + * 企业下载接口使用的授权入口：仅凭当前登录公司用户与路径中的 applicationId 完成全部判定。 + * + * @throws BusinessException 未拥有企业资料 / 跨企业 / 隐私拒绝 → {@code FORBIDDEN(2002)}； + * 投递不存在 → {@code APPLICATION_NOT_FOUND(8002)} + */ + public Decision authorizeForDownload(Long companyUserId, Long applicationId) { + if (companyUserId == null || applicationId == null) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + Company company = companyRepository.findByOwnerUserId(companyUserId).orElse(null); + if (company == null) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + Application application = applicationRepository.findById(applicationId) + .orElseThrow(() -> new BusinessException(ErrorCode.APPLICATION_NOT_FOUND)); + + if (!isVisibleToCompanyInternal(application, company.getId())) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + return new Decision(application.getStudentUserId()); + } + + /** + * 既有布尔语义的授权判定（供 {@code PrivacySettingsService} 委托）。 + * + *

调用方提供的 {@code studentUserId} 只用于一致性校验：必须与投递记录一致， + * 否则视为不可信并拒绝。

+ */ + public boolean isVisible(Long studentUserId, Long companyId, Long applicationId) { + if (studentUserId == null || companyId == null || applicationId == null) { + return false; + } + Application application = applicationRepository.findById(applicationId).orElse(null); + if (application == null || !studentUserId.equals(application.getStudentUserId())) { + return false; + } + return isVisibleToCompanyInternal(application, companyId); + } + + /** + * 核心判定：投递所属岗位必须属于该企业，再按学生隐私设置决定可见性。 + */ + private boolean isVisibleToCompanyInternal(Application application, Long companyId) { + Job job = jobRepository.findById(application.getJobId()).orElse(null); + if (job == null || !companyId.equals(job.getCompanyId())) { + // 岗位不存在或不属于当前企业：一律拒绝（含跨企业投递）。 + return false; + } + + ResumeVisibility visibility = visibilityOf(application.getStudentUserId()); + switch (visibility) { + case APPLIED_COMPANIES: + // 白名单判定（失败关闭）：null / 空白 / 未知 / 大小写变体一律拒绝。 + // 先做 null 判断，避免 Set.of(...).contains(null) 抛 NPE。 + return application.getStatus() != null + && APPLIED_COMPANY_VISIBLE_STATUSES.contains(application.getStatus()); + case VERIFIED_COMPANIES: + Company company = companyRepository.findById(companyId).orElse(null); + return company != null && Boolean.TRUE.equals(company.getVerified()); + case PRIVATE: + default: + // 无设置记录、null 或 PRIVATE：按 PRIVATE 处理。 + return false; + } + } + + private ResumeVisibility visibilityOf(Long studentUserId) { + StudentPrivacySettings settings = privacyRepository.findByStudentUserId(studentUserId).orElse(null); + if (settings == null || settings.getResumeVisibility() == null) { + return ResumeVisibility.PRIVATE; + } + return settings.getResumeVisibility(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeService.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeService.java new file mode 100644 index 0000000..b68a36d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/CompanyResumeService.java @@ -0,0 +1,72 @@ +package com.mydreamjob.application; + +import com.mydreamjob.application.dto.CompanyResumeFile; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.profile.StudentProfile; +import com.mydreamjob.profile.StudentProfileRepository; +import com.mydreamjob.profile.storage.ResumeFilenameSanitizer; +import com.mydreamjob.profile.storage.ResumeStorageService; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.Set; + +/** + * S03-B 企业读取候选人简历文件。 + * + *

本类只负责「授权已通过之后」的文件读取与响应构建： + * 授权全部由 {@link CompanyResumeAccessPolicy} 完成，**任何拒绝路径都不会走到 + * {@link ResumeStorageService#read}。

+ * + *

简历正文、存储路径、原始文件名与学生标识都不写入日志、审计或异常。

+ */ +@Slf4j +@Service +@RequiredArgsConstructor +public class CompanyResumeService { + + /** Content-Type 白名单：只能来自上传时已校验的三种简历类型。 */ + static final Set ALLOWED_CONTENT_TYPES = Set.of( + "application/pdf", + "application/msword", + "application/vnd.openxmlformats-officedocument.wordprocessingml.document"); + + static final String FALLBACK_CONTENT_TYPE = "application/octet-stream"; + + private final CompanyResumeAccessPolicy accessPolicy; + private final StudentProfileRepository profileRepository; + private final ResumeStorageService resumeStorageService; + + /** + * 读取该投递对应候选人的简历。 + * + * @throws BusinessException 授权失败（{@code FORBIDDEN} / {@code APPLICATION_NOT_FOUND}）， + * 或授权通过但学生没有简历（{@code PROFILE_NOT_FOUND}） + */ + @Transactional(readOnly = true) + public CompanyResumeFile load(Long companyUserId, Long applicationId) { + // 先授权，后读文件：拒绝路径绝不触碰存储。 + CompanyResumeAccessPolicy.Decision decision = + accessPolicy.authorizeForDownload(companyUserId, applicationId); + + StudentProfile profile = profileRepository.findByUserId(decision.studentUserId()) + .orElseThrow(() -> new BusinessException(ErrorCode.PROFILE_NOT_FOUND)); + + String storagePath = profile.getResumeUrl(); + if (storagePath == null || storagePath.isBlank()) { + throw new BusinessException(ErrorCode.PROFILE_NOT_FOUND); + } + + byte[] content = resumeStorageService.read(storagePath); + String filename = ResumeFilenameSanitizer.forDownload(profile.getResumeOriginalName(), "resume"); + String contentType = resolveContentType(profile.getResumeContentType()); + return new CompanyResumeFile(content, filename, contentType); + } + + private String resolveContentType(String stored) { + return (stored != null && ALLOWED_CONTENT_TYPES.contains(stored)) ? stored : FALLBACK_CONTENT_TYPE; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/application/dto/CompanyResumeFile.java b/mydreamjob-server/src/main/java/com/mydreamjob/application/dto/CompanyResumeFile.java new file mode 100644 index 0000000..3d984bf --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/application/dto/CompanyResumeFile.java @@ -0,0 +1,10 @@ +package com.mydreamjob.application.dto; + +/** + * S03-B 企业简历下载的内部响应载体。 + * + *

只携带渲染文件响应所必需的三个字段：文件内容、已净化的下载文件名、白名单内的 + * Content-Type。**不包含**存储路径、学生用户 ID、手机号、邮箱或简历正文文本。

+ */ +public record CompanyResumeFile(byte[] content, String filename, String contentType) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswer.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswer.java new file mode 100644 index 0000000..7eff122 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswer.java @@ -0,0 +1,43 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 单题答案（V34/V35）。 + * + *

value 使用 1-5 Likert 量表（1=完全不感兴趣 … 5=非常感兴趣）。同 (attempt, question) 唯一，重复保存走 upsert。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_answers") +@EntityListeners(AuditingEntityListener.class) +public class AssessmentAnswer { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "question_id", nullable = false) + private Long questionId; + + @Column(name = "answer_value", nullable = false) + private Integer value; + + @CreatedDate + @Column(name = "answered_at", nullable = false, updatable = false) + private LocalDateTime answeredAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswerRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswerRepository.java new file mode 100644 index 0000000..de78e4f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAnswerRepository.java @@ -0,0 +1,15 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.List; +import java.util.Optional; + +@Repository +public interface AssessmentAnswerRepository extends JpaRepository { + Optional findByAttemptIdAndQuestionId(Long attemptId, Long questionId); + List findByAttemptId(Long attemptId); + long countByAttemptId(Long attemptId); + void deleteByAttemptId(Long attemptId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttempt.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttempt.java new file mode 100644 index 0000000..4ecd8c6 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttempt.java @@ -0,0 +1,89 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 答卷主记录（V34/V35）。 + * + *

状态流转：DRAFT → IN_PROGRESS → COMPLETED。{@code samplingSeed} 用于抽题随机种子， + * 持久化但不下发前端。{@code idempotencyKey} 与 {@code studentUserId} 联合唯一实现创建幂等。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_attempts") +@EntityListeners(AuditingEntityListener.class) +public class AssessmentAttempt { + + public static final String STATUS_DRAFT = "DRAFT"; + public static final String STATUS_IN_PROGRESS = "IN_PROGRESS"; + public static final String STATUS_COMPLETED = "COMPLETED"; + public static final String STATUS_EXPIRED = "EXPIRED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "student_user_id", nullable = false) + private Long studentUserId; + + @Column(name = "definition_id", nullable = false) + private Long definitionId; + + @Column(nullable = false, length = 20) + @Builder.Default + private String status = STATUS_DRAFT; + + @Column(name = "sampling_seed") + private Long samplingSeed; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "selected_question_count", nullable = false) + private Integer selectedQuestionCount; + + @Column(name = "answered_count", nullable = false) + @Builder.Default + private Integer answeredCount = 0; + + @Column(name = "idempotency_key", length = 64) + private String idempotencyKey; + + /** 活跃答卷唯一键：DRAFT/IN_PROGRESS 非空，终态后置 NULL（数据库唯一约束保证同学生同类型仅一份活跃） */ + @Column(name = "active_key", length = 255) + private String activeKey; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + + @Column(name = "started_at") + private LocalDateTime startedAt; + + @Column(name = "submitted_at") + private LocalDateTime submittedAt; + + @Column(name = "completed_at") + private LocalDateTime completedAt; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestion.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestion.java new file mode 100644 index 0000000..d807415 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestion.java @@ -0,0 +1,43 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 本次答卷随机抽中的题目（V34/V35）。 + * + *

答卷创建时一次性写入 30 道，顺序（position）不可再变，刷新页面不重新抽题。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_attempt_questions") +@EntityListeners(AuditingEntityListener.class) +public class AssessmentAttemptQuestion { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "question_id", nullable = false) + private Long questionId; + + @Column(nullable = false) + private Integer position; + + @CreatedDate + @Column(name = "selected_at", nullable = false, updatable = false) + private LocalDateTime selectedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestionRepository.java new file mode 100644 index 0000000..d5068e1 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptQuestionRepository.java @@ -0,0 +1,12 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.List; + +@Repository +public interface AssessmentAttemptQuestionRepository extends JpaRepository { + List findByAttemptIdOrderByPositionAsc(Long attemptId); + boolean existsByAttemptIdAndQuestionId(Long attemptId, Long questionId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptRepository.java new file mode 100644 index 0000000..1b84523 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptRepository.java @@ -0,0 +1,32 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.domain.Page; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Modifying; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; +import org.springframework.stereotype.Repository; + +import java.time.LocalDateTime; +import java.util.Collection; +import java.util.Optional; + +@Repository +public interface AssessmentAttemptRepository extends JpaRepository { + + Optional findByStudentUserIdAndIdempotencyKey(Long studentUserId, String idempotencyKey); + + boolean existsByStudentUserIdAndDefinitionIdAndStatusIn( + Long studentUserId, Long definitionId, Collection statuses); + + Page findByStudentUserIdOrderByCreatedAtDesc(Long studentUserId, Pageable pageable); + + /** 幂等置为已完成：仅 DRAFT/IN_PROGRESS → COMPLETED，并释放 active_key；已终态返回 0，供并发提交防护。 */ + @Modifying + @Query("update AssessmentAttempt a set a.status = :status, a.submittedAt = :now, " + + "a.completedAt = :now, a.answeredCount = :answered, a.activeKey = null " + + "where a.id = :id and a.status in ('DRAFT','IN_PROGRESS')") + int markCompleted(@Param("id") Long id, @Param("status") String status, + @Param("now") LocalDateTime now, @Param("answered") int answered); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptService.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptService.java new file mode 100644 index 0000000..ceefda4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptService.java @@ -0,0 +1,475 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.assessment.dto.AssessmentAttemptResponse; +import com.mydreamjob.assessment.dto.AssessmentHistoryItem; +import com.mydreamjob.assessment.dto.AssessmentQuestionResponse; +import com.mydreamjob.assessment.dto.AssessmentResultResponse; +import com.mydreamjob.assessment.dto.CreateAssessmentAttemptRequest; +import com.mydreamjob.assessment.dto.SaveAssessmentAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.dao.OptimisticLockingFailureException; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Isolation; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Random; +import java.util.function.Function; +import java.util.stream.Collectors; + +/** + * 答卷业务服务（V34/V35）。 + * + *

创建答卷时按六维各随机抽 5 题、整体打乱后持久化，刷新页面不重抽；保存答案走 upsert 且受 + * 乐观锁保护（9707）；提交仅允许 30 题全答（9706）、仅 DRAFT/IN_PROGRESS（9703）、 + * 重复提交幂等返回原结果、不重复生成结果与审计。身份仅取自 JWT，仅 STUDENT 可操作。

+ */ +@Service +@RequiredArgsConstructor +public class AssessmentAttemptService { + + private static final int MAX_PAGE_SIZE = 50; + + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final AssessmentDefinitionRepository definitionRepository; + private final AssessmentQuestionRepository questionRepository; + private final AssessmentAttemptRepository attemptRepository; + private final AssessmentAttemptQuestionRepository attemptQuestionRepository; + private final AssessmentAnswerRepository answerRepository; + private final AssessmentResultRepository resultRepository; + private final AssessmentResultService resultService; + private final AssessmentResultComputer resultComputer; + private final AssessmentAttemptWriter attemptWriter; + private final UserRepository userRepository; + private final AuditService auditService; + + // ─────────────────────────── 创建答卷 ─────────────────────────── + + /** + * 创建答卷。写实现(attempt+attempt_questions)委托给 {@link AssessmentAttemptWriter}（REQUIRES_NEW 独立事务）， + * 并发唯一键冲突在该独立事务内回滚，外层 Session 不被污染。 + * + *

此处显式使用 {@code READ_COMMITTED} 隔离级别：MySQL/H2 默认行为下，事务内固定的 + * REPEATABLE READ 快照会让「外层事务」读不到刚由 {@code REQUIRES_NEW} 提交的 attempt_questions， + * 也读不到并发胜者已提交的活跃答卷，从而返回空题列表或误 500；READ_COMMITTED 使每次读都取最新已提交数据。 + */ + @Transactional(isolation = Isolation.READ_COMMITTED) + public AssessmentAttemptResponse create(Long userId, CreateAssessmentAttemptRequest req, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AssessmentDefinition def = definitionRepository.findByTypeCode(req.getTypeCode()) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND)); + // 仅 ACTIVE 类型可创建；INACTIVE 统一 404/9701 + if (!AssessmentDefinition.STATUS_ACTIVE.equals(def.getStatus())) { + throw new BusinessException(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND); + } + String idem = normalizeIdempotencyKey(req.getIdempotencyKey()); + + // 幂等重放：同学生+同键返回原答卷；同键但定义不同 → 9709 + if (idem != null) { + AssessmentAttempt existing = findByIdem(userId, idem); + if (existing != null) { + if (!def.getId().equals(existing.getDefinitionId())) { + throw new BusinessException(ErrorCode.ASSESSMENT_IDEMPOTENCY_CONFLICT); + } + return toAttemptResponse(existing); + } + } + + // 快速路径：已有活跃答卷（数据库 active_key 唯一约束才是并发下的最终兜底） + if (attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn( + userId, def.getId(), List.of(AssessmentAttempt.STATUS_DRAFT, + AssessmentAttempt.STATUS_IN_PROGRESS))) { + throw new BusinessException(ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE); + } + + long seed = new Random().nextLong(); + List active = questionRepository + .findByDefinitionIdAndActiveTrueOrderByPositionAsc(def.getId()); + List sampled = sample(active, seed, def.getAttemptQuestionCount(), def.getMinPerDimension()); + + // 写入委托给依赖 Bean：attempt + attempt_questions 在独立 REQUIRES_NEW 事务中落库。 + // 若并发触发唯一键冲突，失败发生在该独立事务内并自行回滚，外层 Session 不受污染。 + AssessmentAttempt attempt; + try { + attempt = attemptWriter.persistNew(userId, def, seed, sampled, idem, activeKeyOf(userId, def.getId())); + } catch (DataIntegrityViolationException e) { + // 幂等键唯一冲突：同学生+同键已有原 attempt → 幂等返回 + if (idem != null) { + AssessmentAttempt existing = findByIdem(userId, idem); + if (existing != null) { + if (!def.getId().equals(existing.getDefinitionId())) { + throw new BusinessException(ErrorCode.ASSESSMENT_IDEMPOTENCY_CONFLICT); + } + return toAttemptResponse(existing); + } + } + // active_key 唯一冲突：同学生同类型已有活跃答卷 → 409/9708 + if (attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn( + userId, def.getId(), List.of(AssessmentAttempt.STATUS_DRAFT, + AssessmentAttempt.STATUS_IN_PROGRESS))) { + throw new BusinessException(ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE); + } + // 其他数据库约束异常：保留真实错误，不得伪装成重复答卷 + throw e; + } + + auditService.log(userId, "ASSESSMENT_ATTEMPT_CREATED", "ASSESSMENT_ATTEMPT", attempt.getId(), + "attemptId=" + attempt.getId() + ", typeCode=" + def.getTypeCode() + + ", status=" + attempt.getStatus() + + ", questionSetVersion=" + attempt.getQuestionSetVersion() + + ", rulesVersion=" + def.getRulesVersion(), + ctx); + return toAttemptResponse(attempt); + } + + // ─────────────────────────── 答卷详情 ─────────────────────────── + + @Transactional(readOnly = true) + public AssessmentAttemptResponse get(Long userId, Long attemptId) { + userRoleGuard.requireStudent(userId); + AssessmentAttempt attempt = loadOwned(userId, attemptId); + return toAttemptResponse(attempt); + } + + // ─────────────────────────── 保存答案 ─────────────────────────── + + @Transactional + public AssessmentAttemptResponse saveAnswers(Long userId, Long attemptId, + SaveAssessmentAnswersRequest req, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AssessmentAttempt attempt = loadOwned(userId, attemptId); + if (!isMutable(attempt.getStatus())) { + throw new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE); + } + if (!attempt.getVersion().equals(req.getVersion())) { + throw new BusinessException(ErrorCode.ASSESSMENT_CONCURRENT_UPDATE); + } + + // 同一 PATCH 内同题不得重复出现（防止同题不同值静默取最后一条） + if (req.getAnswers().size() != req.getAnswers().stream() + .map(SaveAssessmentAnswersRequest.AnswerItem::getQuestionId).distinct().count()) { + throw new BusinessException(ErrorCode.ASSESSMENT_ANSWER_INVALID, + "duplicate questionId in answers"); + } + + for (SaveAssessmentAnswersRequest.AnswerItem item : req.getAnswers()) { + if (item.getValue() == null || item.getValue() < 1 || item.getValue() > 5) { + throw new BusinessException(ErrorCode.ASSESSMENT_ANSWER_INVALID, "value must be 1-5"); + } + if (!attemptQuestionRepository.existsByAttemptIdAndQuestionId(attemptId, item.getQuestionId())) { + throw new BusinessException(ErrorCode.ASSESSMENT_ANSWER_INVALID, + "question does not belong to this attempt"); + } + AssessmentAnswer answer = answerRepository + .findByAttemptIdAndQuestionId(attemptId, item.getQuestionId()) + .orElseGet(() -> AssessmentAnswer.builder() + .attemptId(attemptId) + .questionId(item.getQuestionId()) + .build()); + answer.setValue(item.getValue()); + answerRepository.save(answer); + } + answerRepository.flush(); + + int answered = (int) answerRepository.countByAttemptId(attemptId); + attempt.setAnsweredCount(answered); + if (answered > 0 && AssessmentAttempt.STATUS_DRAFT.equals(attempt.getStatus())) { + attempt.setStatus(AssessmentAttempt.STATUS_IN_PROGRESS); + } + try { + attemptRepository.saveAndFlush(attempt); + } catch (OptimisticLockingFailureException e) { + throw new BusinessException(ErrorCode.ASSESSMENT_CONCURRENT_UPDATE); + } + return toAttemptResponse(attempt); + } + + // ─────────────────────────── 提交答卷 ─────────────────────────── + + @Transactional + public AssessmentResultResponse submit(Long userId, Long attemptId, AuditContext ctx) { + userRoleGuard.requireStudent(userId); + AssessmentAttempt attempt = loadOwned(userId, attemptId); + + // 重复提交幂等：返回原结果，不重新生成、不重复审计 + if (AssessmentAttempt.STATUS_COMPLETED.equals(attempt.getStatus())) { + AssessmentResult existing = resultRepository.findByAttemptId(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE)); + return resultService.toResponse(attempt, existing); + } + if (!isMutable(attempt.getStatus())) { + throw new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE); + } + + int answered = (int) answerRepository.countByAttemptId(attemptId); + if (answered < attempt.getSelectedQuestionCount()) { + throw new BusinessException(ErrorCode.ASSESSMENT_INCOMPLETE); + } + // 每个维度各答 5 题 + if (!allSelectedAnswered(attemptId, attempt)) { + throw new BusinessException(ErrorCode.ASSESSMENT_INCOMPLETE); + } + + // 原子状态流转：仅 DRAFT/IN_PROGRESS → COMPLETED，并返回影响行数。 + // 赢得流转的线程负责生成结果+审计；失败方（行数=0）说明已由并发请求完成 → 幂等返回。 + int transitioned = attemptRepository.markCompleted( + attemptId, AssessmentAttempt.STATUS_COMPLETED, LocalDateTime.now(), answered); + if (transitioned == 0) { + AssessmentResult existing = resultRepository.findByAttemptId(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE)); + return resultService.toResponse(attempt, existing); + } + + AssessmentResultComputer.ComputedResult computed = compute(attempt); + AssessmentResult result; + try { + result = resultService.persist(attempt, computed, answered); + } catch (DataIntegrityViolationException e) { + // 极端并发：result attempt_id 唯一约束兜底，复用已有结果实现幂等 + AssessmentResult existing = resultRepository.findByAttemptId(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE)); + return resultService.toResponse(attempt, existing); + } + + AssessmentDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + auditService.log(userId, "ASSESSMENT_ATTEMPT_SUBMITTED", "ASSESSMENT_ATTEMPT", attemptId, + "attemptId=" + attemptId + ", typeCode=" + (def == null ? null : def.getTypeCode()) + + ", status=COMPLETED, answeredCount=" + answered + + ", questionSetVersion=" + attempt.getQuestionSetVersion() + + ", rulesVersion=" + (def == null ? null : def.getRulesVersion()), + ctx); + return resultService.toResponse(attempt, result); + } + + // ─────────────────────────── 我的历史 ─────────────────────────── + + @Transactional(readOnly = true) + public Page listMine(Long userId, int page, int size) { + userRoleGuard.requireStudent(userId); + if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + Page attempts = attemptRepository + .findByStudentUserIdOrderByCreatedAtDesc(userId, PageRequest.of(page, size)); + + List content = attempts.getContent(); + Map attemptById = content.stream() + .collect(Collectors.toMap(AssessmentAttempt::getId, Function.identity())); + Map resultByAttempt = resultRepository + .findByAttemptIdIn(attemptById.keySet()).stream() + .collect(Collectors.toMap(AssessmentResult::getAttemptId, Function.identity())); + Map defById = new HashMap<>(); + for (AssessmentAttempt a : content) { + if (!defById.containsKey(a.getDefinitionId())) { + defById.put(a.getDefinitionId(), + definitionRepository.findById(a.getDefinitionId()).orElse(null)); + } + } + + return attempts.map(a -> { + AssessmentResult r = resultByAttempt.get(a.getId()); + AssessmentDefinition d = defById.get(a.getDefinitionId()); + return AssessmentHistoryItem.builder() + .attemptId(a.getId()) + .typeCode(d == null ? null : d.getTypeCode()) + .status(a.getStatus()) + .answeredCount(a.getAnsweredCount()) + .completionRate(completionRate(a)) + .questionSetVersion(a.getQuestionSetVersion()) + .primaryCode(r == null ? null : r.getPrimaryCode()) + .primaryType(r == null ? null : r.getPrimaryType()) + .createdAt(a.getCreatedAt()) + .submittedAt(a.getSubmittedAt()) + .build(); + }); + } + + // ─────────────────────────── 内部工具 ─────────────────────────── + + private boolean isMutable(String status) { + return AssessmentAttempt.STATUS_DRAFT.equals(status) + || AssessmentAttempt.STATUS_IN_PROGRESS.equals(status); + } + + private AssessmentAttempt loadOwned(Long userId, Long attemptId) { + AssessmentAttempt a = attemptRepository.findById(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_NOT_FOUND)); + if (!a.getStudentUserId().equals(userId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + return a; + } + private AssessmentAttempt findByIdem(Long userId, String idem) { + if (idem == null) { + return null; + } + return attemptRepository.findByStudentUserIdAndIdempotencyKey(userId, idem).orElse(null); + } + + private String normalizeIdempotencyKey(String key) { + return key == null || key.isBlank() ? null : key.trim(); + } + + private String activeKeyOf(Long studentUserId, Long definitionId) { + return studentUserId + ":" + definitionId + ":ACTIVE"; + } + + /** + * 抽题：R/I/A/S/E/C 六维各恰好抽 perDim 道，合并后整体打乱，总数为 attemptCount。 + * + *

严格约束：任一维度 ACTIVE 题不足 perDim 时直接拒绝创建（不静默减少题目数）； + * 校验 attemptCount == 6 × perDim 且六维齐全，保证总数严格为 30。

+ */ + private List sample(List all, long seed, + int attemptCount, int perDim) { + if (attemptCount <= 0 || perDim <= 0) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "invalid attempt question count or per-dimension count"); + } + if (attemptCount != 6 * perDim) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "attemptQuestionCount must equal 6 * minPerDimension"); + } + Map> byDim = new LinkedHashMap<>(); + for (AssessmentQuestion q : all) { + byDim.computeIfAbsent(q.getDimension(), k -> new ArrayList<>()).add(q); + } + if (byDim.size() != 6) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "all six RIASEC dimensions must be present"); + } + for (String dim : List.of("R", "I", "A", "S", "E", "C")) { + int available = byDim.getOrDefault(dim, List.of()).size(); + if (available < perDim) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "insufficient active questions in dimension " + dim + + " (need " + perDim + ", have " + available + ")"); + } + } + Random random = new Random(seed); + List picked = new ArrayList<>(attemptCount); + for (String dim : List.of("R", "I", "A", "S", "E", "C")) { + List group = new ArrayList<>(byDim.get(dim)); + Collections.shuffle(group, random); + picked.addAll(group.subList(0, perDim)); // 显式每维恰 perDim，不再依赖 Math.min() + } + Collections.shuffle(picked, random); + if (picked.size() != attemptCount) { + throw new BusinessException(ErrorCode.BAD_REQUEST, + "sampled question count mismatch"); + } + return picked; + } + + private boolean allSelectedAnswered(Long attemptId, AssessmentAttempt attempt) { + List selected = attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(attemptId) + .stream().map(AssessmentAttemptQuestion::getQuestionId).toList(); + if (selected.size() < attempt.getSelectedQuestionCount()) { + return false; + } + for (Long qid : selected) { + if (answerRepository.findByAttemptIdAndQuestionId(attemptId, qid).isEmpty()) { + return false; + } + } + return true; + } + + private AssessmentResultComputer.ComputedResult compute(AssessmentAttempt attempt) { + List aqs = attemptQuestionRepository + .findByAttemptIdOrderByPositionAsc(attempt.getId()); + Map questionById = new HashMap<>(); + if (!aqs.isEmpty()) { + questionById.putAll(questionRepository.findAllById( + aqs.stream().map(AssessmentAttemptQuestion::getQuestionId).toList()) + .stream().collect(Collectors.toMap(AssessmentQuestion::getId, Function.identity()))); + } + Map answerByQuestion = answerRepository.findByAttemptId(attempt.getId()) + .stream().collect(Collectors.toMap(AssessmentAnswer::getQuestionId, Function.identity())); + + List values = new ArrayList<>(); + for (AssessmentAttemptQuestion aq : aqs) { + AssessmentQuestion q = questionById.get(aq.getQuestionId()); + AssessmentAnswer ans = answerByQuestion.get(aq.getQuestionId()); + if (q == null || ans == null) { + continue; + } + values.add(new AssessmentResultComputer.DimensionValue(q.getDimension(), ans.getValue())); + } + AssessmentDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + int perDim = def == null ? 1 : def.getMinPerDimension(); + return resultComputer.compute(values, perDim, 5); + } + + private AssessmentAttemptResponse toAttemptResponse(AssessmentAttempt attempt) { + List aqs = attemptQuestionRepository + .findByAttemptIdOrderByPositionAsc(attempt.getId()); + Map values = answerRepository.findByAttemptId(attempt.getId()) + .stream().collect(Collectors.toMap(AssessmentAnswer::getQuestionId, AssessmentAnswer::getValue)); + + Map questionById = new HashMap<>(); + if (!aqs.isEmpty()) { + questionById.putAll(questionRepository.findAllById( + aqs.stream().map(AssessmentAttemptQuestion::getQuestionId).toList()) + .stream().collect(Collectors.toMap(AssessmentQuestion::getId, Function.identity()))); + } + + int total = attempt.getSelectedQuestionCount() == null ? 30 : attempt.getSelectedQuestionCount(); + int answered = values.size(); + List items = aqs.stream().map(aq -> { + AssessmentQuestion q = questionById.get(aq.getQuestionId()); + if (q == null) { + return null; + } + return AssessmentQuestionResponse.builder() + .id(q.getId()) + .position(aq.getPosition()) + .stem(q.getStem()) + .scaleType(q.getScaleType()) + .value(values.get(q.getId())) + .build(); + }).filter(java.util.Objects::nonNull).toList(); + + return AssessmentAttemptResponse.builder() + .attemptId(attempt.getId()) + .status(attempt.getStatus()) + .totalQuestions(total) + .answeredCount(answered) + .completionRate(completionRate(total, answered)) + .questionSetVersion(attempt.getQuestionSetVersion()) + .version(attempt.getVersion()) + .questions(items) + .build(); + } + + private BigDecimal completionRate(int total, int answered) { + if (total <= 0) { + return BigDecimal.ZERO.setScale(2); + } + return BigDecimal.valueOf(answered) + .multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(total), 2, RoundingMode.HALF_UP); + } + + private BigDecimal completionRate(AssessmentAttempt a) { + int total = a.getSelectedQuestionCount() == null ? 30 : a.getSelectedQuestionCount(); + return completionRate(total, a.getAnsweredCount() == null ? 0 : a.getAnsweredCount()); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptWriter.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptWriter.java new file mode 100644 index 0000000..59b1965 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentAttemptWriter.java @@ -0,0 +1,60 @@ +package com.mydreamjob.assessment; + +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * 答卷持久化写入 Bean（V34/V35）。 + * + *

将「新建 attempt + 30 条 attempt_questions」放到独立的 {@code REQUIRES_NEW} 事务中执行： + * 当并发创建某一份 attempt 触发唯一键冲突（active_key / idempotency_key）时，冲突发生在 + * 新开的事务内、由其自身回滚，外层事务的 Hibernate Session 不会被污染的 flush 破坏， + * 从而避免 {@code Hibernate AssertionFailure} 与 HTTP 500。失败后外层可安全使用新事务查询幂等记录。

+ */ +@Component +@RequiredArgsConstructor +public class AssessmentAttemptWriter { + + private final AssessmentAttemptRepository attemptRepository; + private final AssessmentAttemptQuestionRepository attemptQuestionRepository; + + /** + * 在独立的新事务中创建答卷主记录并写入 30 道抽中题目。 + * + * @return 已持久化的答卷（含数据库生成的 id） + */ + @Transactional(propagation = Propagation.REQUIRES_NEW) + public AssessmentAttempt persistNew(Long userId, AssessmentDefinition def, long seed, + List sampled, String idempotencyKey, + String activeKey) { + AssessmentAttempt attempt = AssessmentAttempt.builder() + .studentUserId(userId) + .definitionId(def.getId()) + .status(AssessmentAttempt.STATUS_DRAFT) + .samplingSeed(seed) + .questionSetVersion(def.getQuestionSetVersion()) + .selectedQuestionCount(sampled.size()) + .answeredCount(0) + .idempotencyKey(idempotencyKey) + .activeKey(activeKey) + .startedAt(LocalDateTime.now()) + .build(); + attempt = attemptRepository.saveAndFlush(attempt); + + int position = 1; + for (AssessmentQuestion q : sampled) { + attemptQuestionRepository.save(AssessmentAttemptQuestion.builder() + .attemptId(attempt.getId()) + .questionId(q.getId()) + .position(position++) + .build()); + } + attemptQuestionRepository.flush(); + return attempt; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentCatalogService.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentCatalogService.java new file mode 100644 index 0000000..a7f90c4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentCatalogService.java @@ -0,0 +1,67 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.assessment.dto.AssessmentQuestionResponse; +import com.mydreamjob.assessment.dto.AssessmentTypeResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +/** + * 测评目录服务（V34/V35）。 + * + *

仅提供测评类型与题目查询，任何已登录用户可访问。题目响应隐藏 + * dimension、reverseScored、source、questionVersion。

+ */ +@Service +@RequiredArgsConstructor +public class AssessmentCatalogService { + + private final AssessmentDefinitionRepository definitionRepository; + private final AssessmentQuestionRepository questionRepository; + + @Transactional(readOnly = true) + public List listTypes() { + return definitionRepository.findAll().stream() + .filter(d -> AssessmentDefinition.STATUS_ACTIVE.equals(d.getStatus())) + .map(this::toTypeResponse) + .toList(); + } + + @Transactional(readOnly = true) + public List listQuestions(String typeCode) { + AssessmentDefinition def = definitionRepository.findByTypeCode(typeCode) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND)); + if (!AssessmentDefinition.STATUS_ACTIVE.equals(def.getStatus())) { + throw new BusinessException(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND); + } + return questionRepository.findByDefinitionIdAndActiveTrueOrderByPositionAsc(def.getId()) + .stream() + .map(q -> AssessmentQuestionResponse.builder() + .id(q.getId()) + .position(q.getPosition()) + .stem(q.getStem()) + .scaleType(q.getScaleType()) + .build()) + .toList(); + } + + private AssessmentTypeResponse toTypeResponse(AssessmentDefinition d) { + return AssessmentTypeResponse.builder() + .typeCode(d.getTypeCode()) + .displayName(d.getDisplayName()) + .description(d.getDescription()) + .instructions(d.getInstructions()) + .status(d.getStatus()) + .scaleType(d.getScaleType()) + .questionCount(d.getQuestionCount()) + .attemptQuestionCount(d.getAttemptQuestionCount()) + .minPerDimension(d.getMinPerDimension()) + .questionSetVersion(d.getQuestionSetVersion()) + .rulesVersion(d.getRulesVersion()) + .build(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentController.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentController.java new file mode 100644 index 0000000..931fc29 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentController.java @@ -0,0 +1,166 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.assessment.dto.AssessmentAttemptResponse; +import com.mydreamjob.assessment.dto.AssessmentHistoryItem; +import com.mydreamjob.assessment.dto.AssessmentQuestionResponse; +import com.mydreamjob.assessment.dto.AssessmentResultResponse; +import com.mydreamjob.assessment.dto.AssessmentTypeResponse; +import com.mydreamjob.assessment.dto.CreateAssessmentAttemptRequest; +import com.mydreamjob.assessment.dto.SaveAssessmentAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.api.PageResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.responses.ApiResponses; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.web.bind.annotation.*; + +import java.util.List; + +/** + * RIASEC 职业兴趣测评接口（V34/V35）。 + * + *

身份仅取自 JWT，不接受 userId 参数。类型与题目对任意已登录用户开放； + * 答卷创建/详情/保存/提交/结果/历史仅 STUDENT 且仅限本人。COMPANY/ADMIN 操作答卷返回 403。

+ */ +@Tag(name = "RIASEC 职业兴趣测评", description = "测评类型、题目、答卷、保存答案、提交与结果查询") +@RestController +@RequiredArgsConstructor +public class AssessmentController { + + private final AssessmentCatalogService catalogService; + private final AssessmentAttemptService attemptService; + private final AssessmentResultService resultService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; + + @Operation(summary = "测评类型列表", + description = "返回全部 ACTIVE 测评定义。任意已登录用户可访问；未登录 401。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录") + }) + @GetMapping("/assessments/types") + public ApiResponse> listTypes(HttpServletRequest request) { + return ApiResponse.ok(catalogService.listTypes(), requestIdAccessor.get(request)); + } + + @Operation(summary = "题目列表", + description = "返回指定测评的 ACTIVE 题目，隐藏维度/reverseScored/source/版本等内部字段。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "测评类型不存在（9701）") + }) + @GetMapping("/assessments/{type}/questions") + public ApiResponse> listQuestions( + @PathVariable String type, HttpServletRequest request) { + return ApiResponse.ok(catalogService.listQuestions(type), requestIdAccessor.get(request)); + } + + @Operation(summary = "创建答卷", + description = "照六维各抽 5 题共 30 道并持久化，刷新不重抽。幂等键重放返回原答卷；" + + "同键不同定义 409/9709；已有活跃答卷 409/9708。仅 STUDENT。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "测评类型不存在（9701）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "活跃答卷/幂等冲突（9708/9709）") + }) + @PostMapping("/assessments/attempts") + public ApiResponse createAttempt( + @Valid @RequestBody CreateAssessmentAttemptRequest req, HttpServletRequest request) { + return ApiResponse.ok(attemptService.create(currentUserAccessor.requireUserId(), req, AuditContext.from(request)), + requestIdAccessor.get(request)); + } + + @Operation(summary = "答卷详情", + description = "返回本次抽中的 30 道题（固定顺序）、已保存答案、进度与当前状态。仅本人可访问；非 STUDENT 403。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9702）") + }) + @GetMapping("/assessments/attempts/{attemptId}") + public ApiResponse getAttempt( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(attemptService.get(currentUserAccessor.requireUserId(), attemptId), requestIdAccessor.get(request)); + } + + @Operation(summary = "保存答案", + description = "单题或批量保存，重复保存 upsert；value 1-5；题目必须属于本答卷；" + + "版本冲突 409/9707；首次保存后状态置为 IN_PROGRESS。仅本人。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9702）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "非法状态/并发（9703/9707）") + }) + @PatchMapping("/assessments/attempts/{attemptId}/answers") + public ApiResponse saveAnswers( + @PathVariable Long attemptId, + @Valid @RequestBody SaveAssessmentAnswersRequest req, HttpServletRequest request) { + return ApiResponse.ok(attemptService.saveAnswers(currentUserAccessor.requireUserId(), attemptId, req, + AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @Operation(summary = "提交答卷", + description = "30 题全答且每维各 5 题后方可提交（否则 400/9706）；提交后生成结果并写审计；" + + "重复提交返回原结果，不重复生成与审计。仅本人。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9702）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "非法状态（9703）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "未完成（9706）") + }) + @PostMapping("/assessments/attempts/{attemptId}/submit") + public ApiResponse submitAttempt( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(attemptService.submit(currentUserAccessor.requireUserId(), attemptId, + AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @Operation(summary = "查看结果", + description = "答卷 COMPLETED 后返回聚合分、类型排名、探索方向。仅本人可访问。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非本人或非 STUDENT（2002）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "答卷不存在（9702）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "答卷未完成（9703）") + }) + @GetMapping("/assessments/attempts/{attemptId}/result") + public ApiResponse getResult( + @PathVariable Long attemptId, HttpServletRequest request) { + return ApiResponse.ok(resultService.get(currentUserAccessor.requireUserId(), attemptId), requestIdAccessor.get(request)); + } + + @Operation(summary = "我的测评历史", + description = "分页返回当前学生的全部答卷与结果概要。仅 STUDENT 本人可访问。") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 STUDENT（2002）") + }) + @GetMapping("/assessments/me") + public ApiResponse> listMine( + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + Page result = attemptService.listMine(currentUserAccessor.requireUserId(), page, size); + return ApiResponse.ok(PageResponse.of( + result.getContent(), + result.getTotalElements(), result.getNumber(), result.getSize()), requestIdAccessor.get(request)); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinition.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinition.java new file mode 100644 index 0000000..8a1f0fd --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinition.java @@ -0,0 +1,76 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 测评定义（V34/V35）。 + * + *

{@code questionCount} 为题库总题数（72），{@code attemptQuestionCount} 为每次答卷抽题数（30）， + * {@code minPerDimension} 为每个维度最少抽题数（5）。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_definitions") +@EntityListeners(AuditingEntityListener.class) +public class AssessmentDefinition { + + public static final String STATUS_ACTIVE = "ACTIVE"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "type_code", nullable = false, length = 40) + private String typeCode; + + @Column(name = "display_name", nullable = false, length = 100) + private String displayName; + + @Column(length = 1000) + private String description; + + @Column(columnDefinition = "TEXT") + private String instructions; + + @Column(nullable = false, length = 20) + @Builder.Default + private String status = STATUS_ACTIVE; + + @Column(name = "scale_type", nullable = false, length = 20) + private String scaleType; + + @Column(name = "question_count", nullable = false) + private Integer questionCount; + + @Column(name = "attempt_question_count", nullable = false) + private Integer attemptQuestionCount; + + @Column(name = "min_per_dimension", nullable = false) + private Integer minPerDimension; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "rules_version", nullable = false, length = 40) + private String rulesVersion; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinitionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinitionRepository.java new file mode 100644 index 0000000..bacbf42 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentDefinitionRepository.java @@ -0,0 +1,11 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.Optional; + +@Repository +public interface AssessmentDefinitionRepository extends JpaRepository { + Optional findByTypeCode(String typeCode); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestion.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestion.java new file mode 100644 index 0000000..7aaaf11 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestion.java @@ -0,0 +1,80 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 测评题目（V34/V35）。 + * + *

所有题目仅测量职业兴趣，不测量能力，无正确答案，{@code reverseScored} 恒为 false， + * 来源 {@code SELF_AUTHORED}。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_questions") +@EntityListeners(AuditingEntityListener.class) +public class AssessmentQuestion { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "question_code", nullable = false, length = 20) + private String questionCode; + + @Column(name = "definition_id", nullable = false) + private Long definitionId; + + @Column(nullable = false) + private Integer position; + + @Column(nullable = false, length = 1) + private String dimension; + + @Column(nullable = false, length = 2000) + private String stem; + + @Column(name = "scale_type", nullable = false, length = 20) + private String scaleType; + + @Column(name = "question_version", nullable = false, length = 40) + private String questionVersion; + + @Column(nullable = false, length = 40) + private String source; + + /** + * MySQL/H2 MODE=MySQL 均以 TINYINT 存储 0/1；用 {@code @JdbcTypeCode(TINYINT)} 使 + * Hibernate 在 schema 校验时按 tinyint 比对，避免默认 Boolean→BIT 与 MySQL TINYINT 的类型冲突。 + */ + @Column(name = "reverse_scored", nullable = false) + @JdbcTypeCode(SqlTypes.TINYINT) + @Builder.Default + private Boolean reverseScored = false; + + @Column(nullable = false) + @JdbcTypeCode(SqlTypes.TINYINT) + @Builder.Default + private Boolean active = true; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestionRepository.java new file mode 100644 index 0000000..a05aeb5 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentQuestionRepository.java @@ -0,0 +1,11 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.List; + +@Repository +public interface AssessmentQuestionRepository extends JpaRepository { + List findByDefinitionIdAndActiveTrueOrderByPositionAsc(Long definitionId); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResult.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResult.java new file mode 100644 index 0000000..e5b9ef1 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResult.java @@ -0,0 +1,64 @@ +package com.mydreamjob.assessment; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +/** + * 测评结果（V34/V35）。 + * + *

仅 RIASEC 六维聚合分，不存储原始答案。{@code dimensionScoresText} / {@code typeRankingText} + * 以 TEXT 保存 JSON 字符串，保持 MySQL 8 与 H2 MODE=MySQL 兼容。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "assessment_results") +public class AssessmentResult { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "attempt_id", nullable = false) + private Long attemptId; + + @Column(name = "primary_code", nullable = false, length = 3) + private String primaryCode; + + @Column(name = "primary_type", nullable = false, length = 1) + private String primaryType; + + @Column(name = "dimension_scores_text", columnDefinition = "TEXT") + private String dimensionScoresText; + + @Column(name = "type_ranking_text", columnDefinition = "TEXT") + private String typeRankingText; + + @Column(name = "answered_count", nullable = false) + private Integer answeredCount; + + @Column(name = "completion_rate", nullable = false, precision = 5, scale = 2) + private BigDecimal completionRate; + + @Column(name = "question_set_version", nullable = false, length = 40) + private String questionSetVersion; + + @Column(name = "rules_version", nullable = false, length = 40) + private String rulesVersion; + + @Column(name = "generated_at", nullable = false) + private LocalDateTime generatedAt; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultComputer.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultComputer.java new file mode 100644 index 0000000..7aa0a9f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultComputer.java @@ -0,0 +1,85 @@ +package com.mydreamjob.assessment; + +import org.springframework.stereotype.Component; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * RIASEC 计分引擎（V34/V35，rules-version riasec-scoring-v0.1）。 + * + *

每个维度 5 道题：rawScore = 5 道题之和，maxScore = 25， + * percentage = rawScore / 25 × 100（BigDecimal, HALF_UP, scale=2）。 + * 六维按 percentage 降序排序，同分按维度字母升序；前三位组成 primaryCode。

+ */ +@Component +public class AssessmentResultComputer { + + /** 六个维度的规范顺序，用于分数结果的有序输出 */ + public static final List DIMENSION_ORDER = List.of("R", "I", "A", "S", "E", "C"); + + /** 单条已答维度值 */ + public record DimensionValue(String dimension, Integer value) {} + + /** 单个维度计算结果 */ + public record DimensionScoreResult(String dimension, BigDecimal score, int answeredCount) {} + + /** 计算结果 */ + public record ComputedResult( + List dimensionScores, + List typeRanking, + String primaryCode, + String primaryType) {} + + /** + * 计算六维聚合分、排序与 primary code。 + * + * @param answers 已答的 (维度, 值) 列表 + * @param questionsPerDimension 每个维度抽题数（5） + * @param maxScorePerQuestion maxScorePerQuestion 每题最高分（5） + */ + public ComputedResult compute(List answers, + int questionsPerDimension, int maxScorePerQuestion) { + int maxScore = questionsPerDimension * maxScorePerQuestion; + + // 分维度求和 + Map rawScores = new HashMap<>(); + Map answeredCount = new HashMap<>(); + for (DimensionValue a : answers) { + if (a.dimension() == null || a.value() == null) continue; + rawScores.merge(a.dimension(), a.value(), Integer::sum); + answeredCount.merge(a.dimension(), 1, Integer::sum); + } + + // 规范顺序输出六维分数 + Map percentages = new LinkedHashMap<>(); + List scores = new ArrayList<>(6); + for (String dim : DIMENSION_ORDER) { + int raw = rawScores.getOrDefault(dim, 0); + int count = answeredCount.getOrDefault(dim, 0); + BigDecimal pct = BigDecimal.valueOf(raw) + .multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(maxScore), 2, RoundingMode.HALF_UP); + percentages.put(dim, pct); + scores.add(new DimensionScoreResult(dim, pct, count)); + } + + // 降序排序，同分按维度字母升序 + List ranking = new ArrayList<>(DIMENSION_ORDER); + ranking.sort((d1, d2) -> { + int cmp = percentages.get(d2).compareTo(percentages.get(d1)); + return cmp != 0 ? cmp : d1.compareTo(d2); + }); + + String primaryCode = ranking.size() >= 3 + ? ranking.get(0) + ranking.get(1) + ranking.get(2) : null; + String primaryType = ranking.isEmpty() ? null : ranking.get(0); + + return new ComputedResult(scores, ranking, primaryCode, primaryType); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultRepository.java new file mode 100644 index 0000000..8c9c7af --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultRepository.java @@ -0,0 +1,15 @@ +package com.mydreamjob.assessment; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.Collection; +import java.util.List; +import java.util.Optional; + +@Repository +public interface AssessmentResultRepository extends JpaRepository { + Optional findByAttemptId(Long attemptId); + boolean existsByAttemptId(Long attemptId); + List findByAttemptIdIn(Collection attemptIds); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultService.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultService.java new file mode 100644 index 0000000..847f24e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/AssessmentResultService.java @@ -0,0 +1,143 @@ +package com.mydreamjob.assessment; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.assessment.dto.AssessmentResultResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.LocalDateTime; +import java.util.List; + +/** + * 测评结果服务（V34/V35）。 + * + *

负责将计分结果持久化（dimension/ranking 以 TEXT JSON 保存）与构建对外结果响应。 + * 结果响应不返回 studentUserId、phone、email、password、原始答案及他人信息。

+ */ +@Service +@RequiredArgsConstructor +public class AssessmentResultService { + + public static final String DISCLAIMER = "本结果仅供职业兴趣探索参考，不构成心理或职业诊断。"; + + private static final TypeReference> DIM_SCORES_TYPE = new TypeReference<>() {}; + private static final TypeReference> STRING_LIST_TYPE = new TypeReference<>() {}; + + private final AssessmentResultRepository resultRepository; + private final AssessmentDefinitionRepository definitionRepository; + private final AssessmentAttemptRepository attemptRepository; + private final CareerDirectionCatalog directionCatalog; + private final ObjectMapper objectMapper; + + /** + * 持久化结果。attempt_id 在表上唯一，并发重复生成会在数据库层被拦截。 + */ + @Transactional + public AssessmentResult persist(AssessmentAttempt attempt, + AssessmentResultComputer.ComputedResult computed, + int answeredCount) { + int total = attempt.getSelectedQuestionCount() == null ? 0 : attempt.getSelectedQuestionCount(); + BigDecimal rate = total == 0 ? BigDecimal.ZERO.setScale(2) + : BigDecimal.valueOf(answeredCount) + .multiply(BigDecimal.valueOf(100)) + .divide(BigDecimal.valueOf(total), 2, RoundingMode.HALF_UP); + + AssessmentResult result = AssessmentResult.builder() + .attemptId(attempt.getId()) + .primaryCode(computed.primaryCode()) + .primaryType(computed.primaryType()) + .dimensionScoresText(toJson(computed.dimensionScores())) + .typeRankingText(toJson(computed.typeRanking())) + .answeredCount(answeredCount) + .completionRate(rate) + .questionSetVersion(attempt.getQuestionSetVersion()) + .rulesVersion(attemptRulesVersion(attempt)) + .generatedAt(LocalDateTime.now()) + .build(); + return resultRepository.saveAndFlush(result); + } + + /** + * 读取本人答卷结果。非 COMPLETED 返回 9703。 + */ + @Transactional(readOnly = true) + public AssessmentResultResponse get(Long userId, Long attemptId) { + AssessmentAttempt attempt = requireCompleted(userId, attemptId); + AssessmentResult result = resultRepository.findByAttemptId(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE)); + return toResponse(attempt, result); + } + + /** + * 仅本人且答卷已 COMPLETED 才允许读取结果。 + */ + public AssessmentAttempt requireCompleted(Long userId, Long attemptId) { + AssessmentAttempt attempt = attemptFor(userId, attemptId); + if (!AssessmentAttempt.STATUS_COMPLETED.equals(attempt.getStatus())) { + throw new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE); + } + return attempt; + } + + public AssessmentAttempt attemptFor(Long userId, Long attemptId) { + AssessmentAttempt attempt = attemptRepository.findById(attemptId) + .orElseThrow(() -> new BusinessException(ErrorCode.ASSESSMENT_ATTEMPT_NOT_FOUND)); + if (!attempt.getStudentUserId().equals(userId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + return attempt; + } + + public AssessmentResultResponse toResponse(AssessmentAttempt attempt, AssessmentResult result) { + AssessmentDefinition def = definitionRepository.findById(attempt.getDefinitionId()).orElse(null); + String typeCode = def == null ? null : def.getTypeCode(); + return AssessmentResultResponse.builder() + .attemptId(attempt.getId()) + .typeCode(typeCode) + .status(AssessmentAttempt.STATUS_COMPLETED) + .primaryCode(result.getPrimaryCode()) + .primaryType(result.getPrimaryType()) + .dimensionScores(fromJson(result.getDimensionScoresText(), DIM_SCORES_TYPE)) + .typeRanking(fromJson(result.getTypeRankingText(), STRING_LIST_TYPE)) + .answeredCount(result.getAnsweredCount()) + .completionRate(result.getCompletionRate()) + .questionSetVersion(result.getQuestionSetVersion()) + .rulesVersion(result.getRulesVersion()) + .generatedAt(result.getGeneratedAt() == null ? null : result.getGeneratedAt().toString()) + .disclaimer(DISCLAIMER) + .explorationDirections(directionCatalog.resolveDirections(result.getPrimaryCode())) + .build(); + } + + private String attemptRulesVersion(AssessmentAttempt attempt) { + return definitionRepository.findById(attempt.getDefinitionId()) + .map(AssessmentDefinition::getRulesVersion) + .orElse(null); + } + + private String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new BusinessException(ErrorCode.INTERNAL_ERROR, "failed to serialize score"); + } + } + + private T fromJson(String json, TypeReference type) { + if (json == null || json.isBlank()) { + return null; + } + try { + return objectMapper.readValue(json, type); + } catch (JsonProcessingException e) { + return null; + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/CareerDirectionCatalog.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/CareerDirectionCatalog.java new file mode 100644 index 0000000..cea4755 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/CareerDirectionCatalog.java @@ -0,0 +1,59 @@ +package com.mydreamjob.assessment; + +import org.springframework.stereotype.Component; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 职业方向探索建议（V34/V35, career-direction-v0.1）。 + * + *

仅供职业兴趣探索参考，不使用"适合职业/精准匹配/最适合职业/职业诊断结果"等表述。 + * 返回文案统一为"可能感兴趣的职业探索方向"。

+ */ +@Component +public class CareerDirectionCatalog { + + /** 已配置的三字母组合 → 探索方向（精确优先） */ + private final Map> curated = new LinkedHashMap<>(); + + /** 单维度兜底方向（未配置的三字母组合按前三个维度分别返回一条兜底） */ + private final Map dimensionDefault = new LinkedHashMap<>(); + + public CareerDirectionCatalog() { + curated.put("SIC", List.of("教育辅导", "用户运营", "客户成功", "职业咨询")); + curated.put("SEC", List.of("市场营销", "客户成功", "项目运营", "职业咨询")); + curated.put("SIE", List.of("职业咨询", "教育培训", "产品运营", "客户成功")); + curated.put("RIE", List.of("技术研发", "产品方案", "项目管理", "质量控制")); + + dimensionDefault.put("R", "工程设计/现场实施"); + dimensionDefault.put("I", "数据分析/科研支持"); + dimensionDefault.put("A", "创意设计/内容创作"); + dimensionDefault.put("S", "教育辅导/社区服务"); + dimensionDefault.put("E", "市场营销/项目管理"); + dimensionDefault.put("C", "财务行政/流程运营"); + } + + /** + * 由 primaryCode 解析探索方向。 + */ + public List resolveDirections(String primaryCode) { + if (primaryCode == null || primaryCode.isBlank()) { + return List.of(); + } + String key = primaryCode.toUpperCase(); + if (curated.containsKey(key)) { + return curated.get(key); + } + List fallback = new ArrayList<>(); + for (char c : key.toCharArray()) { + String dim = String.valueOf(c); + if (dimensionDefault.containsKey(dim)) { + fallback.add(dimensionDefault.get(dim)); + } + } + return fallback; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentAttemptResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentAttemptResponse.java new file mode 100644 index 0000000..28641db --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentAttemptResponse.java @@ -0,0 +1,26 @@ +package com.mydreamjob.assessment.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.util.List; + +/** + * 答卷响应（V34/V35）。 + * + *

包含本次抽中的 30 道题（固定顺序）及已保存答案。不含 samplingSeed、studentUserId 等内部字段。

+ */ +@Data +@Builder +public class AssessmentAttemptResponse { + + private Long attemptId; + private String status; + private Integer totalQuestions; + private Integer answeredCount; + private BigDecimal completionRate; + private String questionSetVersion; + private Long version; + private List questions; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentHistoryItem.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentHistoryItem.java new file mode 100644 index 0000000..155696c --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentHistoryItem.java @@ -0,0 +1,26 @@ +package com.mydreamjob.assessment.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +/** + * 我的测评历史项（V34/V35）。 + */ +@Data +@Builder +public class AssessmentHistoryItem { + + private Long attemptId; + private String typeCode; + private String status; + private Integer answeredCount; + private BigDecimal completionRate; + private String questionSetVersion; + private String primaryCode; + private String primaryType; + private LocalDateTime createdAt; + private LocalDateTime submittedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentQuestionResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentQuestionResponse.java new file mode 100644 index 0000000..6e7b162 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentQuestionResponse.java @@ -0,0 +1,22 @@ +package com.mydreamjob.assessment.dto; + +import lombok.Builder; +import lombok.Data; + +/** + * 题目响应（V34/V35）。 + * + *

对外隐藏 dimension、reverseScored、source、questionVersion、questionCode —— + * 不暴露任何可推导 R/I/A/S/E/C 维度的内部编码。{@code value} 仅在答卷上下文中 + * 填充当前已保存答案（1-5），题目目录列表场景为 null。

+ */ +@Data +@Builder +public class AssessmentQuestionResponse { + + private Long id; + private Integer position; + private String stem; + private String scaleType; + private Integer value; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentResultResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentResultResponse.java new file mode 100644 index 0000000..66da335 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentResultResponse.java @@ -0,0 +1,40 @@ +package com.mydreamjob.assessment.dto; + +import lombok.Builder; +import lombok.Data; + +import java.math.BigDecimal; +import java.util.List; + +/** + * 测评结果响应（V34/V35）。 + * + *

仅返回聚合分与探索建议，不暴露 studentUserId、phone、email、password、原始答案及他人信息。

+ */ +@Data +@Builder +public class AssessmentResultResponse { + + private Long attemptId; + private String typeCode; + private String status; + private String primaryCode; + private String primaryType; + private List dimensionScores; + private List typeRanking; + private Integer answeredCount; + private BigDecimal completionRate; + private String questionSetVersion; + private String rulesVersion; + private String generatedAt; + private String disclaimer; + private List explorationDirections; + + @Data + @Builder + public static class DimensionScore { + private String dimension; + private BigDecimal score; + private Integer answeredCount; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentTypeResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentTypeResponse.java new file mode 100644 index 0000000..a527f00 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/AssessmentTypeResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.assessment.dto; + +import lombok.Builder; +import lombok.Data; + +/** + * 测评类型响应（V34/V35）。 + */ +@Data +@Builder +public class AssessmentTypeResponse { + + private String typeCode; + private String displayName; + private String description; + private String instructions; + private String status; + private String scaleType; + private Integer questionCount; + private Integer attemptQuestionCount; + private Integer minPerDimension; + private String questionSetVersion; + private String rulesVersion; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/CreateAssessmentAttemptRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/CreateAssessmentAttemptRequest.java new file mode 100644 index 0000000..c150726 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/CreateAssessmentAttemptRequest.java @@ -0,0 +1,21 @@ +package com.mydreamjob.assessment.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import lombok.Builder; +import lombok.Data; + +/** + * 创建答卷请求（V34/V35）。 + */ +@Data +@Builder +public class CreateAssessmentAttemptRequest { + + @NotBlank(message = "typeCode is required") + @Size(max = 40, message = "typeCode must be at most 40 chars") + private String typeCode; + + @Size(max = 64, message = "idempotencyKey must be at most 64 chars") + private String idempotencyKey; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/SaveAssessmentAnswersRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/SaveAssessmentAnswersRequest.java new file mode 100644 index 0000000..1b69a40 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/assessment/dto/SaveAssessmentAnswersRequest.java @@ -0,0 +1,41 @@ +package com.mydreamjob.assessment.dto; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; +import lombok.Builder; +import lombok.Data; + +import java.util.List; + +/** + * 保存答案请求（V34/V35）。 + * + *

支持单题或批量；同一题重复保存执行 upsert。{@code version} 为乐观锁版本，用于并发冲突检测（9707）。

+ */ +@Data +@Builder +public class SaveAssessmentAnswersRequest { + + @NotNull(message = "version is required") + @Min(value = 0, message = "version must be >= 0") + private Long version; + + @NotEmpty(message = "answers is required") + @Valid + private List answers; + + @Data + @Builder + public static class AnswerItem { + + @NotNull(message = "questionId is required") + private Long questionId; + + @NotNull(message = "value is required") + @Min(value = 1, message = "value must be 1-5") + @jakarta.validation.constraints.Max(value = 5, message = "value must be 1-5") + private Integer value; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLog.java b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLog.java index aa0968b..8c11813 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLog.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLog.java @@ -50,7 +50,10 @@ public class AuditLog { @Column(name = "request_id", length = 32) private String requestId; - @CreatedDate + // S02：不再使用 @CreatedDate。 + // Spring Data 审计会在持久化时用“当前时间”覆盖显式设置的值，而 S02 认证入口 + // （登录/刷新/登出/重放处置/全局吊销）要求审计时间与入口单次捕获的 capturedNow 同源。 + // 所有写入方（AuditService、SecurityAuditService）本就显式设置 createdAt，移除后行为不变。 @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLogRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLogRepository.java index 8ec9d74..c2a37c8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLogRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditLogRepository.java @@ -19,4 +19,11 @@ public interface AuditLogRepository extends JpaRepository { List findByCreatedAtAfter(@Param("since") LocalDateTime since); void deleteByCreatedAtBefore(LocalDateTime before); + + // ---- V37 风险扫描：读取增量审计 + 窗口命中数（仅读取，不复制 details/ip/user_agent） ---- + @Query("SELECT a FROM AuditLog a WHERE a.id > :id ORDER BY a.id ASC") + List findByIdAfterOrderByIdAsc(@Param("id") Long id, Pageable pageable); + + long countByUserIdAndActionAndCreatedAtBetween(Long userId, String action, + LocalDateTime from, LocalDateTime to); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditService.java b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditService.java index 493e525..9424878 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/audit/AuditService.java @@ -3,6 +3,8 @@ package com.mydreamjob.audit; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; @@ -22,7 +24,8 @@ public class AuditService { public void log(Long userId, String action, String entityType, Long entityId, String details, String ipAddress, String userAgent, String requestId) { logWithContext(userId, action, entityType, entityId, details, - AuditContext.builder().requestId(requestId).ipAddress(ipAddress).userAgent(userAgent).build()); + AuditContext.builder().requestId(requestId).ipAddress(ipAddress).userAgent(userAgent).build(), + LocalDateTime.now()); } /** @@ -30,11 +33,43 @@ public class AuditService { */ public void log(Long userId, String action, String entityType, Long entityId, String details, AuditContext context) { - logWithContext(userId, action, entityType, entityId, details, context); + logWithContext(userId, action, entityType, entityId, details, context, LocalDateTime.now()); + } + + /** + * 记录一个审计事件（显式时间戳版本，S02）。 + * + *

供 S02 认证入口使用：登录、刷新、登出、重放处置与全局吊销在各自入口 + * 只捕获一次 {@code capturedNow}，审计时间必须与之同源，不得再次读时。

+ */ + public void log(Long userId, String action, String entityType, Long entityId, + String details, AuditContext context, LocalDateTime capturedAt) { + logWithContext(userId, action, entityType, entityId, details, context, capturedAt); + } + + /** + * 必须与调用方业务事务一起成功的审计写入。仅用于需要原子审计的事务， + * 不吞异常；普通历史调用继续使用 log() 的非阻断语义。 + */ + @Transactional(propagation = Propagation.MANDATORY) + public void logRequired(Long userId, String action, String entityType, Long entityId, + String details, AuditContext context, LocalDateTime capturedAt) { + AuditLog auditLog = AuditLog.builder() + .userId(userId) + .action(action) + .entityType(entityType) + .entityId(entityId) + .details(sanitize(details)) + .ipAddress(context != null ? context.getIpAddress() : null) + .userAgent(context != null ? context.getUserAgent() : null) + .requestId(context != null ? context.getRequestId() : null) + .createdAt(capturedAt) + .build(); + auditLogRepository.saveAndFlush(auditLog); } private void logWithContext(Long userId, String action, String entityType, Long entityId, - String details, AuditContext ctx) { + String details, AuditContext ctx, LocalDateTime createdAt) { try { // 脱敏：details 中不得包含 code/password/token/secret 等关键词的值 String safeDetails = sanitize(details); @@ -47,7 +82,7 @@ public class AuditService { .ipAddress(ctx != null ? ctx.getIpAddress() : null) .userAgent(ctx != null ? ctx.getUserAgent() : null) .requestId(ctx != null ? ctx.getRequestId() : null) - .createdAt(LocalDateTime.now()) + .createdAt(createdAt) .build(); auditLogRepository.save(auditLog); } catch (Exception e) { @@ -73,6 +108,32 @@ public class AuditService { log(userId, "LOGOUT", "USER", userId, "User logged out", ctx); } + /** S02：登录会话创建，使用显式 capturedNow。 */ + public void logSessionCreated(Long userId, String sessionRef, AuditContext ctx, LocalDateTime capturedAt) { + log(userId, "AUTH_SESSION_CREATED", "AUTH_SESSION", null, + "{\"sessionRef\":\"" + sessionRef + "\"}", ctx, capturedAt); + } + + /** S02：Refresh Token 轮换成功，使用显式 capturedNow。 */ + public void logTokenRefreshed(Long userId, String sessionRef, AuditContext ctx, LocalDateTime capturedAt) { + log(userId, "AUTH_TOKEN_REFRESHED", "AUTH_SESSION", null, + "{\"sessionRef\":\"" + sessionRef + "\"}", ctx, capturedAt); + } + + /** S02：会话被撤销（登出、重放处置或全局吊销）。 */ + public void logSessionRevoked(Long userId, String sessionRef, String reason, + AuditContext ctx, LocalDateTime capturedAt) { + log(userId, "AUTH_SESSION_REVOKED", "AUTH_SESSION", null, + "{\"sessionRef\":\"" + sessionRef + "\",\"reason\":\"" + reason + "\"}", ctx, capturedAt); + } + + /** S02：检测到 Refresh Token 重放。 */ + public void logRefreshReuseDetected(Long userId, String sessionRef, + AuditContext ctx, LocalDateTime capturedAt) { + log(userId, "AUTH_REFRESH_REUSE_DETECTED", "AUTH_SESSION", null, + "{\"sessionRef\":\"" + sessionRef + "\"}", ctx, capturedAt); + } + /** * 脱敏：不记录可能的敏感字段值 */ diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AccessTokenClaims.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AccessTokenClaims.java new file mode 100644 index 0000000..214cffa --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AccessTokenClaims.java @@ -0,0 +1,17 @@ +package com.mydreamjob.auth; + +import java.time.Instant; + +/** + * 已通过完整校验的 Access Token 声明（S02）。 + * + *

强类型只读视图：调用方不再接触 JJWT 的 Claims 对象，也不依赖 claim 名。

+ */ +public record AccessTokenClaims( + Long userId, + String sessionId, + String tokenId, + String role, + Instant issuedAt, + Instant expiresAt) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapCreator.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapCreator.java new file mode 100644 index 0000000..e11e149 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapCreator.java @@ -0,0 +1,105 @@ +package com.mydreamjob.auth; + +import org.springframework.dao.DataAccessException; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; +import org.springframework.transaction.support.TransactionTemplate; + +import java.util.List; +import java.util.Optional; + +/** + * S03 定向整改：管理员账号创建的**独立事务组件**。 + * + *

为什么不用 JPA/Hibernate：并发初始化时数据库唯一约束会成为正常并发控制手段， + * 而 Hibernate 的 {@code SqlExceptionHelper} 会在业务代码捕获异常**之前**以 ERROR 级别 + * 记录整条语句与绑定值 —— 管理员手机号因此进入生产可见日志。

+ * + *

本组件改用 {@link JdbcTemplate} 的参数化语句：

+ *
    + *
  • 冲突在 JDBC 层被捕获，**不经过** Hibernate 日志体系；
    • + *
  • 原始数据库异常与 message/cause **一律丢弃**，对外只返回结果码；
    • + *
  • {@code users} 与 {@code user_roles} 在**同一事务**内提交 —— + * 角色写入失败时用户创建整体回滚；
    • + *
  • 不打印 SQL、手机号或绑定参数。
    • + *
+ */ +@Component +public class AdminBootstrapCreator { + + /** 创建结果：成功创建 / 数据库唯一约束冲突。 */ + public enum CreateResult { + CREATED, + CONFLICT + } + + /** 引导账号的最小状态视图（不含任何敏感字段输出）。 */ + public record BootstrapUser(Long id, String role, boolean active, boolean verified, + boolean passwordAbsent, List roles) { + } + + private final JdbcTemplate jdbcTemplate; + private final TransactionTemplate transactionTemplate; + + /** + * 使用**独立 REQUIRES_NEW 事务**：冲突必须只回滚本次创建，不得把调用方的外层事务 + * 标记为 rollback-only（否则调用方提交时会抛 {@code UnexpectedRollbackException}）。 + */ + public AdminBootstrapCreator(JdbcTemplate jdbcTemplate, + org.springframework.transaction.PlatformTransactionManager transactionManager) { + this.jdbcTemplate = jdbcTemplate; + this.transactionTemplate = new TransactionTemplate(transactionManager); + this.transactionTemplate.setPropagationBehavior( + org.springframework.transaction.TransactionDefinition.PROPAGATION_REQUIRES_NEW); + } + + /** + * 在同一事务内写入 {@code users} 与 {@code user_roles}。 + * + * @return {@link CreateResult#CREATED} 或 {@link CreateResult#CONFLICT}； + * 冲突时不抛出任何携带原始数据库信息的异常 + */ + public CreateResult createAdmin(String phone, String nickname) { + try { + transactionTemplate.executeWithoutResult(status -> { + jdbcTemplate.update( + "INSERT INTO users (phone, nickname, password_hash, role, is_active, is_verified, " + + "created_at, updated_at) VALUES (?, ?, NULL, 'ADMIN', 1, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + phone, nickname); + Long userId = jdbcTemplate.queryForObject( + "SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, 'ADMIN')", userId); + }); + return CreateResult.CREATED; + } catch (DataAccessException e) { + // 唯一约束冲突（并发初始化）、角色写入失败或任何 JDBC 层失败：事务已整体回滚。 + // 刻意**丢弃**原始异常：它的 message 可能包含 SQL 与绑定值（例如手机号）。 + // 调用方据此重新查询，决定是「幂等成功」还是抛出不带 cause 的固定安全异常。 + return CreateResult.CONFLICT; + } + } + + /** 按手机号读取引导所需的最小状态；只读、参数化，不经过 Hibernate。 */ + public Optional findByPhone(String phone) { + List rows = jdbcTemplate.query( + "SELECT id, role, is_active, is_verified, password_hash FROM users WHERE phone = ?", + (rs, i) -> new BootstrapUser( + rs.getLong("id"), + rs.getString("role"), + rs.getInt("is_active") == 1, + rs.getInt("is_verified") == 1, + rs.getString("password_hash") == null, + List.of()), + phone); + if (rows.isEmpty()) { + return Optional.empty(); + } + BootstrapUser base = rows.get(0); + List roles = jdbcTemplate.queryForList( + "SELECT role FROM user_roles WHERE user_id = ?", String.class, base.id()); + return Optional.of(new BootstrapUser(base.id(), base.role(), base.active(), + base.verified(), base.passwordAbsent(), roles)); + } + + /** 是否存在活动 ADMIN（不涉及手机号，可用 JPA 仓储）。 */ +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapRunner.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapRunner.java new file mode 100644 index 0000000..acf4de5 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AdminBootstrapRunner.java @@ -0,0 +1,119 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AdminBootstrapProperties; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.boot.ApplicationArguments; +import org.springframework.boot.ApplicationRunner; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import java.util.Optional; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * S03-A 一次性管理员初始化（显式开关，默认关闭）。 + * + *

仅在 {@code app.bootstrap.admin.enabled} 为字面量 {@code "true"} 时装配； + * 本类还会再校验一次字面量，确保大小写变体不会误启用。

+ * + *

规则（设计 §3.2）：

+ *
    + *
  1. 手机号必须通过既有手机号格式校验；不写日志、异常详情或审计 details；
    2. + *
  2. 已有活动 ADMIN → 无副作用跳过；
    3. + *
  3. 无活动 ADMIN 且手机号未被占用 → 创建 active=true / verified=true 的 ADMIN， + * 同时写入 {@code users.role} 与 {@code user_roles}；
    4. + *
  4. 手机号已属于任何用户（任意角色 / inactive / 角色不一致）→ 启动失败， + * 禁止提权、复活或覆盖；
    5. + *
  5. 相同配置重复启动幂等；
    6. + *
  6. 多实例并发：数据库唯一手机号约束是最后防线，冲突直接失败，不吞掉。
    7. + *
+ * + *

不签发 Token、不发送短信、不设置默认密码、不提供公网接口。

+ */ +@Slf4j +@Component +@RequiredArgsConstructor +@ConditionalOnProperty(name = "app.bootstrap.admin.enabled", havingValue = "true") +public class AdminBootstrapRunner implements ApplicationRunner { + + /** 与登录链路一致的手机号格式：11 位数字。 */ + private static final Pattern PHONE_PATTERN = Pattern.compile("[0-9]{11}"); + + /** 严格字面量：只有 "true" 才算启用。 */ + private static final String STRICTLY_ENABLED = "true"; + + /** 固定安全文案：不包含手机号、用户对象、SQL 或环境变量值。 */ + static final String ERROR_INVALID_PHONE = "admin bootstrap rejected: configured phone is invalid"; + static final String ERROR_PHONE_IN_USE = "admin bootstrap rejected: configured phone is already in use"; + + private final AdminBootstrapProperties properties; + private final UserRepository userRepository; + /** S03 整改：创建走独立的 JdbcTemplate 事务组件，避免 Hibernate 记录绑定手机号。 */ + private final AdminBootstrapCreator creator; + + @Override + public void run(ApplicationArguments args) { + // 兜底的字面量校验：即使 @ConditionalOnProperty 的匹配更宽松，也不允许非 "true" 生效。 + if (!STRICTLY_ENABLED.equals(properties.getEnabled())) { + return; + } + + String phone = properties.getPhone(); + if (phone == null || !PHONE_PATTERN.matcher(phone.trim()).matches()) { + throw new IllegalStateException(ERROR_INVALID_PHONE); + } + phone = phone.trim(); + + // 配置手机号已被任何用户占用（含 inactive、STUDENT、COMPANY、角色不一致）？ + // 必须先验证该账号，不能被“已有活动 ADMIN”短路：否则一个主角色为 ADMIN、 + // 但角色表缺失/含附加角色/仍有密码的账号会绕过严格幂等判据。 + Optional existing = creator.findByPhone(phone); + if (existing.isPresent()) { + // 方案 A：仅当现存账号正是本次初始化配置要求的合法 ADMIN 时幂等成功； + // 普通用户 / inactive / 角色不一致一律启动失败，绝不提权、复活或覆盖。 + if (isValidBootstrapAdmin(existing.get())) { + log.info("admin bootstrap skipped: a matching administrator already exists"); + return; + } + throw new IllegalStateException(ERROR_PHONE_IN_USE); + } + + // 配置手机号不存在且已有其他活动 ADMIN：无副作用跳过，绝不创建第二个管理员。 + if (userRepository.countByRoleAndActiveTrue(User.Role.ADMIN) > 0) { + log.info("admin bootstrap skipped: an active administrator already exists"); + return; + } + + AdminBootstrapCreator.CreateResult result = creator.createAdmin(phone, properties.getNickname()); + if (result == AdminBootstrapCreator.CreateResult.CONFLICT) { + // 并发初始化：另一个实例刚创建了同一手机号。按方案 A 重新判定： + // 只有现存账号完全合法才幂等成功，否则一律失败。 + if (creator.findByPhone(phone).filter(this::isValidBootstrapAdmin).isPresent()) { + log.info("admin bootstrap skipped: a matching administrator already exists"); + return; + } + throw new IllegalStateException(ERROR_PHONE_IN_USE); + } + + // 固定事件文本，不含手机号；部署方初始化后必须移除开关。 + log.info("admin bootstrap created an administrator; remove the bootstrap switch now"); + } + + /** + * 方案 A 的幂等判据：现存账号必须**恰好**是本次初始化所要求的合法管理员。 + * + *

要求角色为 ADMIN、active、verified、无默认口令、{@code user_roles} 含 ADMIN， + * 且不含 STUDENT/COMPANY 等附加角色。任一不满足即视为「手机号被占用」，启动失败。

+ */ + private boolean isValidBootstrapAdmin(AdminBootstrapCreator.BootstrapUser user) { + return User.Role.ADMIN.name().equals(user.role()) + && user.active() + && user.verified() + && user.passwordAbsent() + && user.roles().contains(User.Role.ADMIN.name()) + && !user.roles().contains(User.Role.STUDENT.name()) + && !user.roles().contains(User.Role.COMPANY.name()); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthService.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthService.java index b3a3bd1..75ca01d 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthService.java @@ -1,5 +1,6 @@ package com.mydreamjob.auth; +import com.mydreamjob.audit.AuditContext; import com.mydreamjob.audit.AuditService; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; @@ -12,25 +13,34 @@ import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.time.Clock; +import java.time.Instant; import java.util.*; /** - * Mock 认证服务 - 仅用于开发/测试环境登录原型 + * 认证服务（S02）：手机号验证码登录，并编排刷新与登出。 + * + *

登录成功后创建服务端登录会话；Access/Refresh 由各自的密钥签发， + * 数据库只保存 Refresh Token 的 HMAC 摘要。

*/ @Slf4j @Service @RequiredArgsConstructor public class AuthService { + /** 登录与刷新响应中的 expiresIn 秒数，保持既有契约不变（设计 D04）。 */ + public static final long EXPIRES_IN_SECONDS = 86400L; + private final UserRepository userRepository; - private final JwtTokenProvider jwtTokenProvider; private final SmsVerificationService smsVerificationService; private final AuditService auditService; private final AccountDeletionRepository accountDeletionRepository; private final AccountDeletionPhoneHasher accountDeletionPhoneHasher; + private final AuthSessionService authSessionService; + private final Clock clock; /** - * Mock 登录：验证短信验证码后自动创建/登录用户 + * Mock 登录：验证短信验证码后自动创建/登录用户，并建立一次登录会话。 */ @Transactional public Map mockLogin(String phone, String code, String purpose, @@ -57,34 +67,62 @@ public class AuthService { .verified(true) .build(); user = userRepository.save(user); - log.info("Auto-created user: id={}, phone={}", user.getId(), phone); + // 日志不得记录完整手机号 + log.info("Auto-created user: id={}", user.getId()); } else { user = userOpt.get(); } // 已注销（COMPLETED）用户禁止登录 - java.util.Optional deletion = accountDeletionRepository.findByUserId(user.getId()); + Optional deletion = accountDeletionRepository.findByUserId(user.getId()); if (deletion.isPresent() && deletion.get().getStatus() == DeletionStatus.COMPLETED) { throw new BusinessException(ErrorCode.ACCOUNT_DELETED); } - // 生成 token - String accessToken = jwtTokenProvider.generateAccessToken(user.getId(), user.getPhone(), Map.of("role", user.getRole().name())); - String refreshToken = jwtTokenProvider.generateRefreshToken(user.getId(), user.getPhone()); + // 认证入口只取一次时间，后续 JWT iat/exp、数据库时间与审计全部同源。 + Instant capturedNow = clock.instant(); + AuditContext ctx = AuditContext.builder() + .requestId(requestId) + .ipAddress(ipAddress) + .userAgent(userAgent) + .build(); + + // 会话记录必须与登录在同一事务内持久化；失败则整个登录失败，不返回 Token。 + AuthSessionService.SessionTokens tokens = authSessionService.createSession(user, capturedNow, ctx); - auditService.logLogin(user.getId(), ipAddress, userAgent, requestId); + auditService.log(user.getId(), "LOGIN", "USER", user.getId(), "User logged in", ctx, toLocal(capturedNow)); Map result = new HashMap<>(); result.put("userId", user.getId()); result.put("phone", user.getPhone()); result.put("nickname", user.getNickname()); result.put("role", user.getRole()); - result.put("accessToken", accessToken); - result.put("refreshToken", refreshToken); - result.put("expiresIn", 86400); + result.put("accessToken", tokens.accessToken()); + result.put("refreshToken", tokens.refreshToken()); + result.put("expiresIn", EXPIRES_IN_SECONDS); return result; } + /** + * 刷新：消费并轮换 Refresh Token。 + * + * @throws InvalidTokenException 任何失败（统一对外 401） + */ + public AuthSessionService.SessionTokens refresh(String refreshToken, + String requestId, String ipAddress, String userAgent) { + Instant capturedNow = clock.instant(); + return authSessionService.refresh(refreshToken, capturedNow, context(requestId, ipAddress, userAgent)); + } + + /** + * 登出：撤销当前会话（幂等）。 + */ + public void logout(Long userId, String sessionId, + String requestId, String ipAddress, String userAgent) { + Instant capturedNow = clock.instant(); + authSessionService.logout(userId, sessionId, capturedNow, context(requestId, ipAddress, userAgent)); + } + /** * 获取当前用户信息 */ @@ -104,4 +142,16 @@ public class AuthService { result.put("createdAt", user.getCreatedAt()); return result; } + + private AuditContext context(String requestId, String ipAddress, String userAgent) { + return AuditContext.builder() + .requestId(requestId) + .ipAddress(ipAddress) + .userAgent(userAgent) + .build(); + } + + private static java.time.LocalDateTime toLocal(Instant instant) { + return AuthSessionService.toLocal(instant); + } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthSessionService.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthSessionService.java new file mode 100644 index 0000000..0b36c25 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthSessionService.java @@ -0,0 +1,342 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import lombok.extern.slf4j.Slf4j; +import org.springframework.dao.DataAccessException; +import org.springframework.stereotype.Service; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.TransactionDefinition; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionTemplate; + +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.Objects; +import java.util.Optional; +import java.util.UUID; + +/** + * S02 登录会话服务：创建会话、校验会话、轮换与消费 Refresh Token、撤销会话。 + * + *

并发正确性完全由数据库条件更新保证（{@link AuthTokenRepository#consumeIfCurrent}）， + * 不使用任何 JVM 本地锁。

+ * + *

时间一律由调用方（认证入口）传入的 {@code capturedNow} 决定，本类不自行取时。

+ */ +@Slf4j +@Service +public class AuthSessionService { + + /** 固定业务时区（设计 D13）。 */ + public static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + + /** 撤销原因白名单（设计 D12 / 第十二节）。 */ + public static final String REASON_LOGOUT = "USER_LOGOUT"; + public static final String REASON_REPLAY = "REFRESH_REUSE_DETECTED"; + public static final String REASON_ACCOUNT_DELETED = "ACCOUNT_DELETED"; + public static final String REASON_USER_DISABLED = "USER_DISABLED"; + + private final AuthTokenRepository authTokenRepository; + private final AuthTokenHasher authTokenHasher; + private final JwtTokenProvider jwtTokenProvider; + private final UserRepository userRepository; + private final AuditService auditService; + /** 刷新尝试：消费旧 Token + 写入后继 Token 必须在同一事务内完成。 */ + private final TransactionTemplate refreshTransaction; + /** 重放撤销：必须在刷新尝试事务**结束之后**独立提交，避免与并发胜出方互相持锁。 */ + private final TransactionTemplate replayTransaction; + + public AuthSessionService(AuthTokenRepository authTokenRepository, + AuthTokenHasher authTokenHasher, + JwtTokenProvider jwtTokenProvider, + UserRepository userRepository, + AuditService auditService, + PlatformTransactionManager transactionManager) { + this.authTokenRepository = authTokenRepository; + this.authTokenHasher = authTokenHasher; + this.jwtTokenProvider = jwtTokenProvider; + this.userRepository = userRepository; + this.auditService = auditService; + this.refreshTransaction = new TransactionTemplate(transactionManager); + this.refreshTransaction.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED); + this.replayTransaction = new TransactionTemplate(transactionManager); + this.replayTransaction.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW); + } + + /** 刷新尝试的结果：成功（携带新 Token 对）或识别为重放。 */ + private sealed interface RefreshAttempt { + record Succeeded(SessionTokens tokens) implements RefreshAttempt { + } + + record Replayed(Long userId, String sessionId) implements RefreshAttempt { + } + } + + /** 一次会话签发的结果。Token 原文只在内存中短暂存在。 */ + public record SessionTokens(String accessToken, String refreshToken, String sessionId) { + } + + // ── 登录：创建会话 ─────────────────────────────────────────── + + /** + * 创建一次登录会话并签发 Access/Refresh Token。 + * + *

必须运行在调用方事务内：会话记录持久化失败时，整个登录事务失败，不得返回 Token。

+ */ + @Transactional + public SessionTokens createSession(User user, Instant capturedNow, AuditContext ctx) { + // All session issuers take the users row lock before touching auth_tokens. Password + // changes use the same order, so a committed change cannot be followed by a session + // created from credentials validated before that change. + User lockedUser = user == null ? null : userRepository.findByIdForUpdate(user.getId()).orElse(null); + // 失败关闭：不给不可用用户创建活动会话，更不返回 Token。 + // 不能先发 Token 再由过滤器拒绝 —— 那样 Token 已经流出去了。 + if (lockedUser == null || !isUsable(lockedUser)) { + throw new InvalidTokenException(); + } + String sessionId = UUID.randomUUID().toString(); + String accessJti = UUID.randomUUID().toString(); + String refreshJti = UUID.randomUUID().toString(); + + IssuedToken access = jwtTokenProvider.generateAccessToken( + lockedUser.getId(), lockedUser.getRole().name(), sessionId, accessJti, capturedNow); + IssuedToken refresh = jwtTokenProvider.generateRefreshToken( + lockedUser.getId(), sessionId, refreshJti, capturedNow); + + authTokenRepository.save(AuthToken.builder() + .userId(lockedUser.getId()) + .tokenHash(authTokenHasher.hash(refresh.token())) + .tokenType(AuthToken.TYPE_REFRESH) + .expiredAt(toLocal(refresh.expiresAt())) + .revoked(false) + .sessionId(sessionId) + .tokenJti(refreshJti) + // created_at 必须与入口捕获的 capturedNow 同源，不能由审计读取系统时间。 + .createdAt(toLocal(capturedNow)) + .build()); + + auditService.logSessionCreated(lockedUser.getId(), sessionRef(sessionId), ctx, toLocal(capturedNow)); + return new SessionTokens(access.token(), refresh.token(), sessionId); + } + + // ── 校验：Access 所属会话是否可用（失败关闭）────────────────── + + /** + * Access Token 的服务端会话校验（设计 D10）。任一条不满足即返回 {@code false}： + * 会话属于该用户、存在未消费未撤销未过期的 Refresh 记录、用户存在且 active。 + * + *

关于账号注销：这里刻意只检查 {@code active}，不单独判定注销记录的 + * COMPLETED 状态。账号注销完成时 {@code AccountDeletionCompletionWorker} 会 + * 1) 脱敏并将用户置为 inactive，2) 撤销该用户全部会话 —— 两道处理叠加后， + * 真实注销用户的旧 Token 无论走哪条路径都会失败。把 COMPLETED 的 409/9303 语义 + * 保留给 {@code DeletionGuardInterceptor}，可避免改变既有注销端点契约。

+ * + *

任何数据库/运行时异常一律**失败关闭**，不建立认证。

+ */ + public boolean isSessionActive(Long userId, String sessionId, Instant capturedNow) { + if (userId == null || sessionId == null || sessionId.isBlank()) { + return false; + } + try { + if (!isUserUsable(userId)) { + // 固定安全文本：不包含 userId、sessionId、Token 或 claim。 + log.warn("session validation rejected: user not usable"); + return false; + } + if (authTokenRepository.countActiveSessionTokens(userId, sessionId, toLocal(capturedNow)) <= 0) { + log.warn("session validation rejected: no active session"); + return false; + } + return true; + } catch (Exception e) { + // 固定安全文本：不回显异常消息、userId、sessionId 或 Token。 + log.warn("session validation failed"); + return false; + } + } + + // ── 刷新：消费并轮换 ───────────────────────────────────────── + + /** + * 刷新编排入口。**本方法不运行在事务中** —— 这一点是并发重放处置正确性的前提： + * 刷新尝试事务必须先结束（释放其持有的行锁），重放撤销才能在无竞争的事务里生效， + * 从而覆盖并发胜出方刚写入的后继 Token。 + * + * @throws InvalidTokenException 任何失败，包括重放 + */ + public SessionTokens refresh(String rawRefreshToken, Instant capturedNow, AuditContext ctx) { + // 校验与摘要不访问数据库，放在事务外，异常时仍能拿到 sessionId 用于重放撤销。 + RefreshTokenClaims claims = jwtTokenProvider.parseAndValidateRefreshToken(rawRefreshToken, capturedNow); + String hash = authTokenHasher.hash(rawRefreshToken); + + RefreshAttempt attempt; + try { + attempt = refreshTransaction.execute( + status -> executeRefreshAttempt(claims, hash, capturedNow, ctx)); + } catch (DataAccessException e) { + // 并发的另一次刷新正持有该记录的行锁。本次刷新无法完成， + // 按重放处置并撤销整个会话（失败关闭），对调用方仍是统一的 401。 + revokeReplayedSession(claims.userId(), claims.sessionId(), ctx, capturedNow); + throw new InvalidTokenException(); + } + + if (attempt instanceof RefreshAttempt.Replayed replayed) { + // 此时刷新尝试事务已经结束：胜出方要么已提交、要么已被本事务回滚释放， + // 撤销事务不会再与之互相持锁。 + revokeReplayedSession(replayed.userId(), replayed.sessionId(), ctx, capturedNow); + throw new InvalidTokenException(); + } + + return ((RefreshAttempt.Succeeded) attempt).tokens(); + } + + /** + * 一次刷新尝试：校验记录、原子消费旧 Token、写入后继 Token，全部在同一事务内。 + * + *

识别为重放时**不抛异常**，而是返回 {@link RefreshAttempt.Replayed} —— + * 否则事务回滚会连带丢失撤销所需的会话信息。

+ */ + private RefreshAttempt executeRefreshAttempt(RefreshTokenClaims claims, String hash, + Instant capturedNow, AuditContext ctx) { + // Lock order is users -> auth_tokens, matching password mutation transactions. + User user = requireUsableUserForUpdate(claims.userId()); + AuthToken record = authTokenRepository.findTopByTokenHashOrderByIdDesc(hash) + .orElseThrow(InvalidTokenException::new); + + // 声明必须与数据库记录一致，否则视为不可信。 + if (!Objects.equals(record.getUserId(), claims.userId()) + || !Objects.equals(record.getSessionId(), claims.sessionId()) + || !Objects.equals(record.getTokenJti(), claims.tokenId())) { + throw new InvalidTokenException(); + } + + int consumed = authTokenRepository.consumeIfCurrent( + record.getId(), record.getVersion(), toLocal(capturedNow), toLocal(capturedNow)); + + if (consumed != 1) { + // 已消费 / 已撤销 / 已过期：交回编排入口做重放处置。 + return new RefreshAttempt.Replayed(record.getUserId(), record.getSessionId()); + } + + String newAccessJti = UUID.randomUUID().toString(); + String newRefreshJti = UUID.randomUUID().toString(); + + IssuedToken access = jwtTokenProvider.generateAccessToken( + user.getId(), user.getRole().name(), claims.sessionId(), newAccessJti, capturedNow); + IssuedToken refresh = jwtTokenProvider.generateRefreshToken( + user.getId(), claims.sessionId(), newRefreshJti, capturedNow); + + authTokenRepository.save(AuthToken.builder() + .userId(user.getId()) + .tokenHash(authTokenHasher.hash(refresh.token())) + .tokenType(AuthToken.TYPE_REFRESH) + .expiredAt(toLocal(refresh.expiresAt())) + .revoked(false) + .sessionId(claims.sessionId()) + .tokenJti(newRefreshJti) + .parentTokenId(record.getId()) + // created_at 与入口捕获的 capturedNow 同源。 + .createdAt(toLocal(capturedNow)) + .build()); + + auditService.logTokenRefreshed(user.getId(), sessionRef(claims.sessionId()), ctx, toLocal(capturedNow)); + return new RefreshAttempt.Succeeded( + new SessionTokens(access.token(), refresh.token(), claims.sessionId())); + } + + /** + * 重放处置：在独立 REQUIRES_NEW 事务中撤销该会话全部记录并写脱敏审计， + * 随后**校验该会话已无活动 Token**（含并发胜出方的后继 Token）。 + * + *

撤销失败不做吞掉处理：先做有限次重试（无 sleep），仍失败则让异常向外传播 —— + * 宁可暴露基础设施故障，也不能留下一个可继续使用的会话。

+ */ + private void revokeReplayedSession(Long userId, String sessionId, AuditContext ctx, Instant capturedNow) { + if (sessionId == null) { + return; + } + for (int attempt = 0; attempt < MAX_REPLAY_REVOKE_ATTEMPTS; attempt++) { + replayTransaction.execute(status -> { + authTokenRepository.revokeSession(userId, sessionId, toLocal(capturedNow), REASON_REPLAY); + auditService.logRefreshReuseDetected(userId, sessionRef(sessionId), ctx, toLocal(capturedNow)); + auditService.logSessionRevoked(userId, sessionRef(sessionId), REASON_REPLAY, ctx, toLocal(capturedNow)); + return null; + }); + if (authTokenRepository.countActiveSessionTokens(userId, sessionId, toLocal(capturedNow)) <= 0) { + return; + } + // 胜出方的后继 Token 可能在本轮撤销之后才提交，重试一轮覆盖它。 + // 固定安全文本：不记录 userId、sessionId 或 Token。 + log.warn("replayed session still had active tokens; retrying revocation"); + } + throw new IllegalStateException("replayed session could not be revoked"); + } + + /** 重放撤销的重试上限（无 sleep；正常情况下第一轮即成功）。 */ + private static final int MAX_REPLAY_REVOKE_ATTEMPTS = 3; + + // ── 登出：撤销当前会话 ─────────────────────────────────────── + + /** + * 撤销当前会话（幂等）。重复登出不报错，也不影响其他设备会话。 + */ + @Transactional + public void logout(Long userId, String sessionId, Instant capturedNow, AuditContext ctx) { + if (userId == null || sessionId == null || sessionId.isBlank()) { + throw new InvalidTokenException(); + } + authTokenRepository.revokeSession(userId, sessionId, toLocal(capturedNow), REASON_LOGOUT); + auditService.logSessionRevoked(userId, sessionRef(sessionId), REASON_LOGOUT, ctx, toLocal(capturedNow)); + } + + // ── 全局吊销 ───────────────────────────────────────────────── + + /** + * 撤销该用户全部会话（账号注销完成、用户禁用等）。 + * + * @return 受影响行数 + */ + @Transactional + public int revokeAllUserSessions(Long userId, String reason, Instant capturedNow) { + if (userId == null) { + return 0; + } + return authTokenRepository.revokeAllForUser(userId, toLocal(capturedNow), reason); + } + + // ── 内部工具 ───────────────────────────────────────────────── + + private User requireUsableUser(Long userId) { + return userRepository.findById(userId) + .filter(this::isUsable) + .orElseThrow(InvalidTokenException::new); + } + + private User requireUsableUserForUpdate(Long userId) { + return userRepository.findByIdForUpdate(userId) + .filter(this::isUsable) + .orElseThrow(InvalidTokenException::new); + } + + private boolean isUserUsable(Long userId) { + Optional user = userRepository.findById(userId); + return user.isPresent() && isUsable(user.get()); + } + + private boolean isUsable(User user) { + return user.getActive() != null && user.getActive(); + } + + /** + * 审计用的会话标识：sessionId 的 HMAC 截断，不可逆且不泄露原值。 + */ + String sessionRef(String sessionId) { + return authTokenHasher.hash("sid:" + sessionId).substring(0, 16); + } + + static LocalDateTime toLocal(Instant instant) { + return LocalDateTime.ofInstant(instant, BUSINESS_ZONE); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthToken.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthToken.java index 02fe3a7..344e0f2 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthToken.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthToken.java @@ -5,13 +5,22 @@ import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; import lombok.NoArgsConstructor; -import org.springframework.data.annotation.CreatedDate; -import org.springframework.data.jpa.domain.support.AuditingEntityListener; import java.time.LocalDateTime; /** - * JWT Token 实体（用于 token 吊销和刷新） + * 登录会话中的 Refresh Token 记录（S02）。 + * + *

字段含义（S02 固定）：

+ *
    + *
  • {@code tokenHash} —— **Refresh Token 原文的 HMAC-SHA256 摘要**，绝不保存原文；
    • + *
  • {@code tokenType} —— 新记录固定 {@code REFRESH}；
    • + *
  • {@code expiredAt} —— Refresh Token 到期时间；
    • + *
  • {@code revoked} —— 兼容既有布尔语义，与 {@code revokedAt} 同步维护；
    • + *
  • {@code refreshTokenHash} —— 旧字段保留，S02 新逻辑不依赖。
    • + *
+ * + *

旧数据（{@code sessionId IS NULL}）永远不被新鉴权逻辑视为活动会话。

*/ @Data @Builder @@ -19,9 +28,11 @@ import java.time.LocalDateTime; @AllArgsConstructor @Entity @Table(name = "auth_tokens") -@EntityListeners(AuditingEntityListener.class) public class AuthToken { + /** Token 类型：S02 起 auth_tokens 只保存 Refresh 记录。 */ + public static final String TYPE_REFRESH = "REFRESH"; + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @@ -34,7 +45,7 @@ public class AuthToken { @Column(name = "token_type", nullable = false, length = 20) @Builder.Default - private String tokenType = "ACCESS"; + private String tokenType = TYPE_REFRESH; @Column(name = "expired_at", nullable = false) private LocalDateTime expiredAt; @@ -46,7 +57,32 @@ public class AuthToken { @Column(name = "refresh_token_hash", length = 255) private String refreshTokenHash; - @CreatedDate + @Column(name = "session_id", length = 36) + private String sessionId; + + @Column(name = "token_jti", length = 36) + private String tokenJti; + + @Column(name = "parent_token_id") + private Long parentTokenId; + + @Column(name = "consumed_at") + private LocalDateTime consumedAt; + + @Column(name = "revoked_at") + private LocalDateTime revokedAt; + + @Column(name = "revocation_reason", length = 40) + private String revocationReason; + + @Version + @Column(name = "version", nullable = false) + @Builder.Default + private Long version = 0L; + + // S02：不使用 @CreatedDate —— Spring Data 审计会在持久化时用“当前时间”覆盖显式值， + // 导致 created_at 与认证入口捕获的 capturedNow 不同源。生产写入路径只有 + // AuthSessionService（创建会话、轮换后继）两处，均显式设置 createdAt。 @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenHasher.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenHasher.java new file mode 100644 index 0000000..ea26933 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenHasher.java @@ -0,0 +1,71 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AppJwtProperties; +import org.springframework.stereotype.Component; + +import javax.crypto.Mac; +import javax.crypto.spec.SecretKeySpec; +import java.nio.charset.StandardCharsets; +import java.security.InvalidKeyException; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; + +/** + * Refresh Token 摘要器（S02）。 + * + *

数据库只保存 {@code HMAC-SHA256(token-hash-secret, rawToken)} 的十六进制表示， + * 不保存 Token 原文，也不使用可逆加密或无密钥的裸摘要。

+ * + *

本类**不记录**输入、输出或异常原值。比较使用常量时间比较。

+ */ +@Component +public class AuthTokenHasher { + + private static final String ALGORITHM = "HmacSHA256"; + private static final char[] HEX = "0123456789abcdef".toCharArray(); + + private final byte[] key; + + public AuthTokenHasher(AppJwtProperties properties) { + this.key = properties.getTokenHashSecret().getBytes(StandardCharsets.UTF_8); + } + + /** + * 计算摘要，返回固定 64 字符的小写十六进制字符串。 + * + * @param rawToken Token 原文；{@code null} 视为空串以保证稳定输出 + */ + public String hash(String rawToken) { + byte[] input = (rawToken == null ? "" : rawToken).getBytes(StandardCharsets.UTF_8); + try { + Mac mac = Mac.getInstance(ALGORITHM); + mac.init(new SecretKeySpec(key, ALGORITHM)); + return toHex(mac.doFinal(input)); + } catch (NoSuchAlgorithmException | InvalidKeyException e) { + // 固定安全文本：不回显输入、输出或异常原值。 + throw new IllegalStateException("token hash unavailable"); + } + } + + /** + * 常量时间比较两个摘要。任一为 {@code null} 时返回 {@code false}。 + */ + public boolean matches(String expectedHash, String actualHash) { + if (expectedHash == null || actualHash == null) { + return false; + } + return MessageDigest.isEqual( + expectedHash.getBytes(StandardCharsets.UTF_8), + actualHash.getBytes(StandardCharsets.UTF_8)); + } + + private static String toHex(byte[] bytes) { + char[] out = new char[bytes.length * 2]; + for (int i = 0; i < bytes.length; i++) { + int v = bytes[i] & 0xFF; + out[i * 2] = HEX[v >>> 4]; + out[i * 2 + 1] = HEX[v & 0x0F]; + } + return new String(out); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenRepository.java index b5e74ae..d16ef71 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/AuthTokenRepository.java @@ -1,12 +1,21 @@ package com.mydreamjob.auth; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Modifying; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; import java.time.LocalDateTime; import java.util.List; import java.util.Optional; +/** + * auth_tokens 数据访问（S02）。 + * + *

并发消费与撤销**一律通过带条件的原子 UPDATE** 完成，并严格检查受影响行数； + * 禁止以 {@code findById -> set -> save} 作为并发保证。

+ */ @Repository public interface AuthTokenRepository extends JpaRepository { @@ -17,4 +26,94 @@ public interface AuthTokenRepository extends JpaRepository { Optional findByRefreshTokenHash(String refreshTokenHash); List findByExpiredAtBefore(LocalDateTime expiredAt); + + // ── S02 会话查询 ──────────────────────────────────────────── + + /** + * 按摘要取候选 Refresh 记录（同摘要理论上唯一，取最新一条以防历史重复）。 + */ + Optional findTopByTokenHashOrderByIdDesc(String tokenHash); + + /** + * 会话是否活动：同一 user + session 下存在未消费、未撤销且未过期的 Refresh 记录。 + * + *

旧数据 {@code sessionId IS NULL} 永远不会命中。

+ */ + @Query(""" + SELECT COUNT(t) FROM AuthToken t + WHERE t.userId = :userId + AND t.sessionId = :sessionId + AND t.revoked = false + AND t.consumedAt IS NULL + AND t.expiredAt > :capturedNow + """) + long countActiveSessionTokens(@Param("userId") Long userId, + @Param("sessionId") String sessionId, + @Param("capturedNow") LocalDateTime capturedNow); + + List findByUserIdAndSessionIdOrderByIdAsc(Long userId, String sessionId); + + // ── S02 原子条件更新（返回值必须被严格检查）──────────────────── + + /** + * 原子消费一条 Refresh 记录。只有满足以下全部条件才会成功： + * id、expectedVersion、未撤销、未消费、未过期。 + * + * @return 受影响行数；0 表示并发冲突、已被消费、已被撤销或已过期 + */ + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query(""" + UPDATE AuthToken t + SET t.consumedAt = :consumedAt, + t.version = t.version + 1 + WHERE t.id = :id + AND t.version = :expectedVersion + AND t.revoked = false + AND t.consumedAt IS NULL + AND t.expiredAt > :capturedNow + """) + int consumeIfCurrent(@Param("id") Long id, + @Param("expectedVersion") Long expectedVersion, + @Param("consumedAt") LocalDateTime consumedAt, + @Param("capturedNow") LocalDateTime capturedNow); + + /** + * 撤销某用户某个会话下所有未撤销记录。 + * + * @return 受影响行数 + */ + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query(""" + UPDATE AuthToken t + SET t.revoked = true, + t.revokedAt = :revokedAt, + t.revocationReason = :reason, + t.version = t.version + 1 + WHERE t.userId = :userId + AND t.sessionId = :sessionId + AND t.revoked = false + """) + int revokeSession(@Param("userId") Long userId, + @Param("sessionId") String sessionId, + @Param("revokedAt") LocalDateTime revokedAt, + @Param("reason") String reason); + + /** + * 撤销某用户全部未撤销记录（账号注销完成、用户禁用等全局安全事件）。 + * + * @return 受影响行数 + */ + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query(""" + UPDATE AuthToken t + SET t.revoked = true, + t.revokedAt = :revokedAt, + t.revocationReason = :reason, + t.version = t.version + 1 + WHERE t.userId = :userId + AND t.revoked = false + """) + int revokeAllForUser(@Param("userId") Long userId, + @Param("revokedAt") LocalDateTime revokedAt, + @Param("reason") String reason); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/InvalidTokenException.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/InvalidTokenException.java new file mode 100644 index 0000000..492f3f5 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/InvalidTokenException.java @@ -0,0 +1,16 @@ +package com.mydreamjob.auth; + +/** + * Token 校验失败（S02）。 + * + *

异常消息固定为安全文本，**绝不包含 Token 原文、claim 原值或摘要**。 + * 对外一律表现为统一的 401，不区分“不存在”“已消费”“已撤销”或“重放”。

+ */ +public class InvalidTokenException extends RuntimeException { + + private static final long serialVersionUID = 1L; + + public InvalidTokenException() { + super("invalid token"); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/IssuedToken.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/IssuedToken.java new file mode 100644 index 0000000..80338e7 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/IssuedToken.java @@ -0,0 +1,17 @@ +package com.mydreamjob.auth; + +import java.time.Instant; + +/** + * 一次 Token 签发的结果（S02）。 + * + *

{@code token} 为原始 JWT 原文，只在内存中短暂存在；调用方不得将其写入 + * 数据库、日志、审计或错误响应。

+ */ +public record IssuedToken( + String token, + String sessionId, + String tokenId, + Instant issuedAt, + Instant expiresAt) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtAuthenticationFilter.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtAuthenticationFilter.java index a24a4e9..700b27a 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtAuthenticationFilter.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtAuthenticationFilter.java @@ -9,16 +9,28 @@ import lombok.extern.slf4j.Slf4j; import org.springframework.lang.Nullable; import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; import org.springframework.security.core.context.SecurityContextHolder; -import org.springframework.security.web.authentication.WebAuthenticationDetailsSource; import org.springframework.stereotype.Component; import org.springframework.util.StringUtils; import org.springframework.web.filter.OncePerRequestFilter; import java.io.IOException; +import java.time.Clock; +import java.time.Instant; import java.util.Collections; /** - * JWT 认证过滤器 + * S02 认证过滤器：只接受 Access Token。 + * + *

与修复前的关键差异：

+ *
    + *
  • 只调用 {@link JwtTokenProvider#parseAndValidateAccessToken}， + * Refresh Token、无 {@code type}、未知 {@code type}、错误 issuer/audience 一律拒绝；
    • + *
  • 验签之后还必须通过服务端会话校验（会话存在、未消费、未撤销、未过期， + * 且用户 active、注销未完成）；
    • + *
  • 任何失败都不建立部分认证，并清理 SecurityContext；
    • + *
  • 数据库或会话校验异常时**失败关闭**，绝不放行；
    • + *
  • 日志只用固定安全文本，不使用异常 {@code getMessage()}，不回显 Token、subject、sid、jti。
    • + *
*/ @Slf4j @Component @@ -26,26 +38,47 @@ import java.util.Collections; public class JwtAuthenticationFilter extends OncePerRequestFilter { private final JwtTokenProvider tokenProvider; + private final AuthSessionService authSessionService; + private final Clock clock; @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { String token = extractToken(request); - if (token != null && tokenProvider.validateToken(token)) { - try { - Long userId = tokenProvider.parseUserId(token); - UsernamePasswordAuthenticationToken authentication = - new UsernamePasswordAuthenticationToken(userId, null, Collections.emptyList()); - authentication.setDetails(new WebAuthenticationDetailsSource().buildDetails(request)); - SecurityContextHolder.getContext().setAuthentication(authentication); - log.debug("Authenticated user {} from JWT", userId); - } catch (Exception e) { - log.warn("JWT authentication failed for token: {}", e.getMessage()); - } + if (token != null) { + authenticate(request, token); } filterChain.doFilter(request, response); } + private void authenticate(HttpServletRequest request, String token) { + try { + Instant capturedNow = clock.instant(); + AccessTokenClaims claims = tokenProvider.parseAndValidateAccessToken(token, capturedNow); + + if (!authSessionService.isSessionActive(claims.userId(), claims.sessionId(), capturedNow)) { + SecurityContextHolder.clearContext(); + log.warn("JWT authentication rejected: session not active"); + return; + } + + // 资源权限仍以后续服务层校验为准，这里只建立“已认证用户”身份。 + // principal 保持为 userId（既有约 40 处 Long.valueOf(auth.getName()) 依赖该形态）， + // 已校验的 sessionId 通过 details 传递，供 /auth/logout 使用。 + UsernamePasswordAuthenticationToken authentication = + new UsernamePasswordAuthenticationToken(claims.userId(), null, Collections.emptyList()); + authentication.setDetails(new SessionAuthenticationDetails(request, claims.sessionId())); + SecurityContextHolder.getContext().setAuthentication(authentication); + } catch (InvalidTokenException e) { + // 固定安全文本：不区分过期/类型错误/签名错误，也不回显任何 claim 原值。 + SecurityContextHolder.clearContext(); + } catch (Exception e) { + // 会话校验或数据库异常：失败关闭。 + SecurityContextHolder.clearContext(); + log.warn("JWT authentication rejected: internal check failed"); + } + } + @Nullable private String extractToken(HttpServletRequest request) { String bearerToken = request.getHeader("Authorization"); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtTokenProvider.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtTokenProvider.java index 7da354d..d820a50 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtTokenProvider.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/JwtTokenProvider.java @@ -1,84 +1,207 @@ package com.mydreamjob.auth; -import io.jsonwebtoken.*; +import com.mydreamjob.config.AppJwtProperties; +import io.jsonwebtoken.Claims; +import io.jsonwebtoken.JwtException; +import io.jsonwebtoken.Jwts; import io.jsonwebtoken.security.Keys; import lombok.extern.slf4j.Slf4j; -import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; import javax.crypto.SecretKey; import java.nio.charset.StandardCharsets; +import java.time.Instant; import java.util.Date; -import java.util.Map; +import java.util.UUID; /** - * JWT 工具类 + * S02 Access/Refresh Token 签发与校验。 + * + *

核心变更：

+ *
    + *
  • Access 与 Refresh 使用**不同签名密钥**，交叉验签必然失败；
    • + *
  • 强制校验 {@code type}、{@code iss}、{@code aud}，不再用“验签通过即有效”判断用途；
    • + *
  • 新 Token 不再包含手机号；
    • + *
  • {@code iat}/{@code exp} 一律来自调用方传入的 {@code capturedNow}，本类不自行取时；
    • + *
  • 过期边界固定为 {@code exp <= capturedNow} 视为过期；
    • + *
  • 对外只返回强类型 record，不暴露 JJWT {@code Claims}；
    • + *
  • 异常消息固定为安全文本，不含 Token 或 claim 原值。
    • + *
+ * + *

本类**不访问数据库**。

*/ @Slf4j @Component public class JwtTokenProvider { - private final SecretKey secretKey; + private static final String CLAIM_TYPE = "type"; + private static final String CLAIM_SID = "sid"; + private static final String CLAIM_ROLE = "role"; + private static final String TYPE_ACCESS = "access"; + private static final String TYPE_REFRESH = "refresh"; + + private final SecretKey accessKey; + private final SecretKey refreshKey; private final long expirationMs; private final long refreshExpirationMs; + private final String issuer; + private final String accessAudience; + private final String refreshAudience; - public JwtTokenProvider( - @Value("${app.jwt.secret}") String secret, - @Value("${app.jwt.expiration-ms:86400000}") long expirationMs, - @Value("${app.jwt.refresh-expiration-ms:604800000}") long refreshExpirationMs) { - this.secretKey = Keys.hmacShaKeyFor(secret.getBytes(StandardCharsets.UTF_8)); - this.expirationMs = expirationMs; - this.refreshExpirationMs = refreshExpirationMs; + public JwtTokenProvider(AppJwtProperties properties) { + this.accessKey = Keys.hmacShaKeyFor(properties.getAccessSecret().getBytes(StandardCharsets.UTF_8)); + this.refreshKey = Keys.hmacShaKeyFor(properties.getRefreshSecret().getBytes(StandardCharsets.UTF_8)); + this.expirationMs = properties.getExpirationMs(); + this.refreshExpirationMs = properties.getRefreshExpirationMs(); + this.issuer = properties.getIssuer(); + this.accessAudience = properties.getAccessAudience(); + this.refreshAudience = properties.getRefreshAudience(); } - public String generateAccessToken(Long userId, String phone, Map claims) { - return generateToken(userId, phone, claims, expirationMs); - } + // ── 签发 ──────────────────────────────────────────────────── - public String generateRefreshToken(Long userId, String phone) { - return generateToken(userId, phone, Map.of("type", "refresh"), refreshExpirationMs); + public IssuedToken generateAccessToken(Long userId, String role, String sessionId, + String tokenId, Instant capturedNow) { + Instant expiresAt = capturedNow.plusMillis(expirationMs); + String token = Jwts.builder() + .subject(String.valueOf(userId)) + .id(tokenId) + .claim(CLAIM_TYPE, TYPE_ACCESS) + .claim(CLAIM_SID, sessionId) + .claim(CLAIM_ROLE, role) + .issuer(issuer) + .audience().add(accessAudience).and() + .issuedAt(Date.from(capturedNow)) + .expiration(Date.from(expiresAt)) + .signWith(accessKey) + .compact(); + return new IssuedToken(token, sessionId, tokenId, capturedNow, expiresAt); } - private String generateToken(Long userId, String phone, Map claims, long expirationMs) { - Date now = new Date(); - Date expiry = new Date(now.getTime() + expirationMs); - - return Jwts.builder() + public IssuedToken generateRefreshToken(Long userId, String sessionId, + String tokenId, Instant capturedNow) { + Instant expiresAt = capturedNow.plusMillis(refreshExpirationMs); + String token = Jwts.builder() .subject(String.valueOf(userId)) - .claim("phone", phone) - .claims(claims) - .issuedAt(now) - .expiration(expiry) - .signWith(secretKey) + .id(tokenId) + .claim(CLAIM_TYPE, TYPE_REFRESH) + .claim(CLAIM_SID, sessionId) + .issuer(issuer) + .audience().add(refreshAudience).and() + .issuedAt(Date.from(capturedNow)) + .expiration(Date.from(expiresAt)) + .signWith(refreshKey) .compact(); + return new IssuedToken(token, sessionId, tokenId, capturedNow, expiresAt); } - public Long parseUserId(String token) { - String subject = Jwts.parser() - .verifyWith(secretKey) - .build() - .parseSignedClaims(token) - .getPayload() - .getSubject(); - return Long.parseLong(subject); + // ── 校验 ──────────────────────────────────────────────────── + + /** + * 校验并解析 Access Token。任何失败（签名、类型、issuer、audience、subject、 + * sid、jti、role、过期）统一抛出 {@link InvalidTokenException}。 + */ + public AccessTokenClaims parseAndValidateAccessToken(String rawToken, Instant capturedNow) { + Claims claims = parse(rawToken, accessKey, TYPE_ACCESS, accessAudience, capturedNow); + Long userId = requirePositiveSubject(claims); + String sid = requireCanonicalUuid(claims.get(CLAIM_SID, String.class)); + String jti = requireCanonicalUuid(claims.getId()); + String role = claims.get(CLAIM_ROLE, String.class); + if (role == null || role.isBlank()) { + throw new InvalidTokenException(); + } + return new AccessTokenClaims(userId, sid, jti, role, + toInstant(claims.getIssuedAt()), toInstant(claims.getExpiration())); } - public boolean validateToken(String token) { + /** + * 校验并解析 Refresh Token。Refresh **不含** role，也不接受 role 参与判断。 + */ + public RefreshTokenClaims parseAndValidateRefreshToken(String rawToken, Instant capturedNow) { + Claims claims = parse(rawToken, refreshKey, TYPE_REFRESH, refreshAudience, capturedNow); + Long userId = requirePositiveSubject(claims); + String sid = requireCanonicalUuid(claims.get(CLAIM_SID, String.class)); + String jti = requireCanonicalUuid(claims.getId()); + return new RefreshTokenClaims(userId, sid, jti, + toInstant(claims.getIssuedAt()), toInstant(claims.getExpiration())); + } + + private Claims parse(String rawToken, SecretKey key, String expectedType, + String expectedAudience, Instant capturedNow) { + if (rawToken == null || rawToken.isBlank()) { + throw new InvalidTokenException(); + } + Claims claims; try { - Jwts.parser().verifyWith(secretKey).build().parseSignedClaims(token); - return true; - } catch (JwtException e) { - log.debug("JWT validation failed: {}", e.getMessage()); - return false; + claims = Jwts.parser() + .verifyWith(key) + // 过期判定由下面显式完成：这里把解析时钟固定在很早的时间， + // 避免依赖 jjwt 内部边界语义，从而严格执行本文档的契约。 + .clock(() -> Date.from(Instant.EPOCH)) + .require(CLAIM_TYPE, expectedType) + .requireIssuer(issuer) + .requireAudience(expectedAudience) + .build() + .parseSignedClaims(rawToken) + .getPayload(); + } catch (JwtException | IllegalArgumentException e) { + // 固定安全文本：不回显 Token、claim 原值或异常消息。 + throw new InvalidTokenException(); } + + // 时间契约（设计第七节）：iat <= capturedNow < exp。 + // + // 过期判定：exp 缺失或 exp <= capturedNow 一律拒绝。 + Date expiration = claims.getExpiration(); + if (expiration == null || !expiration.toInstant().isAfter(capturedNow)) { + throw new InvalidTokenException(); + } + + // 签发时间判定：iat 缺失或 iat > capturedNow 一律拒绝。 + // 缺 iat 的 Token 无法界定有效窗口；iat 在未来说明 Token 被伪造或时钟被绕过。 + Date issuedAt = claims.getIssuedAt(); + if (issuedAt == null || issuedAt.toInstant().isAfter(capturedNow)) { + throw new InvalidTokenException(); + } + + return claims; + } + + private Long requirePositiveSubject(Claims claims) { + String subject = claims.getSubject(); + if (subject == null || subject.isBlank()) { + throw new InvalidTokenException(); + } + long userId; + try { + userId = Long.parseLong(subject); + } catch (NumberFormatException e) { + throw new InvalidTokenException(); + } + if (userId <= 0) { + throw new InvalidTokenException(); + } + return userId; } - public boolean isTokenExpired(String token) { + private String requireCanonicalUuid(String value) { + if (value == null || value.isBlank()) { + throw new InvalidTokenException(); + } + UUID parsed; try { - return Jwts.parser().verifyWith(secretKey).build() - .parseSignedClaims(token).getPayload().getExpiration().before(new Date()); - } catch (JwtException e) { - return true; + parsed = UUID.fromString(value); + } catch (IllegalArgumentException e) { + throw new InvalidTokenException(); } + // 只接受规范小写连字符形式，避免宽松解析放行异常写法。 + if (!parsed.toString().equals(value)) { + throw new InvalidTokenException(); + } + return value; + } + + private static Instant toInstant(Date date) { + return date == null ? null : date.toInstant(); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/RefreshTokenClaims.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/RefreshTokenClaims.java new file mode 100644 index 0000000..15cff0f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/RefreshTokenClaims.java @@ -0,0 +1,16 @@ +package com.mydreamjob.auth; + +import java.time.Instant; + +/** + * 已通过完整校验的 Refresh Token 声明（S02）。 + * + *

Refresh Token 不含 role，也不含手机号。

+ */ +public record RefreshTokenClaims( + Long userId, + String sessionId, + String tokenId, + Instant issuedAt, + Instant expiresAt) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/SessionAuthenticationDetails.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SessionAuthenticationDetails.java new file mode 100644 index 0000000..7924c0e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SessionAuthenticationDetails.java @@ -0,0 +1,25 @@ +package com.mydreamjob.auth; + +import jakarta.servlet.http.HttpServletRequest; +import org.springframework.security.web.authentication.WebAuthenticationDetails; + +/** + * 携带已验证会话标识的认证详情（S02）。 + * + *

{@code sessionId} 只可能由 {@link JwtAuthenticationFilter} 在 Access Token + * 通过完整校验（签名、类型、issuer、audience、claim 与服务端会话状态）之后写入， + * 因此可作为 {@code /auth/logout} 的可信会话来源，不接受任何客户端参数。

+ */ +public class SessionAuthenticationDetails extends WebAuthenticationDetails { + + private final String sessionId; + + public SessionAuthenticationDetails(HttpServletRequest request, String sessionId) { + super(request); + this.sessionId = sessionId; + } + + public String getSessionId() { + return sessionId; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationCodeRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationCodeRepository.java index 221c039..7ab0c72 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationCodeRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationCodeRepository.java @@ -1,6 +1,7 @@ package com.mydreamjob.auth; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Modifying; import org.springframework.data.jpa.repository.Query; import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; @@ -12,6 +13,12 @@ import java.util.Optional; @Repository public interface SmsVerificationCodeRepository extends JpaRepository { + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query("UPDATE SmsVerificationCode c SET c.used = true " + + "WHERE c.id = :id AND c.used = false AND c.expiredAt > :now " + + "AND c.attempts < c.maxAttempts") + int consumeIfValid(@Param("id") Long id, @Param("now") LocalDateTime now); + List findByPhoneAndCreatedAtAfter(String phone, LocalDateTime after); /** diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationService.java index 4316d42..c2d0723 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/SmsVerificationService.java @@ -1,6 +1,7 @@ package com.mydreamjob.auth; import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.sms.SmsCodeSender; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; @@ -14,12 +15,15 @@ import java.security.SecureRandom; import java.time.LocalDateTime; import java.util.List; import java.util.Optional; +import java.util.Set; import java.util.regex.Pattern; import java.util.concurrent.TimeUnit; /** - * Mock 短信验证码服务 - * 不接入真实短信网关，验证码直接生成并存入 Redis + * 短信验证码服务。 + * + *

验证码只写入短信验证码表，并通过 {@link SmsCodeSender} 投递； + * 任何级别的日志都不得包含验证码或完整手机号。

*/ @Slf4j @Service @@ -29,6 +33,7 @@ public class SmsVerificationService { private final SmsVerificationCodeRepository codeRepository; private final RedisTemplate redisTemplate; private final AuditService auditService; + private final SmsCodeSender smsCodeSender; @Value("${app.sms.mock.code-length:6}") private int codeLength; @@ -47,9 +52,14 @@ public class SmsVerificationService { private static final SecureRandom SECURE_RANDOM = new SecureRandom(); private static final Pattern PHONE_PATTERN = Pattern.compile("[0-9]{11}"); private static final Pattern CODE_PATTERN = Pattern.compile("[0-9]{6}"); + private static final Set ALLOWED_PURPOSES = Set.of( + "login", "password-set", "password-reset", "company-register"); /** - * 发送验证码（Mock） + * 发送验证码。 + * + *

发送动作委派给 {@link SmsCodeSender}： + * {@code app.sms.mock.enabled=false} 或未配置时使用不可用实现，安全失败并回滚本次验证码落库。

*/ @Transactional public void sendCode(String phone, String purpose, @@ -59,14 +69,14 @@ public class SmsVerificationService { // 检查锁定 String lockoutKey = LOCKOUT_KEY_PREFIX + phone; if (redisTemplate.hasKey(lockoutKey)) { - log.warn("Phone {} is locked out", phone); + log.warn("SMS send rejected: phone locked out, phone={}", maskPhone(phone)); throw new BusinessException(ErrorCode.SMS_RATE_LIMITED); } // 检查频率限制（60秒内最多1次） String rateLimitKey = RATE_LIMIT_KEY_PREFIX + phone; if (redisTemplate.hasKey(rateLimitKey)) { - log.warn("Phone {} rate limited", phone); + log.warn("SMS send rejected: rate limited, phone={}", maskPhone(phone)); throw new BusinessException(ErrorCode.SMS_RATE_LIMITED); } @@ -89,14 +99,26 @@ public class SmsVerificationService { // 设置频率限制 redisTemplate.opsForValue().set(rateLimitKey, "1", 60, TimeUnit.SECONDS); - // Mock: 打印验证码到日志（不发送真实短信） - log.info("MOCK SMS CODE: phone={}, purpose={}, code={}", phone, purpose, code); + // 投递验证码：实现方保证不把验证码/完整手机号写入日志。 + // 不可用实现会在此抛出 SERVICE_UNAVAILABLE，令本次事务回滚（不产生虚假的“发送成功”）。 + smsCodeSender.sendVerificationCode(phone, purpose, code); + // 审计明细同样不得记录完整手机号 auditService.log(null, "SMS_SEND", "PHONE", null, - "Mock SMS sent to " + phone + " for " + purpose, + "SMS send accepted; phone=" + maskPhone(phone) + "; purpose=" + purpose, ipAddress, userAgent, requestId); } + /** + * 手机号脱敏：仅保留前 3 位与后 4 位，用于日志与审计明细。 + */ + private String maskPhone(String phone) { + if (phone == null || phone.length() < 7) { + return "***"; + } + return phone.substring(0, 3) + "****" + phone.substring(phone.length() - 4); + } + /** * 验证验证码 * 按手机号+用途查询最新一条未使用记录，原子性标记已使用。 @@ -141,9 +163,10 @@ public class SmsVerificationService { throw new BusinessException(ErrorCode.SMS_CODE_INVALID); } - // 原子性标记已使用并保存 - smsCode.setUsed(true); - codeRepository.save(smsCode); + // 条件更新保证同一验证码并发只能被一个事务消费；更新 0 行表示已被其他请求消费。 + if (codeRepository.consumeIfValid(smsCode.getId(), now) != 1) { + throw new BusinessException(ErrorCode.SMS_CODE_INVALID); + } return true; } @@ -170,9 +193,9 @@ public class SmsVerificationService { } private void validatePurpose(String purpose) { - if (purpose == null || purpose.isBlank()) { + if (purpose == null || !ALLOWED_PURPOSES.contains(purpose)) { throw new BusinessException(ErrorCode.BAD_REQUEST, - "purpose is required"); + "unsupported sms purpose"); } } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/User.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/User.java index 2d4b57f..023e1d8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/User.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/User.java @@ -43,6 +43,9 @@ public class User { @Column(name = "password_hash", length = 255) private String passwordHash; + @Column(name = "password_changed_at") + private LocalDateTime passwordChangedAt; + @Enumerated(EnumType.STRING) @Column(name = "role", nullable = false, length = 30) @Builder.Default diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/UserRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/UserRepository.java index e4de3b8..5525ae4 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/auth/UserRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/UserRepository.java @@ -1,13 +1,26 @@ package com.mydreamjob.auth; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Lock; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; +import jakarta.persistence.LockModeType; + import java.util.Optional; @Repository public interface UserRepository extends JpaRepository { Optional findByPhone(String phone); + + @Lock(LockModeType.PESSIMISTIC_WRITE) + @Query("select u from User u where u.phone = :phone") + Optional findByPhoneForUpdate(@Param("phone") String phone); + + @Lock(LockModeType.PESSIMISTIC_WRITE) + @Query("select u from User u where u.id = :id") + Optional findByIdForUpdate(@Param("id") Long id); Optional findByEmail(String email); boolean existsByPhone(String phone); boolean existsByEmail(String email); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationProperties.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationProperties.java new file mode 100644 index 0000000..6e7a294 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationProperties.java @@ -0,0 +1,24 @@ +package com.mydreamjob.auth.company; + +import lombok.Getter; +import lombok.Setter; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +/** Feature switch for the public company registration entry point. */ +@Getter +@Setter +@Component +@ConfigurationProperties(prefix = "app.company-registration") +public class CompanyRegistrationProperties { + private String enabled = "false"; + + /** + * Enables registration only for the exact lower-case literal "true". + * Spring's default Boolean converter also accepts values such as "yes" and + * "1", which must not enable this safety-sensitive feature switch. + */ + public boolean isEnabled() { + return "true".equals(enabled); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationRequest.java new file mode 100644 index 0000000..2e79705 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationRequest.java @@ -0,0 +1,43 @@ +package com.mydreamjob.auth.company; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Pattern; +import jakarta.validation.constraints.Size; +import lombok.Data; + +@Data +public class CompanyRegistrationRequest { + @NotBlank + @Pattern(regexp = "[0-9]{11}") + private String phone; + + @NotBlank + @Pattern(regexp = "[0-9]{6}") + private String code; + + @NotBlank + @Size(min = 12, max = 64) + private String password; + + @Valid + @NotNull + private CompanyDetails company; + + @Data + public static class CompanyDetails { + @NotBlank + @Size(max = 100) + private String name; + @Size(max = 500) + private String logoUrl; + private String description; + @Size(max = 80) + private String industry; + @Size(max = 255) + private String website; + @Size(max = 255) + private String address; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationResponse.java new file mode 100644 index 0000000..15f7d61 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationResponse.java @@ -0,0 +1,11 @@ +package com.mydreamjob.auth.company; + +public record CompanyRegistrationResponse( + Long userId, + Long companyId, + String role, + String onboardingStatus, + String accessToken, + String refreshToken, + long expiresIn) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationService.java new file mode 100644 index 0000000..245b6f4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/company/CompanyRegistrationService.java @@ -0,0 +1,104 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.AuthService; +import com.mydreamjob.auth.AuthSessionService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.deletion.AccountDeletionPhoneHasher; +import com.mydreamjob.deletion.AccountDeletionRepository; +import com.mydreamjob.auth.password.PasswordPolicy; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.dao.DataAccessException; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.util.Map; +import java.util.Set; + +@Service +@RequiredArgsConstructor +public class CompanyRegistrationService { + private static final String PURPOSE = "company-register"; + + private final CompanyRegistrationProperties properties; + private final SmsVerificationService smsVerificationService; + private final UserRepository userRepository; + private final CompanyRepository companyRepository; + private final PasswordPolicy passwordPolicy; + private final PasswordEncoder passwordEncoder; + private final AccountDeletionRepository accountDeletionRepository; + private final AccountDeletionPhoneHasher accountDeletionPhoneHasher; + private final AuthSessionService authSessionService; + private final AuditService auditService; + private final Clock clock; + + @Transactional + public CompanyRegistrationResponse register(CompanyRegistrationRequest request, AuditContext ctx) { + if (!properties.isEnabled()) { + throw new BusinessException(ErrorCode.COMPANY_REGISTRATION_DISABLED); + } + String phone = request.getPhone().trim(); + try { + smsVerificationService.verifyCode(phone, request.getCode(), PURPOSE); + String phoneHash = accountDeletionPhoneHasher.hash(phone); + if (accountDeletionRepository.findByDeletedPhoneHash(phoneHash).isPresent()) { + throw new BusinessException(ErrorCode.COMPANY_REGISTRATION_CONFLICT); + } + passwordPolicy.validateNewPassword(request.getPassword(), phone, null, passwordEncoder); + + if (userRepository.findByPhoneForUpdate(phone).isPresent()) { + throw new BusinessException(ErrorCode.COMPANY_REGISTRATION_CONFLICT); + } + + User user = User.builder() + .phone(phone) + .nickname("企业_" + phone.substring(7)) + .passwordHash(passwordEncoder.encode(passwordPolicy.normalize(request.getPassword()))) + .passwordChangedAt(LocalDateTime.ofInstant(clock.instant(), AuthSessionService.BUSINESS_ZONE)) + .role(User.Role.COMPANY) + .roles(Set.of(User.Role.COMPANY)) + .active(true) + .verified(false) + .build(); + user = userRepository.saveAndFlush(user); + + CompanyRegistrationRequest.CompanyDetails d = request.getCompany(); + Company company = Company.builder() + .ownerUserId(user.getId()) + .name(d.getName()) + .logoUrl(d.getLogoUrl()) + .description(d.getDescription()) + .industry(d.getIndustry()) + .website(d.getWebsite()) + .address(d.getAddress()) + .verified(false) + .build(); + company = companyRepository.saveAndFlush(company); + + Instant now = clock.instant(); + AuthSessionService.SessionTokens tokens = authSessionService.createSession(user, now, ctx); + auditService.logRequired(user.getId(), "COMPANY_REGISTERED", "COMPANY", company.getId(), + "{\"result\":\"SUCCESS\"}", ctx, + LocalDateTime.ofInstant(now, AuthSessionService.BUSINESS_ZONE)); + return new CompanyRegistrationResponse(user.getId(), company.getId(), User.Role.COMPANY.name(), + "UNVERIFIED", tokens.accessToken(), tokens.refreshToken(), AuthService.EXPIRES_IN_SECONDS); + } catch (DataIntegrityViolationException e) { + throw new BusinessException(ErrorCode.COMPANY_REGISTRATION_CONFLICT); + } catch (DataAccessException e) { + // 数据库、Redis 或会话持久化故障统一失败关闭，不把 SQL/连接信息返回给客户端。 + throw new BusinessException(ErrorCode.COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordChangeRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordChangeRequest.java new file mode 100644 index 0000000..572f976 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordChangeRequest.java @@ -0,0 +1,10 @@ +package com.mydreamjob.auth.dto; + +import jakarta.validation.constraints.NotBlank; +import lombok.Data; + +@Data +public class PasswordChangeRequest { + @NotBlank private String currentPassword; + @NotBlank private String newPassword; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordLoginRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordLoginRequest.java new file mode 100644 index 0000000..8e516c2 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordLoginRequest.java @@ -0,0 +1,15 @@ +package com.mydreamjob.auth.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Pattern; +import lombok.Data; + +@Data +public class PasswordLoginRequest { + @NotBlank + @Pattern(regexp = "[0-9]{11}") + private String phone; + + @NotBlank + private String password; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordOperationResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordOperationResponse.java new file mode 100644 index 0000000..5963ffa --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordOperationResponse.java @@ -0,0 +1,3 @@ +package com.mydreamjob.auth.dto; + +public record PasswordOperationResponse(boolean passwordConfigured, boolean reauthenticationRequired) {} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordResetRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordResetRequest.java new file mode 100644 index 0000000..26cc899 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordResetRequest.java @@ -0,0 +1,12 @@ +package com.mydreamjob.auth.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Pattern; +import lombok.Data; + +@Data +public class PasswordResetRequest { + @NotBlank @Pattern(regexp = "[0-9]{11}") private String phone; + @NotBlank private String smsCode; + @NotBlank private String newPassword; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordSetRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordSetRequest.java new file mode 100644 index 0000000..aa7f303 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/PasswordSetRequest.java @@ -0,0 +1,10 @@ +package com.mydreamjob.auth.dto; + +import jakarta.validation.constraints.NotBlank; +import lombok.Data; + +@Data +public class PasswordSetRequest { + @NotBlank private String smsCode; + @NotBlank private String newPassword; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/RefreshTokenRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/RefreshTokenRequest.java new file mode 100644 index 0000000..59cbe7d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/RefreshTokenRequest.java @@ -0,0 +1,21 @@ +package com.mydreamjob.auth.dto; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import lombok.Data; + +/** + * S02 刷新请求（白名单 DTO）。 + * + *

只允许 {@code refreshToken} 一个字段；Token 不接受 query/path 参数传递。

+ */ +@Data +@Schema(name = "RefreshTokenRequest", description = "刷新请求") +public class RefreshTokenRequest { + + @NotBlank(message = "refreshToken is required") + @Size(max = 4096, message = "refreshToken is too long") + @Schema(description = "登录或上一次刷新返回的 Refresh Token", requiredMode = Schema.RequiredMode.REQUIRED) + private String refreshToken; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/TokenPairResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/TokenPairResponse.java new file mode 100644 index 0000000..23b3724 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/dto/TokenPairResponse.java @@ -0,0 +1,15 @@ +package com.mydreamjob.auth.dto; + +import io.swagger.v3.oas.annotations.media.Schema; + +/** + * S02 刷新响应（白名单 DTO）。 + * + *

只包含新 Token 对与有效期；不包含 userId、手机号、sessionId 或任何数据库字段。

+ */ +@Schema(name = "TokenPairResponse", description = "刷新后的 Token 对") +public record TokenPairResponse( + @Schema(description = "新的 Access Token") String accessToken, + @Schema(description = "新的 Refresh Token") String refreshToken, + @Schema(description = "Access Token 有效期（秒）") long expiresIn) { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationProperties.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationProperties.java new file mode 100644 index 0000000..3782f22 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationProperties.java @@ -0,0 +1,43 @@ +package com.mydreamjob.auth.password; + +import jakarta.annotation.PostConstruct; +import lombok.Getter; +import lombok.Setter; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +/** Strongly typed, startup-validated password authentication configuration. */ +@Getter +@Setter +@Component +@ConfigurationProperties(prefix = "app.auth.password") +public class PasswordAuthenticationProperties { + private boolean enabled = false; + private String rateKeySecret = ""; + private int maxFailures = 5; + private long lockoutSeconds = 900L; + private long ipWindowSeconds = 600L; + private int ipMaxAttempts = 30; + private long operationWindowSeconds = 600L; + private int operationMaxAttempts = 10; + + @PostConstruct + void validate() { + if (enabled && (rateKeySecret == null || rateKeySecret.length() < 32)) { + throw new IllegalStateException( + "app.auth.password.rate-key-secret must be at least 32 characters"); + } + requireRange("max-failures", maxFailures, 1, 20); + requireRange("lockout-seconds", lockoutSeconds, 60, 86_400); + requireRange("ip-window-seconds", ipWindowSeconds, 60, 3_600); + requireRange("ip-max-attempts", ipMaxAttempts, 1, 1_000); + requireRange("operation-window-seconds", operationWindowSeconds, 60, 3_600); + requireRange("operation-max-attempts", operationMaxAttempts, 1, 100); + } + + private void requireRange(String name, long value, long minimum, long maximum) { + if (value < minimum || value > maximum) { + throw new IllegalStateException("app.auth.password." + name + " is outside the allowed range"); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationService.java new file mode 100644 index 0000000..96dd6cb --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordAuthenticationService.java @@ -0,0 +1,153 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.*; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.deletion.AccountDeletionRepository; +import com.mydreamjob.deletion.DeletionStatus; +import lombok.RequiredArgsConstructor; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Clock; +import java.time.Instant; +import java.util.HashMap; +import java.util.Map; +import java.util.Optional; + +@Service +@RequiredArgsConstructor +public class PasswordAuthenticationService { + private static final String DUMMY_HASH = "$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi"; + private static final String PURPOSE_SET = "password-set"; + private static final String PURPOSE_RESET = "password-reset"; + + private final UserRepository userRepository; + private final PasswordEncoder passwordEncoder; + private final PasswordPolicy passwordPolicy; + private final PasswordRateLimiter rateLimiter; + private final SmsVerificationService smsVerificationService; + private final AuthSessionService authSessionService; + private final AccountDeletionRepository accountDeletionRepository; + private final AuditService auditService; + private final Clock clock; + + @Transactional + public Map login(String phone, String rawPassword, String requestId, + String ipAddress, String userAgent) { + rateLimiter.checkAllowed(phone, ipAddress); + String normalized = passwordPolicy.normalize(rawPassword); + Optional optional = userRepository.findByPhoneForUpdate(phone); + String hash = optional.map(User::getPasswordHash).orElse(DUMMY_HASH); + boolean passwordMatches = passwordEncoder.matches(normalized, hash); + User user = optional.orElse(null); + if (!passwordMatches || !usable(user)) { + rateLimiter.recordFailure(phone); + audit(null, "PASSWORD_LOGIN_FAILED", requestId, ipAddress, userAgent, "INVALID_CREDENTIALS"); + throw new BusinessException(ErrorCode.CREDENTIALS_INVALID, "手机号或密码错误"); + } + Instant now = clock.instant(); + AuditContext ctx = context(requestId, ipAddress, userAgent); + AuthSessionService.SessionTokens tokens = authSessionService.createSession(user, now, ctx); + rateLimiter.recordSuccess(phone); + audit(user.getId(), "PASSWORD_LOGIN_SUCCEEDED", requestId, ipAddress, userAgent, "SUCCESS"); + Map result = new HashMap<>(); + result.put("userId", user.getId()); + result.put("phone", user.getPhone()); + result.put("nickname", user.getNickname()); + result.put("role", user.getRole()); + result.put("accessToken", tokens.accessToken()); + result.put("refreshToken", tokens.refreshToken()); + result.put("expiresIn", AuthService.EXPIRES_IN_SECONDS); + return result; + } + + @Transactional + public PasswordOperationResult setPassword(Long userId, String smsCode, String newPassword, + String requestId, String ipAddress, String userAgent) { + User user = lockedUsableUser(userId); + rateLimiter.checkOperationAllowed(user.getPhone()); + if (user.getPasswordHash() != null) { + throw new BusinessException(ErrorCode.PASSWORD_STATE_CONFLICT, "password is already configured"); + } + smsVerificationService.verifyCode(user.getPhone(), smsCode, PURPOSE_SET); + passwordPolicy.validateNewPassword(newPassword, user.getPhone(), null, passwordEncoder); + user.setPasswordHash(passwordEncoder.encode(passwordPolicy.normalize(newPassword))); + user.setPasswordChangedAt(java.time.LocalDateTime.ofInstant(clock.instant(), AuthSessionService.BUSINESS_ZONE)); + userRepository.save(user); + revokeAndAudit(user, "PASSWORD_SET", requestId, ipAddress, userAgent); + return new PasswordOperationResult(true, true); + } + + @Transactional + public PasswordOperationResult changePassword(Long userId, String currentPassword, String newPassword, + String requestId, String ipAddress, String userAgent) { + User user = lockedUsableUser(userId); + rateLimiter.checkOperationAllowed(user.getPhone()); + if (user.getPasswordHash() == null + || !passwordEncoder.matches(passwordPolicy.normalize(currentPassword), user.getPasswordHash())) { + throw new BusinessException(ErrorCode.CREDENTIALS_INVALID, "手机号或密码错误"); + } + passwordPolicy.validateNewPassword(newPassword, user.getPhone(), user.getPasswordHash(), passwordEncoder); + user.setPasswordHash(passwordEncoder.encode(passwordPolicy.normalize(newPassword))); + user.setPasswordChangedAt(java.time.LocalDateTime.ofInstant(clock.instant(), AuthSessionService.BUSINESS_ZONE)); + userRepository.save(user); + revokeAndAudit(user, "PASSWORD_CHANGED", requestId, ipAddress, userAgent); + return new PasswordOperationResult(true, true); + } + + @Transactional + public PasswordOperationResult resetPassword(String phone, String smsCode, String newPassword, + String requestId, String ipAddress, String userAgent) { + rateLimiter.checkOperationAllowed(phone); + User user = userRepository.findByPhone(phone).orElseThrow( + () -> new BusinessException(ErrorCode.CREDENTIALS_INVALID, "手机号或验证码错误")); + user = lockedUsableUser(user.getId()); + smsVerificationService.verifyCode(phone, smsCode, PURPOSE_RESET); + passwordPolicy.validateNewPassword(newPassword, phone, user.getPasswordHash(), passwordEncoder); + user.setPasswordHash(passwordEncoder.encode(passwordPolicy.normalize(newPassword))); + user.setPasswordChangedAt(java.time.LocalDateTime.ofInstant(clock.instant(), AuthSessionService.BUSINESS_ZONE)); + userRepository.save(user); + revokeAndAudit(user, "PASSWORD_RESET", requestId, ipAddress, userAgent); + rateLimiter.recordSuccess(phone); + return new PasswordOperationResult(true, true); + } + + private User lockedUsableUser(Long userId) { + User user = userRepository.findByIdForUpdate(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.CREDENTIALS_INVALID, "手机号或密码错误")); + if (!usable(user)) { + throw new BusinessException(ErrorCode.CREDENTIALS_INVALID, "手机号或密码错误"); + } + return user; + } + + private boolean usable(User user) { + if (user == null || !Boolean.TRUE.equals(user.getActive())) return false; + return accountDeletionRepository.findByUserId(user.getId()) + .map(d -> d.getStatus() != DeletionStatus.COMPLETED) + .orElse(true); + } + + private void revokeAndAudit(User user, String action, String requestId, String ip, String ua) { + Instant now = clock.instant(); + authSessionService.revokeAllUserSessions(user.getId(), action, now); + audit(user.getId(), action, requestId, ip, ua, "SUCCESS"); + audit(user.getId(), "AUTH_SESSIONS_REVOKED", requestId, ip, ua, action); + } + + private void audit(Long userId, String action, String requestId, String ip, String ua, String reason) { + auditService.log(userId, action, "AUTH", null, + "{\"reason\":\"" + reason + "\"}", context(requestId, ip, ua), + java.time.LocalDateTime.ofInstant(clock.instant(), AuthSessionService.BUSINESS_ZONE)); + } + + private AuditContext context(String requestId, String ip, String ua) { + return AuditContext.builder().requestId(requestId).ipAddress(ip).userAgent(ua).build(); + } + + public record PasswordOperationResult(boolean passwordConfigured, boolean reauthenticationRequired) {} +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordPolicy.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordPolicy.java new file mode 100644 index 0000000..c50bc75 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordPolicy.java @@ -0,0 +1,43 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.springframework.stereotype.Component; + +import java.text.Normalizer; +import java.util.Set; + +/** Pure password normalization and policy checks. */ +@Component +public final class PasswordPolicy { + + private static final int MIN_LENGTH = 12; + private static final int MAX_LENGTH = 64; + private static final Set COMMON_PASSWORDS = Set.of( + "123456789012", "password123", "passwordpassword", "qwertyuiop12", + "administrator", "letmein12345", "111111111111"); + + public String normalize(String raw) { + if (raw == null) { + throw new BusinessException(ErrorCode.PASSWORD_POLICY_INVALID, "password does not meet policy"); + } + return Normalizer.normalize(raw, Normalizer.Form.NFC); + } + + public void validateNewPassword(String raw, String phone, String currentHash, + org.springframework.security.crypto.password.PasswordEncoder encoder) { + String password = normalize(raw); + int length = password.codePointCount(0, password.length()); + if (length < MIN_LENGTH || length > MAX_LENGTH || password.isBlank()) { + throw new BusinessException(ErrorCode.PASSWORD_POLICY_INVALID, "password does not meet policy"); + } + String folded = password.toLowerCase(java.util.Locale.ROOT); + if (COMMON_PASSWORDS.contains(folded) + || (phone != null && password.contains(phone))) { + throw new BusinessException(ErrorCode.PASSWORD_POLICY_INVALID, "password does not meet policy"); + } + if (currentHash != null && encoder.matches(password, currentHash)) { + throw new BusinessException(ErrorCode.PASSWORD_POLICY_INVALID, "new password must differ from current password"); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordRateLimiter.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordRateLimiter.java new file mode 100644 index 0000000..b189fee --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/password/PasswordRateLimiter.java @@ -0,0 +1,150 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.script.DefaultRedisScript; +import org.springframework.stereotype.Component; + +import javax.crypto.Mac; +import javax.crypto.spec.SecretKeySpec; +import java.nio.charset.StandardCharsets; +import java.util.HexFormat; +import java.util.List; + +/** Redis-backed password login throttling. Redis failures fail closed. */ +@Component +public final class PasswordRateLimiter { + private static final String LOCK_PREFIX = "auth:pwd:locked:"; + private static final String FAIL_PREFIX = "auth:pwd:fail:"; + private static final String IP_PREFIX = "auth:pwd:ip:"; + private static final String OPERATION_PREFIX = "auth:pwd:operation:"; + + private static final DefaultRedisScript INCREMENT_WITH_TTL = new DefaultRedisScript<>(""" + local current = redis.call('INCR', KEYS[1]) + local ttl = redis.call('TTL', KEYS[1]) + if current == 1 or ttl < 0 then + redis.call('EXPIRE', KEYS[1], tonumber(ARGV[1])) + end + return current + """, Long.class); + + private static final DefaultRedisScript RECORD_FAILURE = new DefaultRedisScript<>(""" + local current = redis.call('INCR', KEYS[1]) + local ttl = redis.call('TTL', KEYS[1]) + if current == 1 or ttl < 0 then + redis.call('EXPIRE', KEYS[1], tonumber(ARGV[1])) + end + if current >= tonumber(ARGV[2]) then + redis.call('SET', KEYS[2], '1', 'EX', tonumber(ARGV[1]), 'NX') + end + return current + """, Long.class); + + private final RedisTemplate redisTemplate; + private final PasswordAuthenticationProperties properties; + + public PasswordRateLimiter(RedisTemplate redisTemplate, + PasswordAuthenticationProperties properties) { + this.redisTemplate = redisTemplate; + this.properties = properties; + } + + public void checkAllowed(String phone, String ipAddress) { + ensureEnabled(); + try { + String phoneRef = ref(phone); + if (Boolean.TRUE.equals(redisTemplate.hasKey(LOCK_PREFIX + phoneRef))) { + throw new BusinessException(ErrorCode.PASSWORD_RATE_LIMITED, "too many attempts, try again later"); + } + String window = window(properties.getIpWindowSeconds()); + String ipKey = IP_PREFIX + ref(ipAddress == null ? "unknown" : ipAddress) + ":" + window; + long count = incrementWithTtl(ipKey, properties.getIpWindowSeconds()); + if (count > properties.getIpMaxAttempts()) { + throw new BusinessException(ErrorCode.PASSWORD_RATE_LIMITED, "too many attempts, try again later"); + } + } catch (BusinessException e) { + throw e; + } catch (Exception e) { + throw unavailable(); + } + } + + /** Applies to set/change/reset and also enforces the module switch and Redis fail-closed rule. */ + public void checkOperationAllowed(String phone) { + ensureEnabled(); + try { + String key = OPERATION_PREFIX + ref(phone) + ":" + window(properties.getOperationWindowSeconds()); + long count = incrementWithTtl(key, properties.getOperationWindowSeconds()); + if (count > properties.getOperationMaxAttempts()) { + throw new BusinessException(ErrorCode.PASSWORD_RATE_LIMITED, "too many attempts, try again later"); + } + } catch (BusinessException e) { + throw e; + } catch (Exception e) { + throw unavailable(); + } + } + + public void recordFailure(String phone) { + ensureEnabled(); + try { + String phoneRef = ref(phone); + Long count = redisTemplate.execute(RECORD_FAILURE, + List.of(FAIL_PREFIX + phoneRef, LOCK_PREFIX + phoneRef), + properties.getLockoutSeconds(), properties.getMaxFailures()); + if (count == null) { + throw unavailable(); + } + } catch (BusinessException e) { + throw e; + } catch (Exception e) { + throw unavailable(); + } + } + + public void recordSuccess(String phone) { + ensureEnabled(); + try { + String ref = ref(phone); + redisTemplate.delete(FAIL_PREFIX + ref); + redisTemplate.delete(LOCK_PREFIX + ref); + } catch (BusinessException e) { + throw e; + } catch (Exception e) { + throw unavailable(); + } + } + + public String ref(String value) { + try { + Mac mac = Mac.getInstance("HmacSHA256"); + mac.init(new SecretKeySpec(properties.getRateKeySecret().getBytes(StandardCharsets.UTF_8), "HmacSHA256")); + return HexFormat.of().formatHex(mac.doFinal(String.valueOf(value).getBytes(StandardCharsets.UTF_8))); + } catch (Exception e) { + throw unavailable(); + } + } + + private void ensureEnabled() { + if (!properties.isEnabled()) { + throw unavailable(); + } + } + + private long incrementWithTtl(String key, long ttlSeconds) { + Long count = redisTemplate.execute(INCREMENT_WITH_TTL, List.of(key), ttlSeconds); + if (count == null) { + throw unavailable(); + } + return count; + } + + private String window(long windowSeconds) { + return Long.toString(System.currentTimeMillis() / (windowSeconds * 1000L)); + } + + private BusinessException unavailable() { + return new BusinessException(ErrorCode.SERVICE_UNAVAILABLE, "authentication service temporarily unavailable"); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/MockSmsCodeSender.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/MockSmsCodeSender.java new file mode 100644 index 0000000..c2ba83d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/MockSmsCodeSender.java @@ -0,0 +1,23 @@ +package com.mydreamjob.auth.sms; + +import lombok.extern.slf4j.Slf4j; + +/** + * Mock 短信发送实现。 + * + *

由 {@link SmsSenderConfiguration} 在 {@code app.sms.mock.enabled} 显式解析为 + * {@code true} 时装配（不再使用条件注解，以保证任何取值下恰好一个 Bean）。

+ * + *

不接入真实短信网关，仅记录一条固定文本的发送事件。 + * 不得把验证码或完整手机号写入日志。

+ */ +@Slf4j +public class MockSmsCodeSender implements SmsCodeSender { + + @Override + public void sendVerificationCode(String phone, String purpose, String code) { + // 固定安全文本：不包含验证码、手机号、Token 或任何配置细节。 + // 本地开发如需验证码，请从 sms_verification_codes 表读取（见 docs 说明），不要重新写回日志。 + log.info("SMS verification code generated (mock sender)"); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsCodeSender.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsCodeSender.java new file mode 100644 index 0000000..41f1655 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsCodeSender.java @@ -0,0 +1,24 @@ +package com.mydreamjob.auth.sms; + +/** + * 短信验证码发送抽象。 + * + *

由 {@code app.sms.mock.enabled} 决定加载哪一个实现： + *

    + *
  • {@code true} → {@link MockSmsCodeSender}（本地/测试环境，不调用外部网关）
    • + *
  • {@code false} 或未配置 → {@link UnavailableSmsCodeSender}（安全失败，不伪造成功）
    • + *
+ * + *

实现方禁止把验证码或完整手机号写入任何级别的日志。 + */ +public interface SmsCodeSender { + + /** + * 发送验证码。 + * + * @param phone 接收手机号（实现方不得写入日志） + * @param purpose 验证码用途 + * @param code 验证码（实现方不得写入日志） + */ + void sendVerificationCode(String phone, String purpose, String code); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsSenderConfiguration.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsSenderConfiguration.java new file mode 100644 index 0000000..351a9d9 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/SmsSenderConfiguration.java @@ -0,0 +1,37 @@ +package com.mydreamjob.auth.sms; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** + * 短信发送实现装配（单 Bean 方案）。 + * + *

由本配置类始终且仅产生一个 {@link SmsCodeSender}，从而彻底避免 + * “两个互斥 {@code @ConditionalOnProperty} 在空值/空白值下都不匹配 → 0 个 Bean → + * 模糊 Spring 装配错误导致启动失败”的问题。

+ * + *

取值语义（大小写不敏感，两侧空白忽略）：

+ *
    + *
  • {@code true} → {@link MockSmsCodeSender}
    • + *
  • {@code false} / 缺失 / 空字符串 / 仅空白 / 其他非法值 → {@link UnavailableSmsCodeSender}
    • + *
+ * + *

安全约束：只有显式 {@code true} 才启用 Mock；非法值一律安全回退到不可用实现， + * 既不启用 Mock，也不进入发送流程。本类不输出配置原值到日志。

+ */ +@Configuration +public class SmsSenderConfiguration { + + /** 显式启用 Mock 的唯一取值。 */ + private static final String MOCK_ENABLED_VALUE = "true"; + + @Bean + public SmsCodeSender smsCodeSender( + @Value("${app.sms.mock.enabled:false}") String rawEnabled) { + if (rawEnabled != null && MOCK_ENABLED_VALUE.equalsIgnoreCase(rawEnabled.trim())) { + return new MockSmsCodeSender(); + } + return new UnavailableSmsCodeSender(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/UnavailableSmsCodeSender.java b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/UnavailableSmsCodeSender.java new file mode 100644 index 0000000..f0e5ee0 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/auth/sms/UnavailableSmsCodeSender.java @@ -0,0 +1,25 @@ +package com.mydreamjob.auth.sms; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; + +/** + * 不可用短信发送实现。 + * + *

由 {@link SmsSenderConfiguration} 在 {@code app.sms.mock.enabled} 为 false、缺失、 + * 空值、仅空白或其他非法值时装配（不再使用条件注解，以保证任何取值下恰好一个 Bean）。

+ * + *

当前未接入真实短信网关，因此本实现安全失败： + * 抛出既有的“服务不可用”业务异常，绝不返回虚假的“发送成功”。 + * 异常消息为固定安全文本，不含手机号、验证码或任何配置细节。

+ */ +public class UnavailableSmsCodeSender implements SmsCodeSender { + + /** 固定安全文本：不含手机号、验证码、Token、内网地址或配置项。 */ + static final String SAFE_MESSAGE = "sms sender unavailable"; + + @Override + public void sendVerificationCode(String phone, String purpose, String code) { + throw new BusinessException(ErrorCode.SERVICE_UNAVAILABLE, SAFE_MESSAGE); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchController.java b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchController.java index bb13f12..e336702 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchController.java @@ -8,8 +8,6 @@ import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.*; import java.util.Map; @@ -22,6 +20,11 @@ import java.util.Map; @RequiredArgsConstructor public class ApplicationMatchController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final BidirectionalMatchService matchService; @Operation(summary = "提交求职者岗位意愿分", description = "仅投递本人(STUDENT)；0-100；MATCHED/CLOSED 后不可修改") @@ -30,10 +33,10 @@ public class ApplicationMatchController { @PathVariable Long id, @Valid @RequestBody ScoreRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ApplicationMatchRecord record = matchService.submitCandidateInterestScore( userId, id, req.getScore(), com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(toView(record), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(toView(record), requestIdAccessor.get(request))); } @Operation(summary = "提交企业 HR 适配分", description = "仅岗位所属企业；0-100；MATCHED/CLOSED 后不可修改") @@ -42,10 +45,10 @@ public class ApplicationMatchController { @PathVariable Long id, @Valid @RequestBody ScoreRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ApplicationMatchRecord record = matchService.submitHrSuitabilityScore( userId, id, req.getScore(), com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(toView(record), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(toView(record), requestIdAccessor.get(request))); } @Operation(summary = "查询投递匹配状态", description = "仅投递求职者或岗位所属企业；不暴露内部路径/事件 ID") @@ -53,8 +56,8 @@ public class ApplicationMatchController { public ResponseEntity>> getMatch( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(matchService.getMatchView(userId, id), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(matchService.getMatchView(userId, id), requestIdAccessor.get(request))); } /** 评分接口返回记录视图（脱敏，不含内部字段） */ @@ -74,15 +77,4 @@ public class ApplicationMatchController { return v; } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchConversationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchConversationController.java index ccd8bd7..760fc7b 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchConversationController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchConversationController.java @@ -6,8 +6,6 @@ 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.*; import java.util.Map; @@ -20,6 +18,11 @@ import java.util.Map; @RequiredArgsConstructor public class MatchConversationController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final MatchConversationService matchConversationService; @Operation(summary = "创建/获取匹配会话", description = "仅 MATCHED 双方可调用；重复调用返回同一会话") @@ -27,20 +30,9 @@ public class MatchConversationController { public ResponseEntity>> createOrGetConversation( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map conversation = matchConversationService.createOrGetMatchConversation(userId, id); - return ResponseEntity.ok(ApiResponse.ok(conversation, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(conversation, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleController.java b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleController.java index b22568a..29ef858 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleController.java @@ -9,8 +9,6 @@ import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.*; import java.util.Map; @@ -23,51 +21,45 @@ import java.util.Map; @RequiredArgsConstructor public class MatchRuleController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final MatchRuleService matchRuleService; @Operation(summary = "查询企业匹配阈值", description = "未配置返回默认 60") @GetMapping("/companies/me/match-rule") public ResponseEntity>> getCompanyRule(HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(matchRuleService.getCompanyRule(userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(matchRuleService.getCompanyRule(userId), requestIdAccessor.get(request))); } @Operation(summary = "更新企业匹配阈值", description = "requiredCandidateScore 0-100；首次更新创建配置") @PutMapping("/companies/me/match-rule") public ResponseEntity>> updateCompanyRule( @Valid @RequestBody CompanyMatchRuleRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( matchRuleService.updateCompanyRule(userId, req.getRequiredCandidateScore()), - getRequestId(request))); + requestIdAccessor.get(request))); } @Operation(summary = "查询学生匹配阈值", description = "未配置返回默认 60") @GetMapping("/profile/me/match-rule") public ResponseEntity>> getStudentRule(HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(matchRuleService.getStudentRule(userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(matchRuleService.getStudentRule(userId), requestIdAccessor.get(request))); } @Operation(summary = "更新学生匹配阈值", description = "requiredHrScore 0-100；首次更新创建配置") @PutMapping("/profile/me/match-rule") public ResponseEntity>> updateStudentRule( @Valid @RequestBody StudentMatchRuleRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( matchRuleService.updateStudentRule(userId, req.getRequiredHrScore()), - getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleService.java b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleService.java index c25cf01..dedeb07 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/bidirectionalmatch/MatchRuleService.java @@ -6,6 +6,7 @@ import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.security.UserRoleGuard; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; @@ -21,6 +22,7 @@ import java.util.Map; @RequiredArgsConstructor public class MatchRuleService { + private final UserRoleGuard userRoleGuard; private final CompanyMatchRuleRepository companyRuleRepository; private final StudentMatchRuleRepository studentRuleRepository; private final CompanyRepository companyRepository; @@ -51,7 +53,7 @@ public class MatchRuleService { @Transactional(readOnly = true) public Map getStudentRule(Long userId) { - requireStudent(userId); + userRoleGuard.requireStudent(userId); StudentMatchRule rule = studentRuleRepository.findByStudentUserId(userId).orElse(null); int required = rule != null ? rule.getRequiredHrScore() : StudentMatchRule.DEFAULT_REQUIRED_HR_SCORE; @@ -60,7 +62,7 @@ public class MatchRuleService { @Transactional public Map updateStudentRule(Long userId, int requiredHrScore) { - requireStudent(userId); + userRoleGuard.requireStudent(userId); StudentMatchRule rule = studentRuleRepository.findByStudentUserId(userId) .orElseGet(() -> StudentMatchRule.builder().studentUserId(userId).build()); rule.setRequiredHrScore(requiredHrScore); @@ -94,11 +96,4 @@ public class MatchRuleService { .orElseThrow(() -> new BusinessException(ErrorCode.COMPANY_NOT_FOUND)); } - private void requireStudent(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles() != null - && user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) throw new BusinessException(ErrorCode.FORBIDDEN); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSource.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSource.java new file mode 100644 index 0000000..9678afc --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSource.java @@ -0,0 +1,115 @@ +package com.mydreamjob.candidatescore; + +import lombok.RequiredArgsConstructor; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * V38：候选人 ABILITY 维度仅读投影源。 + * + *

一次查询取某学生最新、COMPLETED、且 {@code valid_until > capturedNow} 的 V36 + * {@code WORKPLACE_ABILITY} 完整结果。只关联 ability_results / ability_attempts / + * ability_definitions，绝不读取 ability_answers / ability_attempt_questions / 题目或答案键。 + * 排序固定为 {@code completed_at DESC, attempt_id DESC}，最多一条；不比较分数（不取历史最高分）。

+ * + *

不暴露实体给 Controller，仅作为 CandidateScoringCalculator 的只读数据源。

+ */ +@Component +@RequiredArgsConstructor +public class AbilityAssessmentScoreSource { + + private static final String SQL = """ + SELECT r.id AS resultId, + a.completed_at AS completedAt, + r.valid_until AS validUntil, + r.question_set_version AS questionSetVersion, + r.rules_version AS assessmentRulesVersion, + a.answered_count AS answeredCount, + r.dimension_scores_json AS dimensionScoresJson + FROM ability_results r + JOIN ability_attempts a ON a.id = r.attempt_id + JOIN ability_definitions d ON d.id = a.definition_id + WHERE a.student_user_id = ? + AND a.status = 'COMPLETED' + AND d.type_code = 'WORKPLACE_ABILITY' + AND r.valid_until > ? + ORDER BY a.completed_at DESC, a.id DESC + LIMIT 1 + """; + + /** + * 仅在没有任何有效结果时读取最新的已完成过期结果，用于向学生解释“已过期”。 + * 该查询不参与分数计算；正常有效结果仍只走 {@link #SQL}。 + */ + private static final String NON_VALID_SQL = """ + SELECT r.id AS resultId, + a.completed_at AS completedAt, + r.valid_until AS validUntil, + r.question_set_version AS questionSetVersion, + r.rules_version AS assessmentRulesVersion, + a.answered_count AS answeredCount, + r.dimension_scores_json AS dimensionScoresJson + FROM ability_results r + JOIN ability_attempts a ON a.id = r.attempt_id + JOIN ability_definitions d ON d.id = a.definition_id + WHERE a.student_user_id = ? + AND a.status = 'COMPLETED' + AND d.type_code = 'WORKPLACE_ABILITY' + AND (r.valid_until IS NULL OR r.valid_until <= ?) + ORDER BY a.completed_at DESC, a.id DESC + LIMIT 1 + """; + + private final JdbcTemplate jdbcTemplate; + + /** + * 最新有效完整结果的只读投影；无匹配结果或参数为空时返回 {@code null}。 + * 单次调用只发起一次查询，禁止按四维循环查询（不存在 N+1）。 + */ + public AbilityResultProjection findLatestValidCompletedResult(Long studentUserId, LocalDateTime capturedNow) { + if (studentUserId == null || capturedNow == null) { + return null; + } + List rows = jdbcTemplate.query(SQL, rowMapper(), studentUserId, capturedNow); + return rows.isEmpty() ? null : rows.get(0); + } + + /** + * 仅在 {@link #findLatestValidCompletedResult(Long, LocalDateTime)} 没有命中时调用， + * 读取最新已完成但当前不可参与评分的结果，供解释层区分 EXPIRED 与 INVALID。 + * 不存在结果时返回 null。 + */ + public AbilityResultProjection findLatestNonValidCompletedResult(Long studentUserId, LocalDateTime capturedNow) { + if (studentUserId == null || capturedNow == null) { + return null; + } + List rows = jdbcTemplate.query(NON_VALID_SQL, rowMapper(), studentUserId, capturedNow); + return rows.isEmpty() ? null : rows.get(0); + } + + private org.springframework.jdbc.core.RowMapper rowMapper() { + return (rs, n) -> new AbilityResultProjection( + rs.getLong("resultId"), + rs.getTimestamp("completedAt") == null ? null : rs.getTimestamp("completedAt").toLocalDateTime(), + rs.getTimestamp("validUntil") == null ? null : rs.getTimestamp("validUntil").toLocalDateTime(), + rs.getString("questionSetVersion"), + rs.getString("assessmentRulesVersion"), + rs.getInt("answeredCount"), + rs.getString("dimensionScoresJson")); + } + + /** + * 仅含评分所需最小字段的只读投影；不含题目、答案、答案键、选项分值或题库标签。 + */ + public record AbilityResultProjection(Long resultId, + LocalDateTime completedAt, + LocalDateTime validUntil, + String questionSetVersion, + String assessmentRulesVersion, + Integer answeredCount, + String dimensionScoresJson) { + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityScoreMapper.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityScoreMapper.java new file mode 100644 index 0000000..531d08e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/AbilityScoreMapper.java @@ -0,0 +1,185 @@ +package com.mydreamjob.candidatescore; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.springframework.stereotype.Component; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; + +/** + * V38：四维能力结果 → 候选人 ABILITY 维度的纯函数映射器（无数据库访问）。 + * + *

仅接受恰好包含 LOGIC / COMMUNICATION / EXECUTION / LEARNING 四维、每维错题数均为 6、 + * 总错题数为 24、且分数均在 [0,100]（有限数值）的完整结果；任何结构异常都返回 + * {@link Optional#empty()}，由调用方映射为 {@code PENDING}，绝不抛给前端 500。

+ * + *

公式（V38 固定业务权重，不复用 V36 等权 overallScore）：
+ * abilityScore = LOGIC×0.35 + EXECUTION×0.30 + LEARNING×0.20 + COMMUNICATION×0.15， + * 最终 scale=2、HALF_UP。

+ */ +@Component +public class AbilityScoreMapper { + + public static final String MAPPING_RULES_VERSION = "ability-assessment-scoring-v0.1"; + + public static final BigDecimal WEIGHT_LOGIC = new BigDecimal("0.35"); + public static final BigDecimal WEIGHT_EXECUTION = new BigDecimal("0.30"); + public static final BigDecimal WEIGHT_LEARNING = new BigDecimal("0.20"); + public static final BigDecimal WEIGHT_COMMUNICATION = new BigDecimal("0.15"); + + public static final int PER_DIMENSION_ANSWERED = 6; + public static final int TOTAL_ANSWERED = 24; + public static final BigDecimal MAX_SCORE = new BigDecimal("100"); + + private static final ObjectMapper MAPPER = new ObjectMapper(); + private static final TypeReference>> ENTRIES_LIST = + new TypeReference<>() { + }; + private static final Set EXPECTED_DIMENSIONS = + Set.of("LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"); + + /** + * 计算结果。{@code dimensionScores} 与 {@code weights} 均使用固定有序键， + * 便于调用方构造白名单 subScores 与最小溯源 JSON。 + */ + public record MappedScores(BigDecimal abilityScore, + Map dimensionScores, + Map weights) { + } + + /** + * 安全解析单个 V36 结果。结构异常一律返回空。 + * + * @param dimensionScoresJson ability_results.dimension_scores_json（数组：{code,score,answeredCount}） + * @param attemptAnsweredCount ability_attempts.answered_count（必须为 24） + */ + public Optional map(String dimensionScoresJson, Integer attemptAnsweredCount) { + if (dimensionScoresJson == null || dimensionScoresJson.isBlank()) { + return Optional.empty(); + } + final List> entries; + try { + entries = MAPPER.readValue(dimensionScoresJson, ENTRIES_LIST); + } catch (Exception e) { + return Optional.empty(); + } + if (entries == null || entries.size() != EXPECTED_DIMENSIONS.size()) { + return Optional.empty(); + } + + Map scores = new LinkedHashMap<>(); + Set seen = new java.util.HashSet<>(); + int sumAnswered = 0; + for (LinkedHashMap e : entries) { + String code = e.get("code") instanceof String s ? s : null; + if (code == null || !EXPECTED_DIMENSIONS.contains(code) || !seen.add(code)) { + return Optional.empty(); // 缺维 / 重复维 / 意外维 + } + BigDecimal score = toFiniteScore(e.get("score")); + if (score == null) { + return Optional.empty(); + } + Integer answered = toExactInt(e.get("answeredCount")); + if (answered == null || answered != PER_DIMENSION_ANSWERED) { + return Optional.empty(); // 每维错题数必须精确等于 6（6.9/6.5/溢出/非法均不可用） + } + scores.put(code, score); + sumAnswered += answered; + } + if (scores.size() != EXPECTED_DIMENSIONS.size() || sumAnswered != TOTAL_ANSWERED) { + return Optional.empty(); + } + if (attemptAnsweredCount == null || attemptAnsweredCount != TOTAL_ANSWERED) { + return Optional.empty(); // 答卷总错题数必须非空且恰为 24 + } + + Map weights = new LinkedHashMap<>(); + weights.put("LOGIC", Integer.valueOf(35)); + weights.put("EXECUTION", Integer.valueOf(30)); + weights.put("LEARNING", Integer.valueOf(20)); + weights.put("COMMUNICATION", Integer.valueOf(15)); + + BigDecimal abilityScore = scores.get("LOGIC").multiply(WEIGHT_LOGIC) + .add(scores.get("EXECUTION").multiply(WEIGHT_EXECUTION)) + .add(scores.get("LEARNING").multiply(WEIGHT_LEARNING)) + .add(scores.get("COMMUNICATION").multiply(WEIGHT_COMMUNICATION)) + .setScale(2, RoundingMode.HALF_UP); + + Map ordered = new LinkedHashMap<>(); + ordered.put("LOGIC", scores.get("LOGIC")); + ordered.put("EXECUTION", scores.get("EXECUTION")); + ordered.put("LEARNING", scores.get("LEARNING")); + ordered.put("COMMUNICATION", scores.get("COMMUNICATION")); + + return Optional.of(new MappedScores(abilityScore, ordered, weights)); + } + + private BigDecimal toFiniteScore(Object v) { + BigDecimal b = toBigDecimal(v); + if (b == null) return null; + if (b.compareTo(BigDecimal.ZERO) < 0 || b.compareTo(MAX_SCORE) > 0) return null; + return b; + } + + private BigDecimal toBigDecimal(Object v) { + if (v == null) return null; + BigDecimal out; + if (v instanceof BigDecimal bd) { + out = bd; + } else if (v instanceof Number num) { + double d = num.doubleValue(); + if (Double.isNaN(d) || Double.isInfinite(d)) return null; + out = BigDecimal.valueOf(d); + } else { + String s = String.valueOf(v).trim(); + if (s.isEmpty()) return null; + try { + out = new BigDecimal(s); + } catch (NumberFormatException e) { + return null; + } + } + return out; + } + + /** + * 将 answeredCount 精确解析为整数：仅接受数值意义上等于整数的表示 + * （如 JSON 整数 6 或 6.0、"6"、"6.0"）。6.9、6.5、"6.5"、溢出 int、空串、null + * 一律返回 null，由调用方映射为不可用。不使用 intValue() 截断，避免把小数误判为整数。 + */ + private Integer toExactInt(Object v) { + if (v == null) return null; + try { + if (v instanceof BigDecimal bd) { + return exactIntOrNull(bd); + } else if (v instanceof Number num) { + double d = num.doubleValue(); + if (Double.isNaN(d) || Double.isInfinite(d)) return null; + return exactIntOrNull(BigDecimal.valueOf(d)); + } else if (v instanceof String s) { + String t = s.trim(); + if (t.isEmpty()) return null; + return exactIntOrNull(new BigDecimal(t)); + } + return null; + } catch (NumberFormatException e) { + return null; + } + } + + /** stripTrailingZeros 后能精确转 int 才返回，否则 null。 */ + private Integer exactIntOrNull(BigDecimal b) { + if (b == null) return null; + try { + return b.stripTrailingZeros().intValueExact(); + } catch (ArithmeticException e) { + return null; // 非精确整数（如 6.5、6.9）或溢出 int + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicy.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicy.java new file mode 100644 index 0000000..2ebcff6 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicy.java @@ -0,0 +1,51 @@ +package com.mydreamjob.candidatescore; + +import java.util.List; +import java.util.Objects; +import java.util.function.Predicate; + +/** Single pure policy for candidate overview status aggregation. */ +public final class CandidateOverviewStatusPolicy { + + private CandidateOverviewStatusPolicy() { + } + + public static String fromComputedResults( + List results, int expectedDimensions) { + Objects.requireNonNull(results, "results"); + return evaluate(results, expectedDimensions, + result -> isComputable(result.status, result.score != null), + result -> "PENDING".equals(result.status), + "PENDING"); + } + + public static String fromSnapshots(List snapshots) { + if (snapshots == null || snapshots.isEmpty()) { + return "INSUFFICIENT_DATA"; + } + return evaluate(snapshots, snapshots.size(), + snapshot -> isComputable(snapshot.getStatus(), true), + snapshot -> "PENDING".equals(snapshot.getStatus()), + "INSUFFICIENT_DATA"); + } + + private static String evaluate(List values, int completeCount, + Predicate computable, Predicate pending, + String emptyStatus) { + if (values == null || values.isEmpty()) { + return emptyStatus; + } + long computableCount = values.stream().filter(computable).count(); + if (computableCount == completeCount) { + return "OK"; + } + if (computableCount > 0) { + return "PARTIAL"; + } + return values.stream().allMatch(pending) ? "PENDING" : "INSUFFICIENT_DATA"; + } + + private static boolean isComputable(String status, boolean valueAvailable) { + return valueAvailable && ("OK".equals(status) || "ESTIMATED".equals(status)); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoreCardController.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoreCardController.java index 9ec913d..dcf0a9c 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoreCardController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoreCardController.java @@ -16,8 +16,6 @@ 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.*; @Tag(name = "求职者评分卡", description = "求职者评价聚合与评分卡") @@ -25,6 +23,11 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class CandidateScoreCardController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CandidateScoreCardService scoreCardService; private final CompanyService companyService; @@ -39,10 +42,10 @@ public class CandidateScoreCardController { @GetMapping("/profile/me/candidate-score-card") public ResponseEntity> getScoreCard( HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); CandidateScoreCardResponse card = scoreCardService.getScoreCard(userId); - return ResponseEntity.ok(ApiResponse.ok(card, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(card, requestIdAccessor.get(request))); } @Operation(summary = "查询评分趋势", description = "仅 STUDENT；返回最近月份的反馈趋势") @@ -59,10 +62,10 @@ public class CandidateScoreCardController { @Parameter(description = "统计月数，默认 6，范围 1-24") @RequestParam(defaultValue = "6") int months, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); CandidateScoreTrendResponse trend = scoreCardService.getTrend(userId, months); - return ResponseEntity.ok(ApiResponse.ok(trend, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(trend, requestIdAccessor.get(request))); } @Operation(summary = "查询百分位", description = "仅 STUDENT；返回自己在候选人中的评分百分位") @@ -76,21 +79,10 @@ public class CandidateScoreCardController { @GetMapping("/profile/me/candidate-percentile") public ResponseEntity> getPercentile( HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); CandidatePercentileResponse percentile = scoreCardService.getPercentile(userId); - return ResponseEntity.ok(ApiResponse.ok(percentile, getRequestId(request))); - } - - private Long resolveUserId() { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(percentile, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java index fc41729..b5670d7 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringCalculator.java @@ -5,17 +5,17 @@ import com.fasterxml.jackson.databind.ObjectMapper; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; +import com.mydreamjob.candidatescore.rules.CandidateScoringRuleSet; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.preference.StudentPreference; import com.mydreamjob.preference.StudentPreferenceRepository; import com.mydreamjob.profile.StudentProfile; import com.mydreamjob.profile.StudentProfileRepository; -import jakarta.persistence.EntityManager; -import jakarta.persistence.PersistenceContext; -import jakarta.persistence.Query; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.stereotype.Component; @@ -23,6 +23,7 @@ import java.math.BigDecimal; import java.math.RoundingMode; import java.time.LocalDate; import java.time.LocalDateTime; +import java.time.Clock; import java.time.temporal.ChronoUnit; import java.util.*; import java.util.stream.Collectors; @@ -36,8 +37,9 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class CandidateScoringCalculator { - public static final String RULES_VERSION = "candidate-scoring-v0.1"; - public static final BigDecimal DEFAULT_WEIGHT = new BigDecimal("12.50"); + /** R01-C：版本与默认权重来自唯一规则源 CandidateScoringRuleSet。 */ + public static final String RULES_VERSION = CandidateScoringRuleSet.VERSION; + public static final BigDecimal DEFAULT_WEIGHT = CandidateScoringRuleSet.DEFAULT_DIMENSION_WEIGHT; public static boolean isValidDimension(String dimension) { return DIMENSIONS.contains(dimension); @@ -68,63 +70,56 @@ public class CandidateScoringCalculator { private static final ObjectMapper MAPPER = new ObjectMapper(); - // 内置学校档次名单（v0.1 硬编码，非数据库表） - private static final Set C985 = new HashSet<>(List.of( - "北京大学", "清华大学", "中国人民大学", "北京航空航天大学", "北京理工大学", - "中国农业大学", "北京师范大学", "中央民族大学", "南开大学", "天津大学", - "大连理工大学", "吉林大学", "哈尔滨工业大学", "复旦大学", "同济大学", - "上海交通大学", "华东师范大学", "南京大学", "东南大学", "浙江大学", - "中国科学技术大学", "厦门大学", "山东大学", "中国海洋大学", "武汉大学", - "华中科技大学", "湖南大学", "中南大学", "中山大学", "华南理工大学", - "四川大学", "重庆大学", "电子科技大学", "西安交通大学", "西北工业大学", - "兰州大学", "东北大学", "西北农林科技大学")); - private static final Set C211 = new HashSet<>(List.of( - "北京交通大学", "北京工业大学", "北京科技大学", "北京化工大学", "北京邮电大学", - "北京林业大学", "北京中医药大学", "北京外国语大学", "中国传媒大学", "中央财经大学", - "对外经济贸易大学", "中国政法大学", "华北电力大学", "天津医科大学", "河北工业大学", - "太原理工大学", "内蒙古大学", "辽宁大学", "大连海事大学", "延边大学", - "哈尔滨工程大学", "东北农业大学", "东北林业大学", "东华大学", "上海大学", - "上海财经大学", "上海外国语大学", "苏州大学", "南京航空航天大学", "南京理工大学", - "中国矿业大学", "河海大学", "江南大学", "南京农业大学", "中国药科大学", - "南京师范大学", "安徽大学", "合肥工业大学", "福州大学", "南昌大学", - "郑州大学", "武汉理工大学", "华中农业大学", "华中师范大学", "中南财经政法大学", - "湖南师范大学", "暨南大学", "华南师范大学", "广西大学", "海南大学", - "西南交通大学", "西南财经大学", "贵州大学", "云南大学", "西北大学", - "西安电子科技大学", "长安大学", "新疆大学", "石河子大学", "宁夏大学", - "青海大学", "北京科技大学")); private final StudentProfileRepository profileRepository; private final StudentPreferenceRepository preferenceRepository; private final UserRepository userRepository; private final JdbcTemplate jdbcTemplate; + private final AbilityAssessmentScoreSource abilityScoreSource; + private final AbilityScoreMapper abilityScoreMapper; + /** R01-D4-1：唯一快照 Writer（普通物化幂等 / Governance 强制版本双模式）。 */ + private final com.mydreamjob.candidatescore.refresh.CandidateScoringSnapshotWriter snapshotWriter; - @PersistenceContext - private EntityManager entityManager; + /** 可测试的时间源；未提供 Spring Clock 时保持系统时区语义。 */ + private Clock clock = Clock.systemDefaultZone(); + + @Value("${scoring.ability-assessment.enabled:false}") + private boolean abilityAssessmentEnabled; + + @Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; + } // ── 数据采集（一次性、单学生过滤，无 N+1）───────────────────── public List computeAll(Long studentUserId) { + return computeAll(studentUserId, LocalDateTime.now(clock)); + } + + public List computeAll(Long studentUserId, LocalDateTime capturedNow) { User user = userRepository.findById(studentUserId).orElse(null); StudentProfile profile = profileRepository.findByUserId(studentUserId).orElse(null); StudentPreference pref = preferenceRepository.findByStudentUserId(studentUserId).orElse(null); - AppAgg apps = queryApps(studentUserId); - AuditAgg audit = queryAudit(studentUserId); + AppAgg apps = queryApps(studentUserId, capturedNow); + AuditAgg audit = queryAudit(studentUserId, capturedNow); OfferAgg offers = queryOffers(studentUserId); FbAgg fb = queryFeedback(studentUserId); ResumeAgg resume = queryResume(studentUserId); long msgCount = queryMessages(studentUserId); List list = new ArrayList<>(); - list.add(computeEducation(profile)); - list.add(computeInternship()); - list.add(computeAbility()); - list.add(computeCompliance(pref)); + list.add(computeEducation(profile, capturedNow)); + list.add(computeInternship(capturedNow)); + list.add(computeAbility(studentUserId, capturedNow)); + list.add(computeCompliance(pref, capturedNow)); list.add(computeStability(user != null ? user.getCreatedAt() : null, - (int) apps.total, (int) apps.withdrawn, (int) audit.login30d)); - list.add(computeGrowth((int) resume.count, resume.latestUpdate, skillCount(profile))); + (int) apps.total, (int) apps.withdrawn, (int) audit.login30d, capturedNow)); + list.add(computeGrowth((int) resume.count, resume.latestUpdate, skillCount(profile), capturedNow)); list.add(computeIntegrity((int) offers.accepted, (int) offers.expired, - fb.count, fb.avg, isProfileComplete(profile, resume.count))); - list.add(computeActivity((int) apps.recent90d, (int) audit.total30d, msgCount)); + fb.count, fb.avg, isProfileComplete(profile, resume.count), capturedNow)); + list.add(computeActivity((int) apps.recent90d, (int) audit.total30d, msgCount, capturedNow)); + list.forEach(result -> result.capturedAt = capturedNow); return list; } @@ -132,33 +127,40 @@ public class CandidateScoringCalculator { * 按当前数据确定性重算单维度并写入指定 period 的快照（评分治理回滚复用） */ public DimensionResult recomputeAndSnapshot(Long studentUserId, String dimension, String period) { + return recomputeAndSnapshot(studentUserId, dimension, period, LocalDateTime.now(clock)); + } + + public DimensionResult recomputeAndSnapshot(Long studentUserId, String dimension, String period, + LocalDateTime capturedNow) { if (!DIMENSIONS.contains(dimension)) { throw new BusinessException(ErrorCode.BAD_REQUEST, "invalid dimension: " + dimension); } - DimensionResult r = computeAll(studentUserId).stream() + DimensionResult r = computeAll(studentUserId, capturedNow).stream() .filter(x -> x.dimension.equals(dimension)).findFirst() .orElseThrow(() -> new BusinessException(ErrorCode.BAD_REQUEST, "invalid dimension")); - upsertSnapshots(studentUserId, List.of(r), period); + // R01-D4-1：Governance（申诉决定/回滚）强制版本推进路径 —— 与普通物化（值变化才 +1）显式区分， + // 保持 afterVersion = beforeVersion + 1 与 snapshot_history 审计语义不变。 + snapshotWriter.upsertForcingVersion(studentUserId, r, period, capturedNow, currentRulesVersion()); return r; } - private AppAgg queryApps(Long sid) { + private AppAgg queryApps(Long sid, LocalDateTime capturedNow) { return jdbcTemplate.queryForObject( "SELECT COUNT(*), COALESCE(SUM(CASE WHEN status='WITHDRAWN' THEN 1 ELSE 0 END),0), " + "MIN(created_at), COALESCE(SUM(CASE WHEN created_at >= ? THEN 1 ELSE 0 END),0) " + "FROM applications WHERE student_user_id = ?", (rs, n) -> new AppAgg(rs.getLong(1), rs.getLong(2), rs.getTimestamp(3) == null ? null : rs.getTimestamp(3).toLocalDateTime(), rs.getLong(4)), - LocalDateTime.now().minusDays(90), sid); + capturedNow.minusDays(90), sid); } - private AuditAgg queryAudit(Long sid) { + private AuditAgg queryAudit(Long sid, LocalDateTime capturedNow) { return jdbcTemplate.queryForObject( "SELECT COALESCE(SUM(CASE WHEN created_at >= ? THEN 1 ELSE 0 END),0), " + "COALESCE(SUM(CASE WHEN action='LOGIN' AND created_at >= ? THEN 1 ELSE 0 END),0) " + "FROM audit_logs WHERE user_id = ?", (rs, n) -> new AuditAgg(rs.getLong(1), rs.getLong(2)), - LocalDateTime.now().minusDays(30), LocalDateTime.now().minusDays(30), sid); + capturedNow.minusDays(30), capturedNow.minusDays(30), sid); } private OfferAgg queryOffers(Long sid) { @@ -191,69 +193,176 @@ public class CandidateScoringCalculator { // ── 八维规则（确定性）────────────────────────────────────── public DimensionResult computeEducation(StudentProfile profile) { + return computeEducation(profile, LocalDateTime.now(clock)); + } + + public DimensionResult computeEducation(StudentProfile profile, LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("EDUCATION"); if (profile == null || isBlank(profile.getEducation())) { r.status = "INSUFFICIENT_DATA"; r.summary = "未填写学历信息"; + addContribution(r, "EDUCATION_MISSING", "MISSING", null, CandidateScoringRuleSet.EDUCATION_MISSING_SCORE, "教育资料", + "学历资料未填写，当前维度不计算"); return r; } BigDecimal eduLevel = switch (profile.getEducation()) { - case "博士" -> new BigDecimal("100"); - case "硕士" -> new BigDecimal("85"); - case "本科" -> new BigDecimal("70"); - case "大专" -> new BigDecimal("55"); - default -> new BigDecimal("50"); + case "博士" -> CandidateScoringRuleSet.EDUCATION_LEVEL_DOCTOR; + case "硕士" -> CandidateScoringRuleSet.EDUCATION_LEVEL_MASTER; + case "本科" -> CandidateScoringRuleSet.EDUCATION_LEVEL_BACHELOR; + case "大专" -> CandidateScoringRuleSet.EDUCATION_LEVEL_JUNIOR_COLLEGE; + default -> CandidateScoringRuleSet.EDUCATION_LEVEL_UNKNOWN; }; String school = profile.getSchool(); boolean estimated = false; BigDecimal schoolTier; if (isBlank(school)) { - schoolTier = new BigDecimal("50"); + schoolTier = CandidateScoringRuleSet.SCHOOL_TIER_MISSING; estimated = true; r.reasons.add("学校未填写，按兜底档位估算"); - } else if (C985.contains(school)) { - schoolTier = new BigDecimal("85"); - } else if (C211.contains(school)) { - schoolTier = new BigDecimal("75"); + } else if (CandidateScoringRuleSet.is985(school)) { + schoolTier = CandidateScoringRuleSet.SCHOOL_TIER_985; + } else if (CandidateScoringRuleSet.is211(school)) { + schoolTier = CandidateScoringRuleSet.SCHOOL_TIER_211; } else if (school.endsWith("大学") || school.endsWith("学院")) { - schoolTier = new BigDecimal("65"); + schoolTier = CandidateScoringRuleSet.SCHOOL_TIER_OTHER; } else { - schoolTier = new BigDecimal("50"); + schoolTier = CandidateScoringRuleSet.SCHOOL_TIER_MISSING; estimated = true; r.reasons.add("学校不在内置名单，按兜底档位估算"); } - r.score = eduLevel.multiply(new BigDecimal("0.55")) - .add(schoolTier.multiply(new BigDecimal("0.45"))) + r.score = eduLevel.multiply(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT) + .add(schoolTier.multiply(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT)) .setScale(2, RoundingMode.HALF_UP); + addContribution(r, "EDUCATION_LEVEL", "APPLIED", eduLevel.multiply(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT), CandidateScoringRuleSet.EDUCATION_LEVEL_FULL_SCORE, + "学历层次", profile.getEducation(), "学历字段按固定映射形成贡献"); + if (isBlank(school)) { + addContribution(r, "EDUCATION_MISSING", "MISSING", null, null, "教育资料缺失", + "学校资料未填写，学校档位使用估算兜底"); + } + addContribution(r, "EDUCATION_SCHOOL_TIER", "APPLIED", schoolTier.multiply(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT), CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_FULL_SCORE, + "学校分类", isBlank(school) ? "未填写" : "已按学校分类规则处理", "学校分类按固定规则形成贡献，不能代表能力"); r.status = estimated ? "ESTIMATED" : "OK"; r.summary = "学历层次与学校档次的加权综合"; - r.subScores.add(sub("学历层次", eduLevel, new BigDecimal("55"), profile.getEducation())); - r.subScores.add(sub("学校档次", schoolTier, new BigDecimal("45"), isBlank(school) ? "未填写" : school)); - r.dataSources.add(ds("student_profiles.education/school", profile.getUpdatedAt(), "学历与学校字段")); + r.subScores.add(sub("学历层次", eduLevel, CandidateScoringRuleSet.EDUCATION_LEVEL_FULL_SCORE, profile.getEducation())); + r.subScores.add(sub("学校档次", schoolTier, CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_FULL_SCORE, isBlank(school) ? "未填写" : school)); + r.dataSources.add(ds("个人教育资料", profile.getUpdatedAt(), "学历与学校分类信息")); return r; } public DimensionResult computeInternship() { + return computeInternship(LocalDateTime.now(clock)); + } + + public DimensionResult computeInternship(LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("INTERNSHIP"); r.status = "PENDING"; r.summary = "实习经历数据源未就绪"; r.reasons.add("结构化实习经历尚未提供"); + addContribution(r, "INTERNSHIP_SOURCE_UNAVAILABLE", "UNAVAILABLE", null, null, "实习经历数据源", + "未接入，不等于没有实习经历"); return r; } - public DimensionResult computeAbility() { + /** + * ABILITY 维度：V38 有限接入 V36 四维能力测评（WORKPLACE_ABILITY）。 + *

开关关闭时严格保持 V37 前行为（PENDING、不查询 V36 来源）。 + * 开关开启且存在最新有效完整结果时，按 V38 固定权重映射；无有效结果或结构异常一律 + * PENDING 且 score=null，绝不对前端抛 500。

+ */ + public DimensionResult computeAbility(Long studentUserId, LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("ABILITY"); - r.status = "PENDING"; - r.summary = "能力测评数据源未就绪"; - r.reasons.add("能力测评（F1.2）尚未实现"); + if (!abilityAssessmentEnabled) { + r.status = "PENDING"; + r.summary = "能力测评数据源未就绪"; + r.reasons.add("能力测评（F1.2）尚未实现"); + addContribution(r, "ABILITY_FEATURE_DISABLED", "UNAVAILABLE", null, null, "四维能力测评", + "能力测评功能开关当前关闭"); + return r; + } + var proj = abilityScoreSource.findLatestValidCompletedResult(studentUserId, capturedNow); + if (proj == null) { + // 有效结果查询为空时，仅额外读取最新不可用结果用于解释；不存在则保持 MISSING/PENDING。 + proj = abilityScoreSource.findLatestNonValidCompletedResult(studentUserId, capturedNow); + } + if (proj == null) { + r.status = "PENDING"; + r.summary = "能力测评数据源未就绪"; + r.reasons.add("无可用的完整能力测评结果"); + addContribution(r, "ABILITY_RESULT_MISSING", "MISSING", null, null, "四维能力测评", + "没有可用的完整测评结果"); + return r; + } + if (proj.validUntil() == null) { + r.status = "PENDING"; + r.summary = "能力测评结果结构异常"; + r.reasons.add("测评有效期缺失，暂不参与评分"); + addContribution(r, "ABILITY_RESULT_INVALID", "UNAVAILABLE", null, null, "四维能力测评", + "测评有效期缺失，暂不参与评分"); + r.dataSources.add(ds("四维能力测评", proj.completedAt(), "最近一次测评结果不可用")); + return r; + } + if (!proj.validUntil().isAfter(capturedNow)) { + r.status = "PENDING"; + r.summary = "能力测评结果已过期"; + r.reasons.add("测评有效期已结束，暂不参与评分"); + addContribution(r, "ABILITY_RESULT_EXPIRED", "EXPIRED", null, null, "四维能力测评", + "测评有效期已结束，暂不参与评分"); + r.dataSources.add(ds("四维能力测评", proj.completedAt(), "最近一次测评已过期")); + r.dataSources.add(ds("四维能力测评有效期", proj.validUntil(), "测评有效期")); + r.abilitySnapshotTrace = new AbilitySnapshotTrace( + proj.resultId(), proj.completedAt(), proj.validUntil(), + proj.questionSetVersion(), proj.assessmentRulesVersion(), null, null); + return r; + } + var mapped = abilityScoreMapper.map(proj.dimensionScoresJson(), proj.answeredCount()); + if (mapped.isEmpty()) { + r.status = "PENDING"; + r.summary = "能力测评数据源异常"; + r.reasons.add("测评结果结构异常，暂不参与评分"); + addContribution(r, "ABILITY_RESULT_INVALID", "UNAVAILABLE", null, null, "四维能力测评", + "测评结果结构异常，暂不参与评分"); + return r; + } + var m = mapped.get(); + r.status = "OK"; + r.score = m.abilityScore(); + r.summary = "最新有效四维能力测评（LOGIC/EXECUTION/LEARNING/COMMUNICATION）加权映射"; + r.subScores.add(sub("逻辑能力", m.dimensionScores().get("LOGIC"), new BigDecimal("35"), "V36 四维能力测评聚合分")); + r.subScores.add(sub("执行能力", m.dimensionScores().get("EXECUTION"), new BigDecimal("30"), "V36 四维能力测评聚合分")); + r.subScores.add(sub("学习能力", m.dimensionScores().get("LEARNING"), new BigDecimal("20"), "V36 四维能力测评聚合分")); + r.subScores.add(sub("沟通能力", m.dimensionScores().get("COMMUNICATION"), new BigDecimal("15"), "V36 四维能力测评聚合分")); + addContribution(r, "ABILITY_LOGIC", "APPLIED", m.dimensionScores().get("LOGIC").multiply(new BigDecimal("0.35")), new BigDecimal("35"), "逻辑能力", "测评聚合分", "按 V38 固定权重映射"); + addContribution(r, "ABILITY_EXECUTION", "APPLIED", m.dimensionScores().get("EXECUTION").multiply(new BigDecimal("0.30")), new BigDecimal("30"), "执行能力", "测评聚合分", "按 V38 固定权重映射"); + addContribution(r, "ABILITY_LEARNING", "APPLIED", m.dimensionScores().get("LEARNING").multiply(new BigDecimal("0.20")), new BigDecimal("20"), "学习能力", "测评聚合分", "按 V38 固定权重映射"); + addContribution(r, "ABILITY_COMMUNICATION", "APPLIED", m.dimensionScores().get("COMMUNICATION").multiply(new BigDecimal("0.15")), new BigDecimal("15"), "沟通能力", "测评聚合分", "按 V38 固定权重映射"); + reconcileContributionRounding(r); + r.dataSources.add(ds("四维能力测评", proj.completedAt(), "最新有效四维能力测评完成时间")); + r.dataSources.add(ds("四维能力测评有效期", proj.validUntil(), "测评有效期")); + r.reasons.add("映射规则版本 " + AbilityScoreMapper.MAPPING_RULES_VERSION); + r.abilitySnapshotTrace = new AbilitySnapshotTrace( + proj.resultId(), proj.completedAt(), proj.validUntil(), + proj.questionSetVersion(), proj.assessmentRulesVersion(), m.weights(), m.dimensionScores()); return r; } + /** + * 候选评分规则版本：开关开启时升级为 v0.2，否则保持 v0.1；历史趋势优先使用快照自身版本。 + */ + public String currentRulesVersion() { + return abilityAssessmentEnabled ? "candidate-scoring-v0.2" : RULES_VERSION; + } + public DimensionResult computeCompliance(StudentPreference pref) { + return computeCompliance(pref, LocalDateTime.now(clock)); + } + + public DimensionResult computeCompliance(StudentPreference pref, LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("COMPLIANCE"); if (pref == null) { r.status = "INSUFFICIENT_DATA"; r.summary = "未设置求职偏好"; + addContribution(r, "PREFERENCE_ALL_MISSING", "MISSING", null, null, "求职偏好", + "没有可比较的偏好字段"); return r; } boolean salary = pref.getExpectedSalaryMin() != null || pref.getExpectedSalaryMax() != null; @@ -271,6 +380,8 @@ public class CandidateScoringCalculator { if (present == 0) { r.status = "INSUFFICIENT_DATA"; r.summary = "未填写任何求职偏好字段"; + addContribution(r, "PREFERENCE_ALL_MISSING", "MISSING", null, null, "求职偏好", + "没有可比较的偏好字段"); return r; } r.score = score.setScale(2, RoundingMode.HALF_UP); @@ -281,126 +392,178 @@ public class CandidateScoringCalculator { r.subScores.add(sub("用工类型", type ? new BigDecimal("20") : ZERO, new BigDecimal("20"), type ? "已填" : "未填")); r.subScores.add(sub("行业偏好", industry ? new BigDecimal("15") : ZERO, new BigDecimal("15"), industry ? "已填" : "未填")); r.subScores.add(sub("岗位类型", jobType ? new BigDecimal("15") : ZERO, new BigDecimal("15"), jobType ? "已填" : "未填")); - r.dataSources.add(ds("student_preferences", pref.getUpdatedAt(), "薪资/城市/用工/行业/岗位偏好")); + addContribution(r, "PREFERENCE_SALARY_PRESENT", salary ? "APPLIED" : "NOT_APPLIED", salary ? new BigDecimal("25") : ZERO, new BigDecimal("25"), "薪资偏好", salary ? "已填写" : "未填写", "仅反映资料完整度"); + addContribution(r, "PREFERENCE_CITY_PRESENT", city ? "APPLIED" : "NOT_APPLIED", city ? new BigDecimal("25") : ZERO, new BigDecimal("25"), "城市偏好", city ? "已填写" : "未填写", "仅反映资料完整度"); + addContribution(r, "PREFERENCE_EMPLOYMENT_TYPE_PRESENT", type ? "APPLIED" : "NOT_APPLIED", type ? new BigDecimal("20") : ZERO, new BigDecimal("20"), "用工类型偏好", type ? "已填写" : "未填写", "仅反映资料完整度"); + addContribution(r, "PREFERENCE_INDUSTRY_PRESENT", industry ? "APPLIED" : "NOT_APPLIED", industry ? new BigDecimal("15") : ZERO, new BigDecimal("15"), "行业偏好", industry ? "已填写" : "未填写", "仅反映资料完整度"); + addContribution(r, "PREFERENCE_JOB_TYPE_PRESENT", jobType ? "APPLIED" : "NOT_APPLIED", jobType ? new BigDecimal("15") : ZERO, new BigDecimal("15"), "岗位类型偏好", jobType ? "已填写" : "未填写", "仅反映资料完整度"); + r.dataSources.add(ds("求职偏好", pref.getUpdatedAt(), "薪资/城市/用工/行业/岗位偏好")); return r; } public DimensionResult computeStability(LocalDateTime accountCreatedAt, int totalApps, int withdrawnApps, int login30d) { + return computeStability(accountCreatedAt, totalApps, withdrawnApps, login30d, LocalDateTime.now(clock)); + } + + public DimensionResult computeStability(LocalDateTime accountCreatedAt, int totalApps, int withdrawnApps, int login30d, + LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("STABILITY"); if (totalApps == 0 && login30d == 0) { r.status = "INSUFFICIENT_DATA"; r.summary = "无投递且无登录活动"; + addContribution(r, "STABILITY_DATA_MISSING", "MISSING", null, null, "平台行为资料", + "没有足够的平台行为数据"); return r; } BigDecimal score = new BigDecimal("50"); - long ageMonths = accountCreatedAt == null ? 0 : ChronoUnit.MONTHS.between(accountCreatedAt, LocalDateTime.now()); + addContribution(r, "STABILITY_BASE", "APPLIED", new BigDecimal("50"), new BigDecimal("50"), "基础信号", "已计算", "按当前稳定信号规则计算"); + long ageMonths = accountCreatedAt == null ? 0 : ChronoUnit.MONTHS.between(accountCreatedAt, capturedNow); + BigDecimal ageContribution = ZERO; if (ageMonths > 12) { score = score.add(new BigDecimal("25")); r.reasons.add("账号活跃期超过 12 个月"); } else if (ageMonths > 6) { score = score.add(new BigDecimal("15")); r.reasons.add("账号活跃期超过 6 个月"); } + if (ageMonths > 12) ageContribution = new BigDecimal("25"); + else if (ageMonths > 6) ageContribution = new BigDecimal("15"); + addContribution(r, "STABILITY_ACCOUNT_AGE", accountCreatedAt == null ? "MISSING" : ageContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", + ageContribution, new BigDecimal("25"), "账号时长信号", "按账号时长区间处理", "仅反映平台账号行为代理"); + BigDecimal withdrawalContribution = ZERO; if (totalApps > 0) { double rate = withdrawnApps * 1.0 / totalApps; - if (rate < 0.2) { score = score.add(new BigDecimal("15")); r.reasons.add("撤回率低于 20%"); } - else if (rate > 0.5) { score = score.subtract(new BigDecimal("20")); r.reasons.add("撤回率高于 50%"); } + if (rate < 0.2) { score = score.add(new BigDecimal("15")); withdrawalContribution = new BigDecimal("15"); r.reasons.add("撤回率低于 20%"); } + else if (rate > 0.5) { score = score.subtract(new BigDecimal("20")); withdrawalContribution = new BigDecimal("-20"); r.reasons.add("撤回率高于 50%"); } } - if (login30d > 0) { score = score.add(new BigDecimal("10")); r.reasons.add("近 30 天有登录"); } - r.score = cap(score); + String withdrawalOutcome = totalApps <= 0 ? "MISSING" : withdrawalContribution.signum() == 0 ? "NOT_APPLIED" : "APPLIED"; + addContribution(r, "STABILITY_WITHDRAWAL_RATE", withdrawalOutcome, withdrawalContribution, new BigDecimal("15"), "撤回率信号", "按撤回率区间处理", "仅反映平台行为代理"); + BigDecimal loginContribution = login30d > 0 ? new BigDecimal("10") : ZERO; + if (login30d > 0) { score = score.add(loginContribution); r.reasons.add("近 30 天有登录"); } + addContribution(r, "STABILITY_RECENT_LOGIN", login30d > 0 ? "APPLIED" : "NOT_APPLIED", loginContribution, new BigDecimal("10"), "近期登录信号", login30d > 0 ? "存在近期登录" : "无近期登录", "仅反映平台活动"); + r.score = capWithAdjustment(r, score); r.status = "OK"; r.summary = "账号活跃期、撤回率与登录信号的稳定性评估"; - r.dataSources.add(ds("users.createdAt/applications/audit_logs", LocalDateTime.now(), "账号年龄与求职行为")); + r.dataSources.add(ds("平台求职行为", capturedNow, "账号年龄、投递与近期平台活动")); return r; } public DimensionResult computeGrowth(int activeResumeCount, LocalDateTime latestResumeUpdate, int skillCount) { + return computeGrowth(activeResumeCount, latestResumeUpdate, skillCount, LocalDateTime.now(clock)); + } + + public DimensionResult computeGrowth(int activeResumeCount, LocalDateTime latestResumeUpdate, int skillCount, + LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("GROWTH"); if (activeResumeCount == 0 && skillCount == 0) { r.status = "INSUFFICIENT_DATA"; r.summary = "无简历版本且无技能标签"; + addContribution(r, "GROWTH_DATA_MISSING", "MISSING", null, null, "简历与技能资料", + "没有足够的资料维护数据"); return r; } BigDecimal score = new BigDecimal("40"); - if (activeResumeCount >= 2) { score = score.add(new BigDecimal("15")); r.reasons.add("简历版本数 >= 2"); } - if (latestResumeUpdate != null && latestResumeUpdate.isAfter(LocalDateTime.now().minusDays(90))) { - score = score.add(new BigDecimal("15")); r.reasons.add("近 90 天内更新过简历"); + addContribution(r, "GROWTH_BASE", "APPLIED", new BigDecimal("40"), new BigDecimal("40"), "基础信号", "已计算", "按当前资料维护规则计算"); + BigDecimal resumeContribution = activeResumeCount >= 2 ? new BigDecimal("15") : ZERO; + if (resumeContribution.signum() > 0) { score = score.add(resumeContribution); r.reasons.add("简历版本数 >= 2"); } + addContribution(r, "GROWTH_RESUME_VERSIONS", activeResumeCount == 0 ? "MISSING" : resumeContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", + resumeContribution, new BigDecimal("15"), "简历版本信号", activeResumeCount >= 2 ? "达到规则区间" : "未达到规则区间", "仅反映资料维护状态"); + BigDecimal recentContribution = ZERO; + if (latestResumeUpdate != null && latestResumeUpdate.isAfter(capturedNow.minusDays(90))) { + recentContribution = new BigDecimal("15"); score = score.add(recentContribution); r.reasons.add("近 90 天内更新过简历"); } - if (skillCount >= 5) { score = score.add(new BigDecimal("15")); r.reasons.add("技能标签 >= 5"); } - r.score = cap(score); + addContribution(r, "GROWTH_RECENT_RESUME_UPDATE", latestResumeUpdate == null ? "MISSING" : recentContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", + recentContribution, new BigDecimal("15"), "近期更新信号", recentContribution.signum() > 0 ? "近 90 天已更新" : "未在近 90 天更新", "仅反映资料维护状态"); + BigDecimal skillContribution = skillCount >= 5 ? new BigDecimal("15") : ZERO; + if (skillContribution.signum() > 0) { score = score.add(skillContribution); r.reasons.add("技能标签 >= 5"); } + addContribution(r, "GROWTH_SKILL_TAGS", skillCount == 0 ? "MISSING" : skillContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", + skillContribution, new BigDecimal("15"), "技能展示信号", skillCount >= 5 ? "达到规则区间" : "未达到规则区间", "技能数量不等于技能质量"); + r.score = capWithAdjustment(r, score); r.status = "OK"; r.summary = "简历迭代、更新频率与技能数量的成长信号"; - r.dataSources.add(ds("resume_versions/student_profiles.skillsJson", LocalDateTime.now(), "简历与技能")); + r.dataSources.add(ds("简历与技能资料", capturedNow, "简历维护与技能标签展示")); return r; } public DimensionResult computeIntegrity(int acceptedOffers, int expiredOffers, long feedbackCount, double avgRating, boolean profileComplete) { + return computeIntegrity(acceptedOffers, expiredOffers, feedbackCount, avgRating, profileComplete, + LocalDateTime.now(clock)); + } + + public DimensionResult computeIntegrity(int acceptedOffers, int expiredOffers, long feedbackCount, + double avgRating, boolean profileComplete, LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("INTEGRITY"); if (acceptedOffers == 0 && expiredOffers == 0 && feedbackCount == 0) { r.status = "INSUFFICIENT_DATA"; r.summary = "无 Offer 历史且无候选人反馈"; + addContribution(r, "INTEGRITY_DATA_MISSING", "MISSING", null, null, "履约与资料信号", + "没有足够的履约或反馈数据"); return r; } BigDecimal score = new BigDecimal("60"); - if (acceptedOffers > 0) { score = score.add(new BigDecimal(Math.min(acceptedOffers, 2) * 15)); r.reasons.add("接受 Offer（守约信号）"); } - if (expiredOffers > 0) { score = score.subtract(new BigDecimal(Math.min(expiredOffers, 2) * 10)); r.reasons.add("Offer 过期未响应"); } - if (feedbackCount >= 3 && avgRating >= 4) { score = score.add(new BigDecimal("10")); r.reasons.add("候选人反馈质量良好"); } - else if (feedbackCount > 0 && avgRating < 3) { score = score.subtract(new BigDecimal("10")); r.reasons.add("候选人反馈评分偏低"); } - if (profileComplete) { score = score.add(new BigDecimal("10")); r.reasons.add("资料完整且一致"); } - r.score = cap(score); + addContribution(r, "INTEGRITY_BASE", "APPLIED", new BigDecimal("60"), new BigDecimal("60"), "基础信号", "已计算", "按当前履约与资料规则计算"); + BigDecimal acceptedContribution = new BigDecimal(Math.min(acceptedOffers, 2) * 15); + if (acceptedOffers > 0) { score = score.add(acceptedContribution); r.reasons.add("接受 Offer（守约信号）"); } + addContribution(r, "INTEGRITY_ACCEPTED_OFFERS", acceptedOffers > 0 ? "APPLIED" : "MISSING", acceptedContribution, new BigDecimal("30"), "Offer 响应信号", acceptedOffers > 0 ? "存在接受记录" : "无接受记录", "仅反映平台履约代理"); + BigDecimal expiredContribution = new BigDecimal(-Math.min(expiredOffers, 2) * 10); + if (expiredOffers > 0) { score = score.add(expiredContribution); r.reasons.add("Offer 过期未响应"); } + addContribution(r, "INTEGRITY_EXPIRED_OFFERS", expiredOffers > 0 ? "APPLIED" : "MISSING", expiredContribution, new BigDecimal("20"), "Offer 过期信号", expiredOffers > 0 ? "存在过期记录" : "无过期记录", "可能受通知或岗位变化影响"); + BigDecimal feedbackContribution = ZERO; + if (feedbackCount >= 3 && avgRating >= 4) { feedbackContribution = new BigDecimal("10"); score = score.add(feedbackContribution); r.reasons.add("候选人反馈质量良好"); } + else if (feedbackCount > 0 && avgRating < 3) { feedbackContribution = new BigDecimal("-10"); score = score.add(feedbackContribution); r.reasons.add("候选人反馈评分偏低"); } + addContribution(r, "INTEGRITY_FEEDBACK", feedbackCount == 0 ? "MISSING" : feedbackContribution.signum() == 0 ? "NOT_APPLIED" : "APPLIED", + feedbackContribution, new BigDecimal("10"), "反馈信号", feedbackCount > 0 ? "存在反馈记录" : "无反馈记录", "反馈可能受样本量和评价者差异影响"); + BigDecimal profileContribution = profileComplete ? new BigDecimal("10") : ZERO; + if (profileComplete) { score = score.add(profileContribution); r.reasons.add("资料完整且一致"); } + addContribution(r, "INTEGRITY_PROFILE_COMPLETENESS", profileComplete ? "APPLIED" : "NOT_APPLIED", profileContribution, new BigDecimal("10"), "资料完整度", profileComplete ? "资料较完整" : "资料仍可完善", "资料完整不等于人格诚信"); + r.score = capWithAdjustment(r, score); r.status = "OK"; r.summary = "Offer 守约、反馈质量与资料完整度"; - r.dataSources.add(ds("offers/offer_status_history/candidate_feedback/student_profiles/resume_versions", - LocalDateTime.now(), "守约与资料信号")); + r.dataSources.add(ds("Offer 履约与候选反馈", capturedNow, "履约、反馈与资料完整度")); return r; } public DimensionResult computeActivity(int apps90d, int audit30d, long msgCount) { + return computeActivity(apps90d, audit30d, msgCount, LocalDateTime.now(clock)); + } + + public DimensionResult computeActivity(int apps90d, int audit30d, long msgCount, LocalDateTime capturedNow) { DimensionResult r = new DimensionResult("ACTIVITY"); if (apps90d == 0 && audit30d == 0 && msgCount == 0) { r.status = "INSUFFICIENT_DATA"; r.summary = "近期无投递、登录或沟通活动"; + addContribution(r, "ACTIVITY_DATA_MISSING", "MISSING", null, null, "平台求职活动", + "没有足够的近期平台活动数据"); return r; } BigDecimal score = ZERO; - if (apps90d >= 6) { score = score.add(new BigDecimal("50")); r.reasons.add("近 90 天投递 >= 6"); } - else if (apps90d >= 3) { score = score.add(new BigDecimal("40")); r.reasons.add("近 90 天投递 >= 3"); } - else if (apps90d >= 1) { score = score.add(new BigDecimal("20")); r.reasons.add("近 90 天有投递"); } - if (audit30d >= 3) { score = score.add(new BigDecimal("30")); r.reasons.add("近 30 天活跃操作 >= 3"); } - if (msgCount > 0) { score = score.add(new BigDecimal("20")); r.reasons.add("有沟通消息"); } - r.score = cap(score); + BigDecimal appContribution = apps90d >= 6 ? new BigDecimal("50") : apps90d >= 3 ? new BigDecimal("40") : apps90d >= 1 ? new BigDecimal("20") : ZERO; + if (appContribution.signum() > 0) r.reasons.add(apps90d >= 6 ? "近 90 天投递 >= 6" : apps90d >= 3 ? "近 90 天投递 >= 3" : "近 90 天有投递"); + score = score.add(appContribution); + addContribution(r, "ACTIVITY_APPLICATIONS", appContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", appContribution, new BigDecimal("50"), "近期投递信号", appContribution.signum() > 0 ? "近 90 天存在投递" : "近 90 天无投递", "仅反映平台活动"); + BigDecimal opContribution = audit30d >= 3 ? new BigDecimal("30") : ZERO; + if (opContribution.signum() > 0) { score = score.add(opContribution); r.reasons.add("近 30 天活跃操作 >= 3"); } + addContribution(r, "ACTIVITY_PLATFORM_OPERATIONS", opContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", opContribution, new BigDecimal("30"), "近期平台操作", opContribution.signum() > 0 ? "达到规则区间" : "未达到规则区间", "仅反映平台活动"); + BigDecimal msgContribution = msgCount > 0 ? new BigDecimal("20") : ZERO; + if (msgContribution.signum() > 0) { score = score.add(msgContribution); r.reasons.add("有沟通消息"); } + addContribution(r, "ACTIVITY_MESSAGES", msgContribution.signum() > 0 ? "APPLIED" : "NOT_APPLIED", msgContribution, new BigDecimal("20"), "沟通信号", msgContribution.signum() > 0 ? "存在沟通记录" : "无沟通记录", "不代表沟通质量或职业能力"); + r.score = capWithAdjustment(r, score); r.status = "OK"; r.summary = "投递、登录与沟通活跃度"; - r.dataSources.add(ds("applications/audit_logs/messages", LocalDateTime.now(), "活跃行为")); + r.dataSources.add(ds("平台求职活动", capturedNow, "投递、平台操作与沟通信号")); return r; } - // ── 快照批量 upsert（原生 MySQL）──────────────────────────── + // ── 快照写入（R01-D4-1：全部委托唯一 Writer）──────────────────── public void upsertSnapshots(Long studentUserId, List results, String period) { - if (results.isEmpty()) return; - StringBuilder sql = new StringBuilder( - "INSERT INTO candidate_dimension_scores (student_user_id, dimension, period, score, status, " + - "sub_scores_json, weight, rules_version, calculated_at, version, created_at, updated_at) VALUES "); - List params = new ArrayList<>(); - for (int i = 0; i < results.size(); i++) { - if (i > 0) sql.append(","); - sql.append("(?,?,?,?,?,?,?,?,NOW(),0,NOW(),NOW())"); - DimensionResult r = results.get(i); - params.add(studentUserId); - params.add(r.dimension); - params.add(period); - params.add(r.score); - params.add(r.status); - params.add(toJson(r.subScores)); - params.add(DEFAULT_WEIGHT); - params.add(RULES_VERSION); - } - sql.append(" ON DUPLICATE KEY UPDATE score=VALUES(score), status=VALUES(status), " + - "sub_scores_json=VALUES(sub_scores_json), weight=VALUES(weight), " + - "rules_version=VALUES(rules_version), calculated_at=VALUES(calculated_at), " + - "version=version+1, updated_at=NOW()"); - Query q = entityManager.createNativeQuery(sql.toString()); - for (int i = 0; i < params.size(); i++) { - q.setParameter(i + 1, params.get(i)); - } - q.executeUpdate(); + upsertSnapshots(studentUserId, results, period, LocalDateTime.now(clock)); + } + + /** + * 普通物化入口（含 GET 兜底）：委托 {@code CandidateScoringSnapshotWriter#upsertIfChanged}。 + * 值完全相同时不增 version/updated_at；业务值或 rulesVersion 变化才 version+1 → + * 重复读取不再产生无意义的版本噪声，为 D4-2 GET 停写做准备。 + */ + public void upsertSnapshots(Long studentUserId, List results, String period, + LocalDateTime capturedNow) { + snapshotWriter.upsertIfChanged(studentUserId, results, period, capturedNow, currentRulesVersion()); } // ── 工具 ──────────────────────────────────────────────────── @@ -438,17 +601,58 @@ public class CandidateScoringCalculator { return !isBlank(profile.getRealName()) && !isBlank(profile.getEducation()) && !isBlank(profile.getSchool()); } - private String toJson(List subs) { - if (subs == null || subs.isEmpty()) return null; - try { - return MAPPER.writeValueAsString(subs); - } catch (Exception e) { - return null; + private BigDecimal cap(BigDecimal v) { + return v.max(ZERO).min(HUNDRED).setScale(2, RoundingMode.HALF_UP); + } + + private BigDecimal capWithAdjustment(DimensionResult r, BigDecimal raw) { + BigDecimal capped = cap(raw); + BigDecimal adjustment = capped.subtract(raw); + if (adjustment.signum() != 0) { + addContribution(r, "SCORE_CAP_ADJUSTMENT", "APPLIED", adjustment, new BigDecimal("100"), "分数边界调整", + "结果已限制在 0–100", "仅用于说明边界截断，不代表新的评分规则"); } + return capped; } - private BigDecimal cap(BigDecimal v) { - return v.max(ZERO).min(HUNDRED).setScale(2, RoundingMode.HALF_UP); + private void addContribution(DimensionResult r, String ruleCode, String outcome, + BigDecimal contribution, BigDecimal maxContribution, + String label, String observation, String explanation) { + r.ruleContributions.add(new com.mydreamjob.candidatescore.explanation.RuleContribution( + ruleCode, outcome, + contribution == null ? null : contribution.setScale(2, RoundingMode.HALF_UP), + maxContribution == null ? null : maxContribution.setScale(2, RoundingMode.HALF_UP), + label, observation, explanation)); + } + + /** + * 四维能力分数允许小数。各项贡献展示为两位小数时，逐项舍入可能与整体 + * abilityScore 的 HALF_UP 结果相差 0.01；用独立对账项显式记录该展示舍入差， + * 不修改任何评分公式或最终分数。 + */ + private void reconcileContributionRounding(DimensionResult r) { + if (r.score == null || r.ruleContributions.isEmpty()) return; + BigDecimal sum = r.ruleContributions.stream() + .map(c -> c.contribution() == null ? ZERO : c.contribution()) + .reduce(ZERO, BigDecimal::add) + .setScale(2, RoundingMode.HALF_UP); + BigDecimal adjustment = r.score.subtract(sum).setScale(2, RoundingMode.HALF_UP); + if (adjustment.signum() != 0) { + addContribution(r, "SCORE_ROUNDING_ADJUSTMENT", "APPLIED", adjustment, null, + "展示舍入对账", "各项贡献按两位小数展示", "用于对齐最终维度分数，不改变评分规则"); + } + } + + /** + * Convenience overload for unavailable/missing rules that only have an + * observation. The observation is also used as the stable explanation so + * every contribution remains fully populated without changing scoring. + */ + private void addContribution(DimensionResult r, String ruleCode, String outcome, + BigDecimal contribution, BigDecimal maxContribution, + String label, String observation) { + addContribution(r, ruleCode, outcome, contribution, maxContribution, + label, observation, observation); } private DimensionScoreDetailResponse.SubScore sub(String name, BigDecimal score, BigDecimal weight, String desc) { @@ -470,13 +674,27 @@ public class CandidateScoringCalculator { public List subScores = new ArrayList<>(); public List reasons = new ArrayList<>(); public List dataSources = new ArrayList<>(); + public List ruleContributions = new ArrayList<>(); public String summary; + public LocalDateTime capturedAt; + /** 仅 ABILITY(OK) 时携带的最小溯源信息，用于写出 sub_scores_json；其他维度为 null。 */ + public AbilitySnapshotTrace abilitySnapshotTrace; public DimensionResult(String dimension) { this.dimension = dimension; } } + /** V38：ABLE 快照最小溯源元数据（仅持久化到内部 sub_scores_json，绝不对外返回）。 */ + public record AbilitySnapshotTrace(Long resultId, + LocalDateTime completedAt, + LocalDateTime validUntil, + String questionSetVersion, + String assessmentRulesVersion, + Map weights, + Map dimensionScores) { + } + public static class AppAgg { public long total; public long withdrawn; public LocalDateTime earliest; public long recent90d; public AppAgg(long total, long withdrawn, LocalDateTime earliest, long recent90d) { diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringController.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringController.java index 2e37082..fbc0952 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringController.java @@ -13,8 +13,6 @@ 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.*; /** @@ -26,56 +24,50 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class CandidateScoringController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CandidateScoringEngineService scoringEngineService; private final CompanyService companyService; @Operation(summary = "综合评分卡", description = "仅 STUDENT；返回本人 8 维评分、综合分、权重与状态") @GetMapping("/profile/me/candidate-scoring") public ResponseEntity> getOverview(HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); CandidateScoringOverviewResponse data = scoringEngineService.getOverview(userId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "单维度明细", description = "仅 STUDENT；返回某维度分项、归因与数据源；非法 dimension 返回 400") @GetMapping("/profile/me/candidate-scoring/dimensions/{dimension}") public ResponseEntity> getDimensionDetail( @PathVariable String dimension, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); DimensionScoreDetailResponse data = scoringEngineService.getDimensionDetail(userId, dimension); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "评分趋势", description = "仅 STUDENT；基于快照按月返回综合分与维度分（months 1-24）") @GetMapping("/profile/me/candidate-scoring/trend") public ResponseEntity> getTrend( @RequestParam(defaultValue = "6") int months, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); companyService.assertStudentRole(userId); CandidateScoringTrendResponse data = scoringEngineService.getTrend(userId, months); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "企业候选人评分卡", description = "仅岗位所属企业；只读，仅返回 applicationId/overallScore/status/dimensions/generatedAt/rulesVersion，不泄露候选人敏感信息") @GetMapping("/company/candidates/{applicationId}/scoring") public ResponseEntity> getCompanyScoring( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); CompanyCandidateScoringResponse data = scoringEngineService.getCompanyScoring(userId, applicationId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); - } - - private Long resolveUserId() { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringEngineService.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringEngineService.java index 23c58a4..fd5776d 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringEngineService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/CandidateScoringEngineService.java @@ -12,6 +12,7 @@ import com.mydreamjob.job.JobService; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; +import org.springframework.beans.factory.annotation.Autowired; import org.springframework.transaction.annotation.Transactional; import java.math.BigDecimal; @@ -19,6 +20,7 @@ import java.math.RoundingMode; import java.time.Instant; import java.time.LocalDate; import java.time.LocalDateTime; +import java.time.Clock; import java.util.*; /** @@ -31,32 +33,39 @@ import java.util.*; public class CandidateScoringEngineService { private static final BigDecimal ZERO = BigDecimal.ZERO; + private static final int TOTAL_DIMENSIONS = 8; private final CandidateScoringCalculator calculator; private final CandidateDimensionScoreRepository snapshotRepository; private final CompanyRepository companyRepository; private final ApplicationRepository applicationRepository; private final JobService jobService; + private Clock clock = Clock.systemDefaultZone(); + + @Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; + } // ── 综合评分卡（学生自查）──────────────────────────────────── - @Transactional + @Transactional(readOnly = true) public CandidateScoringOverviewResponse getOverview(Long studentUserId) { - List results = calculator.computeAll(studentUserId); - calculator.upsertSnapshots(studentUserId, results, yearMonth(LocalDate.now())); - return buildOverview(studentUserId, results); + LocalDateTime capturedNow = LocalDateTime.now(clock); + List results = calculator.computeAll(studentUserId, capturedNow); + return buildOverview(studentUserId, results, capturedNow); } // ── 单维度明细 ─────────────────────────────────────────────── - @Transactional + @Transactional(readOnly = true) public DimensionScoreDetailResponse getDimensionDetail(Long studentUserId, String dimension) { - List results = calculator.computeAll(studentUserId); + LocalDateTime capturedNow = LocalDateTime.now(clock); + List results = calculator.computeAll(studentUserId, capturedNow); CandidateScoringCalculator.DimensionResult r = results.stream() .filter(x -> x.dimension.equals(dimension)) .findFirst().orElseThrow(() -> new BusinessException(ErrorCode.BAD_REQUEST, "invalid dimension")); - calculator.upsertSnapshots(studentUserId, List.of(r), yearMonth(LocalDate.now())); - return toDetail(r); + return toDetail(r, capturedNow); } // ── 趋势（只读快照，不写）──────────────────────────────────── @@ -77,9 +86,9 @@ public class CandidateScoringEngineService { Map dims = new LinkedHashMap<>(); List computable = new ArrayList<>(); String rulesVersion = e.getValue().isEmpty() - ? CandidateScoringCalculator.RULES_VERSION : e.getValue().get(0).getRulesVersion(); + ? calculator.currentRulesVersion() : e.getValue().get(0).getRulesVersion(); for (CandidateDimensionScore s : e.getValue()) { - if ("OK".equals(s.getStatus()) || "ESTIMATED".equals(s.getStatus())) { + if (("OK".equals(s.getStatus()) || "ESTIMATED".equals(s.getStatus())) && s.getScore() != null) { dims.put(s.getDimension(), s.getScore()); computable.add(s.getScore()); } @@ -94,7 +103,7 @@ public class CandidateScoringEngineService { // ── 企业只读评分卡 ─────────────────────────────────────────── - @Transactional + @Transactional(readOnly = true) public CompanyCandidateScoringResponse getCompanyScoring(Long companyUserId, Long applicationId) { Company company = companyRepository.findByOwnerUserId(companyUserId) .orElseThrow(() -> new BusinessException(ErrorCode.FORBIDDEN)); @@ -104,60 +113,67 @@ public class CandidateScoringEngineService { if (!company.getId().equals(job.getCompanyId())) { throw new BusinessException(ErrorCode.APPLICATION_OWNER_MISMATCH); } - List results = calculator.computeAll(app.getStudentUserId()); - calculator.upsertSnapshots(app.getStudentUserId(), results, yearMonth(LocalDate.now())); + LocalDateTime capturedNow = LocalDateTime.now(clock); + List results = calculator.computeAll(app.getStudentUserId(), capturedNow); List computable = results.stream() - .filter(r -> "OK".equals(r.status) || "ESTIMATED".equals(r.status)) + .filter(r -> ("OK".equals(r.status) || "ESTIMATED".equals(r.status)) && r.score != null) .toList(); BigDecimal overall = computable.isEmpty() ? null : mean(computable.stream().map(r -> r.score).toList()); - String status = overviewStatus(results); + String status = CandidateOverviewStatusPolicy.fromComputedResults(results, TOTAL_DIMENSIONS); List dims = results.stream() .map(r -> CompanyCandidateScoringResponse.CompanyDimensionItem.builder() .dimension(r.dimension).score(r.score).status(r.status).build()) .toList(); return CompanyCandidateScoringResponse.builder() .applicationId(applicationId).overallScore(overall).status(status) - .dimensions(dims).generatedAt(Instant.now()) - .rulesVersion(CandidateScoringCalculator.RULES_VERSION).build(); + .dimensions(dims).generatedAt(capturedNow.atZone(clock.getZone()).toInstant()) + .rulesVersion(calculator.currentRulesVersion()).build(); } // ── 组装 ──────────────────────────────────────────────────── private CandidateScoringOverviewResponse buildOverview(Long studentUserId, - List results) { + List results, + LocalDateTime capturedNow) { List computable = results.stream() - .filter(r -> "OK".equals(r.status) || "ESTIMATED".equals(r.status)).toList(); + .filter(r -> ("OK".equals(r.status) || "ESTIMATED".equals(r.status)) && r.score != null).toList(); BigDecimal overall = computable.isEmpty() ? null : mean(computable.stream().map(r -> r.score).toList()); Map weights = new LinkedHashMap<>(); List items = new ArrayList<>(); + List included = new ArrayList<>(); + List excluded = new ArrayList<>(); for (CandidateScoringCalculator.DimensionResult r : results) { weights.put(r.dimension, CandidateScoringCalculator.DEFAULT_WEIGHT); items.add(CandidateScoringOverviewResponse.DimensionItem.builder() .dimension(r.dimension).score(r.score).status(r.status) .weight(CandidateScoringCalculator.DEFAULT_WEIGHT).summary(r.summary).build()); + if (("OK".equals(r.status) || "ESTIMATED".equals(r.status)) && r.score != null) { + included.add(r.dimension); + } else { + excluded.add(CandidateScoringOverviewResponse.ExcludedDimension.builder() + .dimension(r.dimension).status(r.status).reason(r.summary).build()); + } } return CandidateScoringOverviewResponse.builder() - .candidateId(studentUserId).status(overviewStatus(results)).overallScore(overall) - .weights(weights).dimensions(items).rulesVersion(CandidateScoringCalculator.RULES_VERSION) - .generatedAt(Instant.now()).build(); - } - - private DimensionScoreDetailResponse toDetail(CandidateScoringCalculator.DimensionResult r) { - return DimensionScoreDetailResponse.builder() - .dimension(r.dimension).score(r.score).status(r.status) - .subScores(r.subScores).reasons(r.reasons).dataSources(r.dataSources) - .updatedAt(LocalDateTime.now()).rulesVersion(CandidateScoringCalculator.RULES_VERSION).build(); + .candidateId(studentUserId) + .status(CandidateOverviewStatusPolicy.fromComputedResults(results, TOTAL_DIMENSIONS)) + .overallScore(overall) + .weights(weights).dimensions(items).rulesVersion(calculator.currentRulesVersion()) + .generatedAt(capturedNow.atZone(clock.getZone()).toInstant()) + .explanationVersion(com.mydreamjob.candidatescore.explanation.CandidateScoringExplanationCatalog.VERSION) + .coverage(CandidateScoringOverviewResponse.Coverage.builder() + .computableDimensions(included.size()).totalDimensions(TOTAL_DIMENSIONS) + .includedDimensions(included).excludedDimensions(excluded).build()) + .comparabilityNotice("不同参与维度集合的综合分不适合直接横向比较") + .build(); } - private String overviewStatus(List results) { - long computable = results.stream() - .filter(x -> "OK".equals(x.status) || "ESTIMATED".equals(x.status)).count(); - if (computable == results.size()) return "OK"; - if (computable > 0) return "PARTIAL"; - boolean allPending = results.stream().allMatch(x -> "PENDING".equals(x.status)); - return allPending ? "PENDING" : "INSUFFICIENT_DATA"; + private DimensionScoreDetailResponse toDetail(CandidateScoringCalculator.DimensionResult r, + LocalDateTime capturedNow) { + return com.mydreamjob.candidatescore.explanation.CandidateScoringExplanationAssembler.assemble( + r, calculator.currentRulesVersion(), capturedNow); } private BigDecimal mean(List scores) { diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculator.java new file mode 100644 index 0000000..02325f7 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculator.java @@ -0,0 +1,45 @@ +package com.mydreamjob.candidatescore.dashboard; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.TreeMap; + +/** Pure O(n log n) percentile calculator preserving the dashboard's historical lower-rank formula. */ +public final class CandidatePercentileCalculator { + + private CandidatePercentileCalculator() { + } + + public static List calculate(List scores) { + Objects.requireNonNull(scores, "scores"); + List scored = scores.stream().filter(Objects::nonNull).sorted().toList(); + if (scored.size() < 2) { + return scores.stream().map(ignored -> (BigDecimal) null).toList(); + } + + Map lowerCountByScore = new TreeMap<>(); + for (int index = 0; index < scored.size(); index++) { + BigDecimal score = scored.get(index); + lowerCountByScore.putIfAbsent(score, (long) index); + } + + BigDecimal denominator = BigDecimal.valueOf(scored.size() - 1L); + List result = new ArrayList<>(scores.size()); + for (BigDecimal score : scores) { + if (score == null) { + result.add(null); + continue; + } + result.add(BigDecimal.valueOf(lowerCountByScore.get(score)) + .divide(denominator, 10, RoundingMode.HALF_UP) + .multiply(BigDecimal.valueOf(100)) + .setScale(2, RoundingMode.HALF_UP)); + } + return Collections.unmodifiableList(result); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardController.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardController.java index 79f1ecf..1f9df3c 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardController.java @@ -9,8 +9,6 @@ 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.*; /** @@ -21,14 +19,19 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class CompanyScoringDashboardController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CompanyScoringDashboardService dashboardService; @Operation(summary = "企业评分运营概览", description = "仅 COMPANY；只返回本企业数据") @GetMapping("/company/scoring/dashboard/overview") public ResponseEntity> getOverview(HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getOverview(userId), getRequestId(request))); + dashboardService.getOverview(userId), requestIdAccessor.get(request))); } @Operation(summary = "岗位评分排名", description = "仅 COMPANY；avgRating DESC, jobId DESC；审核通过评价") @@ -37,18 +40,18 @@ public class CompanyScoringDashboardController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getJobRankings(userId, page, size), getRequestId(request))); + dashboardService.getJobRankings(userId, page, size), requestIdAccessor.get(request))); } @Operation(summary = "单岗位评分排名", description = "仅 COMPANY；跨企业 403/8004") @GetMapping("/company/scoring/dashboard/job-rankings/{jobId}") public ResponseEntity> getJobRanking( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getJobRanking(userId, jobId), getRequestId(request))); + dashboardService.getJobRanking(userId, jobId), requestIdAccessor.get(request))); } @Operation(summary = "候选人评分排名", description = "仅 COMPANY；按学生去重；overallScore DESC, applicationId DESC") @@ -57,46 +60,35 @@ public class CompanyScoringDashboardController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getCandidateRankings(userId, page, size), getRequestId(request))); + dashboardService.getCandidateRankings(userId, page, size), requestIdAccessor.get(request))); } @Operation(summary = "单候选人评分排名明细", description = "仅 COMPANY；跨企业 403/8004") @GetMapping("/company/scoring/dashboard/candidate-rankings/{applicationId}") public ResponseEntity> getCandidateRanking( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getCandidateRanking(userId, applicationId), getRequestId(request))); + dashboardService.getCandidateRanking(userId, applicationId), requestIdAccessor.get(request))); } @Operation(summary = "企业评分趋势", description = "仅 COMPANY；months 1–24") @GetMapping("/company/scoring/dashboard/trend") public ResponseEntity> getTrend( @RequestParam(defaultValue = "6") int months, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getTrend(userId, months), getRequestId(request))); + dashboardService.getTrend(userId, months), requestIdAccessor.get(request))); } @Operation(summary = "全局运营概览", description = "仅 ADMIN") @GetMapping("/admin/scoring/dashboard/overview") public ResponseEntity> getAdminOverview(HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dashboardService.getAdminOverview(userId), getRequestId(request))); - } - - private Long resolveUserId() { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + dashboardService.getAdminOverview(userId), requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardService.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardService.java index b45d78d..bc2c28e 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardService.java @@ -44,6 +44,7 @@ public class CompanyScoringDashboardService { private static final String REVIEW_FILTER = "jr.status='PUBLISHED' AND jr.moderation_status IN ('AUTO_APPROVED','APPROVED')"; + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final CompanyRepository companyRepository; private final ApplicationRepository applicationRepository; private final JobService jobService; @@ -276,7 +277,7 @@ public class CompanyScoringDashboardService { @Transactional(readOnly = true) public AdminDashboardOverviewResponse getAdminOverview(Long adminUserId) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); Integer totalCompanies = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM companies", Integer.class); Integer totalJobs = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM jobs", Integer.class); Integer totalCandidates = jdbcTemplate.queryForObject( @@ -423,19 +424,10 @@ public class CompanyScoringDashboardService { } private void computePercentiles(List candidates) { - List scored = candidates.stream() - .map(c -> c.overallScore).filter(Objects::nonNull).collect(Collectors.toList()); - if (scored.size() < 2) { - candidates.forEach(c -> c.percentile = null); - return; - } - for (CandidateWithScore c : candidates) { - if (c.overallScore == null) { c.percentile = null; continue; } - long lower = scored.stream().filter(s -> s.compareTo(c.overallScore) < 0).count(); - c.percentile = BigDecimal.valueOf(lower) - .divide(BigDecimal.valueOf(scored.size() - 1), 10, RoundingMode.HALF_UP) - .multiply(BigDecimal.valueOf(100)) - .setScale(2, RoundingMode.HALF_UP); + List percentiles = CandidatePercentileCalculator.calculate( + candidates.stream().map(c -> c.overallScore).toList()); + for (int index = 0; index < candidates.size(); index++) { + candidates.get(index).percentile = percentiles.get(index); } } @@ -461,15 +453,6 @@ public class CompanyScoringDashboardService { return companyRepository.findByOwnerUserId(userId) .orElseThrow(() -> new BusinessException(ErrorCode.FORBIDDEN)); } - - private void assertAdminRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - if (user.getRoles().stream().noneMatch(r -> r == User.Role.ADMIN)) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - private void validatePage(int page, int size) { if (page < 0 || size < 1 || size > 100) { throw new BusinessException(ErrorCode.BAD_REQUEST); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/CandidateScoringOverviewResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/CandidateScoringOverviewResponse.java index c5fd232..2f7e069 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/CandidateScoringOverviewResponse.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/CandidateScoringOverviewResponse.java @@ -24,6 +24,26 @@ public class CandidateScoringOverviewResponse { private List dimensions; private String rulesVersion; private Instant generatedAt; + private String explanationVersion; + private Coverage coverage; + private String comparabilityNotice; + + @Data + @Builder + public static class Coverage { + private int computableDimensions; + private int totalDimensions; + private List includedDimensions; + private List excludedDimensions; + } + + @Data + @Builder + public static class ExcludedDimension { + private String dimension; + private String status; + private String reason; + } @Data @Builder diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/DimensionScoreDetailResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/DimensionScoreDetailResponse.java index 22fc03c..b31b009 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/DimensionScoreDetailResponse.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/dto/DimensionScoreDetailResponse.java @@ -24,6 +24,16 @@ public class DimensionScoreDetailResponse { private List dataSources; private LocalDateTime updatedAt; private String rulesVersion; + private String displayName; + private String whatItMeasures; + private String interpretation; + private List limitations; + private String evidenceLevel; + private List ruleContributions; + private List improvementActions; + private String explanationVersion; + private Validity validity; + private LocalDateTime calculatedAt; @Data @Builder @@ -41,4 +51,26 @@ public class DimensionScoreDetailResponse { private LocalDateTime time; private String note; } + + @Data + @Builder + public static class RuleContribution { + private String ruleCode; + private String outcome; + @JsonInclude(JsonInclude.Include.ALWAYS) + private BigDecimal contribution; + @JsonInclude(JsonInclude.Include.ALWAYS) + private BigDecimal maxContribution; + private String label; + private String observation; + private String explanation; + } + + @Data + @Builder + public static class Validity { + private LocalDateTime completedAt; + private LocalDateTime validUntil; + private Boolean expired; + } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationAssembler.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationAssembler.java new file mode 100644 index 0000000..bbaf24d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationAssembler.java @@ -0,0 +1,76 @@ +package com.mydreamjob.candidatescore.explanation; + +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.LocalDateTime; +import java.util.List; +import java.util.Set; + +/** 只负责把同源计算事实组装为学生白名单响应，不包含任何评分公式。 */ +public final class CandidateScoringExplanationAssembler { + private static final Set SUPPORTED_OUTCOMES = Set.of( + "APPLIED", "NOT_APPLIED", "MISSING", "EXPIRED", "UNAVAILABLE"); + + private CandidateScoringExplanationAssembler() {} + + public static DimensionScoreDetailResponse assemble(CandidateScoringCalculator.DimensionResult r, + String rulesVersion, + LocalDateTime capturedNow) { + CandidateScoringExplanationCatalog.Metadata m = CandidateScoringExplanationCatalog.metadata(r.dimension); + validateContributions(r); + List contributions = r.ruleContributions == null + ? List.of() : r.ruleContributions.stream().map(RuleContribution::toResponse).toList(); + DimensionScoreDetailResponse.Validity validity = null; + if (r.abilitySnapshotTrace != null) { + LocalDateTime until = r.abilitySnapshotTrace.validUntil(); + validity = DimensionScoreDetailResponse.Validity.builder() + .completedAt(r.abilitySnapshotTrace.completedAt()).validUntil(until) + .expired(until != null && !until.isAfter(capturedNow)).build(); + } + return DimensionScoreDetailResponse.builder() + .dimension(r.dimension).score(r.score).status(r.status) + .subScores(r.subScores).reasons(r.reasons).dataSources(r.dataSources) + .updatedAt(capturedNow).rulesVersion(rulesVersion) + .displayName(m.displayName()).whatItMeasures(m.whatItMeasures()) + .interpretation(m.interpretation()).limitations(m.limitations()) + .evidenceLevel(m.evidenceLevel()).ruleContributions(contributions) + .improvementActions(m.improvementActions()).explanationVersion(CandidateScoringExplanationCatalog.VERSION) + .validity(validity).calculatedAt(capturedNow).build(); + } + + /** + * 解释必须与真实计分事实完整对账。未知或损坏的内部规则不能被静默丢弃， + * 否则会生成“成功但贡献不等于分数”的不可信响应。异常文本固定且不回显内部值。 + */ + private static void validateContributions(CandidateScoringCalculator.DimensionResult result) { + if (result.ruleContributions == null || result.ruleContributions.isEmpty()) { + throw unsupportedContribution(); + } + for (RuleContribution contribution : result.ruleContributions) { + if (contribution == null || contribution.ruleCode() == null + || contribution.ruleCode().isBlank() + || !CandidateScoringExplanationCatalog.isKnownRuleCode(contribution.ruleCode()) + || contribution.outcome() == null + || !SUPPORTED_OUTCOMES.contains(contribution.outcome())) { + throw unsupportedContribution(); + } + } + if (result.score != null) { + BigDecimal sum = result.ruleContributions.stream() + .map(c -> c.contribution() == null ? BigDecimal.ZERO : c.contribution()) + .reduce(BigDecimal.ZERO, BigDecimal::add) + .setScale(2, RoundingMode.HALF_UP); + BigDecimal score = result.score.setScale(2, RoundingMode.HALF_UP); + if (sum.compareTo(score) != 0) { + throw unsupportedContribution(); + } + } + } + + private static IllegalStateException unsupportedContribution() { + return new IllegalStateException("candidate scoring explanation contains an unsupported rule"); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationCatalog.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationCatalog.java new file mode 100644 index 0000000..5450a5e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/CandidateScoringExplanationCatalog.java @@ -0,0 +1,68 @@ +package com.mydreamjob.candidatescore.explanation; + +import java.util.List; +import java.util.Map; + +/** 固定白名单解释元数据；不访问数据库、不计算分数、不生成动态文案。 */ +public final class CandidateScoringExplanationCatalog { + public static final String VERSION = "candidate-scoring-explanation-v1"; + private static final java.util.Set RULE_CODES = java.util.Set.of( + "EDUCATION_LEVEL", "EDUCATION_SCHOOL_TIER", "EDUCATION_MISSING", + "INTERNSHIP_SOURCE_UNAVAILABLE", + "ABILITY_FEATURE_DISABLED", "ABILITY_RESULT_MISSING", "ABILITY_RESULT_EXPIRED", + "ABILITY_RESULT_INVALID", "ABILITY_LOGIC", "ABILITY_EXECUTION", "ABILITY_LEARNING", + "ABILITY_COMMUNICATION", + "PREFERENCE_SALARY_PRESENT", "PREFERENCE_CITY_PRESENT", + "PREFERENCE_EMPLOYMENT_TYPE_PRESENT", "PREFERENCE_INDUSTRY_PRESENT", + "PREFERENCE_JOB_TYPE_PRESENT", "PREFERENCE_ALL_MISSING", + "STABILITY_BASE", "STABILITY_ACCOUNT_AGE", "STABILITY_WITHDRAWAL_RATE", + "STABILITY_RECENT_LOGIN", "STABILITY_DATA_MISSING", + "GROWTH_BASE", "GROWTH_RESUME_VERSIONS", "GROWTH_RECENT_RESUME_UPDATE", + "GROWTH_SKILL_TAGS", "GROWTH_DATA_MISSING", + "INTEGRITY_BASE", "INTEGRITY_ACCEPTED_OFFERS", "INTEGRITY_EXPIRED_OFFERS", + "INTEGRITY_FEEDBACK", "INTEGRITY_PROFILE_COMPLETENESS", "INTEGRITY_DATA_MISSING", + "ACTIVITY_APPLICATIONS", "ACTIVITY_PLATFORM_OPERATIONS", "ACTIVITY_MESSAGES", + "ACTIVITY_DATA_MISSING", "SCORE_CAP_ADJUSTMENT", "SCORE_ROUNDING_ADJUSTMENT"); + private static final Map ITEMS = Map.of( + "EDUCATION", new Metadata("教育背景信息", "个人教育资料按固定分类规则形成的背景信号", + "反映资料字段在平台分类规则下的结果", List.of("不能代表智力、实际技能或录用适合度"), "UNVALIDATED_PROXY", + List.of("完善真实教育资料", "保持资料真实准确")), + "INTERNSHIP", new Metadata("实习经历信息", "结构化实习经历数据源的可用性", + "当前平台是否具备该维度数据", List.of("数据源未接入不等于没有实习"), "DIRECT_RULE", + List.of("待平台接入结构化实习资料")), + "ABILITY", new Metadata("四维能力测评", "V36 四维能力测评的规则化聚合结果", + "反映当前自研测评规则下的聚合表现", List.of("不代表确定性工作能力或录用结论"), "UNVALIDATED_PROXY", + List.of("完成有效测评", "测评结果过期后重新测评")), + "COMPLIANCE", new Metadata("求职偏好完整度", "五类求职偏好字段的填写情况", + "反映资料完整程度，不作个人行为评价", List.of("不代表纪律性、合规意识或职业道德"), "SELF_REPORTED", + List.of("完善真实求职偏好", "保持偏好资料准确")), + "STABILITY", new Metadata("平台求职行为稳定信号", "账号时长、撤回率和近期登录形成的行为信号", + "反映平台行为规则下的稳定信号", List.of("不代表人格稳定、忠诚度或离职概率"), "UNVALIDATED_PROXY", + List.of("保持资料真实准确", "在有效期内处理 Offer")), + "GROWTH", new Metadata("简历维护与技能展示信号", "简历维护和技能标签展示情况", + "反映资料维护状态，不作个人发展结论", List.of("不代表成长潜力、学习速度或晋升能力"), "UNVALIDATED_PROXY", + List.of("核对简历和技能标签", "保持资料真实准确")), + "INTEGRITY", new Metadata("履约与资料一致性信号", "Offer 响应、反馈和资料完整度形成的行为信号", + "反映平台履约与资料一致性规则下的结果", List.of("该信号不是个人征信、信用评级、道德评价或人格判断"), "UNVALIDATED_PROXY", + List.of("及时查看并处理有效 Offer", "保持资料真实准确")), + "ACTIVITY", new Metadata("平台求职活跃度", "指定窗口内的投递、平台操作和沟通信号", + "反映平台内近期活动状态", List.of("不代表工作积极性、职业动机或职业能力"), "BEHAVIOR_PROXY", + List.of("保持资料真实准确")) + ); + + private CandidateScoringExplanationCatalog() {} + + public static Metadata metadata(String dimension) { + Metadata m = ITEMS.get(dimension); + if (m == null) throw new IllegalArgumentException("unknown scoring dimension"); + return m; + } + + public static boolean isKnownRuleCode(String ruleCode) { + return ruleCode != null && RULE_CODES.contains(ruleCode); + } + + public record Metadata(String displayName, String whatItMeasures, String interpretation, + List limitations, String evidenceLevel, + List improvementActions) {} +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/RuleContribution.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/RuleContribution.java new file mode 100644 index 0000000..0175e31 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/explanation/RuleContribution.java @@ -0,0 +1,17 @@ +package com.mydreamjob.candidatescore.explanation; + +import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; + +import java.math.BigDecimal; + +/** 由真实计分分支产生的解释事实；不访问数据库，也不重新计算分数。 */ +public record RuleContribution(String ruleCode, String outcome, BigDecimal contribution, + BigDecimal maxContribution, String label, + String observation, String explanation) { + public DimensionScoreDetailResponse.RuleContribution toResponse() { + return DimensionScoreDetailResponse.RuleContribution.builder() + .ruleCode(ruleCode).outcome(outcome).contribution(contribution) + .maxContribution(maxContribution).label(label).observation(observation) + .explanation(explanation).build(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringAppealHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringAppealHistoryRepository.java index 570362f..d3c2f17 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringAppealHistoryRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringAppealHistoryRepository.java @@ -9,4 +9,6 @@ import java.util.List; public interface CandidateScoringAppealHistoryRepository extends JpaRepository { List findByAppealIdOrderByCreatedAtAsc(Long appealId); + + List findByAppealIdInOrderByAppealIdAscCreatedAtAsc(List appealIds); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceController.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceController.java index 722bc22..2d99f29 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceController.java @@ -7,8 +7,8 @@ import com.mydreamjob.candidatescore.governance.dto.AppealResponse; import com.mydreamjob.candidatescore.governance.dto.CreateAppealRequest; import com.mydreamjob.candidatescore.governance.dto.SnapshotHistoryItem; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -16,8 +16,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.HashMap; @@ -33,14 +31,16 @@ import java.util.Map; public class CandidateScoringGovernanceController { private final CandidateScoringGovernanceService governanceService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "提交评分申诉", description = "仅 STUDENT 本人；同一学生+维度+周期 PENDING/APPROVED 唯一") @PostMapping("/profile/me/candidate-scoring/appeals") public ResponseEntity> createAppeal( @Valid @RequestBody CreateAppealRequest req, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); AppealResponse data = governanceService.createAppeal(userId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "我的申诉列表", description = "仅 STUDENT 本人") @@ -50,27 +50,27 @@ public class CandidateScoringGovernanceController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); Page result = governanceService.listMyAppeals(userId, status, page, size); - return ResponseEntity.ok(ApiResponse.ok(pageView(result), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(pageView(result), requestIdAccessor.get(request))); } @Operation(summary = "申诉详情", description = "本人或 ADMIN") @GetMapping("/profile/me/candidate-scoring/appeals/{appealId}") public ResponseEntity> getAppeal( @PathVariable Long appealId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); AppealResponse data = governanceService.getAppeal(userId, appealId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "撤销申诉", description = "仅本人；仅 PENDING 可撤销") @PostMapping("/profile/me/candidate-scoring/appeals/{appealId}/cancel") public ResponseEntity> cancelAppeal( @PathVariable Long appealId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); AppealResponse data = governanceService.cancelAppeal(userId, appealId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "全部申诉列表", description = "仅 ADMIN") @@ -80,9 +80,9 @@ public class CandidateScoringGovernanceController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); Page result = governanceService.listAllAppeals(userId, status, page, size); - return ResponseEntity.ok(ApiResponse.ok(pageView(result), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(pageView(result), requestIdAccessor.get(request))); } @Operation(summary = "审核决定", description = "仅 ADMIN；APPROVE/REJECT，REJECT 必须填 reason") @@ -90,27 +90,27 @@ public class CandidateScoringGovernanceController { public ResponseEntity> decideAppeal( @PathVariable Long appealId, @Valid @RequestBody AppealDecisionRequest req, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); AppealResponse data = governanceService.decideAppeal(userId, appealId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "执行回滚", description = "仅 ADMIN；记录前态+确定性重算+新版本；年 3 次上限") @PostMapping("/admin/candidate-scoring/appeals/{appealId}/rollback") public ResponseEntity> rollbackAppeal( @PathVariable Long appealId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); AppealResponse data = governanceService.rollbackAppeal(userId, appealId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "申诉历史", description = "本人（脱敏，无 actorUserId）或 ADMIN（全量）；此路径的本人放行先于 ADMIN 通用规则") @GetMapping("/admin/candidate-scoring/appeals/{appealId}/history") public ResponseEntity>> getAppealHistory( @PathVariable Long appealId, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); List data = governanceService.getAppealHistory(userId, appealId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "快照变更审计", description = "仅 ADMIN；按学生+维度+周期查看回滚前后完整变化") @@ -120,10 +120,10 @@ public class CandidateScoringGovernanceController { @PathVariable String dimension, @PathVariable String period, HttpServletRequest request) { - Long userId = resolveUserId(); + Long userId = currentUserAccessor.requireUserId(); List data = governanceService.getSnapshotHistory( userId, candidateUserId, dimension, period); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 辅助 ──────────────────────────────────────────────────── @@ -138,15 +138,4 @@ public class CandidateScoringGovernanceController { return data; } - private Long resolveUserId() { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceService.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceService.java index d05159e..627e63e 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceService.java @@ -14,6 +14,7 @@ import jakarta.persistence.EntityManager; import jakarta.persistence.PersistenceContext; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Autowired; import org.springframework.dao.DataIntegrityViolationException; import org.springframework.dao.OptimisticLockingFailureException; import org.springframework.data.domain.Page; @@ -22,7 +23,7 @@ import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; -import java.time.Year; +import java.time.Clock; import java.util.List; import java.util.Optional; import java.util.regex.Pattern; @@ -40,6 +41,7 @@ public class CandidateScoringGovernanceService { public static final int MAX_ROLLBACK_PER_YEAR = 3; private static final Pattern PERIOD_PATTERN = Pattern.compile("^\\d{4}-(0[1-9]|1[0-2])$"); + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final CandidateScoringAppealRepository appealRepository; private final CandidateScoringAppealHistoryRepository appealHistoryRepository; private final CandidateScoringSnapshotHistoryRepository snapshotHistoryRepository; @@ -49,27 +51,18 @@ public class CandidateScoringGovernanceService { private final UserRepository userRepository; private final AuditService auditService; - @PersistenceContext - private EntityManager entityManager; - - // ── 角色校验 ──────────────────────────────────────────────── + /** 与评分计算器一致的可注入时间源，保证一次回滚重算使用同一 capturedNow。 */ + private Clock clock = Clock.systemDefaultZone(); - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - if (user.getRoles().stream().noneMatch(r -> r == User.Role.STUDENT)) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + @Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; } - private void assertAdminRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - if (user.getRoles().stream().noneMatch(r -> r == User.Role.ADMIN)) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } + @PersistenceContext + private EntityManager entityManager; + // ── 角色校验 ──────────────────────────────────────────────── private boolean isAdmin(Long userId) { return userRepository.findById(userId) .map(u -> u.getRoles().stream().anyMatch(r -> r == User.Role.ADMIN)) @@ -80,7 +73,7 @@ public class CandidateScoringGovernanceService { @Transactional public AppealResponse createAppeal(Long studentUserId, CreateAppealRequest req, AuditContext ctx) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); if (!CandidateScoringCalculator.isValidDimension(req.getDimension())) { throw new BusinessException(ErrorCode.BAD_REQUEST, "invalid dimension: " + req.getDimension()); } @@ -117,7 +110,7 @@ public class CandidateScoringGovernanceService { CandidateScoringAppeal appeal = CandidateScoringAppeal.builder() .candidateUserId(studentUserId).dimension(req.getDimension()).period(req.getPeriod()) .status(CandidateScoringAppeal.STATUS_PENDING).reason(req.getReason().trim()) - .rulesVersion(CandidateScoringCalculator.RULES_VERSION) + .rulesVersion(calculator.currentRulesVersion()) .idempotencyKey(req.getIdempotencyKey()) .activeKey(activeKey) .scoreAtAppeal(snap != null ? snap.getScore() : null) @@ -149,7 +142,7 @@ public class CandidateScoringGovernanceService { // ── 我的申诉列表 ──────────────────────────────────────────── public Page listMyAppeals(Long studentUserId, String status, int page, int size) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); validatePage(page, size); PageRequest pr = PageRequest.of(page, size); Page p = (status != null && !status.isBlank()) @@ -173,7 +166,7 @@ public class CandidateScoringGovernanceService { @Transactional public AppealResponse cancelAppeal(Long studentUserId, Long appealId, AuditContext ctx) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); CandidateScoringAppeal appeal = requireAppeal(appealId); if (!appeal.getCandidateUserId().equals(studentUserId)) { throw new BusinessException(ErrorCode.FORBIDDEN); @@ -195,7 +188,7 @@ public class CandidateScoringGovernanceService { // ── 全部申诉列表（ADMIN） ─────────────────────────────────── public Page listAllAppeals(Long adminUserId, String status, int page, int size) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); validatePage(page, size); PageRequest pr = PageRequest.of(page, size); Page p = (status != null && !status.isBlank()) @@ -208,7 +201,7 @@ public class CandidateScoringGovernanceService { @Transactional public AppealResponse decideAppeal(Long adminUserId, Long appealId, AppealDecisionRequest req, AuditContext ctx) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); CandidateScoringAppeal appeal = requireAppeal(appealId); String target = req.getDecision(); if (!"APPROVE".equals(target) && !"REJECT".equals(target)) { @@ -252,7 +245,7 @@ public class CandidateScoringGovernanceService { @Transactional public AppealResponse rollbackAppeal(Long adminUserId, Long appealId, AuditContext ctx) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); CandidateScoringAppeal appeal = requireAppeal(appealId); if (CandidateScoringAppeal.STATUS_ROLLED_BACK.equals(appeal.getStatus())) { return toView(appeal, true); // 幂等，不重复写历史 @@ -261,7 +254,8 @@ public class CandidateScoringGovernanceService { throw new BusinessException(ErrorCode.APPEAL_INVALID_TRANSITION); } Long candidateId = appeal.getCandidateUserId(); - int year = Year.now().getValue(); + LocalDateTime capturedNow = LocalDateTime.now(clock); + int year = capturedNow.getYear(); // 并发安全：确保 rollback_limits 行存在（INSERT IGNORE 不抛唯一冲突），再悲观锁串行化 entityManager.createNativeQuery( @@ -282,7 +276,7 @@ public class CandidateScoringGovernanceService { // 按当前数据确定性重算并写新版本 CandidateScoringCalculator.DimensionResult after = calculator.recomputeAndSnapshot( - candidateId, appeal.getDimension(), appeal.getPeriod()); + candidateId, appeal.getDimension(), appeal.getPeriod(), capturedNow); // 原生 upsert 固定 version=version+1：afterVersion 确定性计算（避免读取持久化上下文旧值） Long afterVersion = before != null ? before.getVersion() + 1 : 0L; @@ -294,12 +288,12 @@ public class CandidateScoringGovernanceService { .beforeVersion(before != null ? before.getVersion() : null) .afterVersion(afterVersion) .beforeRulesVersion(before != null ? before.getRulesVersion() : null) - .afterRulesVersion(CandidateScoringCalculator.RULES_VERSION) + .afterRulesVersion(calculator.currentRulesVersion()) .build()); String from = appeal.getStatus(); appeal.setStatus(CandidateScoringAppeal.STATUS_ROLLED_BACK); - appeal.setRollbackAt(LocalDateTime.now()); + appeal.setRollbackAt(capturedNow); appeal.setActiveKey(null); // 终态清空 active_key appealRepository.save(appeal); recordHistory(appeal.getId(), from, CandidateScoringAppeal.STATUS_ROLLED_BACK, @@ -333,7 +327,7 @@ public class CandidateScoringGovernanceService { public List getSnapshotHistory(Long adminUserId, Long candidateUserId, String dimension, String period) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); return snapshotHistoryRepository .findByCandidateUserIdAndDimensionAndPeriodOrderByCreatedAtAsc(candidateUserId, dimension, period) .stream().map(s -> SnapshotHistoryItem.builder() diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshCompensationScanner.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshCompensationScanner.java new file mode 100644 index 0000000..5e38be4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshCompensationScanner.java @@ -0,0 +1,101 @@ +package com.mydreamjob.candidatescore.refresh; + +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Clock; +import java.time.LocalDateTime; +import java.util.List; + +/** + * R01-D4-1 补偿扫描（基础版）。 + * + *

仅登记刷新任务，不直接写快照：分页（LIMIT 固定预算）扫描近期有评分输入活动的学生， + * 统一调用 {@link CandidateScoringRefreshRequestService#requestRefresh}（任务唯一键自动合并）。 + * 用于覆盖无业务写入但评分自然变化的时间窗口（近 90 天投递窗口、近 30 天审计窗口、 + * 能力测评有效期、rulesVersion 切换），由定时调度触发。

+ * + *

查询预算：本扫描 = 1 次聚合查询 + ≤limit 次登记 upsert；不逐用户 N+1。

+ */ +@Slf4j +@Component +@RequiredArgsConstructor +public class CandidateScoringRefreshCompensationScanner { + + static final String ACTIVE_STUDENTS_SCAN = "ACTIVE_STUDENTS"; + + private final JdbcTemplate jdbcTemplate; + private final CandidateScoringRefreshRequestService requestService; + private Clock clock = Clock.systemDefaultZone(); + + @org.springframework.beans.factory.annotation.Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; + } + + /** + * 返回本轮登记的学生数。游标与任务登记在同一事务中提交：失败时二者一起回滚， + * 多实例通过 checkpoint 行的 FOR UPDATE 串行推进，同一轮最多处理 {@code limit} 人。 + */ + @Transactional + public int scanDueStudents(int limit) { + LocalDateTime now = LocalDateTime.now(clock); + LocalDateTime appsSince = now.minusDays(90); + LocalDateTime auditSince = now.minusDays(30); + int budget = Math.max(1, Math.min(limit, 500)); + ensureCheckpoint(); + long cursor = lockCursor(); + List ids = findEligibleAfter(cursor, appsSince, auditSince, budget); + if (ids.isEmpty() && cursor > 0L) { + cursor = 0L; + ids = findEligibleAfter(cursor, appsSince, auditSince, budget); + } + for (Long studentId : ids) { + requestService.requestRefresh(studentId, now); + } + long nextCursor = ids.size() < budget || ids.isEmpty() ? 0L : ids.get(ids.size() - 1); + jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_scan_checkpoints + SET last_user_id=?, version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE scan_key=? + """, nextCursor, ACTIVE_STUDENTS_SCAN); + log.debug("compensation scan registered {} students (budget {}, next cursor {})", + ids.size(), budget, nextCursor); + return ids.size(); + } + + private void ensureCheckpoint() { + jdbcTemplate.update(""" + INSERT INTO candidate_scoring_refresh_scan_checkpoints + (scan_key, last_user_id, version, updated_at) + VALUES (?, 0, 0, CURRENT_TIMESTAMP) + ON DUPLICATE KEY UPDATE scan_key=scan_key + """, ACTIVE_STUDENTS_SCAN); + } + + private long lockCursor() { + Long cursor = jdbcTemplate.queryForObject(""" + SELECT last_user_id FROM candidate_scoring_refresh_scan_checkpoints + WHERE scan_key=? FOR UPDATE + """, Long.class, ACTIVE_STUDENTS_SCAN); + return cursor == null ? 0L : cursor; + } + + private List findEligibleAfter(long cursor, LocalDateTime appsSince, + LocalDateTime auditSince, int budget) { + return jdbcTemplate.query(""" + SELECT DISTINCT u.id + FROM users u + WHERE u.id > ? AND u.role = 'STUDENT' AND u.is_active = 1 + AND (EXISTS (SELECT 1 FROM applications a + WHERE a.student_user_id = u.id AND a.created_at >= ?) + OR EXISTS (SELECT 1 FROM audit_logs al + WHERE al.user_id = u.id AND al.created_at >= ?)) + ORDER BY u.id + LIMIT ? + """, (rs, i) -> rs.getLong(1), cursor, appsSince, auditSince, budget); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshRequestService.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshRequestService.java new file mode 100644 index 0000000..5d3d783 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshRequestService.java @@ -0,0 +1,81 @@ +package com.mydreamjob.candidatescore.refresh; + +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDate; +import java.time.LocalDateTime; + +/** + * R01-D4-1 评分快照刷新任务登记组件。 + * + *

职责仅限"登记"：把某个学生当前周期的物化请求合并进任务表。 + * 使用原生参数化 upsert 维护 {@code uk_refresh_task_student_period} 唯一性：

+ *
    + *
  • 同学生同周期重复登记：不新增行，更新 {@code requested_at}；
    • + *
  • 任务 COMPLETED/FAILED：重新打开为 PENDING，attempts 归零；
    • + *
  • 任务 PROCESSING：保留 PROCESSING（不覆盖），推进 requested_at， + * Worker 完成时若 {@code requested_at} 晚于 {@code processing_started_at} 则回到 PENDING；
    • + *
  • 任务 RETRY：回到 PENDING（保留 attempts，不重复计分重试次数）。
    • + *
+ * + *

登记会加入调用方现有业务事务（默认 REQUIRED）：源业务提交失败时，登记一并回滚； + * 登记本身不触发任何线程内评分计算、不发送 RabbitMQ、不写成功审计、不记录敏感值。

+ */ +@Slf4j +@Service +@RequiredArgsConstructor +public class CandidateScoringRefreshRequestService { + + private final JdbcTemplate jdbcTemplate; + + /** + * 登记当前周期的一次刷新（period = capturedNow 所在 yyyy-MM）。 + * + * @param studentUserId 学生用户 ID；null 直接忽略 + * @param capturedNow 请求捕获时间（本方法内部只读取一次） + */ + @Transactional(propagation = Propagation.REQUIRED) + public void requestRefresh(Long studentUserId, LocalDateTime capturedNow) { + if (studentUserId == null || capturedNow == null) { + return; + } + String period = String.format("%04d-%02d", + capturedNow.getYear(), capturedNow.getMonthValue()); + jdbcTemplate.update(""" + INSERT INTO candidate_scoring_refresh_tasks + (student_user_id, target_period, status, requested_at, attempts, version, created_at, updated_at) + VALUES (?, ?, 'PENDING', ?, 0, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP) + ON DUPLICATE KEY UPDATE + requested_at = GREATEST(requested_at, VALUES(requested_at)), + attempts = CASE + WHEN status IN ('COMPLETED', 'FAILED') THEN 0 + ELSE attempts + END, + last_error_code = CASE + WHEN status = 'PROCESSING' THEN last_error_code + ELSE NULL + END, + next_attempt_at = CASE + WHEN status = 'PROCESSING' THEN next_attempt_at + ELSE NULL + END, + status = CASE + WHEN status = 'PROCESSING' THEN status + ELSE 'PENDING' + END, + version = version + 1, + updated_at = CURRENT_TIMESTAMP + """, + studentUserId, period, capturedNow); + } + + public String periodOf(LocalDateTime capturedNow) { + LocalDate d = capturedNow.toLocalDate(); + return String.format("%04d-%02d", d.getYear(), d.getMonthValue()); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshScheduler.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshScheduler.java new file mode 100644 index 0000000..889b8d9 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshScheduler.java @@ -0,0 +1,77 @@ +package com.mydreamjob.candidatescore.refresh; + +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.scheduling.annotation.Scheduled; +import org.springframework.stereotype.Component; + +import java.time.Clock; +import java.time.LocalDateTime; + +/** + * R01-D4-1 定时调度：Worker 领取刷新 + 补偿扫描。 + * + *

默认关闭（{@code app.scoring.refresh.enabled=false}），生产启用时负责周期驱动； + * 测试一律直接调用 Worker/Scanner，不依赖真实等待。调度不发送 RabbitMQ、不写通知。

+ */ +@Slf4j +@Component +@RequiredArgsConstructor +public class CandidateScoringRefreshScheduler { + + private final CandidateScoringRefreshWorker worker; + private final CandidateScoringRefreshCompensationScanner compensationScanner; + private Clock clock = Clock.systemDefaultZone(); + + @Value("${app.scoring.refresh.enabled:false}") + private boolean enabled; + + @Value("${app.scoring.refresh.compensation-enabled:false}") + private boolean compensationEnabled; + + @Value("${app.scoring.refresh.batch-size:20}") + private int batchSize; + + @Value("${app.scoring.refresh.compensation-limit:100}") + private int compensationLimit; + + @org.springframework.beans.factory.annotation.Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; + } + + @Scheduled(fixedDelayString = "${app.scoring.refresh.worker-interval-ms:60000}") + public void workerTick() { + if (!enabled) { + return; + } + try { + int processed = worker.processDue(batchSize); + if (processed > 0) { + log.debug("scoring refresh worker processed {} tasks", processed); + } + } catch (Exception e) { + // 调度兜底：单轮失败只告警，不影响后续轮次；具体任务失败在 Worker 内已分类登记。 + log.warn("scoring refresh worker tick failed: {}", e.getClass().getSimpleName()); + } + } + + @Scheduled(fixedDelayString = "${app.scoring.refresh.compensation-interval-ms:3600000}") + public void compensationTick() { + if (!enabled || !compensationEnabled) { + return; + } + try { + int registered = compensationScanner.scanDueStudents(compensationLimit); + log.debug("compensation scan registered {} students", registered); + } catch (Exception e) { + log.warn("compensation scan tick failed: {}", e.getClass().getSimpleName()); + } + } + + /** 测试用：暴露当前时钟时刻（无副作用）。 */ + LocalDateTime nowForTest() { + return LocalDateTime.now(clock); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTask.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTask.java new file mode 100644 index 0000000..7537a5d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTask.java @@ -0,0 +1,102 @@ +package com.mydreamjob.candidatescore.refresh; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import jakarta.persistence.Version; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * R01-D4-1 评分快照刷新任务（持久化物化登记）。 + * + *

同一学生同一周期只有一条任务（{@code uk_refresh_task_student_period}）； + * 状态机：PENDING → PROCESSING → COMPLETED / RETRY → (…) → FAILED。 + * PROCESSING 期间的新请求通过 {@code requested_at} 推进保留，Worker 完成时 + * 若 {@code requested_at} 晚于 {@code processing_started_at} 则回到 PENDING。

+ */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "candidate_scoring_refresh_tasks", + uniqueConstraints = @UniqueConstraint(name = "uk_refresh_task_student_period", + columnNames = {"student_user_id", "target_period"})) +@EntityListeners(AuditingEntityListener.class) +public class CandidateScoringRefreshTask { + + public static final String STATUS_PENDING = "PENDING"; + public static final String STATUS_PROCESSING = "PROCESSING"; + public static final String STATUS_RETRY = "RETRY"; + public static final String STATUS_COMPLETED = "COMPLETED"; + public static final String STATUS_FAILED = "FAILED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "student_user_id", nullable = false) + private Long studentUserId; + + /** yyyy-MM */ + @Column(name = "target_period", nullable = false, length = 7) + private String targetPeriod; + + @Column(name = "status", nullable = false, length = 20) + @Builder.Default + private String status = STATUS_PENDING; + + @Column(name = "requested_at", nullable = false) + private LocalDateTime requestedAt; + + /** 仅用于超时扫描与观测；秒级精度不足以作为所有权证明。 */ + @Column(name = "processing_started_at") + private LocalDateTime processingStartedAt; + + /** + * R01-D4-2 claim fence：本次领取的不可复用令牌（UUID）。 + * 每次成功领取写入新值，进入 COMPLETED/PENDING/RETRY/FAILED 时清空。 + */ + @Column(name = "claim_token", length = 36) + private String claimToken; + + @Column(name = "processed_at") + private LocalDateTime processedAt; + + @Column(name = "next_attempt_at") + private LocalDateTime nextAttemptAt; + + @Column(name = "attempts", nullable = false) + @Builder.Default + private Integer attempts = 0; + + /** 固定错误分类（如 COMPUTE_FAILED / WRITE_FAILED），不保存异常原文、SQL、手机号或堆栈。 */ + @Column(name = "last_error_code", length = 40) + private String lastErrorCode; + + @Version + @Column(name = "version", nullable = false) + @Builder.Default + private Long version = 0L; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java new file mode 100644 index 0000000..1b6a62f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshTaskExecutor.java @@ -0,0 +1,153 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import lombok.RequiredArgsConstructor; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * 单任务事务执行器。领取、评分写入、失败状态分别使用独立事务，避免批次共享事务， + * 也避免捕获数据库异常后在 rollback-only 事务中记录 RETRY。 + */ +@Component +@RequiredArgsConstructor +public class CandidateScoringRefreshTaskExecutor { + + private final JdbcTemplate jdbcTemplate; + private final CandidateScoringCalculator calculator; + private final CandidateScoringSnapshotWriter writer; + + /** + * 回收因进程退出而遗留的 PROCESSING 租约。恢复与领取分属独立事务，任何实例均可执行； + * 条件更新保证同一行只会被一次恢复。失败次数达到上限时进入 FAILED，避免永久热循环。 + */ + @Transactional(propagation = Propagation.REQUIRES_NEW) + public int recoverStale(LocalDateTime staleBefore, LocalDateTime now, int maxAttempts) { + return jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_tasks + SET status=CASE WHEN attempts+1 >= ? THEN 'FAILED' ELSE 'RETRY' END, + next_attempt_at=NULL, + attempts=attempts+1, + last_error_code='WORKER_TIMEOUT', + processing_started_at=NULL, + claim_token=NULL, + version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE status='PROCESSING' AND processing_started_at < ? + """, maxAttempts, staleBefore); + } + + /** + * 领取任务。 + * + *

每次成功领取都生成一个全新的随机 UUID 作为所有权令牌（claim token）， + * 在领取 SQL 中原子写入。令牌不可复用、与时间无关，因此不受 + * {@code processing_started_at} 秒级精度影响。

+ */ + @Transactional(propagation = Propagation.REQUIRES_NEW) + public ClaimedTask claim(Long taskId, LocalDateTime now) { + String claimToken = java.util.UUID.randomUUID().toString(); + int updated = jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_tasks + SET status='PROCESSING', processing_started_at=?, claim_token=?, + version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE id=? AND status IN ('PENDING','RETRY') + AND (next_attempt_at IS NULL OR next_attempt_at <= ?) + """, now, claimToken, taskId, now); + if (updated != 1) { + return null; + } + return jdbcTemplate.query(""" + SELECT id, student_user_id, target_period, processing_started_at, claim_token, version + FROM candidate_scoring_refresh_tasks WHERE id=? + """, (rs, i) -> new ClaimedTask( + rs.getLong("id"), rs.getLong("student_user_id"), + rs.getString("target_period"), + rs.getObject("processing_started_at", LocalDateTime.class), + rs.getString("claim_token"), + rs.getLong("version")), taskId) + .stream().findFirst().orElse(null); + } + + @Transactional(propagation = Propagation.REQUIRES_NEW) + public void materialize(ClaimedTask task, LocalDateTime capturedNow) { + List results = + calculator.computeAll(task.studentUserId(), capturedNow); + writer.upsertIfChanged(task.studentUserId(), results, task.targetPeriod(), capturedNow, + calculator.currentRulesVersion()); + + // 所有权闸门（claim fence）：claim_token 是本次领取写入的不可复用令牌， + // 只有它仍与领取时一致，才说明任务仍由本次领取持有。 + // version 额外参与 COMPLETED 判定：处理期间的新请求会推进 version， + // 此时应回到 PENDING 再算一次（而不是错误地置为 COMPLETED）。 + int completed = jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_tasks + SET status='COMPLETED', processing_started_at=NULL, claim_token=NULL, processed_at=?, + last_error_code=NULL, next_attempt_at=NULL, + version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE id=? AND status='PROCESSING' AND claim_token=? AND version=? + """, capturedNow, task.id(), task.claimToken(), task.claimedVersion()); + if (completed == 1) { + return; + } + + // 同一 claim 期间有新请求推进 version → 回到 PENDING；闸门仍校验所有权令牌， + // 因此已被其他 Worker 重新领取时不会误改新持有者的状态。 + int pending = jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_tasks + SET status='PENDING', processing_started_at=NULL, claim_token=NULL, processed_at=?, + next_attempt_at=NULL, version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE id=? AND status='PROCESSING' AND claim_token=? + """, capturedNow, task.id(), task.claimToken()); + if (pending == 0) { + // stale claim：任务已被租约回收并由其他 Worker 重新领取。 + // 安静退出，绝不覆盖新持有者的状态（这不是系统异常）。 + return; + } + } + + /** + * 记录失败并安排重试/终止。 + * + *

所有权闸门：只有 {@code claim_token} 仍等于本次领取写入的令牌时才更新。 + * 更新 0 行表示本次领取已失效（任务被租约回收并由其他 Worker 持有）—— + * 这属于正常竞争，安静退出而不是抛异常，以免中断同批其余任务。

+ * + * @param claimToken 本次领取的不可复用令牌 + */ + @Transactional(propagation = Propagation.REQUIRES_NEW) + public void recordFailure(Long taskId, String category, LocalDateTime now, + int maxAttempts, long retryBackoffMs, String claimToken) { + LocalDateTime nextAttempt = now.plusNanos(Math.max(1L, retryBackoffMs) * 1_000_000L); + int updated = jdbcTemplate.update(""" + UPDATE candidate_scoring_refresh_tasks + SET status=CASE WHEN attempts+1 >= ? THEN 'FAILED' ELSE 'RETRY' END, + next_attempt_at=CASE WHEN attempts+1 >= ? THEN NULL ELSE ? END, + attempts=attempts+1, + last_error_code=?, + processing_started_at=NULL, + claim_token=NULL, + version=version+1, updated_at=CURRENT_TIMESTAMP + WHERE id=? AND status='PROCESSING' AND claim_token=? + """, maxAttempts, maxAttempts, nextAttempt, category, taskId, claimToken); + if (updated != 1) { + // stale claim：不覆盖新持有者，也不视为系统异常。 + return; + } + } + + /** + * 领取结果。 + * + * @param claimedAt 领取时写入 processing_started_at 的值 —— 仅用于超时扫描与观测， + * 不再承担所有权证明（秒级精度不足以区分同秒内的两次领取） + * @param claimToken 本次领取的不可复用所有权令牌（UUID），所有终态更新都必须携带它 + */ + public record ClaimedTask(Long id, Long studentUserId, String targetPeriod, + LocalDateTime claimedAt, String claimToken, long claimedVersion) { + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorker.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorker.java new file mode 100644 index 0000000..aa84c4b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorker.java @@ -0,0 +1,117 @@ +package com.mydreamjob.candidatescore.refresh; + +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; + +import java.time.Clock; +import java.time.Duration; +import java.time.LocalDateTime; +import java.util.List; + +/** + * R01-D4-1 评分快照刷新 Worker。 + * + *

并发模型：数据库条件更新领取——{@code claim} 只在 + * {@code status IN ('PENDING','RETRY') AND next_attempt_at 到期} 时把行置为 PROCESSING， + * 第二个 Worker 对同一任务 claim 更新 0 行（略过），因此同一任务并发只能有一个有效处理者； + * 不使用 synchronized/ReentrantLock/Thread.sleep。

+ * + *

失败语义：捕获并转为固定错误分类（COMPUTE_FAILED/WRITE_FAILED/UNKNOWN_REFRESH_FAILURE）， + * attempts+1 进入 RETRY、设置 next_attempt_at；超过最大次数进入 FAILED（定时补偿仍可重新登记）。 + * 异常不回抛，不中断其他任务；{@code last_error_code} 不保存异常原文、SQL、手机号或堆栈。

+ * + *

普通刷新不写审计（规避 刷新→审计→审计触发刷新 的循环）；处理不发送 RabbitMQ、 + * 不写 notification、不写 snapshot_history。

+ */ +@Slf4j +@Component +@RequiredArgsConstructor +public class CandidateScoringRefreshWorker { + + public static final int DEFAULT_MAX_ATTEMPTS = 3; + public static final int DEFAULT_BATCH_SIZE = 20; + + private final JdbcTemplate jdbcTemplate; + private final CandidateScoringRefreshTaskExecutor taskExecutor; + private Clock clock = Clock.systemDefaultZone(); + + @Value("${app.scoring.refresh.max-attempts:3}") + private int maxAttempts = DEFAULT_MAX_ATTEMPTS; + + @Value("${app.scoring.refresh.processing-timeout-ms:600000}") + private long processingTimeoutMs; + + @org.springframework.beans.factory.annotation.Autowired(required = false) + public void setClock(Clock clock) { + if (clock != null) this.clock = clock; + } + + /** 领取一批到期任务并逐个处理；返回处理数。 */ + public int processDue(int batchSize) { + LocalDateTime now = LocalDateTime.now(clock); + long timeoutMs = processingTimeoutMs <= 0 ? 600_000L : processingTimeoutMs; + taskExecutor.recoverStale(now.minus(Duration.ofMillis(timeoutMs)), now, + Math.max(1, maxAttempts)); + List due = jdbcTemplate.queryForList( + "SELECT id FROM candidate_scoring_refresh_tasks " + + "WHERE status IN ('PENDING','RETRY') AND (next_attempt_at IS NULL OR next_attempt_at <= ?) " + + "ORDER BY id LIMIT ?", Long.class, now, batchSize); + int processed = 0; + for (Long id : due) { + try { + if (processOne(id, LocalDateTime.now(clock))) { + processed++; + } + } catch (Exception e) { + // 单任务异常不得阻断同批其余任务；具体分类已在 processOne 内登记。 + log.warn("refresh task processing aborted: taskId={}, cause={}", + id, e.getClass().getSimpleName()); + } + } + return processed; + } + + /** 处理单条任务；领取失败（被并发 Worker 领取）直接返回 false。 */ + public boolean processOne(Long taskId, LocalDateTime capturedNow) { + CandidateScoringRefreshTaskExecutor.ClaimedTask task = taskExecutor.claim(taskId, capturedNow); + if (task == null) { + return false; + } + try { + taskExecutor.materialize(task, capturedNow); + return true; + } catch (Exception e) { + String category = classify(e); + log.warn("refresh task failed: taskId={}, category={}", taskId, category); + try { + taskExecutor.recordFailure(taskId, category, capturedNow, + Math.max(1, maxAttempts), nextBackoffMs(), task.claimToken()); + } catch (Exception inner) { + // 失败登记本身出问题也不得吞掉整个批次；本轮不改状态，由租约超时兜底恢复。 + log.warn("refresh task failure recording skipped: taskId={}, cause={}", + taskId, inner.getClass().getSimpleName()); + } + return false; + } + } + + @Value("${app.scoring.refresh.retry-backoff-ms:300000}") + private long retryBackoffMs; + + private long nextBackoffMs() { + return retryBackoffMs <= 0 ? 300_000L : retryBackoffMs; + } + + private String classify(Throwable t) { + if (t instanceof org.springframework.dao.DataAccessException) { + return "WRITE_FAILED"; + } + if (t instanceof com.mydreamjob.common.exception.BusinessException) { + return "COMPUTE_FAILED"; + } + return "UNKNOWN_REFRESH_FAILURE"; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringSnapshotWriter.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringSnapshotWriter.java new file mode 100644 index 0000000..1ff32fd --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/refresh/CandidateScoringSnapshotWriter.java @@ -0,0 +1,224 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; + +/** + * R01-D4-1 唯一快照 Writer：集中写入 {@code candidate_dimension_scores}。 + * + *

两种写入模式：

+ *
    + *
  • {@link #upsertIfChanged}:普通物化——score/status/sub_scores_json/weight/rules_version + * 完全相同时不改写 version 与 updated_at（幂等）；任一业务字段变化或 rulesVersion + * 变化才 {@code version+1}；{@code calculated_at} 不单独触发 version 增长。
    • + *
  • {@link #upsertForcingVersion}:Governance 申诉决定/回滚的强制版本推进路径—— + * 每次无条件 version+1，保持 {@code GovernanceService} 的 + * {@code afterVersion = beforeVersion + 1} 与历史审计语义不变。
    • + *
+ * + *

sub_scores_json 写入前做 canonical 化（字段按字典序重排），避免字段顺序制造伪变化。 + * 不依赖 JVM 锁：唯一键 + 条件更新保证并发安全；MySQL 与 H2（MODE=MySQL）都应通过。

+ */ +@Component +@RequiredArgsConstructor +public class CandidateScoringSnapshotWriter { + + public static final BigDecimal DEFAULT_WEIGHT = new BigDecimal("12.50"); + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private final JdbcTemplate jdbcTemplate; + + /** + * 普通物化：值变化才推进 version。 + * + * @param rulesVersion 当前规则版本（由调用方 {@code Calculator#currentRulesVersion()} 提供） + */ + @Transactional + public void upsertIfChanged(Long studentUserId, List results, + String period, java.time.LocalDateTime capturedNow, String rulesVersion) { + if (results == null || results.isEmpty() || studentUserId == null) { + return; + } + for (CandidateScoringCalculator.DimensionResult r : results) { + upsertRow(studentUserId, r, period, capturedNow, rulesVersion, false); + } + } + + /** + * 单条强制版本推进（Governance 申诉决定/回滚专用）。 + */ + @Transactional + public void upsertForcingVersion(Long studentUserId, CandidateScoringCalculator.DimensionResult r, + String period, java.time.LocalDateTime capturedNow, String rulesVersion) { + upsertRow(studentUserId, r, period, capturedNow, rulesVersion, true); + } + + private void upsertRow(Long studentUserId, CandidateScoringCalculator.DimensionResult r, + String period, java.time.LocalDateTime capturedNow, + String rulesVersion, boolean forceVersion) { + String json = canonicalJson(subScoresPayload(r)); + if (forceVersion) { + jdbcTemplate.update(""" + INSERT INTO candidate_dimension_scores + (student_user_id, dimension, period, score, status, sub_scores_json, + weight, rules_version, calculated_at, version, created_at, updated_at) + VALUES (?,?,?,?,?,?,?,?,?,0,NOW(),NOW()) + ON DUPLICATE KEY UPDATE + score=?, status=?, sub_scores_json=?, weight=?, rules_version=?, calculated_at=?, + version=version+1, updated_at=NOW() + """, studentUserId, r.dimension, period, r.score, r.status, json, + DEFAULT_WEIGHT, rulesVersion, capturedNow, + r.score, r.status, json, DEFAULT_WEIGHT, rulesVersion, capturedNow); + return; + } + // 先做并发安全的“若不存在则插入”。冲突时只做主键自赋值，不覆盖业务字段， + // 随后的锁定读负责比较旧值；避免先 SELECT 后 INSERT 的首次物化竞争。 + jdbcTemplate.update(""" + INSERT INTO candidate_dimension_scores + (student_user_id, dimension, period, score, status, sub_scores_json, + weight, rules_version, calculated_at, version, created_at, updated_at) + VALUES (?,?,?,?,?,?,?,?,?,0,NOW(),NOW()) + ON DUPLICATE KEY UPDATE id=id + """, studentUserId, r.dimension, period, r.score, r.status, json, + DEFAULT_WEIGHT, rulesVersion, capturedNow); + ExistingRow existing = findForUpdate(studentUserId, r.dimension, period); + if (existing == null) { + throw new org.springframework.dao.DataIntegrityViolationException( + "candidate scoring snapshot insert was not visible"); + } + + boolean changed = !same(existing.score(), r.score) + || !java.util.Objects.equals(existing.status(), r.status) + || !java.util.Objects.equals(canonicalJson(existing.subScoresJson()), json) + || !same(existing.weight(), DEFAULT_WEIGHT) + || !java.util.Objects.equals(existing.rulesVersion(), rulesVersion); + if (!changed) { + return; + } + int updated = jdbcTemplate.update(""" + UPDATE candidate_dimension_scores + SET score=?, status=?, sub_scores_json=?, weight=?, rules_version=?, calculated_at=?, + version=version+1, updated_at=NOW() + WHERE id=? AND version=? + """, r.score, r.status, json, DEFAULT_WEIGHT, rulesVersion, capturedNow, + existing.id(), existing.version()); + if (updated != 1) { + throw new org.springframework.dao.OptimisticLockingFailureException( + "candidate scoring snapshot changed concurrently"); + } + } + + private ExistingRow findForUpdate(Long studentUserId, String dimension, String period) { + return jdbcTemplate.query(""" + SELECT id, score, status, sub_scores_json, weight, rules_version, version + FROM candidate_dimension_scores + WHERE student_user_id=? AND dimension=? AND period=? + FOR UPDATE + """, (rs, i) -> new ExistingRow( + rs.getLong("id"), rs.getBigDecimal("score"), rs.getString("status"), + rs.getString("sub_scores_json"), rs.getBigDecimal("weight"), + rs.getString("rules_version"), rs.getLong("version")), + studentUserId, dimension, period).stream().findFirst().orElse(null); + } + + private boolean same(BigDecimal left, BigDecimal right) { + return left == null ? right == null : right != null && left.compareTo(right) == 0; + } + + private record ExistingRow(long id, BigDecimal score, String status, String subScoresJson, + BigDecimal weight, String rulesVersion, long version) { + } + + // ── payload（与 CandidateScoringCalculator.subScoresPayload 等价的内部实现） ── + + private String subScoresPayload(CandidateScoringCalculator.DimensionResult r) { + if ("ABILITY".equals(r.dimension) && r.abilitySnapshotTrace != null) { + try { + Map m = new LinkedHashMap<>(); + m.put("source", "V36_ABILITY_ASSESSMENT"); + m.put("sourceResultId", r.abilitySnapshotTrace.resultId()); + m.put("sourceCompletedAt", r.abilitySnapshotTrace.completedAt() == null + ? null : r.abilitySnapshotTrace.completedAt().toString()); + m.put("validUntil", r.abilitySnapshotTrace.validUntil() == null + ? null : r.abilitySnapshotTrace.validUntil().toString()); + m.put("questionSetVersion", r.abilitySnapshotTrace.questionSetVersion()); + m.put("assessmentRulesVersion", r.abilitySnapshotTrace.assessmentRulesVersion()); + m.put("mappingRulesVersion", com.mydreamjob.candidatescore.AbilityScoreMapper.MAPPING_RULES_VERSION); + m.put("weights", r.abilitySnapshotTrace.weights()); + m.put("dimensionScores", r.abilitySnapshotTrace.dimensionScores()); + return MAPPER.writeValueAsString(m); + } catch (Exception e) { + return null; + } + } + return toJson(r.subScores); + } + + private String toJson(List subs) { + if (subs == null || subs.isEmpty()) { + return null; + } + try { + return MAPPER.writeValueAsString(subs); + } catch (Exception e) { + return null; + } + } + + static String canonicalJson(String raw) { + if (raw == null || raw.isBlank()) { + return raw; + } + try { + JsonNode node = MAPPER.readTree(raw); + return MAPPER.writeValueAsString(sortKeys(node)); + } catch (Exception e) { + return raw; + } + } + + private static JsonNode sortKeys(JsonNode node) { + if (node instanceof ObjectNode obj) { + ObjectNode sorted = MAPPER.createObjectNode(); + List names = new ArrayList<>(); + obj.fieldNames().forEachRemaining(names::add); + names.sort(Comparator.naturalOrder()); + for (String name : names) { + sorted.set(name, sortKeys(obj.get(name))); + } + return sorted; + } + if (node.isArray()) { + com.fasterxml.jackson.databind.node.ArrayNode array = MAPPER.createArrayNode(); + for (JsonNode child : node) { + array.add(sortKeys(child)); + } + return array; + } + return node; + } + + /** 仅测试用：暴露时区无关的 canonic 化。 */ + static String canonicalForTest(Map raw) { + try { + return canonicalJson(MAPPER.writeValueAsString(new TreeMap<>(raw))); + } catch (Exception e) { + return null; + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/rules/CandidateScoringRuleSet.java b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/rules/CandidateScoringRuleSet.java new file mode 100644 index 0000000..22ded7b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/candidatescore/rules/CandidateScoringRuleSet.java @@ -0,0 +1,137 @@ +package com.mydreamjob.candidatescore.rules; + +import java.math.BigDecimal; +import java.util.Collections; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +/** + * 求职者评分规则的**唯一代码来源**（R01-C）。 + * + *

本类只承载"规则值本身"：版本标识、高校档次名单、教育背景分数与权重、默认维度权重。 + * 规则随**代码发布**变更，不接数据库、不接外部动态配置、无 setter、不暴露可变集合。

+ * + *

不变量

+ *
    + *
  • {@link #VERSION} 必须与重构前 {@code CandidateScoringCalculator.RULES_VERSION} 完全一致 + * （{@code candidate-scoring-v0.1}）—— 本轮**不新增版本、不改变响应中的版本值**；
    • + *
  • 高校名单内容、数量、字符串与判定优先级逐项不变；
    • + *
  • 所有 BigDecimal 使用**字符串构造**，scale 与重构前一致；
    • + *
  • 不同业务语义的相同数字**不合并**（例如学历层次 85 与学校档次 85 是两个命名常量）。
    • + *
+ */ +public final class CandidateScoringRuleSet { + + private CandidateScoringRuleSet() { + } + + // ── 版本与汇总 ──────────────────────────────────────────── + + /** 评分规则版本。原值取自 {@code CandidateScoringCalculator.RULES_VERSION}，逐字不变。 */ + public static final String VERSION = "candidate-scoring-v0.1"; + + /** 各维度默认等权重（参与维度重新归一化后等价于算术平均）。 */ + public static final BigDecimal DEFAULT_DIMENSION_WEIGHT = new BigDecimal("12.50"); + + /** 百分制上界，用于分数归一化。 */ + public static final BigDecimal FULL_SCORE = new BigDecimal("100"); + + // ── 教育背景：学历层次 ──────────────────────────────────── + + public static final BigDecimal EDUCATION_LEVEL_DOCTOR = new BigDecimal("100"); + public static final BigDecimal EDUCATION_LEVEL_MASTER = new BigDecimal("85"); + public static final BigDecimal EDUCATION_LEVEL_BACHELOR = new BigDecimal("70"); + public static final BigDecimal EDUCATION_LEVEL_JUNIOR_COLLEGE = new BigDecimal("55"); + public static final BigDecimal EDUCATION_LEVEL_UNKNOWN = new BigDecimal("50"); + + /** 教育维度内：学历层次与学校档次的合成权重（相加为 1.00）。 */ + public static final BigDecimal EDUCATION_LEVEL_WEIGHT = new BigDecimal("0.55"); + public static final BigDecimal EDUCATION_SCHOOL_TIER_WEIGHT = new BigDecimal("0.45"); + + /** 教育维度子项满分（用于解释与贡献校验）。 */ + public static final BigDecimal EDUCATION_LEVEL_FULL_SCORE = new BigDecimal("55"); + public static final BigDecimal EDUCATION_SCHOOL_TIER_FULL_SCORE = new BigDecimal("45"); + + // ── 教育背景：学校档次 ──────────────────────────────────── + + /** 985 高校档次得分。 */ + public static final BigDecimal SCHOOL_TIER_985 = new BigDecimal("85"); + /** 211（非 985）高校档次得分。 */ + public static final BigDecimal SCHOOL_TIER_211 = new BigDecimal("75"); + /** 已填写但不在两个名单内的学校。 */ + public static final BigDecimal SCHOOL_TIER_OTHER = new BigDecimal("65"); + /** 学校档次缺失（与"学历层次缺失"的 50 语义不同，故为独立常量）。 */ + public static final BigDecimal SCHOOL_TIER_MISSING = new BigDecimal("50"); + /** 教育资料整体缺失时的维度得分。 */ + public static final BigDecimal EDUCATION_MISSING_SCORE = new BigDecimal("100"); + + // ── 高校名单（v0.1 硬编码，非数据库表）──────────────────── + + /** + * 985 高校名单（38 项）。 + * + *

内容逐项抄录自重构前的 {@code CandidateScoringCalculator.C985}，顺序与字符串均未改动。

+ */ + private static final Set C985 = immutableSet(List.of( + "北京大学", "清华大学", "中国人民大学", "北京航空航天大学", "北京理工大学", + "中国农业大学", "北京师范大学", "中央民族大学", "南开大学", "天津大学", + "大连理工大学", "吉林大学", "哈尔滨工业大学", "复旦大学", "同济大学", + "上海交通大学", "华东师范大学", "南京大学", "东南大学", "浙江大学", + "中国科学技术大学", "厦门大学", "山东大学", "中国海洋大学", "武汉大学", + "华中科技大学", "湖南大学", "中南大学", "中山大学", "华南理工大学", + "四川大学", "重庆大学", "电子科技大学", "西安交通大学", "西北工业大学", + "兰州大学", "东北大学", "西北农林科技大学")); + + /** + * 211（非 985）高校名单：字面量 **62 条**、唯一项 **61**。 + * + *

末项 {@code 北京科技大学} 与首段重复 —— 这是重构前名单的**既有事实**， + * 按"名单内容逐项不变、数量不变"的要求**原样保留**，不擅自去重、不补充、不删除。 + * 集合语义下判定行为与重构前一致（{@code HashSet} 去重）。

+ */ + private static final Set C211 = immutableSet(List.of( + "北京交通大学", "北京工业大学", "北京科技大学", "北京化工大学", "北京邮电大学", + "北京林业大学", "北京中医药大学", "北京外国语大学", "中国传媒大学", "中央财经大学", + "对外经济贸易大学", "中国政法大学", "华北电力大学", "天津医科大学", "河北工业大学", + "太原理工大学", "内蒙古大学", "辽宁大学", "大连海事大学", "延边大学", + "哈尔滨工程大学", "东北农业大学", "东北林业大学", "东华大学", "上海大学", + "上海财经大学", "上海外国语大学", "苏州大学", "南京航空航天大学", "南京理工大学", + "中国矿业大学", "河海大学", "江南大学", "南京农业大学", "中国药科大学", + "南京师范大学", "安徽大学", "合肥工业大学", "福州大学", "南昌大学", + "郑州大学", "武汉理工大学", "华中农业大学", "华中师范大学", "中南财经政法大学", + "湖南师范大学", "暨南大学", "华南师范大学", "广西大学", "海南大学", + "西南交通大学", "西南财经大学", "贵州大学", "云南大学", "西北大学", + "西安电子科技大学", "长安大学", "新疆大学", "石河子大学", "宁夏大学", + "青海大学", "北京科技大学")); + + /** 只读视图：985 名单。 */ + public static Set c985() { + return C985; + } + + /** 只读视图：211（非 985）名单。 */ + public static Set c211() { + return C211; + } + + /** 该校是否为 985。 */ + public static boolean is985(String school) { + return school != null && C985.contains(school); + } + + /** 该校是否为 211（非 985）。 */ + public static boolean is211(String school) { + return school != null && C211.contains(school); + } + + /** + * 构造不可变集合。 + * + *

刻意使用 {@code unmodifiableSet(new HashSet<>(...))} 而非 {@code Set.copyOf}： + * 后者遇到重复元素会抛 {@code IllegalArgumentException}，而 211 名单的重复项必须原样保留。

+ */ + private static Set immutableSet(List values) { + return Collections.unmodifiableSet(new HashSet<>(values)); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressController.java b/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressController.java index 891a111..9554b82 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressController.java @@ -13,8 +13,6 @@ 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.RequestParam; import org.springframework.web.bind.annotation.RestController; @@ -30,6 +28,11 @@ import org.springframework.web.bind.annotation.RestController; @RequiredArgsConstructor public class CareerProgressController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CareerProgressService careerProgressService; @Operation( @@ -54,20 +57,9 @@ public class CareerProgressController { description = "投递状态过滤，可选 SUBMITTED/VIEWED/INTERVIEW/HIRED/REJECTED/WITHDRAWN") @RequestParam(required = false) String status, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CareerProgressResponse data = careerProgressService.getCareerProgress(userId, page, size, status); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressService.java b/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressService.java index 7f1a649..ba4f954 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/careerprogress/CareerProgressService.java @@ -66,6 +66,7 @@ public class CareerProgressService { private static final Set NEXT_INTERVIEW_STATUSES = Set.of("SCHEDULED", "CONFIRMED"); private static final String REPORT_DECISION_TYPE = "REPORT_DECISION"; + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final ApplicationRepository applicationRepository; private final InterviewRepository interviewRepository; private final InterviewScoreRepository interviewScoreRepository; @@ -75,10 +76,11 @@ public class CareerProgressService { private final CompanyRepository companyRepository; private final UserRepository userRepository; private final CompetitionRankingCalculator rankingCalculator; + private final CandidateScoringCalculator candidateScoringCalculator; @Transactional(readOnly = true) public CareerProgressResponse getCareerProgress(Long studentUserId, int page, int size, String status) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); validateParams(page, size, status); LocalDateTime now = LocalDateTime.now(); @@ -303,21 +305,11 @@ public class CareerProgressService { .percentile(cr.percentile) .status(cr.status) .mySnapshotPeriod(cr.mySnapshotPeriod) - .rulesVersion(CandidateScoringCalculator.RULES_VERSION) + .rulesVersion(candidateScoringCalculator.currentRulesVersion()) .build(); } // ── 权限 / 参数 / 工具 ───────────────────────────────── - - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - private void validateParams(int page, int size, String status) { if (page < 0 || size < 1 || size > 50) { throw new BusinessException(ErrorCode.BAD_REQUEST); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorCode.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorCode.java index d8dac91..d7c4f2f 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorCode.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorCode.java @@ -16,6 +16,9 @@ public enum ErrorCode { TOKEN_EXPIRED(2003, "token expired"), TOKEN_INVALID(2004, "token invalid"), CREDENTIALS_INVALID(2005, "invalid credentials"), + PASSWORD_RATE_LIMITED(2006, "password authentication rate limited"), + PASSWORD_STATE_CONFLICT(2007, "password state conflict"), + PASSWORD_POLICY_INVALID(2008, "password does not meet policy"), // 验证码 3xxx SMS_CODE_SENT(3001, "sms code sent"), @@ -80,8 +83,11 @@ public enum ErrorCode { MATCH_SCORES_LOCKED(8302, "match already succeeded, scores are locked"), MATCH_REQUIRED_FOR_CONVERSATION(8303, "direct conversation between company and candidate requires a matched application"), APPLICATION_NOT_MATCHED(8304, "application is not matched"), - // 站内信 8305 + // 站内信 83xx CONVERSATION_NOT_FOUND(8305, "conversation not found"), + MESSAGE_NOT_FOUND(8306, "message not found"), + MESSAGE_RECALL_WINDOW_EXPIRED(8307, "message recall window expired"), + MESSAGE_RECALL_CONCURRENT_UPDATE(8308, "message recall concurrent update"), // 评价 91xx DUPLICATE_REVIEW(9101, "duplicate review"), @@ -98,11 +104,6 @@ public enum ErrorCode { // 评价权重 9106 REVIEW_WEIGHT_CONCURRENT_UPDATE(9106, "concurrent weight update conflict"), - // 企业回复 91xx - DUPLICATE_REPLY(9107, "duplicate reply"), - REPLY_NOT_FOUND(9108, "reply not found"), - REPLY_ALREADY_DECIDED(9109, "reply already decided"), - // 面试 84xx INTERVIEW_NOT_FOUND(8401, "interview not found"), INTERVIEW_ACCESS_DENIED(8402, "interview access denied"), @@ -172,20 +173,73 @@ public enum ErrorCode { REPORT_RATE_LIMITED(9609, "report rate limited"), BLOCKED_SEND_PROHIBITED(9610, "message cannot be sent"), - // 入职清单 97xx - ONBOARDING_CHECKLIST_ITEM_NOT_FOUND(9701, "onboarding checklist item not found"), - ONBOARDING_CHECKLIST_ITEM_CONCURRENT_UPDATE(9702, "onboarding checklist item was modified concurrently"), - ONBOARDING_ITEM_LIMIT_EXCEEDED(9703, "onboarding checklist item limit exceeded"), - ONBOARDING_IDEMPOTENCY_CONFLICT(9704, "idempotency key conflict: request body differs"), - ONBOARDING_PROGRESS_CONCURRENT_UPDATE(9705, "onboarding progress was modified concurrently"), - ONBOARDING_KNOWLEDGE_CONCURRENT_UPDATE(9706, "company knowledge was modified concurrently"), - - // 薪资计算器 98xx - SALARY_CITY_NOT_FOUND(9801, "salary city not found or disabled"), - SALARY_INVALID_PARAMETER(9802, "invalid salary calculation parameter"), - SALARY_HISTORY_NOT_FOUND(9803, "salary calculation history not found"), - SALARY_IDEMPOTENCY_CONFLICT(9804, "salary idempotency key conflict: request body differs"), - SALARY_POLICY_VERSION_CONFLICT(9805, "salary city policy version conflict"); + // RIASEC 职业兴趣测评 97xx（9704 预留，未使用） + ASSESSMENT_TYPE_NOT_FOUND(9701, "assessment type not found"), + ASSESSMENT_ATTEMPT_NOT_FOUND(9702, "assessment attempt not found"), + ASSESSMENT_ATTEMPT_INVALID_STATE(9703, "assessment attempt is not in a valid state"), + ASSESSMENT_ANSWER_INVALID(9705, "invalid assessment answer"), + ASSESSMENT_INCOMPLETE(9706, "assessment is incomplete, answer all questions before submitting"), + ASSESSMENT_CONCURRENT_UPDATE(9707, "assessment attempt was modified concurrently"), + ASSESSMENT_DUPLICATE_ACTIVE(9708, "an active assessment attempt already exists"), + ASSESSMENT_IDEMPOTENCY_CONFLICT(9709, "idempotency key conflict: request body differs"), + + // 四维能力测评 98xx + ABILITY_TYPE_NOT_FOUND(9801, "ability assessment type not found"), + ABILITY_ATTEMPT_NOT_FOUND(9802, "ability attempt not found"), + ABILITY_ATTEMPT_INVALID_STATE(9803, "ability attempt is not in a valid state"), + ABILITY_RESULT_NOT_FOUND(9804, "ability result not found"), + ABILITY_ANSWER_INVALID(9805, "invalid ability answer"), + ABILITY_INCOMPLETE(9806, "ability assessment is incomplete, answer all questions before submitting"), + ABILITY_CONCURRENT_UPDATE(9807, "ability attempt was modified concurrently"), + ABILITY_DUPLICATE_ACTIVE(9808, "an active ability attempt already exists"), + ABILITY_IDEMPOTENCY_CONFLICT(9809, "idempotency key conflict: request body differs"), + ABILITY_RETAKE_COOLDOWN(9810, "a valid result still exists within cooldown period"), + ABILITY_RETAKE_LIMIT(9811, "retake limit reached within the rolling window"), + + // 风险概览与运营规则配置 99xx + RISK_RULE_NOT_FOUND(9901, "risk rule not found"), + RISK_EVENT_NOT_FOUND(9902, "risk event not found"), + RISK_RULE_CONCURRENT_UPDATE(9903, "risk rule was modified concurrently"), + RISK_EVENT_CONCURRENT_UPDATE(9904, "risk event was modified concurrently"), + RISK_INVALID_ACTION(9905, "invalid risk action or reason code"), + RISK_INVALID_FILTER(9906, "invalid risk filter"), + + // 岗位推荐 100xx + RECOMMENDATION_PROFILE_NOT_FOUND(10001, "job recommendation profile not found"), + RECOMMENDATION_PROFILE_INVALID(10002, "invalid job recommendation profile"), + RECOMMENDATION_PROFILE_CONCURRENT_UPDATE(10003, "job recommendation profile was modified concurrently"), + RECOMMENDATION_INVALID_QUERY(10004, "invalid recommendation query"), + RECOMMENDATION_TAXONOMY_INVALID(10005, "invalid recommendation taxonomy"), + RECOMMENDATION_FEEDBACK_CONCURRENT_UPDATE(10006, "recommendation feedback was modified concurrently"), + RECOMMENDATION_FEEDBACK_IDEMPOTENCY_CONFLICT(10007, "recommendation feedback idempotency conflict"), + RECOMMENDATION_FEEDBACK_NOT_FOUND(10008, "recommendation feedback not found"), + RECOMMENDATION_PROFILE_INVALID_REVIEW_STATE(10009, "invalid recommendation profile review state"), + + // 企业评价官方回复 101xx + REVIEW_REPLY_NOT_FOUND(10101, "review reply not found"), + REVIEW_REPLY_ALREADY_EXISTS(10102, "review already has a reply"), + REVIEW_REPLY_INVALID_STATE(10103, "review reply is not in a valid state"), + REVIEW_REPLY_CONCURRENT_UPDATE(10104, "review reply was modified concurrently"), + REVIEW_REPLY_CONTENT_INVALID(10105, "invalid review reply content"), + REVIEW_REPLY_IDEMPOTENCY_CONFLICT(10106, "review reply idempotency conflict"), + REVIEW_REPLY_DECISION_INVALID(10107, "invalid review reply decision"), + + // 企业人才邀约 102xx + TALENT_INVITATION_NOT_FOUND(10201, "talent invitation not found"), + TALENT_INVITATION_CANDIDATE_UNAVAILABLE(10202, "candidate is not currently available for invitation"), + TALENT_INVITATION_ALREADY_ACTIVE(10203, "an active or cooling invitation already exists"), + TALENT_INVITATION_INVALID_STATE(10204, "talent invitation is not in a valid state"), + TALENT_INVITATION_EXPIRED(10205, "talent invitation has expired"), + TALENT_INVITATION_CONCURRENT_UPDATE(10206, "talent invitation was modified concurrently"), + TALENT_INVITATION_IDEMPOTENCY_CONFLICT(10207, "talent invitation idempotency conflict"), + TALENT_INVITATION_CONTENT_INVALID(10208, "invalid talent invitation content"), + TALENT_INVITATION_RATE_LIMITED(10209, "talent invitation rate limited"), + + // 企业注册与入驻 Phase A 103xx + COMPANY_REGISTRATION_DISABLED(10301, "company registration is disabled"), + COMPANY_REGISTRATION_CONFLICT(10302, "company registration conflict"), + COMPANY_ONBOARDING_INCONSISTENT_STATE(10303, "company onboarding state is inconsistent"), + COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE(10304, "company registration dependency unavailable"); private final int code; private final String message; @@ -203,4 +257,3 @@ public enum ErrorCode { return message; } } - diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorHttpStatusRegistry.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorHttpStatusRegistry.java new file mode 100644 index 0000000..0833cf7 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/ErrorHttpStatusRegistry.java @@ -0,0 +1,270 @@ +package com.mydreamjob.common.exception; + +import org.springframework.http.HttpStatus; +import org.springframework.stereotype.Component; + +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Objects; + +/** + * 业务错误码 → HTTP 状态的**唯一**集中映射（R01-B/B2）。 + * + *

职责边界：只回答"这个业务错误码应该对应哪个 HTTP 状态"。不做日志、不读请求、 + * 不生成响应体、不解析 requestId、不缓存请求级状态。

+ * + *

契约（与重构前逐项一致）

+ *
    + *
  • 显式映射只在 {@link #explicitMappings()} 一处定义，全部使用 + * {@code ErrorCode.X} 符号，不出现手写数字；
    • + *
  • **未显式映射的错误码回退 {@link #DEFAULT_STATUS}（400 BAD_REQUEST）**， + * 与重构前 {@code getOrDefault(code, BAD_REQUEST)} 完全一致；
    • + *
  • **映射键是 {@link ErrorCode} 本身，不是数字**。这一点是必须的： + * {@code ErrorCode} 现有 166 个常量却只有 165 个唯一数字码 + * （{@code REVIEW_ALREADY_DECIDED} 与 {@code DUPLICATE_FEEDBACK} 同为 9103）， + * 若以数字为键，"禁止重复键"将无法在不修改 {@code ErrorCode} 数字的前提下成立。 + * 数字入口 {@link #resolve(int)} 由该映射派生；若两个不同常量被映射到 + * **同一个数字码且状态不同**，初始化即抛错（这是不可接受的歧义）；
    • + *
  • 映射表初始化后不可变（{@link Map#copyOf}），运行期无法增删改；
    • + *
  • 同一个 {@link ErrorCode} 常量被注册两次即为**初始化错误** + * （无论目标状态是否相同），由 {@link Builder#put} 立即抛出 + * {@link IllegalStateException}，使"重复键"在启动期而不是请求期暴露；
    • + *
  • 不使用反射扫描，不引入任何运行时可变的 Map。
    • + *
+ * + *

注意：{@code UNAUTHORIZED(2001)} 与 {@code SERVICE_UNAVAILABLE} + * 在本映射中**故意不显式登记**，因此既有语义是回退 400 —— 这是重构前就存在的行为， + * 本次收束不得擅自把它改成 401/503。

+ */ +@Component +public final class ErrorHttpStatusRegistry { + + /** 未显式映射时的回退状态（与重构前一致）。 */ + public static final HttpStatus DEFAULT_STATUS = HttpStatus.BAD_REQUEST; + + private static final Map EXPLICIT = explicitMappings(); + private static final Map BY_CODE = indexByCode(EXPLICIT); + + /** 按 {@link ErrorCode} 解析。{@code null} 走默认回退，不做 NPE 抛出。 */ + public HttpStatus resolve(ErrorCode errorCode) { + return errorCode == null ? DEFAULT_STATUS : EXPLICIT.getOrDefault(errorCode, DEFAULT_STATUS); + } + + /** 按数字业务码解析（{@code BusinessException} 只暴露数字 code）。 */ + public HttpStatus resolve(int errorCode) { + return BY_CODE.getOrDefault(errorCode, DEFAULT_STATUS); + } + + /** 未映射错误码的默认状态。 */ + public HttpStatus defaultStatus() { + return DEFAULT_STATUS; + } + + /** 显式登记的 {@link ErrorCode} 常量数量（用于一致性校验与报告）。 */ + public int explicitMappingCount() { + return EXPLICIT.size(); + } + + /** 显式映射覆盖的唯一数字码数量（小于等于 {@link #explicitMappingCount()}）。 */ + public int explicitNumericCodeCount() { + return BY_CODE.size(); + } + + /** 只读视图：显式映射的 {@link ErrorCode} → 状态。 */ + public static Map explicitMappingsView() { + return EXPLICIT; + } + + /** 只读视图：数字业务码 → 状态（由 {@link #explicitMappingsView()} 派生）。 */ + public static Map numericMappingsView() { + return BY_CODE; + } + + /** 某个错误码是否被显式登记。 */ + public static boolean isExplicitlyMapped(ErrorCode errorCode) { + return errorCode != null && EXPLICIT.containsKey(errorCode); + } + + /** + * 由 {@link ErrorCode} 键映射派生数字键索引。 + * + *

同一数字码对应多个常量是**既有事实**（9103）。只要它们被映射到相同状态， + * 数字入口就是无歧义的，保持既有行为；一旦状态不同，说明存在无法自动裁决的冲突， + * 初始化必须失败而不是任选其一。

+ */ + private static Map indexByCode(Map explicit) { + Map byCode = new LinkedHashMap<>(); + for (Map.Entry entry : explicit.entrySet()) { + HttpStatus previous = byCode.putIfAbsent(entry.getKey().getCode(), entry.getValue()); + if (previous != null && previous != entry.getValue()) { + throw new IllegalStateException("conflicting HTTP status mapping for numeric error code " + + entry.getKey().getCode() + ": " + previous + " then " + entry.getValue()); + } + } + return Map.copyOf(byCode); + } + + /** + * 显式映射定义（唯一位置）。仅登记与重构前完全一致的 (错误码, 状态) 组合。 + */ + private static Map explicitMappings() { + return new Builder() + .put(HttpStatus.FORBIDDEN, + ErrorCode.APPLICATION_OWNER_MISMATCH, + ErrorCode.FORBIDDEN, + ErrorCode.INTERVIEW_ACCESS_DENIED, + ErrorCode.MATCH_REQUIRED_FOR_CONVERSATION, + ErrorCode.OFFER_COMPARE_NOT_OWNER) + .put(HttpStatus.NOT_FOUND, + ErrorCode.ABILITY_ATTEMPT_NOT_FOUND, + ErrorCode.ABILITY_RESULT_NOT_FOUND, + ErrorCode.ABILITY_TYPE_NOT_FOUND, + ErrorCode.APPEAL_NOT_FOUND, + ErrorCode.APPLICATION_NOT_FOUND, + ErrorCode.ASSESSMENT_ATTEMPT_NOT_FOUND, + ErrorCode.ASSESSMENT_TYPE_NOT_FOUND, + ErrorCode.COMPANY_NOT_FOUND, + ErrorCode.CONVERSATION_NOT_FOUND, + ErrorCode.DATA_EXPORT_TASK_NOT_FOUND, + ErrorCode.FEEDBACK_NOT_FOUND, + ErrorCode.INTERVIEW_SCORE_NOT_FOUND, + ErrorCode.JOB_NOT_FOUND, + ErrorCode.MESSAGE_NOT_FOUND, + ErrorCode.OFFER_COUNTER_OFFER_NOT_FOUND, + ErrorCode.OFFER_NOT_FOUND, + ErrorCode.PROFILE_NOT_FOUND, + ErrorCode.REPORT_NOT_FOUND, + ErrorCode.RESUME_EXPORT_TASK_NOT_FOUND, + ErrorCode.RESUME_VERSION_NOT_FOUND, + ErrorCode.REVIEW_NOT_FOUND, + ErrorCode.REVIEW_REPLY_NOT_FOUND, + ErrorCode.RISK_EVENT_NOT_FOUND, + ErrorCode.RISK_RULE_NOT_FOUND, + ErrorCode.TALENT_INVITATION_NOT_FOUND, + ErrorCode.USER_NOT_FOUND, + ErrorCode.VERIFICATION_NOT_FOUND) + .put(HttpStatus.CONFLICT, + ErrorCode.PASSWORD_STATE_CONFLICT, + ErrorCode.ABILITY_ATTEMPT_INVALID_STATE, + ErrorCode.ABILITY_CONCURRENT_UPDATE, + ErrorCode.ABILITY_DUPLICATE_ACTIVE, + ErrorCode.ABILITY_IDEMPOTENCY_CONFLICT, + ErrorCode.ABILITY_RETAKE_COOLDOWN, + ErrorCode.ACCOUNT_DELETED, + ErrorCode.ACCOUNT_DELETION_CANCEL_DEADLINE_PASSED, + ErrorCode.ACCOUNT_DELETION_CONCURRENT_UPDATE, + ErrorCode.ACCOUNT_DELETION_PENDING, + ErrorCode.APPEAL_ALREADY_DECIDED, + ErrorCode.APPEAL_DUPLICATE, + ErrorCode.APPEAL_IDEMPOTENCY_CONFLICT, + ErrorCode.APPEAL_INVALID_TRANSITION, + ErrorCode.APPEAL_ROLLBACK_LIMIT_EXCEEDED, + ErrorCode.APPLICATION_DUPLICATE, + ErrorCode.APPLICATION_NOT_MATCHED, + ErrorCode.ASSESSMENT_ATTEMPT_INVALID_STATE, + ErrorCode.ASSESSMENT_CONCURRENT_UPDATE, + ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE, + ErrorCode.ASSESSMENT_IDEMPOTENCY_CONFLICT, + ErrorCode.COMPANY_ALREADY_EXISTS, + ErrorCode.DATA_EXPORT_DUPLICATE, + ErrorCode.DATA_EXPORT_EXPIRED, + ErrorCode.DATA_EXPORT_FAILED, + ErrorCode.DATA_EXPORT_FILE_NOT_FOUND, + ErrorCode.DATA_EXPORT_NOT_READY, + ErrorCode.DEFAULT_RESUME_DELETE_NOT_ALLOWED, + ErrorCode.DUPLICATE_DEFAULT_RESUME, + ErrorCode.DUPLICATE_FEEDBACK, + ErrorCode.DUPLICATE_OFFER, + ErrorCode.DUPLICATE_REVIEW, + ErrorCode.INTERVIEW_ALREADY_RESPONDED, + ErrorCode.INTERVIEW_COMPLETE_NOT_READY, + ErrorCode.INTERVIEW_NOT_COMPLETED, + ErrorCode.INTERVIEW_SCORE_CONCURRENT_UPDATE, + ErrorCode.INTERVIEW_SCORE_SUBMITTED, + ErrorCode.INVALID_APPLICATION_STATUS_TRANSITION, + ErrorCode.INVALID_DELETION_STATE, + ErrorCode.INVALID_INTERVIEW_STATUS_TRANSITION, + ErrorCode.INVALID_JOB_STATUS_TRANSITION, + ErrorCode.INVALID_OFFER_STATUS_TRANSITION, + ErrorCode.INVALID_VERIFICATION_STATUS_TRANSITION, + ErrorCode.LAST_ADMIN_CANNOT_DELETE, + ErrorCode.MATCH_CLOSED, + ErrorCode.MATCH_SCORES_LOCKED, + ErrorCode.MESSAGE_RECALL_CONCURRENT_UPDATE, + ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED, + ErrorCode.OFFER_COUNTER_OFFER_EXISTS, + ErrorCode.OFFER_COUNTER_OFFER_EXPIRED, + ErrorCode.OFFER_COUNTER_OFFER_NOT_PENDING, + ErrorCode.OFFER_EXPIRED, + ErrorCode.OFFER_NOT_EDITABLE, + ErrorCode.OFFER_REMINDER_DUPLICATE, + ErrorCode.PRIVACY_SETTINGS_CONCURRENT_UPDATE, + ErrorCode.REPORT_ALREADY_DECIDED, + ErrorCode.REPORT_DUPLICATE, + ErrorCode.REPORT_IDEMPOTENCY_CONFLICT, + ErrorCode.REPORT_INVALID_TRANSITION, + ErrorCode.RESUME_EXPORT_IN_PROGRESS, + ErrorCode.RESUME_EXPORT_NOT_READY, + ErrorCode.REVIEW_ALREADY_DECIDED, + ErrorCode.REVIEW_REPLY_ALREADY_EXISTS, + ErrorCode.REVIEW_REPLY_CONCURRENT_UPDATE, + ErrorCode.REVIEW_REPLY_IDEMPOTENCY_CONFLICT, + ErrorCode.REVIEW_REPLY_INVALID_STATE, + ErrorCode.REVIEW_WEIGHT_CONCURRENT_UPDATE, + ErrorCode.RISK_EVENT_CONCURRENT_UPDATE, + ErrorCode.RISK_INVALID_ACTION, + ErrorCode.RISK_RULE_CONCURRENT_UPDATE, + ErrorCode.TALENT_INVITATION_ALREADY_ACTIVE, + ErrorCode.TALENT_INVITATION_CANDIDATE_UNAVAILABLE, + ErrorCode.TALENT_INVITATION_CONCURRENT_UPDATE, + ErrorCode.TALENT_INVITATION_EXPIRED, + ErrorCode.TALENT_INVITATION_IDEMPOTENCY_CONFLICT, + ErrorCode.TALENT_INVITATION_INVALID_STATE, + ErrorCode.VERIFICATION_ALREADY_APPROVED, + ErrorCode.VERIFICATION_ALREADY_PENDING, + ErrorCode.COMPANY_REGISTRATION_CONFLICT, + ErrorCode.COMPANY_ONBOARDING_INCONSISTENT_STATE) + .put(HttpStatus.SERVICE_UNAVAILABLE, + ErrorCode.COMPANY_REGISTRATION_DISABLED, + ErrorCode.COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE) + .put(HttpStatus.TOO_MANY_REQUESTS, + ErrorCode.PASSWORD_RATE_LIMITED, + ErrorCode.ABILITY_RETAKE_LIMIT, + ErrorCode.REPORT_RATE_LIMITED, + ErrorCode.TALENT_INVITATION_RATE_LIMITED) + .put(HttpStatus.UNAUTHORIZED, + ErrorCode.CREDENTIALS_INVALID) + .build(); + } + + /** + * 显式映射构建器。 + * + *

重复键检测：同一个数字错误码第二次注册即抛 {@link IllegalStateException}， + * **不区分目标状态是否相同** —— "同码同状态的重复登记"同样是不可审计的配置错误。

+ */ + public static final class Builder { + + private final Map entries = new LinkedHashMap<>(); + + public Builder put(HttpStatus status, ErrorCode... errorCodes) { + Objects.requireNonNull(status, "status"); + Objects.requireNonNull(errorCodes, "errorCodes"); + for (ErrorCode errorCode : errorCodes) { + Objects.requireNonNull(errorCode, "errorCode"); + HttpStatus previous = entries.putIfAbsent(errorCode, status); + if (previous != null) { + throw new IllegalStateException( + "duplicate HTTP status mapping for error code " + errorCode.getCode() + + " (" + errorCode.name() + "): " + previous + " then " + status); + } + } + return this; + } + + /** 构建不可变映射（键为 {@link ErrorCode}）。 */ + public Map build() { + return Map.copyOf(entries); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java index 0310ce2..573fb2e 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/exception/GlobalExceptionHandler.java @@ -1,10 +1,12 @@ package com.mydreamjob.common.exception; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.salarycalculator.SalaryPolicyVersionConflictException; +import com.mydreamjob.common.logging.RequestIdAccessor; import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.ConstraintViolationException; import lombok.extern.slf4j.Slf4j; +import lombok.RequiredArgsConstructor; +import org.springframework.context.annotation.Import; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.http.converter.HttpMessageNotReadableException; @@ -17,18 +19,26 @@ import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException; +import org.springframework.web.servlet.resource.NoResourceFoundException; import java.util.HashMap; -import java.util.LinkedHashMap; import java.util.Map; /** * 全局异常处理器 + * + *

R01-B/B2：业务错误码 → HTTP 状态的映射已收束到 {@link ErrorHttpStatusRegistry}， + * 本类只负责调用它，不再持有任何映射表或条件链。

*/ @Slf4j @RestControllerAdvice +@RequiredArgsConstructor +@Import(ErrorHttpStatusRegistry.class) public class GlobalExceptionHandler { + private final RequestIdAccessor requestIdAccessor; + private final ErrorHttpStatusRegistry errorHttpStatusRegistry; + @ExceptionHandler(ConstraintViolationException.class) public ResponseEntity> handleConstraintViolation( ConstraintViolationException ex, HttpServletRequest request) { @@ -44,163 +54,12 @@ public class GlobalExceptionHandler { int errorCode = e.getErrorCode(); log.warn("BusinessException: code={}, message={}, path={}", errorCode, e.getMessage(), request.getRequestURI()); - HttpStatus status = resolveHttpStatus(errorCode); + HttpStatus status = errorHttpStatusRegistry.resolve(errorCode); return ResponseEntity .status(status) .body(ApiResponse.error(errorCode, e.getMessage(), getRequestId(request))); } - /** - * 按业务错误码段映射 HTTP 状态码（与 API v0.2 草案一致）： - * - FORBIDDEN(2002) → 403 - * - 不存在类(5001/6001/7001/8002/4001/9102) → 404 - * - 冲突/非法流转类(5003/7003/8001/8003/9101) → 409 - * - 其余 → 400 - */ - private HttpStatus resolveHttpStatus(int errorCode) { - // 权限 → 403 - if (errorCode == ErrorCode.FORBIDDEN.getCode()) return HttpStatus.FORBIDDEN; - // 面试访问/越权 → 403 - if (errorCode == ErrorCode.INTERVIEW_ACCESS_DENIED.getCode() - || errorCode == ErrorCode.APPLICATION_OWNER_MISMATCH.getCode()) - return HttpStatus.FORBIDDEN; - // 不存在 → 404 - if (errorCode == ErrorCode.COMPANY_NOT_FOUND.getCode() - || errorCode == ErrorCode.PROFILE_NOT_FOUND.getCode() - || errorCode == ErrorCode.JOB_NOT_FOUND.getCode() - || errorCode == ErrorCode.APPLICATION_NOT_FOUND.getCode() - || errorCode == ErrorCode.OFFER_NOT_FOUND.getCode() - || errorCode == ErrorCode.OFFER_COUNTER_OFFER_NOT_FOUND.getCode() - || errorCode == ErrorCode.RESUME_VERSION_NOT_FOUND.getCode() - || errorCode == ErrorCode.RESUME_EXPORT_TASK_NOT_FOUND.getCode() - || errorCode == ErrorCode.USER_NOT_FOUND.getCode() - || errorCode == ErrorCode.REVIEW_NOT_FOUND.getCode() - || errorCode == ErrorCode.FEEDBACK_NOT_FOUND.getCode() - || errorCode == ErrorCode.CONVERSATION_NOT_FOUND.getCode() - || errorCode == ErrorCode.APPEAL_NOT_FOUND.getCode() - || errorCode == ErrorCode.DATA_EXPORT_TASK_NOT_FOUND.getCode() - || errorCode == ErrorCode.ONBOARDING_CHECKLIST_ITEM_NOT_FOUND.getCode() - || errorCode == ErrorCode.SALARY_CITY_NOT_FOUND.getCode() - || errorCode == ErrorCode.SALARY_HISTORY_NOT_FOUND.getCode()) return HttpStatus.NOT_FOUND; - // 冲突 → 409 - if (errorCode == ErrorCode.COMPANY_ALREADY_EXISTS.getCode() - || errorCode == ErrorCode.APPLICATION_DUPLICATE.getCode() - || errorCode == ErrorCode.INVALID_APPLICATION_STATUS_TRANSITION.getCode() - || errorCode == ErrorCode.INVALID_JOB_STATUS_TRANSITION.getCode() - || errorCode == ErrorCode.INVALID_APPLICATION_STATUS_TRANSITION.getCode() - || errorCode == ErrorCode.DUPLICATE_REVIEW.getCode() - || errorCode == ErrorCode.DUPLICATE_FEEDBACK.getCode() - || errorCode == ErrorCode.DUPLICATE_OFFER.getCode() - || errorCode == ErrorCode.INVALID_OFFER_STATUS_TRANSITION.getCode() - || errorCode == ErrorCode.OFFER_EXPIRED.getCode() - || errorCode == ErrorCode.OFFER_NOT_EDITABLE.getCode() - || errorCode == ErrorCode.OFFER_REMINDER_DUPLICATE.getCode() - || errorCode == ErrorCode.OFFER_COUNTER_OFFER_EXISTS.getCode() - || errorCode == ErrorCode.OFFER_COUNTER_OFFER_NOT_PENDING.getCode() - || errorCode == ErrorCode.OFFER_COUNTER_OFFER_EXPIRED.getCode() - || errorCode == ErrorCode.DEFAULT_RESUME_DELETE_NOT_ALLOWED.getCode() - || errorCode == ErrorCode.RESUME_EXPORT_IN_PROGRESS.getCode() - || errorCode == ErrorCode.DUPLICATE_DEFAULT_RESUME.getCode() - || errorCode == ErrorCode.RESUME_EXPORT_NOT_READY.getCode() - || errorCode == ErrorCode.MATCH_CLOSED.getCode() - || errorCode == ErrorCode.MATCH_SCORES_LOCKED.getCode() - || errorCode == ErrorCode.APPLICATION_NOT_MATCHED.getCode() - || errorCode == ErrorCode.REVIEW_ALREADY_DECIDED.getCode() - // 面试冲突 → 409 - || errorCode == ErrorCode.INVALID_INTERVIEW_STATUS_TRANSITION.getCode() - || errorCode == ErrorCode.INTERVIEW_COMPLETE_NOT_READY.getCode() - || errorCode == ErrorCode.INTERVIEW_ALREADY_RESPONDED.getCode()) - return HttpStatus.CONFLICT; - // 越权 → 403（新增：企业-求职者建会话需匹配） - if (errorCode == ErrorCode.MATCH_REQUIRED_FOR_CONVERSATION.getCode()) - return HttpStatus.FORBIDDEN; - // Offer 比较越权（包含非本人 Offer） → 403 - if (errorCode == ErrorCode.OFFER_COMPARE_NOT_OWNER.getCode()) - return HttpStatus.FORBIDDEN; - // 认证不存在 → 404 - if (errorCode == ErrorCode.VERIFICATION_NOT_FOUND.getCode()) return HttpStatus.NOT_FOUND; - // 认证冲突 → 409 - if (errorCode == ErrorCode.VERIFICATION_ALREADY_PENDING.getCode() - || errorCode == ErrorCode.VERIFICATION_ALREADY_APPROVED.getCode() - || errorCode == ErrorCode.INVALID_VERIFICATION_STATUS_TRANSITION.getCode()) - return HttpStatus.CONFLICT; - // 权重并发冲突 → 409 - if (errorCode == ErrorCode.REVIEW_WEIGHT_CONCURRENT_UPDATE.getCode()) - return HttpStatus.CONFLICT; - // 隐私设置并发冲突 → 409 - if (errorCode == ErrorCode.PRIVACY_SETTINGS_CONCURRENT_UPDATE.getCode()) - return HttpStatus.CONFLICT; - // 账号注销状态冲突 → 409（9301-9306） - if (errorCode == ErrorCode.INVALID_DELETION_STATE.getCode() - || errorCode == ErrorCode.ACCOUNT_DELETION_PENDING.getCode() - || errorCode == ErrorCode.ACCOUNT_DELETED.getCode() - || errorCode == ErrorCode.ACCOUNT_DELETION_CONCURRENT_UPDATE.getCode() - || errorCode == ErrorCode.ACCOUNT_DELETION_CANCEL_DEADLINE_PASSED.getCode() - || errorCode == ErrorCode.LAST_ADMIN_CANNOT_DELETE.getCode()) - return HttpStatus.CONFLICT; - // 评分治理冲突 → 409 - if (errorCode == ErrorCode.APPEAL_DUPLICATE.getCode() - || errorCode == ErrorCode.APPEAL_ALREADY_DECIDED.getCode() - || errorCode == ErrorCode.APPEAL_ROLLBACK_LIMIT_EXCEEDED.getCode() - || errorCode == ErrorCode.APPEAL_INVALID_TRANSITION.getCode() - || errorCode == ErrorCode.APPEAL_IDEMPOTENCY_CONFLICT.getCode()) - return HttpStatus.CONFLICT; - // 个人数据导出 → 409（9402-9406，除 9401 已映射 404） - if (errorCode == ErrorCode.DATA_EXPORT_DUPLICATE.getCode() - || errorCode == ErrorCode.DATA_EXPORT_NOT_READY.getCode() - || errorCode == ErrorCode.DATA_EXPORT_EXPIRED.getCode() - || errorCode == ErrorCode.DATA_EXPORT_FAILED.getCode() - || errorCode == ErrorCode.DATA_EXPORT_FILE_NOT_FOUND.getCode()) - return HttpStatus.CONFLICT; - // 结构化面试评分 → 404（9504 评分不存在） - if (errorCode == ErrorCode.INTERVIEW_SCORE_NOT_FOUND.getCode()) - return HttpStatus.NOT_FOUND; - // 结构化面试评分 → 409（9501 并发 / 9502 未完成 / 9503 已提交） - if (errorCode == ErrorCode.INTERVIEW_SCORE_CONCURRENT_UPDATE.getCode() - || errorCode == ErrorCode.INTERVIEW_NOT_COMPLETED.getCode() - || errorCode == ErrorCode.INTERVIEW_SCORE_SUBMITTED.getCode()) - return HttpStatus.CONFLICT; - // 举报与屏蔽：不存在 → 404 - if (errorCode == ErrorCode.REPORT_NOT_FOUND.getCode()) return HttpStatus.NOT_FOUND; - // 举报与屏蔽：冲突/重复/非法流转 → 409 - if (errorCode == ErrorCode.REPORT_DUPLICATE.getCode() - || errorCode == ErrorCode.REPORT_ALREADY_DECIDED.getCode() - || errorCode == ErrorCode.REPORT_INVALID_TRANSITION.getCode() - || errorCode == ErrorCode.REPORT_IDEMPOTENCY_CONFLICT.getCode()) - return HttpStatus.CONFLICT; - // 入职清单并发、上限与幂等冲突 → 409 - if (errorCode == ErrorCode.ONBOARDING_CHECKLIST_ITEM_CONCURRENT_UPDATE.getCode() - || errorCode == ErrorCode.ONBOARDING_ITEM_LIMIT_EXCEEDED.getCode() - || errorCode == ErrorCode.ONBOARDING_IDEMPOTENCY_CONFLICT.getCode() - || errorCode == ErrorCode.ONBOARDING_PROGRESS_CONCURRENT_UPDATE.getCode() - || errorCode == ErrorCode.ONBOARDING_KNOWLEDGE_CONCURRENT_UPDATE.getCode() - || errorCode == ErrorCode.SALARY_IDEMPOTENCY_CONFLICT.getCode() - || errorCode == ErrorCode.SALARY_POLICY_VERSION_CONFLICT.getCode()) - return HttpStatus.CONFLICT; - // 举报限流 → 429 - if (errorCode == ErrorCode.REPORT_RATE_LIMITED.getCode()) - return HttpStatus.TOO_MANY_REQUESTS; - // Offer 进阶契约 → 400（不可撤销、不可还价、比较数量超限） - if (errorCode == ErrorCode.OFFER_NOT_WITHDRAWABLE.getCode() - || errorCode == ErrorCode.OFFER_NOT_NEGOTIABLE.getCode() - || errorCode == ErrorCode.OFFER_COMPARE_TOO_MANY.getCode()) - return HttpStatus.BAD_REQUEST; - return HttpStatus.BAD_REQUEST; - } - - @ExceptionHandler(SalaryPolicyVersionConflictException.class) - public ResponseEntity>> handleSalaryPolicyVersionConflict( - SalaryPolicyVersionConflictException ex, HttpServletRequest request) { - Map details = new LinkedHashMap<>(); - details.put("latestPolicyVersion", ex.getLatestPolicyVersion()); - details.put("policyEffectiveDate", ex.getLatestPolicyEffectiveDate()); - ApiResponse> body = ApiResponse.error( - ErrorCode.SALARY_POLICY_VERSION_CONFLICT.getCode(), - ErrorCode.SALARY_POLICY_VERSION_CONFLICT.getMessage(), - getRequestId(request)); - body.setData(details); - return ResponseEntity.status(HttpStatus.CONFLICT).body(body); - } @ExceptionHandler(MethodArgumentNotValidException.class) public ResponseEntity> handleValidationException( MethodArgumentNotValidException ex, HttpServletRequest request) { @@ -261,6 +120,17 @@ public class GlobalExceptionHandler { .body(ApiResponse.forbidden("access denied", getRequestId(request))); } + @ExceptionHandler(NoResourceFoundException.class) + public ResponseEntity> handleNoResourceFound( + NoResourceFoundException ex, HttpServletRequest request) { + // S03-C 整改：业务端口 /actuator/** 等不存在资源统一返回 404。 + // 只记录固定文案与归一化 requestId，不回显异常 message、资源路径或堆栈。 + log.warn("No resource found: requestId={}", getRequestId(request)); + return ResponseEntity + .status(HttpStatus.NOT_FOUND) + .body(ApiResponse.error(404, "not found", getRequestId(request))); + } + @ExceptionHandler(Exception.class) public ResponseEntity> handleGenericException( Exception ex, HttpServletRequest request) { @@ -271,11 +141,6 @@ public class GlobalExceptionHandler { } private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return requestIdAccessor.get(request); } } - - - - - diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdAccessor.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdAccessor.java new file mode 100644 index 0000000..a822e3e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdAccessor.java @@ -0,0 +1,37 @@ +package com.mydreamjob.common.logging; + +import jakarta.servlet.http.HttpServletRequest; +import org.springframework.stereotype.Component; + +/** + * 请求 ID 读取器：读取 requestId 的**唯一入口**，保证响应头、MDC、Controller 响应体、 + * {@code AuditContext} 与异常响应使用同一个值。 + * + *

取值优先级：

+ *
    + *
  1. {@link RequestIdFilter} 写入的请求属性（规范化后的值）；
    2. + *
  2. 请求头 {@code X-Request-Id} —— 过滤器已通过请求包装器把它替换为规范化值， + * 因此这里得到的仍是同一个值；若调用路径绕过了过滤器，则由 + * {@link RequestIdFilter#normalizeRequestId(String)} 按同一规则收敛， + * **不会**把超长或非法客户端头原样返回。
    3. + *
+ * + *

本类不产生第二套生成规则：缺失或空白时复用过滤器同一处 + * {@code normalizeRequestId} 逻辑。

+ */ +@Component +public class RequestIdAccessor { + + /** 读取当前请求的规范化 requestId。 */ + public String get(HttpServletRequest request) { + if (request == null) { + return RequestIdFilter.normalizeRequestId(null); + } + Object attribute = request.getAttribute(RequestIdFilter.REQUEST_ID_ATTRIBUTE); + if (attribute instanceof String value && !value.isBlank()) { + return value; + } + // 过滤器未执行时的兜底：仍按过滤器同一规则收敛，绝不直接回显客户端原值。 + return RequestIdFilter.normalizeRequestId(request.getHeader(RequestIdFilter.REQUEST_ID_HEADER)); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdFilter.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdFilter.java index 43f4bbf..42997c6 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdFilter.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/logging/RequestIdFilter.java @@ -11,20 +11,32 @@ import java.util.Collections; import java.util.UUID; /** - * 请求 ID 过滤器：为每个请求生成/传递唯一 ID，便于日志追踪 + * 请求 ID 过滤器：为每个请求生成/传递唯一 ID，便于日志追踪。 + * + *

本过滤器是 requestId 的**唯一产出点**：规范化后的值同时写入请求属性 + * {@link #REQUEST_ID_ATTRIBUTE}、MDC、响应头，并覆盖请求包装器的 {@code X-Request-Id} + * 头，使 Controller、{@code AuditContext} 与异常响应读到同一个值。

*/ @Component public class RequestIdFilter extends OncePerRequestFilter { - private static final String REQUEST_ID_HEADER = "X-Request-Id"; - private static final String REQUEST_ID_ATTR = "requestId"; + /** 客户端可传入的请求头名；同时是响应头名。 */ + static final String REQUEST_ID_HEADER = "X-Request-Id"; + + /** + * 规范化 requestId 的请求属性名。下游（Controller、异常处理器）应通过 + * {@link RequestIdAccessor} 读取，而不是各自解析请求头。 + */ + public static final String REQUEST_ID_ATTRIBUTE = "requestId"; + private static final int MAX_REQUEST_ID_LENGTH = 32; @Override protected void doFilterInternal(HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, jakarta.servlet.FilterChain filterChain) throws IOException, jakarta.servlet.ServletException { String requestId = normalizeRequestId(request.getHeader(REQUEST_ID_HEADER)); - MDC.put(REQUEST_ID_ATTR, requestId); + request.setAttribute(REQUEST_ID_ATTRIBUTE, requestId); + MDC.put(REQUEST_ID_ATTRIBUTE, requestId); response.setHeader(REQUEST_ID_HEADER, requestId); try { // Controllers and AuditContext read the request header directly. Wrap the @@ -50,17 +62,35 @@ public class RequestIdFilter extends OncePerRequestFilter { }; filterChain.doFilter(normalizedRequest, response); } finally { - MDC.remove(REQUEST_ID_ATTR); + MDC.remove(REQUEST_ID_ATTRIBUTE); } } static String normalizeRequestId(String candidate) { String value = candidate == null ? "" : candidate.trim(); - if (value.isEmpty()) { - return UUID.randomUUID().toString().replace("-", "").substring(0, 16); + if (value.isEmpty() || !hasOnlySafeCharacters(value)) { + return generatedRequestId(); } return value.length() <= MAX_REQUEST_ID_LENGTH ? value : value.substring(0, MAX_REQUEST_ID_LENGTH); } + + private static boolean hasOnlySafeCharacters(String value) { + for (int i = 0; i < value.length(); i++) { + char c = value.charAt(i); + boolean safe = c >= 'a' && c <= 'z' + || c >= 'A' && c <= 'Z' + || c >= '0' && c <= '9' + || c == '.' || c == '_' || c == ':' || c == '-'; + if (!safe) { + return false; + } + } + return true; + } + + private static String generatedRequestId() { + return UUID.randomUUID().toString().replace("-", "").substring(0, 16); + } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/common/time/TimeConfig.java b/mydreamjob-server/src/main/java/com/mydreamjob/common/time/TimeConfig.java new file mode 100644 index 0000000..25ad109 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/common/time/TimeConfig.java @@ -0,0 +1,18 @@ +package com.mydreamjob.common.time; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import java.time.Clock; + +/** + * 可注入的 {@link Clock}，便于在计时与超时边界测试中固定时间（V36）。 + */ +@Configuration +public class TimeConfig { + + @Bean + public Clock clock() { + return Clock.systemDefaultZone(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyController.java b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyController.java index fadc773..5bd872a 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyController.java @@ -12,8 +12,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.HashMap; @@ -25,7 +23,20 @@ import java.util.Map; @RequiredArgsConstructor public class CompanyController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CompanyService companyService; + private final CompanyOnboardingService companyOnboardingService; + + @Operation(summary = "查询企业入驻状态", description = "返回当前企业资料、认证状态和允许动作") + @GetMapping("/me/onboarding") + public ResponseEntity> getMyOnboarding(HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(companyOnboardingService.get(userId), requestIdAccessor.get(request))); + } // ── 创建 ────────────────────────────────────────────────── @@ -34,9 +45,9 @@ public class CompanyController { public ResponseEntity>> createMyCompany( @Valid @RequestBody CompanyCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Company company = companyService.createCompany(userId, req); - return ResponseEntity.ok(ApiResponse.ok(companyService.toView(company), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(companyService.toView(company), requestIdAccessor.get(request))); } // ── 查询 ────────────────────────────────────────────────── @@ -44,13 +55,13 @@ public class CompanyController { @Operation(summary = "查询当前企业资料", description = "返回当前登录用户绑定的企业资料，未绑定企业返回 404") @GetMapping("/me") public ResponseEntity>> getMyCompany(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = companyService.toView(companyService.findCompanyByOwnerUserId(userId)); if (view == null) { return ResponseEntity.status(404).body( - ApiResponse.error(404, "company not found", getRequestId(request))); + ApiResponse.error(404, "company not found", requestIdAccessor.get(request))); } - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 更新 ────────────────────────────────────────────────── @@ -60,9 +71,9 @@ public class CompanyController { public ResponseEntity>> updateMyCompany( @Valid @RequestBody CompanyUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = companyService.toView(companyService.updateCompany(userId, req)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 公开端：企业详情 ──────────────────────────────────────── @@ -73,7 +84,7 @@ public class CompanyController { @PathVariable Long companyId, HttpServletRequest request) { CompanyPublicView view = companyService.getPublicCompany(companyId); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 公开端：企业岗位列表 ──────────────────────────────────── @@ -93,19 +104,7 @@ public class CompanyController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingResponse.java new file mode 100644 index 0000000..ea9ff2f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingResponse.java @@ -0,0 +1,20 @@ +package com.mydreamjob.company; + +import java.time.LocalDateTime; +import java.util.List; + +public record CompanyOnboardingResponse( + CompanySummary company, + String onboardingStatus, + VerificationSummary latestVerification, + List missingFields, + List allowedActions) { + + public record CompanySummary(Long id, String name, String logoUrl, String description, + String industry, String website, String address, Boolean verified) { + } + + public record VerificationSummary(Long id, String status, LocalDateTime submittedAt, + LocalDateTime decidedAt) { + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingService.java b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingService.java new file mode 100644 index 0000000..809b892 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyOnboardingService.java @@ -0,0 +1,69 @@ +package com.mydreamjob.company; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.verification.CompanyVerification; +import com.mydreamjob.verification.CompanyVerificationRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.ArrayList; +import java.util.List; + +@Service +@RequiredArgsConstructor +public class CompanyOnboardingService { + private final UserRoleGuard userRoleGuard; + private final CompanyRepository companyRepository; + private final CompanyVerificationRepository verificationRepository; + + @Transactional(readOnly = true) + public CompanyOnboardingResponse get(Long userId) { + userRoleGuard.requireCompany(userId); + Company company = companyRepository.findByOwnerUserId(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.COMPANY_NOT_FOUND)); + CompanyVerification latest = verificationRepository.findTopByCompanyIdOrderByIdDesc(company.getId()) + .orElse(null); + + String status; + if (Boolean.TRUE.equals(company.getVerified())) { + status = "VERIFIED"; + } else if (latest == null) { + status = "UNVERIFIED"; + } else if ("PENDING".equals(latest.getStatus()) || "RESUBMITTED".equals(latest.getStatus())) { + status = "PENDING"; + } else if ("REJECTED".equals(latest.getStatus())) { + status = "REJECTED"; + } else if ("APPROVED".equals(latest.getStatus())) { + throw new BusinessException(ErrorCode.COMPANY_ONBOARDING_INCONSISTENT_STATE); + } else { + throw new BusinessException(ErrorCode.COMPANY_ONBOARDING_INCONSISTENT_STATE); + } + + List missing = new ArrayList<>(); + if (isBlank(company.getName())) missing.add("name"); + if (isBlank(company.getIndustry())) missing.add("industry"); + if (isBlank(company.getDescription())) missing.add("description"); + if (isBlank(company.getAddress())) missing.add("address"); + + List actions = switch (status) { + case "UNVERIFIED", "REJECTED" -> List.of("UPDATE_PROFILE", "SUBMIT_VERIFICATION"); + case "PENDING" -> List.of("UPDATE_PROFILE", "WAIT_REVIEW"); + case "VERIFIED" -> List.of("ENTER_COMPANY_WORKSPACE"); + default -> List.of(); + }; + CompanyOnboardingResponse.VerificationSummary verification = latest == null ? null + : new CompanyOnboardingResponse.VerificationSummary(latest.getId(), latest.getStatus(), + latest.getSubmittedAt(), latest.getDecidedAt()); + CompanyOnboardingResponse.CompanySummary summary = new CompanyOnboardingResponse.CompanySummary( + company.getId(), company.getName(), company.getLogoUrl(), company.getDescription(), + company.getIndustry(), company.getWebsite(), company.getAddress(), company.getVerified()); + return new CompanyOnboardingResponse(summary, status, verification, missing, actions); + } + + private boolean isBlank(String value) { + return value == null || value.isBlank(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyRepository.java index 31aca0d..b91caf9 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyRepository.java @@ -1,6 +1,10 @@ package com.mydreamjob.company; +import jakarta.persistence.LockModeType; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Lock; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; import java.util.Optional; @@ -10,5 +14,9 @@ public interface CompanyRepository extends JpaRepository { Optional findByOwnerUserId(Long ownerUserId); + @Lock(LockModeType.PESSIMISTIC_WRITE) + @Query("select c from Company c where c.id = :id") + Optional findByIdForUpdate(@Param("id") Long id); + boolean existsByOwnerUserId(Long ownerUserId); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyService.java b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyService.java index d1265b9..dcfd781 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/company/CompanyService.java @@ -25,37 +25,28 @@ import java.util.Map; @Service public class CompanyService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final CompanyRepository companyRepository; private final UserRepository userRepository; private final JobService jobService; public CompanyService(CompanyRepository companyRepository, UserRepository userRepository, - JobService jobService) { + JobService jobService, + com.mydreamjob.security.UserRoleGuard userRoleGuard) { this.companyRepository = companyRepository; this.userRepository = userRepository; this.jobService = jobService; + this.userRoleGuard = userRoleGuard; } // ── 角色校验（最先执行）─────────────────────────────────── public void assertCompanyRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isCompany = user.getRoles().stream() - .anyMatch(r -> r == User.Role.COMPANY); - if (!isCompany) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireCompany(userId); } public void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream() - .anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireStudent(userId); } // ── 业务方法 ────────────────────────────────────────────── diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingCalculator.java index 5827ef7..2e509e0 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingCalculator.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingCalculator.java @@ -4,6 +4,7 @@ import com.mydreamjob.application.Application; import com.mydreamjob.candidatescore.CandidateDimensionScore; import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.CandidateOverviewStatusPolicy; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Component; @@ -99,7 +100,7 @@ public class CompetitionRankingCalculator { BigDecimal percentile = computePercentile(rows, me); List meSnaps = latestByStudent.getOrDefault(meId, List.of()); - String status = overviewStatus(meSnaps); + String status = CandidateOverviewStatusPolicy.fromSnapshots(meSnaps); String myPeriod = me == null ? null : me.snapshotPeriod; return new CohortRanking(rows.size(), rows, me, rank, @@ -123,17 +124,6 @@ public class CompetitionRankingCalculator { .setScale(2, RoundingMode.HALF_UP); } - /** 综合卡状态：OK / PARTIAL / INSUFFICIENT_DATA / PENDING（复用引擎语义） */ - public String overviewStatus(List snaps) { - if (snaps == null || snaps.isEmpty()) return "INSUFFICIENT_DATA"; - long computable = snaps.stream() - .filter(s -> "OK".equals(s.getStatus()) || "ESTIMATED".equals(s.getStatus())).count(); - if (computable == snaps.size()) return "OK"; - if (computable > 0) return "PARTIAL"; - boolean allPending = snaps.stream().allMatch(s -> "PENDING".equals(s.getStatus())); - return allPending ? "PENDING" : "INSUFFICIENT_DATA"; - } - /** 排序载体（不参与响应序列化） */ public static class Row { public final Long studentUserId; @@ -178,4 +168,4 @@ public class CompetitionRankingCalculator { this.meSnaps = meSnaps; } } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingController.java b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingController.java index 84d1a1f..d18c313 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingController.java @@ -1,17 +1,15 @@ package com.mydreamjob.competition; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.competition.dto.CompetitionRankingResponse; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.responses.ApiResponses; 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.RestController; @@ -28,6 +26,8 @@ import org.springframework.web.bind.annotation.RestController; public class CompetitionRankingController { private final CompetitionRankingService competitionRankingService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "同岗位竞争力排名", description = "仅 STUDENT 且已投递该岗位；返回本人排名/综合分/百分位/维度/缺口及匿名 Top 5。" @@ -42,20 +42,8 @@ public class CompetitionRankingController { @GetMapping("/jobs/{jobId}/competition-ranking") public ResponseEntity> getRanking( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CompetitionRankingResponse data = competitionRankingService.getRanking(userId, jobId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingService.java b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingService.java index 8bb281d..c53a24e 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/competition/CompetitionRankingService.java @@ -39,17 +39,19 @@ public class CompetitionRankingService { private static final int TOP_N = 5; + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final UserRepository userRepository; private final JobService jobService; private final ApplicationRepository applicationRepository; private final CompetitionRankingCalculator rankingCalculator; + private final CandidateScoringCalculator candidateScoringCalculator; @Transactional(readOnly = true) public CompetitionRankingResponse getRanking(Long studentUserId, Long jobId) { if (jobId == null || jobId <= 0) { throw new BusinessException(ErrorCode.BAD_REQUEST); } - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); // 仅 PUBLISHED 岗位可查看未公开状态统一 404，避免暴露岗位候选人池 Job job = jobService.getJob(jobId); @@ -105,7 +107,7 @@ public class CompetitionRankingService { .dimensions(buildDimensions(cr.meSnaps)) .gaps(buildGaps(cr.meSnaps)) .topCandidates(top) - .rulesVersion(CandidateScoringCalculator.RULES_VERSION) + .rulesVersion(candidateScoringCalculator.currentRulesVersion()) .generatedAt(Instant.now()) .build(); } @@ -145,16 +147,6 @@ public class CompetitionRankingService { } // ── 身份与工具 ───────────────────────────────────────────── - - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - private String yearMonth(LocalDate d) { return String.format("%04d-%02d", d.getYear(), d.getMonthValue()); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/config/AdminBootstrapProperties.java b/mydreamjob-server/src/main/java/com/mydreamjob/config/AdminBootstrapProperties.java new file mode 100644 index 0000000..38c3d7c --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/config/AdminBootstrapProperties.java @@ -0,0 +1,28 @@ +package com.mydreamjob.config; + +import lombok.Getter; +import lombok.Setter; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +/** + * S03-A 一次性管理员初始化配置。 + * + *

默认关闭；只有显式把开关设为字面量 {@code "true"} 才会装配初始化器。 + * 手机号只能来自环境变量，**没有默认值**，因此不会误建管理员。

+ */ +@Getter +@Setter +@Component +@ConfigurationProperties(prefix = "app.bootstrap.admin") +public class AdminBootstrapProperties { + + /** 是否启用一次性管理员初始化（严格 true 才生效）。 */ + private String enabled = "false"; + + /** 管理员手机号；无默认值，必须由部署方显式提供。 */ + private String phone = ""; + + /** 管理员昵称。 */ + private String nickname = "平台管理员"; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/config/AppJwtProperties.java b/mydreamjob-server/src/main/java/com/mydreamjob/config/AppJwtProperties.java new file mode 100644 index 0000000..0a86b9a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/config/AppJwtProperties.java @@ -0,0 +1,90 @@ +package com.mydreamjob.config; + +import jakarta.annotation.PostConstruct; +import lombok.Getter; +import lombok.Setter; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +/** + * S02 Access/Refresh Token 隔离配置。 + * + *

Access 与 Refresh 使用独立签名密钥，Token 摘要另用独立密钥；三项密钥 + * 均不得缺失、不得为空、不得互相回退，且必须两两不同。

+ * + *

校验失败时抛出固定安全文本的异常，**不回显密钥值本身**。

+ */ +@Getter +@Setter +@Component +@ConfigurationProperties(prefix = "app.jwt") +public class AppJwtProperties { + + /** HMAC-SHA256 最小密钥长度（256 bit）。 */ + static final int MIN_SECRET_LENGTH = 32; + + /** + * 旧配置迁移项。S02 新签发的 Token 不使用该密钥，保留仅为兼容既有部署的环境变量， + * 因此不参与下面的长度与互异性校验。 + */ + private String secret; + + private String accessSecret; + private String refreshSecret; + private String tokenHashSecret; + + private long expirationMs = 86_400_000L; + private long refreshExpirationMs = 604_800_000L; + + private String issuer = "mydreamjob"; + private String accessAudience = "mydreamjob-api"; + private String refreshAudience = "mydreamjob-auth"; + + @PostConstruct + void validate() { + requireStrong("JWT_ACCESS_SECRET", accessSecret); + requireStrong("JWT_REFRESH_SECRET", refreshSecret); + requireStrong("JWT_TOKEN_HASH_SECRET", tokenHashSecret); + + // 三项必须两两不同：任一回退或被复用都会削弱隔离。 + requireDistinct("JWT_ACCESS_SECRET", accessSecret, "JWT_REFRESH_SECRET", refreshSecret); + requireDistinct("JWT_ACCESS_SECRET", accessSecret, "JWT_TOKEN_HASH_SECRET", tokenHashSecret); + requireDistinct("JWT_REFRESH_SECRET", refreshSecret, "JWT_TOKEN_HASH_SECRET", tokenHashSecret); + + requirePositive("JWT_EXPIRATION_MS", expirationMs); + requirePositive("JWT_REFRESH_EXPIRATION_MS", refreshExpirationMs); + + requireText("app.jwt.issuer", issuer); + requireText("app.jwt.access-audience", accessAudience); + requireText("app.jwt.refresh-audience", refreshAudience); + } + + private void requireStrong(String name, String value) { + if (value == null || value.isBlank()) { + throw new IllegalStateException("invalid jwt configuration: " + name + " must be set"); + } + if (value.length() < MIN_SECRET_LENGTH) { + throw new IllegalStateException("invalid jwt configuration: " + name + + " must be at least " + MIN_SECRET_LENGTH + " characters"); + } + } + + private void requireDistinct(String nameA, String valueA, String nameB, String valueB) { + if (valueA.equals(valueB)) { + throw new IllegalStateException("invalid jwt configuration: " + nameA + + " and " + nameB + " must differ"); + } + } + + private void requirePositive(String name, long value) { + if (value <= 0) { + throw new IllegalStateException("invalid jwt configuration: " + name + " must be positive"); + } + } + + private void requireText(String name, String value) { + if (value == null || value.isBlank()) { + throw new IllegalStateException("invalid jwt configuration: " + name + " must be set"); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/config/SecurityConfig.java b/mydreamjob-server/src/main/java/com/mydreamjob/config/SecurityConfig.java index fe2cb40..b0f669c 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/config/SecurityConfig.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/config/SecurityConfig.java @@ -60,24 +60,46 @@ public class SecurityConfig { "{\"code\":403,\"message\":\"access denied\",\"timestamp\":\"\"}"); })) .authorizeHttpRequests(auth -> auth - // Actuator 健康检查 - .requestMatchers("/actuator/health/**").permitAll() - .requestMatchers("/actuator/info").permitAll() + // S03-C 整改：业务端口统一放行 /actuator/**。 + // Actuator 端点仍只注册在独立管理端口（默认 127.0.0.1），业务端口上 + // /actuator/** 全部落入 MVC 的不存在资源处理，由 GlobalExceptionHandler 的 + // NoResourceFoundException 精确映射为 404 —— 避免匿名请求先被认证层 + // 拦截成 401（未放行路径）或落入通用异常映射成 500（放行路径）。 + // permitAll 不代表暴露指标，只保证所有 /actuator/** 都走到同一 404 语义； + // 业务端口不得新增任何 Actuator Controller 或端点映射。 + .requestMatchers("/actuator/**").permitAll() // Swagger UI .requestMatchers("/swagger-ui/**", "/v3/api-docs/**", "/api-docs/**").permitAll() // 健康检查 API .requestMatchers("/health/**").permitAll() .requestMatchers("/health").permitAll() + // 平台维护的岗位推荐分类字典（公开只读） + .requestMatchers(HttpMethod.GET, "/job-recommendation-taxonomies").permitAll() // 认证相关 .requestMatchers("/auth/sms/send").permitAll() .requestMatchers("/auth/login").permitAll() + .requestMatchers("/auth/password/login").permitAll() + .requestMatchers("/auth/company/register").permitAll() + .requestMatchers("/auth/password/reset").permitAll() .requestMatchers("/auth/register").permitAll() + // S02：刷新允许匿名进入 Controller；是否成功仍取决于 Refresh Token 校验。 + // permitAll 只表示可进入，不代表 Token 有效。 + .requestMatchers("/auth/refresh").permitAll() // 当前用户 .requestMatchers("/auth/me").authenticated() - // 行业技能词云（需登录，仅 STUDENT，Controller 层校验角色） - .requestMatchers(HttpMethod.GET, "/skills/**").authenticated() + // S02：登出必须已认证 + .requestMatchers("/auth/logout").authenticated() + .requestMatchers("/auth/password/set").authenticated() + .requestMatchers("/auth/password/change").authenticated() // 企业资料（需登录） .requestMatchers("/companies/me/**").authenticated() + // V41 学生人才发现授权与企业人才发现推荐（角色和归属由 Service 校验） + .requestMatchers("/profile/me/talent-discovery").authenticated() + .requestMatchers("/companies/me/jobs/*/talent-recommendations").authenticated() + // V42 企业人才邀约与学生决策（角色和租户归属由 Service 二次校验） + .requestMatchers("/companies/me/jobs/*/talent-invitations/**").authenticated() + .requestMatchers("/companies/me/talent-invitations/**").authenticated() + .requestMatchers("/profile/me/talent-invitations/**").authenticated() // 企业公开岗位列表（匿名 GET） .requestMatchers(HttpMethod.GET, "/companies/*/jobs").permitAll() // 企业公开主页（匿名 GET） @@ -104,14 +126,12 @@ public class SecurityConfig { .requestMatchers("/jobs/*/favorite").authenticated() .requestMatchers("/jobs/favorites").authenticated() .requestMatchers("/jobs/*/reviews/**").authenticated() - // 企业回复评价（公开查询，写操作需登录） - .requestMatchers(HttpMethod.GET, "/reviews/*/reply").permitAll() - .requestMatchers("/reviews/*/reply").authenticated() // 个性化评分（需登录，仅 STUDENT，Service 层校验） .requestMatchers(HttpMethod.GET, "/jobs/*/personalized-review-score").authenticated() // 岗位公开查询 .requestMatchers("/jobs/public/**").permitAll() - .requestMatchers("/jobs").permitAll() + // 仅公开岗位列表为匿名可读；写操作必须命中下方的 /jobs/** → authenticated + .requestMatchers(HttpMethod.GET, "/jobs").permitAll() // 岗位搜索与筛选（公开） .requestMatchers(HttpMethod.GET, "/jobs/search").permitAll() .requestMatchers(HttpMethod.GET, "/jobs/filters").permitAll() @@ -126,10 +146,10 @@ public class SecurityConfig { .requestMatchers("/company/scoring/dashboard/**").authenticated() // 面试（需登录） .requestMatchers("/interviews/**").authenticated() - // 入职清单与公司知识（需登录；细粒度角色/所有权在 Service 校验） - .requestMatchers("/onboarding/**").authenticated() - // 薪资计算器（需登录；仅 STUDENT 在 Service 校验） - .requestMatchers("/salary-calculator/**").authenticated() + // RIASEC 职业兴趣测评（需登录；类型/题目任意登录用户，答卷仅 STUDENT 由 Service 层校验） + .requestMatchers("/assessments/**").authenticated() + // 四维能力测评（需登录；类型任意登录用户，答卷仅 STUDENT 本人由 Service 层校验） + .requestMatchers("/abilities/**").authenticated() // API 信息入口 .requestMatchers("/").permitAll() .anyRequest().authenticated() @@ -159,4 +179,3 @@ public class SecurityConfig { return new BCryptPasswordEncoder(); } } - diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/controller/ApiController.java b/mydreamjob-server/src/main/java/com/mydreamjob/controller/ApiController.java index bc1b704..3a75f3c 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/controller/ApiController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/controller/ApiController.java @@ -4,6 +4,7 @@ import com.mydreamjob.common.api.ApiResponse; 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.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; @@ -16,9 +17,15 @@ import java.util.Map; */ @Tag(name = "API", description = "API 信息入口") @RestController +@RequiredArgsConstructor @RequestMapping public class ApiController { + /** R01-A6：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A6：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + @Operation(summary = "API 信息", description = "返回 API v0.1 基本信息") @GetMapping("/") public ResponseEntity>> index(HttpServletRequest request) { @@ -35,10 +42,7 @@ public class ApiController { ), "docs", "http://localhost:8080/swagger-ui.html" ); - return ResponseEntity.ok(ApiResponse.ok(info, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(info, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java b/mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java index c77d012..d7c66ca 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/controller/AuthController.java @@ -1,12 +1,26 @@ package com.mydreamjob.controller; import com.mydreamjob.auth.AuthService; -import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.auth.AuthSessionService; +import com.mydreamjob.auth.InvalidTokenException; import com.mydreamjob.auth.LoginRequest; import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.auth.dto.RefreshTokenRequest; +import com.mydreamjob.auth.dto.TokenPairResponse; +import com.mydreamjob.auth.dto.PasswordChangeRequest; +import com.mydreamjob.auth.dto.PasswordLoginRequest; +import com.mydreamjob.auth.dto.PasswordOperationResponse; +import com.mydreamjob.auth.dto.PasswordResetRequest; +import com.mydreamjob.auth.dto.PasswordSetRequest; +import com.mydreamjob.auth.password.PasswordAuthenticationService; +import com.mydreamjob.auth.company.CompanyRegistrationRequest; +import com.mydreamjob.auth.company.CompanyRegistrationResponse; +import com.mydreamjob.auth.company.CompanyRegistrationService; +import com.mydreamjob.audit.AuditContext; import com.mydreamjob.common.api.ApiResponse; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -16,29 +30,41 @@ import jakarta.validation.constraints.NotBlank; import jakarta.validation.constraints.Pattern; import lombok.RequiredArgsConstructor; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; -import java.util.HashMap; import java.util.Map; /** * 认证相关接口 + * + *

S02：新增 {@code /auth/refresh} 与 {@code /auth/logout}。Controller 只做参数接收、 + * 身份解析和响应包装，不计算摘要、不解析 JWT、不访问 Repository，也不重复实现会话逻辑。

*/ -@Tag(name = "认证", description = "登录、验证码、用户信息") +@Tag(name = "认证", description = "登录、验证码、Token 刷新与登出、用户信息") @RestController @RequestMapping("/auth") @RequiredArgsConstructor @Validated public class AuthController { + /** R01-A6：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; private final AuthService authService; private final SmsVerificationService smsVerificationService; - private final JwtTokenProvider jwtTokenProvider; + private final CurrentUserAccessor currentUserAccessor; + private final PasswordAuthenticationService passwordAuthenticationService; + private final CompanyRegistrationService companyRegistrationService; - @Operation(summary = "发送短信验证码（Mock）", description = "开发环境 Mock：验证码会打印到日志") + @Operation(summary = "企业注册", description = "使用 company-register 短信验证码创建企业账号和企业资料") + @PostMapping("/company/register") + public ResponseEntity> companyRegister( + @Valid @RequestBody CompanyRegistrationRequest body, HttpServletRequest request) { + CompanyRegistrationResponse response = companyRegistrationService.register(body, AuditContext.from(request)); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); + } + + @Operation(summary = "发送短信验证码", description = "开发/测试使用 Mock 发送实现；生产环境未接入短信网关时返回服务不可用。验证码不会写入日志。") @PostMapping("/sms/send") public ResponseEntity>> sendSmsCode( @RequestParam @NotBlank(message = "phone is required") @@ -47,22 +73,22 @@ public class AuthController { HttpServletRequest request) { try { smsVerificationService.sendCode(phone, purpose, - getRequestId(request), + requestIdAccessor.get(request), request.getRemoteAddr(), request.getHeader("User-Agent")); return ResponseEntity.ok(ApiResponse.ok( Map.of("message", "验证码已发送（Mock）"), - getRequestId(request))); + requestIdAccessor.get(request))); } catch (ConstraintViolationException e) { return ResponseEntity.badRequest().body( - ApiResponse.badRequest(e.getMessage(), getRequestId(request))); + ApiResponse.badRequest(e.getMessage(), requestIdAccessor.get(request))); } catch (Exception e) { return ResponseEntity.badRequest().body( - ApiResponse.error(400, e.getMessage(), getRequestId(request))); + ApiResponse.error(400, e.getMessage(), requestIdAccessor.get(request))); } } - @Operation(summary = "Mock 登录", description = "使用手机号+验证码登录，返回 JWT token") + @Operation(summary = "Mock 登录", description = "使用手机号+验证码登录，返回 Access/Refresh Token 并创建服务端登录会话") @PostMapping("/login") public ResponseEntity>> mockLogin( @Valid @RequestBody LoginRequest body, @@ -73,10 +99,10 @@ public class AuthController { ? "login" : body.getPurpose(); try { Map result = authService.mockLogin(phone, code, purpose, - getRequestId(request), + requestIdAccessor.get(request), request.getRemoteAddr(), request.getHeader("User-Agent")); - return ResponseEntity.ok(ApiResponse.ok(result, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(result, requestIdAccessor.get(request))); } catch (BusinessException e) { // 已注销手机号：保留 HTTP 409 / 业务 code=9303，交由全局异常处理器映射。 // 其余业务异常（如验证码错误、参数校验）维持既有 400/code=400 行为。 @@ -84,26 +110,139 @@ public class AuthController { throw e; } return ResponseEntity.badRequest().body( - ApiResponse.error(400, e.getMessage(), getRequestId(request))); + ApiResponse.error(400, e.getMessage(), requestIdAccessor.get(request))); } catch (Exception e) { return ResponseEntity.badRequest().body( - ApiResponse.error(400, e.getMessage(), getRequestId(request))); + ApiResponse.error(400, e.getMessage(), requestIdAccessor.get(request))); } } + @Operation(summary = "手机号密码登录", description = "使用手机号和密码登录，返回 Access/Refresh Token；不自动创建账号") + @PostMapping("/password/login") + public ResponseEntity>> passwordLogin( + @Valid @RequestBody PasswordLoginRequest body, HttpServletRequest request) { + try { + return ResponseEntity.ok(ApiResponse.ok(passwordAuthenticationService.login( + body.getPhone(), body.getPassword(), requestIdAccessor.get(request), + request.getRemoteAddr(), request.getHeader("User-Agent")), requestIdAccessor.get(request))); + } catch (BusinessException e) { + if (e.getErrorCodeInt() == ErrorCode.SERVICE_UNAVAILABLE.getCode()) { + return ResponseEntity.status(503).body(ApiResponse.error(503, + "authentication service temporarily unavailable", requestIdAccessor.get(request))); + } + throw e; + } + } + + @Operation(summary = "首次设置密码") + @PostMapping("/password/set") + public ResponseEntity> setPassword( + @Valid @RequestBody PasswordSetRequest body, HttpServletRequest request) { + try { + Long userId = currentUserAccessor.requireUserId(); + PasswordAuthenticationService.PasswordOperationResult result = passwordAuthenticationService.setPassword( + userId, body.getSmsCode(), body.getNewPassword(), requestIdAccessor.get(request), + request.getRemoteAddr(), request.getHeader("User-Agent")); + return ResponseEntity.ok(ApiResponse.ok( + new PasswordOperationResponse(result.passwordConfigured(), result.reauthenticationRequired()), + requestIdAccessor.get(request))); + } catch (BusinessException e) { + if (e.getErrorCodeInt() == ErrorCode.SERVICE_UNAVAILABLE.getCode()) { + return ResponseEntity.status(503).body(ApiResponse.error(503, + "authentication service temporarily unavailable", requestIdAccessor.get(request))); + } + throw e; + } + } + + @Operation(summary = "修改密码") + @PostMapping("/password/change") + public ResponseEntity> changePassword( + @Valid @RequestBody PasswordChangeRequest body, HttpServletRequest request) { + try { + Long userId = currentUserAccessor.requireUserId(); + PasswordAuthenticationService.PasswordOperationResult result = passwordAuthenticationService.changePassword( + userId, body.getCurrentPassword(), body.getNewPassword(), requestIdAccessor.get(request), + request.getRemoteAddr(), request.getHeader("User-Agent")); + return ResponseEntity.ok(ApiResponse.ok( + new PasswordOperationResponse(result.passwordConfigured(), result.reauthenticationRequired()), + requestIdAccessor.get(request))); + } catch (BusinessException e) { + if (e.getErrorCodeInt() == ErrorCode.SERVICE_UNAVAILABLE.getCode()) { + return ResponseEntity.status(503).body(ApiResponse.error(503, + "authentication service temporarily unavailable", requestIdAccessor.get(request))); + } + throw e; + } + } + + @Operation(summary = "短信找回并重置密码") + @PostMapping("/password/reset") + public ResponseEntity> resetPassword( + @Valid @RequestBody PasswordResetRequest body, HttpServletRequest request) { + try { + PasswordAuthenticationService.PasswordOperationResult result = passwordAuthenticationService.resetPassword( + body.getPhone(), body.getSmsCode(), body.getNewPassword(), requestIdAccessor.get(request), + request.getRemoteAddr(), request.getHeader("User-Agent")); + return ResponseEntity.ok(ApiResponse.ok( + new PasswordOperationResponse(result.passwordConfigured(), result.reauthenticationRequired()), + requestIdAccessor.get(request))); + } catch (BusinessException e) { + if (e.getErrorCodeInt() == ErrorCode.SERVICE_UNAVAILABLE.getCode()) { + return ResponseEntity.status(503).body(ApiResponse.error(503, + "authentication service temporarily unavailable", requestIdAccessor.get(request))); + } + throw e; + } + } + + @Operation(summary = "刷新 Token", + description = "使用 Refresh Token 换取新的 Access/Refresh Token 对；旧 Refresh Token 立即失效") + @PostMapping("/refresh") + public ResponseEntity> refresh( + @Valid @RequestBody RefreshTokenRequest body, + HttpServletRequest request) { + try { + AuthSessionService.SessionTokens tokens = authService.refresh( + body.getRefreshToken(), + requestIdAccessor.get(request), + request.getRemoteAddr(), + request.getHeader("User-Agent")); + return ResponseEntity.ok(ApiResponse.ok( + new TokenPairResponse(tokens.accessToken(), tokens.refreshToken(), + AuthService.EXPIRES_IN_SECONDS), + requestIdAccessor.get(request))); + } catch (InvalidTokenException e) { + // 统一 401：不说明 Token 不存在、已消费、已撤销还是重放，也不回显任何 Token。 + return unauthorized(request); + } + } + + @Operation(summary = "登出", + description = "撤销当前登录会话；需要 Access Token，不接受任何请求体") + @PostMapping("/logout") + public ResponseEntity>> logout(HttpServletRequest request) { + // 身份与会话一律来自通过校验的 Access Token，不接受客户端传入 userId/sessionId。 + Long userId = currentUserAccessor.requireUserId(); + String sessionId = currentUserAccessor.requireSessionId(); + authService.logout(userId, sessionId, + requestIdAccessor.get(request), + request.getRemoteAddr(), + request.getHeader("User-Agent")); + return ResponseEntity.ok(ApiResponse.ok( + Map.of("message", "logged out"), requestIdAccessor.get(request))); + } + @Operation(summary = "当前用户信息", description = "需要 JWT 认证") @GetMapping("/me") public ResponseEntity>> me(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - return ResponseEntity.status(401).body( - ApiResponse.unauthorized("not authenticated", getRequestId(request))); - } - Long userId = Long.valueOf(auth.getName()); - return ResponseEntity.ok(ApiResponse.ok(authService.getCurrentUser(userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(authService.getCurrentUser(userId), requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + private ResponseEntity> unauthorized(HttpServletRequest request) { + return ResponseEntity.status(401).body( + ApiResponse.unauthorized("invalid or expired token", requestIdAccessor.get(request))); } + } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/controller/SystemController.java b/mydreamjob-server/src/main/java/com/mydreamjob/controller/SystemController.java index 338684d..884d662 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/controller/SystemController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/controller/SystemController.java @@ -4,6 +4,7 @@ import com.mydreamjob.common.api.ApiResponse; 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.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; @@ -16,9 +17,15 @@ import java.util.Map; */ @Tag(name = "系统", description = "健康检查、应用信息") @RestController +@RequiredArgsConstructor @RequestMapping public class SystemController { + /** R01-A6：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A6：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + @Operation(summary = "应用健康检查", description = "返回应用及依赖服务状态") @GetMapping("/health") public ResponseEntity>> health(HttpServletRequest request) { @@ -27,7 +34,7 @@ public class SystemController { "application", "mydreamjob-server", "version", "0.0.1-SNAPSHOT" ); - return ResponseEntity.ok(ApiResponse.ok(details, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(details, requestIdAccessor.get(request))); } @Operation(summary = "应用信息", description = "返回应用版本、运行时信息") @@ -40,10 +47,7 @@ public class SystemController { "uptimeSeconds", (System.currentTimeMillis() - java.lang.management.ManagementFactory.getRuntimeMXBean().getStartTime()) / 1000, "springProfile", System.getProperty("spring.profiles.active", "dev") ); - return ResponseEntity.ok(ApiResponse.ok(info, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(info, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataCollector.java b/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataCollector.java index 29e03a9..bd17491 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataCollector.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataCollector.java @@ -52,6 +52,8 @@ import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Optional; +import java.util.function.Function; +import java.util.stream.Collectors; /** * 个人数据导出收集器：汇总当前用户自己的业务数据，用于打包 ZIP。 @@ -97,13 +99,14 @@ public class PersonalDataCollector { public CollectResult collect(Long userId) { CollectResult r = new CollectResult(); + List applications = applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(userId); r.getSections().put("profile", buildProfile(userId)); r.getSections().put("preferences", buildPreferences(userId)); buildResumes(r, userId); - buildApplications(r, userId); + buildApplications(r, applications); buildInterviews(r, userId); buildOffers(r, userId); - buildFeedback(r, userId); + buildFeedback(r, applications); buildFavorites(r, userId); buildNotifications(r, userId); buildConversationsAndMessages(r, userId); @@ -187,16 +190,17 @@ public class PersonalDataCollector { } // ── applications + timelines ──────────────────────────── - private void buildApplications(CollectResult r, Long userId) { + private void buildApplications(CollectResult r, List applications) { List> apps = new ArrayList<>(); List> timelines = new ArrayList<>(); - applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(userId) - .forEach(a -> { - apps.add(applicationView(a)); - applicationStatusHistoryRepository - .findByApplicationIdOrderByCreatedAtAsc(a.getId()) - .forEach(h -> timelines.add(applicationTimelineView(h))); - }); + Map> histories = groupBy( + applicationStatusHistoryRepository.findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc( + ids(applications, Application::getId)), ApplicationStatusHistory::getApplicationId); + applications.forEach(a -> { + apps.add(applicationView(a)); + histories.getOrDefault(a.getId(), List.of()) + .forEach(h -> timelines.add(applicationTimelineView(h))); + }); r.getSections().put("applications", apps); r.getSections().put("application-timelines", timelines); } @@ -226,16 +230,22 @@ public class PersonalDataCollector { private void buildInterviews(CollectResult r, Long userId) { List> ivs = new ArrayList<>(); List> timelines = new ArrayList<>(); - interviewRepository.findByStudentUserIdOrderByStartAtDesc(userId, PageRequest.of(0, MAX_ROWS)) - .forEach(iv -> addInterview(r, iv, ivs, timelines)); - interviewRepository.findByCompanyUserIdOrderByStartAtDesc(userId, PageRequest.of(0, MAX_ROWS)) - .forEach(iv -> addInterview(r, iv, ivs, timelines)); + List interviews = new ArrayList<>(); + interviews.addAll(interviewRepository.findByStudentUserIdOrderByStartAtDesc( + userId, PageRequest.of(0, MAX_ROWS)).getContent()); + interviews.addAll(interviewRepository.findByCompanyUserIdOrderByStartAtDesc( + userId, PageRequest.of(0, MAX_ROWS)).getContent()); + Map> histories = groupBy( + interviewStatusHistoryRepository.findByInterviewIdInOrderByInterviewIdAscCreatedAtAsc( + ids(interviews, Interview::getId)), InterviewStatusHistory::getInterviewId); + interviews.forEach(iv -> addInterview(iv, ivs, timelines, histories)); r.getSections().put("interviews", ivs); r.getSections().put("interview-timelines", timelines); } - private void addInterview(CollectResult r, Interview iv, - List> ivs, List> timelines) { + private void addInterview(Interview iv, List> ivs, + List> timelines, + Map> histories) { Map m = new LinkedHashMap<>(); m.put("interviewId", iv.getId()); m.put("applicationId", iv.getApplicationId()); @@ -250,7 +260,7 @@ public class PersonalDataCollector { m.put("notes", iv.getNotes()); m.put("status", iv.getStatus()); ivs.add(m); - interviewStatusHistoryRepository.findByInterviewIdOrderByCreatedAtAsc(iv.getId()) + histories.getOrDefault(iv.getId(), List.of()) .forEach(h -> timelines.add(interviewTimelineView(h))); } @@ -268,21 +278,27 @@ public class PersonalDataCollector { private void buildOffers(CollectResult r, Long userId) { List> offers = new ArrayList<>(); List> timelines = new ArrayList<>(); - offerRepository.findByCandidateIdOrderByCreatedAtDesc(userId, PageRequest.of(0, MAX_ROWS)) - .forEach(o -> addOffer(r, o, offers, timelines)); + List source = new ArrayList<>(); + source.addAll(offerRepository.findByCandidateIdOrderByCreatedAtDesc( + userId, PageRequest.of(0, MAX_ROWS)).getContent()); companyRepository.findByOwnerUserId(userId).ifPresent(c -> - offerRepository.findByCompanyIdOrderByCreatedAtDesc(c.getId(), PageRequest.of(0, MAX_ROWS)) - .forEach(o -> addOffer(r, o, offers, timelines))); + source.addAll(offerRepository.findByCompanyIdOrderByCreatedAtDesc( + c.getId(), PageRequest.of(0, MAX_ROWS)).getContent())); + Map> histories = groupBy( + offerStatusHistoryRepository.findByOfferIdInOrderByOfferIdAscCreatedAtAsc( + ids(source, Offer::getId)), OfferStatusHistory::getOfferId); + source.forEach(o -> addOffer(o, offers, timelines, histories)); r.getSections().put("offers", offers); r.getSections().put("offer-timelines", timelines); } - private void addOffer(CollectResult r, Offer o, - List> offers, List> timelines) { + private void addOffer(Offer o, List> offers, + List> timelines, + Map> histories) { if (!offersContains(offers, o.getId())) { offers.add(offerView(o)); } - offerStatusHistoryRepository.findByOfferIdOrderByCreatedAtAsc(o.getId()) + histories.getOrDefault(o.getId(), List.of()) .forEach(h -> timelines.add(offerTimelineView(h))); } @@ -325,11 +341,13 @@ public class PersonalDataCollector { } // ── feedback ──────────────────────────────────────────── - private void buildFeedback(CollectResult r, Long userId) { + private void buildFeedback(CollectResult r, List applications) { List> list = new ArrayList<>(); - applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(userId) - .forEach(a -> candidateFeedbackRepository.findByApplicationId(a.getId()) - .ifPresent(f -> list.add(feedbackView(f)))); + Map feedbackByApplication = candidateFeedbackRepository + .findByApplicationIdIn(ids(applications, Application::getId)).stream() + .collect(Collectors.toMap(CandidateFeedback::getApplicationId, Function.identity())); + applications.forEach(a -> Optional.ofNullable(feedbackByApplication.get(a.getId())) + .ifPresent(f -> list.add(feedbackView(f)))); r.getSections().put("feedback", list); } @@ -381,8 +399,15 @@ public class PersonalDataCollector { private void buildConversationsAndMessages(CollectResult r, Long userId) { List> convs = new ArrayList<>(); List> msgs = new ArrayList<>(); - for (ConversationMember member : conversationMemberRepository.findByUserId(userId)) { - conversationRepository.findById(member.getConversationId()).ifPresent(c -> { + List members = conversationMemberRepository.findByUserId(userId); + List conversationIds = ids(members, ConversationMember::getConversationId); + Map conversations = conversationRepository.findAllById(conversationIds).stream() + .collect(Collectors.toMap(Conversation::getId, Function.identity())); + Map> messages = groupBy( + messageRepository.findByConversationIdInOrderByConversationIdAscCreatedAtDesc(conversationIds), + Message::getConversationId); + for (ConversationMember member : members) { + Optional.ofNullable(conversations.get(member.getConversationId())).ifPresent(c -> { Map mc = new LinkedHashMap<>(); mc.put("conversationId", c.getId()); mc.put("title", c.getTitle()); @@ -391,8 +416,7 @@ public class PersonalDataCollector { mc.put("updatedAt", c.getUpdatedAt()); convs.add(mc); }); - messageRepository.findByConversationIdOrderByCreatedAtDesc( - member.getConversationId(), PageRequest.of(0, MAX_ROWS)) + messages.getOrDefault(member.getConversationId(), List.of()).stream().limit(MAX_ROWS) .forEach(msg -> msgs.add(messageView(msg))); } r.getSections().put("conversations", convs); @@ -428,9 +452,12 @@ public class PersonalDataCollector { r.getSections().put("candidate-scoring", scores); List> appeals = new ArrayList<>(); - candidateScoringAppealRepository.findByCandidateUserIdOrderByCreatedAtDesc( - userId, PageRequest.of(0, MAX_ROWS)) - .forEach(a -> { + List source = candidateScoringAppealRepository + .findByCandidateUserIdOrderByCreatedAtDesc(userId, PageRequest.of(0, MAX_ROWS)).getContent(); + Map> histories = groupBy( + candidateScoringAppealHistoryRepository.findByAppealIdInOrderByAppealIdAscCreatedAtAsc( + ids(source, CandidateScoringAppeal::getId)), CandidateScoringAppealHistory::getAppealId); + source.forEach(a -> { Map m = new LinkedHashMap<>(); m.put("appealId", a.getId()); m.put("dimension", a.getDimension()); @@ -441,7 +468,7 @@ public class PersonalDataCollector { m.put("createdAt", a.getCreatedAt()); m.put("updatedAt", a.getUpdatedAt()); List> hist = new ArrayList<>(); - candidateScoringAppealHistoryRepository.findByAppealIdOrderByCreatedAtAsc(a.getId()) + histories.getOrDefault(a.getId(), List.of()) .forEach(h -> { Map hm = new LinkedHashMap<>(); hm.put("fromStatus", h.getFromStatus()); @@ -479,4 +506,12 @@ public class PersonalDataCollector { String n = name.replaceAll("[\\\\/:*?\"<>|\\s]+", "_"); return n.isEmpty() ? "resume" : n; } -} \ No newline at end of file + + private List ids(List values, Function idExtractor) { + return values.stream().map(idExtractor).toList(); + } + + private Map> groupBy(List values, Function idExtractor) { + return values.stream().collect(Collectors.groupingBy(idExtractor)); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataExportController.java b/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataExportController.java index d9d4a79..0ecb19b 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataExportController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/dataexport/PersonalDataExportController.java @@ -2,10 +2,10 @@ package com.mydreamjob.dataexport; import com.mydreamjob.common.api.ApiResponse; import com.mydreamjob.common.api.PageResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.dataexport.dto.CreateDataExportRequest; import com.mydreamjob.dataexport.dto.DataExportTaskResponse; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -15,8 +15,6 @@ import org.springframework.http.ContentDisposition; import org.springframework.http.HttpHeaders; import org.springframework.http.MediaType; 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.PostMapping; @@ -37,16 +35,18 @@ import java.nio.charset.StandardCharsets; public class PersonalDataExportController { private final DataExportService dataExportService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "创建个人数据导出任务", description = "异步生成 ZIP；同 idempotencyKey 重放返回原任务；注销进行中禁止创建") @PostMapping("/profile/me/data-export-tasks") public ResponseEntity> create( @Valid @RequestBody(required = false) CreateDataExportRequest body, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CreateDataExportRequest req = body == null ? new CreateDataExportRequest() : body; return ResponseEntity.ok(ApiResponse.ok( - dataExportService.create(userId, req), getRequestId(request))); + dataExportService.create(userId, req), requestIdAccessor.get(request))); } @Operation(summary = "查询个人数据导出任务列表", description = "仅本人；按创建时间倒序分页") @@ -56,9 +56,9 @@ public class PersonalDataExportController { @RequestParam(defaultValue = "20") int size, @RequestParam(required = false) String status, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dataExportService.list(userId, page, size, status), getRequestId(request))); + dataExportService.list(userId, page, size, status), requestIdAccessor.get(request))); } @Operation(summary = "查询个人数据导出任务详情", description = "仅本人；不暴露存储路径与内部字段") @@ -66,9 +66,9 @@ public class PersonalDataExportController { public ResponseEntity> get( @PathVariable Long taskId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - dataExportService.get(userId, taskId), getRequestId(request))); + dataExportService.get(userId, taskId), requestIdAccessor.get(request))); } @Operation(summary = "下载个人数据导出 ZIP", description = "仅本人且 COMPLETED 未过期可下载；attachment") @@ -76,7 +76,7 @@ public class PersonalDataExportController { public ResponseEntity download( @PathVariable Long taskId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); DataExportService.DownloadFile df = dataExportService.download(userId, taskId); ContentDisposition cd = ContentDisposition.attachment() .filename(df.filename(), StandardCharsets.UTF_8) @@ -86,21 +86,4 @@ public class PersonalDataExportController { .header(HttpHeaders.CONTENT_DISPOSITION, cd.toString()) .body(df.content()); } - - private Long resolveUserId(HttpServletRequest request) { - 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 e) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionCompletionWorker.java b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionCompletionWorker.java index 107ea2b..3193e1c 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionCompletionWorker.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionCompletionWorker.java @@ -1,10 +1,10 @@ package com.mydreamjob.deletion; import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.AuthSessionService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; import com.mydreamjob.dataexport.PersonalDataExportCleanupService; -import com.mydreamjob.salarycalculator.SalaryHistoryCleanupService; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.orm.ObjectOptimisticLockingFailureException; @@ -12,6 +12,8 @@ import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Propagation; import org.springframework.transaction.annotation.Transactional; +import java.time.Clock; +import java.time.Instant; import java.time.LocalDateTime; /** @@ -33,7 +35,8 @@ public class AccountDeletionCompletionWorker { private final AuditService auditService; private final AccountDeletionPhoneHasher phoneHasher; private final PersonalDataExportCleanupService dataExportCleanupService; - private final SalaryHistoryCleanupService salaryHistoryCleanupService; + private final AuthSessionService authSessionService; + private final Clock clock; /** * 若用户处于 PENDING 且已到期，则执行完成态迁移 + 脱敏 + 审计。 @@ -46,7 +49,9 @@ public class AccountDeletionCompletionWorker { if (rec == null || rec.getStatus() != DeletionStatus.PENDING) { return false; } - LocalDateTime now = LocalDateTime.now(); + // S02：注销完成入口只取一次时间，状态迁移、脱敏与全局会话吊销共用。 + Instant capturedNow = clock.instant(); + LocalDateTime now = LocalDateTime.ofInstant(capturedNow, AuthSessionService.BUSINESS_ZONE); if (rec.getEffectiveAt() == null || rec.getEffectiveAt().isAfter(now)) { return false; } @@ -57,9 +62,12 @@ public class AccountDeletionCompletionWorker { rec.setCompletedAt(now); accountDeletionRepository.saveAndFlush(rec); // @Version 门控：并发时后到者抛异常 desensitize(rec.getUserId()); + // S02：注销完成必须撤销该用户全部登录会话（与状态迁移同一事务）。 + // 只按 rec.getUserId() 撤销，不接受任何客户端传入的 userId。 + authSessionService.revokeAllUserSessions( + rec.getUserId(), AuthSessionService.REASON_ACCOUNT_DELETED, capturedNow); // 注销完成：清理该用户的个人导出文件并作废未完成任务 dataExportCleanupService.purgeForDeletedUser(rec.getUserId()); - salaryHistoryCleanupService.purgeForDeletedUser(rec.getUserId()); // 完成 + 脱敏审计各写一次 auditService.log(userId, "ACCOUNT_DELETION_COMPLETED", "ACCOUNT_DELETION", rec.getId(), "account deletion completed; userId=" + userId @@ -112,5 +120,4 @@ public class AccountDeletionCompletionWorker { u.setActive(false); userRepository.saveAndFlush(u); } -} - +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionController.java b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionController.java index 271801c..d5c707a 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/AccountDeletionController.java @@ -14,8 +14,6 @@ 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.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; @@ -27,6 +25,11 @@ import org.springframework.web.bind.annotation.RestController; @RequiredArgsConstructor public class AccountDeletionController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final AccountDeletionService accountDeletionService; @Operation( @@ -57,9 +60,9 @@ public class AccountDeletionController { }) @PostMapping public ResponseEntity> initiate(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - accountDeletionService.initiate(userId), getRequestId(request))); + accountDeletionService.initiate(userId), requestIdAccessor.get(request))); } @Operation( @@ -82,9 +85,9 @@ public class AccountDeletionController { }) @GetMapping public ResponseEntity> getStatus(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - accountDeletionService.getCurrentStatus(userId), getRequestId(request))); + accountDeletionService.getCurrentStatus(userId), requestIdAccessor.get(request))); } @Operation( @@ -112,20 +115,9 @@ public class AccountDeletionController { }) @PostMapping("/cancel") public ResponseEntity> cancel(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - accountDeletionService.cancel(userId), getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + accountDeletionService.cancel(userId), requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java index 522f8ae..5de8e31 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/deletion/DeletionGuardInterceptor.java @@ -3,11 +3,13 @@ package com.mydreamjob.deletion; import com.fasterxml.jackson.databind.ObjectMapper; import com.mydreamjob.common.api.ApiResponse; import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.security.CurrentUserAccessor; import jakarta.servlet.http.HttpServletRequest; import jakarta.servlet.http.HttpServletResponse; import lombok.RequiredArgsConstructor; import org.springframework.beans.factory.ObjectProvider; import org.springframework.http.MediaType; +import org.springframework.security.authentication.InsufficientAuthenticationException; import org.springframework.security.core.Authentication; import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.stereotype.Component; @@ -24,7 +26,14 @@ import java.util.Set; *
  • PENDING：拦截 POST/PUT/PATCH/DELETE 写操作返回 409/9302；GET 与 OPTIONS 放行
    • * * 注销接口（POST/GET /profile/me/deletion、POST /profile/me/deletion/cancel）始终放行，交由 Controller 决策。 - * 未认证、未注销用户不受影响。 + * 未认证、未注销用户不受影响。

    + * + *

    身份解析复用唯一的 {@link CurrentUserAccessor}（R01-A）：本拦截器注册在 + * {@code /**}，先于所有 Controller 执行，因此绝不能自己解析主体。此前它用 + * {@code Character::isDigit} 判断后直接 {@code Long.valueOf(name)}，导致 Long 溢出主体 + * （如 {@code "99999999999999999999"}）抛出 {@code NumberFormatException}，在到达任何 + * Controller 之前就逃逸为全站 HTTP 500。现在非法主体一律视为未认证并放行， + * 由 Controller 统一返回 401。

    */ @Component @RequiredArgsConstructor @@ -37,6 +46,7 @@ public class DeletionGuardInterceptor implements HandlerInterceptor { private static final Set WRITE_METHODS = Set.of("POST", "PUT", "PATCH", "DELETE"); private final ObjectProvider deletionServiceProvider; + private final CurrentUserAccessor currentUserAccessor; private final ObjectMapper objectMapper; @Override @@ -45,11 +55,9 @@ public class DeletionGuardInterceptor implements HandlerInterceptor { if ("OPTIONS".equalsIgnoreCase(request.getMethod())) { return true; } - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - // 匿名用户（principal 为 "anonymousUser"，非数字 userId）等同于未认证，直接放行 - if (auth == null || !auth.isAuthenticated() - || "anonymousUser".equals(String.valueOf(auth.getPrincipal())) - || auth.getName() == null || !auth.getName().chars().allMatch(Character::isDigit)) { + // 未认证 / 匿名 / 非法或溢出主体 → 一律放行，交由 Controller 按未登录处理（401）。 + Long userId = resolveUserIdOrNull(SecurityContextHolder.getContext().getAuthentication()); + if (userId == null) { return true; } // 切片测试（@WebMvcTest）等场景可能无此服务 Bean，此时不拦截 @@ -57,7 +65,6 @@ public class DeletionGuardInterceptor implements HandlerInterceptor { if (deletionService == null) { return true; } - Long userId = Long.valueOf(auth.getName()); String path = resolvePath(request); if (DELETION_PATHS.contains(path)) { return true; @@ -72,6 +79,19 @@ public class DeletionGuardInterceptor implements HandlerInterceptor { return true; } + /** + * 解析用户 ID；任何非法主体返回 {@code null}，绝不抛出。 + * + *

    该安全依赖由构造器强制注入；装配缺失时应用必须失败启动。

    + */ + private Long resolveUserIdOrNull(Authentication authentication) { + try { + return currentUserAccessor.requireUserId(authentication); + } catch (InsufficientAuthenticationException e) { + return null; + } + } + private boolean reject(HttpServletResponse response, ErrorCode errorCode, HttpServletRequest request) throws Exception { response.setStatus(409); @@ -92,4 +112,4 @@ public class DeletionGuardInterceptor implements HandlerInterceptor { } return uri; } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackController.java b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackController.java index 414f1b2..0c4c987 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackController.java @@ -9,8 +9,6 @@ import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.*; import java.util.Map; @@ -20,6 +18,11 @@ import java.util.Map; @RequiredArgsConstructor public class CandidateFeedbackController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CandidateFeedbackService feedbackService; @Operation(summary = "创建候选人反馈", description = "仅岗位所属企业；同一投递只能反馈一次") @@ -28,9 +31,9 @@ public class CandidateFeedbackController { @PathVariable Long applicationId, @Valid @RequestBody CandidateFeedbackRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CandidateFeedbackResponse response = feedbackService.createFeedback(userId, applicationId, req); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } @Operation(summary = "查询候选人反馈", description = "该投递的企业或学生可查看") @@ -38,9 +41,9 @@ public class CandidateFeedbackController { public ResponseEntity> get( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CandidateFeedbackResponse response = feedbackService.getFeedback(userId, applicationId); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } @Operation(summary = "修改候选人反馈", description = "仅岗位所属企业") @@ -49,9 +52,9 @@ public class CandidateFeedbackController { @PathVariable Long applicationId, @Valid @RequestBody CandidateFeedbackRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CandidateFeedbackResponse response = feedbackService.updateFeedback(userId, applicationId, req); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } @Operation(summary = "删除候选人反馈", description = "仅岗位所属企业") @@ -59,20 +62,9 @@ public class CandidateFeedbackController { public ResponseEntity>> delete( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); feedbackService.deleteFeedback(userId, applicationId); - return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "feedback deleted"), getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "feedback deleted"), requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackRepository.java index b0d0c95..00f485d 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackRepository.java @@ -4,11 +4,14 @@ import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.stereotype.Repository; import java.util.Optional; +import java.util.List; @Repository public interface CandidateFeedbackRepository extends JpaRepository { Optional findByApplicationId(Long applicationId); + List findByApplicationIdIn(List applicationIds); + boolean existsByApplicationId(Long applicationId); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackService.java b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackService.java index 19728c3..09c5429 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/feedback/CandidateFeedbackService.java @@ -10,6 +10,7 @@ import com.mydreamjob.feedback.dto.CandidateFeedbackRequest; import com.mydreamjob.feedback.dto.CandidateFeedbackResponse; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobService; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.core.type.TypeReference; import com.fasterxml.jackson.databind.ObjectMapper; @@ -28,6 +29,8 @@ public class CandidateFeedbackService { private final CandidateFeedbackRepository feedbackRepository; private final ApplicationRepository applicationRepository; private final JobService jobService; + /** R01-D4-1：候选人反馈创建后登记评分快照刷新（INTEGRITY 维度）。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; private final CompanyRepository companyRepository; private static final ObjectMapper mapper = new ObjectMapper(); @@ -74,7 +77,10 @@ public class CandidateFeedbackService { .rating(req.getRating()).content(req.getContent()) .tags(toJson(req.getTags())) .build(); - return toResponse(feedbackRepository.save(fb)); + CandidateFeedback saved = feedbackRepository.save(fb); + // R01-D4-1：候选人反馈计数/均值影响 INTEGRITY 维度 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(app.getStudentUserId(), java.time.LocalDateTime.now()); + return toResponse(saved); } // ── 查询 ────────────────────────────────────────────────── @@ -110,7 +116,10 @@ public class CandidateFeedbackService { if (req.getRating() != null) fb.setRating(req.getRating()); if (req.getContent() != null) fb.setContent(req.getContent()); if (req.getTags() != null) fb.setTags(toJson(req.getTags())); - return toResponse(feedbackRepository.save(fb)); + CandidateFeedback updated = feedbackRepository.save(fb); + // R01-D4-2 F2：修改 rating 会改变 AVG(rating) → 与写操作同事务登记刷新。 + scoringRefreshRequestService.requestRefresh(app.getStudentUserId(), java.time.LocalDateTime.now()); + return toResponse(updated); } // ── 删除 ────────────────────────────────────────────────── @@ -123,7 +132,11 @@ public class CandidateFeedbackService { CandidateFeedback fb = feedbackRepository.findByApplicationId(applicationId) .orElseThrow(() -> new BusinessException(ErrorCode.FEEDBACK_NOT_FOUND)); + // R01-D4-2 F2：删除前先固定候选人标识，删除后仍能正确登记。 + Long studentUserId = app.getStudentUserId(); feedbackRepository.delete(fb); + // COUNT(*) 与 AVG(rating) 同时变化 → 与删除操作同事务登记刷新。 + scoringRefreshRequestService.requestRefresh(studentUserId, java.time.LocalDateTime.now()); } // ── 视图 ────────────────────────────────────────────────── diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewController.java b/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewController.java index 8246226..01df0e2 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewController.java @@ -16,8 +16,6 @@ import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.time.LocalDateTime; @@ -34,6 +32,11 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class InterviewController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final InterviewService interviewService; // ── 企业创建面试 ──────────────────────────────────────────── @@ -44,10 +47,10 @@ public class InterviewController { @PathVariable Long applicationId, @Valid @RequestBody InterviewCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Interview interview = interviewService.createInterview(userId, applicationId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 查询某投递的面试列表 ───────────────────────────────────── @@ -57,11 +60,11 @@ public class InterviewController { public ResponseEntity>>> listByApplication( @PathVariable Long applicationId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List interviews = interviewService.listByApplication(applicationId, userId); List> items = interviews.stream() .map(interviewService::toView).collect(Collectors.toList()); - return ResponseEntity.ok(ApiResponse.ok(items, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(items, requestIdAccessor.get(request))); } // ── 当前用户面试列表 ──────────────────────────────────────── @@ -75,7 +78,7 @@ public class InterviewController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); if (size > 100) size = 100; Page result = interviewService.listMyInterviews(userId, status, from, to, page, size); Map data = new HashMap<>(); @@ -84,7 +87,7 @@ public class InterviewController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 查看面试详情 ──────────────────────────────────────────── @@ -94,9 +97,9 @@ public class InterviewController { public ResponseEntity>> get( @PathVariable Long interviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Interview interview = interviewService.getInterview(interviewId, userId); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 企业修改面试 ──────────────────────────────────────────── @@ -107,10 +110,10 @@ public class InterviewController { @PathVariable Long interviewId, @Valid @RequestBody InterviewUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Interview interview = interviewService.updateInterview(userId, interviewId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 学生响应面试 ──────────────────────────────────────────── @@ -121,10 +124,10 @@ public class InterviewController { @PathVariable Long interviewId, @Valid @RequestBody InterviewRespondRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Interview interview = interviewService.respondToInterview(userId, interviewId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 企业取消面试 ──────────────────────────────────────────── @@ -135,10 +138,10 @@ public class InterviewController { @PathVariable Long interviewId, @Valid @RequestBody InterviewCancelRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Interview interview = interviewService.cancelInterview(userId, interviewId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 企业完成面试 ──────────────────────────────────────────── @@ -149,11 +152,11 @@ public class InterviewController { @PathVariable Long interviewId, @RequestBody(required = false) Map body, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); String notes = body != null ? body.get("notes") : null; Interview interview = interviewService.completeInterview(userId, interviewId, notes, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(interviewService.toView(interview), requestIdAccessor.get(request))); } // ── 状态时间线 ────────────────────────────────────────────── @@ -163,21 +166,11 @@ public class InterviewController { public ResponseEntity>>> timeline( @PathVariable Long interviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List> data = interviewService.getTimeline(interviewId, userId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 辅助 ──────────────────────────────────────────────────── - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewStatusHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewStatusHistoryRepository.java index aa9de0c..79f8a02 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewStatusHistoryRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/interview/InterviewStatusHistoryRepository.java @@ -9,4 +9,7 @@ import java.util.List; public interface InterviewStatusHistoryRepository extends JpaRepository { List findByInterviewIdOrderByCreatedAtAsc(Long interviewId); -} \ No newline at end of file + + List findByInterviewIdInOrderByInterviewIdAscCreatedAtAsc( + List interviewIds); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/interviewscore/InterviewScoreController.java b/mydreamjob-server/src/main/java/com/mydreamjob/interviewscore/InterviewScoreController.java index 0dfb616..68bf1a2 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/interviewscore/InterviewScoreController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/interviewscore/InterviewScoreController.java @@ -2,19 +2,17 @@ package com.mydreamjob.interviewscore; import com.mydreamjob.audit.AuditContext; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.interviewscore.dto.InterviewScoreHistoryItem; import com.mydreamjob.interviewscore.dto.InterviewScoreResponse; import com.mydreamjob.interviewscore.dto.InterviewScoreSaveRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.*; import java.util.List; @@ -31,6 +29,8 @@ import java.util.List; public class InterviewScoreController { private final InterviewScoreService interviewScoreService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "保存评分草稿", description = "企业为已完成的面试保存评分草稿（支持重复保存）") @PutMapping("/interviews/{interviewId}/score") @@ -38,10 +38,10 @@ public class InterviewScoreController { @PathVariable Long interviewId, @Valid @RequestBody InterviewScoreSaveRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); InterviewScoreResponse data = interviewScoreService.saveDraft(userId, interviewId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "查看评分", description = "企业 owner 可查看草稿与已提交；学生只能在提交后查看") @@ -49,9 +49,9 @@ public class InterviewScoreController { public ResponseEntity> get( @PathVariable Long interviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - interviewScoreService.getScore(userId, interviewId), getRequestId(request))); + interviewScoreService.getScore(userId, interviewId), requestIdAccessor.get(request))); } @Operation(summary = "提交评分", description = "将草稿提交为终态，提交后不可修改") @@ -59,10 +59,10 @@ public class InterviewScoreController { public ResponseEntity> submit( @PathVariable Long interviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( interviewScoreService.submitScore(userId, interviewId, AuditContext.from(request)), - getRequestId(request))); + requestIdAccessor.get(request))); } @Operation(summary = "评分历史", description = "查看评分快照历史；无历史返回空数组") @@ -70,20 +70,8 @@ public class InterviewScoreController { public ResponseEntity>> history( @PathVariable Long interviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - interviewScoreService.getHistory(userId, interviewId), getRequestId(request))); + interviewScoreService.getHistory(userId, interviewId), requestIdAccessor.get(request))); } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/job/FavoriteController.java b/mydreamjob-server/src/main/java/com/mydreamjob/job/FavoriteController.java index 127a127..bdd95da 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/job/FavoriteController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/job/FavoriteController.java @@ -1,14 +1,14 @@ package com.mydreamjob.job; import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; 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.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.HashMap; @@ -20,15 +20,17 @@ import java.util.Map; public class FavoriteController { private final JobFavoriteService favoriteService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "收藏岗位", description = "仅 STUDENT；仅 PUBLISHED；幂等") @PostMapping("/jobs/{jobId}/favorite") public ResponseEntity>> favorite( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map result = favoriteService.favorite(userId, jobId); - return ResponseEntity.ok(ApiResponse.ok(result, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(result, requestIdAccessor.get(request))); } @Operation(summary = "取消收藏", description = "仅 STUDENT；幂等，未收藏也返回 200") @@ -36,9 +38,9 @@ public class FavoriteController { public ResponseEntity>> unfavorite( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map result = favoriteService.unfavorite(userId, jobId); - return ResponseEntity.ok(ApiResponse.ok(result, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(result, requestIdAccessor.get(request))); } @Operation(summary = "我的收藏列表", description = "仅 STUDENT；分页，按收藏时间倒序") @@ -47,7 +49,7 @@ public class FavoriteController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page> result = favoriteService.listFavorites(userId, page, size); Map data = new HashMap<>(); data.put("items", result.getContent()); @@ -55,19 +57,6 @@ public class FavoriteController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java index d9ad7b6..940a6d8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobController.java @@ -1,12 +1,15 @@ package com.mydreamjob.job; import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; import com.mydreamjob.company.CompanyService; import com.mydreamjob.job.dto.JobCreateRequest; import com.mydreamjob.job.dto.JobSearchItem; import com.mydreamjob.job.dto.JobStatusRequest; import com.mydreamjob.job.dto.JobUpdateRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -14,8 +17,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.HashMap; @@ -31,9 +32,12 @@ import java.util.Map; @RequestMapping("/jobs") @RequiredArgsConstructor public class JobController { + /** R01-A6：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; private final JobService jobService; private final CompanyService companyService; + private final CurrentUserAccessor currentUserAccessor; // ── 企业端：创建岗位 ──────────────────────────────────────── @@ -42,9 +46,9 @@ public class JobController { public ResponseEntity>> createJob( @Valid @RequestBody JobCreateRequest req, HttpServletRequest request) { - Long companyId = resolveCompanyId(request); + Long companyId = resolveCompanyId(); Map view = jobService.toView(jobService.createJob(companyId, req)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 企业端：编辑岗位 ──────────────────────────────────────── @@ -55,9 +59,9 @@ public class JobController { @PathVariable Long jobId, @Valid @RequestBody JobUpdateRequest req, HttpServletRequest request) { - Long companyId = resolveCompanyId(request); + Long companyId = resolveCompanyId(); Map view = jobService.toView(jobService.updateJob(companyId, jobId, req)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 企业端：状态流转 ──────────────────────────────────────── @@ -68,9 +72,9 @@ public class JobController { @PathVariable Long jobId, @Valid @RequestBody JobStatusRequest req, HttpServletRequest request) { - Long companyId = resolveCompanyId(request); + Long companyId = resolveCompanyId(); Map view = jobService.toView(jobService.transitionStatus(companyId, jobId, req)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 企业端：查询岗位详情 ──────────────────────────────────── @@ -80,11 +84,11 @@ public class JobController { public ResponseEntity>> getJob( @PathVariable Long jobId, HttpServletRequest request) { - Long companyId = resolveCompanyId(request); + Long companyId = resolveCompanyId(); // 验证归属后返回 jobService.assertOwnerOrThrow(companyId, jobId); Map view = jobService.toView(jobService.getJob(jobId)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 公开端：岗位列表 ──────────────────────────────────────── @@ -110,7 +114,7 @@ public class JobController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 公开端：岗位详情 ──────────────────────────────────────── @@ -121,7 +125,7 @@ public class JobController { @PathVariable Long jobId, HttpServletRequest request) { Map view = jobService.getPublicJob(jobId); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 公开端：高级搜索 ──────────────────────────────────────── @@ -148,7 +152,7 @@ public class JobController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 公开端：筛选选项 ──────────────────────────────────────── @@ -158,27 +162,19 @@ public class JobController { public ResponseEntity>> getFilters( HttpServletRequest request) { Map options = jobService.getFilterOptions(); - return ResponseEntity.ok(ApiResponse.ok(options, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(options, requestIdAccessor.get(request))); } // ── 辅助方法 ──────────────────────────────────────────────── - private Long resolveCompanyId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - Long userId = Long.valueOf(auth.getName()); + private Long resolveCompanyId() { + // 身份只来自 JWT/SecurityContext；非法主体统一为未登录语义（401），不抛 NumberFormatException + Long userId = currentUserAccessor.requireUserId(); Company company = companyService.findCompanyByOwnerUserId(userId); if (company == null) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.COMPANY_NOT_FOUND); + throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); } return company.getId(); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobFavoriteService.java b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobFavoriteService.java index 0dd3959..da171b4 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobFavoriteService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobFavoriteService.java @@ -20,6 +20,7 @@ import java.util.Map; @RequiredArgsConstructor public class JobFavoriteService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final JobFavoriteRepository favoriteRepository; private final JobService jobService; private final UserRepository userRepository; @@ -27,22 +28,11 @@ public class JobFavoriteService { private static final int MAX_PAGE_SIZE = 50; // ── 角色校验 ────────────────────────────────────────────── - - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream() - .anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - // ── 收藏 ────────────────────────────────────────────────── @Transactional public Map favorite(Long studentUserId, Long jobId) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); Job job = jobService.getJob(jobId); if (!"PUBLISHED".equals(job.getStatus())) { @@ -76,7 +66,7 @@ public class JobFavoriteService { @Transactional public Map unfavorite(Long studentUserId, Long jobId) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); // 幂等：不存在时也返回 200 favoriteRepository.deleteByJobIdAndStudentUserId(jobId, studentUserId); @@ -86,7 +76,7 @@ public class JobFavoriteService { // ── 查询收藏列表 ────────────────────────────────────────── public Page> listFavorites(Long studentUserId, int page, int size) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); // size<1 直接 400，避免 PageRequest.of 抛 IllegalArgumentException 导致 500 if (size < 1) throw new BusinessException(ErrorCode.BAD_REQUEST); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java index a2df424..17fecd3 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobSearchSpecification.java @@ -5,6 +5,7 @@ import org.springframework.data.jpa.domain.Specification; import java.util.ArrayList; import java.util.List; +import java.util.Locale; /** * 岗位搜索动态查询 Specification。 @@ -51,21 +52,24 @@ public class JobSearchSpecification { if (keyword != null && !keyword.isBlank()) { String pattern = "%" + keyword.trim() + "%"; Predicate keywordPred = cb.or( - cb.like(cb.lower(root.get(TITLE)), pattern.toLowerCase()), - cb.like(cb.lower(root.get(DESCRIPTION)), pattern.toLowerCase()), - cb.like(cb.lower(root.get(REQUIREMENTS)), pattern.toLowerCase()) + cb.like(cb.lower(root.get(TITLE)), pattern.toLowerCase(Locale.ROOT)), + cb.like(cb.lower(root.get(DESCRIPTION)), pattern.toLowerCase(Locale.ROOT)), + cb.like(cb.lower(root.get(REQUIREMENTS)), pattern.toLowerCase(Locale.ROOT)) ); predicates.add(keywordPred); } - // 城市精确匹配 + // 城市：trim 后忽略大小写精确匹配。 + // 显式 lower 可避免 MySQL 的大小写不敏感排序规则与 H2 默认比较规则产生差异。 if (city != null && !city.isBlank()) { - predicates.add(cb.equal(root.get(CITY), city.trim())); + predicates.add(cb.equal(cb.lower(root.get(CITY)), city.trim().toLowerCase(Locale.ROOT))); } - // 用工类型精确匹配 + // 用工类型：trim 后忽略大小写精确匹配，与线上 MySQL 既有比较结果保持一致。 if (employmentType != null && !employmentType.isBlank()) { - predicates.add(cb.equal(root.get(EMPLOYMENT_TYPE), employmentType.trim())); + predicates.add(cb.equal( + cb.lower(root.get(EMPLOYMENT_TYPE)), + employmentType.trim().toLowerCase(Locale.ROOT))); } // 薪资范围：岗位 salaryMax >= 用户 salaryMin @@ -86,4 +90,4 @@ public class JobSearchSpecification { return cb.and(predicates.toArray(new Predicate[0])); }; } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java index 8effaaa..b36913e 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/job/JobService.java @@ -119,6 +119,11 @@ public class JobService { /** * 公开岗位列表：仅返回 PUBLISHED，支持筛选和分页 + * + *

    DEF-01：关键词在此处规范化，使其与 {@code GET /jobs/search} + * （{@code JobSearchSpecification} 的 {@code keyword.trim()} + {@code isBlank()} 判空） + * 的输入语义一致 —— 只去两端空白，空串与纯空白等同「未传关键词」， + * 不折叠中间空格、不改大小写，也不改变任何过滤/排序/分页语义。

    */ public Page> listPublishedJobs(String keyword, String city, String employmentType, @@ -127,8 +132,9 @@ public class JobService { if (salaryMin != null && salaryMax != null && salaryMin > salaryMax) { throw new BusinessException(ErrorCode.BAD_REQUEST); } + String normalizedKeyword = keyword == null || keyword.isBlank() ? null : keyword.trim(); Pageable pageable = PageRequest.of(page, size, Sort.by(Sort.Direction.DESC, "createdAt")); - Page result = jobRepository.findPublishedJobs(keyword, city, employmentType, + Page result = jobRepository.findPublishedJobs(normalizedKeyword, city, employmentType, salaryMin, salaryMax, pageable); return result.map(this::toPublicView); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchController.java b/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchController.java index f6e63f0..a6d0dc9 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchController.java @@ -6,8 +6,6 @@ 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.*; import java.util.Map; @@ -18,6 +16,11 @@ import java.util.Map; @RequiredArgsConstructor public class MatchController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final MatchService matchService; @Operation(summary = "岗位匹配诊断", description = "仅 STUDENT；返回匹配分、硬性条件、缺口和说明") @@ -25,21 +28,10 @@ public class MatchController { public ResponseEntity>> diagnose( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map result = matchService.diagnose(userId, jobId, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(result, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(result, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchService.java b/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchService.java index eadd129..93ee9a9 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/match/MatchService.java @@ -29,6 +29,7 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class MatchService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final JobService jobService; private final StudentPreferenceRepository preferenceRepository; private final StudentProfileRepository profileRepository; @@ -38,15 +39,6 @@ public class MatchService { private static final String RULES_VERSION = "RULES_V0_1"; /** 岗位匹配诊断仅 STUDENT 可用 */ - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - // ── 匹配规则 ────────────────────────────────────────────── public Map diagnose(Long studentUserId, Long jobId) { @@ -54,7 +46,7 @@ public class MatchService { } public Map diagnose(Long studentUserId, Long jobId, com.mydreamjob.audit.AuditContext ctx) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); // 岗位必须存在 Job job = jobService.getJob(jobId); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/Message.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/Message.java index 0dc43c3..e3772e0 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/Message.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/Message.java @@ -32,6 +32,18 @@ public class Message { @Column(nullable = false, columnDefinition = "text") private String content; + @Column(nullable = false, length = 20) + @Builder.Default + private String status = "SENT"; + + @Column(name = "recalled_at") + private LocalDateTime recalledAt; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageRepository.java index a752435..814d29d 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageRepository.java @@ -3,10 +3,79 @@ package com.mydreamjob.messaging; import org.springframework.data.domain.Page; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Lock; +import org.springframework.data.jpa.repository.Modifying; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; +import jakarta.persistence.LockModeType; + +import java.time.LocalDateTime; +import java.util.List; @Repository public interface MessageRepository extends JpaRepository { Page findByConversationIdOrderByCreatedAtDesc(Long conversationId, Pageable pageable); + + List findByConversationIdInOrderByConversationIdAscCreatedAtDesc(List conversationIds); + + interface ConversationUnreadCount { + Long getConversationId(); + Long getUnreadCount(); + } + + /** + * 批量统计各会话最近 500 条消息中的未读数，保持历史 countUnread 的窗口与撤回语义。 + */ + @Query(value = """ + SELECT ranked.conversation_id AS conversationId, COUNT(*) AS unreadCount + FROM ( + SELECT m.id, m.conversation_id, m.status, + ROW_NUMBER() OVER ( + PARTITION BY m.conversation_id + ORDER BY m.created_at DESC + ) AS row_no + FROM messages m + WHERE m.conversation_id IN (:conversationIds) + ) ranked + LEFT JOIN message_reads mr + ON mr.message_id = ranked.id + AND mr.reader_user_id = :readerUserId + WHERE ranked.row_no <= 500 + AND (ranked.status IS NULL OR ranked.status <> 'RECALLED') + AND mr.id IS NULL + GROUP BY ranked.conversation_id + """, nativeQuery = true) + List countUnreadByConversationIds( + @Param("conversationIds") List conversationIds, + @Param("readerUserId") Long readerUserId); + + /** + * 条件更新未命中后的当前读，用于区分并发请求已完成撤回与真实冲突。 + * PESSIMISTIC_WRITE 强制读取提交后的最新行，避免 MySQL REPEATABLE READ 使用旧快照。 + */ + @Lock(LockModeType.PESSIMISTIC_WRITE) + @Query("select m from Message m where m.id = :messageId") + java.util.Optional findCurrentByIdForRecall(@Param("messageId") Long messageId); + + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query(""" + update Message m + set m.status = 'RECALLED', + m.content = :placeholder, + m.recalledAt = :recalledAt, + m.version = m.version + 1 + where m.id = :messageId + and m.conversationId = :conversationId + and m.senderUserId = :senderUserId + and m.status = 'SENT' + and m.version = :expectedVersion + """) + int recallIfCurrent(@Param("messageId") Long messageId, + @Param("conversationId") Long conversationId, + @Param("senderUserId") Long senderUserId, + @Param("expectedVersion") Long expectedVersion, + @Param("placeholder") String placeholder, + @Param("recalledAt") LocalDateTime recalledAt); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageViewMapper.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageViewMapper.java new file mode 100644 index 0000000..7889d73 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessageViewMapper.java @@ -0,0 +1,32 @@ +package com.mydreamjob.messaging; + +import com.mydreamjob.messaging.dto.MessageResponse; +import org.springframework.stereotype.Component; + +import java.util.Objects; + +/** 集中处理 DIRECT 与 TALENT_INVITATION 消息的白名单映射。 */ +@Component +public class MessageViewMapper { + + public static final String RECALLED_PLACEHOLDER = "消息已撤回"; + + public MessageResponse toResponse(Message message, Long currentUserId, boolean talentInvitation) { + if (message == null) return null; + boolean recalled = "RECALLED".equals(message.getStatus()); + MessageResponse.MessageResponseBuilder builder = MessageResponse.builder() + .id(message.getId()) + .conversationId(message.getConversationId()) + .content(recalled ? RECALLED_PLACEHOLDER : message.getContent()) + .status(message.getStatus() == null ? "SENT" : message.getStatus()) + .recalledAt(message.getRecalledAt()) + .createdAt(message.getCreatedAt()); + if (talentInvitation) { + builder.senderScope(Objects.equals(message.getSenderUserId(), currentUserId) + ? "CURRENT_USER" : "OTHER_PARTICIPANT"); + } else { + builder.senderUserId(message.getSenderUserId()); + } + return builder.build(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingController.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingController.java index 2cbd3bf..9392101 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingController.java @@ -1,20 +1,19 @@ package com.mydreamjob.messaging; import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.audit.AuditContext; import com.mydreamjob.messaging.dto.CreateConversationRequest; +import com.mydreamjob.messaging.dto.MessagePageResponse; +import com.mydreamjob.messaging.dto.MessageResponse; import com.mydreamjob.messaging.dto.SendMessageRequest; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; -import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; -import java.util.HashMap; import java.util.List; import java.util.Map; @@ -24,72 +23,76 @@ import java.util.Map; @RequiredArgsConstructor public class MessagingController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final MessagingService messagingService; @Operation(summary = "会话列表", description = "当前用户参与的所有会话") @GetMapping public ResponseEntity>>> listConversations(HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(messagingService.listConversations(userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(messagingService.listConversations(userId), requestIdAccessor.get(request))); } @Operation(summary = "会话详情", description = "查看会话信息和未读数") @GetMapping("/{id}") public ResponseEntity>> getConversation( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(messagingService.getConversation(id, userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(messagingService.getConversation(id, userId), requestIdAccessor.get(request))); } @Operation(summary = "创建/获取会话", description = "创建或返回与另一用户的 DIRECT 会话") @PostMapping public ResponseEntity>> createConversation( @Valid @RequestBody CreateConversationRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); return ResponseEntity.ok(ApiResponse.ok( - messagingService.createOrGetDirectConversation(userId, req), getRequestId(request))); + messagingService.createOrGetDirectConversation(userId, req), requestIdAccessor.get(request))); } @Operation(summary = "发送消息", description = "在会话中发送消息，仅成员可发送") @PostMapping("/messages") public ResponseEntity>> sendMessage( @Valid @RequestBody SendMessageRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(messagingService.sendMessage(userId, req), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(messagingService.sendMessage(userId, req), requestIdAccessor.get(request))); } @Operation(summary = "消息列表", description = "分页查询会话消息，倒序；仅成员可查看") @GetMapping("/{id}/messages") - public ResponseEntity>> listMessages( + public ResponseEntity> listMessages( @PathVariable Long id, @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); - Page> result = messagingService.listMessages(id, userId, page, size); - Map data = new HashMap<>(); - data.put("items", result.getContent()); data.put("total", result.getTotalElements()); - data.put("page", result.getNumber()); data.put("size", result.getSize()); - data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + MessagePageResponse result = messagingService.listMessages(id, userId, page, size); + return ResponseEntity.ok(ApiResponse.ok(result, requestIdAccessor.get(request))); } @Operation(summary = "标记已读", description = "将当前会话所有消息标记为已读") @PostMapping("/{id}/read") public ResponseEntity>> markRead( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); messagingService.markRead(id, userId); - return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "marked as read"), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "marked as read"), requestIdAccessor.get(request))); } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + @Operation(summary = "撤回消息", description = "仅原发送者可在发送后两分钟内撤回消息；重复撤回幂等返回当前状态") + @PostMapping("/{conversationId}/messages/{messageId}/recall") + public ResponseEntity> recallMessage( + @PathVariable Long conversationId, + @PathVariable Long messageId, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + MessageResponse response = messagingService.recallMessage( + userId, conversationId, messageId, AuditContext.from(request)); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { return request.getHeader("X-Request-Id"); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingService.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingService.java index 86f72a3..b443d95 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/MessagingService.java @@ -1,7 +1,10 @@ package com.mydreamjob.messaging; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.audit.AuditService; import com.mydreamjob.audit.AuditContext; import com.mydreamjob.audit.SecurityAuditService; import com.mydreamjob.bidirectionalmatch.ApplicationMatchRecordRepository; @@ -10,6 +13,8 @@ import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; import com.mydreamjob.company.CompanyRepository; import com.mydreamjob.messaging.dto.CreateConversationRequest; +import com.mydreamjob.messaging.dto.MessagePageResponse; +import com.mydreamjob.messaging.dto.MessageResponse; import com.mydreamjob.messaging.dto.SendMessageRequest; import com.mydreamjob.safety.BlockRelationRepository; import lombok.RequiredArgsConstructor; @@ -22,6 +27,8 @@ import org.springframework.web.context.request.RequestContextHolder; import org.springframework.web.context.request.ServletRequestAttributes; import java.util.*; +import java.time.Clock; +import java.time.LocalDateTime; @Slf4j @Service @@ -37,9 +44,17 @@ public class MessagingService { private final ApplicationMatchRecordRepository applicationMatchRecordRepository; private final BlockRelationRepository blockRelationRepository; private final SecurityAuditService securityAuditService; + private final AuditService auditService; + private final com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; + private final Clock clock; + private final MessageViewMapper messageViewMapper; + private final ObjectMapper objectMapper; private static final int MAX_PAGE_SIZE = 50; private static final int MAX_CONTENT_LENGTH = 2000; + private static final String RECALLED_STATUS = "RECALLED"; + private static final String SENT_STATUS = "SENT"; + private static final int RECALL_WINDOW_MINUTES = 2; private void assertMember(Long conversationId, Long userId) { if (!memberRepository.existsByConversationIdAndUserId(conversationId, userId)) @@ -57,11 +72,14 @@ public class MessagingService { if (memberships.isEmpty()) return List.of(); List convIds = memberships.stream().map(ConversationMember::getConversationId).toList(); List convs = conversationRepository.findAllById(convIds); + Map unreadByConversation = new HashMap<>(); + messageRepository.countUnreadByConversationIds(convIds, userId).forEach(row -> + unreadByConversation.put(row.getConversationId(), row.getUnreadCount())); convs.sort((a, b) -> b.getUpdatedAt().compareTo(a.getUpdatedAt())); List> result = new ArrayList<>(); for (Conversation c : convs) { - Map v = toView(c); - v.put("unreadCount", countUnread(c.getId(), userId)); + Map v = toView(c, userId); + v.put("unreadCount", unreadByConversation.getOrDefault(c.getId(), 0L)); result.add(v); } return result; @@ -70,7 +88,7 @@ public class MessagingService { public Map getConversation(Long conversationId, Long userId) { Conversation c = requireConversation(conversationId); assertMember(conversationId, userId); - Map v = toView(c); + Map v = toView(c, userId); v.put("unreadCount", countUnread(conversationId, userId)); return v; } @@ -85,7 +103,7 @@ public class MessagingService { for (ConversationMember m : my) { if (memberRepository.existsByConversationIdAndUserId(m.getConversationId(), otherId)) { Conversation existing = conversationRepository.findById(m.getConversationId()).orElse(null); - if (existing != null && "DIRECT".equals(existing.getType())) return toView(existing); + if (existing != null && "DIRECT".equals(existing.getType())) return toView(existing, userId); } } // 新建会话：任意方向存在屏蔽 → 禁止新建 DIRECT 会话 @@ -174,19 +192,40 @@ public class MessagingService { conversationRepository.findById(req.getConversationId()).ifPresent(c -> { c.setUpdatedAt(msg.getCreatedAt()); conversationRepository.save(c); }); - return toView(msg); + // R01-D4-1：成功发送后，若发送者为学生则登记评分刷新（ACTIVITY 维度按发送消息计数）。 + // 消息撤回不登记（公式只统计发送消息总数）。 + userRepository.findById(userId).ifPresent(u -> { + if (u.getRoles() != null && u.getRoles().stream() + .anyMatch(r -> r == com.mydreamjob.auth.User.Role.STUDENT)) { + scoringRefreshRequestService.requestRefresh(userId, LocalDateTime.now(clock)); + } + }); + return toView(msg, userId); } - public Page> listMessages(Long conversationId, Long userId, int page, int size) { - requireConversation(conversationId); + public MessagePageResponse listMessages(Long conversationId, Long userId, int page, int size) { + Conversation conversation = requireConversation(conversationId); assertMember(conversationId, userId); if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) throw new BusinessException(ErrorCode.BAD_REQUEST); - return messageRepository.findByConversationIdOrderByCreatedAtDesc(conversationId, PageRequest.of(page, size)) - .map(m -> { - Map v = toView(m); - v.put("isRead", readRepository.existsByMessageIdAndReaderUserId(m.getId(), userId)); - return v; - }); + Page result = messageRepository.findByConversationIdOrderByCreatedAtDesc( + conversationId, PageRequest.of(page, size)); + List messageIds = result.getContent().stream().map(Message::getId).toList(); + Set readIds = messageIds.isEmpty() ? Set.of() : readRepository + .findByMessageIdInAndReaderUserId(messageIds, userId).stream() + .map(MessageRead::getMessageId).collect(java.util.stream.Collectors.toSet()); + boolean talentInvitation = "TALENT_INVITATION".equals(conversation.getType()); + List items = result.getContent().stream().map(m -> { + MessageResponse response = messageViewMapper.toResponse(m, userId, talentInvitation); + response.setIsRead(readIds.contains(m.getId())); + return response; + }).toList(); + return MessagePageResponse.builder() + .items(items) + .total(result.getTotalElements()) + .page(result.getNumber()) + .size(result.getSize()) + .totalPages(result.getTotalPages()) + .build(); } @Transactional @@ -195,7 +234,10 @@ public class MessagingService { assertMember(conversationId, userId); List msgs = messageRepository .findByConversationIdOrderByCreatedAtDesc(conversationId, PageRequest.of(0, 500)).getContent(); - List msgIds = msgs.stream().map(Message::getId).toList(); + List msgIds = msgs.stream() + .filter(m -> !RECALLED_STATUS.equals(m.getStatus())) + .map(Message::getId).toList(); + if (msgIds.isEmpty()) return; List existing = readRepository.findByMessageIdInAndReaderUserId(msgIds, userId); Set existingIds = new HashSet<>(); for (MessageRead r : existing) existingIds.add(r.getMessageId()); @@ -209,10 +251,104 @@ public class MessagingService { List msgs = messageRepository .findByConversationIdOrderByCreatedAtDesc(convId, PageRequest.of(0, 500)).getContent(); if (msgs.isEmpty()) return 0; - List msgIds = msgs.stream().map(Message::getId).toList(); + List msgIds = msgs.stream() + .filter(m -> !RECALLED_STATUS.equals(m.getStatus())) + .map(Message::getId).toList(); + if (msgIds.isEmpty()) return 0; return msgIds.size() - readRepository.findByMessageIdInAndReaderUserId(msgIds, userId).size(); } + /** + * 在事务内执行消息撤回。调用者身份、会话成员关系和原发送者关系均由服务端校验。 + * capturedNow 由入口统一捕获，便于边界测试，也避免同一请求混用多个时间。 + */ + @Transactional + public MessageResponse recallMessage(Long currentUserId, Long conversationId, Long messageId, + AuditContext auditContext, LocalDateTime capturedNow) { + Conversation conversation = requireConversation(conversationId); + assertMember(conversationId, currentUserId); + User currentUser = userRepository.findById(currentUserId).orElse(null); + if (currentUser != null && hasRole(currentUser, User.Role.ADMIN)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + Message message = messageRepository.findById(messageId) + .orElseThrow(() -> new BusinessException(ErrorCode.MESSAGE_NOT_FOUND)); + if (!Objects.equals(message.getConversationId(), conversationId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + if (!Objects.equals(message.getSenderUserId(), currentUserId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + + String status = message.getStatus() == null ? SENT_STATUS : message.getStatus(); + if (RECALLED_STATUS.equals(status)) { + return toMessageResponse(message, currentUserId, conversation); + } + LocalDateTime createdAt = message.getCreatedAt(); + if (createdAt == null || capturedNow == null + || capturedNow.isAfter(createdAt.plusMinutes(RECALL_WINDOW_MINUTES))) { + throw new BusinessException(ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED); + } + Long expectedVersion = message.getVersion() == null ? 0L : message.getVersion(); + int updated = messageRepository.recallIfCurrent(messageId, conversationId, currentUserId, + expectedVersion, MessageViewMapper.RECALLED_PLACEHOLDER, capturedNow); + if (updated != 1) { + Message latest = messageRepository.findCurrentByIdForRecall(messageId).orElse(null); + if (latest != null && RECALLED_STATUS.equals(latest.getStatus())) { + return toMessageResponse(latest, currentUserId, conversation); + } + throw new BusinessException(ErrorCode.MESSAGE_RECALL_CONCURRENT_UPDATE); + } + + auditService.log(currentUserId, "MESSAGE_RECALLED", "MESSAGE", messageId, + recallAuditDetails(messageId, conversationId, conversation.getType(), auditContext), + recallAuditContext(auditContext)); + Message recalled = messageRepository.findById(messageId).orElse(message); + return toMessageResponse(recalled, currentUserId, conversation); + } + + /** 生产入口使用 Spring Clock 捕获一次当前时间。 */ + @Transactional + public MessageResponse recallMessage(Long currentUserId, Long conversationId, Long messageId, + AuditContext auditContext) { + Clock effectiveClock = clock == null ? Clock.systemDefaultZone() : clock; + return recallMessage(currentUserId, conversationId, messageId, auditContext, + LocalDateTime.now(effectiveClock)); + } + + private MessageResponse toMessageResponse(Message message, Long currentUserId, Conversation conversation) { + MessageResponse response = messageViewMapper.toResponse(message, currentUserId, + conversation != null && "TALENT_INVITATION".equals(conversation.getType())); + if (response != null) { + response.setIsRead(readRepository.existsByMessageIdAndReaderUserId(message.getId(), currentUserId)); + } + return response; + } + + private AuditContext recallAuditContext(AuditContext source) { + return AuditContext.builder() + .requestId(source == null ? null : source.getRequestId()) + .build(); + } + + private String recallAuditDetails(Long messageId, Long conversationId, String conversationType, + AuditContext context) { + String safeConversationType = "DIRECT".equals(conversationType) + || "TALENT_INVITATION".equals(conversationType) + ? conversationType : "UNKNOWN"; + Map details = new LinkedHashMap<>(); + details.put("messageId", messageId); + details.put("conversationId", conversationId); + details.put("conversationType", safeConversationType); + details.put("status", "RECALLED"); + details.put("requestId", context == null ? null : context.getRequestId()); + try { + return objectMapper.writeValueAsString(details); + } catch (JsonProcessingException ex) { + throw new IllegalStateException("message recall audit serialization failed"); + } + } + public Map toView(Conversation c) { Map v = new HashMap<>(); v.put("id", c.getId()); v.put("title", c.getTitle()); v.put("type", c.getType()); @@ -220,10 +356,47 @@ public class MessagingService { return v; } + /** V42 会话隐私映射：TALENT_INVITATION 不返回 createdBy（其中可能是另一方学生 ID）。 */ + public Map toView(Conversation c, Long currentUserId) { + if (c == null || !"TALENT_INVITATION".equals(c.getType())) return toView(c); + Map v = new HashMap<>(); + v.put("id", c.getId()); v.put("title", c.getTitle()); v.put("type", c.getType()); + v.put("participantScope", "CURRENT_USER_AND_OTHER_PARTICIPANT"); + v.put("createdAt", c.getCreatedAt()); v.put("updatedAt", c.getUpdatedAt()); + return v; + } + public Map toView(Message m) { + return toLegacyView(messageViewMapper.toResponse(m, null, false)); + } + + /** V42 消息隐私映射：TALENT_INVITATION 仅返回相对发送者身份。 */ + public Map toView(Message m, Long currentUserId) { + if (m == null) return null; + return toView(m, currentUserId, isTalentInvitationConversation(m.getConversationId())); + } + + private Map toView(Message m, Long currentUserId, boolean talentInvitation) { + return toLegacyView(messageViewMapper.toResponse(m, currentUserId, talentInvitation)); + } + + private Map toLegacyView(MessageResponse response) { Map v = new HashMap<>(); - v.put("id", m.getId()); v.put("conversationId", m.getConversationId()); - v.put("senderUserId", m.getSenderUserId()); v.put("content", m.getContent()); v.put("createdAt", m.getCreatedAt()); + if (response == null) return v; + v.put("id", response.getId()); + v.put("conversationId", response.getConversationId()); + if (response.getSenderUserId() != null) v.put("senderUserId", response.getSenderUserId()); + if (response.getSenderScope() != null) v.put("senderScope", response.getSenderScope()); + v.put("content", response.getContent()); + v.put("status", response.getStatus()); + if (response.getRecalledAt() != null) v.put("recalledAt", response.getRecalledAt()); + v.put("createdAt", response.getCreatedAt()); + if (response.getIsRead() != null) v.put("isRead", response.getIsRead()); return v; } + + private boolean isTalentInvitationConversation(Long conversationId) { + return conversationId != null && conversationRepository.findById(conversationId) + .map(c -> "TALENT_INVITATION".equals(c.getType())).orElse(false); + } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessagePageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessagePageResponse.java new file mode 100644 index 0000000..fe508ae --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessagePageResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.messaging.dto; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.util.List; + +/** 消息分页白名单响应，保持既有分页字段兼容。 */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Schema(name = "MessagePageResponse", description = "脱敏消息分页响应") +public class MessagePageResponse { + + private List items; + private long total; + private int page; + private int size; + private int totalPages; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessageResponse.java new file mode 100644 index 0000000..992f5ca --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/messaging/dto/MessageResponse.java @@ -0,0 +1,31 @@ +package com.mydreamjob.messaging.dto; + +import com.fasterxml.jackson.annotation.JsonInclude; +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +/** 消息白名单响应；不直接暴露 Message 实体。 */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@JsonInclude(JsonInclude.Include.NON_NULL) +@Schema(name = "MessageResponse", description = "脱敏消息响应") +public class MessageResponse { + + private Long id; + private Long conversationId; + /** 仅 DIRECT 会话返回；TALENT_INVITATION 使用 senderScope。 */ + private Long senderUserId; + private String senderScope; + private String content; + private String status; + private LocalDateTime recalledAt; + private LocalDateTime createdAt; + private Boolean isRead; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/notification/NotificationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/notification/NotificationController.java index 2951e31..2c0a9c3 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/notification/NotificationController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/notification/NotificationController.java @@ -7,8 +7,6 @@ import jakarta.servlet.http.HttpServletRequest; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.HashMap; @@ -21,6 +19,11 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class NotificationController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final NotificationService notificationService; @Operation(summary = "通知列表", description = "当前用户的通知，分页，按时间倒序") @@ -29,7 +32,7 @@ public class NotificationController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page result = notificationService.list(userId, page, size); Map data = new HashMap<>(); data.put("items", result.getContent().stream().map(notificationService::toView).collect(Collectors.toList())); @@ -37,7 +40,7 @@ public class NotificationController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "标记已读", description = "标记单条通知已读（幂等）") @@ -45,36 +48,25 @@ public class NotificationController { public ResponseEntity>> markRead( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); notificationService.markRead(userId, id); - return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "marked as read"), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "marked as read"), requestIdAccessor.get(request))); } @Operation(summary = "全部已读", description = "标记当前用户全部通知已读（幂等）") @PostMapping("/read-all") public ResponseEntity>> markAllRead(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); int marked = notificationService.markAllRead(userId); - return ResponseEntity.ok(ApiResponse.ok(Map.of("marked", marked), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(Map.of("marked", marked), requestIdAccessor.get(request))); } @Operation(summary = "未读数", description = "当前用户未读通知数") @GetMapping("/unread-count") public ResponseEntity>> unreadCount(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); long count = notificationService.unreadCount(userId); - return ResponseEntity.ok(ApiResponse.ok(Map.of("unreadCount", count), getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); + return ResponseEntity.ok(ApiResponse.ok(Map.of("unreadCount", count), requestIdAccessor.get(request))); } - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferController.java b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferController.java index 3a835c5..d1b59fd 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferController.java @@ -15,8 +15,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.util.ArrayList; @@ -34,6 +32,11 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class OfferController { + /** R01-A2：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A2：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final OfferService offerService; @Operation(summary = "创建 Offer", description = "仅企业账号；投递存在、岗位属于本企业、投递状态可发、无有效 Offer；默认 DRAFT") @@ -41,9 +44,9 @@ public class OfferController { public ResponseEntity>> create( @Valid @RequestBody OfferCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Offer offer = offerService.createOffer(userId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), requestIdAccessor.get(request))); } @Operation(summary = "Offer 列表", description = "候选人查看收到的、企业查看发出的 Offer；支持 status、applicationId 筛选与分页") @@ -54,7 +57,7 @@ public class OfferController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page result = offerService.listOffers(userId, status, applicationId, page, size); Map data = new HashMap<>(); data.put("items", result.getContent().stream().map(offerService::toView).collect(Collectors.toList())); @@ -62,7 +65,7 @@ public class OfferController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "Offer 详情", description = "仅目标候选人、所属企业可访问；其他账号返回无权限错误") @@ -70,9 +73,9 @@ public class OfferController { public ResponseEntity>> get( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Offer offer = offerService.getOffer(id, userId); - return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), requestIdAccessor.get(request))); } @Operation(summary = "修改 Offer", description = "仅所属企业、仅 DRAFT 状态可修改；其余状态返回业务错误") @@ -81,9 +84,9 @@ public class OfferController { @PathVariable Long id, @Valid @RequestBody OfferUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Offer offer = offerService.updateOffer(userId, id, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), requestIdAccessor.get(request))); } @Operation(summary = "Offer 状态变更", description = "DRAFT→SENT 企业；SENT/NEGOTIATING→ACCEPTED/REJECTED/NEGOTIATING 候选人；重复提交幂等") @@ -92,9 +95,9 @@ public class OfferController { @PathVariable Long id, @Valid @RequestBody OfferStatusRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Offer offer = offerService.transitionStatus(userId, id, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toView(offer), requestIdAccessor.get(request))); } @Operation(summary = "Offer 状态时间线", description = "完整状态变更历史，含操作者、原因与请求 ID") @@ -102,9 +105,9 @@ public class OfferController { public ResponseEntity>>> timeline( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List> data = offerService.getTimeline(id, userId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "手动提醒", description = "仅所属企业；仅 SENT/NEGOTIATING 可提醒；相同提醒不重复创建") @@ -112,14 +115,14 @@ public class OfferController { public ResponseEntity>> remind( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); OfferReminder reminder = offerService.remind(userId, id, AuditContext.from(request)); Map data = new HashMap<>(); data.put("offerId", reminder.getOfferId()); data.put("reminderType", reminder.getReminderType()); data.put("status", reminder.getStatus()); data.put("sentAt", reminder.getSentAt()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── Offer 进阶接口 ───────────────────────────────────────── @@ -130,9 +133,9 @@ public class OfferController { @PathVariable Long id, @Valid @RequestBody CounterOfferCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); OfferCounterOffer co = offerService.createCounterOffer(userId, id, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), requestIdAccessor.get(request))); } @Operation(summary = "还价列表", description = "候选人查看本人 Offer 的还价、企业查看本企业 Offer 的还价") @@ -140,10 +143,10 @@ public class OfferController { public ResponseEntity>>> listCounterOffers( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List> items = offerService.getCounterOffers(id, userId) .stream().map(offerService::toCounterOfferView).collect(Collectors.toList()); - return ResponseEntity.ok(ApiResponse.ok(items, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(items, requestIdAccessor.get(request))); } @Operation(summary = "接受还价", description = "仅所属企业；接受后更新 Offer 薪资/入职日期并变为 ACCEPTED") @@ -152,9 +155,9 @@ public class OfferController { @PathVariable Long id, @PathVariable Long coId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); OfferCounterOffer co = offerService.acceptCounterOffer(userId, id, coId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), requestIdAccessor.get(request))); } @Operation(summary = "拒绝还价", description = "仅所属企业；拒绝后 Offer 保持 NEGOTIATING") @@ -163,9 +166,9 @@ public class OfferController { @PathVariable Long id, @PathVariable Long coId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); OfferCounterOffer co = offerService.rejectCounterOffer(userId, id, coId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(offerService.toCounterOfferView(co), requestIdAccessor.get(request))); } @Operation(summary = "Offer 比较", description = "仅候选人本人；比较 2-5 个非 DRAFT 的 Offer") @@ -173,10 +176,10 @@ public class OfferController { public ResponseEntity>>> compare( @RequestParam("ids") String idsParam, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List ids = parseIds(idsParam); List> items = offerService.compareOffers(userId, ids); - return ResponseEntity.ok(ApiResponse.ok(items, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(items, requestIdAccessor.get(request))); } @Operation(summary = "Offer 统计", description = "仅企业；统计本企业 Offer 状态分布、接受率、平均响应时间") @@ -184,9 +187,9 @@ public class OfferController { public ResponseEntity>> statistics( @RequestParam(required = false, defaultValue = "6") Integer months, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map data = offerService.getStatistics(userId, months); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } /** @@ -216,14 +219,4 @@ public class OfferController { return ids; } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferExpiryWorker.java b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferExpiryWorker.java index 4d44423..a006531 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferExpiryWorker.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferExpiryWorker.java @@ -35,6 +35,13 @@ public class OfferExpiryWorker { private final OfferCounterOfferRepository counterOfferRepository; private final CompanyRepository companyRepository; private final NotificationService notificationService; + /** + * R01-D4-2 F1：Offer 自动过期是评分输入的真实写侧事件 + * （{@code CandidateScoringCalculator#queryOffers} 以 {@code status='EXPIRED'} 计数参与 + * INTEGRITY 维度），必须与状态变更登记在同一事务。 + */ + private final com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService + scoringRefreshRequestService; /** 到期自动失效：SENT/NEGOTIATING → EXPIRED */ @Transactional(propagation = Propagation.REQUIRES_NEW) @@ -59,6 +66,8 @@ public class OfferExpiryWorker { .build()); // 同步将 PENDING 还价标记为 EXPIRED counterOfferRepository.expirePendingByOfferId(saved.getId()); + // R01-D4-2 F1：状态变更与刷新登记同一事务——任一步失败则二者一起回滚。 + scoringRefreshRequestService.requestRefresh(saved.getCandidateId(), LocalDateTime.now()); notifyExpired(saved); log.info("Offer {} expired ({})", saved.getId(), status); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferService.java b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferService.java index c2bdc14..e0f52d8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferService.java @@ -13,6 +13,7 @@ import com.mydreamjob.company.CompanyRepository; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobService; import com.mydreamjob.notification.NotificationService; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import com.mydreamjob.offer.dto.CounterOfferCreateRequest; import com.mydreamjob.offer.dto.OfferCreateRequest; import com.mydreamjob.offer.dto.OfferStatusRequest; @@ -64,6 +65,8 @@ public class OfferService { private final UserRepository userRepository; private final NotificationService notificationService; private final AuditService auditService; + /** R01-D4-1：Offer 状态变更（ACCEPTED/EXPIRED 履约聚合）后登记评分快照刷新。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; @PersistenceContext private EntityManager entityManager; @@ -297,6 +300,8 @@ public class OfferService { notifyStatusChange(saved, fromStatus, to); auditService.log(operatorUserId, "UPDATE_OFFER_STATUS", "OFFER", saved.getId(), "Offer status changed: " + fromStatus + " → " + to.name(), ctx); + // R01-D4-1：Offer 状态变更影响 ACCEPTED/EXPIRED 履约聚合（INTEGRITY）→ 登记刷新。 + scoringRefreshRequestService.requestRefresh(offer.getCandidateId(), java.time.LocalDateTime.now()); return saved; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferStatusHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferStatusHistoryRepository.java index 97a1772..eb090c8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferStatusHistoryRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/offer/OfferStatusHistoryRepository.java @@ -13,6 +13,8 @@ public interface OfferStatusHistoryRepository extends JpaRepository findByOfferIdOrderByCreatedAtAsc(Long offerId); + List findByOfferIdInOrderByOfferIdAscCreatedAtAsc(List offerIds); + /** 查询某企业指定时间范围内的状态历史（用于统计平均响应时间） */ @Query("SELECT h FROM OfferStatusHistory h, Offer o " + "WHERE h.offerId = o.id AND o.companyId = :companyId AND h.createdAt >= :since " + diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceController.java b/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceController.java index e53f6ed..24d5b57 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceController.java @@ -1,15 +1,15 @@ package com.mydreamjob.preference; import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.preference.dto.StudentPreferenceRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.*; import java.util.Map; @@ -21,13 +21,15 @@ import java.util.Map; public class PreferenceController { private final PreferenceService preferenceService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "查询求职偏好", description = "仅 STUDENT；无记录时返回空偏好对象") @GetMapping("/preferences") public ResponseEntity>> getPreferences(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = preferenceService.getPreferences(userId); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "保存求职偏好", description = "仅 STUDENT；upsert，完全替换传入字段") @@ -35,21 +37,8 @@ public class PreferenceController { public ResponseEntity>> savePreferences( @Valid @RequestBody StudentPreferenceRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = preferenceService.savePreferences(userId, req); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceService.java b/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceService.java index 06aca67..9ff2007 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/preference/PreferenceService.java @@ -4,15 +4,18 @@ 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.candidatescore.refresh.CandidateScoringRefreshRequestService; import com.mydreamjob.preference.dto.StudentPreferenceRequest; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.core.type.TypeReference; import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.security.UserRoleGuard; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.time.LocalDateTime; import java.util.HashMap; import java.util.List; import java.util.Map; @@ -22,20 +25,17 @@ import java.util.Map; @RequiredArgsConstructor public class PreferenceService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final StudentPreferenceRepository preferenceRepository; private final UserRepository userRepository; + /** R01-D4-1：求职偏好更新后登记评分快照刷新（COMPLIANCE 维度）。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; private static final ObjectMapper mapper = new ObjectMapper(); // ── 角色校验 ────────────────────────────────────────────── public void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream() - .anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireStudent(userId); } // ── 查询 ────────────────────────────────────────────────── @@ -68,6 +68,8 @@ public class PreferenceService { if (req.getRemoteAllowed() != null) pref.setRemoteAllowed(req.getRemoteAllowed()); StudentPreference saved = preferenceRepository.save(pref); + // R01-D4-1：偏好更新影响 COMPLIANCE 维度 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(studentUserId, LocalDateTime.now()); return toView(saved); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsController.java b/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsController.java index 8a16618..be04d75 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsController.java @@ -1,10 +1,10 @@ package com.mydreamjob.privacy; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.privacy.dto.PrivacySettingsResponse; import com.mydreamjob.privacy.dto.PrivacySettingsUpdateRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.media.Content; import io.swagger.v3.oas.annotations.media.ExampleObject; @@ -16,8 +16,6 @@ import jakarta.servlet.http.HttpServletRequest; import jakarta.validation.Valid; 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.PutMapping; import org.springframework.web.bind.annotation.RequestBody; @@ -31,6 +29,8 @@ import org.springframework.web.bind.annotation.RestController; public class PrivacySettingsController { private final PrivacySettingsService privacySettingsService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation( summary = "查询当前学生隐私设置", @@ -77,9 +77,9 @@ public class PrivacySettingsController { }) @GetMapping public ResponseEntity> getMyPrivacySettings(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); PrivacySettingsResponse response = privacySettingsService.getCurrentUserSettings(userId); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } @Operation( @@ -139,20 +139,8 @@ public class PrivacySettingsController { public ResponseEntity> updateMyPrivacySettings( @Valid @RequestBody PrivacySettingsUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); PrivacySettingsResponse response = privacySettingsService.updateCurrentUserSettings(userId, req); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsService.java b/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsService.java index d4fb899..9b36b36 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/privacy/PrivacySettingsService.java @@ -1,16 +1,14 @@ package com.mydreamjob.privacy; -import com.mydreamjob.application.Application; -import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.application.CompanyResumeAccessPolicy; import com.mydreamjob.audit.AuditService; 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.company.Company; -import com.mydreamjob.company.CompanyRepository; import com.mydreamjob.privacy.dto.PrivacySettingsResponse; import com.mydreamjob.privacy.dto.PrivacySettingsUpdateRequest; +import com.mydreamjob.security.UserRoleGuard; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.dao.DataIntegrityViolationException; @@ -18,8 +16,6 @@ import org.springframework.orm.ObjectOptimisticLockingFailureException; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; -import java.util.Set; - /** * 学生隐私设置服务。 * @@ -31,24 +27,20 @@ import java.util.Set; @RequiredArgsConstructor public class PrivacySettingsService { - /** 视为"非有效投递"的状态：撤销或已拒绝的投递不允许企业查看简历 */ - private static final Set INEFFECTIVE_STATUSES = Set.of("WITHDRAWN", "REJECTED"); - + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final StudentPrivacySettingsRepository privacyRepository; private final UserRepository userRepository; - private final ApplicationRepository applicationRepository; - private final CompanyRepository companyRepository; private final AuditService auditService; + /** + * S03-B：企业简历可见性统一由失败关闭的授权策略判定。 + * 策略强制校验「投递所属岗位属于该企业」，修复了此前只校验学生与状态、 + * 不校验企业归属的缺陷。 + */ + private final CompanyResumeAccessPolicy companyResumeAccessPolicy; /** 校验当前用户必须为 STUDENT，否则抛 FORBIDDEN。 */ public void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles() != null - && user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireStudent(userId); } /** @@ -105,33 +97,20 @@ public class PrivacySettingsService { } /** - * 企业是否可查看某学生的简历。 + * 企业是否可查看某学生的简历（S03-B：委托给失败关闭的授权策略）。 + * + *

    判定需要同时满足：投递存在、投递学生与传入 {@code studentUserId} 一致、 + * 投递所属岗位属于 {@code companyId}，再按隐私设置决定：

    * *
      - *
    • PRIVATE：企业不可见
      • - *
    • APPLIED_COMPANIES：仅当该学生在该企业存在有效投递时可见（WITHDRAWN/REJECTED 不算）
      • - *
    • VERIFIED_COMPANIES：仅当企业 verified=true 时可见
      • + *
    • 无记录 / null / PRIVATE：不可见
      • + *
    • APPLIED_COMPANIES：岗位属于该企业且投递状态为 + * SUBMITTED/VIEWED/INTERVIEW/HIRED
      • + *
    • VERIFIED_COMPANIES：该企业 {@code verified=true} 且拥有该投递岗位
      • *
    */ public boolean canCompanyViewResume(Long studentUserId, Long companyId, Long applicationId) { - StudentPrivacySettings settings = privacyRepository.findByStudentUserId(studentUserId).orElse(null); - ResumeVisibility visibility = (settings == null || settings.getResumeVisibility() == null) - ? ResumeVisibility.PRIVATE : settings.getResumeVisibility(); - switch (visibility) { - case VERIFIED_COMPANIES: - Company company = companyRepository.findById(companyId).orElse(null); - return company != null && Boolean.TRUE.equals(company.getVerified()); - case APPLIED_COMPANIES: - // 投递表不含 companyId，以 applicationId 定位具体投递校验有效状态（WITHDRAWN/REJECTED 不算有效） - Application app = applicationRepository.findById(applicationId).orElse(null); - if (app == null || !studentUserId.equals(app.getStudentUserId())) { - return false; - } - return !INEFFECTIVE_STATUSES.contains(app.getStatus()); - case PRIVATE: - default: - return false; - } + return companyResumeAccessPolicy.isVisible(studentUserId, companyId, applicationId); } /** diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileController.java b/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileController.java index 4a5a8c3..63a088f 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileController.java @@ -2,7 +2,10 @@ package com.mydreamjob.profile; import com.mydreamjob.profile.dto.StudentProfileResponse; import com.mydreamjob.profile.dto.StudentProfileUpdateRequest; +import com.mydreamjob.profile.storage.ResumeFilenameSanitizer; import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.media.Content; import io.swagger.v3.oas.annotations.media.ExampleObject; @@ -17,8 +20,6 @@ import org.springframework.http.ContentDisposition; import org.springframework.http.HttpHeaders; import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; @@ -32,6 +33,8 @@ import java.util.Map; public class ProfileController { private final ProfileService profileService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; // ── 资料 CRUD ──────────────────────────────────────────── @@ -80,10 +83,10 @@ public class ProfileController { }) @GetMapping("/me") public ResponseEntity> getMyProfile(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); profileService.assertStudentRole(userId); StudentProfileResponse response = profileService.toResponse(profileService.findProfileByUserId(userId)); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(response, requestIdAccessor.get(request))); } @Operation(summary = "更新学生资料", description = "仅更新传入的非 null 字段；不存在则自动创建") @@ -91,9 +94,9 @@ public class ProfileController { public ResponseEntity>> updateMyProfile( @Valid @RequestBody StudentProfileUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = profileService.toView(profileService.updateProfile(userId, req)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } // ── 简历管理 ────────────────────────────────────────────── @@ -103,19 +106,19 @@ public class ProfileController { public ResponseEntity>> uploadResume( @RequestParam("file") MultipartFile file, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = profileService.uploadResume(userId, file); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "下载简历", description = "下载当前学生上传的简历文件，仅 STUDENT 角色") @GetMapping("/me/resume") public ResponseEntity downloadResume(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ProfileService.ResumeFile rf = profileService.getResume(userId); MediaType mediaType = resolveContentType(rf.getContentType()); ContentDisposition cd = ContentDisposition.inline() - .filename(rf.getFilename(), StandardCharsets.UTF_8) + .filename(ResumeFilenameSanitizer.forDownload(rf.getFilename(), "resume"), StandardCharsets.UTF_8) .build(); return ResponseEntity.ok() .contentType(mediaType) @@ -126,27 +129,14 @@ public class ProfileController { @Operation(summary = "删除简历", description = "删除当前学生的简历文件并清空 resumeUrl，仅 STUDENT 角色") @DeleteMapping("/me/resume") public ResponseEntity>> deleteResume(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); profileService.deleteResume(userId); return ResponseEntity.ok(ApiResponse.ok( - Map.of("message", "resume deleted"), getRequestId(request))); + Map.of("message", "resume deleted"), requestIdAccessor.get(request))); } // ── 辅助 ────────────────────────────────────────────────── - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } - private MediaType resolveContentType(String contentType) { if (contentType == null) return MediaType.APPLICATION_OCTET_STREAM; try { diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileService.java b/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileService.java index f1345bd..c1c2498 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/profile/ProfileService.java @@ -6,55 +6,46 @@ import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.profile.dto.StudentProfileResponse; import com.mydreamjob.profile.dto.StudentProfileUpdateRequest; +import com.mydreamjob.profile.storage.ResumeFileValidator; +import com.mydreamjob.profile.storage.ResumeFilenameSanitizer; import com.mydreamjob.profile.storage.ResumeStorageService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import lombok.Getter; +import com.mydreamjob.security.UserRoleGuard; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionSynchronization; +import org.springframework.transaction.support.TransactionSynchronizationManager; import org.springframework.web.multipart.MultipartFile; +import java.time.LocalDateTime; import java.util.HashMap; import java.util.List; import java.util.Map; -import java.util.Set; @Slf4j @Service @RequiredArgsConstructor public class ProfileService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final StudentProfileRepository profileRepository; private final ResumeStorageService resumeStorageService; private final UserRepository userRepository; + private final ResumeFileValidator resumeFileValidator; + /** R01-D4-1：学生资料/简历更新后登记评分快照刷新。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper(); - private static final Set ALLOWED_CONTENT_TYPES = Set.of( - "application/pdf", - "application/msword", - "application/vnd.openxmlformats-officedocument.wordprocessingml.document" - ); - private static final Set ALLOWED_EXTENSIONS = Set.of(".pdf", ".doc", ".docx"); - private static final Map EXT_TO_CONTENT_TYPE = Map.of( - ".pdf", "application/pdf", - ".doc", "application/msword", - ".docx", "application/vnd.openxmlformats-officedocument.wordprocessingml.document" - ); - private static final long MAX_RESUME_SIZE = 10 * 1024 * 1024L; - // ── 角色校验 ────────────────────────────────────────────── public void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream() - .anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireStudent(userId); } // ── 学生资料 CRUD ──────────────────────────────────────── @@ -75,7 +66,10 @@ public class ProfileService { if (req.getGraduationYear() != null) profile.setGraduationYear(req.getGraduationYear().shortValue()); if (req.getResumeUrl() != null) profile.setResumeUrl(req.getResumeUrl()); if (req.getSkills() != null) profile.setSkillsJson(toValidJson(req.getSkills())); - return profileRepository.save(profile); + StudentProfile saved = profileRepository.save(profile); + // R01-D4-1：资料（含学历/学校/技能/简历链接）变化影响 8 维评分 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(userId, LocalDateTime.now()); + return saved; } /** @@ -94,32 +88,7 @@ public class ProfileService { // ── 简历校验 ────────────────────────────────────────────── public void validateResumeFile(MultipartFile file) { - if (file == null || file.isEmpty()) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - if (file.getSize() > MAX_RESUME_SIZE) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - - String originalName = file.getOriginalFilename(); - if (originalName == null || !originalName.contains(".")) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - String ext = originalName.substring(originalName.lastIndexOf('.')).toLowerCase(); - if (!ALLOWED_EXTENSIONS.contains(ext)) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - - String contentType = file.getContentType(); - if (contentType == null || !ALLOWED_CONTENT_TYPES.contains(contentType)) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - - // 验证扩展名与 Content-Type 一致 - String expectedContentType = EXT_TO_CONTENT_TYPE.get(ext); - if (!contentType.equals(expectedContentType)) { - throw new BusinessException(ErrorCode.BAD_REQUEST); - } + resumeFileValidator.validate(file); } // ── 简历上传 ────────────────────────────────────────────── @@ -132,17 +101,27 @@ public class ProfileService { StudentProfile profile = profileRepository.findByUserId(userId) .orElse(StudentProfile.builder().userId(userId).build()); - // 删除旧文件 - if (profile.getResumeUrl() != null) { - resumeStorageService.delete(profile.getResumeUrl()); - } - + String oldPath = profile.getResumeUrl(); String newPath = resumeStorageService.store(userId, file); + if (newPath == null || newPath.isBlank()) { + throw new IllegalStateException("resume storage returned no path"); + } + boolean synchronizationRegistered = registerReplacementLifecycle(oldPath, newPath); profile.setResumeUrl(newPath); - profile.setResumeOriginalName(file.getOriginalFilename()); + profile.setResumeOriginalName(ResumeFilenameSanitizer.forDownload(file.getOriginalFilename(), "resume")); profile.setResumeContentType(file.getContentType()); profile.setResumeSize(file.getSize()); - profileRepository.save(profile); + try { + profileRepository.save(profile); + } catch (RuntimeException e) { + if (!synchronizationRegistered && !newPath.equals(oldPath)) { + resumeStorageService.delete(newPath); + } + throw e; + } + if (!synchronizationRegistered && oldPath != null && !oldPath.equals(newPath)) { + resumeStorageService.delete(oldPath); + } return toResumeView(profile); } @@ -170,12 +149,13 @@ public class ProfileService { StudentProfile profile = profileRepository.findByUserId(userId) .orElseThrow(() -> new BusinessException(ErrorCode.PROFILE_NOT_FOUND)); if (profile.getResumeUrl() != null) { - resumeStorageService.delete(profile.getResumeUrl()); + String storagePath = profile.getResumeUrl(); profile.setResumeUrl(null); profile.setResumeOriginalName(null); profile.setResumeContentType(null); profile.setResumeSize(null); profileRepository.save(profile); + deleteFileAfterCommit(storagePath); } } @@ -242,4 +222,39 @@ public class ProfileService { this.content = content; } } + + private boolean registerReplacementLifecycle(String oldPath, String newPath) { + if (!TransactionSynchronizationManager.isSynchronizationActive()) { + return false; + } + TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() { + @Override + public void afterCommit() { + if (oldPath != null && !oldPath.equals(newPath)) { + resumeStorageService.delete(oldPath); + } + } + + @Override + public void afterCompletion(int status) { + if (status != TransactionSynchronization.STATUS_COMMITTED && !newPath.equals(oldPath)) { + resumeStorageService.delete(newPath); + } + } + }); + return true; + } + + private void deleteFileAfterCommit(String storagePath) { + if (!TransactionSynchronizationManager.isSynchronizationActive()) { + resumeStorageService.delete(storagePath); + return; + } + TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() { + @Override + public void afterCommit() { + resumeStorageService.delete(storagePath); + } + }); + } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/LocalResumeStorageService.java b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/LocalResumeStorageService.java index 17d8b8f..2d84fa2 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/LocalResumeStorageService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/LocalResumeStorageService.java @@ -49,15 +49,27 @@ public class LocalResumeStorageService implements ResumeStorageService { String ext = getExtension(originalName); String storedName = userId + "_" + UUID.randomUUID().toString().substring(0, 8) + ext; Path target = basePath.resolve(storedName).normalize(); + Path temporary = basePath.resolve(storedName + ".uploading").normalize(); // 禁止路径穿越 - if (!target.startsWith(basePath)) { + if (!target.startsWith(basePath) || !temporary.startsWith(basePath)) { throw new BusinessException(ErrorCode.BAD_REQUEST); } try { - Files.copy(file.getInputStream(), target, StandardCopyOption.REPLACE_EXISTING); + // Never expose a partially copied file under its final storage key. + Files.copy(file.getInputStream(), temporary, StandardCopyOption.REPLACE_EXISTING); + try { + Files.move(temporary, target, StandardCopyOption.ATOMIC_MOVE); + } catch (java.nio.file.AtomicMoveNotSupportedException ignored) { + Files.move(temporary, target, StandardCopyOption.REPLACE_EXISTING); + } } catch (IOException e) { + try { + Files.deleteIfExists(temporary); + } catch (IOException cleanupFailure) { + e.addSuppressed(cleanupFailure); + } throw new RuntimeException("Failed to store resume", e); } log.info("Resume stored: userId={}, path={}", userId, storedName); diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFileValidator.java b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFileValidator.java new file mode 100644 index 0000000..b697e4b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFileValidator.java @@ -0,0 +1,216 @@ +package com.mydreamjob.profile.storage; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.springframework.stereotype.Component; +import org.springframework.web.multipart.MultipartFile; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.Map; +import java.util.Set; +import java.util.zip.ZipEntry; +import java.util.zip.ZipException; +import java.util.zip.ZipInputStream; + +/** + * 简历上传白名单校验器。 + * + *

    扩展名和客户端 Content-Type 只作为第一层校验；随后检查文件实际签名。 + * DOCX 还会验证必要的 Office Open XML 条目，并限制条目数、解压总量和压缩比， + * 避免将任意 ZIP、路径穿越条目或压缩炸弹当作简历保存。

    + * + *

    本校验不等同于恶意软件扫描。生产环境如需病毒查杀，应在独立安全组件中完成。

    + */ +@Component +public class ResumeFileValidator { + + static final long MAX_FILE_SIZE = 10L * 1024 * 1024; + static final int MAX_DOCX_ENTRIES = 1_024; + static final long MAX_DOCX_UNCOMPRESSED_BYTES = 40L * 1024 * 1024; + static final long MAX_DOCX_COMPRESSION_RATIO = 100L; + private static final int BUFFER_SIZE = 8 * 1024; + + private static final Set ALLOWED_EXTENSIONS = Set.of(".pdf", ".doc", ".docx"); + private static final Map EXT_TO_CONTENT_TYPE = Map.of( + ".pdf", "application/pdf", + ".doc", "application/msword", + ".docx", "application/vnd.openxmlformats-officedocument.wordprocessingml.document" + ); + + private static final byte[] PDF_SIGNATURE = {'%', 'P', 'D', 'F', '-'}; + private static final byte[] OLE_SIGNATURE = { + (byte) 0xD0, (byte) 0xCF, 0x11, (byte) 0xE0, + (byte) 0xA1, (byte) 0xB1, 0x1A, (byte) 0xE1 + }; + private static final byte[] WORD_DOCUMENT_UTF16_LE = { + 'W', 0, 'o', 0, 'r', 0, 'd', 0, 'D', 0, 'o', 0, 'c', 0, + 'u', 0, 'm', 0, 'e', 0, 'n', 0, 't', 0 + }; + + public void validate(MultipartFile file) { + if (file == null || file.isEmpty() || file.getSize() <= 0 || file.getSize() > MAX_FILE_SIZE) { + reject(); + } + + String originalName = file.getOriginalFilename(); + ResumeFilenameSanitizer.validateUploadName(originalName); + String extension = extensionOf(originalName); + if (!ALLOWED_EXTENSIONS.contains(extension)) { + reject(); + } + + String contentType = file.getContentType(); + if (!EXT_TO_CONTENT_TYPE.get(extension).equals(contentType)) { + reject(); + } + + byte[] content; + try { + content = file.getBytes(); + } catch (IOException e) { + reject(); + return; + } + if (content.length == 0 || content.length > MAX_FILE_SIZE) { + reject(); + } + + switch (extension) { + case ".pdf" -> validatePdf(content); + case ".doc" -> validateLegacyDoc(content); + case ".docx" -> validateDocx(content); + default -> reject(); + } + } + + private void validatePdf(byte[] content) { + int offset = startsWith(content, new byte[]{(byte) 0xEF, (byte) 0xBB, (byte) 0xBF}) ? 3 : 0; + while (offset < content.length && offset < 16 && isAsciiWhitespace(content[offset])) { + offset++; + } + if (!startsWithAt(content, PDF_SIGNATURE, offset)) { + reject(); + } + int searchStart = Math.max(0, content.length - 2_048); + if (indexOf(content, new byte[]{'%', '%', 'E', 'O', 'F'}, searchStart) < 0) { + reject(); + } + } + + private void validateLegacyDoc(byte[] content) { + if (!startsWith(content, OLE_SIGNATURE) || indexOf(content, WORD_DOCUMENT_UTF16_LE, 0) < 0) { + reject(); + } + } + + private void validateDocx(byte[] content) { + if (!startsWith(content, new byte[]{'P', 'K'})) { + reject(); + } + + boolean contentTypesFound = false; + boolean documentFound = false; + int entryCount = 0; + long uncompressedBytes = 0; + byte[] buffer = new byte[BUFFER_SIZE]; + + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(content))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + entryCount++; + if (entryCount > MAX_DOCX_ENTRIES || unsafeEntryName(entry.getName())) { + reject(); + } + if ("[Content_Types].xml".equals(entry.getName())) { + contentTypesFound = true; + } else if ("word/document.xml".equals(entry.getName())) { + documentFound = true; + } + + int read; + while ((read = zip.read(buffer)) != -1) { + uncompressedBytes += read; + if (uncompressedBytes > MAX_DOCX_UNCOMPRESSED_BYTES + || uncompressedBytes > safeMultiply(content.length, MAX_DOCX_COMPRESSION_RATIO)) { + reject(); + } + } + zip.closeEntry(); + } + } catch (ZipException e) { + reject(); + } catch (IOException e) { + reject(); + } + + if (!contentTypesFound || !documentFound) { + reject(); + } + } + + private boolean unsafeEntryName(String name) { + if (name == null || name.isBlank() || name.startsWith("/") || name.startsWith("\\") + || name.contains("\\") || name.indexOf('\0') >= 0 || name.contains(":")) { + return true; + } + for (String segment : name.split("/")) { + if ("..".equals(segment)) { + return true; + } + } + return false; + } + + private long safeMultiply(long value, long multiplier) { + if (value > Long.MAX_VALUE / multiplier) { + return Long.MAX_VALUE; + } + return value * multiplier; + } + + private String extensionOf(String filename) { + int dot = filename.lastIndexOf('.'); + if (dot <= 0 || dot == filename.length() - 1) { + reject(); + } + return filename.substring(dot).toLowerCase(java.util.Locale.ROOT); + } + + private boolean startsWith(byte[] content, byte[] signature) { + return startsWithAt(content, signature, 0); + } + + private boolean startsWithAt(byte[] content, byte[] signature, int offset) { + if (offset < 0 || content.length - offset < signature.length) { + return false; + } + for (int i = 0; i < signature.length; i++) { + if (content[offset + i] != signature[i]) { + return false; + } + } + return true; + } + + private int indexOf(byte[] content, byte[] target, int start) { + outer: + for (int i = Math.max(0, start); i <= content.length - target.length; i++) { + for (int j = 0; j < target.length; j++) { + if (content[i + j] != target[j]) { + continue outer; + } + } + return i; + } + return -1; + } + + private boolean isAsciiWhitespace(byte value) { + return value == ' ' || value == '\t' || value == '\r' || value == '\n' || value == '\f'; + } + + private void reject() { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFilenameSanitizer.java b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFilenameSanitizer.java new file mode 100644 index 0000000..276b22c --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/profile/storage/ResumeFilenameSanitizer.java @@ -0,0 +1,54 @@ +package com.mydreamjob.profile.storage; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; + +/** 文件名白名单处理：阻止路径字符、控制字符和响应头换行进入存储元数据或下载响应。 */ +public final class ResumeFilenameSanitizer { + + private static final int MAX_FILENAME_LENGTH = 255; + + private ResumeFilenameSanitizer() { + } + + public static void validateUploadName(String filename) { + if (filename == null || filename.isBlank() || filename.length() > MAX_FILENAME_LENGTH) { + reject(); + } + for (int i = 0; i < filename.length(); i++) { + char c = filename.charAt(i); + if (Character.isISOControl(c) || c == '/' || c == '\\' || c == ':') { + reject(); + } + } + if (".".equals(filename) || "..".equals(filename)) { + reject(); + } + } + + /** + * 兼容历史数据的下载文件名净化。新上传文件已在入口处拒绝危险字符， + * 此方法为旧记录提供防御性兜底，不返回路径片段或换行。 + */ + public static String forDownload(String filename, String fallback) { + String safeFallback = (fallback == null || fallback.isBlank()) ? "resume" : fallback; + if (filename == null || filename.isBlank()) { + return safeFallback; + } + StringBuilder safe = new StringBuilder(Math.min(filename.length(), MAX_FILENAME_LENGTH)); + for (int i = 0; i < filename.length() && safe.length() < MAX_FILENAME_LENGTH; i++) { + char c = filename.charAt(i); + if (Character.isISOControl(c) || c == '/' || c == '\\' || c == ':') { + safe.append('_'); + } else { + safe.append(c); + } + } + String result = safe.toString().trim(); + return result.isEmpty() || ".".equals(result) || "..".equals(result) ? safeFallback : result; + } + + private static void reject() { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculator.java new file mode 100644 index 0000000..7368f4a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculator.java @@ -0,0 +1,68 @@ +package com.mydreamjob.recommendation; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +/** Pure calculator for the existing 30/20/20/15/15 job-preference score. */ +public final class JobPreferenceScoreCalculator { + + private static final int CITY_WEIGHT = 30; + private static final int EMPLOYMENT_TYPE_WEIGHT = 20; + private static final int SALARY_WEIGHT = 20; + private static final int INDUSTRY_WEIGHT = 15; + private static final int JOB_FAMILY_WEIGHT = 15; + + private JobPreferenceScoreCalculator() { + } + + public static BigDecimal calculate(Criteria criteria, Target target) { + int matched = 0; + int available = 0; + + if (!criteria.cities().isEmpty()) { + available += CITY_WEIGHT; + if (criteria.cities().contains(target.city())) matched += CITY_WEIGHT; + } + if (!criteria.employmentTypes().isEmpty()) { + available += EMPLOYMENT_TYPE_WEIGHT; + if (criteria.employmentTypes().contains(target.employmentType())) matched += EMPLOYMENT_TYPE_WEIGHT; + } + if (criteria.expectedSalaryMin() != null) { + available += SALARY_WEIGHT; + if (target.salaryMax() != null && target.salaryMax() >= criteria.expectedSalaryMin()) { + matched += SALARY_WEIGHT; + } + } + if (!criteria.industries().isEmpty()) { + available += INDUSTRY_WEIGHT; + if (criteria.industries().contains(target.industryCode())) matched += INDUSTRY_WEIGHT; + } + if (!criteria.jobFamilies().isEmpty()) { + available += JOB_FAMILY_WEIGHT; + if (criteria.jobFamilies().contains(target.jobFamilyCode())) matched += JOB_FAMILY_WEIGHT; + } + return available == 0 ? null : BigDecimal.valueOf(matched * 100L) + .divide(BigDecimal.valueOf(available), 2, RoundingMode.HALF_UP); + } + + public record Criteria(List cities, List employmentTypes, Integer expectedSalaryMin, + List industries, List jobFamilies) { + public Criteria { + cities = copyPreservingNulls(cities); + employmentTypes = copyPreservingNulls(employmentTypes); + industries = copyPreservingNulls(industries); + jobFamilies = copyPreservingNulls(jobFamilies); + } + + private static List copyPreservingNulls(List values) { + return values == null ? List.of() : Collections.unmodifiableList(new ArrayList<>(values)); + } + } + + public record Target(String city, String employmentType, Integer salaryMax, + String industryCode, String jobFamilyCode) { + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationController.java new file mode 100644 index 0000000..05ed3cf --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationController.java @@ -0,0 +1,68 @@ +package com.mydreamjob.recommendation; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.api.PageResponse; +import com.mydreamjob.common.exception.*; +import com.mydreamjob.recommendation.dto.*; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.security.core.*; +import org.springframework.web.bind.annotation.*; +import java.util.List; + +/** V39 学生推荐、企业画像、分类字典与 ADMIN 审核接口。身份仅取 SecurityContext。 */ +@RestController +@RequiredArgsConstructor +public class JobRecommendationController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + + private final JobRecommendationService service; + + @GetMapping("/job-recommendation-taxonomies") + public ApiResponse> taxonomies(HttpServletRequest request) { + return ApiResponse.ok(service.taxonomies(), requestIdAccessor.get(request)); + } + + @GetMapping("/profile/me/job-recommendations") + public ApiResponse> recommendations(@RequestParam(defaultValue="0") int page, @RequestParam(defaultValue="20") int size, HttpServletRequest request) { + Page result = service.recommend(currentUserAccessor.requireUserId(), page, size); + return ApiResponse.ok(PageResponse.of(result.getContent(),result.getTotalElements(),result.getNumber(),result.getSize()),requestIdAccessor.get(request)); + } + + @PostMapping("/profile/me/job-recommendations/{jobId}/feedback") + public ApiResponse feedback(@PathVariable Long jobId,@Valid @RequestBody RecommendationFeedbackRequest body,HttpServletRequest request) { + return ApiResponse.ok(service.feedback(currentUserAccessor.requireUserId(),jobId,body,AuditContext.from(request)),requestIdAccessor.get(request)); + } + + @DeleteMapping("/profile/me/job-recommendations/{jobId}/feedback") + public ApiResponse revokeFeedback(@PathVariable Long jobId,@RequestParam Long expectedVersion,HttpServletRequest request) { + service.revokeNotInterested(currentUserAccessor.requireUserId(),jobId,expectedVersion,AuditContext.from(request)); return ApiResponse.ok(null,requestIdAccessor.get(request)); + } + + @GetMapping("/companies/me/jobs/{jobId}/recommendation-profile") + public ApiResponse profile(@PathVariable Long jobId,HttpServletRequest request) { + return ApiResponse.ok(service.companyProfile(currentUserAccessor.requireUserId(),jobId),requestIdAccessor.get(request)); + } + + @PutMapping("/companies/me/jobs/{jobId}/recommendation-profile") + public ApiResponse updateProfile(@PathVariable Long jobId,@Valid @RequestBody RecommendationProfileRequest body,HttpServletRequest request) { + return ApiResponse.ok(service.upsertCompanyProfile(currentUserAccessor.requireUserId(),jobId,body,AuditContext.from(request)),requestIdAccessor.get(request)); + } + + @GetMapping("/admin/job-recommendation-profiles") + public ApiResponse> adminProfiles(@RequestParam(defaultValue="0") int page,@RequestParam(defaultValue="20") int size,@RequestParam(required=false) String status,HttpServletRequest request) { + Page result=service.adminProfiles(currentUserAccessor.requireUserId(),page,size,status); return ApiResponse.ok(PageResponse.of(result.getContent(),result.getTotalElements(),result.getNumber(),result.getSize()),requestIdAccessor.get(request)); + } + + @PostMapping("/admin/job-recommendation-profiles/{jobId}/decision") + public ApiResponse decide(@PathVariable Long jobId,@Valid @RequestBody RecommendationDecisionRequest body,HttpServletRequest request) { + return ApiResponse.ok(service.decide(currentUserAccessor.requireUserId(),jobId,body,AuditContext.from(request)),requestIdAccessor.get(request)); + } + +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfile.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfile.java new file mode 100644 index 0000000..5d8a05f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfile.java @@ -0,0 +1,40 @@ +package com.mydreamjob.recommendation; + +import jakarta.persistence.*; +import lombok.*; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "job_recommendation_profiles") +@EntityListeners(AuditingEntityListener.class) +public class JobRecommendationProfile { + public static final String PENDING_REVIEW = "PENDING_REVIEW"; + public static final String APPROVED = "APPROVED"; + public static final String REJECTED = "REJECTED"; + public static final String DISABLED = "DISABLED"; + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; + @Column(name = "job_id", nullable = false, unique = true) private Long jobId; + @Column(name = "industry_code", nullable = false, length = 64) private String industryCode; + @Column(name = "job_family_code", nullable = false, length = 64) private String jobFamilyCode; + @Column(name = "riasec_weights_json", columnDefinition = "TEXT") private String riasecWeightsJson; + @Column(name = "ability_expectations_json", columnDefinition = "TEXT") private String abilityExpectationsJson; + @JdbcTypeCode(SqlTypes.TINYINT) + @Column(nullable = false) @Builder.Default private Boolean enabled = true; + @Column(name = "review_status", nullable = false, length = 20) @Builder.Default private String reviewStatus = PENDING_REVIEW; + @Column(name = "review_reason", length = 40) private String reviewReason; + @Column(name = "reviewed_by_user_id") private Long reviewedByUserId; + @Column(name = "reviewed_at") private LocalDateTime reviewedAt; + @Version @Column(nullable = false) @Builder.Default private Long version = 0L; + @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; + @LastModifiedDate @Column(name = "updated_at", nullable = false) private LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfileRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfileRepository.java new file mode 100644 index 0000000..5f802e0 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationProfileRepository.java @@ -0,0 +1,10 @@ +package com.mydreamjob.recommendation; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; +import java.util.*; +public interface JobRecommendationProfileRepository extends JpaRepository { + Optional findByJobId(Long jobId); + Page findByReviewStatusOrderByUpdatedAtDesc(String reviewStatus, Pageable pageable); + List findByReviewStatusAndEnabledTrue(String reviewStatus); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationService.java new file mode 100644 index 0000000..13c4e98 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationService.java @@ -0,0 +1,214 @@ +package com.mydreamjob.recommendation; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +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.company.Company; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.job.JobService; +import com.mydreamjob.preference.StudentPreference; +import com.mydreamjob.preference.StudentPreferenceRepository; +import com.mydreamjob.recommendation.dto.*; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.data.domain.*; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.math.*; +import java.time.LocalDateTime; +import java.util.*; +import java.util.stream.Collectors; + +/** V39 规则型岗位推荐。只读取测评聚合结果，不读取题面、答案或候选评分快照。 */ +@Service +@RequiredArgsConstructor +public class JobRecommendationService { + private static final ObjectMapper JSON = new ObjectMapper(); + private static final Set RIASEC = Set.of("R","I","A","S","E","C"); + private static final Set ABILITY = Set.of("LOGIC","COMMUNICATION","EXECUTION","LEARNING"); + private static final Set FEEDBACK = Set.of("NOT_INTERESTED","REASON_HELPFUL","REASON_NOT_HELPFUL"); + private static final Set DECISIONS = Set.of("APPROVE", "REJECT"); + private static final Set REJECT_REASONS = Set.of("TAXONOMY_MISMATCH", "WEIGHT_INVALID", "CONTENT_INCOMPLETE", "OTHER"); + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final JobRecommendationTaxonomyRepository taxonomyRepository; + private final JobRecommendationProfileRepository profileRepository; + private final StudentJobRecommendationFeedbackRepository feedbackRepository; + private final JobRepository jobRepository; + private final JobService jobService; + private final CompanyService companyService; + private final UserRepository userRepository; + private final StudentPreferenceRepository preferenceRepository; + private final ApplicationRepository applicationRepository; + private final AuditService auditService; + private final JdbcTemplate jdbcTemplate; + @Value("${recommendation.assessment.enabled:false}") private boolean assessmentEnabled; + + @Transactional(readOnly = true) + public List taxonomies() { + return taxonomyRepository.findByEnabledTrueOrderBySortOrderAscCodeAsc().stream().map(t -> TaxonomyResponse.builder() + .code(t.getCode()).parentCode(t.getParentCode()).type(t.getTaxonomyType()).displayName(t.getDisplayName()).build()).toList(); + } + + @Transactional(readOnly = true) + public RecommendationProfileResponse companyProfile(Long userId, Long jobId) { + assertCompanyOwns(userId, jobId); + return profileRepository.findByJobId(jobId).map(this::profileView) + .orElseThrow(() -> new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_NOT_FOUND)); + } + + @Transactional + public RecommendationProfileResponse upsertCompanyProfile(Long userId, Long jobId, RecommendationProfileRequest req, AuditContext ctx) { + assertCompanyOwns(userId, jobId); + validateTaxonomy(req.getIndustryCode(), req.getJobFamilyCode()); + validateMaps(req.getRiasecWeights(), req.getAbilityExpectations()); + JobRecommendationProfile p = profileRepository.findByJobId(jobId).orElse(null); + if (p != null && !Objects.equals(p.getVersion(), req.getExpectedVersion())) { + throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_CONCURRENT_UPDATE); + } + if (p == null && req.getExpectedVersion() != 0L) throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_CONCURRENT_UPDATE); + if (p == null) p = JobRecommendationProfile.builder().jobId(jobId).build(); + p.setIndustryCode(req.getIndustryCode()); p.setJobFamilyCode(req.getJobFamilyCode()); + p.setRiasecWeightsJson(write(req.getRiasecWeights())); p.setAbilityExpectationsJson(write(req.getAbilityExpectations())); + p.setEnabled(req.getEnabled()); + if (Boolean.TRUE.equals(req.getEnabled())) { p.setReviewStatus(JobRecommendationProfile.PENDING_REVIEW); p.setReviewReason(null); p.setReviewedAt(null); p.setReviewedByUserId(null); } + else p.setReviewStatus(JobRecommendationProfile.DISABLED); + p = profileRepository.saveAndFlush(p); + auditService.log(userId, "JOB_RECOMMENDATION_PROFILE_UPDATED", "JOB_RECOMMENDATION_PROFILE", p.getId(), + "{\"jobId\":" + jobId + ",\"status\":\"" + p.getReviewStatus() + "\"}", ctx); + return profileView(p); + } + + @Transactional(readOnly = true) + public Page adminProfiles(Long adminId, int page, int size, String status) { + userRoleGuard.requireAdmin(adminId); validatePage(page, size); + Page result = status == null || status.isBlank() + ? profileRepository.findAll(PageRequest.of(page, size, Sort.by(Sort.Direction.DESC, "updatedAt"))) + : profileRepository.findByReviewStatusOrderByUpdatedAtDesc(status, PageRequest.of(page, size)); + return result.map(this::profileView); + } + + @Transactional + public RecommendationProfileResponse decide(Long adminId, Long jobId, RecommendationDecisionRequest req, AuditContext ctx) { + userRoleGuard.requireAdmin(adminId); + if (!DECISIONS.contains(req.getDecision()) || ("REJECT".equals(req.getDecision()) && !REJECT_REASONS.contains(req.getReasonCode()))) + throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID); + JobRecommendationProfile p = profileRepository.findByJobId(jobId) + .orElseThrow(() -> new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_NOT_FOUND)); + if (!Objects.equals(p.getVersion(), req.getExpectedVersion())) throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_CONCURRENT_UPDATE); + if (!JobRecommendationProfile.PENDING_REVIEW.equals(p.getReviewStatus())) throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID_REVIEW_STATE); + p.setReviewStatus("APPROVE".equals(req.getDecision()) ? JobRecommendationProfile.APPROVED : JobRecommendationProfile.REJECTED); + p.setReviewReason("REJECT".equals(req.getDecision()) ? req.getReasonCode() : null); + p.setReviewedByUserId(adminId); p.setReviewedAt(LocalDateTime.now()); p = profileRepository.saveAndFlush(p); + auditService.log(adminId, "JOB_RECOMMENDATION_PROFILE_REVIEWED", "JOB_RECOMMENDATION_PROFILE", p.getId(), + "{\"jobId\":" + jobId + ",\"status\":\"" + p.getReviewStatus() + "\"}", ctx); + return profileView(p); + } + + @Transactional + public RecommendationFeedbackResponse feedback(Long studentId, Long jobId, RecommendationFeedbackRequest req, AuditContext ctx) { + userRoleGuard.requireStudent(studentId); jobService.getPublicJob(jobId); + if (!FEEDBACK.contains(req.getFeedbackType()) || req.getIdempotencyKey().length() > 64) + throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID); + String key = studentId + ":" + jobId + ":" + req.getFeedbackType() + ":" + Optional.ofNullable(req.getReasonType()).orElse(""); + Optional replay = feedbackRepository.findByStudentUserIdAndIdempotencyKey(studentId, req.getIdempotencyKey()); + if (replay.isPresent()) { + StudentJobRecommendationFeedback old = replay.get(); + if (!Objects.equals(old.getFeedbackKey(), key)) throw new BusinessException(ErrorCode.RECOMMENDATION_FEEDBACK_IDEMPOTENCY_CONFLICT); + return feedbackView(old); + } + StudentJobRecommendationFeedback f = feedbackRepository.findByStudentUserIdAndFeedbackKey(studentId, key).orElse(null); + if (f == null) f = StudentJobRecommendationFeedback.builder().studentUserId(studentId).jobId(jobId).feedbackType(req.getFeedbackType()).reasonType(req.getReasonType()).feedbackKey(key).idempotencyKey(req.getIdempotencyKey()).build(); + else { f.setStatus(StudentJobRecommendationFeedback.ACTIVE); f.setIdempotencyKey(req.getIdempotencyKey()); } + try { f = feedbackRepository.saveAndFlush(f); } catch (DataIntegrityViolationException e) { throw new BusinessException(ErrorCode.RECOMMENDATION_FEEDBACK_CONCURRENT_UPDATE); } + auditService.log(studentId, "JOB_RECOMMENDATION_FEEDBACK_RECORDED", "JOB", jobId, + "{\"jobId\":" + jobId + ",\"status\":\"ACTIVE\"}", ctx); + return feedbackView(f); + } + + @Transactional + public void revokeNotInterested(Long studentId, Long jobId, Long expectedVersion, AuditContext ctx) { + userRoleGuard.requireStudent(studentId); + StudentJobRecommendationFeedback f = feedbackRepository.findByStudentUserIdAndJobIdAndFeedbackTypeAndStatus(studentId, jobId, "NOT_INTERESTED", StudentJobRecommendationFeedback.ACTIVE) + .orElseThrow(() -> new BusinessException(ErrorCode.RECOMMENDATION_FEEDBACK_NOT_FOUND)); + if (!Objects.equals(f.getVersion(), expectedVersion)) throw new BusinessException(ErrorCode.RECOMMENDATION_FEEDBACK_CONCURRENT_UPDATE); + f.setStatus(StudentJobRecommendationFeedback.REVOKED); feedbackRepository.saveAndFlush(f); + auditService.log(studentId, "JOB_RECOMMENDATION_NOT_INTERESTED_REVOKED", "JOB", jobId, "{\"jobId\":" + jobId + ",\"status\":\"REVOKED\"}", ctx); + } + + @Transactional(readOnly = true) + public Page recommend(Long studentId, int page, int size) { + userRoleGuard.requireStudent(studentId); validatePage(page, size); LocalDateTime now = LocalDateTime.now(); + Set applied = new HashSet<>(applicationRepository.findDistinctJobIdsByStudentUserId(studentId)); + Set hidden = feedbackRepository.findByStudentUserIdAndStatusAndFeedbackType(studentId, StudentJobRecommendationFeedback.ACTIVE, "NOT_INTERESTED") + .stream().map(StudentJobRecommendationFeedback::getJobId).collect(Collectors.toSet()); + StudentPreference pref = preferenceRepository.findByStudentUserId(studentId).orElse(null); + if (!assessmentEnabled) return fallback(page, size, applied, hidden, pref); + Map riasec = latestRiasec(studentId); + Map ability = latestAbility(studentId, now); + if (riasec.isEmpty() && ability.isEmpty() && pref == null) return fallback(page, size, applied, hidden, null); + List jobs = jobRepository.findAllById(profileRepository.findByReviewStatusAndEnabledTrue(JobRecommendationProfile.APPROVED).stream().map(JobRecommendationProfile::getJobId).toList()); + Map jobsById = jobs.stream().collect(Collectors.toMap(Job::getId, j -> j)); + List items = profileRepository.findByReviewStatusAndEnabledTrue(JobRecommendationProfile.APPROVED).stream() + .map(p -> scored(p, jobsById.get(p.getJobId()), pref, riasec, ability, applied, hidden)).filter(Objects::nonNull) + .sorted(Comparator.comparing(JobRecommendationItem::getScore).reversed().thenComparing(JobRecommendationItem::getJobId)).toList(); + return slice(items, page, size); + } + + private JobRecommendationItem scored(JobRecommendationProfile p, Job j, StudentPreference pref, Map riasec, Map ability, Set applied, Set hidden) { + if (j == null || !"PUBLISHED".equals(j.getStatus()) || applied.contains(j.getId()) || hidden.contains(j.getId()) || !hardPreferenceMatch(pref, j)) return null; + List components = new ArrayList<>(); List weights = new ArrayList<>(); List reasons = new ArrayList<>(); + BigDecimal preference = preferenceScore(pref, p, j); if (preference != null) { components.add(preference); weights.add(BigDecimal.valueOf(40)); reasons.add("岗位偏好匹配"); } + BigDecimal r = weighted(riasec, mapDecimal(p.getRiasecWeightsJson()), RIASEC); if (r != null) { components.add(r); weights.add(BigDecimal.valueOf(35)); reasons.add("职业兴趣匹配"); } + BigDecimal a = abilityScore(ability, mapDecimal(p.getAbilityExpectationsJson())); if (a != null) { components.add(a); weights.add(BigDecimal.valueOf(25)); reasons.add("能力要求匹配"); } + if (weights.isEmpty()) return null; + BigDecimal top = BigDecimal.ZERO, bottom = BigDecimal.ZERO; + for (int i=0;i fallback(int page,int size,Set applied,Set hidden,StudentPreference pref) { + List all = jobRepository.findByStatusOrderByCreatedAtDesc("PUBLISHED").stream().filter(j -> !applied.contains(j.getId()) && !hidden.contains(j.getId()) && hardPreferenceMatch(pref,j)).map(j -> JobRecommendationItem.builder().jobId(j.getId()).title(j.getTitle()).city(j.getCity()).employmentType(j.getEmploymentType()).salaryMin(j.getSalaryMin()).salaryMax(j.getSalaryMax()).mode("FALLBACK").reasons(List.of("最新公开岗位")).build()).toList(); + return slice(all,page,size); + } + private Page slice(List all,int page,int size) { int from=Math.min(page*size,all.size()), to=Math.min(from+size,all.size()); return new PageImpl<>(all.subList(from,to), PageRequest.of(page,size),all.size()); } + private boolean hardPreferenceMatch(StudentPreference p,Job j) { if(p==null)return true; List cities=list(p.getPreferredCities()); if(!cities.isEmpty()&&!cities.contains(j.getCity()))return false; return p.getExpectedSalaryMin()==null || j.getSalaryMax()==null || j.getSalaryMax()>=p.getExpectedSalaryMin(); } + private BigDecimal preferenceScore(StudentPreference preference, JobRecommendationProfile profile, Job job) { + if (preference == null) return null; + JobPreferenceScoreCalculator.Criteria criteria = new JobPreferenceScoreCalculator.Criteria( + list(preference.getPreferredCities()), + list(preference.getEmploymentTypes()), + preference.getExpectedSalaryMin(), + list(preference.getPreferredIndustries()), + list(preference.getPreferredJobTypes())); + JobPreferenceScoreCalculator.Target target = new JobPreferenceScoreCalculator.Target( + job.getCity(), job.getEmploymentType(), job.getSalaryMax(), + profile.getIndustryCode(), profile.getJobFamilyCode()); + return JobPreferenceScoreCalculator.calculate(criteria, target); + } + private BigDecimal weighted(Map scores,Map expected,Set allowed){if(scores.isEmpty()||expected.isEmpty())return null; BigDecimal n=BigDecimal.ZERO,d=BigDecimal.ZERO;for(var e:expected.entrySet())if(allowed.contains(e.getKey())&&scores.containsKey(e.getKey())&&e.getValue().signum()>0){n=n.add(scores.get(e.getKey()).multiply(e.getValue()));d=d.add(e.getValue());}return d.signum()==0?null:n.divide(d,2,RoundingMode.HALF_UP);} + private BigDecimal abilityScore(Map scores,Map expected){if(scores.isEmpty()||expected.isEmpty())return null;BigDecimal total=BigDecimal.ZERO;int n=0;for(var e:expected.entrySet())if(ABILITY.contains(e.getKey())&&scores.containsKey(e.getKey())&&e.getValue().compareTo(BigDecimal.ZERO)>0){total=total.add(scores.get(e.getKey()).min(e.getValue()).multiply(BigDecimal.valueOf(100)).divide(e.getValue(),2,RoundingMode.HALF_UP));n++;}return n==0?null:total.divide(BigDecimal.valueOf(n),2,RoundingMode.HALF_UP);} + private Map latestRiasec(Long student){return latest("SELECT r.dimension_scores_text FROM assessment_results r JOIN assessment_attempts a ON a.id=r.attempt_id JOIN assessment_definitions d ON d.id=a.definition_id WHERE a.student_user_id=? AND a.status='COMPLETED' AND d.type_code='HOLLAND_RIASEC' ORDER BY a.completed_at DESC,a.id DESC LIMIT 1",student,null,RIASEC);} + private Map latestAbility(Long student,LocalDateTime now){return latest("SELECT r.dimension_scores_json FROM ability_results r JOIN ability_attempts a ON a.id=r.attempt_id JOIN ability_definitions d ON d.id=a.definition_id WHERE a.student_user_id=? AND a.status='COMPLETED' AND d.type_code='WORKPLACE_ABILITY' AND r.valid_until>? ORDER BY a.completed_at DESC,a.id DESC LIMIT 1",student,now,ABILITY);} + private Map latest(String sql,Long student,LocalDateTime now,Set expected){List rows=now==null?jdbcTemplate.query(sql,(rs,n)->rs.getString(1),student):jdbcTemplate.query(sql,(rs,n)->rs.getString(1),student,now);return rows.isEmpty()?Map.of():scoreEntries(rows.get(0),expected);} + private Map scoreEntries(String raw,Set expected){try{List> a=JSON.readValue(raw,new TypeReference<>(){});Mapout=new HashMap<>();for(Map e:a){Object key=e.getOrDefault("code",e.get("dimension"));Object score=e.get("score");BigDecimal value=score==null?null:new BigDecimal(String.valueOf(score));if(!(key instanceof String)||value==null||value.compareTo(BigDecimal.ZERO)<0||value.compareTo(BigDecimal.valueOf(100))>0||out.put((String)key,value)!=null)return Map.of();}return out.keySet().equals(expected)?out:Map.of();}catch(Exception e){return Map.of();}} + private Map mapDecimal(String raw){try{if(raw==null)return Map.of();Mapm=JSON.readValue(raw,new TypeReference<>(){});Mapo=new HashMap<>();for(var e:m.entrySet())o.put(e.getKey(),new BigDecimal(String.valueOf(e.getValue())));return o;}catch(Exception e){return Map.of();}} + private List list(String raw){try{return raw==null?List.of():JSON.readValue(raw,new TypeReference>(){});}catch(Exception e){return List.of();}} + private String write(Object o){try{return o==null?null:JSON.writeValueAsString(o);}catch(Exception e){throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID);}} + private void validateTaxonomy(String industry,String family){JobRecommendationTaxonomy i=taxonomyRepository.findById(industry).orElseThrow(()->new BusinessException(ErrorCode.RECOMMENDATION_TAXONOMY_INVALID));JobRecommendationTaxonomy f=taxonomyRepository.findById(family).orElseThrow(()->new BusinessException(ErrorCode.RECOMMENDATION_TAXONOMY_INVALID));if(!Boolean.TRUE.equals(i.getEnabled())||!Boolean.TRUE.equals(f.getEnabled())||!"INDUSTRY".equals(i.getTaxonomyType())||!"JOB_FAMILY".equals(f.getTaxonomyType())||!industry.equals(f.getParentCode()))throw new BusinessException(ErrorCode.RECOMMENDATION_TAXONOMY_INVALID);} + private void validateMaps(Map r,Mapa){if((r==null||r.isEmpty())&&(a==null||a.isEmpty()))throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID);if(r!=null&&(!RIASEC.containsAll(r.keySet())||r.values().stream().anyMatch(v->v==null||v<0||v>100)))throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID);if(a!=null&&(!ABILITY.containsAll(a.keySet())||a.values().stream().anyMatch(v->v==null||v<1||v>100)))throw new BusinessException(ErrorCode.RECOMMENDATION_PROFILE_INVALID);} + private void assertCompanyOwns(Long user,Long job){Company c=companyService.findCompanyByOwnerUserId(user);if(c==null)throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND);jobService.assertOwnerOrThrow(c.getId(),job);} + private void validatePage(int p,int s){if(p<0||s<1||s>50)throw new BusinessException(ErrorCode.RECOMMENDATION_INVALID_QUERY);} + private RecommendationProfileResponse profileView(JobRecommendationProfile p){return RecommendationProfileResponse.builder().jobId(p.getJobId()).industryCode(p.getIndustryCode()).jobFamilyCode(p.getJobFamilyCode()).riasecWeights(mapInteger(p.getRiasecWeightsJson())).abilityExpectations(mapInteger(p.getAbilityExpectationsJson())).enabled(p.getEnabled()).reviewStatus(p.getReviewStatus()).reviewReason(p.getReviewReason()).version(p.getVersion()).updatedAt(p.getUpdatedAt()).build();} + private Map mapInteger(String raw){try{return raw==null?Map.of():JSON.readValue(raw,new TypeReference>(){});}catch(Exception e){return Map.of();}} + private RecommendationFeedbackResponse feedbackView(StudentJobRecommendationFeedback f){return RecommendationFeedbackResponse.builder().jobId(f.getJobId()).feedbackType(f.getFeedbackType()).reasonType(f.getReasonType()).status(f.getStatus()).version(f.getVersion()).build();} +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomy.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomy.java new file mode 100644 index 0000000..fb2af0d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomy.java @@ -0,0 +1,29 @@ +package com.mydreamjob.recommendation; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.Data; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; + +@Data +@Entity +@Table(name = "job_recommendation_taxonomies") +public class JobRecommendationTaxonomy { + @Id + @Column(length = 64) + private String code; + @Column(name = "parent_code", length = 64) + private String parentCode; + @Column(name = "taxonomy_type", nullable = false, length = 20) + private String taxonomyType; + @Column(name = "display_name", nullable = false, length = 80) + private String displayName; + @JdbcTypeCode(SqlTypes.TINYINT) + @Column(nullable = false) + private Boolean enabled; + @Column(name = "sort_order", nullable = false) + private Integer sortOrder; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomyRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomyRepository.java new file mode 100644 index 0000000..a70ea00 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/JobRecommendationTaxonomyRepository.java @@ -0,0 +1,6 @@ +package com.mydreamjob.recommendation; +import org.springframework.data.jpa.repository.JpaRepository; +import java.util.List; +public interface JobRecommendationTaxonomyRepository extends JpaRepository { + List findByEnabledTrueOrderBySortOrderAscCodeAsc(); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedback.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedback.java new file mode 100644 index 0000000..d3d5c24 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedback.java @@ -0,0 +1,31 @@ +package com.mydreamjob.recommendation; + +import jakarta.persistence.*; +import lombok.*; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "student_job_recommendation_feedback") +@EntityListeners(AuditingEntityListener.class) +public class StudentJobRecommendationFeedback { + public static final String ACTIVE = "ACTIVE"; + public static final String REVOKED = "REVOKED"; + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; + @Column(name = "student_user_id", nullable = false) private Long studentUserId; + @Column(name = "job_id", nullable = false) private Long jobId; + @Column(name = "feedback_type", nullable = false, length = 32) private String feedbackType; + @Column(name = "reason_type", length = 40) private String reasonType; + @Column(name = "feedback_key", nullable = false, unique = true, length = 220) private String feedbackKey; + @Column(name = "idempotency_key", nullable = false, length = 64) private String idempotencyKey; + @Column(nullable = false, length = 20) @Builder.Default private String status = ACTIVE; + @Version @Column(nullable = false) @Builder.Default private Long version = 0L; + @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; + @LastModifiedDate @Column(name = "updated_at", nullable = false) private LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedbackRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedbackRepository.java new file mode 100644 index 0000000..0c147eb --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/StudentJobRecommendationFeedbackRepository.java @@ -0,0 +1,9 @@ +package com.mydreamjob.recommendation; +import org.springframework.data.jpa.repository.JpaRepository; +import java.util.*; +public interface StudentJobRecommendationFeedbackRepository extends JpaRepository { + Optional findByStudentUserIdAndIdempotencyKey(Long userId, String idempotencyKey); + Optional findByStudentUserIdAndFeedbackKey(Long userId, String feedbackKey); + Optional findByStudentUserIdAndJobIdAndFeedbackTypeAndStatus(Long userId, Long jobId, String feedbackType, String status); + List findByStudentUserIdAndStatusAndFeedbackType(Long userId, String status, String feedbackType); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/JobRecommendationItem.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/JobRecommendationItem.java new file mode 100644 index 0000000..1b0131b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/JobRecommendationItem.java @@ -0,0 +1,6 @@ +package com.mydreamjob.recommendation.dto; +import lombok.Builder; import lombok.Value; import java.math.BigDecimal; import java.util.List; +@Value @Builder public class JobRecommendationItem { + Long jobId; String title; String city; String employmentType; Integer salaryMin; Integer salaryMax; + String mode; BigDecimal score; List reasons; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationDecisionRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationDecisionRequest.java new file mode 100644 index 0000000..93dc82e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationDecisionRequest.java @@ -0,0 +1,3 @@ +package com.mydreamjob.recommendation.dto; +import jakarta.validation.constraints.NotBlank; import jakarta.validation.constraints.NotNull; import lombok.Data; +@Data public class RecommendationDecisionRequest { @NotBlank private String decision; private String reasonCode; @NotNull private Long expectedVersion; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackRequest.java new file mode 100644 index 0000000..3ff3678 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackRequest.java @@ -0,0 +1,3 @@ +package com.mydreamjob.recommendation.dto; +import jakarta.validation.constraints.NotBlank; import jakarta.validation.constraints.NotNull; import lombok.Data; +@Data public class RecommendationFeedbackRequest { @NotBlank private String feedbackType; private String reasonType; @NotBlank private String idempotencyKey; @NotNull private Long expectedVersion; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackResponse.java new file mode 100644 index 0000000..d503f37 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationFeedbackResponse.java @@ -0,0 +1,3 @@ +package com.mydreamjob.recommendation.dto; +import lombok.Builder; import lombok.Value; +@Value @Builder public class RecommendationFeedbackResponse { Long jobId; String feedbackType; String reasonType; String status; Long version; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileRequest.java new file mode 100644 index 0000000..bdfb640 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileRequest.java @@ -0,0 +1,14 @@ +package com.mydreamjob.recommendation.dto; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import lombok.Data; +import java.util.Map; +@Data +public class RecommendationProfileRequest { + @NotBlank private String industryCode; + @NotBlank private String jobFamilyCode; + private Map riasecWeights; + private Map abilityExpectations; + @NotNull private Boolean enabled; + @NotNull private Long expectedVersion; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileResponse.java new file mode 100644 index 0000000..30cc9ba --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/RecommendationProfileResponse.java @@ -0,0 +1,7 @@ +package com.mydreamjob.recommendation.dto; +import lombok.Builder; import lombok.Value; import java.time.LocalDateTime; import java.util.Map; +@Value @Builder public class RecommendationProfileResponse { + Long jobId; String industryCode; String jobFamilyCode; Map riasecWeights; + Map abilityExpectations; Boolean enabled; String reviewStatus; String reviewReason; + Long version; LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/TaxonomyResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/TaxonomyResponse.java new file mode 100644 index 0000000..e05dc26 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/recommendation/dto/TaxonomyResponse.java @@ -0,0 +1,3 @@ +package com.mydreamjob.recommendation.dto; +import lombok.Builder; import lombok.Value; +@Value @Builder public class TaxonomyResponse { String code; String parentCode; String type; String displayName; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionController.java b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionController.java index b0f19f8..f6b93b5 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionController.java @@ -1,8 +1,9 @@ package com.mydreamjob.resume; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.profile.storage.ResumeFilenameSanitizer; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -11,8 +12,6 @@ import org.springframework.http.ContentDisposition; import org.springframework.http.HttpHeaders; import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; @@ -34,6 +33,8 @@ public class ResumeVersionController { private final ResumeVersionService resumeVersionService; private final ResumeExportService resumeExportService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "创建简历版本", description = "仅本人(STUDENT)；PDF/DOC/DOCX ≤10MB；可附版本名") @PostMapping(value = "/profile/me/resume-versions", consumes = MediaType.MULTIPART_FORM_DATA_VALUE) @@ -41,18 +42,18 @@ public class ResumeVersionController { @RequestParam("file") MultipartFile file, @RequestParam(value = "name", required = false) String name, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeVersion version = resumeVersionService.createVersion(userId, name, file); - return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), requestIdAccessor.get(request))); } @Operation(summary = "简历版本列表", description = "本人 ACTIVE 版本，version_no 倒序") @GetMapping("/profile/me/resume-versions") public ResponseEntity>>> list(HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); List> data = resumeVersionService.listVersions(userId) .stream().map(resumeVersionService::toView).collect(Collectors.toList()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "简历版本详情", description = "仅本人可查看；他人 403，不存在 404") @@ -60,9 +61,9 @@ public class ResumeVersionController { public ResponseEntity>> get( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeVersion version = resumeVersionService.getVersion(userId, id); - return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), requestIdAccessor.get(request))); } @Operation(summary = "修改简历版本", description = "本人；可选重命名 + 可选替换文件（替换时删除旧文件）") @@ -72,9 +73,9 @@ public class ResumeVersionController { @RequestParam(value = "file", required = false) MultipartFile file, @RequestParam(value = "name", required = false) String name, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeVersion version = resumeVersionService.updateVersion(userId, id, name, file); - return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), requestIdAccessor.get(request))); } @Operation(summary = "删除简历版本", description = "默认版本需先设其他默认；导出进行中不可删；删除文件并移除记录") @@ -82,10 +83,10 @@ public class ResumeVersionController { public ResponseEntity>> delete( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); resumeVersionService.deleteVersion(userId, id); return ResponseEntity.ok(ApiResponse.ok( - Map.of("message", "resume version deleted"), getRequestId(request))); + Map.of("message", "resume version deleted"), requestIdAccessor.get(request))); } @Operation(summary = "设为默认简历", description = "同用户最多一个默认；已默认幂等；并发冲突 409") @@ -93,9 +94,9 @@ public class ResumeVersionController { public ResponseEntity>> setDefault( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeVersion version = resumeVersionService.setDefault(userId, id); - return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeVersionService.toView(version), requestIdAccessor.get(request))); } @Operation(summary = "创建简历导出任务", description = "异步复制该版本文件到导出目录；返回任务状态") @@ -103,9 +104,9 @@ public class ResumeVersionController { public ResponseEntity>> createExportTask( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeExportTask task = resumeExportService.createExportTask(userId, id); - return ResponseEntity.ok(ApiResponse.ok(resumeExportService.toView(task), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeExportService.toView(task), requestIdAccessor.get(request))); } @Operation(summary = "导出任务状态", description = "仅本人可查询；SUCCESS 含输出文件，FAILED 含失败原因") @@ -113,9 +114,9 @@ public class ResumeVersionController { public ResponseEntity>> getExportTask( @PathVariable Long taskId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeExportTask task = resumeExportService.getExportTask(userId, taskId); - return ResponseEntity.ok(ApiResponse.ok(resumeExportService.toView(task), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(resumeExportService.toView(task), requestIdAccessor.get(request))); } @Operation(summary = "下载导出产物", description = "仅本人且任务 SUCCESS 可下载；attachment；不暴露内部路径") @@ -123,11 +124,11 @@ public class ResumeVersionController { public ResponseEntity downloadExportTask( @PathVariable Long taskId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ResumeExportService.DownloadFile df = resumeExportService.download(userId, taskId); MediaType mediaType = resolveContentType(df.getContentType()); ContentDisposition cd = ContentDisposition.attachment() - .filename(df.getFilename(), StandardCharsets.UTF_8) + .filename(ResumeFilenameSanitizer.forDownload(df.getFilename(), "resume"), StandardCharsets.UTF_8) .build(); return ResponseEntity.ok() .contentType(mediaType) @@ -135,17 +136,6 @@ public class ResumeVersionController { .body(df.getContent()); } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } - private MediaType resolveContentType(String contentType) { if (contentType == null) return MediaType.APPLICATION_OCTET_STREAM; try { diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionService.java b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionService.java index cfd599d..2ad1fbd 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionService.java @@ -2,7 +2,9 @@ package com.mydreamjob.resume; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import com.mydreamjob.profile.ProfileService; +import com.mydreamjob.profile.storage.ResumeFilenameSanitizer; import com.mydreamjob.profile.storage.ResumeStorageService; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; @@ -37,6 +39,8 @@ public class ResumeVersionService { private final ResumeStorageService resumeStorageService; private final ResumeVersionWriter versionWriter; private final ProfileService profileService; + /** R01-D4-1：简历版本创建/替换/删除后登记评分快照刷新（GROWTH 维度）。 */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; // ── 创建 ────────────────────────────────────────────────── @@ -60,8 +64,12 @@ public class ResumeVersionService { try { for (int attempt = 0; attempt < MAX_VERSION_NO_RETRY; attempt++) { try { - return versionWriter.saveNewVersion(userId, normalizeName(name), storagePath, - file.getOriginalFilename(), file.getContentType(), file.getSize()); + ResumeVersion saved = versionWriter.saveNewVersion(userId, normalizeName(name), storagePath, + ResumeFilenameSanitizer.forDownload(file.getOriginalFilename(), "resume"), + file.getContentType(), file.getSize()); + // R01-D4-2 F3：刷新登记已移入 ResumeVersionWriter 的同一 REQUIRES_NEW 事务， + // 保证"版本行与刷新任务同一提交边界"；此处不再重复登记（避免二次登记与外层事务耦合）。 + return saved; } catch (DataIntegrityViolationException e) { // uk_resume_versions_user_no 并发冲突 → 短退避后重试 log.info("Resume version_no conflict for user {}, retry {}/{}", userId, attempt + 1, MAX_VERSION_NO_RETRY); @@ -129,7 +137,7 @@ public class ResumeVersionService { // 1) 先保存新文件（绝不在保存前删除旧文件） newStoragePath = resumeStorageService.store(userId, file); version.setFileStoragePath(newStoragePath); - version.setFileName(file.getOriginalFilename()); + version.setFileName(ResumeFilenameSanitizer.forDownload(file.getOriginalFilename(), "resume")); version.setContentType(file.getContentType()); version.setFileSize(file.getSize()); // 2) 注册事务回调：提交后删旧文件；回滚时清理新文件 @@ -151,6 +159,8 @@ public class ResumeVersionService { // 非事务上下文（单元测试）：无 afterCommit 回调，立即执行旧文件清理 deleteOldFileIfUnreferenced(oldStoragePath); } + // R01-D4-1：简历替换/重命名影响 GROWTH 维度 → 登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(userId, java.time.LocalDateTime.now()); return version; } @@ -175,6 +185,8 @@ public class ResumeVersionService { } // 1) 先完成数据库删除 resumeVersionRepository.delete(version); + // R01-D4-1：简历版本数影响 GROWTH 维度 → 删除后登记当前周期刷新。 + scoringRefreshRequestService.requestRefresh(userId, java.time.LocalDateTime.now()); // 2) 事务提交后再删除存储文件（提交失败则文件保留） deleteFileAfterCommit(version.getFileStoragePath()); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionWriter.java b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionWriter.java index a63fdd6..751c391 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionWriter.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/resume/ResumeVersionWriter.java @@ -1,10 +1,13 @@ package com.mydreamjob.resume; +import com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Component; import org.springframework.transaction.annotation.Propagation; import org.springframework.transaction.annotation.Transactional; +import java.time.LocalDateTime; + /** * 简历版本写入工作单元：每个"计算版本号 + 插入"运行在独立事务（REQUIRES_NEW）。 * @@ -16,6 +19,14 @@ import org.springframework.transaction.annotation.Transactional; public class ResumeVersionWriter { private final ResumeVersionRepository resumeVersionRepository; + /** + * R01-D4-2 F3：刷新登记必须与版本行在同一提交边界。 + * + *

    版本行由本组件的 {@code REQUIRES_NEW} 事务独立提交（这是既有的并发冲突重试防护， + * 不能移除）。若登记留在外层事务，外层在提交阶段失败就会出现"版本行已落库、刷新信号 + * 丢失"。把登记放进本事务后，二者要么一起提交、要么一起回滚。

    + */ + private final CandidateScoringRefreshRequestService scoringRefreshRequestService; /** 计算用户下一个版本号（max+1）并插入；并发冲突抛 DataIntegrityViolationException */ @Transactional(propagation = Propagation.REQUIRES_NEW) @@ -34,6 +45,9 @@ public class ResumeVersionWriter { .defaultKey(null) .status(ResumeVersion.STATUS_ACTIVE) .build(); - return resumeVersionRepository.save(version); + ResumeVersion saved = resumeVersionRepository.save(version); + // R01-D4-2 F3：与版本行同事务登记（RESUME 版本数/最近更新影响 GROWTH 维度）。 + scoringRefreshRequestService.requestRefresh(userId, LocalDateTime.now()); + return saved; } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewController.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewController.java index 407a25c..b0cdeb9 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewController.java @@ -1,11 +1,9 @@ package com.mydreamjob.review; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.api.PageResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; -import com.mydreamjob.review.dto.AdminCompanyReviewReplyResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.review.dto.ReviewDecisionRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -14,9 +12,6 @@ import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.authentication.AnonymousAuthenticationToken; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.time.LocalDateTime; @@ -33,7 +28,8 @@ import java.util.Map; public class AdminReviewController { private final JobReviewService reviewService; - private final CompanyReviewReplyService replyService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "待审评价列表", description = "仅 ADMIN；分页 + jobId/riskLevel/createdFrom/createdTo 筛选；不返回明文 IP/UA") @GetMapping("/pending") @@ -47,10 +43,10 @@ public class AdminReviewController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page> result = reviewService.listPendingReviews( userId, jobId, riskLevel, createdFrom, createdTo, page, size); - return ResponseEntity.ok(ApiResponse.ok(toPage(result), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(toPage(result), requestIdAccessor.get(request))); } @Operation(summary = "评价审核决策", description = "仅 ADMIN；仅 PENDING 可审，重复提交 409；决策写入历史与 audit_logs") @@ -59,11 +55,11 @@ public class AdminReviewController { @PathVariable Long reviewId, @Valid @RequestBody ReviewDecisionRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = reviewService.decideReview( userId, reviewId, req.getDecision(), req.getReason(), com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "审核历史", description = "仅 ADMIN；分页返回审核结果、审核人、时间与原因") @@ -72,9 +68,9 @@ public class AdminReviewController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page> result = reviewService.listModerationHistory(userId, page, size); - return ResponseEntity.ok(ApiResponse.ok(toPage(result), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(toPage(result), requestIdAccessor.get(request))); } private Map toPage(Page> result) { @@ -87,47 +83,4 @@ public class AdminReviewController { return data; } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated() || auth instanceof AnonymousAuthenticationToken) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } - - @Operation(summary = "待审企业回复列表", description = "仅 ADMIN；分页 + 企业/岗位/回复状态/创建时间范围筛选；moderationStatus 缺省为 PENDING") - @GetMapping("/replies/pending") - public ResponseEntity>> pendingReplies( - @RequestParam(required = false) Long companyId, - @RequestParam(required = false) Long jobId, - @RequestParam(required = false) String moderationStatus, - @RequestParam(required = false) - @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) LocalDateTime createdFrom, - @RequestParam(required = false) - @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) LocalDateTime createdTo, - @RequestParam(defaultValue = "0") int page, - @RequestParam(defaultValue = "20") int size, - HttpServletRequest request) { - Long userId = resolveUserId(request); - Page result = replyService.listAdminReplies( - userId, companyId, jobId, moderationStatus, createdFrom, createdTo, page, size); - return ResponseEntity.ok(ApiResponse.ok(PageResponse.of( - result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), - getRequestId(request))); - } - - @Operation(summary = "企业回复审核决策", description = "仅 ADMIN；仅 PENDING 可审，重复提交 409") - @PostMapping("/replies/{replyId}/decision") - public ResponseEntity> decideReply( - @PathVariable Long replyId, - @Valid @RequestBody ReviewDecisionRequest req, - HttpServletRequest request) { - Long userId = resolveUserId(request); - com.mydreamjob.review.dto.CompanyReviewReplyResponse response = replyService.moderateReply( - userId, replyId, req.getDecision(), req.getReason()); - return ResponseEntity.ok(ApiResponse.ok(response, getRequestId(request))); - } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyController.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyController.java new file mode 100644 index 0000000..7ef8a63 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyController.java @@ -0,0 +1,63 @@ +package com.mydreamjob.review; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.review.dto.AdminReviewReplyPageResponse; +import com.mydreamjob.review.dto.AdminReviewReplyResponse; +import com.mydreamjob.review.dto.ReviewReplyDecisionRequest; +import com.mydreamjob.security.CurrentUserAccessor; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.format.annotation.DateTimeFormat; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.time.LocalDateTime; + +@Tag(name = "官方回复审核", description = "管理员审核企业官方回复") +@RestController +@RequiredArgsConstructor +public class AdminReviewReplyController { + + private final AdminReviewReplyService adminService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; + + @Operation(summary = "待审官方回复", description = "仅 ADMIN；分页查看风险回复") + @GetMapping("/admin/review-replies/pending") + public ResponseEntity> pending( + @RequestParam(required = false) Long companyId, + @RequestParam(required = false) Long jobId, + @RequestParam(required = false) String riskLevel, + @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) + LocalDateTime createdFrom, + @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) + LocalDateTime createdTo, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(adminService.listPending(userId, companyId, jobId, riskLevel, + createdFrom, createdTo, page, size), requestIdAccessor.get(request))); + } + + @Operation(summary = "官方回复审核决策", description = "仅 ADMIN；PENDING 回复可 APPROVE 或 REJECT") + @PostMapping("/admin/review-replies/{replyId}/decision") + public ResponseEntity> decide( + @PathVariable Long replyId, + @Valid @RequestBody ReviewReplyDecisionRequest requestBody, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(adminService.decide(userId, replyId, requestBody, + AuditContext.from(request)), requestIdAccessor.get(request))); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyService.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyService.java new file mode 100644 index 0000000..56e9b0e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/AdminReviewReplyService.java @@ -0,0 +1,204 @@ +package com.mydreamjob.review; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +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.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.review.dto.AdminReviewReplyPageResponse; +import com.mydreamjob.review.dto.AdminReviewReplyResponse; +import com.mydreamjob.review.dto.ReviewReplyDecisionRequest; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.io.IOException; +import java.time.LocalDateTime; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.function.Function; +import java.util.stream.Collectors; + +/** 管理员官方回复审核服务；条件更新保证并发决策只产生一个胜者。 */ +@Service +@RequiredArgsConstructor +public class AdminReviewReplyService { + + private static final int MAX_PAGE_SIZE = 50; + private static final int MAX_REQUEST_ID_LENGTH = 32; + + private final UserRepository userRepository; + private final CompanyReviewReplyRepository replyRepository; + private final CompanyReviewReplyHistoryRepository historyRepository; + private final JobReviewRepository reviewRepository; + private final JobRepository jobRepository; + private final CompanyRepository companyRepository; + private final AuditService auditService; + private final ObjectMapper objectMapper; + + @Transactional(readOnly = true) + public AdminReviewReplyPageResponse listPending(Long adminUserId, Long companyId, Long jobId, + String riskLevel, LocalDateTime createdFrom, + LocalDateTime createdTo, int page, int size) { + assertAdmin(adminUserId); + validatePage(page, size); + if (createdFrom != null && createdTo != null && createdFrom.isAfter(createdTo)) + throw new BusinessException(ErrorCode.BAD_REQUEST); + Page replies = replyRepository.findPending( + companyId, jobId, riskLevel, createdFrom, createdTo, PageRequest.of(page, size)); + List reviewIds = replies.getContent().stream().map(CompanyReviewReply::getReviewId).toList(); + Map reviews = reviewIds.isEmpty() ? Map.of() : reviewRepository.findAllById(reviewIds).stream() + .collect(Collectors.toMap(JobReview::getId, Function.identity(), (a, b) -> a)); + Set jobIds = reviews.values().stream().map(JobReview::getJobId) + .filter(java.util.Objects::nonNull).collect(Collectors.toSet()); + Map jobs = jobIds.isEmpty() ? Map.of() : jobRepository.findAllById(jobIds).stream() + .collect(Collectors.toMap(Job::getId, Function.identity(), (a, b) -> a)); + Set companyIds = jobs.values().stream().map(Job::getCompanyId) + .filter(java.util.Objects::nonNull).collect(Collectors.toSet()); + Map companies = companyIds.isEmpty() ? Map.of() : companyRepository.findAllById(companyIds).stream() + .collect(Collectors.toMap(Company::getId, Function.identity(), (a, b) -> a)); + List items = replies.getContent().stream() + .map(reply -> toAdminResponse(reply, reviews, jobs, companies)).toList(); + return AdminReviewReplyPageResponse.builder() + .items(items).total(replies.getTotalElements()).page(replies.getNumber()) + .size(replies.getSize()).totalPages(replies.getTotalPages()).build(); + } + + @Transactional + public AdminReviewReplyResponse decide(Long adminUserId, Long replyId, + ReviewReplyDecisionRequest request, + AuditContext context) { + assertAdmin(adminUserId); + if (request == null || request.getDecision() == null) + throw new BusinessException(ErrorCode.REVIEW_REPLY_DECISION_INVALID); + String decision = request.getDecision().trim().toUpperCase(); + if (!"APPROVE".equals(decision) && !"REJECT".equals(decision)) + throw new BusinessException(ErrorCode.REVIEW_REPLY_DECISION_INVALID); + String reason = request.getReason() == null ? null : request.getReason().trim(); + if ("REJECT".equals(decision) && (reason == null || reason.isEmpty())) + throw new BusinessException(ErrorCode.REVIEW_REPLY_DECISION_INVALID); + + CompanyReviewReply current = replyRepository.findById(replyId) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + JobReview review = reviewRepository.findById(current.getReviewId()).orElse(null); + if (!CompanyReviewReply.PENDING.equals(current.getModerationStatus())) + throw new BusinessException(ErrorCode.REVIEW_REPLY_INVALID_STATE); + + String finalStatus = "APPROVE".equals(decision) + ? CompanyReviewReply.APPROVED : CompanyReviewReply.REJECTED; + int updated = replyRepository.decidePending(replyId, current.getVersion(), finalStatus, + adminUserId, LocalDateTime.now()); + if (updated != 1) { + CompanyReviewReply latest = replyRepository.findById(replyId).orElse(null); + if (latest == null) throw new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND); + if (!CompanyReviewReply.PENDING.equals(latest.getModerationStatus())) + throw new BusinessException(ErrorCode.REVIEW_REPLY_INVALID_STATE); + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONCURRENT_UPDATE); + } + + CompanyReviewReply saved = replyRepository.findById(replyId) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + String historyAction = "APPROVE".equals(decision) + ? CompanyReviewReplyHistory.APPROVED : CompanyReviewReplyHistory.REJECTED; + historyRepository.save(CompanyReviewReplyHistory.builder() + .replyId(replyId).action(historyAction).actorUserId(adminUserId) + .reasonCodes(saved.getModerationReason()).humanReason(reason).build()); + auditService.log(adminUserId, + "APPROVE".equals(decision) ? "REVIEW_REPLY_APPROVED" : "REVIEW_REPLY_REJECTED", + "COMPANY_REVIEW_REPLY", replyId, + auditDetails(saved, review, context), requestOnlyContext(context)); + return toAdminResponse(saved); + } + + private void assertAdmin(Long userId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); + if (user.getRoles() == null || user.getRoles().stream().noneMatch(r -> r == User.Role.ADMIN)) + throw new BusinessException(ErrorCode.FORBIDDEN); + } + + private void validatePage(int page, int size) { + if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + + private AdminReviewReplyResponse toAdminResponse(CompanyReviewReply reply) { + JobReview review = reviewRepository.findById(reply.getReviewId()).orElse(null); + Job job = review == null ? null : jobRepository.findById(review.getJobId()).orElse(null); + Company company = job == null ? null : companyRepository.findById(job.getCompanyId()).orElse(null); + return toAdminResponse(reply, + review == null ? Map.of() : Map.of(review.getId(), review), + job == null ? Map.of() : Map.of(job.getId(), job), + company == null ? Map.of() : Map.of(company.getId(), company)); + } + + private AdminReviewReplyResponse toAdminResponse(CompanyReviewReply reply, + Map reviews, + Map jobs, + Map companies) { + JobReview review = reviews.get(reply.getReviewId()); + Job job = review == null ? null : jobs.get(review.getJobId()); + Company company = job == null ? null : companies.get(job.getCompanyId()); + return AdminReviewReplyResponse.builder() + .replyId(reply.getId()) + .reviewId(reply.getReviewId()) + .jobId(job == null ? null : job.getId()) + .jobTitle(job == null ? null : job.getTitle()) + .companyId(company == null ? reply.getCompanyId() : company.getId()) + .companyName(company == null ? null : company.getName()) + .rating(review == null ? null : review.getRating()) + .reviewContent(review == null ? null : review.getContent()) + .reviewModerationStatus(review == null ? null : review.getModerationStatus()) + .replyContent(reply.getContent()) + .replyStatus(reply.getModerationStatus()) + .version(reply.getVersion()) + .riskScore(reply.getModerationScore()) + .riskLevel(reply.getRiskLevel()) + .reasonCodes(parseReasonCodes(reply.getModerationReason())) + .createdAt(reply.getCreatedAt()) + .build(); + } + + private List parseReasonCodes(String json) { + if (json == null || json.isBlank()) return List.of(); + try { + return objectMapper.readValue(json, new TypeReference>() {}); + } catch (IOException e) { + return List.of(); + } + } + + private String auditDetails(CompanyReviewReply reply, JobReview review, AuditContext context) { + Map details = new HashMap<>(); + details.put("reviewId", reply.getReviewId()); + details.put("replyId", reply.getId()); + details.put("jobId", review == null ? null : review.getJobId()); + details.put("status", reply.getModerationStatus()); + details.put("requestId", context == null ? null : context.getRequestId()); + try { + return objectMapper.writeValueAsString(details); + } catch (Exception e) { + return "{\"reviewId\":" + reply.getReviewId() + ",\"replyId\":" + reply.getId() + + ",\"status\":\"" + reply.getModerationStatus() + "\"}"; + } + } + + private AuditContext requestOnlyContext(AuditContext context) { + if (context == null) return null; + String requestId = context.getRequestId(); + if (requestId != null && requestId.length() > MAX_REQUEST_ID_LENGTH) + requestId = requestId.substring(0, MAX_REQUEST_ID_LENGTH); + return AuditContext.builder().requestId(requestId).build(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementController.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementController.java new file mode 100644 index 0000000..70b47d4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementController.java @@ -0,0 +1,87 @@ +package com.mydreamjob.review; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.review.dto.CompanyReviewDetailResponse; +import com.mydreamjob.review.dto.CompanyReviewReplyResponse; +import com.mydreamjob.review.dto.CreateCompanyReviewReplyRequest; +import com.mydreamjob.review.dto.ReviewReplyPageResponse; +import com.mydreamjob.review.dto.UpdateCompanyReviewReplyRequest; +import com.mydreamjob.security.CurrentUserAccessor; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.format.annotation.DateTimeFormat; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.time.LocalDateTime; + +@Tag(name = "企业评价管理", description = "企业查看自有岗位评价并提交官方回复") +@RestController +@RequiredArgsConstructor +public class CompanyReviewManagementController { + + private final CompanyReviewManagementService managementService; + private final CompanyReviewReplyService replyService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; + + @Operation(summary = "企业评价列表", description = "仅岗位所属 COMPANY；分页查看本企业岗位评价与回复状态") + @GetMapping("/companies/me/job-reviews") + public ResponseEntity> list( + @RequestParam(required = false) Long jobId, + @RequestParam(required = false) Integer rating, + @RequestParam(required = false) String reviewModerationStatus, + @RequestParam(required = false) String replyStatus, + @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) + LocalDateTime createdFrom, + @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) + LocalDateTime createdTo, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(managementService.listMine(userId, jobId, rating, + reviewModerationStatus, replyStatus, createdFrom, createdTo, page, size), requestIdAccessor.get(request))); + } + + @Operation(summary = "企业评价详情", description = "仅岗位所属 COMPANY；不返回评价作者身份") + @GetMapping("/companies/me/job-reviews/{reviewId}") + public ResponseEntity> detail( + @PathVariable Long reviewId, HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(managementService.getMine(userId, reviewId), requestIdAccessor.get(request))); + } + + @Operation(summary = "创建官方回复", description = "仅岗位所属 COMPANY；安全文本自动公开，风险文本进入管理员审核") + @PostMapping("/companies/me/job-reviews/{reviewId}/reply") + public ResponseEntity> createReply( + @PathVariable Long reviewId, + @Valid @RequestBody CreateCompanyReviewReplyRequest requestBody, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(replyService.create(userId, reviewId, requestBody, + AuditContext.from(request)), requestIdAccessor.get(request))); + } + + @Operation(summary = "修订被驳回回复", description = "仅 REJECTED 回复可修订；使用 expectedVersion 防并发覆盖") + @PutMapping("/companies/me/job-reviews/{reviewId}/reply") + public ResponseEntity> reviseReply( + @PathVariable Long reviewId, + @Valid @RequestBody UpdateCompanyReviewReplyRequest requestBody, + HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(replyService.revise(userId, reviewId, requestBody, + AuditContext.from(request)), requestIdAccessor.get(request))); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementService.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementService.java new file mode 100644 index 0000000..839e590 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewManagementService.java @@ -0,0 +1,196 @@ +package com.mydreamjob.review; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.review.dto.CompanyReviewDetailResponse; +import com.mydreamjob.review.dto.CompanyReviewItemResponse; +import com.mydreamjob.review.dto.CompanyReviewJobResponse; +import com.mydreamjob.review.dto.CompanyReviewReplyResponse; +import com.mydreamjob.review.dto.ReviewReplyPageResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.io.IOException; +import java.time.LocalDateTime; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.function.Function; +import java.util.stream.Collectors; + +/** 企业评价管理只读投影；所有查询均限定在当前企业拥有的岗位。 */ +@Service +@RequiredArgsConstructor +public class CompanyReviewManagementService { + + private static final int MAX_PAGE_SIZE = 50; + private static final Set REVIEW_STATUSES = Set.of( + JobReview.MODERATION_AUTO_APPROVED, JobReview.MODERATION_PENDING, + JobReview.MODERATION_APPROVED, JobReview.MODERATION_REJECTED); + private static final Set REPLY_STATUSES = Set.of( + "NONE", CompanyReviewReply.AUTO_APPROVED, CompanyReviewReply.PENDING, + CompanyReviewReply.APPROVED, CompanyReviewReply.REJECTED); + + private final CompanyService companyService; + private final JobReviewRepository reviewRepository; + private final JobRepository jobRepository; + private final JobReviewDimensionScoreRepository dimensionScoreRepository; + private final CompanyReviewReplyRepository replyRepository; + private final CompanyReviewReplyHistoryRepository historyRepository; + private final ObjectMapper objectMapper; + + @Transactional(readOnly = true) + public ReviewReplyPageResponse listMine(Long userId, Long jobId, Integer rating, + String reviewModerationStatus, String replyStatus, + LocalDateTime createdFrom, LocalDateTime createdTo, + int page, int size) { + Company company = requireCompany(userId); + validatePage(page, size); + validateFilters(rating, reviewModerationStatus, replyStatus, createdFrom, createdTo); + + Page reviewPage = reviewRepository.findCompanyReviews( + company.getId(), jobId, rating, reviewModerationStatus, replyStatus, + createdFrom, createdTo, PageRequest.of(page, size)); + List reviewIds = reviewPage.getContent().stream().map(JobReview::getId).toList(); + Map jobs = loadJobs(reviewPage.getContent()); + Map> dimensions = loadDimensions(reviewIds); + Map replies = loadReplies(reviewIds); + Map rejectionReasons = loadRejectionReasons(replies.values()); + + List items = reviewPage.getContent().stream() + .map(r -> toItem(r, jobs.get(r.getJobId()), dimensions.getOrDefault(r.getId(), Map.of()), + replies.get(r.getId()), rejectionReasons.get(r.getId()))) + .toList(); + return ReviewReplyPageResponse.builder() + .items(items).total(reviewPage.getTotalElements()).page(reviewPage.getNumber()) + .size(reviewPage.getSize()).totalPages(reviewPage.getTotalPages()).build(); + } + + @Transactional(readOnly = true) + public CompanyReviewDetailResponse getMine(Long userId, Long reviewId) { + Company company = requireCompany(userId); + JobReview review = reviewRepository.findById(reviewId) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + Job job = jobRepository.findById(review.getJobId()) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + assertOwnership(company, job); + CompanyReviewReply reply = replyRepository.findByReviewId(reviewId).orElse(null); + String rejectionReason = reply == null ? null : loadRejectionReasons(List.of(reply)).get(reply.getId()); + CompanyReviewItemResponse item = toItem(review, job, + loadDimensions(List.of(reviewId)).getOrDefault(reviewId, Map.of()), reply, rejectionReason); + CompanyReviewDetailResponse detail = new CompanyReviewDetailResponse(); + detail.setReviewId(item.getReviewId()); + detail.setJob(item.getJob()); + detail.setRating(item.getRating()); + detail.setContent(item.getContent()); + detail.setTags(item.getTags()); + detail.setDimensionScores(item.getDimensionScores()); + detail.setReviewStatus(item.getReviewStatus()); + detail.setReviewCreatedAt(item.getReviewCreatedAt()); + detail.setReply(item.getReply()); + return detail; + } + + private Company requireCompany(Long userId) { + Company company = companyService.findCompanyByOwnerUserId(userId); + if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); + return company; + } + + private void assertOwnership(Company company, Job job) { + if (job == null || !company.getId().equals(job.getCompanyId())) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + } + + private void validatePage(int page, int size) { + if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + + private void validateFilters(Integer rating, String reviewStatus, String replyStatus, + LocalDateTime from, LocalDateTime to) { + if (rating != null && (rating < 1 || rating > 5)) + throw new BusinessException(ErrorCode.BAD_REQUEST); + if (reviewStatus != null && !REVIEW_STATUSES.contains(reviewStatus)) + throw new BusinessException(ErrorCode.BAD_REQUEST); + if (replyStatus != null && !REPLY_STATUSES.contains(replyStatus)) + throw new BusinessException(ErrorCode.BAD_REQUEST); + if (from != null && to != null && from.isAfter(to)) + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + + private Map loadJobs(List reviews) { + Set ids = reviews.stream().map(JobReview::getJobId).collect(Collectors.toSet()); + if (ids.isEmpty()) return Map.of(); + return jobRepository.findAllById(ids).stream() + .collect(Collectors.toMap(Job::getId, Function.identity())); + } + + private Map> loadDimensions(List reviewIds) { + if (reviewIds.isEmpty()) return Map.of(); + Map> result = new HashMap<>(); + dimensionScoreRepository.findByReviewIdIn(reviewIds).forEach(d -> + result.computeIfAbsent(d.getReviewId(), ignored -> new HashMap<>()) + .put(d.getDimensionCode(), d.getScore())); + return result; + } + + private Map loadReplies(List reviewIds) { + if (reviewIds.isEmpty()) return Map.of(); + return replyRepository.findByReviewIdIn(reviewIds).stream() + .collect(Collectors.toMap(CompanyReviewReply::getReviewId, Function.identity())); + } + + private Map loadRejectionReasons(java.util.Collection replies) { + List ids = replies.stream().map(CompanyReviewReply::getId).filter(java.util.Objects::nonNull).toList(); + if (ids.isEmpty()) return Map.of(); + Map result = new HashMap<>(); + historyRepository.findByReplyIdIn(ids).stream() + .filter(h -> CompanyReviewReplyHistory.REJECTED.equals(h.getAction())) + .sorted((a, b) -> b.getCreatedAt().compareTo(a.getCreatedAt())) + .forEach(h -> result.putIfAbsent(h.getReplyId(), h.getHumanReason())); + return result; + } + + private CompanyReviewItemResponse toItem(JobReview review, Job job, + Map dimensions, + CompanyReviewReply reply, String rejectionReason) { + return CompanyReviewItemResponse.builder() + .reviewId(review.getId()) + .job(job == null ? null : new CompanyReviewJobResponse(job.getId(), job.getTitle())) + .rating(review.getRating()) + .content(review.getContent()) + .tags(parseTags(review.getTags())) + .dimensionScores(dimensions) + .reviewStatus(review.getModerationStatus()) + .reviewCreatedAt(review.getCreatedAt()) + .reply(reply == null ? null : CompanyReviewReplyResponse.builder() + .id(reply.getId()).content(reply.getContent()).status(reply.getModerationStatus()) + .version(reply.getVersion()).updatedAt(reply.getUpdatedAt()) + .rejectionReason(CompanyReviewReply.REJECTED.equals(reply.getModerationStatus()) + ? rejectionReason : null) + .build()) + .build(); + } + + private List parseTags(String json) { + if (json == null || json.isBlank()) return List.of(); + try { + return objectMapper.readValue(json, new TypeReference>() {}); + } catch (IOException e) { + return List.of(); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReply.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReply.java index 1df7a1a..d4bbc94 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReply.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReply.java @@ -1,6 +1,14 @@ package com.mydreamjob.review; -import jakarta.persistence.*; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import jakarta.persistence.Version; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; @@ -9,18 +17,29 @@ import org.springframework.data.annotation.CreatedDate; import org.springframework.data.annotation.LastModifiedDate; import org.springframework.data.jpa.domain.support.AuditingEntityListener; +import java.math.BigDecimal; import java.time.LocalDateTime; +/** 企业对岗位评价的当前官方回复；正文在 AUTO_APPROVED/APPROVED 后不可覆盖。 */ @Data @Builder @NoArgsConstructor @AllArgsConstructor @Entity @Table(name = "company_review_replies", - uniqueConstraints = @UniqueConstraint(columnNames = "review_id")) + uniqueConstraints = { + @UniqueConstraint(name = "uk_company_review_replies_review", columnNames = "review_id"), + @UniqueConstraint(name = "uk_company_review_replies_idempotency", + columnNames = {"company_id", "idempotency_key"}) + }) @EntityListeners(AuditingEntityListener.class) public class CompanyReviewReply { + public static final String AUTO_APPROVED = "AUTO_APPROVED"; + public static final String PENDING = "PENDING"; + public static final String APPROVED = "APPROVED"; + public static final String REJECTED = "REJECTED"; + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @@ -28,27 +47,38 @@ public class CompanyReviewReply { @Column(name = "review_id", nullable = false) private Long reviewId; - @Column(name = "company_user_id", nullable = false) - private Long companyUserId; + @Column(name = "company_id", nullable = false) + private Long companyId; - @Column(nullable = false, columnDefinition = "text") + @Column(nullable = false, length = 500) private String content; - // ── 审核状态 ────────────────────────────────────────────── - - public static final String MODERATION_PENDING = "PENDING"; - public static final String MODERATION_APPROVED = "APPROVED"; - public static final String MODERATION_REJECTED = "REJECTED"; + @Column(name = "idempotency_key", nullable = false, length = 64) + private String idempotencyKey; @Column(name = "moderation_status", nullable = false, length = 20) @Builder.Default - private String moderationStatus = MODERATION_PENDING; + private String moderationStatus = PENDING; @Column(name = "moderation_reason", length = 500) private String moderationReason; - @Column(name = "moderation_updated_at") - private LocalDateTime moderationUpdatedAt; + @Column(name = "moderation_score", precision = 5, scale = 2) + private BigDecimal moderationScore; + + @Column(name = "risk_level", length = 20) + private String riskLevel; + + @Column(name = "reviewed_by_user_id") + private Long reviewedByUserId; + + @Column(name = "reviewed_at") + private LocalDateTime reviewedAt; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistory.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistory.java new file mode 100644 index 0000000..ad8d7bf --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistory.java @@ -0,0 +1,59 @@ +package com.mydreamjob.review; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.PrePersist; +import jakarta.persistence.Table; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +/** 官方回复生命周期历史；不保存正文副本。 */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "company_review_reply_history") +public class CompanyReviewReplyHistory { + + public static final String CREATED = "CREATED"; + public static final String AUTO_APPROVED = "AUTO_APPROVED"; + public static final String PENDING = "PENDING"; + public static final String RESUBMITTED = "RESUBMITTED"; + public static final String APPROVED = "APPROVED"; + public static final String REJECTED = "REJECTED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "reply_id", nullable = false) + private Long replyId; + + @Column(nullable = false, length = 30) + private String action; + + @Column(name = "actor_user_id") + private Long actorUserId; + + @Column(name = "reason_codes", length = 500) + private String reasonCodes; + + @Column(name = "human_reason", length = 500) + private String humanReason; + + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @PrePersist + void prePersist() { + if (createdAt == null) createdAt = LocalDateTime.now(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistoryRepository.java new file mode 100644 index 0000000..403b4c6 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyHistoryRepository.java @@ -0,0 +1,19 @@ +package com.mydreamjob.review; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.Collection; +import java.util.List; +import java.util.Optional; + +@Repository +public interface CompanyReviewReplyHistoryRepository extends JpaRepository { + + List findByReplyIdIn(Collection replyIds); + + List findByReplyIdOrderByCreatedAtDesc(Long replyId); + + Optional findTopByReplyIdAndActionOrderByCreatedAtDesc( + Long replyId, String action); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyRepository.java index 595bf95..7f16b51 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyRepository.java @@ -3,9 +3,11 @@ package com.mydreamjob.review; import org.springframework.data.domain.Page; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Modifying; import org.springframework.data.jpa.repository.Query; import org.springframework.data.repository.query.Param; import org.springframework.stereotype.Repository; +import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; import java.util.Collection; @@ -17,44 +19,46 @@ public interface CompanyReviewReplyRepository extends JpaRepository findByReviewId(Long reviewId); - boolean existsByReviewId(Long reviewId); - - List findByReviewIdInAndModerationStatus(List reviewIds, String status); - - List findByReviewIdIn(List reviewIds); - - Optional findByReviewIdAndModerationStatus(Long reviewId, String moderationStatus); - - /** 管理端企业回复列表：可 companyId/jobId/moderationStatus/时间范围 筛选，分页 */ - @Query("SELECT r FROM CompanyReviewReply r" - + " JOIN JobReview rv ON rv.id = r.reviewId" - + " WHERE (:companyId IS NULL OR rv.jobId IN" - + " (SELECT j.id FROM Job j WHERE j.companyId = :companyId))" - + " AND (:jobId IS NULL OR rv.jobId = :jobId)" - + " AND (:moderationStatus IS NULL OR r.moderationStatus = :moderationStatus)" - + " AND (:createdFrom IS NULL OR r.createdAt >= :createdFrom)" - + " AND (:createdTo IS NULL OR r.createdAt <= :createdTo)") - Page findAdminReplies(@Param("companyId") Long companyId, - @Param("jobId") Long jobId, - @Param("moderationStatus") String moderationStatus, - @Param("createdFrom") LocalDateTime createdFrom, - @Param("createdTo") LocalDateTime createdTo, - Pageable pageable); - - /** 按月统计同一行业下各企业评价总数与已回复数；industry 为 null 时不限行业 */ - @Query("SELECT j.companyId AS companyId, COUNT(r) AS totalCnt, " - + " COUNT(CASE WHEN rr.id IS NOT NULL THEN 1 END) AS repliedCnt " - + " FROM JobReview r " - + " JOIN Job j ON j.id = r.jobId " - + " LEFT JOIN CompanyReviewReply rr ON rr.reviewId = r.id " - + " WHERE (:industry IS NULL OR" - + " j.companyId IN (SELECT cc.id FROM Company cc WHERE cc.industry = :industry))" - + " AND r.status = 'PUBLISHED'" - + " AND r.moderationStatus IN :moderationStatuses" - + " AND r.createdAt >= :start AND r.createdAt < :end" - + " GROUP BY j.companyId") - List findMonthlyReplyStats(@Param("industry") String industry, - @Param("moderationStatuses") Collection moderationStatuses, - @Param("start") LocalDateTime start, - @Param("end") LocalDateTime end); + Optional findByCompanyIdAndIdempotencyKey(Long companyId, String idempotencyKey); + + List findByReviewIdIn(Collection reviewIds); + + @Query(value = "SELECT rr.* FROM company_review_replies rr " + + "JOIN job_reviews r ON r.id = rr.review_id " + + "JOIN jobs j ON j.id = r.job_id " + + "WHERE rr.moderation_status = 'PENDING' " + + "AND (:companyId IS NULL OR rr.company_id = :companyId) " + + "AND (:jobId IS NULL OR r.job_id = :jobId) " + + "AND (:riskLevel IS NULL OR rr.risk_level = :riskLevel) " + + "AND (:createdFrom IS NULL OR rr.created_at >= :createdFrom) " + + "AND (:createdTo IS NULL OR rr.created_at <= :createdTo) " + + "ORDER BY rr.created_at ASC", + countQuery = "SELECT COUNT(*) FROM company_review_replies rr " + + "JOIN job_reviews r ON r.id = rr.review_id " + + "JOIN jobs j ON j.id = r.job_id " + + "WHERE rr.moderation_status = 'PENDING' " + + "AND (:companyId IS NULL OR rr.company_id = :companyId) " + + "AND (:jobId IS NULL OR r.job_id = :jobId) " + + "AND (:riskLevel IS NULL OR rr.risk_level = :riskLevel) " + + "AND (:createdFrom IS NULL OR rr.created_at >= :createdFrom) " + + "AND (:createdTo IS NULL OR rr.created_at <= :createdTo)", + nativeQuery = true) + Page findPending(@Param("companyId") Long companyId, + @Param("jobId") Long jobId, + @Param("riskLevel") String riskLevel, + @Param("createdFrom") LocalDateTime createdFrom, + @Param("createdTo") LocalDateTime createdTo, + Pageable pageable); + + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Transactional + @Query("UPDATE CompanyReviewReply r SET r.moderationStatus = :status, " + + "r.reviewedByUserId = :reviewedBy, r.reviewedAt = :reviewedAt, " + + "r.version = r.version + 1 " + + "WHERE r.id = :id AND r.version = :version AND r.moderationStatus = 'PENDING'") + int decidePending(@Param("id") Long id, + @Param("version") Long version, + @Param("status") String status, + @Param("reviewedBy") Long reviewedBy, + @Param("reviewedAt") LocalDateTime reviewedAt); } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyService.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyService.java index 94a94d3..8441801 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyService.java @@ -1,378 +1,237 @@ package com.mydreamjob.review; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; -import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.company.CompanyService; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobRepository; -import com.mydreamjob.job.JobService; -import com.mydreamjob.auth.User; -import com.mydreamjob.auth.UserRepository; -import com.mydreamjob.review.dto.AdminCompanyReviewReplyResponse; -import com.mydreamjob.review.dto.CompanyReviewReplyCreateRequest; import com.mydreamjob.review.dto.CompanyReviewReplyResponse; -import com.mydreamjob.review.dto.CompanyReviewReplyUpdateRequest; -import com.mydreamjob.review.dto.ReviewReplyStatsResponse; +import com.mydreamjob.review.dto.CreateCompanyReviewReplyRequest; +import com.mydreamjob.review.dto.UpdateCompanyReviewReplyRequest; import lombok.RequiredArgsConstructor; -import lombok.extern.slf4j.Slf4j; -import org.springframework.data.domain.Page; -import org.springframework.data.domain.PageRequest; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.orm.ObjectOptimisticLockingFailureException; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; -import java.time.LocalDate; -import java.util.HashMap; +import java.util.LinkedHashMap; import java.util.List; import java.util.Map; -import java.util.Set; -import java.util.stream.Collectors; +import java.util.UUID; -@Slf4j +/** 企业官方回复写服务：归属、状态机、幂等、预审和白名单审计。 */ @Service @RequiredArgsConstructor public class CompanyReviewReplyService { - private static final int MAX_PAGE_SIZE = 100; - private static final Set ALLOWED_REPLY_STATUSES = - Set.of(CompanyReviewReply.MODERATION_PENDING, - CompanyReviewReply.MODERATION_APPROVED, - CompanyReviewReply.MODERATION_REJECTED); + private static final int MAX_REQUEST_ID_LENGTH = 32; - private final CompanyReviewReplyRepository replyRepository; + private final CompanyService companyService; private final JobReviewRepository reviewRepository; private final JobRepository jobRepository; - private final CompanyRepository companyRepository; - private final UserRepository userRepository; - private final JobService jobService; - - // ── 企业归属校验 ────────────────────────────────────────── - - /** - * 校验当前用户是否是该评价所属岗位的企业 - */ - private void assertCompanyOwner(Long userId, JobReview review) { - Job job = jobService.getJob(review.getJobId()); - Company company = companyRepository.findByOwnerUserId(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.FORBIDDEN)); - if (!company.getId().equals(job.getCompanyId())) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } - } - - // ── 创建回复 ────────────────────────────────────────────── + private final CompanyReviewReplyRepository replyRepository; + private final CompanyReviewReplyWriter replyWriter; + private final CompanyReviewReplyHistoryRepository historyRepository; + private final ReviewModerationService moderationService; + private final AuditService auditService; + private final ObjectMapper objectMapper; @Transactional - public CompanyReviewReplyResponse createReply(Long userId, Long reviewId, - CompanyReviewReplyCreateRequest req) { - // 1. 校验评价存在 - JobReview review = reviewRepository.findById(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_NOT_FOUND)); - - // 2. 校验评价已公开（只有审核通过的评价才能被回复） - if (!JobReview.MODERATION_AUTO_APPROVED.equals(review.getModerationStatus()) - && !JobReview.MODERATION_APPROVED.equals(review.getModerationStatus())) { - throw new BusinessException(ErrorCode.REVIEW_NOT_FOUND); + public CompanyReviewReplyResponse create(Long userId, Long reviewId, + CreateCompanyReviewReplyRequest request, + AuditContext context) { + Company company = requireCompany(userId); + String content = normalizeContent(request == null ? null : request.getContent()); + String idempotencyKey = normalizeIdempotencyKey(request == null ? null : request.getIdempotencyKey()); + JobReview review = findOwnedReview(company, reviewId); + + CompanyReviewReply byKey = replyRepository.findByCompanyIdAndIdempotencyKey(company.getId(), idempotencyKey) + .orElse(null); + if (byKey != null) { + if (byKey.getReviewId().equals(reviewId) && content.equals(byKey.getContent())) { + return toResponse(byKey, null); + } + throw new BusinessException(ErrorCode.REVIEW_REPLY_IDEMPOTENCY_CONFLICT); } - // 3. 校验企业归属 - assertCompanyOwner(userId, review); - - // 4. 校验是否已回复（一条评价只能回复一次） - if (replyRepository.existsByReviewId(reviewId)) { - throw new BusinessException(ErrorCode.DUPLICATE_REPLY); + CompanyReviewReply existing = replyRepository.findByReviewId(reviewId).orElse(null); + if (existing != null) { + if (CompanyReviewReply.REJECTED.equals(existing.getModerationStatus())) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_INVALID_STATE); + } + throw new BusinessException(ErrorCode.REVIEW_REPLY_ALREADY_EXISTS); } - // 5. 创建回复（默认 PENDING 状态，需人工审核） + ReviewModerationService.ModerationResult moderation = moderationService.moderateCompanyReply(content); CompanyReviewReply reply = CompanyReviewReply.builder() .reviewId(reviewId) - .companyUserId(userId) - .content(req.getContent()) - .moderationStatus(CompanyReviewReply.MODERATION_PENDING) + .companyId(company.getId()) + .content(content) + .idempotencyKey(idempotencyKey) + .moderationStatus(moderation.getStatus()) + .moderationReason(toJson(moderation.getReasonCodes())) + .moderationScore(moderation.getScore()) + .riskLevel(moderation.getRiskLevel()) .build(); - - reply = replyRepository.save(reply); - log.info("企业回复创建成功：replyId={}, reviewId={}, companyId={}", - reply.getId(), reviewId, userId); - - return toResponse(reply); - } - - // ── 查询回复 ────────────────────────────────────────────── - - /** - * 查询单条回复（公开接口） - * 鉴权感知：回复所属企业可以看到自己回复的任何状态（审核中/已批准/被驳回）； - * 匿名用户与其他用户仅能看到已审核通过(APPROVED)的回复。 - */ - public CompanyReviewReplyResponse getReply(Long userId, Long reviewId) { - CompanyReviewReply reply = replyRepository.findByReviewId(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REPLY_NOT_FOUND)); - - // 本人（回复所属企业）可看到任意状态 - boolean isOwner = userId != null && userId.equals(reply.getCompanyUserId()); - - // 非本人：只有审核通过的回复才对外展示，否则视为未找到 - if (!isOwner && !CompanyReviewReply.MODERATION_APPROVED.equals(reply.getModerationStatus())) { - throw new BusinessException(ErrorCode.REPLY_NOT_FOUND); - } - - return toResponse(reply); - } - - /** - * 批量查询回复（用于评价列表接口，仅返回审核通过的） - */ - public Map batchGetApprovedReplies(List reviewIds) { - if (reviewIds == null || reviewIds.isEmpty()) { - return Map.of(); - } - - List replies = replyRepository - .findByReviewIdInAndModerationStatus(reviewIds, CompanyReviewReply.MODERATION_APPROVED); - - Map result = new HashMap<>(); - for (CompanyReviewReply reply : replies) { - result.put(reply.getReviewId(), toResponse(reply)); - } - return result; - } - - // ── 回复率统计（企业侧） ────────────────────────────────── - - /** - * 企业回复率统计：本月回复率 / 行业平均回复率（逐企业平均）/ 本月待回复条数。 - * 仅统计本月、属于本公司岗位、可回复的公开评价（AUTO_APPROVED/APPROVED）； - * 评价存在任意回复记录即视为已回复。 - */ - @Transactional(readOnly = true) - public ReviewReplyStatsResponse getReviewReplyStats(Long userId) { - Company company = companyRepository.findByOwnerUserId(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.FORBIDDEN)); - LocalDateTime start = LocalDate.now().withDayOfMonth(1).atStartOfDay(); - LocalDateTime end = start.plusMonths(1); - String industry = company.getIndustry(); - boolean hasIndustry = industry != null && !industry.isBlank(); - List rows = replyRepository.findMonthlyReplyStats( - hasIndustry ? industry : null, - List.of(JobReview.MODERATION_AUTO_APPROVED, JobReview.MODERATION_APPROVED), - start, end); - long myTotal = 0, myReplied = 0; - double rateSum = 0; - long rateCount = 0; - for (Object[] row : rows) { - long cid = ((Number) row[0]).longValue(); - long total = ((Number) row[1]).longValue(); - long replied = ((Number) row[2]).longValue(); - if (cid == company.getId()) { - myTotal = total; - myReplied = replied; + try { + // 让唯一键冲突只回滚独立写事务，避免并发失败污染当前事务。 + reply = replyWriter == null + ? replyRepository.saveAndFlush(reply) // 兼容纯单元测试直接注入 service 的场景 + : replyWriter.saveAndFlush(reply); + } catch (DataIntegrityViolationException ex) { + // 唯一约束是并发最终防线；优先返回可确定的业务冲突，不把它泄露为 500。 + CompanyReviewReply concurrent = replyRepository.findByCompanyIdAndIdempotencyKey( + company.getId(), idempotencyKey).orElse(null); + if (concurrent != null && concurrent.getReviewId().equals(reviewId) + && content.equals(concurrent.getContent())) { + return toResponse(concurrent, null); } - if (total > 0) { - rateSum += (double) replied / total; - rateCount++; + if (concurrent != null) throw new BusinessException(ErrorCode.REVIEW_REPLY_IDEMPOTENCY_CONFLICT); + if (replyRepository.findByReviewId(reviewId).isPresent()) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_ALREADY_EXISTS); } + throw new BusinessException(ErrorCode.REVIEW_REPLY_ALREADY_EXISTS); } - int monthRate = myTotal == 0 ? 0 : (int) Math.round(myReplied * 100.0 / myTotal); - int unreplied = (int) (myTotal - myReplied); - int industryAvg = (!hasIndustry || rateCount == 0) - ? 0 : (int) Math.round(rateSum / rateCount * 100.0); - return ReviewReplyStatsResponse.builder() - .monthReplyRate(monthRate) - .industryAvgReplyRate(industryAvg) - .unrepliedCount(unreplied) - .build(); - } - - // ── 更新回复（企业侧） ────────────────────────────────────── - - @Transactional - public CompanyReviewReplyResponse updateReply(Long userId, Long reviewId, - CompanyReviewReplyUpdateRequest req) { - // 1. 查找回复 - CompanyReviewReply reply = replyRepository.findByReviewId(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REPLY_NOT_FOUND)); - - // 2. 校验企业归属 - JobReview review = reviewRepository.findById(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_NOT_FOUND)); - assertCompanyOwner(userId, review); - // 3. 更新内容（审核状态重置为 PENDING，需重新审核） - if (req.getContent() != null && !req.getContent().isBlank()) { - reply.setContent(req.getContent()); - reply.setModerationStatus(CompanyReviewReply.MODERATION_PENDING); - reply.setModerationUpdatedAt(null); + saveHistory(reply.getId(), CompanyReviewReplyHistory.CREATED, userId, + moderation.getReasonCodes(), null); + String statusAction = CompanyReviewReply.AUTO_APPROVED.equals(reply.getModerationStatus()) + ? CompanyReviewReplyHistory.AUTO_APPROVED : CompanyReviewReplyHistory.PENDING; + saveHistory(reply.getId(), statusAction, null, moderation.getReasonCodes(), null); + audit(userId, "COMPANY_REVIEW_REPLY_CREATED", reply, review, context); + if (CompanyReviewReply.AUTO_APPROVED.equals(reply.getModerationStatus())) { + audit(userId, "REVIEW_REPLY_AUTO_APPROVED", reply, review, context); } - - reply = replyRepository.save(reply); - log.info("企业回复更新：replyId={}, reviewId={}", reply.getId(), reviewId); - - return toResponse(reply); - } - - // ── 删除回复（企业侧） ────────────────────────────────────── - - @Transactional - public void deleteReply(Long userId, Long reviewId) { - // 1. 查找回复 - CompanyReviewReply reply = replyRepository.findByReviewId(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REPLY_NOT_FOUND)); - - // 2. 校验企业归属 - JobReview review = reviewRepository.findById(reviewId) - .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_NOT_FOUND)); - assertCompanyOwner(userId, review); - - // 3. 删除 - replyRepository.delete(reply); - log.info("企业回复删除：replyId={}, reviewId={}", reply.getId(), reviewId); + return toResponse(reply, null); } - // ── 管理员审核 ────────────────────────────────────────────── - @Transactional - public CompanyReviewReplyResponse moderateReply(Long adminUserId, Long replyId, - String decision, String reason) { - // 0. 仅 ADMIN 可审核 - assertAdminRole(adminUserId); - // 1. 查找回复 - CompanyReviewReply reply = replyRepository.findById(replyId) - .orElseThrow(() -> new BusinessException(ErrorCode.REPLY_NOT_FOUND)); + public CompanyReviewReplyResponse revise(Long userId, Long reviewId, + UpdateCompanyReviewReplyRequest request, + AuditContext context) { + Company company = requireCompany(userId); + JobReview review = findOwnedReview(company, reviewId); + String content = normalizeContent(request == null ? null : request.getContent()); + Long expectedVersion = request == null ? null : request.getExpectedVersion(); + if (expectedVersion == null) throw new BusinessException(ErrorCode.REVIEW_REPLY_CONCURRENT_UPDATE); - // 2. 只有 PENDING 状态可审核 - if (!CompanyReviewReply.MODERATION_PENDING.equals(reply.getModerationStatus())) { - throw new BusinessException(ErrorCode.REPLY_ALREADY_DECIDED); + CompanyReviewReply reply = replyRepository.findByReviewId(reviewId) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + if (!CompanyReviewReply.REJECTED.equals(reply.getModerationStatus())) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_INVALID_STATE); } - - // 3. 更新审核状态 - boolean approved = CompanyReviewReply.MODERATION_APPROVED.equals(decision); - String finalStatus = approved ? CompanyReviewReply.MODERATION_APPROVED - : CompanyReviewReply.MODERATION_REJECTED; - reply.setModerationStatus(finalStatus); - reply.setModerationReason(reason); - reply.setModerationUpdatedAt(LocalDateTime.now()); - - reply = replyRepository.save(reply); - log.info("企业回复审核：replyId={}, decision={}, adminId={}", - replyId, finalStatus, adminUserId); - - return toResponse(reply); - } - - // ── 管理端回复列表（仅 ADMIN） ───────────────────────────── - // 关键关系：company_review_replies(reviewId) → job_reviews(jobId) → jobs(companyId) → companies - - /** - * 管理端企业回复列表（仅 ADMIN），支持 企业/岗位/回复状态/创建时间范围 筛选 + 分页。 - * moderationStatus 缺省视为 PENDING（待审）。 - */ - @Transactional(readOnly = true) - public Page listAdminReplies( - Long adminUserId, Long companyId, Long jobId, String moderationStatus, - LocalDateTime createdFrom, LocalDateTime createdTo, int page, int size) { - assertAdminRole(adminUserId); - assertValidPage(page, size); - String status = moderationStatus == null || moderationStatus.isBlank() - ? CompanyReviewReply.MODERATION_PENDING : moderationStatus; - assertValidReplyStatus(status); - - return toAdminPage(replyRepository.findAdminReplies( - companyId, jobId, status, createdFrom, createdTo, PageRequest.of(page, size))); - } - - private Page toAdminPage(Page replies) { - if (replies.isEmpty()) { - return replies.map(this::toAdminView); + if (!expectedVersion.equals(reply.getVersion())) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONCURRENT_UPDATE); } - // 批量取评价、岗位、企业，避免 N+1 - Set reviewIds = replies.stream() - .map(CompanyReviewReply::getReviewId).collect(Collectors.toSet()); - Map reviewMap = reviewRepository.findAllById(reviewIds).stream() - .collect(Collectors.toMap(JobReview::getId, r -> r)); - - Set jobIds = reviewMap.values().stream() - .map(JobReview::getJobId).collect(Collectors.toSet()); - Map jobMap = jobRepository.findAllById(jobIds).stream() - .collect(Collectors.toMap(Job::getId, j -> j)); - - Set companyIds = jobMap.values().stream() - .map(Job::getCompanyId).collect(Collectors.toSet()); - Map companyMap = companyRepository.findAllById(companyIds).stream() - .collect(Collectors.toMap(Company::getId, c -> c)); + ReviewModerationService.ModerationResult moderation = moderationService.moderateCompanyReply(content); + reply.setContent(content); + reply.setModerationStatus(moderation.getStatus()); + reply.setModerationReason(toJson(moderation.getReasonCodes())); + reply.setModerationScore(moderation.getScore()); + reply.setRiskLevel(moderation.getRiskLevel()); + reply.setReviewedByUserId(null); + reply.setReviewedAt(null); + try { + reply = replyRepository.saveAndFlush(reply); + } catch (ObjectOptimisticLockingFailureException ex) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONCURRENT_UPDATE); + } - return replies.map(r -> toAdminView(r, reviewMap, jobMap, companyMap)); + saveHistory(reply.getId(), CompanyReviewReplyHistory.RESUBMITTED, userId, + moderation.getReasonCodes(), null); + String statusAction = CompanyReviewReply.AUTO_APPROVED.equals(reply.getModerationStatus()) + ? CompanyReviewReplyHistory.AUTO_APPROVED : CompanyReviewReplyHistory.PENDING; + saveHistory(reply.getId(), statusAction, null, moderation.getReasonCodes(), null); + audit(userId, "COMPANY_REVIEW_REPLY_RESUBMITTED", reply, review, context); + if (CompanyReviewReply.AUTO_APPROVED.equals(reply.getModerationStatus())) { + audit(userId, "REVIEW_REPLY_AUTO_APPROVED", reply, review, context); + } + return toResponse(reply, null); } - private AdminCompanyReviewReplyResponse toAdminView(CompanyReviewReply reply) { - // 空页边界：仅组装回复自身 - return toAdminView(reply, Map.of(), Map.of(), Map.of()); + private Company requireCompany(Long userId) { + Company company = companyService.findCompanyByOwnerUserId(userId); + if (company == null) throw new BusinessException(ErrorCode.COMPANY_NOT_FOUND); + return company; } - private AdminCompanyReviewReplyResponse toAdminView(CompanyReviewReply reply, - Map reviewMap, - Map jobMap, - Map companyMap) { - AdminCompanyReviewReplyResponse.AdminCompanyReviewReplyResponseBuilder builder = - AdminCompanyReviewReplyResponse.builder() - .id(reply.getId()) - .reviewId(reply.getReviewId()) - .companyUserId(reply.getCompanyUserId()) - .content(reply.getContent()) - .moderationStatus(reply.getModerationStatus()) - .moderationReason(reply.getModerationReason()) - .createdAt(reply.getCreatedAt()) - .updatedAt(reply.getUpdatedAt()) - .moderationUpdatedAt(reply.getModerationUpdatedAt()); - - JobReview review = reviewMap.get(reply.getReviewId()); - if (review != null) { - builder.reviewRating(review.getRating()) - .reviewContent(review.getContent()) - .studentUserId(review.getStudentUserId()); - Job job = jobMap.get(review.getJobId()); - if (job != null) { - builder.jobId(job.getId()).jobTitle(job.getTitle()).companyId(job.getCompanyId()); - Company company = companyMap.get(job.getCompanyId()); - if (company != null) { - builder.companyName(company.getName()); - } - } + private JobReview findOwnedReview(Company company, Long reviewId) { + if (reviewId == null) throw new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND); + JobReview review = reviewRepository.findById(reviewId) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + Job job = jobRepository.findById(review.getJobId()) + .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_REPLY_NOT_FOUND)); + if (!company.getId().equals(job.getCompanyId())) throw new BusinessException(ErrorCode.FORBIDDEN); + return review; + } + + private String normalizeContent(String value) { + if (value == null) throw new BusinessException(ErrorCode.REVIEW_REPLY_CONTENT_INVALID); + String normalized = value.trim(); + if (normalized.isEmpty() || normalized.length() > 500) + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONTENT_INVALID); + return normalized; + } + + private String normalizeIdempotencyKey(String value) { + if (value == null || value.isBlank() || value.length() > 64) + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONTENT_INVALID); + String normalized = value.trim(); + try { + UUID.fromString(normalized); + } catch (IllegalArgumentException ex) { + throw new BusinessException(ErrorCode.REVIEW_REPLY_CONTENT_INVALID); } - return builder.build(); + return normalized; } - private void assertAdminRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isAdmin = user.getRoles() != null - && user.getRoles().stream().anyMatch(r -> r == User.Role.ADMIN); - if (!isAdmin) throw new BusinessException(ErrorCode.FORBIDDEN); + private void saveHistory(Long replyId, String action, Long actorUserId, + List reasonCodes, String humanReason) { + historyRepository.save(CompanyReviewReplyHistory.builder() + .replyId(replyId).action(action).actorUserId(actorUserId) + .reasonCodes(toJson(reasonCodes)).humanReason(humanReason).build()); } - private void assertValidPage(int page, int size) { - if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) - throw new BusinessException(ErrorCode.BAD_REQUEST); + private CompanyReviewReplyResponse toResponse(CompanyReviewReply reply, String rejectionReason) { + return CompanyReviewReplyResponse.builder() + .id(reply.getId()).content(reply.getContent()).status(reply.getModerationStatus()) + .version(reply.getVersion()).updatedAt(reply.getUpdatedAt()) + .rejectionReason(rejectionReason).build(); } - private void assertValidReplyStatus(String status) { - if (!ALLOWED_REPLY_STATUSES.contains(status)) - throw new BusinessException(ErrorCode.BAD_REQUEST); + private String toJson(Object value) { + if (value == null) return null; + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new IllegalStateException("failed to serialize review reply metadata", e); + } } - // ── 视图转换 ────────────────────────────────────────────── - - private CompanyReviewReplyResponse toResponse(CompanyReviewReply reply) { - return CompanyReviewReplyResponse.builder() - .id(reply.getId()) - .reviewId(reply.getReviewId()) - .content(reply.getContent()) - .moderationStatus(reply.getModerationStatus()) - .moderationReason(reply.getModerationReason()) - .createdAt(reply.getCreatedAt()) - .updatedAt(reply.getUpdatedAt()) - .build(); + private void audit(Long userId, String action, CompanyReviewReply reply, + JobReview review, AuditContext context) { + Map details = new LinkedHashMap<>(); + details.put("reviewId", reply.getReviewId()); + details.put("replyId", reply.getId()); + details.put("jobId", review == null ? null : review.getJobId()); + details.put("status", reply.getModerationStatus()); + details.put("requestId", context == null ? null : context.getRequestId()); + auditService.log(userId, action, "COMPANY_REVIEW_REPLY", reply.getId(), toJson(details), + requestOnlyContext(context)); + } + + private AuditContext requestOnlyContext(AuditContext context) { + if (context == null) return null; + String requestId = context.getRequestId(); + if (requestId != null && requestId.length() > MAX_REQUEST_ID_LENGTH) + requestId = requestId.substring(0, MAX_REQUEST_ID_LENGTH); + return AuditContext.builder().requestId(requestId).build(); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyWriter.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyWriter.java new file mode 100644 index 0000000..70a48b4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/CompanyReviewReplyWriter.java @@ -0,0 +1,24 @@ +package com.mydreamjob.review; + +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +/** + * 回复创建的独立落库事务。 + * + * 唯一键冲突是并发创建的正常业务分支；将 flush 隔离到新事务，避免 + * 数据库约束异常把外层查询、幂等判定和审计事务标记为 rollback-only。 + */ +@Service +@RequiredArgsConstructor +public class CompanyReviewReplyWriter { + + private final CompanyReviewReplyRepository replyRepository; + + @Transactional(propagation = Propagation.REQUIRES_NEW) + public CompanyReviewReply saveAndFlush(CompanyReviewReply reply) { + return replyRepository.saveAndFlush(reply); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewController.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewController.java index 3c319fc..23bbf6b 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewController.java @@ -3,8 +3,10 @@ package com.mydreamjob.review; import com.mydreamjob.common.api.ApiResponse; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.review.dto.JobReviewCreateRequest; import com.mydreamjob.review.dto.JobReviewUpdateRequest; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.servlet.http.HttpServletRequest; @@ -13,8 +15,6 @@ import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.time.LocalDateTime; @@ -29,6 +29,8 @@ import java.util.Map; public class JobReviewController { private final JobReviewService reviewService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; @Operation(summary = "创建岗位评价", description = "仅 STUDENT；同一学生对同一岗位只能评价一次") @PostMapping("/jobs/{jobId}/reviews") @@ -36,10 +38,10 @@ public class JobReviewController { @PathVariable Long jobId, @Valid @RequestBody JobReviewCreateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = reviewService.createReview(userId, jobId, req, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "查询岗位评价列表", description = "公开访问；仅返回 PUBLISHED 评价，分页；每条含八维评分；支持评分档/时间区间/未回复筛选") @@ -63,7 +65,7 @@ public class JobReviewController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "岗位评价详情", description = "公开访问；返回单条 PUBLISHED 评价与八维评分") @@ -73,7 +75,7 @@ public class JobReviewController { @PathVariable Long reviewId, HttpServletRequest request) { Map view = reviewService.getReview(jobId, reviewId); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "评分汇总", description = "公开访问；统计 PUBLISHED 评价的平均分、分布和热门标签") @@ -82,7 +84,7 @@ public class JobReviewController { @PathVariable Long jobId, HttpServletRequest request) { Map data = reviewService.getReviewSummary(jobId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "岗位对比", description = "公开访问；ids 为 2-3 个公开岗位；返回公开岗位字段与公开评分") @@ -92,7 +94,7 @@ public class JobReviewController { HttpServletRequest request) { List jobIds = parseIds(ids); List> data = reviewService.compareJobs(jobIds); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } private List parseIds(String ids) { @@ -117,10 +119,10 @@ public class JobReviewController { @PathVariable Long reviewId, @Valid @RequestBody JobReviewUpdateRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Map view = reviewService.updateReview(userId, jobId, reviewId, req, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(view, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(view, requestIdAccessor.get(request))); } @Operation(summary = "删除评价", description = "仅评价本人可以删除") @@ -129,21 +131,8 @@ public class JobReviewController { @PathVariable Long jobId, @PathVariable Long reviewId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); reviewService.deleteReview(userId, jobId, reviewId, com.mydreamjob.audit.AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "review deleted"), getRequestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new com.mydreamjob.common.exception.BusinessException( - com.mydreamjob.common.exception.ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); + return ResponseEntity.ok(ApiResponse.ok(Map.of("message", "review deleted"), requestIdAccessor.get(request))); } } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewRepository.java index 75be056..2f8b347 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewRepository.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewRepository.java @@ -31,40 +31,37 @@ public interface JobReviewRepository extends JpaRepository { List findByJobIdAndStatusAndModerationStatusIn( Long jobId, String status, Collection moderationStatuses); - - /** 企业公开评价汇总：一次查询统计全部岗位的 PUBLISHED + 审核通过评价。 */ - @Query(""" - SELECT COUNT(r), COALESCE(AVG(r.rating), 0) - FROM JobReview r - WHERE r.jobId IN (SELECT j.id FROM Job j WHERE j.companyId = :companyId) - AND r.status = 'PUBLISHED' - AND r.moderationStatus IN ('AUTO_APPROVED', 'APPROVED') - """) - List countAndAveragePublishedRatingByCompanyId(@Param("companyId") Long companyId); - - /** 企业公开评价评分分布，按评分升序返回 [rating, count]。 */ - @Query(""" - SELECT r.rating, COUNT(r) - FROM JobReview r - WHERE r.jobId IN (SELECT j.id FROM Job j WHERE j.companyId = :companyId) - AND r.status = 'PUBLISHED' - AND r.moderationStatus IN ('AUTO_APPROVED', 'APPROVED') - GROUP BY r.rating - ORDER BY r.rating - """) - List findPublishedRatingDistributionByCompanyId(@Param("companyId") Long companyId); - - /** 企业公开评价的原始 tags 列，避免逐条读取评价。 */ - @Query(""" - SELECT r.tags - FROM JobReview r - WHERE r.jobId IN (SELECT j.id FROM Job j WHERE j.companyId = :companyId) - AND r.status = 'PUBLISHED' - AND r.moderationStatus IN ('AUTO_APPROVED', 'APPROVED') - AND r.tags IS NOT NULL - ORDER BY r.id ASC - """) - List findPublishedTagsByCompanyId(@Param("companyId") Long companyId); + /** 企业评价管理：仅查询当前公司名下岗位的评价，回复状态通过左连接筛选。 */ + @Query(value = "SELECT r.* FROM job_reviews r JOIN jobs j ON j.id = r.job_id " + + "LEFT JOIN company_review_replies rr ON rr.review_id = r.id " + + "WHERE j.company_id = :companyId " + + "AND (:jobId IS NULL OR r.job_id = :jobId) " + + "AND (:rating IS NULL OR r.rating = :rating) " + + "AND (:reviewModerationStatus IS NULL OR r.moderation_status = :reviewModerationStatus) " + + "AND (:replyStatus IS NULL OR (:replyStatus = 'NONE' AND rr.id IS NULL) " + + " OR rr.moderation_status = :replyStatus) " + + "AND (:createdFrom IS NULL OR r.created_at >= :createdFrom) " + + "AND (:createdTo IS NULL OR r.created_at <= :createdTo) " + + "ORDER BY r.created_at DESC", + countQuery = "SELECT COUNT(*) FROM job_reviews r JOIN jobs j ON j.id = r.job_id " + + "LEFT JOIN company_review_replies rr ON rr.review_id = r.id " + + "WHERE j.company_id = :companyId " + + "AND (:jobId IS NULL OR r.job_id = :jobId) " + + "AND (:rating IS NULL OR r.rating = :rating) " + + "AND (:reviewModerationStatus IS NULL OR r.moderation_status = :reviewModerationStatus) " + + "AND (:replyStatus IS NULL OR (:replyStatus = 'NONE' AND rr.id IS NULL) " + + " OR rr.moderation_status = :replyStatus) " + + "AND (:createdFrom IS NULL OR r.created_at >= :createdFrom) " + + "AND (:createdTo IS NULL OR r.created_at <= :createdTo)", + nativeQuery = true) + Page findCompanyReviews(@Param("companyId") Long companyId, + @Param("jobId") Long jobId, + @Param("rating") Integer rating, + @Param("reviewModerationStatus") String reviewModerationStatus, + @Param("replyStatus") String replyStatus, + @Param("createdFrom") LocalDateTime createdFrom, + @Param("createdTo") LocalDateTime createdTo, + Pageable pageable); // ── 防刷规则查询 ────────────────────────────────────────── @@ -76,29 +73,6 @@ public interface JobReviewRepository extends JpaRepository { long countByUaHashAndCreatedAtAfter(String uaHash, LocalDateTime after); - /** 公开列表（含筛选）：PUBLISHED 且审核通过；支持评分档/时间范围/未回复筛选 */ - @Query("SELECT r FROM JobReview r" - + " WHERE r.jobId = :jobId AND r.status = :status" - + " AND r.moderationStatus IN :moderationStatuses" - + " AND (:ratingType IS NULL OR" - + " (:ratingType = 'GOOD' AND r.rating = 5)" - + " OR (:ratingType = 'MEDIUM' AND r.rating IN (3,4))" - + " OR (:ratingType = 'BAD' AND r.rating IN (1,2)))" - + " AND (:createdFrom IS NULL OR r.createdAt >= :createdFrom)" - + " AND (:createdTo IS NULL OR r.createdAt <= :createdTo)" - + " AND (:unreplied = false OR NOT EXISTS" - + " (SELECT 1 FROM CompanyReviewReply rr" - + " WHERE rr.reviewId = r.id AND rr.moderationStatus = 'APPROVED'))" - + " ORDER BY r.createdAt DESC") - Page findPublicReviews(@Param("jobId") Long jobId, - @Param("status") String status, - @Param("moderationStatuses") Collection moderationStatuses, - @Param("ratingType") String ratingType, - @Param("createdFrom") LocalDateTime createdFrom, - @Param("createdTo") LocalDateTime createdTo, - @Param("unreplied") boolean unreplied, - Pageable pageable); - /** 管理端待审列表：PENDING，支持 jobId / riskLevel / 时间范围筛选 */ @Query("SELECT r FROM JobReview r WHERE r.status = 'PUBLISHED' AND r.moderationStatus = 'PENDING'" + " AND (:jobId IS NULL OR r.jobId = :jobId)" diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewService.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewService.java index 55a8d79..30bd08d 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewService.java @@ -32,6 +32,7 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class JobReviewService { + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final JobReviewRepository reviewRepository; private final JobReviewDimensionScoreRepository dimensionScoreRepository; private final ReviewModerationHistoryRepository moderationHistoryRepository; @@ -39,26 +40,20 @@ public class JobReviewService { private final JobService jobService; private final UserRepository userRepository; private final AuditService auditService; - private final CompanyReviewReplyRepository replyRepository; + /** V40 官方回复只读投影；公开评价批量加载，避免逐条查询。 */ + private final CompanyReviewReplyRepository companyReviewReplyRepository; private static final ObjectMapper mapper = new ObjectMapper(); private static final int MAX_PAGE_SIZE = 50; private static final Set ALLOWED_STATUSES = Set.of("PUBLISHED", "HIDDEN"); - private static final Set ALLOWED_RATING_TYPES = Set.of("GOOD", "MEDIUM", "BAD"); private static final int MIN_SCORE = 1; private static final int MAX_SCORE = 5; private static final int MAX_REQUEST_ID_LENGTH = 32; private static final List PUBLIC_MODERATION_STATUSES = List.of( JobReview.MODERATION_AUTO_APPROVED, JobReview.MODERATION_APPROVED); + private static final Set PUBLIC_REPLY_STATUSES = Set.of( + CompanyReviewReply.AUTO_APPROVED, CompanyReviewReply.APPROVED); // ── 角色校验 ────────────────────────────────────────────── - - private void assertStudentRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isStudent = user.getRoles().stream().anyMatch(r -> r == User.Role.STUDENT); - if (!isStudent) throw new BusinessException(ErrorCode.FORBIDDEN); - } - private void assertJobExists(Long jobId) { jobService.getJob(jobId); // throws JOB_NOT_FOUND } @@ -68,16 +63,6 @@ public class JobReviewService { throw new BusinessException(ErrorCode.BAD_REQUEST); } - private void assertValidRatingType(String ratingType) { - if (ratingType != null && !ALLOWED_RATING_TYPES.contains(ratingType)) - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - - private void assertValidTimeRange(LocalDateTime from, LocalDateTime to) { - if (from != null && to != null && from.isAfter(to)) - throw new BusinessException(ErrorCode.BAD_REQUEST); - } - private void assertValidStatus(String status) { if (status != null && !ALLOWED_STATUSES.contains(status)) throw new BusinessException(ErrorCode.BAD_REQUEST); @@ -99,7 +84,7 @@ public class JobReviewService { @Transactional public Map createReview(Long studentUserId, Long jobId, JobReviewCreateRequest req, AuditContext ctx) { - assertStudentRole(studentUserId); + userRoleGuard.requireStudent(studentUserId); assertJobExists(jobId); if (reviewRepository.existsByJobIdAndStudentUserId(jobId, studentUserId)) @@ -152,23 +137,20 @@ public class JobReviewService { // ── 查询 ────────────────────────────────────────────────── public Page> listReviews(Long jobId, int page, int size) { - return listReviews(jobId, null, null, null, false, page, size); - } - - /** 公开评价列表（含筛选）：评分档/创建时间区间/未回复；均可不传 */ - public Page> listReviews(Long jobId, String ratingType, - LocalDateTime createdFrom, LocalDateTime createdTo, - boolean unreplied, int page, int size) { assertJobExists(jobId); assertValidPage(page, size); - assertValidRatingType(ratingType); - assertValidTimeRange(createdFrom, createdTo); - Page result = reviewRepository.findPublicReviews( - jobId, "PUBLISHED", PUBLIC_MODERATION_STATUSES, - ratingType, createdFrom, createdTo, unreplied, PageRequest.of(page, size)); + Page result = reviewRepository + .findByJobIdAndStatusAndModerationStatusInOrderByCreatedAtDesc( + jobId, "PUBLISHED", PUBLIC_MODERATION_STATUSES, PageRequest.of(page, size)); List ids = result.getContent().stream().map(JobReview::getId).toList(); Map> dimsByReview = batchLoadDimensionMap(ids); - return result.map(r -> toView(r, dimsByReview.getOrDefault(r.getId(), Map.of()))); + Map> repliesByReview = batchLoadPublicReplies(ids); + return result.map(r -> { + Map view = toView(r, dimsByReview.getOrDefault(r.getId(), Map.of())); + Map officialReply = repliesByReview.get(r.getId()); + if (officialReply != null) view.put("officialReply", officialReply); + return view; + }); } /** 评价详情（公开；仅审核通过可公开） */ @@ -180,7 +162,10 @@ public class JobReviewService { throw new BusinessException(ErrorCode.REVIEW_NOT_FOUND); if (!PUBLIC_MODERATION_STATUSES.contains(review.getModerationStatus())) throw new BusinessException(ErrorCode.REVIEW_NOT_FOUND); // PENDING/REJECTED 不公开 - return toView(review, loadDimensionMap(reviewId)); + Map view = toView(review, loadDimensionMap(reviewId)); + Map officialReply = batchLoadPublicReplies(List.of(reviewId)).get(reviewId); + if (officialReply != null) view.put("officialReply", officialReply); + return view; } // ── 修改 ────────────────────────────────────────────────── @@ -195,7 +180,7 @@ public class JobReviewService { @Transactional public Map updateReview(Long userId, Long jobId, Long reviewId, JobReviewUpdateRequest req, AuditContext ctx) { - assertStudentRole(userId); + userRoleGuard.requireStudent(userId); JobReview review = findOwnReview(userId, jobId, reviewId); if (req.getRating() != null) { @@ -232,7 +217,7 @@ public class JobReviewService { @Transactional public void deleteReview(Long userId, Long jobId, Long reviewId, AuditContext ctx) { - assertStudentRole(userId); + userRoleGuard.requireStudent(userId); findOwnReview(userId, jobId, reviewId); reviewRepository.deleteById(reviewId); // DB 外键 ON DELETE CASCADE 删除维度分 auditService.log(userId, "DELETE_REVIEW", "JOB_REVIEW", reviewId, @@ -339,7 +324,7 @@ public class JobReviewService { public Page> listPendingReviews(Long adminUserId, Long jobId, String riskLevel, LocalDateTime createdFrom, LocalDateTime createdTo, int page, int size) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); assertValidPage(page, size); return reviewRepository.findPendingModeration(jobId, riskLevel, createdFrom, createdTo, PageRequest.of(page, size)) @@ -350,7 +335,7 @@ public class JobReviewService { @Transactional public Map decideReview(Long adminUserId, Long reviewId, String decision, String reason, AuditContext ctx) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); JobReview review = reviewRepository.findById(reviewId) .orElseThrow(() -> new BusinessException(ErrorCode.REVIEW_NOT_FOUND)); if (!JobReview.MODERATION_PENDING.equals(review.getModerationStatus())) { @@ -379,19 +364,11 @@ public class JobReviewService { /** 审核历史（分页），返回结果、审核人、时间与原因 */ @Transactional(readOnly = true) public Page> listModerationHistory(Long adminUserId, int page, int size) { - assertAdminRole(adminUserId); + userRoleGuard.requireAdmin(adminUserId); assertValidPage(page, size); return moderationHistoryRepository.findAllByOrderByCreatedAtDesc(PageRequest.of(page, size)) .map(this::toHistoryView); } - - private void assertAdminRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isAdmin = user.getRoles().stream().anyMatch(r -> r == User.Role.ADMIN); - if (!isAdmin) throw new BusinessException(ErrorCode.FORBIDDEN); - } - // ── 八维评分 ────────────────────────────────────────────── /** 校验并归一化维度分：null/空 → 空；key 非法 → 400；value 非 1-5 或 null → 400 */ @@ -448,6 +425,20 @@ public class JobReviewService { return result; } + /** 仅公开 AUTO_APPROVED/APPROVED 回复，且只返回正文与回复时间。 */ + private Map> batchLoadPublicReplies(List reviewIds) { + Map> result = new HashMap<>(); + if (reviewIds == null || reviewIds.isEmpty() || companyReviewReplyRepository == null) return result; + for (CompanyReviewReply reply : companyReviewReplyRepository.findByReviewIdIn(reviewIds)) { + if (!PUBLIC_REPLY_STATUSES.contains(reply.getModerationStatus())) continue; + Map view = new LinkedHashMap<>(); + view.put("content", reply.getContent()); + view.put("repliedAt", reply.getUpdatedAt() != null ? reply.getUpdatedAt() : reply.getCreatedAt()); + result.put(reply.getReviewId(), view); + } + return result; + } + /** 八维汇总：始终返回全部 8 个维度；sampleCount<3 → INSUFFICIENT，>=3 → SUFFICIENT；无数据 → null */ private Map buildDimensionSummary(List reviewIds) { Map result = new LinkedHashMap<>(); @@ -502,10 +493,11 @@ public class JobReviewService { } public Map toView(JobReview r, Map dimensionScores) { - Map view = new HashMap<>(); + Map view = new LinkedHashMap<>(); view.put("id", r.getId()); view.put("jobId", r.getJobId()); - view.put("studentUserId", r.getStudentUserId()); + // 公开/企业评价载荷不得暴露评价人内部主键。 + view.put("reviewerLabel", "匿名求职者"); view.put("rating", r.getRating()); view.put("content", r.getContent()); view.put("tags", fromJson(r.getTags())); @@ -514,20 +506,6 @@ public class JobReviewService { view.put("createdAt", r.getCreatedAt()); view.put("updatedAt", r.getUpdatedAt()); view.put("dimensionScores", dimensionScores == null ? Map.of() : dimensionScores); - - // 新增：查询企业回复（仅审核通过的） - CompanyReviewReply reply = replyRepository.findByReviewIdAndModerationStatus( - r.getId(), CompanyReviewReply.MODERATION_APPROVED).orElse(null); - if (reply != null) { - view.put("companyReply", Map.of( - "id", reply.getId(), - "content", reply.getContent(), - "createdAt", reply.getCreatedAt() - )); - } else { - view.put("companyReply", null); - } - return view; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/ReviewModerationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/ReviewModerationService.java index d3c5d99..1e53950 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/ReviewModerationService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/ReviewModerationService.java @@ -108,6 +108,34 @@ public class ReviewModerationService { new ArrayList<>(codes), BigDecimal.valueOf(capped), riskLevel(capped)); } + /** + * 企业官方回复预审。只使用与文本本身相关的规则，不使用学生评价的提交频率、 + * 岗位重复评价或学生批量行为规则，避免把两种主体的风控语义混在一起。 + */ + public ModerationResult moderateCompanyReply(String content) { + Set codes = new LinkedHashSet<>(); + double score = 0; + if (containsSensitiveWord(content)) { + codes.add(REASON_SENSITIVE_WORD); + score += 2; + } + if (containsContactInfo(content)) { + codes.add(REASON_CONTACT_INFO); + score += 2; + } + if (hasAnomalousPattern(content)) { + codes.add(REASON_PATTERN_ANOMALY); + score += 1; + } + if (codes.isEmpty()) { + return new ModerationResult(CompanyReviewReply.AUTO_APPROVED, + List.of(), BigDecimal.ZERO, null); + } + double capped = Math.min(score, 100); + return new ModerationResult(CompanyReviewReply.PENDING, + new ArrayList<>(codes), BigDecimal.valueOf(capped), riskLevel(capped)); + } + // ── 规则实现 ────────────────────────────────────────────── private boolean containsSensitiveWord(String content) { diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/StudentReviewWeightController.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/StudentReviewWeightController.java index e0d8775..c4f7838 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/StudentReviewWeightController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/StudentReviewWeightController.java @@ -1,20 +1,18 @@ package com.mydreamjob.review; import com.mydreamjob.common.api.ApiResponse; -import com.mydreamjob.common.exception.BusinessException; -import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.logging.RequestIdAccessor; import com.mydreamjob.review.dto.PersonalizedScoreResponse; import com.mydreamjob.review.dto.ReviewWeightResponse; import com.mydreamjob.review.dto.SaveWeightRequest; import com.mydreamjob.review.dto.WeightTemplateResponse; +import com.mydreamjob.security.CurrentUserAccessor; import io.swagger.v3.oas.annotations.media.Content; import io.swagger.v3.oas.annotations.media.Schema; import io.swagger.v3.oas.annotations.responses.ApiResponses; 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.*; import java.util.List; @@ -24,6 +22,8 @@ import java.util.List; public class StudentReviewWeightController { private final StudentReviewWeightService weightService; + private final CurrentUserAccessor currentUserAccessor; + private final RequestIdAccessor requestIdAccessor; // ── 模板列表（登录即可） ────────────────────────────────── @@ -35,7 +35,7 @@ public class StudentReviewWeightController { }) public ResponseEntity>> getTemplates( HttpServletRequest request) { - return ResponseEntity.ok(ApiResponse.ok(weightService.getTemplates(), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(weightService.getTemplates(), requestIdAccessor.get(request))); } // ── 获取我的权重配置（仅 STUDENT，Service 层校验） ────────── @@ -50,8 +50,8 @@ public class StudentReviewWeightController { }) public ResponseEntity> getMyWeights( HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(weightService.getMyWeights(userId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(weightService.getMyWeights(userId), requestIdAccessor.get(request))); } // ── 保存我的权重配置（仅 STUDENT，Service 层校验） ────────── @@ -67,8 +67,8 @@ public class StudentReviewWeightController { public ResponseEntity> saveWeights( @RequestBody SaveWeightRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(weightService.saveWeights(userId, req), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(weightService.saveWeights(userId, req), requestIdAccessor.get(request))); } // ── 个性化评分（仅 STUDENT，Service 层校验） ──────────────── @@ -84,19 +84,7 @@ public class StudentReviewWeightController { public ResponseEntity> getPersonalizedScore( @PathVariable Long jobId, HttpServletRequest request) { - Long userId = resolveUserId(request); - return ResponseEntity.ok(ApiResponse.ok(weightService.getPersonalizedScore(userId, jobId), getRequestId(request))); + Long userId = currentUserAccessor.requireUserId(); + return ResponseEntity.ok(ApiResponse.ok(weightService.getPersonalizedScore(userId, jobId), requestIdAccessor.get(request))); } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyPageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyPageResponse.java new file mode 100644 index 0000000..ea082dc --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyPageResponse.java @@ -0,0 +1,20 @@ +package com.mydreamjob.review.dto; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.util.List; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class AdminReviewReplyPageResponse { + private List items; + private long total; + private int page; + private int size; + private int totalPages; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyResponse.java new file mode 100644 index 0000000..39b575f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/AdminReviewReplyResponse.java @@ -0,0 +1,33 @@ +package com.mydreamjob.review.dto; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class AdminReviewReplyResponse { + private Long replyId; + private Long reviewId; + private Long jobId; + private String jobTitle; + private Long companyId; + private String companyName; + private Integer rating; + private String reviewContent; + private String reviewModerationStatus; + private String replyContent; + private String replyStatus; + private Long version; + private BigDecimal riskScore; + private String riskLevel; + private List reasonCodes; + private LocalDateTime createdAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewDetailResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewDetailResponse.java new file mode 100644 index 0000000..53d2fbe --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewDetailResponse.java @@ -0,0 +1,8 @@ +package com.mydreamjob.review.dto; + +import lombok.Data; + +/** 详情与列表使用同一白名单字段，避免 Entity 直接序列化。 */ +@Data +public class CompanyReviewDetailResponse extends CompanyReviewItemResponse { +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewItemResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewItemResponse.java new file mode 100644 index 0000000..1c1075c --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewItemResponse.java @@ -0,0 +1,26 @@ +package com.mydreamjob.review.dto; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.Map; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class CompanyReviewItemResponse { + private Long reviewId; + private CompanyReviewJobResponse job; + private Integer rating; + private String content; + private List tags; + private Map dimensionScores; + private String reviewStatus; + private LocalDateTime reviewCreatedAt; + private CompanyReviewReplyResponse reply; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewJobResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewJobResponse.java new file mode 100644 index 0000000..3888152 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewJobResponse.java @@ -0,0 +1,13 @@ +package com.mydreamjob.review.dto; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CompanyReviewJobResponse { + private Long id; + private String title; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewReplyResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewReplyResponse.java index 7677c73..a7407b4 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewReplyResponse.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CompanyReviewReplyResponse.java @@ -1,7 +1,5 @@ package com.mydreamjob.review.dto; -import com.fasterxml.jackson.annotation.JsonInclude; -import io.swagger.v3.oas.annotations.media.Schema; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; @@ -13,28 +11,11 @@ import java.time.LocalDateTime; @Builder @NoArgsConstructor @AllArgsConstructor -@JsonInclude(JsonInclude.Include.NON_NULL) -@Schema(name = "CompanyReviewReplyResponse", description = "企业对评价的回复") public class CompanyReviewReplyResponse { - - @Schema(description = "回复 ID", example = "1") private Long id; - - @Schema(description = "被回复的评价 ID", example = "100") - private Long reviewId; - - @Schema(description = "回复内容", example = "感谢您的反馈，我们会持续改进") private String content; - - @Schema(description = "审核状态：PENDING/APPROVED/REJECTED", example = "APPROVED") - private String moderationStatus; - - @Schema(description = "审核原因/意见", example = "内容合规") - private String moderationReason; - - @Schema(description = "创建时间", example = "2026-09-01T10:00:00") - private LocalDateTime createdAt; - - @Schema(description = "更新时间", example = "2026-09-01T10:00:00") + private String status; + private Long version; private LocalDateTime updatedAt; + private String rejectionReason; } diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CreateCompanyReviewReplyRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CreateCompanyReviewReplyRequest.java new file mode 100644 index 0000000..a60813f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/CreateCompanyReviewReplyRequest.java @@ -0,0 +1,16 @@ +package com.mydreamjob.review.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import lombok.Data; + +@Data +public class CreateCompanyReviewReplyRequest { + @NotBlank(message = "content is required") + @Size(max = 500, message = "content must not exceed 500 characters") + private String content; + + @NotBlank(message = "idempotencyKey is required") + @Size(max = 64, message = "idempotencyKey must not exceed 64 characters") + private String idempotencyKey; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyDecisionRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyDecisionRequest.java new file mode 100644 index 0000000..10b51c1 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyDecisionRequest.java @@ -0,0 +1,14 @@ +package com.mydreamjob.review.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import lombok.Data; + +@Data +public class ReviewReplyDecisionRequest { + @NotBlank(message = "decision is required") + private String decision; + + @Size(max = 500, message = "reason must not exceed 500 characters") + private String reason; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyPageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyPageResponse.java new file mode 100644 index 0000000..9bc93ba --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/ReviewReplyPageResponse.java @@ -0,0 +1,20 @@ +package com.mydreamjob.review.dto; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.util.List; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class ReviewReplyPageResponse { + private List items; + private long total; + private int page; + private int size; + private int totalPages; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/UpdateCompanyReviewReplyRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/UpdateCompanyReviewReplyRequest.java new file mode 100644 index 0000000..5f47fec --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/review/dto/UpdateCompanyReviewReplyRequest.java @@ -0,0 +1,16 @@ +package com.mydreamjob.review.dto; + +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.PositiveOrZero; +import jakarta.validation.constraints.Size; +import lombok.Data; + +@Data +public class UpdateCompanyReviewReplyRequest { + @Size(min = 1, max = 500, message = "content must be 1-500 characters") + private String content; + + @NotNull(message = "expectedVersion is required") + @PositiveOrZero(message = "expectedVersion must be non-negative") + private Long expectedVersion; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/AdminRiskController.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/AdminRiskController.java new file mode 100644 index 0000000..16e095a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/AdminRiskController.java @@ -0,0 +1,206 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.api.PageResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.risk.dto.RiskDistributionResponse; +import com.mydreamjob.risk.dto.RiskEventActionRequest; +import com.mydreamjob.risk.dto.RiskEventResponse; +import com.mydreamjob.risk.dto.RiskOverviewResponse; +import com.mydreamjob.risk.dto.RiskRuleResponse; +import com.mydreamjob.risk.dto.RiskRuleUpdateRequest; +import com.mydreamjob.risk.dto.RiskTrendResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.responses.ApiResponses; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.time.LocalDateTime; +import java.time.format.DateTimeParseException; +import java.util.List; + +/** + * 风险概览与运营规则配置（V37）。仅 ADMIN；COMPANY/STUDENT/未登录分别 403/403/401。 + * + *

    身份一律 JWT/SecurityContext，不接受 adminUserId/operatorUserId/userId 参数。 + * 风险事件响应为字段白名单，严禁返回 subjectUserId/phone/email/IP/userAgent/details。

    + */ +@Tag(name = "风险治理", description = "ADMIN 防刷风险概览与运营规则配置") +@RestController +@RequestMapping("/admin/scoring/risk") +@RequiredArgsConstructor +public class AdminRiskController { + + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + + private final RiskGovernanceService riskGovernanceService; + + @Operation(summary = "风险概览（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "非法筛选（9906）") + }) + @GetMapping("/overview") + public ResponseEntity> overview( + @RequestParam(required = false) String from, + @RequestParam(required = false) String to, + HttpServletRequest request) { + requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok( + riskGovernanceService.overview(parse(from), parse(to)), requestIdAccessor.get(request))); + } + + @Operation(summary = "风险趋势（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "非法 bucket/筛选（9906）") + }) + @GetMapping("/trend") + public ResponseEntity> trend( + @RequestParam String bucket, + @RequestParam(required = false) String from, + @RequestParam(required = false) String to, + HttpServletRequest request) { + requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok( + riskGovernanceService.trend(bucket, parse(from), parse(to)), requestIdAccessor.get(request))); + } + + @Operation(summary = "风险分布（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "非法筛选（9906）") + }) + @GetMapping("/distribution") + public ResponseEntity> distribution( + @RequestParam(required = false) String from, + @RequestParam(required = false) String to, + HttpServletRequest request) { + requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok( + riskGovernanceService.distribution(parse(from), parse(to)), requestIdAccessor.get(request))); + } + + @Operation(summary = "风险事件分页（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "非法筛选/分页（9906/1001）") + }) + @GetMapping("/events") + public ResponseEntity>> events( + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + @RequestParam(required = false) String status, + @RequestParam(required = false) String severity, + @RequestParam(required = false) String ruleCode, + @RequestParam(required = false) String from, + @RequestParam(required = false) String to, + HttpServletRequest request) { + requireAdmin(request); + Page result = riskGovernanceService.events( + page, size, status, severity, ruleCode, parse(from), parse(to)); + return ResponseEntity.ok(ApiResponse.ok(PageResponse.of( + result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), + requestIdAccessor.get(request))); + } + + @Operation(summary = "风险规则列表（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）") + }) + @GetMapping("/rules") + public ResponseEntity>> rules(HttpServletRequest request) { + requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok(riskGovernanceService.listRules(), requestIdAccessor.get(request))); + } + + @Operation(summary = "更新风险规则（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "参数非法（1001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "规则不存在（9901）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "并发更新（9903）") + }) + @PutMapping("/rules/{ruleCode}") + public ResponseEntity> updateRule( + @PathVariable String ruleCode, @Valid @RequestBody RiskRuleUpdateRequest req, + HttpServletRequest request) { + Long adminUserId = requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok(riskGovernanceService.updateRule( + ruleCode, req, adminUserId, riskAuditContext(request)), requestIdAccessor.get(request))); + } + + @Operation(summary = "风险事件人工操作（ADMIN）") + @ApiResponses({ + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "OK"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "参数非法（1001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "401", description = "未登录"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "403", description = "非 ADMIN（2002/4001）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "404", description = "事件不存在（9902）"), + @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "409", description = "非法流转/并发（9904/9905）") + }) + @PostMapping("/events/{eventId}/actions") + public ResponseEntity> actionEvent( + @PathVariable Long eventId, @Valid @RequestBody RiskEventActionRequest req, + HttpServletRequest request) { + Long adminUserId = requireAdmin(request); + return ResponseEntity.ok(ApiResponse.ok(riskGovernanceService.actionEvent( + eventId, req, adminUserId, riskAuditContext(request)), requestIdAccessor.get(request))); + } + + /** + * R01-B/B1：身份来自 {@link com.mydreamjob.security.CurrentUserAccessor}， + * 角色授权委托给公共 {@link com.mydreamjob.security.UserRoleGuard}。 + */ + private Long requireAdmin(HttpServletRequest request) { + Long userId = currentUserAccessor.requireUserId(); + userRoleGuard.requireAdmin(userId); + return userId; + } + + /** 风险审计上下文：仅保留 requestId，禁止写入 IP/UA/请求体等。 */ + private AuditContext riskAuditContext(HttpServletRequest request) { + return AuditContext.builder().requestId(requestIdAccessor.get(request)).build(); + } + + private LocalDateTime parse(String s) { + if (s == null || s.isBlank()) { + return null; + } + try { + return LocalDateTime.parse(s); + } catch (DateTimeParseException e) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventDetector.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventDetector.java new file mode 100644 index 0000000..1211f3a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventDetector.java @@ -0,0 +1,138 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.audit.AuditService; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Clock; +import java.time.LocalDateTime; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.function.Function; +import java.util.stream.Collectors; + +/** + * 风险事件扫描器（V37）。 + * + *

    {@code scanOnce()} 为可直接单测的方法；{@code @Scheduled} 只调用它。扫描基于既有 + * {@code audit_logs}，仅消费 {@code REPORT_RATE_LIMITED}/{@code BLOCKED_SEND_PROHIBITED} 两个 + * 白名单 action，且 user_id 非空。整批成功后才推进 checkpoint；任一处理失败整体回滚。

    + * + *

    去刷屏：仅当窗口内命中数恰等于 thresholdCount 时创建事件；阈值之后同窗口的更多命中不再 + * 创建新事件。事件插入受唯一键 {@code (rule_config_id, source_audit_log_id)} 与 existsBy 防重保护。

    + */ +@Slf4j +@Component +@RequiredArgsConstructor +public class RiskEventDetector { + + public static final int BATCH_SIZE = 500; + public static final Set ALLOWED_ACTIONS = + Set.of("REPORT_RATE_LIMITED", "BLOCKED_SEND_PROHIBITED"); + + private static final String AUDIT_DETECTED = "RISK_EVENT_DETECTED"; + + private final ScoringRuleConfigRepository ruleRepository; + private final ScoringRiskEventRepository eventRepository; + private final ScoringRiskScanCheckpointRepository checkpointRepository; + private final AuditLogRepository auditLogRepository; + private final AuditService auditService; + private final Clock clock; + + /** + * 执行一次风险扫描。返回本轮新建的风险事件数。 + */ + @Transactional + public int scanOnce() { + ScoringRiskScanCheckpoint checkpoint = checkpointRepository + .findByCheckpointKeyForUpdate(ScoringRiskScanCheckpoint.KEY_RISK_EVENT_DETECTOR) + .orElseGet(this::createCheckpoint); + + long lastId = checkpoint.getLastAuditLogId(); + List batch = auditLogRepository + .findByIdAfterOrderByIdAsc(lastId, PageRequest.of(0, BATCH_SIZE)); + if (batch.isEmpty()) { + return 0; + } + + Map ruleByAction = ruleRepository.findAllByEnabledTrue().stream() + .collect(Collectors.toMap(ScoringRuleConfig::getSourceAction, Function.identity())); + + LocalDateTime now = LocalDateTime.now(clock); + long maxId = lastId; + int created = 0; + + for (AuditLog a : batch) { + if (a.getId() > maxId) { + maxId = a.getId(); + } + // 仅处理带用户主体且 action 在规则白名单内的审计 + if (a.getUserId() == null || a.getCreatedAt() == null) { + continue; + } + ScoringRuleConfig rule = ruleByAction.get(a.getAction()); + if (rule == null) { + // 规则已禁用或非白名单 action：审计照常越过 checkpoint；重新启用不回放历史 + continue; + } + + LocalDateTime winStart = a.getCreatedAt().minusMinutes(rule.getWindowMinutes()); + long occurrence = auditLogRepository.countByUserIdAndActionAndCreatedAtBetween( + a.getUserId(), a.getAction(), winStart, a.getCreatedAt()); + + // 仅恰好等于阈值才生成事件（防止阈值后每次操作刷屏） + if (occurrence == rule.getThresholdCount().longValue() + && !eventRepository.existsByRuleIdAndSourceAuditLogId(rule.getId(), a.getId())) { + ScoringRiskEvent ev = ScoringRiskEvent.builder() + .rule(rule) + .subjectUserId(a.getUserId()) + .sourceAuditLogId(a.getId()) + .sourceAction(rule.getSourceAction()) + .severity(rule.getSeverity()) + .windowStartedAt(winStart) + .windowEndedAt(a.getCreatedAt()) + .occurrenceCount((int) occurrence) + .status(ScoringRiskEvent.STATUS_OPEN) + .detectedAt(now) + .build(); + // 使用 saveAndFlush 的返回对象，确保事件 ID 已生成（IDENTITY 生成策略下必须用返回值， + // 否则 ev.getId() 可能仍为 null，导致检测审计 entity_id/details.riskEventId 无法定位）。 + ScoringRiskEvent savedEvent = eventRepository.saveAndFlush(ev); + created++; + + auditService.log(null, AUDIT_DETECTED, "SCORING_RISK_EVENT", savedEvent.getId(), + detectedAuditDetails(savedEvent), AuditContext.builder().build()); + } + } + + checkpoint.setLastAuditLogId(maxId); + checkpointRepository.save(checkpoint); + return created; + } + + private ScoringRiskScanCheckpoint createCheckpoint() { + ScoringRiskScanCheckpoint cp = ScoringRiskScanCheckpoint.builder() + .checkpointKey(ScoringRiskScanCheckpoint.KEY_RISK_EVENT_DETECTOR) + .lastAuditLogId(0L) + .build(); + return checkpointRepository.saveAndFlush(cp); + } + + /** + * RISK_EVENT_DETECTED 审计 details（JSON 形式规避 AuditService 对 {@code code=} 的脱敏误伤， + * 只记录非敏感追踪字段，不含用户身份/原始审计 details/IP/UA/凭据）。 + */ + private static String detectedAuditDetails(ScoringRiskEvent ev) { + return "{\"riskEventId\":" + ev.getId() + + ",\"ruleCode\":\"" + ev.getRule().getRuleCode() + "\"" + + ",\"severity\":\"" + ev.getSeverity() + "\"" + + ",\"occurrenceCount\":" + ev.getOccurrenceCount() + "}"; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventScanScheduler.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventScanScheduler.java new file mode 100644 index 0000000..7eea692 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskEventScanScheduler.java @@ -0,0 +1,32 @@ +package com.mydreamjob.risk; + +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.scheduling.annotation.Scheduled; +import org.springframework.stereotype.Component; + +/** + * 风险扫描定时调度（V37）。{@code @Scheduled} 仅调用 {@link RiskEventDetector#scanOnce()}， + * 默认 60 秒固定延迟，可配置 {@code app.risk.scan.fixed-delay-ms}；测试环境关闭自动扫描。 + */ +@Slf4j +@Component +@RequiredArgsConstructor +@ConditionalOnProperty(name = "app.risk.scan.enabled", havingValue = "true", matchIfMissing = true) +public class RiskEventScanScheduler { + + private final RiskEventDetector riskEventDetector; + + @Scheduled(fixedDelayString = "${app.risk.scan.fixed-delay-ms:60000}") + public void scan() { + try { + int count = riskEventDetector.scanOnce(); + if (count > 0) { + log.info("Risk scan produced {} event(s)", count); + } + } catch (Exception e) { + log.error("Risk scan failed: {}", e.getMessage(), e); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskGovernanceService.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskGovernanceService.java new file mode 100644 index 0000000..7476410 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/RiskGovernanceService.java @@ -0,0 +1,273 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.risk.dto.RiskDistributionResponse; +import com.mydreamjob.risk.dto.RiskEventActionRequest; +import com.mydreamjob.risk.dto.RiskEventResponse; +import com.mydreamjob.risk.dto.RiskOverviewResponse; +import com.mydreamjob.risk.dto.RiskRuleResponse; +import com.mydreamjob.risk.dto.RiskRuleUpdateRequest; +import com.mydreamjob.risk.dto.RiskTrendResponse; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.dao.OptimisticLockingFailureException; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Clock; +import java.time.Duration; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +/** + * 风险治理服务（V37）。仅 ADMIN 使用；身份一律 JWT/SecurityContext。 + * + *

    概览/趋势/分布/事件全部使用 SQL GROUP BY 或 JOIN FETCH 投影，消除 N+1；事件与规则响应 + * 均为字段白名单，绝不返回 subjectUserId/phone/email/IP/userAgent/details 等敏感字段。

    + */ +@Slf4j +@Service +@RequiredArgsConstructor +public class RiskGovernanceService { + + private static final int MAX_PAGE_SIZE = 50; + private static final int MAX_RANGE_DAYS = 90; + private static final Set SEVERITIES = Set.of("LOW", "MEDIUM", "HIGH"); + private static final Set STATUSES = Set.of("OPEN", "ACKNOWLEDGED", "DISMISSED"); + private static final Set BUCKETS = Set.of("HOUR", "DAY"); + private static final Set REASONS = + Set.of("MONITORING", "CONFIRMED_FALSE_POSITIVE", "OUT_OF_BAND_ESCALATED"); + + private static final String AUDIT_RULE_UPDATED = "RISK_RULE_UPDATED"; + private static final String AUDIT_EVENT_ACTIONED = "RISK_EVENT_ACTIONED"; + + private final ScoringRuleConfigRepository ruleRepository; + private final ScoringRiskEventRepository eventRepository; + private final ScoringRiskActionRepository actionRepository; + private final AuditService auditService; + private final Clock clock; + + // ─────────────────────── 概览 / 趋势 / 分布 ─────────────────────── + + @Transactional(readOnly = true) + public RiskOverviewResponse overview(LocalDateTime from, LocalDateTime to) { + LocalDateTime[] range = resolveRange(from, to); + from = range[0]; + to = range[1]; + List byRule = eventRepository + .countGroupByRuleCode(ScoringRiskEvent.STATUS_OPEN, from, to).stream() + .map(r -> RiskOverviewResponse.RuleCount.builder() + .ruleCode((String) r[0]).count(((Number) r[1]).longValue()).build()) + .sorted(java.util.Comparator.comparing(RiskOverviewResponse.RuleCount::getRuleCode)) + .collect(Collectors.toList()); + return RiskOverviewResponse.builder() + .openCount(eventRepository.countByStatusAndDetectedAtBetween( + ScoringRiskEvent.STATUS_OPEN, from, to)) + .bySeverity(eventRepository.countGroupBySeverity( + ScoringRiskEvent.STATUS_OPEN, from, to).stream() + .map(r -> RiskOverviewResponse.SeverityCount.builder() + .severity((String) r[0]).count(((Number) r[1]).longValue()).build()) + .sorted(java.util.Comparator.comparing(RiskOverviewResponse.SeverityCount::getSeverity)) + .collect(Collectors.toList())) + .byRule(byRule) + .lastDetectedAt(eventRepository.findMaxDetectedAtByStatusBetween( + ScoringRiskEvent.STATUS_OPEN, from, to)) + .build(); + } + + @Transactional(readOnly = true) + public RiskTrendResponse trend(String bucket, LocalDateTime from, LocalDateTime to) { + LocalDateTime[] range = resolveRange(from, to); + from = range[0]; + to = range[1]; + if (!BUCKETS.contains(bucket)) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + List rows = "HOUR".equals(bucket) + ? eventRepository.trendByHour(from, to) + : eventRepository.trendByDay(from, to); + List items = new ArrayList<>(rows.size()); + for (Object[] r : rows) { + LocalDateTime time; + if ("HOUR".equals(bucket)) { + time = LocalDateTime.of((int) r[0], (int) r[1], (int) r[2], (int) r[3], 0); + } else { + time = LocalDateTime.of((int) r[0], (int) r[1], (int) r[2], 0, 0); + } + items.add(RiskTrendResponse.TrendPoint.builder() + .time(time).count(((Number) r[r.length - 1]).longValue()).build()); + } + return RiskTrendResponse.builder().bucket(bucket).items(items).build(); + } + + @Transactional(readOnly = true) + public RiskDistributionResponse distribution(LocalDateTime from, LocalDateTime to) { + LocalDateTime[] range = resolveRange(from, to); + from = range[0]; + to = range[1]; + List items = eventRepository + .distribution(from, to).stream() + .map(r -> RiskDistributionResponse.DistributionRow.builder() + .ruleCode((String) r[0]).severity((String) r[1]) + .count(((Number) r[2]).longValue()).build()) + .collect(Collectors.toList()); + return RiskDistributionResponse.builder().items(items).build(); + } + + // ─────────────────────── 事件列表 ─────────────────────── + + @Transactional(readOnly = true) + public Page events(int page, int size, String status, String severity, + String ruleCode, LocalDateTime from, LocalDateTime to) { + LocalDateTime[] range = resolveRange(from, to); + from = range[0]; + to = range[1]; + if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + if (status != null && !STATUSES.contains(status)) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + if (severity != null && !SEVERITIES.contains(severity)) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + return eventRepository + .search(status, severity, ruleCode, from, to, PageRequest.of(page, size)) + .map(this::toEventResponse); + } + + // ─────────────────────── 规则查询 / 更新 ─────────────────────── + + @Transactional(readOnly = true) + public List listRules() { + return ruleRepository.findAllByOrderByRuleCodeAsc().stream().map(this::toRuleResponse) + .collect(Collectors.toList()); + } + + @Transactional + public RiskRuleResponse updateRule(String ruleCode, RiskRuleUpdateRequest req, Long operatorUserId, + AuditContext ctx) { + ScoringRuleConfig rule = ruleRepository.findByRuleCode(ruleCode) + .orElseThrow(() -> new BusinessException(ErrorCode.RISK_RULE_NOT_FOUND)); + if (!rule.getVersion().equals(req.getExpectedVersion())) { + throw new BusinessException(ErrorCode.RISK_RULE_CONCURRENT_UPDATE); + } + rule.setEnabled(req.getEnabled()); + rule.setThresholdCount(req.getThresholdCount()); + rule.setWindowMinutes(req.getWindowMinutes()); + rule.setSeverity(req.getSeverity()); + rule.setVersion(req.getExpectedVersion()); + try { + rule = ruleRepository.saveAndFlush(rule); + } catch (OptimisticLockingFailureException e) { + throw new BusinessException(ErrorCode.RISK_RULE_CONCURRENT_UPDATE); + } + auditService.log(operatorUserId, AUDIT_RULE_UPDATED, "SCORING_RULE_CONFIG", rule.getId(), + ruleUpdateAuditDetails(rule), ctx); + return toRuleResponse(rule); + } + + // ─────────────────────── 事件人工操作 ─────────────────────── + + @Transactional + public RiskEventResponse actionEvent(Long eventId, RiskEventActionRequest req, Long operatorUserId, + AuditContext ctx) { + if (!isValidAction(req.getAction())) { + throw new BusinessException(ErrorCode.RISK_INVALID_ACTION); + } + if (!REASONS.contains(req.getReasonCode())) { + throw new BusinessException(ErrorCode.RISK_INVALID_ACTION); + } + ScoringRiskEvent ev = eventRepository.findById(eventId) + .orElseThrow(() -> new BusinessException(ErrorCode.RISK_EVENT_NOT_FOUND)); + if (!ev.getVersion().equals(req.getExpectedVersion())) { + throw new BusinessException(ErrorCode.RISK_EVENT_CONCURRENT_UPDATE); + } + String to = ScoringRiskEvent.transition(ev.getStatus(), req.getAction()); + if (to == null) { + throw new BusinessException(ErrorCode.RISK_INVALID_ACTION); + } + ev.setStatus(to); + ev.setVersion(req.getExpectedVersion()); + ScoringRiskAction actionRow = ScoringRiskAction.builder() + .riskEventId(ev.getId()).operatorUserId(operatorUserId) + .action(req.getAction()).reasonCode(req.getReasonCode()).build(); + try { + ev = eventRepository.saveAndFlush(ev); + actionRepository.save(actionRow); + } catch (OptimisticLockingFailureException e) { + throw new BusinessException(ErrorCode.RISK_EVENT_CONCURRENT_UPDATE); + } + auditService.log(operatorUserId, AUDIT_EVENT_ACTIONED, "SCORING_RISK_EVENT", ev.getId(), + eventActionAuditDetails(ev, req), ctx); + return toEventResponse(ev); + } + + private boolean isValidAction(String action) { + return "ACKNOWLEDGE".equals(action) || "DISMISS".equals(action); + } + + // ─────────────────────── 工具 ─────────────────────── + + /** 解析时间范围：默认近 7 天；任一缺失则用默认边界；校验 from<=to 与最大 90 天。 */ + private LocalDateTime[] resolveRange(LocalDateTime from, LocalDateTime to) { + LocalDateTime now = LocalDateTime.now(clock); + LocalDateTime f = from != null ? from : now.minusDays(7); + LocalDateTime t = to != null ? to : now; + if (from != null && to == null) { + t = now; + } + if (from == null && to != null) { + f = now.minusDays(7); + } + if (f.isAfter(t)) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + if (Duration.between(f, t).toDays() > MAX_RANGE_DAYS) { + throw new BusinessException(ErrorCode.RISK_INVALID_FILTER); + } + return new LocalDateTime[]{f, t}; + } + + private RiskRuleResponse toRuleResponse(ScoringRuleConfig rule) { + return RiskRuleResponse.builder() + .ruleCode(rule.getRuleCode()).sourceAction(rule.getSourceAction()) + .thresholdCount(rule.getThresholdCount()).windowMinutes(rule.getWindowMinutes()) + .severity(rule.getSeverity()).enabled(rule.getEnabled()).version(rule.getVersion()) + .build(); + } + + private RiskEventResponse toEventResponse(ScoringRiskEvent ev) { + return RiskEventResponse.builder() + .eventId(ev.getId()).ruleCode(ev.getRule().getRuleCode()) + .sourceAction(ev.getSourceAction()).severity(ev.getSeverity()) + .status(ev.getStatus()).occurrenceCount(ev.getOccurrenceCount()) + .windowStartedAt(ev.getWindowStartedAt()).windowEndedAt(ev.getWindowEndedAt()) + .detectedAt(ev.getDetectedAt()).version(ev.getVersion()) + .build(); + } + + private static String ruleUpdateAuditDetails(ScoringRuleConfig rule) { + return "{\"ruleCode\":\"" + rule.getRuleCode() + "\"" + + ",\"enabled\":" + rule.getEnabled() + + ",\"thresholdCount\":" + rule.getThresholdCount() + + ",\"windowMinutes\":" + rule.getWindowMinutes() + + ",\"severity\":\"" + rule.getSeverity() + "\"" + + ",\"version\":" + rule.getVersion() + "}"; + } + + private static String eventActionAuditDetails(ScoringRiskEvent ev, RiskEventActionRequest req) { + return "{\"riskEventId\":" + ev.getId() + + ",\"action\":\"" + req.getAction() + "\"" + + ",\"reasonCode\":\"" + req.getReasonCode() + "\"" + + ",\"version\":" + ev.getVersion() + "}"; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskAction.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskAction.java new file mode 100644 index 0000000..1f6c16b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskAction.java @@ -0,0 +1,61 @@ +package com.mydreamjob.risk; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 风险事件人工操作记录（V37）。 + * + *

    {@code operatorUserId} 仅内部存储，响应不返回。仅支持受控 {code reasonCode}： + * MONITORING / CONFIRMED_FALSE_POSITIVE / OUT_OF_BAND_ESCALATED；不提供自由文本备注， + * 避免运营备注成为新的个人信息载体。

    + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "scoring_risk_actions") +@EntityListeners(AuditingEntityListener.class) +public class ScoringRiskAction { + + public static final String ACTION_ACKNOWLEDGE = "ACKNOWLEDGE"; + public static final String ACTION_DISMISS = "DISMISS"; + + public static final String REASON_MONITORING = "MONITORING"; + public static final String REASON_CONFIRMED_FALSE_POSITIVE = "CONFIRMED_FALSE_POSITIVE"; + public static final String REASON_OUT_OF_BAND_ESCALATED = "OUT_OF_BAND_ESCALATED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "risk_event_id", nullable = false) + private Long riskEventId; + + @Column(name = "operator_user_id", nullable = false) + private Long operatorUserId; + + @Column(nullable = false, length = 20) + private String action; + + @Column(name = "reason_code", nullable = false, length = 40) + private String reasonCode; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskActionRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskActionRepository.java new file mode 100644 index 0000000..11df10d --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskActionRepository.java @@ -0,0 +1,6 @@ +package com.mydreamjob.risk; + +import org.springframework.data.jpa.repository.JpaRepository; + +public interface ScoringRiskActionRepository extends JpaRepository { +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEvent.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEvent.java new file mode 100644 index 0000000..456a1c4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEvent.java @@ -0,0 +1,106 @@ +package com.mydreamjob.risk; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.Version; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 风险事件（V37）。 + * + *

    {@code subjectUserId} 仅内部关联用户，任何 API 响应均不得返回；对外只暴露事件 ID 与 + * 规则快照字段（ruleCode/sourceAction/severity）。状态机：OPEN→ACKNOWLEDGED、OPEN→DISMISSED、 + * ACKNOWLEDGED→DISMISSED，DISMISSED 为终态。

    + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "scoring_risk_events") +@EntityListeners(AuditingEntityListener.class) +public class ScoringRiskEvent { + + public static final String STATUS_OPEN = "OPEN"; + public static final String STATUS_ACKNOWLEDGED = "ACKNOWLEDGED"; + public static final String STATUS_DISMISSED = "DISMISSED"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "rule_config_id", nullable = false) + private ScoringRuleConfig rule; + + @Column(name = "subject_user_id", nullable = false) + private Long subjectUserId; + + @Column(name = "source_audit_log_id", nullable = false) + private Long sourceAuditLogId; + + @Column(name = "source_action", nullable = false, length = 60) + private String sourceAction; + + @Column(nullable = false, length = 10) + private String severity; + + @Column(name = "window_started_at", nullable = false) + private LocalDateTime windowStartedAt; + + @Column(name = "window_ended_at", nullable = false) + private LocalDateTime windowEndedAt; + + @Column(name = "occurrence_count", nullable = false) + private Integer occurrenceCount; + + @Column(nullable = false, length = 20) + @Builder.Default + private String status = STATUS_OPEN; + + @Column(name = "detected_at", nullable = false) + private LocalDateTime detectedAt; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; + + /** 依据当前状态与目标 action 计算目标状态；非法返回 null。 */ + public static String transition(String from, String action) { + if (STATUS_DISMISSED.equals(from)) { + return null; + } + if ("ACKNOWLEDGE".equals(action)) { + return STATUS_OPEN.equals(from) ? STATUS_ACKNOWLEDGED : null; + } + if ("DISMISS".equals(action)) { + return STATUS_OPEN.equals(from) || STATUS_ACKNOWLEDGED.equals(from) ? STATUS_DISMISSED : null; + } + return null; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEventRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEventRepository.java new file mode 100644 index 0000000..dd4fe29 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskEventRepository.java @@ -0,0 +1,73 @@ +package com.mydreamjob.risk; + +import org.springframework.data.domain.Page; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; + +import java.time.LocalDateTime; +import java.util.List; + +public interface ScoringRiskEventRepository extends JpaRepository { + + // 扫描幂等：同一(rule, source_audit_log_id) 已存在视为已处理 + boolean existsByRuleIdAndSourceAuditLogId(Long ruleId, Long sourceAuditLogId); + + long countByStatusAndDetectedAtBetween(String status, LocalDateTime from, LocalDateTime to); + + @Query("SELECT e.severity, COUNT(e) FROM ScoringRiskEvent e " + + "WHERE e.status = :status AND e.detectedAt >= :from AND e.detectedAt <= :to " + + "GROUP BY e.severity ORDER BY e.severity") + List countGroupBySeverity(@Param("status") String status, + @Param("from") LocalDateTime from, + @Param("to") LocalDateTime to); + + @Query("SELECT e.rule.ruleCode, COUNT(e) FROM ScoringRiskEvent e " + + "WHERE e.status = :status AND e.detectedAt >= :from AND e.detectedAt <= :to " + + "GROUP BY e.rule.ruleCode ORDER BY e.rule.ruleCode") + List countGroupByRuleCode(@Param("status") String status, + @Param("from") LocalDateTime from, + @Param("to") LocalDateTime to); + + @Query("SELECT MAX(e.detectedAt) FROM ScoringRiskEvent e " + + "WHERE e.status = :status AND e.detectedAt >= :from AND e.detectedAt <= :to") + LocalDateTime findMaxDetectedAtByStatusBetween(@Param("status") String status, + @Param("from") LocalDateTime from, + @Param("to") LocalDateTime to); + + @Query("SELECT e.rule.ruleCode, e.severity, COUNT(e) FROM ScoringRiskEvent e " + + "WHERE e.detectedAt >= :from AND e.detectedAt <= :to " + + "GROUP BY e.rule.ruleCode, e.severity ORDER BY e.rule.ruleCode, e.severity") + List distribution(@Param("from") LocalDateTime from, @Param("to") LocalDateTime to); + + // 按天/小时聚合趋势（SQL GROUP BY projection，避免逐事件取数） + @Query("SELECT FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), " + + "FUNCTION('DAY', e.detectedAt), COUNT(e) FROM ScoringRiskEvent e " + + "WHERE e.detectedAt >= :from AND e.detectedAt <= :to " + + "GROUP BY FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), FUNCTION('DAY', e.detectedAt) " + + "ORDER BY FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), FUNCTION('DAY', e.detectedAt)") + List trendByDay(@Param("from") LocalDateTime from, @Param("to") LocalDateTime to); + + @Query("SELECT FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), " + + "FUNCTION('DAY', e.detectedAt), FUNCTION('HOUR', e.detectedAt), COUNT(e) FROM ScoringRiskEvent e " + + "WHERE e.detectedAt >= :from AND e.detectedAt <= :to " + + "GROUP BY FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), " + + "FUNCTION('DAY', e.detectedAt), FUNCTION('HOUR', e.detectedAt) " + + "ORDER BY FUNCTION('YEAR', e.detectedAt), FUNCTION('MONTH', e.detectedAt), " + + "FUNCTION('DAY', e.detectedAt), FUNCTION('HOUR', e.detectedAt)") + List trendByHour(@Param("from") LocalDateTime from, @Param("to") LocalDateTime to); + + @Query("SELECT e FROM ScoringRiskEvent e JOIN FETCH e.rule r " + + "WHERE (:status IS NULL OR e.status = :status) " + + "AND (:severity IS NULL OR e.severity = :severity) " + + "AND (:ruleCode IS NULL OR r.ruleCode = :ruleCode) " + + "AND e.detectedAt >= :from AND e.detectedAt <= :to " + + "ORDER BY e.detectedAt DESC, e.id DESC") + Page search(@Param("status") String status, + @Param("severity") String severity, + @Param("ruleCode") String ruleCode, + @Param("from") LocalDateTime from, + @Param("to") LocalDateTime to, + Pageable pageable); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpoint.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpoint.java new file mode 100644 index 0000000..80ee31a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpoint.java @@ -0,0 +1,54 @@ +package com.mydreamjob.risk; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.Version; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 风险扫描游标（V37）。只维护一条 {@code checkpoint_key=RISK_EVENT_DETECTOR}，持久化已成功消费的 + * 最大 {@code audit_logs.id}，解决应用重启或扫描耗时导致的事件遗漏。 + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "scoring_risk_scan_checkpoints") +@EntityListeners(AuditingEntityListener.class) +public class ScoringRiskScanCheckpoint { + + public static final String KEY_RISK_EVENT_DETECTOR = "RISK_EVENT_DETECTOR"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "checkpoint_key", nullable = false, length = 40) + private String checkpointKey; + + @Column(name = "last_audit_log_id", nullable = false) + @Builder.Default + private Long lastAuditLogId = 0L; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpointRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpointRepository.java new file mode 100644 index 0000000..a5590fb --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRiskScanCheckpointRepository.java @@ -0,0 +1,19 @@ +package com.mydreamjob.risk; + +import jakarta.persistence.LockModeType; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Lock; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; + +import java.util.Optional; + +public interface ScoringRiskScanCheckpointRepository extends JpaRepository { + + Optional findByCheckpointKey(String checkpointKey); + + /** 悲观写锁：同一时间只允许一个扫描事务消费审计增量，避免并发扫描重复建事件。 */ + @Lock(LockModeType.PESSIMISTIC_WRITE) + @Query("SELECT c FROM ScoringRiskScanCheckpoint c WHERE c.checkpointKey = :key") + Optional findByCheckpointKeyForUpdate(@Param("key") String key); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfig.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfig.java new file mode 100644 index 0000000..6cad592 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfig.java @@ -0,0 +1,78 @@ +package com.mydreamjob.risk; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.Version; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** + * 风险规则配置（V37）。 + * + *

    {@code source_action} 仅允许 {@code REPORT_RATE_LIMITED}/{@code BLOCKED_SEND_PROHIBITED}； + * 规则更新只影响后续扫描，不回溯、不删除既有事件。

    + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "scoring_rule_configs") +@EntityListeners(AuditingEntityListener.class) +public class ScoringRuleConfig { + + public static final String SEVERITY_LOW = "LOW"; + public static final String SEVERITY_MEDIUM = "MEDIUM"; + public static final String SEVERITY_HIGH = "HIGH"; + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "rule_code", nullable = false, length = 60) + private String ruleCode; + + @Column(name = "source_action", nullable = false, length = 60) + private String sourceAction; + + @Column(name = "threshold_count", nullable = false) + private Integer thresholdCount; + + @Column(name = "window_minutes", nullable = false) + private Integer windowMinutes; + + @Column(nullable = false, length = 10) + private String severity; + + @Column(nullable = false) + @JdbcTypeCode(SqlTypes.TINYINT) + @Builder.Default + private Boolean enabled = true; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfigRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfigRepository.java new file mode 100644 index 0000000..f3826e4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/ScoringRuleConfigRepository.java @@ -0,0 +1,15 @@ +package com.mydreamjob.risk; + +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; +import java.util.Optional; + +public interface ScoringRuleConfigRepository extends JpaRepository { + + Optional findByRuleCode(String ruleCode); + + List findAllByEnabledTrue(); + + List findAllByOrderByRuleCodeAsc(); +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskDistributionResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskDistributionResponse.java new file mode 100644 index 0000000..5b8c209 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskDistributionResponse.java @@ -0,0 +1,23 @@ +package com.mydreamjob.risk.dto; + +import lombok.Builder; +import lombok.Data; + +import java.util.List; + +/** + * 风险分布（V37）：按规则与风险等级聚合。 + */ +@Data +@Builder +public class RiskDistributionResponse { + private List items; + + @Data + @Builder + public static class DistributionRow { + private String ruleCode; + private String severity; + private Long count; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventActionRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventActionRequest.java new file mode 100644 index 0000000..5ab36f4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventActionRequest.java @@ -0,0 +1,22 @@ +package com.mydreamjob.risk.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import lombok.Data; + +/** + * 风险事件人工操作请求（V37）。{@code action} 仅 ACKNOWLEDGE/DISMISS， + * {@code reasonCode} 仅 MONITORING/CONFIRMED_FALSE_POSITIVE/OUT_OF_BAND_ESCALATED。 + */ +@Data +public class RiskEventActionRequest { + + @NotBlank + private String action; + + @NotBlank + private String reasonCode; + + @NotNull + private Long expectedVersion; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventResponse.java new file mode 100644 index 0000000..a6610bf --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskEventResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.risk.dto; + +import lombok.Builder; +import lombok.Data; + +import java.time.LocalDateTime; + +/** + * 风险事件响应（V37）白名单。严禁返回 subjectUserId/phone/email/ipAddress/userAgent/details/requestId/token。 + */ +@Data +@Builder +public class RiskEventResponse { + private Long eventId; + private String ruleCode; + private String sourceAction; + private String severity; + private String status; + private Integer occurrenceCount; + private LocalDateTime windowStartedAt; + private LocalDateTime windowEndedAt; + private LocalDateTime detectedAt; + private Long version; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskOverviewResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskOverviewResponse.java new file mode 100644 index 0000000..5b4a22e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskOverviewResponse.java @@ -0,0 +1,33 @@ +package com.mydreamjob.risk.dto; + +import lombok.Builder; +import lombok.Data; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * 风险概览（V37）：时间范围内 OPEN 总数、等级分布、规则分布、最近检测时间。 + */ +@Data +@Builder +public class RiskOverviewResponse { + private Long openCount; + private List bySeverity; + private List byRule; + private LocalDateTime lastDetectedAt; + + @Data + @Builder + public static class SeverityCount { + private String severity; + private Long count; + } + + @Data + @Builder + public static class RuleCount { + private String ruleCode; + private Long count; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleResponse.java new file mode 100644 index 0000000..5be5d1e --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleResponse.java @@ -0,0 +1,19 @@ +package com.mydreamjob.risk.dto; + +import lombok.Builder; +import lombok.Data; + +/** + * 规则响应（V37）。 + */ +@Data +@Builder +public class RiskRuleResponse { + private String ruleCode; + private String sourceAction; + private Integer thresholdCount; + private Integer windowMinutes; + private String severity; + private Boolean enabled; + private Long version; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleUpdateRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleUpdateRequest.java new file mode 100644 index 0000000..9d11879 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskRuleUpdateRequest.java @@ -0,0 +1,32 @@ +package com.mydreamjob.risk.dto; + +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotNull; +import lombok.Data; + +/** + * 规则更新请求（V37）。不允许修改 {@code ruleCode}/{@code sourceAction}。 + */ +@Data +public class RiskRuleUpdateRequest { + + @NotNull + private Boolean enabled; + + @NotNull + @Min(1) + @Max(100) + private Integer thresholdCount; + + @NotNull + @Min(1) + @Max(1440) + private Integer windowMinutes; + + @NotNull + private String severity; + + @NotNull + private Long expectedVersion; +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskTrendResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskTrendResponse.java new file mode 100644 index 0000000..5a75bde --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/risk/dto/RiskTrendResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.risk.dto; + +import lombok.Builder; +import lombok.Data; + +import java.time.LocalDateTime; +import java.util.List; + +/** + * 风险趋势（V37）：bucket 仅 HOUR/DAY，SQL GROUP BY 聚合。 + */ +@Data +@Builder +public class RiskTrendResponse { + private String bucket; + private List items; + + @Data + @Builder + public static class TrendPoint { + private LocalDateTime time; + private Long count; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/safety/AdminReportController.java b/mydreamjob-server/src/main/java/com/mydreamjob/safety/AdminReportController.java index 067fa6d..626b1a8 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/safety/AdminReportController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/safety/AdminReportController.java @@ -17,8 +17,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; /** @@ -32,6 +30,13 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class AdminReportController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + /** R01-B：角色授权统一委托给公共 guard，本类不再自行比较角色。 */ + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final ReportService reportService; private final UserRepository userRepository; @@ -54,7 +59,7 @@ public class AdminReportController { Page result = reportService.adminList(status, targetType, category, page, size); return ResponseEntity.ok(ApiResponse.ok(PageResponse.of( result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), - requestId(request))); + requestIdAccessor.get(request))); } @Operation(summary = "举报详情（ADMIN）", @@ -70,7 +75,7 @@ public class AdminReportController { public ResponseEntity> adminDetail(@PathVariable Long id, HttpServletRequest request) { requireAdmin(request); - return ResponseEntity.ok(ApiResponse.ok(reportService.adminDetail(id), requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(reportService.adminDetail(id), requestIdAccessor.get(request))); } @Operation(summary = "举报处理决定（ADMIN）", @@ -95,29 +100,17 @@ public class AdminReportController { ? (admin.getRole() == null ? "ADMIN" : admin.getRole().name()) : "ADMIN"; ReportResponse data = reportService.decide(adminUserId, role, id, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } + /** + * R01-B/B1：身份来自 {@link com.mydreamjob.security.CurrentUserAccessor}， + * 角色授权委托给公共 {@link com.mydreamjob.security.UserRoleGuard}。 + */ private Long requireAdmin(HttpServletRequest request) { - Long userId = resolveUserId(request); - User admin = userRepository.findById(userId).orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - boolean isAdmin = admin.getRoles() != null - && admin.getRoles().stream().anyMatch(r -> r == User.Role.ADMIN); - if (!isAdmin) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + Long userId = currentUserAccessor.requireUserId(); + userRoleGuard.requireAdmin(userId); return userId; } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String requestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/safety/BlockController.java b/mydreamjob-server/src/main/java/com/mydreamjob/safety/BlockController.java index 5dd597b..37482d2 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/safety/BlockController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/safety/BlockController.java @@ -13,8 +13,6 @@ import jakarta.servlet.http.HttpServletRequest; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; /** @@ -26,6 +24,11 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class BlockController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final BlockService blockService; @Operation(summary = "屏蔽用户", @@ -40,9 +43,9 @@ public class BlockController { @PutMapping("/blocks/{blockedUserId}") public ResponseEntity> block( @PathVariable Long blockedUserId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); BlockRelationResponse data = blockService.block(userId, blockedUserId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } @Operation(summary = "解除屏蔽", @@ -55,9 +58,9 @@ public class BlockController { @DeleteMapping("/blocks/{blockedUserId}") public ResponseEntity> unblock( @PathVariable Long blockedUserId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); blockService.unblock(userId, blockedUserId, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(null, requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(null, requestIdAccessor.get(request))); } @Operation(summary = "我的屏蔽列表", @@ -71,22 +74,11 @@ public class BlockController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page result = blockService.listMine(userId, page, size); return ResponseEntity.ok(ApiResponse.ok(PageResponse.of( result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), - requestId(request))); - } - - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); + requestIdAccessor.get(request))); } - private String requestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/safety/ReportController.java b/mydreamjob-server/src/main/java/com/mydreamjob/safety/ReportController.java index c2d047c..f21687f 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/safety/ReportController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/safety/ReportController.java @@ -17,8 +17,6 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; /** @@ -32,6 +30,11 @@ import org.springframework.web.bind.annotation.*; @RequiredArgsConstructor public class ReportController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final ReportService reportService; private final UserRepository userRepository; @@ -51,9 +54,9 @@ public class ReportController { @PostMapping("/reports") public ResponseEntity> create( @Valid @RequestBody CreateReportRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ReportResponse data = reportService.create(userId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(data, requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } /** /reports/me 必须在 /reports/{id} 之前注册（路由回归测试覆盖） */ @@ -69,11 +72,11 @@ public class ReportController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); Page result = reportService.listMine(userId, status, page, size); return ResponseEntity.ok(ApiResponse.ok(PageResponse.of( result.getContent(), result.getTotalElements(), result.getNumber(), result.getSize()), - requestId(request))); + requestIdAccessor.get(request))); } @Operation(summary = "我的举报详情", @@ -88,9 +91,9 @@ public class ReportController { @GetMapping("/reports/{id}") public ResponseEntity> getDetail( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); ReportResponse data = reportService.getDetail(userId, id, isAdmin(userId)); - return ResponseEntity.ok(ApiResponse.ok(data, requestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } private boolean isAdmin(Long userId) { @@ -100,15 +103,4 @@ public class ReportController { .orElse(false); } - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) { - throw new BusinessException(ErrorCode.UNAUTHORIZED); - } - return Long.valueOf(auth.getName()); - } - - private String requestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuard.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuard.java new file mode 100644 index 0000000..15f4482 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuard.java @@ -0,0 +1,67 @@ +package com.mydreamjob.scoringmonitoring; + +import java.util.Collection; +import java.util.HashSet; +import java.util.Set; + +/** + * V43 统一小样本与互补抑制规则。 + * + *

    所有集合大小都必须是独立候选人数；事件数不能绕过本组件。

    + */ +public final class FairnessDisclosureGuard { + public static final int MIN_INDEPENDENT_CANDIDATES = 30; + + private FairnessDisclosureGuard() {} + + public static boolean isSmallCell(int count) { + return count > 0 && count < MIN_INDEPENDENT_CANDIDATES; + } + + public static boolean isSmallComplement(int numerator, int denominator) { + int complement = denominator - numerator; + return complement > 0 && complement < MIN_INDEPENDENT_CANDIDATES; + } + + /** 判断一个比率分母及其对应集合是否安全可披露。 */ + public static boolean suppressRatio(int denominator, int numerator) { + return denominator < MIN_INDEPENDENT_CANDIDATES + || isSmallCell(numerator) + || isSmallComplement(numerator, denominator); + } + + /** 判断多个互斥/细分集合；任一小单元即整组抑制，避免通过总计反推。 */ + public static boolean suppressCells(int denominator, Collection cellCounts, + boolean checkComplement) { + if (denominator < MIN_INDEPENDENT_CANDIDATES) return true; + if (cellCounts == null) return false; + for (Integer value : cellCounts) { + if (value == null) continue; + if (isSmallCell(value)) return true; + if (checkComplement && isSmallComplement(value, denominator)) return true; + } + return false; + } + + /** + * Set-aware variant for overlapping groups (for example, one candidate can + * have appeals in more than one status). Complements are calculated from + * the actual universe rather than {@code denominator - cellSize}; callers + * must never use arithmetic subtraction for overlapping populations. + */ + public static boolean suppressSetCells(Set universe, Collection> cells, + boolean checkComplement) { + if (universe == null || universe.size() < MIN_INDEPENDENT_CANDIDATES) return true; + if (cells == null) return false; + for (Set cell : cells) { + if (cell == null) continue; + if (isSmallCell(cell.size())) return true; + if (checkComplement) { + Set complement = new HashSet<>(universe.size()); + for (Object value : universe) if (!cell.contains(value)) complement.add(value); + if (isSmallCell(complement.size())) return true; + } + } + return false; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringController.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringController.java new file mode 100644 index 0000000..90ee146 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringController.java @@ -0,0 +1,83 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +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.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.time.LocalDate; +import java.time.format.DateTimeParseException; +import java.util.Set; + +@Tag(name = "评分公平性监测", description = "ADMIN 只读聚合监测；不返回候选人或申诉身份信息") +@RestController +@RequestMapping("/admin/scoring/fairness") +@RequiredArgsConstructor +public class FairnessMonitoringController { + + /** R01-A6：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A6：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final FairnessMonitoringService service; + + @Operation(summary = "评分完整性概览", description = "仅 ADMIN；按现存月度快照聚合，样本不足时隐藏统计明细") + @GetMapping("/overview") + public ResponseEntity> overview( + @RequestParam String period, HttpServletRequest request) { + checkParams(request, Set.of("period")); + return ResponseEntity.ok(ApiResponse.ok(service.overview(currentUserAccessor.requireUserId(), period), requestIdAccessor.get(request))); + } + + @Operation(summary = "评分维度分布", description = "仅 ADMIN；dimension 仅允许八个评分维度") + @GetMapping("/dimensions") + public ResponseEntity> dimensions( + @RequestParam String period, @RequestParam(required = false) String dimension, HttpServletRequest request) { + checkParams(request, Set.of("period", "dimension")); + return ResponseEntity.ok(ApiResponse.ok(service.dimensions(currentUserAccessor.requireUserId(), period, dimension), requestIdAccessor.get(request))); + } + + @Operation(summary = "评分历史漂移", description = "仅 ADMIN；当前快照可覆盖，历史漂移暂不可计算") + @GetMapping("/drift") + public ResponseEntity> drift(HttpServletRequest request) { + checkParams(request, Set.of()); + return ResponseEntity.ok(ApiResponse.ok(service.drift(currentUserAccessor.requireUserId()), requestIdAccessor.get(request))); + } + + @Operation(summary = "排名稳定性", description = "仅 ADMIN；当前没有持久化排名快照，返回 UNAVAILABLE") + @GetMapping("/ranking-stability") + public ResponseEntity> rankingStability(HttpServletRequest request) { + checkParams(request, Set.of()); + return ResponseEntity.ok(ApiResponse.ok(service.rankingStability(currentUserAccessor.requireUserId()), requestIdAccessor.get(request))); + } + + @Operation(summary = "申诉纠错聚合", description = "仅 ADMIN；按申诉创建队列聚合，隐藏小样本明细") + @GetMapping("/appeals") + public ResponseEntity> appeals( + @RequestParam(required = false) String from, @RequestParam(required = false) String to, + HttpServletRequest request) { + checkParams(request, Set.of("from", "to")); + return ResponseEntity.ok(ApiResponse.ok(service.appeals(currentUserAccessor.requireUserId(), parseDate(from), parseDate(to)), requestIdAccessor.get(request))); + } + + private LocalDate parseDate(String value) { + if (value == null) return null; + try { return LocalDate.parse(value); } + catch (DateTimeParseException e) { throw new BusinessException(ErrorCode.BAD_REQUEST, "date must be yyyy-MM-dd"); } + } + + private void checkParams(HttpServletRequest request, Set allowed) { + for (String name : request.getParameterMap().keySet()) { + if (!allowed.contains(name)) throw new BusinessException(ErrorCode.BAD_REQUEST, "unsupported parameter: " + name); + } + } + +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringRepository.java new file mode 100644 index 0000000..5bee6fd --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringRepository.java @@ -0,0 +1,243 @@ +package com.mydreamjob.scoringmonitoring; + +import lombok.RequiredArgsConstructor; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; +import org.springframework.stereotype.Repository; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.sql.PreparedStatement; +import java.time.LocalDateTime; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** V43 只读数据入口。SQL 只取标量并设置局部超时，不读取答案或详情 JSON。 */ +@Repository +@RequiredArgsConstructor +public class FairnessMonitoringRepository { + private final JdbcTemplate jdbcTemplate; + + /** + * 总览专用聚合入口：先在数据库按候选人归并所有现存维度，再返回总体 + * 计数和综合分频数。不会把候选人×维度明细加载到服务层。 + */ + public OverviewAggregateData findOverviewAggregateData(String period) { + String candidateSummary = "SELECT student_user_id, " + + "COUNT(DISTINCT COALESCE(rules_version, '__UNKNOWN__')) AS version_count, " + + "MIN(COALESCE(rules_version, '__UNKNOWN__')) AS one_version, " + + "MAX(CASE WHEN (status IN ('OK','ESTIMATED') AND score IS NOT NULL " + + "AND score >= 0 AND score <= 100) THEN 1 ELSE 0 END) AS has_valid " + + "FROM candidate_dimension_scores WHERE period = ? GROUP BY student_user_id"; + List summaries = queryWithTimeout( + "SELECT COUNT(*) AS population_size, " + + "COALESCE(SUM(has_valid), 0) AS computable_count, " + + "COALESCE(SUM(CASE WHEN version_count > 1 THEN 1 ELSE 0 END), 0) AS mixed_count, " + + "COALESCE(SUM(CASE WHEN version_count = 1 AND one_version NOT IN " + + "('candidate-scoring-v0.1','candidate-scoring-v0.2') THEN 1 ELSE 0 END), 0) AS unknown_count, " + + "COALESCE(SUM(CASE WHEN version_count = 1 AND one_version = 'candidate-scoring-v0.1' THEN 1 ELSE 0 END), 0) AS v01_count, " + + "COALESCE(SUM(CASE WHEN version_count = 1 AND one_version = 'candidate-scoring-v0.2' THEN 1 ELSE 0 END), 0) AS v02_count " + + "FROM (" + candidateSummary + ") candidate_summary", + (rs, rowNum) -> new OverviewSummaryRow(rs.getInt("population_size"), + rs.getInt("computable_count"), rs.getInt("mixed_count"), + rs.getInt("unknown_count"), rs.getInt("v01_count"), rs.getInt("v02_count")), period); + + String candidateScores = "SELECT student_user_id, " + + "CASE WHEN COUNT(DISTINCT COALESCE(rules_version, '__UNKNOWN__')) = 1 " + + "AND MIN(COALESCE(rules_version, '__UNKNOWN__')) IN " + + "('candidate-scoring-v0.1','candidate-scoring-v0.2') " + + "THEN MIN(COALESCE(rules_version, '__UNKNOWN__')) ELSE NULL END AS coherent_version, " + + "AVG(CASE WHEN status IN ('OK','ESTIMATED') AND score IS NOT NULL " + + "AND score >= 0 AND score <= 100 THEN score ELSE NULL END) AS overall_score " + + "FROM candidate_dimension_scores WHERE period = ? GROUP BY student_user_id"; + List frequencies = queryWithTimeout( + "SELECT coherent_version, overall_score, COUNT(*) AS candidate_count " + + "FROM (" + candidateScores + ") candidate_scores " + + "WHERE coherent_version IS NOT NULL AND overall_score IS NOT NULL " + + "GROUP BY coherent_version, overall_score", + (rs, rowNum) -> new OverviewFrequencyRow(rs.getString("coherent_version"), + scaleScore(rs.getBigDecimal("overall_score")), rs.getInt("candidate_count")), period); + + OverviewSummaryRow summary = summaries.isEmpty() + ? new OverviewSummaryRow(0, 0, 0, 0, 0, 0) : summaries.get(0); + Map> byVersion = new LinkedHashMap<>(); + byVersion.put("candidate-scoring-v0.1", new java.util.ArrayList<>()); + byVersion.put("candidate-scoring-v0.2", new java.util.ArrayList<>()); + frequencies.forEach(row -> byVersion.computeIfAbsent(row.version(), ignored -> new java.util.ArrayList<>()) + .add(new FairnessStatisticsCalculator.ScoreFrequency(row.score(), row.candidateCount()))); + Map versions = new LinkedHashMap<>(); + versions.put("candidate-scoring-v0.1", summary.v01Count()); + versions.put("candidate-scoring-v0.2", summary.v02Count()); + versions.put("UNKNOWN", summary.unknownCount()); + versions.put("MIXED", summary.mixedCount()); + return new OverviewAggregateData(summary.populationSize(), summary.computableCount(), + versions, byVersion); + } + + /** + * Final appeal aggregate. The candidate/appeal identifiers exist only in + * nested SQL relations and never cross the repository boundary. All + * denominators are COUNT(DISTINCT candidate_user_id), while rollback rows + * remain event-level for change-rate and delta statistics. + */ + public AppealAggregateSummary findAppealAggregateSummary(LocalDateTime from, LocalDateTime to) { + String sql = "WITH appeal_base AS (" + + " SELECT id, candidate_user_id, dimension, period, status FROM candidate_scoring_appeals" + + " WHERE created_at >= ? AND created_at < ?)," + + " appeal_groups AS (SELECT candidate_user_id, dimension, period, COUNT(*) AS group_count" + + " FROM appeal_base GROUP BY candidate_user_id, dimension, period)," + + " rollback_counts AS (SELECT h.appeal_id, COUNT(*) AS history_count" + + " FROM candidate_scoring_snapshot_history h JOIN appeal_base a ON a.id=h.appeal_id" + + " WHERE h.action='ROLLBACK' GROUP BY h.appeal_id)," + + " rollback_one AS (SELECT h.appeal_id, a.candidate_user_id, h.before_score, h.after_score," + + " h.before_rules_version, h.after_rules_version" + + " FROM candidate_scoring_snapshot_history h JOIN rollback_counts rc ON rc.appeal_id=h.appeal_id" + + " JOIN appeal_base a ON a.id=h.appeal_id WHERE h.action='ROLLBACK' AND rc.history_count=1)," + + " classified AS (SELECT appeal_id, candidate_user_id," + + " CASE WHEN before_score IS NULL OR after_score IS NULL OR before_score<0 OR before_score>100" + + " OR after_score<0 OR after_score>100 THEN 'INVALID_SCORE'" + + " WHEN before_rules_version IS NULL OR after_rules_version IS NULL" + + " OR before_rules_version NOT IN ('candidate-scoring-v0.1','candidate-scoring-v0.2')" + + " OR after_rules_version<>before_rules_version THEN 'RULE_VERSION_CHANGED' ELSE 'COMPARABLE' END AS reason," + + " CASE WHEN before_score IS NOT NULL AND after_score IS NOT NULL AND before_score BETWEEN 0 AND 100" + + " AND after_score BETWEEN 0 AND 100 AND before_rules_version IN ('candidate-scoring-v0.1','candidate-scoring-v0.2')" + + " AND after_rules_version=before_rules_version THEN 1 ELSE 0 END AS comparable," + + " CASE WHEN before_score IS NOT NULL AND after_score IS NOT NULL AND before_score BETWEEN 0 AND 100" + + " AND after_score BETWEEN 0 AND 100 AND before_rules_version IN ('candidate-scoring-v0.1','candidate-scoring-v0.2')" + + " AND after_rules_version=before_rules_version AND after_score<>before_score THEN 1 ELSE 0 END AS changed," + + " CASE WHEN before_score IS NOT NULL AND after_score IS NOT NULL AND before_score BETWEEN 0 AND 100" + + " AND after_score BETWEEN 0 AND 100 AND before_rules_version IN ('candidate-scoring-v0.1','candidate-scoring-v0.2')" + + " AND after_rules_version=before_rules_version THEN after_score-before_score ELSE NULL END AS delta," + + " CASE WHEN before_score IS NOT NULL AND after_score IS NOT NULL AND before_score BETWEEN 0 AND 100" + + " AND after_score BETWEEN 0 AND 100 AND before_rules_version IN ('candidate-scoring-v0.1','candidate-scoring-v0.2')" + + " AND after_rules_version=before_rules_version THEN ABS(after_score-before_score) ELSE NULL END AS abs_delta" + + " FROM rollback_one)," + + " candidate_flags AS (SELECT a.candidate_user_id," + + " MAX(CASE WHEN ag.group_count>1 THEN 1 ELSE 0 END) AS duplicate_appeal," + + " MAX(CASE WHEN rc.history_count>1 THEN 1 ELSE 0 END) AS duplicate_history," + + " MAX(CASE WHEN c.reason='INVALID_SCORE' THEN 1 ELSE 0 END) AS invalid_score," + + " MAX(CASE WHEN c.reason='RULE_VERSION_CHANGED' THEN 1 ELSE 0 END) AS version_changed," + + " MAX(CASE WHEN c.changed=1 THEN 1 ELSE 0 END) AS changed," + + " MAX(CASE WHEN c.comparable=1 AND c.changed=0 THEN 1 ELSE 0 END) AS unchanged" + + " FROM appeal_base a LEFT JOIN appeal_groups ag ON ag.candidate_user_id=a.candidate_user_id" + + " AND ag.dimension=a.dimension AND ag.period=a.period" + + " LEFT JOIN rollback_counts rc ON rc.appeal_id=a.id" + + " LEFT JOIN classified c ON c.appeal_id=a.id GROUP BY a.candidate_user_id)," + + " rollback_aggregate AS (SELECT" + + " COALESCE(SUM(c.comparable),0) AS comparable_rows," + + " COUNT(DISTINCT CASE WHEN c.comparable=1 THEN c.candidate_user_id END) AS comparable_candidates," + + " COALESCE(SUM(c.changed),0) AS changed_rows," + + " COUNT(DISTINCT CASE WHEN c.changed=1 THEN c.candidate_user_id END) AS changed_candidates," + + " COALESCE(SUM(c.delta),0) AS delta_sum, COALESCE(SUM(c.abs_delta),0) AS abs_delta_sum" + + " FROM classified c)" + + " SELECT" + + " (SELECT COUNT(*) FROM appeal_base) AS appeal_count," + + " (SELECT COUNT(DISTINCT candidate_user_id) FROM appeal_base) AS sample_size," + + " (SELECT COALESCE(SUM(CASE WHEN status='PENDING' THEN 1 ELSE 0 END),0) FROM appeal_base) AS pending_events," + + " (SELECT COALESCE(SUM(CASE WHEN status='APPROVED' THEN 1 ELSE 0 END),0) FROM appeal_base) AS approved_events," + + " (SELECT COALESCE(SUM(CASE WHEN status='REJECTED' THEN 1 ELSE 0 END),0) FROM appeal_base) AS rejected_events," + + " (SELECT COALESCE(SUM(CASE WHEN status='CANCELLED' THEN 1 ELSE 0 END),0) FROM appeal_base) AS cancelled_events," + + " (SELECT COALESCE(SUM(CASE WHEN status='ROLLED_BACK' THEN 1 ELSE 0 END),0) FROM appeal_base) AS rolled_back_events," + + " (SELECT COALESCE(SUM(CASE WHEN status NOT IN ('PENDING','APPROVED','REJECTED','CANCELLED','ROLLED_BACK') THEN 1 ELSE 0 END),0) FROM appeal_base) AS unknown_events," + + " (SELECT COUNT(DISTINCT CASE WHEN status='PENDING' THEN candidate_user_id END) FROM appeal_base) AS pending_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status='APPROVED' THEN candidate_user_id END) FROM appeal_base) AS approved_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status='REJECTED' THEN candidate_user_id END) FROM appeal_base) AS rejected_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status='CANCELLED' THEN candidate_user_id END) FROM appeal_base) AS cancelled_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status='ROLLED_BACK' THEN candidate_user_id END) FROM appeal_base) AS rolled_back_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status NOT IN ('PENDING','APPROVED','REJECTED','CANCELLED','ROLLED_BACK') THEN candidate_user_id END) FROM appeal_base) AS unknown_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status IN ('APPROVED','ROLLED_BACK') THEN candidate_user_id END) FROM appeal_base) AS approved_ever_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN status IN ('APPROVED','ROLLED_BACK','REJECTED') THEN candidate_user_id END) FROM appeal_base) AS approval_denominator," + + " (SELECT COUNT(DISTINCT CASE WHEN duplicate_appeal=1 THEN candidate_user_id END) FROM candidate_flags) AS duplicate_appeal_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN duplicate_history=1 THEN candidate_user_id END) FROM candidate_flags) AS duplicate_history_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN invalid_score=1 THEN candidate_user_id END) FROM candidate_flags) AS invalid_score_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN version_changed=1 THEN candidate_user_id END) FROM candidate_flags) AS version_changed_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN changed=1 THEN candidate_user_id END) FROM candidate_flags) AS changed_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN unchanged=1 THEN candidate_user_id END) FROM candidate_flags) AS unchanged_candidates," + + " (SELECT COUNT(DISTINCT CASE WHEN changed=1 AND unchanged=1 THEN candidate_user_id END) FROM candidate_flags) AS changed_unchanged_intersection," + + " ra.comparable_rows, ra.comparable_candidates, ra.changed_rows, ra.changed_candidates, ra.delta_sum, ra.abs_delta_sum" + + " FROM rollback_aggregate ra"; + List result = queryWithTimeout(sql, (rs, rowNum) -> new AppealAggregateSummary( + rs.getInt("appeal_count"), rs.getInt("sample_size"), + statusMap(rs.getInt("pending_events"), rs.getInt("approved_events"), rs.getInt("rejected_events"), + rs.getInt("cancelled_events"), rs.getInt("rolled_back_events"), rs.getInt("unknown_events")), + statusMap(rs.getInt("pending_candidates"), rs.getInt("approved_candidates"), rs.getInt("rejected_candidates"), + rs.getInt("cancelled_candidates"), rs.getInt("rolled_back_candidates"), rs.getInt("unknown_candidates")), + rs.getInt("approved_ever_candidates"), rs.getInt("approval_denominator"), + rs.getInt("rolled_back_candidates"), rs.getInt("duplicate_appeal_candidates"), + rs.getInt("comparable_rows"), rs.getInt("comparable_candidates"), rs.getInt("changed_rows"), + rs.getInt("changed_candidates"), rs.getInt("unchanged_candidates"), + rs.getInt("changed_unchanged_intersection"), rs.getBigDecimal("delta_sum"), rs.getBigDecimal("abs_delta_sum"), + rs.getInt("duplicate_history_candidates"), rs.getInt("invalid_score_candidates"), rs.getInt("version_changed_candidates")), from, to); + return result.isEmpty() ? AppealAggregateSummary.empty() : result.get(0); + } + + private static Map statusMap(int pending, int approved, int rejected, int cancelled, int rolledBack, int unknown) { + Map map = new LinkedHashMap<>(); + map.put("PENDING", pending); map.put("APPROVED", approved); map.put("REJECTED", rejected); + map.put("CANCELLED", cancelled); map.put("ROLLED_BACK", rolledBack); map.put("UNKNOWN", unknown); + return map; + } + + /** 维度/状态/规则/分数的数据库频数聚合；candidate_count 为 distinct candidate。 */ + public List findSnapshotAggregates(String period) { + return queryWithTimeout("SELECT dimension, status, rules_version, score, " + + "COUNT(DISTINCT student_user_id) AS candidate_count " + + "FROM candidate_dimension_scores WHERE period = ? " + + "GROUP BY dimension, status, rules_version, score", + (rs, rowNum) -> new SnapshotAggregateRow(rs.getString("dimension"), rs.getString("status"), + rs.getString("rules_version"), rs.getBigDecimal("score"), rs.getInt("candidate_count")), period); + } + + public int findSnapshotPopulation(String period) { + List result = queryWithTimeout( + "SELECT COUNT(DISTINCT student_user_id) AS candidate_count " + + "FROM candidate_dimension_scores WHERE period = ?", + (rs, rowNum) -> rs.getInt("candidate_count"), period); + return result.isEmpty() ? 0 : result.get(0); + } + + private List queryWithTimeout(String sql, RowMapper mapper, Object... args) { + return jdbcTemplate.query(connection -> { + PreparedStatement statement = connection.prepareStatement(sql); + statement.setQueryTimeout(5); + for (int i = 0; i < args.length; i++) statement.setObject(i + 1, args[i]); + return statement; + }, mapper); + } + + private static BigDecimal scaleScore(BigDecimal score) { + return score == null ? null : score.setScale(2, RoundingMode.HALF_UP); + } + + record SnapshotAggregateRow(String dimension, String status, String rulesVersion, BigDecimal score, int candidateCount) {} + + record OverviewAggregateData(int populationSize, int computableCount, Map versionCounts, + Map> frequenciesByVersion) { + static OverviewAggregateData empty() { + Map versions = new LinkedHashMap<>(); + versions.put("candidate-scoring-v0.1", 0); versions.put("candidate-scoring-v0.2", 0); + versions.put("UNKNOWN", 0); versions.put("MIXED", 0); + Map> frequencies = new LinkedHashMap<>(); + frequencies.put("candidate-scoring-v0.1", List.of()); frequencies.put("candidate-scoring-v0.2", List.of()); + return new OverviewAggregateData(0, 0, versions, frequencies); + } + } + record AppealAggregateSummary(int appealCount, int sampleSize, Map statusEventCounts, + Map statusCandidateCounts, int approvedEverCount, + int approvalDenominatorCount, int rolledBackCandidateCount, + int duplicateAppealCandidateCount, int comparableRollbackCount, + int comparableRollbackCandidateCount, int changedCount, int changedCandidateCount, + int unchangedCandidateCount, int changedUnchangedIntersectionCount, + BigDecimal deltaSum, BigDecimal absDeltaSum, + int duplicateRollbackHistoryCount, int invalidScoreRollbackCount, + int ruleVersionChangedRollbackCount) { + static AppealAggregateSummary empty() { + return new AppealAggregateSummary(0, 0, statusMap(0, 0, 0, 0, 0, 0), statusMap(0, 0, 0, 0, 0, 0), + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, BigDecimal.ZERO, BigDecimal.ZERO, 0, 0, 0); + } + } + private record OverviewSummaryRow(int populationSize, int computableCount, int mixedCount, int unknownCount, + int v01Count, int v02Count) {} + private record OverviewFrequencyRow(String version, BigDecimal score, int candidateCount) {} +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringService.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringService.java new file mode 100644 index 0000000..e0d5bac --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringService.java @@ -0,0 +1,353 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.Instant; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.time.format.DateTimeFormatter; +import java.time.format.DateTimeParseException; +import java.time.temporal.ChronoUnit; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +@Service +@RequiredArgsConstructor +public class FairnessMonitoringService { + private static final ZoneId ZONE = ZoneId.of("Asia/Shanghai"); + private static final DateTimeFormatter PERIOD = DateTimeFormatter.ofPattern("yyyy-MM"); + private static final Set DIMENSIONS = Set.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + private static final Set KNOWN_RULES = Set.of("candidate-scoring-v0.1", "candidate-scoring-v0.2"); + private static final Set KNOWN_STATUSES = Set.of("OK", "ESTIMATED", "PENDING", "INSUFFICIENT_DATA"); + + private final FairnessMonitoringRepository repository; + private final UserRepository userRepository; + + public void assertAdmin(Long userId) { + User user = userRepository.findById(userId).orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); + if (user.getRoles() == null || user.getRoles().stream().noneMatch(r -> r == User.Role.ADMIN)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + } + + @Transactional(readOnly = true) + public FairnessResponse.Overview overview(Long adminUserId, String period) { + assertAdmin(adminUserId); + Instant captured = Instant.now(); + String validPeriod = validatePeriod(period, captured); + FairnessMonitoringRepository.OverviewAggregateData aggregate = repository.findOverviewAggregateData(validPeriod); + if (aggregate == null) aggregate = FairnessMonitoringRepository.OverviewAggregateData.empty(); + return overviewFromAggregate(validPeriod, captured, aggregate); + } + + private FairnessResponse.Overview overviewFromAggregate(String period, Instant captured, + FairnessMonitoringRepository.OverviewAggregateData aggregate) { + int population = aggregate.populationSize(); + int computable = aggregate.computableCount(); + Map versions = new LinkedHashMap<>(aggregate.versionCounts()); + Map byVersion = new LinkedHashMap<>(); + Map suppressedVersions = new LinkedHashMap<>(); + aggregate.frequenciesByVersion().forEach((version, frequencies) -> { + int versionPopulation = versions.getOrDefault(version, 0); + int validSample = frequencyCount(frequencies); + boolean subsetSuppressed = versionPopulation > 0 + && FairnessDisclosureGuard.suppressRatio(versionPopulation, validSample); + suppressedVersions.put(version, subsetSuppressed); + FairnessResponse.Distribution distribution = FairnessStatisticsCalculator.distributionFromFrequencies(frequencies); + if (subsetSuppressed) { + byVersion.put(version, suppressedDistribution()); + } else if (distribution.getAvailability() != null && !"NO_DATA".equals(distribution.getAvailability())) { + byVersion.put(version, distribution); + } + }); + boolean ratioSuppressed = FairnessDisclosureGuard.suppressRatio(population, computable); + boolean versionSuppressed = FairnessDisclosureGuard.suppressCells(population, versions.values(), true); + // Each version is an independent disclosure universe. An unsafe + // version is suppressed as a cell, while safe sibling versions may + // still be shown when the global universe itself is safe. + boolean versionSubsetSuppressed = suppressedVersions.values().stream().anyMatch(Boolean.TRUE::equals); + boolean distributionSuppressed = byVersion.values().stream() + .anyMatch(d -> "SUPPRESSED".equals(d.getAvailability())); + boolean derivedSuppressed = ratioSuppressed || versionSuppressed || versionSubsetSuppressed; + FairnessResponse.Distribution single = null; + if (!ratioSuppressed && !versionSuppressed && !versionSubsetSuppressed && byVersion.size() == 1) { + single = byVersion.values().iterator().next(); + } + boolean insufficient = population > 0 && population < FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES; + String availability = population == 0 ? "NO_DATA" : insufficient ? "INSUFFICIENT_SAMPLE" + : (derivedSuppressed || distributionSuppressed ? "SUPPRESSED" : "AVAILABLE"); + String reason = population == 0 ? "NO_SNAPSHOT_POPULATION" : insufficient ? "INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET" + : (derivedSuppressed ? "SMALL_CELL_OR_COMPLEMENT_RISK" + : distributionSuppressed ? "SMALL_BUCKET_OR_COMPLEMENT_RISK" : null); + boolean anyVersion = aggregate.frequenciesByVersion().values().stream().anyMatch(v -> v != null && !v.isEmpty()); + if (!anyVersion && population >= FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES) reason = "NO_COHERENT_VERSION_SCORE"; + return FairnessResponse.Overview.builder().basis("CURRENT_STORED_SNAPSHOTS").scope("SCORED_SNAPSHOT_POPULATION") + .period(period).capturedAt(captured).populationSize(population) + .computableSnapshotRatio(ratioSuppressed ? null : FairnessStatisticsCalculator.ratio(computable, population)) + .confidence(FairnessStatisticsCalculator.confidence(population)) + .riskLevel(insufficient ? "INSUFFICIENT_SAMPLE" : derivedSuppressed ? null : highestRisk(byVersion.values())) + // A protected version count plus a safe sibling count can + // reconstruct the protected total; hide the version-count + // group whenever any version cell is unsafe. + .versionCounts(ratioSuppressed || versionSuppressed || versionSubsetSuppressed ? null : versions) + .mixedVersionCount(ratioSuppressed || versionSuppressed || versionSubsetSuppressed ? null : versions.getOrDefault("MIXED", 0)) + .unknownVersionCount(ratioSuppressed || versionSuppressed || versionSubsetSuppressed ? null : versions.getOrDefault("UNKNOWN", 0)) + .distribution(ratioSuppressed || versionSuppressed ? null : single) + // When only a version-local complement is unsafe, preserve + // safe sibling distributions but keep the unsafe cell + // explicitly SUPPRESSED with no numeric statistics. + .distributionsByRulesVersion(ratioSuppressed || versionSuppressed ? null : byVersion) + .coherentVersionSubset(ratioSuppressed || versionSuppressed ? null : new ArrayList<>(byVersion.keySet())) + .availability(availability).reason(reason).build(); + } + + @Transactional(readOnly = true) + public FairnessResponse.Dimensions dimensions(Long adminUserId, String period, String requestedDimension) { + assertAdmin(adminUserId); + Instant captured = Instant.now(); + String validPeriod = validatePeriod(period, captured); + if (requestedDimension != null && !DIMENSIONS.contains(requestedDimension)) { + throw new BusinessException(ErrorCode.BAD_REQUEST, "invalid dimension"); + } + List aggregates = repository.findSnapshotAggregates(validPeriod); + int population = repository.findSnapshotPopulation(validPeriod); + List targets = requestedDimension == null ? DIMENSIONS.stream().sorted().toList() : List.of(requestedDimension); + List result = new ArrayList<>(); + for (String dimension : targets) { + List items = aggregates.stream() + .filter(r -> dimension.equals(r.dimension())).toList(); + int rowCount = sum(items); + int missing = Math.max(0, population - rowCount); + int nullScore = sum(items.stream().filter(r -> r.score() == null).toList()); + int valid = sum(items.stream().filter(this::isValidAggregate).toList()); + Map statuses = groupCounts(items, true); + Map versions = groupCounts(items, false); + Map> frequencies = new LinkedHashMap<>(); + for (var item : items) if (isValidAggregate(item)) { + frequencies.computeIfAbsent(normaliseVersion(item.rulesVersion()), ignored -> new ArrayList<>()) + .add(new FairnessStatisticsCalculator.ScoreFrequency(item.score(), item.candidateCount())); + } + boolean bucketSuppressed = frequencies.values().stream() + .map(FairnessStatisticsCalculator::distributionFromFrequencies) + .anyMatch(d -> "SUPPRESSED".equals(d.getAvailability())); + Map byVersion = new LinkedHashMap<>(); + Map suppressedVersions = new LinkedHashMap<>(); + frequencies.forEach((v, f) -> { + int versionPopulation = versions.getOrDefault(v, 0); + boolean subsetSuppressed = versionPopulation > 0 + && FairnessDisclosureGuard.suppressRatio(versionPopulation, frequencyCount(f)); + suppressedVersions.put(v, subsetSuppressed); + byVersion.put(v, subsetSuppressed + ? suppressedDistribution() + : FairnessStatisticsCalculator.distributionFromFrequencies(f)); + }); + FairnessResponse.Distribution distribution = FairnessStatisticsCalculator.distributionFromFrequencies( + frequencies.values().stream().flatMap(List::stream).toList()); + int inconsistent = sum(items.stream().filter(r -> ("OK".equals(r.status()) || "ESTIMATED".equals(r.status())) != (r.score() != null)).toList()); + int unknownStatus = sum(items.stream().filter(r -> !KNOWN_STATUSES.contains(r.status())).toList()); + int outOfRange = sum(items.stream().filter(r -> r.score() != null && !validScore(r.score())).toList()); + int unknownRules = sum(items.stream().filter(r -> !KNOWN_RULES.contains(r.rulesVersion())).toList()); + boolean versionSubsetSuppressed = suppressedVersions.values().stream().anyMatch(Boolean.TRUE::equals); + boolean baseSuppress = FairnessDisclosureGuard.suppressCells(population, + List.of(rowCount, missing, nullScore, valid, inconsistent, unknownStatus, outOfRange, unknownRules), true) + || FairnessDisclosureGuard.suppressCells(population, statuses.values(), true) + || FairnessDisclosureGuard.suppressCells(population, versions.values(), true) + || "SUPPRESSED".equals(distribution.getAvailability()) + || bucketSuppressed; + // A version-local unsafe complement suppresses aggregate fields + // that could be combined with a safe sibling to recover it, but + // does not erase a safe sibling distribution. + boolean suppress = baseSuppress || versionSubsetSuppressed; + boolean insufficient = population > 0 && (population < FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES + || (valid > 0 && valid < FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES)); + String availability = population == 0 ? "NO_DATA" : insufficient ? "INSUFFICIENT_SAMPLE" + : suppress ? "SUPPRESSED" : valid == 0 ? "NO_DATA" : "AVAILABLE"; + String reason = population == 0 ? "NO_SNAPSHOT_POPULATION" : insufficient ? "INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET" + : suppress ? "SMALL_CELL_OR_COMPLEMENT_RISK" : valid == 0 ? "NO_VALID_SCORE" : null; + result.add(FairnessResponse.DimensionMetric.builder().dimension(dimension).populationSize(population) + .rowCount(suppress ? null : rowCount).missingRowCount(suppress ? null : missing) + .validSampleSize(suppress ? null : valid).confidence(suppress ? null : FairnessStatisticsCalculator.confidence(valid)) + .missingRowRate(suppress ? null : FairnessStatisticsCalculator.ratio(missing, population)) + .nullScoreRate(suppress ? null : FairnessStatisticsCalculator.ratio(nullScore, population)) + .validCoverage(suppress ? null : FairnessStatisticsCalculator.ratio(valid, population)) + .statusCounts(suppress ? null : statuses).versionCounts(suppress ? null : versions) + .inconsistentRecordCount(suppress ? null : inconsistent).unknownStatusCount(suppress ? null : unknownStatus) + .outOfRangeScoreCount(suppress ? null : outOfRange).unknownRulesVersionCount(suppress ? null : unknownRules) + .distribution(baseSuppress || versionSubsetSuppressed ? null : distribution) + .distributionsByRulesVersion(baseSuppress ? null : byVersion) + .availability(availability).reason(reason).build()); + } + boolean allNoData = result.stream().allMatch(r -> "NO_DATA".equals(r.getAvailability())); + boolean anyInsufficient = result.stream().anyMatch(r -> "INSUFFICIENT_SAMPLE".equals(r.getAvailability())); + boolean anySuppressed = result.stream().anyMatch(r -> "SUPPRESSED".equals(r.getAvailability())); + return FairnessResponse.Dimensions.builder().basis("CURRENT_STORED_SNAPSHOTS").scope("SCORED_SNAPSHOT_POPULATION") + .period(validPeriod).capturedAt(captured).dimensions(result) + .availability(allNoData ? "NO_DATA" : anySuppressed ? "SUPPRESSED" : anyInsufficient ? "INSUFFICIENT_SAMPLE" : "AVAILABLE") + .reason(allNoData ? "NO_SNAPSHOT_POPULATION" : anySuppressed ? "SMALL_CELL_OR_COMPLEMENT_RISK" + : anyInsufficient ? "INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET" : null).build(); + } + + @Transactional(readOnly = true) + public FairnessResponse.Unavailable drift(Long adminUserId) { + assertAdmin(adminUserId); + return unavailable("IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE"); + } + + @Transactional(readOnly = true) + public FairnessResponse.Unavailable rankingStability(Long adminUserId) { + assertAdmin(adminUserId); + return unavailable("RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE"); + } + + @Transactional(readOnly = true) + public FairnessResponse.Appeals appeals(Long adminUserId, LocalDate from, LocalDate to) { + assertAdmin(adminUserId); + Instant captured = Instant.now(); + LocalDate today = LocalDateTime.ofInstant(captured, ZONE).toLocalDate(); + LocalDate end = to == null ? today : to; + LocalDate start = from == null ? end.minusDays(30) : from; + if (from == null ^ to == null) throw new BusinessException(ErrorCode.BAD_REQUEST, "from and to must be provided together"); + if (!start.isBefore(end) || end.isAfter(today) || ChronoUnit.DAYS.between(start, end) > 90) { + throw new BusinessException(ErrorCode.BAD_REQUEST, "invalid appeal date range"); + } + FairnessMonitoringRepository.AppealAggregateSummary aggregate = repository.findAppealAggregateSummary( + start.atStartOfDay(ZONE).toLocalDateTime(), end.atStartOfDay(ZONE).toLocalDateTime()); + if (aggregate == null) aggregate = FairnessMonitoringRepository.AppealAggregateSummary.empty(); + return appealsFromSummary(start, end, captured, aggregate); + } + + private FairnessResponse.Appeals appealsFromSummary(LocalDate start, LocalDate end, Instant captured, + FairnessMonitoringRepository.AppealAggregateSummary a) { + int population = a.sampleSize(); + boolean enough = population >= FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES; + boolean comparableEnough = a.comparableRollbackCandidateCount() >= FairnessDisclosureGuard.MIN_INDEPENDENT_CANDIDATES; + boolean statusSuppressed = FairnessDisclosureGuard.suppressCells(population, a.statusCandidateCounts().values(), true); + boolean reasonSuppressed = FairnessDisclosureGuard.suppressCells(population, + List.of(a.duplicateRollbackHistoryCount(), a.invalidScoreRollbackCount(), a.ruleVersionChangedRollbackCount()), true); + boolean duplicateSuppressed = FairnessDisclosureGuard.suppressCells(population, List.of(a.duplicateAppealCandidateCount()), true); + boolean approvalSuppressed = FairnessDisclosureGuard.suppressCells(population, List.of(a.approvedEverCount()), true) + || FairnessDisclosureGuard.suppressRatio(a.approvalDenominatorCount(), a.approvedEverCount()); + boolean rollbackSuppressed = FairnessDisclosureGuard.suppressRatio(a.approvedEverCount(), a.rolledBackCandidateCount()); + // All statistics derived from comparable rollback rows share one + // disclosure decision. A small comparable population must not leave + // changed counts/rates or deltas visible beside a suppressed denominator. + boolean comparableGroupSuppressed = a.comparableRollbackCount() > 0 + && FairnessDisclosureGuard.suppressCells( + a.comparableRollbackCandidateCount(), + List.of(a.changedCandidateCount(), a.unchangedCandidateCount()), true); + boolean hidden = statusSuppressed || reasonSuppressed || duplicateSuppressed || approvalSuppressed + || rollbackSuppressed; + boolean comparableHidden = hidden || comparableGroupSuppressed; + String availability = population == 0 ? "NO_DATA" : !enough ? "INSUFFICIENT_SAMPLE" + : a.comparableRollbackCount() > 0 && !comparableEnough ? "INSUFFICIENT_SAMPLE" + : (hidden || comparableGroupSuppressed) ? "SUPPRESSED" : "AVAILABLE"; + String reason = population == 0 ? "NO_APPEAL_POPULATION" : !enough ? "INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET" + : a.comparableRollbackCount() > 0 && !comparableEnough ? "COMPARABLE_CANDIDATE_THRESHOLD_NOT_MET" + : (hidden || comparableGroupSuppressed) ? "SMALL_CELL_OR_COMPLEMENT_RISK" : null; + Map reasons = new LinkedHashMap<>(); + reasons.put("DUPLICATE_ROLLBACK_HISTORY", a.duplicateRollbackHistoryCount()); + reasons.put("INVALID_SCORE", a.invalidScoreRollbackCount()); + reasons.put("RULE_VERSION_CHANGED", a.ruleVersionChangedRollbackCount()); + BigDecimal meanDelta = a.comparableRollbackCount() == 0 ? null + : a.deltaSum().divide(BigDecimal.valueOf(a.comparableRollbackCount()), 2, RoundingMode.HALF_UP); + BigDecimal meanAbs = a.comparableRollbackCount() == 0 ? null + : a.absDeltaSum().divide(BigDecimal.valueOf(a.comparableRollbackCount()), 2, RoundingMode.HALF_UP); + boolean hideComparable = comparableHidden || !comparableEnough; + return FairnessResponse.Appeals.builder().basis("APPEAL_CREATION_QUEUE_CURRENT_STATE") + .from(start.toString()).to(end.toString()).capturedAt(captured).appealCount(a.appealCount()).sampleSize(population) + .statusCounts(hidden ? null : a.statusCandidateCounts()).statusEventCounts(hidden ? null : a.statusEventCounts()) + .statusCandidateCounts(hidden ? null : a.statusCandidateCounts()).confidence(FairnessStatisticsCalculator.confidence(population)) + .approvedEverCount(!hidden && enough ? a.approvedEverCount() : null) + .approvalRate(hidden ? null : FairnessStatisticsCalculator.ratio(a.approvedEverCount(), a.approvalDenominatorCount())) + .rollbackExecutionRate(hidden ? null : FairnessStatisticsCalculator.ratio(a.rolledBackCandidateCount(), a.approvedEverCount())) + .duplicateAppealCount(!hidden && enough ? a.duplicateAppealCandidateCount() : null) + .duplicateAppealRate(!hidden && enough ? FairnessStatisticsCalculator.ratio(a.duplicateAppealCandidateCount(), population) : null) + .comparableRollbackCount(hideComparable ? null : a.comparableRollbackCount()) + .comparableRollbackCandidateCount(hideComparable ? null : a.comparableRollbackCandidateCount()) + .changedCount(comparableHidden ? null : a.changedCount()) + .changedCandidateCount(comparableHidden ? null : a.changedCandidateCount()) + .actualScoreChangeRate(comparableHidden ? null + : FairnessStatisticsCalculator.ratio(a.changedCount(), a.comparableRollbackCount())) + .meanDelta(comparableHidden ? null : meanDelta) + .meanAbsoluteDelta(comparableHidden ? null : meanAbs) + .duplicateRollbackHistoryCount(hidden ? null : a.duplicateRollbackHistoryCount()) + .invalidScoreRollbackCount(hidden ? null : a.invalidScoreRollbackCount()) + .ruleVersionChangedRollbackCount(hidden ? null : a.ruleVersionChangedRollbackCount()) + .reasonCounts(hidden ? null : reasons).availability(availability).reason(reason) + .exposureAppealRateAvailability("UNAVAILABLE").exposureAppealRateReason("EXPOSURE_DENOMINATOR_NOT_AVAILABLE").build(); + } + + private int sum(List rows) { + return rows.stream().mapToInt(FairnessMonitoringRepository.SnapshotAggregateRow::candidateCount).sum(); + } + + private Map groupCounts(List rows, boolean status) { + Map result = new LinkedHashMap<>(); + for (var row : rows) { + String key = status ? (KNOWN_STATUSES.contains(row.status()) ? row.status() : "UNKNOWN") : normaliseVersion(row.rulesVersion()); + result.merge(key, row.candidateCount(), Integer::sum); + } + return result; + } + + private boolean isValidAggregate(FairnessMonitoringRepository.SnapshotAggregateRow row) { + return ("OK".equals(row.status()) || "ESTIMATED".equals(row.status())) && validScore(row.score()); + } + + private boolean validScore(BigDecimal value) { + return value != null && value.compareTo(BigDecimal.ZERO) >= 0 && value.compareTo(BigDecimal.valueOf(100)) <= 0; + } + + private String normaliseVersion(String value) { return KNOWN_RULES.contains(value) ? value : "UNKNOWN"; } + + private String highestRisk(Iterable distributions) { + String risk = null; + for (var d : distributions) { + if ("HIGH".equals(d.getRiskLevel())) return "HIGH"; + if ("WARNING".equals(d.getRiskLevel())) risk = "WARNING"; + if ("NORMAL".equals(d.getRiskLevel()) && risk == null) risk = "NORMAL"; + } + return risk; + } + + private int frequencyCount(List frequencies) { + return frequencies == null ? 0 : frequencies.stream().filter(f -> f != null && f.count() > 0) + .mapToInt(FairnessStatisticsCalculator.ScoreFrequency::count).sum(); + } + + private FairnessResponse.Distribution suppressedDistribution() { + return FairnessResponse.Distribution.builder() + .availability("SUPPRESSED") + .reason("SMALL_CELL_OR_COMPLEMENT_RISK") + .build(); + } + + private FairnessResponse.Unavailable unavailable(String reason) { + return FairnessResponse.Unavailable.builder().availability("UNAVAILABLE").reason(reason).capturedAt(Instant.now()).build(); + } + + private String validatePeriod(String value, Instant capturedAt) { + if (value == null || !value.matches("\\d{4}-\\d{2}")) throw new BusinessException(ErrorCode.BAD_REQUEST, "period must be yyyy-MM"); + try { + LocalDate parsed = LocalDate.parse(value + "-01", DateTimeFormatter.ISO_LOCAL_DATE); + String current = LocalDateTime.ofInstant(capturedAt, ZONE).toLocalDate().format(PERIOD); + if (value.compareTo(current) > 0) throw new BusinessException(ErrorCode.BAD_REQUEST, "period cannot be in the future"); + return parsed.format(PERIOD); + } catch (DateTimeParseException e) { + throw new BusinessException(ErrorCode.BAD_REQUEST, "invalid period"); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessResponse.java new file mode 100644 index 0000000..6976c72 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessResponse.java @@ -0,0 +1,155 @@ +package com.mydreamjob.scoringmonitoring; + +import com.fasterxml.jackson.annotation.JsonInclude; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; +import java.time.Instant; +import java.util.List; +import java.util.Map; + +/** V43 只读聚合白名单响应。所有内部用户、申诉和快照 ID 均留在服务端。 */ +public final class FairnessResponse { + private FairnessResponse() {} + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class Overview { + private String basis; + private String scope; + private String period; + private Instant capturedAt; + private int populationSize; + private BigDecimal computableSnapshotRatio; + private String confidence; + private String riskLevel; + private Map versionCounts; + private Integer mixedVersionCount; + private Integer unknownVersionCount; + private Distribution distribution; + private Map distributionsByRulesVersion; + private List coherentVersionSubset; + private String availability; + private String reason; + } + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class Dimensions { + private String basis; + private String scope; + private String period; + private Instant capturedAt; + private List dimensions; + private String availability; + private String reason; + } + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class DimensionMetric { + private String dimension; + private int populationSize; + private Integer rowCount; + private Integer missingRowCount; + private Integer validSampleSize; + private String confidence; + private BigDecimal missingRowRate; + private BigDecimal nullScoreRate; + private BigDecimal validCoverage; + private Map statusCounts; + private Map versionCounts; + private Integer inconsistentRecordCount; + private Integer unknownStatusCount; + private Integer outOfRangeScoreCount; + private Integer unknownRulesVersionCount; + private Distribution distribution; + private Map distributionsByRulesVersion; + private String availability; + private String reason; + } + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class Distribution { + private Integer sampleSize; + private BigDecimal mean; + private BigDecimal median; + private BigDecimal p10; + private BigDecimal p25; + private BigDecimal p75; + private BigDecimal p90; + private BigDecimal min; + private BigDecimal max; + private BigDecimal standardDeviation; + private Map buckets; + private BigDecimal concentrationRate; + private String riskLevel; + private String availability; + private String reason; + } + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class Unavailable { + private String availability; + private String reason; + private Instant capturedAt; + } + + @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor + @JsonInclude(JsonInclude.Include.NON_NULL) + public static class Appeals { + private String basis; + private String from; + private String to; + private Instant capturedAt; + private int appealCount; + private int sampleSize; + private Map statusCounts; + private Map statusEventCounts; + private Map statusCandidateCounts; + private String confidence; + private Integer approvedEverCount; + private BigDecimal approvalRate; + private BigDecimal rollbackExecutionRate; + private Integer duplicateAppealCount; + private BigDecimal duplicateAppealRate; + private Integer comparableRollbackCount; + private Integer comparableRollbackCandidateCount; + private Integer changedCount; + private Integer changedCandidateCount; + private BigDecimal actualScoreChangeRate; + private BigDecimal meanDelta; + private BigDecimal meanAbsoluteDelta; + private Integer duplicateRollbackHistoryCount; + private Integer invalidScoreRollbackCount; + private Integer ruleVersionChangedRollbackCount; + private Map reasonCounts; + private String availability; + private String reason; + private String exposureAppealRateAvailability; + private String exposureAppealRateReason; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculator.java new file mode 100644 index 0000000..fb1cdb4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculator.java @@ -0,0 +1,143 @@ +package com.mydreamjob.scoringmonitoring; + +import java.math.BigDecimal; +import java.math.MathContext; +import java.math.RoundingMode; +import java.util.Comparator; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** 无数据库的确定性统计函数。所有样本量均为独立候选人数。 */ +public final class FairnessStatisticsCalculator { + private static final MathContext MC = MathContext.DECIMAL128; + private static final BigDecimal HUNDRED = BigDecimal.valueOf(100); + + private FairnessStatisticsCalculator() {} + + /** 数据库频数聚合的最小输入，不展开为候选人列表。 */ + public record ScoreFrequency(BigDecimal score, int count) {} + + public static String confidence(int n) { + if (n < 30) return "INSUFFICIENT_SAMPLE"; + if (n < 100) return "LOW_CONFIDENCE"; + return "NORMAL_CONFIDENCE"; + } + + public static FairnessResponse.Distribution distribution(List input) { + if (input == null || input.isEmpty()) { + return FairnessResponse.Distribution.builder().sampleSize(0) + .availability("NO_DATA").reason("NO_VALID_SCORE").build(); + } + Map counts = new LinkedHashMap<>(); + input.stream().filter(v -> v != null).forEach(v -> counts.merge(v, 1, Integer::sum)); + return distributionFromFrequencies(counts.entrySet().stream() + .map(e -> new ScoreFrequency(e.getKey(), e.getValue())).toList()); + } + + public static FairnessResponse.Distribution distributionFromFrequencies(List input) { + if (input == null || input.isEmpty()) { + return FairnessResponse.Distribution.builder().sampleSize(0) + .availability("NO_DATA").reason("NO_VALID_SCORE").build(); + } + List values = input.stream() + .filter(v -> v != null && v.score() != null && v.count() > 0) + .sorted(Comparator.comparing(ScoreFrequency::score)).toList(); + int n = values.stream().mapToInt(ScoreFrequency::count).sum(); + if (n == 0) { + return FairnessResponse.Distribution.builder().sampleSize(0) + .availability("NO_DATA").reason("NO_VALID_SCORE").build(); + } + if (n < 30) { + return FairnessResponse.Distribution.builder().sampleSize(n) + .availability("INSUFFICIENT_SAMPLE") + .reason("INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET").build(); + } + Map buckets = buckets(values); + boolean suppressed = FairnessDisclosureGuard.suppressCells(n, buckets.values(), false); + if (suppressed) { + return FairnessResponse.Distribution.builder().sampleSize(null) + .availability("SUPPRESSED").reason("SMALL_BUCKET_OR_COMPLEMENT_RISK").build(); + } + BigDecimal meanExact = values.stream() + .map(v -> v.score().multiply(BigDecimal.valueOf(v.count()), MC)) + .reduce(BigDecimal.ZERO, (a, b) -> a.add(b, MC)) + .divide(BigDecimal.valueOf(n), MC); + BigDecimal variance = values.stream() + .map(v -> v.score().subtract(meanExact, MC).pow(2, MC) + .multiply(BigDecimal.valueOf(v.count()), MC)) + .reduce(BigDecimal.ZERO, (a, b) -> a.add(b, MC)) + .divide(BigDecimal.valueOf(n), MC); + BigDecimal std = variance.max(BigDecimal.ZERO).sqrt(MC) + .setScale(2, RoundingMode.HALF_UP); + int maxBucket = buckets.values().stream().mapToInt(Integer::intValue).max().orElse(0); + BigDecimal concentrationExact = BigDecimal.valueOf(maxBucket).multiply(HUNDRED, MC) + .divide(BigDecimal.valueOf(n), MC); + String risk = concentrationExact.compareTo(BigDecimal.valueOf(85)) >= 0 ? "HIGH" + : concentrationExact.compareTo(BigDecimal.valueOf(70)) >= 0 ? "WARNING" : "NORMAL"; + return FairnessResponse.Distribution.builder() + .sampleSize(n).availability("AVAILABLE") + .mean(meanExact.setScale(2, RoundingMode.HALF_UP)) + .median(weightedPercentile(values, new BigDecimal("0.5"))) + .p10(weightedPercentile(values, new BigDecimal("0.1"))) + .p25(weightedPercentile(values, new BigDecimal("0.25"))) + .p75(weightedPercentile(values, new BigDecimal("0.75"))) + .p90(weightedPercentile(values, new BigDecimal("0.9"))) + .min(values.get(0).score().setScale(2, RoundingMode.HALF_UP)) + .max(values.get(values.size() - 1).score().setScale(2, RoundingMode.HALF_UP)) + .standardDeviation(std).buckets(buckets) + .concentrationRate(concentrationExact.setScale(2, RoundingMode.HALF_UP)) + .riskLevel(risk).build(); + } + + public static BigDecimal ratio(int numerator, int denominator) { + if (denominator <= 0) return null; + return BigDecimal.valueOf(numerator).multiply(HUNDRED, MC) + .divide(BigDecimal.valueOf(denominator), MC).setScale(2, RoundingMode.HALF_UP); + } + + public static BigDecimal percentile(List sorted, BigDecimal p) { + if (sorted == null || sorted.isEmpty()) return null; + if (sorted.size() == 1) return sorted.get(0).setScale(2, RoundingMode.HALF_UP); + BigDecimal h = BigDecimal.valueOf(sorted.size() - 1).multiply(p, MC); + int i = h.setScale(0, RoundingMode.FLOOR).intValue(); + BigDecimal f = h.subtract(BigDecimal.valueOf(i), MC); + BigDecimal left = sorted.get(i); + BigDecimal right = sorted.get(Math.min(i + 1, sorted.size() - 1)); + return left.add(right.subtract(left, MC).multiply(f, MC), MC) + .setScale(2, RoundingMode.HALF_UP); + } + + private static BigDecimal weightedPercentile(List values, BigDecimal p) { + int n = values.stream().mapToInt(ScoreFrequency::count).sum(); + if (n == 1) return values.get(0).score().setScale(2, RoundingMode.HALF_UP); + BigDecimal h = BigDecimal.valueOf(n - 1).multiply(p, MC); + int lower = h.setScale(0, RoundingMode.FLOOR).intValue(); + BigDecimal fraction = h.subtract(BigDecimal.valueOf(lower), MC); + BigDecimal left = valueAt(values, lower); + BigDecimal right = valueAt(values, Math.min(lower + 1, n - 1)); + return left.add(right.subtract(left, MC).multiply(fraction, MC), MC) + .setScale(2, RoundingMode.HALF_UP); + } + + private static BigDecimal valueAt(List values, int index) { + int seen = 0; + for (ScoreFrequency value : values) { + if (index < seen + value.count()) return value.score(); + seen += value.count(); + } + return values.get(values.size() - 1).score(); + } + + private static Map buckets(List values) { + Map result = new LinkedHashMap<>(); + for (int i = 0; i < 10; i++) result.put(i * 10 + "-" + (i == 9 ? 100 : i * 10 + 9), 0); + for (ScoreFrequency value : values) { + int bucket = value.score().compareTo(BigDecimal.valueOf(100)) >= 0 ? 9 + : value.score().max(BigDecimal.ZERO).divide(BigDecimal.TEN, 0, RoundingMode.FLOOR).intValue(); + String key = bucket * 10 + "-" + (bucket == 9 ? 100 : bucket * 10 + 9); + result.computeIfPresent(key, (k, v) -> v + value.count()); + } + return result; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/security/CurrentUserAccessor.java b/mydreamjob-server/src/main/java/com/mydreamjob/security/CurrentUserAccessor.java new file mode 100644 index 0000000..dbf839a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/security/CurrentUserAccessor.java @@ -0,0 +1,106 @@ +package com.mydreamjob.security; + +import com.mydreamjob.auth.SessionAuthenticationDetails; +import org.springframework.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.context.SecurityContextHolder; +import org.springframework.stereotype.Component; + +/** + * 安全关键路径的当前用户解析器。 + * + *

    身份只来自 JWT / SecurityContext，不接受任何请求参数传入的 userId。 + * 所有非法主体一律转换为既有的“未登录”语义（{@link InsufficientAuthenticationException} + * 由 {@code GlobalExceptionHandler} 映射为 HTTP 401），从而避免 + * {@code NumberFormatException} 逃逸为 HTTP 500。

    + * + *

    明确拒绝：Authentication 为 null、未认证、{@link AnonymousAuthenticationToken}、 + * 名称为空、名称为 anonymousUser、名称不是合法 Long、userId <= 0。

    + * + *

    本类只负责身份解析，不承担角色校验与资源归属校验—— + * 那两类判断仍由既有业务逻辑负责。

    + */ +@Component +public class CurrentUserAccessor { + + /** 固定安全文本：不回显任何非法 principal。 */ + static final String UNAUTHENTICATED_MESSAGE = "authentication required"; + + private static final String ANONYMOUS_PRINCIPAL = "anonymousUser"; + + /** 解析当前请求的用户 ID（读取 SecurityContext）。 */ + public Long requireUserId() { + return requireUserId(SecurityContextHolder.getContext().getAuthentication()); + } + + /** + * 解析当前请求**已验证**的登录会话 ID（S02）。 + * + *

    会话 ID 只可能由认证过滤器在 Access Token 通过完整校验后写入 + * {@code Authentication.details}；客户端无法通过参数或请求体提供。 + * 取不到时一律按未登录处理。

    + */ + public String requireSessionId() { + Authentication authentication = SecurityContextHolder.getContext().getAuthentication(); + if (authentication == null + || !authentication.isAuthenticated() + || authentication instanceof AnonymousAuthenticationToken) { + throw unauthenticated(); + } + if (authentication.getDetails() instanceof SessionAuthenticationDetails details) { + String sessionId = details.getSessionId(); + if (sessionId != null && !sessionId.isBlank()) { + return sessionId; + } + } + throw unauthenticated(); + } + + /** + * 解析用户 ID。任何非法输入都抛出未登录异常，绝不抛出 NumberFormatException。 + * + * @param authentication 待校验的认证对象（可为 null） + * @return 大于 0 的已验证用户 ID + */ + public Long requireUserId(Authentication authentication) { + if (authentication == null + || !authentication.isAuthenticated() + || authentication instanceof AnonymousAuthenticationToken) { + throw unauthenticated(); + } + String name = authentication.getName(); + if (name == null || name.isBlank() || ANONYMOUS_PRINCIPAL.equals(name)) { + throw unauthenticated(); + } + if (!isAsciiDigits(name)) { + throw unauthenticated(); + } + long userId; + try { + userId = Long.parseLong(name); + } catch (NumberFormatException e) { + // 位数溢出等极端情况：同样按未登录处理，不回显原始值 + throw unauthenticated(); + } + if (userId <= 0) { + throw unauthenticated(); + } + return userId; + } + + /** 严格校验：仅接受 ASCII 数字，排除 "+42"、"-42"、空白与 Unicode 数字。 */ + private boolean isAsciiDigits(String value) { + for (int i = 0; i < value.length(); i++) { + char c = value.charAt(i); + if (c < '0' || c > '9') { + return false; + } + } + return true; + } + + private InsufficientAuthenticationException unauthenticated() { + return new InsufficientAuthenticationException(UNAUTHENTICATED_MESSAGE); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/security/UserRoleGuard.java b/mydreamjob-server/src/main/java/com/mydreamjob/security/UserRoleGuard.java new file mode 100644 index 0000000..c2a0c45 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/security/UserRoleGuard.java @@ -0,0 +1,142 @@ +package com.mydreamjob.security; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +/** + * 业务角色授权守卫（R01-B/B1）。 + * + *

    把散落在各 Service/Controller 中的"读取用户 → 判断角色 → 抛错"重复实现， + * 收束到唯一实现点。

    + * + *

    职责边界

    + *
      + *
    • 只做角色授权，不做资源归属（ownership）校验 —— + * 归属仍由各业务 Service 负责（如 {@code assertOwnerOrThrow}）；
      • + *
    • 不解析 SecurityContext："当前登录用户是谁"仍由 + * {@link CurrentUserAccessor} 负责，本类只接收已解析出的 {@code userId}；
      • + *
    • 不处理 requestId，不读请求头；
      • + *
    • 不提供任何"由调用方传入角色"的入口：角色只能来自 + * {@link User.Role} 枚举常量，客户端输入无法影响判定；
      • + *
    • 不给 ADMIN 隐式超级权限：{@code requireStudent}/{@code requireCompany} + * 对 ADMIN 同样拒绝，除非调用方显式传入 {@code requireAny(..., ADMIN)}；
      • + *
    • 无副作用：只读用户表，不写库、不写审计、不记日志（尤其不记 userId / 手机号 / Token）。
      • + *
    + * + *

    角色来源

    + *

    角色取自 {@code user.getRoles()}，即 {@code user_roles} 关联表 + * —— 与本类替换掉的全部既有 guard 完全一致。{@code users.role} 单值列用于 JWT 声明签发， + * 不参与此处授权判定：把两者混用会改变既有语义。

    + * + *

    失败关闭

    + *
      + *
    • 用户不存在 → {@link ErrorCode#USER_NOT_FOUND}（沿用既有错误码）；
      • + *
    • 用户存在但 inactive → {@link ErrorCode#FORBIDDEN} + * （比既有实现更严格：被禁用的用户不再因"角色正确"而通过）；
      • + *
    • {@code user_roles} 中缺少所需角色 → {@link ErrorCode#FORBIDDEN} + * （数据不一致时同样是拒绝，而不是放行）。
      • + *
    + * + *

    查询次数

    + *

    {@code requireXxx(Long)} 每次调用恰好 1 次 {@code findById}， + * 不做跨请求缓存（用户被注销/禁用后必须立即失效）。调用方若已加载 + * {@link User}，应使用 {@code requireXxx(User)} 重载以避免第二次查询。

    + */ +@Component +@RequiredArgsConstructor +public class UserRoleGuard { + + private final UserRepository userRepository; + + // ── 按 userId 校验（每次 1 次查询）────────────────────────── + + public void requireStudent(Long userId) { + requireRole(requireUser(userId), User.Role.STUDENT); + } + + public void requireCompany(Long userId) { + requireRole(requireUser(userId), User.Role.COMPANY); + } + + public void requireAdmin(Long userId) { + requireRole(requireUser(userId), User.Role.ADMIN); + } + + /** 允许集合中的任意一个角色（集合由调用方以枚举常量给出，不接受客户端输入）。 */ + public void requireAny(Long userId, User.Role... allowedRoles) { + requireRole(requireUser(userId), allowedRoles); + } + + // ── 按已加载实体校验（0 次查询）──────────────────────────── + + public void requireStudent(User user) { + requireRole(user, User.Role.STUDENT); + } + + public void requireCompany(User user) { + requireRole(user, User.Role.COMPANY); + } + + public void requireAdmin(User user) { + requireRole(user, User.Role.ADMIN); + } + + public void requireAny(User user, User.Role... allowedRoles) { + requireRole(user, allowedRoles); + } + + // ── 基础能力 ─────────────────────────────────────────────── + + /** + * 加载用户并校验其可用（存在且 active）。 + * + * @throws BusinessException {@link ErrorCode#USER_NOT_FOUND} 用户不存在； + * {@link ErrorCode#FORBIDDEN} 用户存在但已禁用 + */ + public User requireUser(Long userId) { + if (userId == null || userId <= 0) { + throw new BusinessException(ErrorCode.USER_NOT_FOUND); + } + User user = userRepository.findById(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); + if (!isActive(user)) { + // 失败关闭：被禁用的用户不得因角色正确而通过授权。 + throw new BusinessException(ErrorCode.FORBIDDEN); + } + return user; + } + + /** + * 校验已加载用户是否具备所需角色之一。 + * + *

    角色来源为 {@code user_roles}；缺失任一所需角色即拒绝。

    + */ + public void requireRole(User user, User.Role... allowedRoles) { + if (user == null) { + throw new BusinessException(ErrorCode.USER_NOT_FOUND); + } + if (!isActive(user)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + if (allowedRoles == null || allowedRoles.length == 0) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + if (user.getRoles() == null) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + for (User.Role allowed : allowedRoles) { + if (allowed != null && user.getRoles().contains(allowed)) { + return; + } + } + throw new BusinessException(ErrorCode.FORBIDDEN); + } + + private static boolean isActive(User user) { + return user.getActive() != null && user.getActive(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/CandidateKeyGenerator.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/CandidateKeyGenerator.java new file mode 100644 index 0000000..3044645 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/CandidateKeyGenerator.java @@ -0,0 +1,35 @@ +package com.mydreamjob.talentdiscovery; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; + +import javax.crypto.Mac; +import javax.crypto.spec.SecretKeySpec; +import java.nio.charset.StandardCharsets; +import java.time.LocalDate; +import java.util.Base64; + +/** 生成与公司、岗位和日期桶绑定的不可逆候选人展示键。 */ +@Component +public class CandidateKeyGenerator { + private static final String HMAC = "HmacSHA256"; + private final byte[] secret; + + public CandidateKeyGenerator(@Value("${app.jwt.secret:}") String configuredSecret) { + this.secret = (configuredSecret == null ? "" : configuredSecret).getBytes(StandardCharsets.UTF_8); + } + + public String generate(Long companyId, Long jobId, Long studentUserId, LocalDate capturedDate) { + if (companyId == null || jobId == null || studentUserId == null || capturedDate == null || secret.length == 0) { + throw new IllegalArgumentException("candidate key parameters are invalid"); + } + String message = "talent-discovery:v1|" + companyId + "|" + jobId + "|" + studentUserId + "|" + capturedDate; + try { + Mac mac = Mac.getInstance(HMAC); + mac.init(new SecretKeySpec(secret, HMAC)); + return Base64.getUrlEncoder().withoutPadding().encodeToString(mac.doFinal(message.getBytes(StandardCharsets.UTF_8))); + } catch (Exception e) { + throw new IllegalStateException("unable to generate candidate key", e); + } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreference.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreference.java new file mode 100644 index 0000000..6f821bd --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreference.java @@ -0,0 +1,57 @@ +package com.mydreamjob.talentdiscovery; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.Version; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +/** 学生对“被企业发现”的显式授权。无记录等价于关闭。 */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "student_talent_discovery_preferences") +@EntityListeners(AuditingEntityListener.class) +public class StudentTalentDiscoveryPreference { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "student_user_id", nullable = false, unique = true) + private Long studentUserId; + + @JdbcTypeCode(SqlTypes.TINYINT) + @Column(nullable = false) + @Builder.Default + private Boolean enabled = false; + + @Version + @Column(nullable = false) + @Builder.Default + private Long version = 0L; + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + private LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreferenceRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreferenceRepository.java new file mode 100644 index 0000000..626f818 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/StudentTalentDiscoveryPreferenceRepository.java @@ -0,0 +1,17 @@ +package com.mydreamjob.talentdiscovery; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +import java.util.Collection; +import java.util.List; +import java.util.Optional; + +@Repository +public interface StudentTalentDiscoveryPreferenceRepository + extends JpaRepository { + + Optional findByStudentUserId(Long studentUserId); + + List findByStudentUserIdInAndEnabledTrue(Collection studentUserIds); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryCandidateSource.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryCandidateSource.java new file mode 100644 index 0000000..16d7954 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryCandidateSource.java @@ -0,0 +1,215 @@ +package com.mydreamjob.talentdiscovery; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.RequiredArgsConstructor; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; + +import java.math.BigDecimal; +import java.sql.Timestamp; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Collection; +import java.util.Collections; +import java.util.HashMap; +import java.util.HashSet; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +/** + * V41 的批量只读数据源。这里集中保存资格 SQL 与聚合结果读取，Controller/Service 不执行 SQL。 + * 所有 ID 都通过 JDBC 参数绑定；仅动态生成与参数数量相同的 ? 占位符。 + */ +@Component +@RequiredArgsConstructor +public class TalentDiscoveryCandidateSource { + + private static final Set RIASEC_DIMENSIONS = Set.of("R", "I", "A", "S", "E", "C"); + private static final Set ABILITY_DIMENSIONS = Set.of("LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"); + private static final TypeReference>> LIST = new TypeReference<>() { }; + private static final TypeReference> STRINGS = new TypeReference<>() { }; + + private final JdbcTemplate jdbcTemplate; + private final ObjectMapper objectMapper; + + /** + * 读取全部合格候选，不做数据库分页。账号注销限制和当前企业任意历史投递均在 SQL 中排除。 + */ + public List findEligibleCandidates(Long companyId) { + if (companyId == null) return List.of(); + String sql = """ + SELECT u.id AS student_user_id, p.location, p.education, p.graduation_year, + p.skills_json, p.updated_at + FROM users u + JOIN student_talent_discovery_preferences td ON td.student_user_id = u.id AND td.enabled = 1 + JOIN student_profiles p ON p.user_id = u.id + WHERE u.role = 'STUDENT' + AND u.is_active = 1 + AND NOT EXISTS ( + SELECT 1 FROM account_deletions ad + WHERE ad.user_id = u.id AND ad.status IN ('PENDING', 'COMPLETED') + ) + AND NOT EXISTS ( + SELECT 1 FROM applications a + JOIN jobs j ON j.id = a.job_id + WHERE a.student_user_id = u.id AND j.company_id = ? + ) + ORDER BY p.updated_at DESC, u.id DESC + """; + return jdbcTemplate.query(sql, (rs, rowNum) -> new CandidateSeed( + rs.getLong("student_user_id"), + rs.getString("location"), + rs.getString("education"), + rs.getObject("graduation_year", Short.class) == null ? null : rs.getObject("graduation_year", Short.class).intValue(), + rs.getString("skills_json"), + timestamp(rs.getTimestamp("updated_at"))), companyId); + } + + /** 批量读取偏好，一次调用对应一条带 IN 参数的 SQL。 */ + public Map findPreferences(Collection studentIds) { + if (studentIds == null || studentIds.isEmpty()) return Map.of(); + List ids = distinctIds(studentIds); + String sql = "SELECT student_user_id, expected_salary_min, expected_salary_max, preferred_cities, employment_types, " + + "preferred_industries, preferred_job_types, remote_allowed FROM student_preferences WHERE student_user_id IN (" + + placeholders(ids.size()) + ")"; + Object[] args = ids.toArray(); + Map out = new HashMap<>(); + jdbcTemplate.query(sql, rs -> { + Long id = rs.getLong("student_user_id"); + out.put(id, new PreferenceSignal( + rs.getObject("expected_salary_min", Integer.class), + rs.getObject("expected_salary_max", Integer.class), + readStrings(rs.getString("preferred_cities")), + readStrings(rs.getString("employment_types")), + readStrings(rs.getString("preferred_industries")), + readStrings(rs.getString("preferred_job_types")), + bool(rs.getObject("remote_allowed")))); + }, args); + return out; + } + + /** 批量读取每位学生最新一份 RIASEC 结果；先按时间选一条，再解析，禁止取历史最高。 */ + public Map findLatestRiasec(Collection studentIds) { + if (studentIds == null || studentIds.isEmpty()) return Map.of(); + List ids = distinctIds(studentIds); + String sql = "SELECT a.student_user_id, a.id AS attempt_id, a.completed_at, r.answered_count, r.dimension_scores_text " + + "FROM assessment_results r JOIN assessment_attempts a ON a.id=r.attempt_id " + + "JOIN assessment_definitions d ON d.id=a.definition_id " + + "WHERE a.student_user_id IN (" + placeholders(ids.size()) + ") " + + "AND a.status='COMPLETED' AND d.type_code='HOLLAND_RIASEC' " + + "ORDER BY a.student_user_id, a.completed_at DESC, a.id DESC"; + Map out = new LinkedHashMap<>(); + jdbcTemplate.query(sql, rs -> { + Long id = rs.getLong("student_user_id"); + if (!out.containsKey(id)) { + out.put(id, new ScoreSignal(parseScores(rs.getString("dimension_scores_text"), RIASEC_DIMENSIONS, + rs.getObject("answered_count", Integer.class), 30), + timestamp(rs.getTimestamp("completed_at")), null)); + } + }, ids.toArray()); + return out; + } + + /** 批量读取每位学生最新、尚未过期的能力结果；valid_until 等于 capturedNow 不可用。 */ + public Map findLatestAbility(Collection studentIds, LocalDateTime capturedNow) { + if (studentIds == null || studentIds.isEmpty() || capturedNow == null) return Map.of(); + List ids = distinctIds(studentIds); + String sql = "SELECT a.student_user_id, a.id AS attempt_id, a.completed_at, a.answered_count, r.valid_until, r.dimension_scores_json " + + "FROM ability_results r JOIN ability_attempts a ON a.id=r.attempt_id " + + "JOIN ability_definitions d ON d.id=a.definition_id " + + "WHERE a.student_user_id IN (" + placeholders(ids.size()) + ") " + + "AND a.status='COMPLETED' AND d.type_code='WORKPLACE_ABILITY' AND r.valid_until > ? " + + "ORDER BY a.student_user_id, a.completed_at DESC, a.id DESC"; + List args = new ArrayList<>(ids); + args.add(capturedNow); + Map out = new LinkedHashMap<>(); + jdbcTemplate.query(sql, rs -> { + Long id = rs.getLong("student_user_id"); + if (!out.containsKey(id)) { + out.put(id, new ScoreSignal(parseScores(rs.getString("dimension_scores_json"), ABILITY_DIMENSIONS, + rs.getObject("answered_count", Integer.class), 24), + timestamp(rs.getTimestamp("completed_at")), timestamp(rs.getTimestamp("valid_until")))); + } + }, args.toArray()); + return out; + } + + private Map parseScores(String raw, Set expected, Integer totalAnswered, int requiredTotal) { + if (raw == null || raw.isBlank() || totalAnswered == null || totalAnswered != requiredTotal) return Map.of(); + try { + List> rows = objectMapper.readValue(raw, LIST); + if (rows == null || rows.size() != expected.size()) return Map.of(); + Map out = new LinkedHashMap<>(); + for (Map row : rows) { + // V35 RIASEC 持久化字段名是 dimension；V36 能力结果字段名是 code。 + // 按测评实际 JSON 结构选择字段，禁止把任意字段静默当成维度。 + Object codeValue = expected.equals(ABILITY_DIMENSIONS) + ? row.get("code") + : (row.containsKey("dimension") ? row.get("dimension") : row.get("code")); + if (!(codeValue instanceof String code) || !expected.contains(code) || out.containsKey(code)) return Map.of(); + BigDecimal score = decimal(row.get("score")); + if (score == null || score.compareTo(BigDecimal.ZERO) < 0 || score.compareTo(BigDecimal.valueOf(100)) > 0) return Map.of(); + if (expected.equals(ABILITY_DIMENSIONS)) { + Integer perDimension = exactInteger(row.get("answeredCount")); + if (perDimension == null || perDimension != 6) return Map.of(); + } + out.put(code, score); + } + return out.keySet().equals(expected) ? out : Map.of(); + } catch (Exception ignored) { + return Map.of(); + } + } + + private List readStrings(String raw) { + if (raw == null || raw.isBlank()) return List.of(); + try { + List values = objectMapper.readValue(raw, STRINGS); + if (values == null) return List.of(); + return values.stream().filter(v -> v != null && !v.trim().isEmpty()).map(String::trim).toList(); + } catch (Exception ignored) { + return List.of(); + } + } + + private BigDecimal decimal(Object value) { + if (value == null) return null; + try { return new BigDecimal(String.valueOf(value)); } catch (Exception e) { return null; } + } + + private Integer exactInteger(Object value) { + BigDecimal number = decimal(value); + if (number == null) return null; + try { return number.stripTrailingZeros().intValueExact(); } catch (ArithmeticException e) { return null; } + } + + private boolean bool(Object value) { + if (value instanceof Boolean b) return b; + if (value instanceof Number n) return n.intValue() != 0; + return "true".equalsIgnoreCase(String.valueOf(value)) || "1".equals(String.valueOf(value)); + } + + private static LocalDateTime timestamp(Timestamp timestamp) { + return timestamp == null ? null : timestamp.toLocalDateTime(); + } + + private static List distinctIds(Collection ids) { + return ids.stream().filter(java.util.Objects::nonNull).distinct().toList(); + } + + private static String placeholders(int count) { + return String.join(",", Collections.nCopies(count, "?")); + } + + public record CandidateSeed(Long studentUserId, String city, String education, Integer graduationYear, + String skillsJson, LocalDateTime profileUpdatedAt) { } + + public record PreferenceSignal(Integer expectedSalaryMin, Integer expectedSalaryMax, List cities, + List employmentTypes, List industries, List jobTypes, + boolean remoteAllowed) { } + + public record ScoreSignal(Map scores, LocalDateTime completedAt, LocalDateTime validUntil) { } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryController.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryController.java new file mode 100644 index 0000000..34052a0 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryController.java @@ -0,0 +1,64 @@ +package com.mydreamjob.talentdiscovery; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPageResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceUpdateRequest; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.media.Content; +import io.swagger.v3.oas.annotations.media.Schema; +import io.swagger.v3.oas.annotations.responses.ApiResponses; +import io.swagger.v3.oas.annotations.security.SecurityRequirement; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RestController; + +/** V41 学生授权与企业人才发现接口；身份只从 SecurityContext 获取。 */ +@RestController +@RequiredArgsConstructor +@Tag(name = "企业人才发现", description = "学生显式授权后，认证企业按自有岗位发现匿名候选人") +public class TalentDiscoveryController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + + private final TalentDiscoveryService service; + + @GetMapping("/profile/me/talent-discovery") + @Operation(summary = "查询人才发现授权", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseTalentDiscoveryPreferenceResponse")))) + public ApiResponse getPreference(HttpServletRequest request) { + return ApiResponse.ok(service.getPreference(currentUserAccessor.requireUserId()), requestIdAccessor.get(request)); + } + + @PutMapping("/profile/me/talent-discovery") + @Operation(summary = "更新人才发现授权", description = "仅当前学生本人可更新；expectedVersion 用于乐观锁并发控制。", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseTalentDiscoveryPreferenceResponse")))) + public ApiResponse updatePreference( + @Valid @RequestBody TalentDiscoveryPreferenceUpdateRequest body, HttpServletRequest request) { + return ApiResponse.ok(service.updatePreference(currentUserAccessor.requireUserId(), body, AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @GetMapping("/companies/me/jobs/{jobId}/talent-recommendations") + @Operation(summary = "查询岗位人才发现推荐", description = "仅已认证企业可查询本人已发布且具备审核通过画像的岗位；候选卡不包含学生身份或测评详情。", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseTalentDiscoveryPageResponse")))) + public ApiResponse recommendations( + @PathVariable Long jobId, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + return ApiResponse.ok(service.recommendations(currentUserAccessor.requireUserId(), jobId, page, size), requestIdAccessor.get(request)); + } + +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculator.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculator.java new file mode 100644 index 0000000..8b18bb8 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculator.java @@ -0,0 +1,46 @@ +package com.mydreamjob.talentdiscovery; + +import org.springframework.stereotype.Component; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; + +/** V41 人才发现评分纯函数；不访问数据库，也不生成对外的数值分数。 */ +@Component +public class TalentDiscoveryScoreCalculator { + public static final BigDecimal PREFERENCE_WEIGHT = new BigDecimal("40"); + public static final BigDecimal RIASEC_WEIGHT = new BigDecimal("35"); + public static final BigDecimal ABILITY_WEIGHT = new BigDecimal("25"); + private static final BigDecimal MIN = BigDecimal.ZERO; + private static final BigDecimal MAX = new BigDecimal("100"); + + public record Calculation(BigDecimal fitScore, String fitBand, List signalsAvailable) { } + + /** 缺失信号不按 0 处罚，仅对有效信号权重重新归一化。 */ + public Optional calculate(BigDecimal preference, BigDecimal riasec, BigDecimal ability) { + BigDecimal numerator = BigDecimal.ZERO; + BigDecimal denominator = BigDecimal.ZERO; + List available = new ArrayList<>(); + if (valid(preference)) { numerator = numerator.add(preference.multiply(PREFERENCE_WEIGHT)); denominator = denominator.add(PREFERENCE_WEIGHT); available.add("PREFERENCE"); } + if (valid(riasec)) { numerator = numerator.add(riasec.multiply(RIASEC_WEIGHT)); denominator = denominator.add(RIASEC_WEIGHT); available.add("RIASEC"); } + if (valid(ability)) { numerator = numerator.add(ability.multiply(ABILITY_WEIGHT)); denominator = denominator.add(ABILITY_WEIGHT); available.add("ABILITY"); } + if (denominator.signum() == 0) return Optional.empty(); + BigDecimal score = numerator.divide(denominator, 2, RoundingMode.HALF_UP); + return Optional.of(new Calculation(score, band(score), List.copyOf(available))); + } + + public String band(BigDecimal score) { + if (score == null) return null; + if (score.compareTo(new BigDecimal("75")) >= 0) return "HIGH"; + if (score.compareTo(new BigDecimal("60")) >= 0) return "MEDIUM"; + return "BASIC"; + } + + private boolean valid(BigDecimal value) { + return value != null && value.compareTo(MIN) >= 0 && value.compareTo(MAX) <= 0 + && value.scale() < 1000; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryService.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryService.java new file mode 100644 index 0000000..67f5f1a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/TalentDiscoveryService.java @@ -0,0 +1,307 @@ +package com.mydreamjob.talentdiscovery; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +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.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.recommendation.JobPreferenceScoreCalculator; +import com.mydreamjob.recommendation.JobRecommendationProfile; +import com.mydreamjob.recommendation.JobRecommendationProfileRepository; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryCandidateResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPageResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceUpdateRequest; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.orm.ObjectOptimisticLockingFailureException; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.regex.Pattern; + +/** V41 企业人才发现服务。只读候选池，不写推荐历史、曝光或候选评分快照。 */ +@Service +@RequiredArgsConstructor +public class TalentDiscoveryService { + private static final ObjectMapper JSON = new ObjectMapper(); + private static final TypeReference> MAP = new TypeReference<>() { }; + private static final TypeReference> LIST = new TypeReference<>() { }; + private static final int BATCH_SIZE = 500; + private static final Pattern SAFE_SKILL = Pattern.compile("[\\p{L}\\p{N}+#./()（）·\\-_ ]+"); + + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final StudentTalentDiscoveryPreferenceRepository preferenceRepository; + private final UserRepository userRepository; + private final CompanyRepository companyRepository; + private final JobRepository jobRepository; + private final JobRecommendationProfileRepository profileRepository; + private final TalentDiscoveryCandidateSource candidateSource; + private final TalentDiscoveryScoreCalculator scoreCalculator; + private final CandidateKeyGenerator candidateKeyGenerator; + private final AuditService auditService; + + @Transactional(readOnly = true) + public TalentDiscoveryPreferenceResponse getPreference(Long userId) { + userRoleGuard.requireStudent(userId); + StudentTalentDiscoveryPreference value = preferenceRepository.findByStudentUserId(userId).orElse(null); + return toPreference(value); + } + + @Transactional + public TalentDiscoveryPreferenceResponse updatePreference(Long userId, + TalentDiscoveryPreferenceUpdateRequest request, + AuditContext context) { + userRoleGuard.requireStudent(userId); + if (request == null || request.getEnabled() == null) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + StudentTalentDiscoveryPreference existing = preferenceRepository.findByStudentUserId(userId).orElse(null); + Long expected = request.getExpectedVersion(); + if (existing == null && expected != null && expected != 0L) { + throw new BusinessException(ErrorCode.PRIVACY_SETTINGS_CONCURRENT_UPDATE); + } + if (existing != null && expected != null && !java.util.Objects.equals(existing.getVersion(), expected)) { + throw new BusinessException(ErrorCode.PRIVACY_SETTINGS_CONCURRENT_UPDATE); + } + try { + StudentTalentDiscoveryPreference saved; + if (existing == null) { + saved = preferenceRepository.saveAndFlush(StudentTalentDiscoveryPreference.builder() + .studentUserId(userId).enabled(request.getEnabled()).version(0L).build()); + } else { + existing.setEnabled(request.getEnabled()); + saved = preferenceRepository.saveAndFlush(existing); + } + String requestId = context == null ? null : context.getRequestId(); + String details = "{\"enabled\":" + saved.getEnabled() + + ",\"version\":" + saved.getVersion() + + ",\"requestId\":" + (requestId == null ? "null" : quote(requestId)) + "}"; + auditService.log(userId, "TALENT_DISCOVERY_PREFERENCE_UPDATED", + "STUDENT_TALENT_DISCOVERY_PREFERENCE", saved.getId(), details, context); + return toPreference(saved); + } catch (ObjectOptimisticLockingFailureException | DataIntegrityViolationException ex) { + throw new BusinessException(ErrorCode.PRIVACY_SETTINGS_CONCURRENT_UPDATE); + } + } + + @Transactional(readOnly = true) + public TalentDiscoveryPageResponse recommendations(Long userId, Long jobId, int page, int size) { + validatePage(jobId, page, size); + Company company = requireVerifiedCompany(userId); + Job job = jobRepository.findById(jobId).orElseThrow(() -> new BusinessException(ErrorCode.JOB_NOT_FOUND)); + if (!company.getId().equals(job.getCompanyId())) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + if (!"PUBLISHED".equals(job.getStatus())) { + throw new BusinessException(ErrorCode.INVALID_JOB_STATUS_TRANSITION); + } + JobRecommendationProfile profile = profileRepository.findByJobId(jobId).orElse(null); + if (profile == null || !Boolean.TRUE.equals(profile.getEnabled()) + || !JobRecommendationProfile.APPROVED.equals(profile.getReviewStatus())) { + return page("UNAVAILABLE", List.of(), 0, page, size, "该岗位尚无审核通过的推荐画像"); + } + + LocalDateTime capturedNow = LocalDateTime.now(); + List seeds = candidateSource.findEligibleCandidates(company.getId()); + if (seeds.isEmpty()) { + return page("NO_ELIGIBLE_CANDIDATE", List.of(), 0, page, size, "暂未发现已授权且满足基础条件的候选人"); + } + Map preferences = new HashMap<>(); + Map riasec = new HashMap<>(); + Map ability = new HashMap<>(); + for (int from = 0; from < seeds.size(); from += BATCH_SIZE) { + int to = Math.min(from + BATCH_SIZE, seeds.size()); + List ids = seeds.subList(from, to).stream() + .map(TalentDiscoveryCandidateSource.CandidateSeed::studentUserId).toList(); + preferences.putAll(candidateSource.findPreferences(ids)); + riasec.putAll(candidateSource.findLatestRiasec(ids)); + ability.putAll(candidateSource.findLatestAbility(ids, capturedNow)); + } + + List scored = new ArrayList<>(); + for (TalentDiscoveryCandidateSource.CandidateSeed seed : seeds) { + BigDecimal p = preferenceScore(preferences.get(seed.studentUserId()), profile, job); + TalentDiscoveryCandidateSource.ScoreSignal iSignal = riasec.get(seed.studentUserId()); + BigDecimal i = weighted(iSignal == null ? Map.of() : iSignal.scores(), parseMap(profile.getRiasecWeightsJson()), Set.of("R", "I", "A", "S", "E", "C")); + TalentDiscoveryCandidateSource.ScoreSignal aSignal = ability.get(seed.studentUserId()); + BigDecimal a = weighted(aSignal == null ? Map.of() : aSignal.scores(), parseMap(profile.getAbilityExpectationsJson()), Set.of("LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING")); + var calculation = scoreCalculator.calculate(p, i, a); + if (calculation.isEmpty()) continue; + TalentDiscoveryScoreCalculator.Calculation value = calculation.get(); + scored.add(new ScoredCandidate(seed, value)); + } + if (scored.isEmpty()) { + return page("NO_ELIGIBLE_CANDIDATE", List.of(), 0, page, size, + "暂未发现已授权且满足基础条件的候选人"); + } + scored.sort(Comparator.comparing((ScoredCandidate c) -> c.calculation.fitScore()).reversed() + .thenComparing(c -> c.seed.profileUpdatedAt(), Comparator.nullsLast(Comparator.reverseOrder())) + .thenComparing(c -> c.seed.studentUserId(), Comparator.reverseOrder())); + int total = scored.size(); + long offset = (long) page * size; + int from = offset >= total ? total : (int) offset; + int to = Math.min(from + size, total); + List items = scored.subList(from, to).stream() + .map(c -> toCandidate(c, company.getId(), job.getId(), capturedNow.toLocalDate())).toList(); + return page("PERSONALIZED", items, total, page, size, null); + } + + private TalentDiscoveryCandidateResponse toCandidate(ScoredCandidate scored, Long companyId, Long jobId, LocalDate date) { + TalentDiscoveryCandidateSource.CandidateSeed seed = scored.seed; + return TalentDiscoveryCandidateResponse.builder() + .candidateKey(candidateKeyGenerator.generate(companyId, jobId, seed.studentUserId(), date)) + .candidateLabel("开放人才候选人") + .city(safeText(seed.city(), 100)) + .education(safeText(seed.education(), 100)) + .graduationYear(seed.graduationYear()) + .skills(safeSkills(seed.skillsJson())) + .fitBand(scored.calculation.fitBand()) + .summary(summary(scored.calculation.fitBand())) + .signalsAvailable(scored.calculation.signalsAvailable()) + .build(); + } + + /** + * R01-C：改为委托 {@link JobPreferenceScoreCalculator}。 + * + *

    原先此处内联了与 {@code JobRecommendationService} 完全相同的一套 30/20/20/15/15 规则 + * （维度顺序、权重、匹配语义、{@code matched*100/available}、scale=2、HALF_UP 与 + * available==0 → null 均逐字一致）。收束后两处共用唯一实现，**行为不变**。

    + */ + private BigDecimal preferenceScore(TalentDiscoveryCandidateSource.PreferenceSignal preference, + JobRecommendationProfile profile, Job job) { + if (preference == null) return null; + return JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria( + preference.cities(), + preference.employmentTypes(), + preference.expectedSalaryMin(), + preference.industries(), + preference.jobTypes()), + new JobPreferenceScoreCalculator.Target( + job.getCity(), + job.getEmploymentType(), + job.getSalaryMax(), + profile.getIndustryCode(), + profile.getJobFamilyCode())); + } + + private BigDecimal weighted(Map scores, Map expected, Set allowed) { + if (scores.isEmpty() || expected.isEmpty()) return null; + BigDecimal numerator = BigDecimal.ZERO; + BigDecimal denominator = BigDecimal.ZERO; + for (Map.Entry entry : expected.entrySet()) { + if (!allowed.contains(entry.getKey()) || !scores.containsKey(entry.getKey()) || entry.getValue() == null || entry.getValue().signum() <= 0) continue; + numerator = numerator.add(scores.get(entry.getKey()).multiply(entry.getValue())); + denominator = denominator.add(entry.getValue()); + } + return denominator.signum() == 0 ? null : numerator.divide(denominator, 2, RoundingMode.HALF_UP); + } + + private Map parseMap(String raw) { + if (raw == null || raw.isBlank()) return Map.of(); + try { + Map input = JSON.readValue(raw, MAP); + Map result = new HashMap<>(); + for (Map.Entry entry : input.entrySet()) { + if (entry.getKey() == null || entry.getValue() == null) return Map.of(); + BigDecimal value = new BigDecimal(String.valueOf(entry.getValue())); + if (value.compareTo(BigDecimal.ZERO) < 0 || value.compareTo(BigDecimal.valueOf(100)) > 0) return Map.of(); + result.put(entry.getKey(), value); + } + return result; + } catch (Exception ignored) { return Map.of(); } + } + + private List safeSkills(String raw) { + if (raw == null || raw.isBlank()) return List.of(); + try { + List values = JSON.readValue(raw, LIST); + if (values == null) return List.of(); + return values.stream().map(v -> safeSkill(v)).filter(v -> v != null && !v.isBlank()) + .distinct().limit(10).toList(); + } catch (Exception ignored) { return List.of(); } + } + + private String safeSkill(String value) { + String text = safeText(value, 40); + return text != null && SAFE_SKILL.matcher(text).matches() ? text : null; + } + + private String safeText(String value, int max) { + if (value == null) return null; + String text = value.trim(); + if (text.isEmpty()) return null; + return text.length() <= max ? text : text.substring(0, max); + } + + private String summary(String band) { + return switch (band) { + case "HIGH" -> "岗位画像与候选人公开资料存在较高匹配度"; + case "MEDIUM" -> "岗位画像与候选人公开资料存在一定匹配度"; + default -> "候选人满足部分岗位画像条件"; + }; + } + + private Company requireVerifiedCompany(Long userId) { + User user = requireUser(userId); + if (!hasRole(user, User.Role.COMPANY)) throw new BusinessException(ErrorCode.FORBIDDEN); + Company company = companyRepository.findByOwnerUserId(userId) + .orElseThrow(() -> new BusinessException(ErrorCode.COMPANY_NOT_FOUND)); + if (!Boolean.TRUE.equals(company.getVerified())) throw new BusinessException(ErrorCode.FORBIDDEN); + return company; + } + private User requireUser(Long userId) { + if (userId == null) throw new BusinessException(ErrorCode.UNAUTHORIZED); + return userRepository.findById(userId).orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); + } + + private boolean hasRole(User user, User.Role role) { + return user != null && ((user.getRoles() != null && user.getRoles().contains(role)) || user.getRole() == role); + } + + private void validatePage(Long jobId, int page, int size) { + if (jobId == null || jobId <= 0 || page < 0 || size < 1 || size > 50) { + throw new BusinessException(ErrorCode.BAD_REQUEST); + } + } + + private TalentDiscoveryPreferenceResponse toPreference(StudentTalentDiscoveryPreference value) { + if (value == null) return TalentDiscoveryPreferenceResponse.builder().enabled(false).version(0L).build(); + return TalentDiscoveryPreferenceResponse.builder().enabled(Boolean.TRUE.equals(value.getEnabled())) + .version(value.getVersion() == null ? 0L : value.getVersion()) + .createdAt(value.getCreatedAt()).updatedAt(value.getUpdatedAt()).build(); + } + + private TalentDiscoveryPageResponse page(String mode, List items, long total, + int page, int size, String message) { + int totalPages = total == 0 ? 0 : (int) Math.ceil((double) total / size); + return TalentDiscoveryPageResponse.builder().mode(mode).items(items).total(total) + .page(page).size(size).totalPages(totalPages).message(message).build(); + } + + private String quote(String value) { + return "\"" + value.replace("\\", "\\\\").replace("\"", "\\\"") + "\""; + } + + private record ScoredCandidate(TalentDiscoveryCandidateSource.CandidateSeed seed, + TalentDiscoveryScoreCalculator.Calculation calculation) { } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryCandidateResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryCandidateResponse.java new file mode 100644 index 0000000..1db9f93 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryCandidateResponse.java @@ -0,0 +1,26 @@ +package com.mydreamjob.talentdiscovery.dto; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.util.List; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Schema(description = "企业人才发现候选人卡片；不含候选人身份、联系方式或测评分数") +public class TalentDiscoveryCandidateResponse { + private String candidateKey; + private String candidateLabel; + private String city; + private String education; + private Integer graduationYear; + private List skills; + private String fitBand; + private String summary; + private List signalsAvailable; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPageResponse.java new file mode 100644 index 0000000..5bd23af --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPageResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.talentdiscovery.dto; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.util.List; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class TalentDiscoveryPageResponse { + @Schema(description = "PERSONALIZED、UNAVAILABLE 或 NO_ELIGIBLE_CANDIDATE") + private String mode; + private List items; + private long total; + private int page; + private int size; + private int totalPages; + private String message; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceResponse.java new file mode 100644 index 0000000..0019b82 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.talentdiscovery.dto; + +import com.fasterxml.jackson.annotation.JsonInclude; +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@JsonInclude(JsonInclude.Include.NON_NULL) +public class TalentDiscoveryPreferenceResponse { + @Schema(description = "是否允许进入企业人才发现候选池") + private Boolean enabled; + @Schema(description = "乐观锁版本号") + private Long version; + private LocalDateTime createdAt; + private LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceUpdateRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceUpdateRequest.java new file mode 100644 index 0000000..1ff67cd --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentdiscovery/dto/TalentDiscoveryPreferenceUpdateRequest.java @@ -0,0 +1,17 @@ +package com.mydreamjob.talentdiscovery.dto; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.PositiveOrZero; +import lombok.Data; + +@Data +public class TalentDiscoveryPreferenceUpdateRequest { + @NotNull + @Schema(description = "是否允许进入企业人才发现候选池", requiredMode = Schema.RequiredMode.REQUIRED) + private Boolean enabled; + + @PositiveOrZero + @Schema(description = "期望的当前版本；首次创建可省略或传 0") + private Long expectedVersion; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitation.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitation.java new file mode 100644 index 0000000..ec307ea --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitation.java @@ -0,0 +1,48 @@ +package com.mydreamjob.talentinvitation; + +import jakarta.persistence.*; +import lombok.*; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "talent_invitations") +@EntityListeners(AuditingEntityListener.class) +public class TalentInvitation { + public static final String PENDING = "PENDING"; + public static final String ACCEPTED = "ACCEPTED"; + public static final String REJECTED = "REJECTED"; + public static final String EXPIRED = "EXPIRED"; + + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + @Column(name = "company_id", nullable = false) private Long companyId; + @Column(name = "job_id", nullable = false) private Long jobId; + @Column(name = "student_user_id", nullable = false) private Long studentUserId; + /** + * V40 已在 MySQL 中以 CHAR(64) 建表；显式声明 JDBC 类型，避免 + * Hibernate 将 String 默认推断为 VARCHAR(64) 导致 ddl-auto=validate 失败。 + */ + @JdbcTypeCode(SqlTypes.CHAR) + @Column(name = "candidate_key_digest", nullable = false, length = 64, columnDefinition = "CHAR(64)") + private String candidateKeyDigest; + @Column(nullable = false, length = 300) private String message; + @Column(nullable = false, length = 20) @Builder.Default private String status = PENDING; + @Column(name = "idempotency_key", nullable = false, length = 64) private String idempotencyKey; + @Column(name = "active_key", length = 200) private String activeKey; + @Column(name = "conversation_id", unique = true) private Long conversationId; + @Column(name = "expires_at", nullable = false) private LocalDateTime expiresAt; + @Column(name = "decided_at") private LocalDateTime decidedAt; + @Version @Column(nullable = false) @Builder.Default private Long version = 0L; + @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; + @LastModifiedDate @Column(name = "updated_at", nullable = false) private LocalDateTime updatedAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolver.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolver.java new file mode 100644 index 0000000..e81388f --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolver.java @@ -0,0 +1,68 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.talentdiscovery.CandidateKeyGenerator; +import com.mydreamjob.talentdiscovery.TalentDiscoveryCandidateSource; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.Map; +import java.util.List; + +/** 在当前 V41 合格候选池内重算 opaque key，绝不通过 key 反解学生 ID。 */ +@Component +@RequiredArgsConstructor +public class TalentInvitationCandidateResolver { + private final TalentDiscoveryCandidateSource candidateSource; + private final CandidateKeyGenerator candidateKeyGenerator; + + public Resolution resolve(Long companyId, Long jobId, String candidateKey, LocalDateTime capturedNow) { + if (companyId == null || jobId == null || candidateKey == null || capturedNow == null) { + return Resolution.none(); + } + byte[] expected = candidateKey.getBytes(StandardCharsets.UTF_8); + Long match = null; + int matches = 0; + List candidates = candidateSource.findEligibleCandidates(companyId); + List candidateIds = candidates.stream().map(TalentDiscoveryCandidateSource.CandidateSeed::studentUserId).toList(); + Map preferences = safeMap(candidateSource.findPreferences(candidateIds)); + Map riasec = safeMap(candidateSource.findLatestRiasec(candidateIds)); + Map ability = safeMap(candidateSource.findLatestAbility(candidateIds, capturedNow)); + LocalDate bucket = capturedNow.toLocalDate(); + for (TalentDiscoveryCandidateSource.CandidateSeed candidate : candidates) { + // 候选池要求至少有一个可用推荐信号；缺失信号不得按 0 分放行。 + if (!hasSignal(candidate.studentUserId(), preferences, riasec, ability)) continue; + String generated = candidateKeyGenerator.generate(companyId, jobId, candidate.studentUserId(), bucket); + if (MessageDigest.isEqual(expected, generated.getBytes(StandardCharsets.UTF_8))) { + match = candidate.studentUserId(); + matches++; + } + } + return matches == 1 ? new Resolution(match, true) : Resolution.none(); + } + + private boolean hasSignal(Long studentId, + Map preferences, + Map riasec, + Map ability) { + TalentDiscoveryCandidateSource.PreferenceSignal p = preferences.get(studentId); + if (p != null && (p.expectedSalaryMin() != null || p.expectedSalaryMax() != null + || !p.cities().isEmpty() || !p.employmentTypes().isEmpty() + || !p.industries().isEmpty() || !p.jobTypes().isEmpty())) return true; + TalentDiscoveryCandidateSource.ScoreSignal i = riasec.get(studentId); + if (i != null && i.scores() != null && !i.scores().isEmpty()) return true; + TalentDiscoveryCandidateSource.ScoreSignal a = ability.get(studentId); + return a != null && a.scores() != null && !a.scores().isEmpty(); + } + + private Map safeMap(Map value) { + return value == null ? Map.of() : value; + } + + public record Resolution(Long studentUserId, boolean matched) { + public static Resolution none() { return new Resolution(null, false); } + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationController.java new file mode 100644 index 0000000..61d42fe --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationController.java @@ -0,0 +1,82 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.talentinvitation.dto.*; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.media.Content; +import io.swagger.v3.oas.annotations.media.Schema; +import io.swagger.v3.oas.annotations.responses.ApiResponses; +import io.swagger.v3.oas.annotations.security.SecurityRequirement; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.*; + +@RestController +@RequiredArgsConstructor +@Tag(name = "企业人才邀约", description = "企业发起邀约，学生同意后建立站内会话") +public class TalentInvitationController { + /** R01-A4：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A4：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + + private final TalentInvitationService service; + + @PostMapping("/companies/me/jobs/{jobId}/talent-invitations") + @Operation(summary = "创建人才邀约", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseCompanyTalentInvitationResponse")))) + public ApiResponse create(@PathVariable Long jobId, + @Valid @RequestBody CreateTalentInvitationRequest body, + HttpServletRequest request) { + return ApiResponse.ok(service.create(currentUserAccessor.requireUserId(), jobId, body, AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @GetMapping("/companies/me/talent-invitations") + @Operation(summary = "企业邀约列表", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseCompanyTalentInvitationPageResponse")))) + public ApiResponse> listCompany( + @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + return ApiResponse.ok(service.listCompany(currentUserAccessor.requireUserId(), page, size), requestIdAccessor.get(request)); + } + + @GetMapping("/companies/me/talent-invitations/{invitationId}") + @Operation(summary = "企业邀约详情", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseCompanyTalentInvitationResponse")))) + public ApiResponse getCompany(@PathVariable Long invitationId, + HttpServletRequest request) { + return ApiResponse.ok(service.getCompany(currentUserAccessor.requireUserId(), invitationId, AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @GetMapping("/profile/me/talent-invitations") + @Operation(summary = "学生收到的邀约列表", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseStudentTalentInvitationPageResponse")))) + public ApiResponse> listStudent( + @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, + HttpServletRequest request) { + return ApiResponse.ok(service.listStudent(currentUserAccessor.requireUserId(), page, size), requestIdAccessor.get(request)); + } + + @GetMapping("/profile/me/talent-invitations/{invitationId}") + @Operation(summary = "学生邀约详情", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseStudentTalentInvitationResponse")))) + public ApiResponse getStudent(@PathVariable Long invitationId, + HttpServletRequest request) { + return ApiResponse.ok(service.getStudent(currentUserAccessor.requireUserId(), invitationId, AuditContext.from(request)), requestIdAccessor.get(request)); + } + + @PostMapping("/profile/me/talent-invitations/{invitationId}/decision") + @Operation(summary = "处理人才邀约", description = "学生接受后才创建 TALENT_INVITATION 站内会话", security = @SecurityRequirement(name = "bearerAuth")) + @ApiResponses(@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", content = @Content(schema = @Schema(ref = "#/components/schemas/ApiResponseStudentTalentInvitationResponse")))) + public ApiResponse decide(@PathVariable Long invitationId, + @Valid @RequestBody TalentInvitationDecisionRequest body, + HttpServletRequest request) { + return ApiResponse.ok(service.decide(currentUserAccessor.requireUserId(), invitationId, body, AuditContext.from(request)), requestIdAccessor.get(request)); + } + +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationConversationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationConversationService.java new file mode 100644 index 0000000..225a1be --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationConversationService.java @@ -0,0 +1,49 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.job.Job; +import com.mydreamjob.messaging.Conversation; +import com.mydreamjob.messaging.ConversationMember; +import com.mydreamjob.messaging.ConversationMemberRepository; +import com.mydreamjob.messaging.ConversationRepository; +import com.mydreamjob.safety.BlockRelationRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +/** 仅供已接受邀约调用的会话创建器；不会放宽现有 DIRECT 会话规则。 */ +@Component +@RequiredArgsConstructor +public class TalentInvitationConversationService { + private final ConversationRepository conversationRepository; + private final ConversationMemberRepository memberRepository; + private final BlockRelationRepository blockRelationRepository; + + @Transactional + public Long createForAcceptedInvitation(TalentInvitation invitation, Long companyOwnerUserId, Job job) { + if (invitation.getConversationId() != null) return invitation.getConversationId(); + if (blockRelationRepository.existsByBlockerUserIdAndBlockedUserId(companyOwnerUserId, invitation.getStudentUserId()) + || blockRelationRepository.existsByBlockerUserIdAndBlockedUserId(invitation.getStudentUserId(), companyOwnerUserId)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + Conversation conversation = conversationRepository.saveAndFlush(Conversation.builder() + .createdBy(companyOwnerUserId) + .title(job == null ? "人才邀约沟通" : job.getTitle()) + .type("TALENT_INVITATION") + .build()); + try { + memberRepository.saveAll(List.of( + ConversationMember.builder().conversationId(conversation.getId()).userId(companyOwnerUserId).build(), + ConversationMember.builder().conversationId(conversation.getId()).userId(invitation.getStudentUserId()).build())); + memberRepository.flush(); + } catch (DataIntegrityViolationException ex) { + // invitation 行由上游锁定；若数据库异常，事务回滚，调用方不会看到半成品会话。 + throw ex; + } + return conversation.getId(); + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryService.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryService.java new file mode 100644 index 0000000..bdf2e91 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryService.java @@ -0,0 +1,55 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Propagation; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.LinkedHashMap; +import java.util.Map; + +/** 把 EXPIRED 状态、历史和审计提交在独立事务中，避免随后返回错误导致回滚。 */ +@Component +@RequiredArgsConstructor +public class TalentInvitationExpiryService { + private final TalentInvitationRepository invitationRepository; + private final TalentInvitationHistoryRepository historyRepository; + private final AuditService auditService; + + @Transactional(propagation = Propagation.REQUIRES_NEW) + public boolean expireIfDue(Long invitationId, LocalDateTime now, AuditContext context) { + if (invitationId == null || now == null) return false; + TalentInvitation current = invitationRepository.findById(invitationId).orElse(null); + if (current == null || !TalentInvitation.PENDING.equals(current.getStatus()) || current.getExpiresAt().isAfter(now)) { + return false; + } + if (invitationRepository.expire(invitationId, now) != 1) return false; + historyRepository.save(TalentInvitationHistory.builder() + .invitationId(invitationId).action(TalentInvitationHistory.EXPIRED).actorUserId(null).build()); + Map details = new LinkedHashMap<>(); + details.put("invitationId", invitationId); + details.put("jobId", current.getJobId()); + details.put("status", TalentInvitation.EXPIRED); + details.put("requestId", context == null ? null : context.getRequestId()); + auditService.log(null, "TALENT_INVITATION_EXPIRED", "TALENT_INVITATION", invitationId, + toJson(details), requestContext(context)); + return true; + } + + private AuditContext requestContext(AuditContext context) { + return context == null ? null : AuditContext.builder().requestId(context.getRequestId()).build(); + } + + private String toJson(Map values) { + return "{\"invitationId\":" + values.get("invitationId") + ",\"jobId\":" + values.get("jobId") + + ",\"status\":\"EXPIRED\",\"requestId\":" + + (values.get("requestId") == null ? "null" : quote(String.valueOf(values.get("requestId")))) + "}"; + } + + private String quote(String value) { + return "\"" + value.replace("\\", "\\\\").replace("\"", "\\\"") + "\""; + } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistory.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistory.java new file mode 100644 index 0000000..3ccf852 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistory.java @@ -0,0 +1,28 @@ +package com.mydreamjob.talentinvitation; + +import jakarta.persistence.*; +import lombok.*; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@Entity +@Table(name = "talent_invitation_history") +@EntityListeners(AuditingEntityListener.class) +public class TalentInvitationHistory { + public static final String CREATED = "CREATED"; + public static final String ACCEPTED = "ACCEPTED"; + public static final String REJECTED = "REJECTED"; + public static final String EXPIRED = "EXPIRED"; + + @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; + @Column(name = "invitation_id", nullable = false) private Long invitationId; + @Column(nullable = false, length = 30) private String action; + @Column(name = "actor_user_id") private Long actorUserId; + @CreatedDate @Column(name = "created_at", nullable = false, updatable = false) private LocalDateTime createdAt; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistoryRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistoryRepository.java new file mode 100644 index 0000000..4e980d7 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationHistoryRepository.java @@ -0,0 +1,9 @@ +package com.mydreamjob.talentinvitation; + +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface TalentInvitationHistoryRepository extends JpaRepository { + long countByInvitationId(Long invitationId); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationRepository.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationRepository.java new file mode 100644 index 0000000..c81715b --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationRepository.java @@ -0,0 +1,56 @@ +package com.mydreamjob.talentinvitation; + +import jakarta.persistence.LockModeType; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.*; +import org.springframework.data.repository.query.Param; +import org.springframework.stereotype.Repository; + +import java.time.LocalDateTime; +import java.util.Optional; + +@Repository +public interface TalentInvitationRepository extends JpaRepository { + Optional findByCompanyIdAndIdempotencyKey(Long companyId, String idempotencyKey); + Optional findByIdAndCompanyId(Long id, Long companyId); + Optional findByIdAndStudentUserId(Long id, Long studentUserId); + Optional findByCompanyIdAndJobIdAndStudentUserIdAndStatus( + Long companyId, Long jobId, Long studentUserId, String status); + Page findByCompanyIdOrderByCreatedAtDescIdDesc(Long companyId, Pageable pageable); + Page findByStudentUserIdOrderByCreatedAtDescIdDesc(Long studentUserId, Pageable pageable); + + @Query("select count(t) from TalentInvitation t where t.companyId=:companyId and t.createdAt>=:from and t.createdAt<:to") + long countCreatedBetween(@Param("companyId") Long companyId, @Param("from") LocalDateTime from, + @Param("to") LocalDateTime to); + + @Query("select count(t) from TalentInvitation t where t.companyId=:companyId and t.jobId=:jobId " + + "and t.createdAt>=:from and t.createdAt<:to") + long countJobCreatedBetween(@Param("companyId") Long companyId, @Param("jobId") Long jobId, + @Param("from") LocalDateTime from, @Param("to") LocalDateTime to); + + @Query("select case when count(t)>0 then true else false end from TalentInvitation t " + + "where t.companyId=:companyId and t.studentUserId=:studentUserId and t.expiresAt>:since") + boolean existsInCooldown(@Param("companyId") Long companyId, @Param("studentUserId") Long studentUserId, + @Param("since") LocalDateTime since); + + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query("update TalentInvitation t set t.status=:status, t.activeKey=null, t.decidedAt=:decidedAt, " + + "t.version=t.version+1 where t.id=:id and t.studentUserId=:studentUserId " + + "and t.status='PENDING' and t.version=:version and t.expiresAt>:now") + int decide(@Param("id") Long id, @Param("studentUserId") Long studentUserId, + @Param("status") String status, @Param("version") Long version, + @Param("decidedAt") LocalDateTime decidedAt, @Param("now") LocalDateTime now); + + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query("update TalentInvitation t set t.conversationId=:conversationId " + + "where t.id=:id and t.studentUserId=:studentUserId and t.status='ACCEPTED' " + + "and t.version=:version and t.conversationId is null") + int attachConversation(@Param("id") Long id, @Param("studentUserId") Long studentUserId, + @Param("conversationId") Long conversationId, @Param("version") Long version); + + @Modifying(clearAutomatically = true, flushAutomatically = true) + @Query("update TalentInvitation t set t.status='EXPIRED', t.activeKey=null, t.decidedAt=:now, " + + "t.version=t.version+1 where t.id=:id and t.status='PENDING' and t.expiresAt<=:now") + int expire(@Param("id") Long id, @Param("now") LocalDateTime now); +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationService.java new file mode 100644 index 0000000..152df9a --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/TalentInvitationService.java @@ -0,0 +1,373 @@ +package com.mydreamjob.talentinvitation; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.audit.SecurityAuditService; +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.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.recommendation.JobRecommendationProfile; +import com.mydreamjob.recommendation.JobRecommendationProfileRepository; +import com.mydreamjob.review.ReviewModerationService; +import com.mydreamjob.safety.BlockRelationRepository; +import com.mydreamjob.talentinvitation.dto.CompanyTalentInvitationResponse; +import com.mydreamjob.talentinvitation.dto.CreateTalentInvitationRequest; +import com.mydreamjob.talentinvitation.dto.StudentTalentInvitationResponse; +import com.mydreamjob.talentinvitation.dto.TalentInvitationDecisionRequest; +import com.mydreamjob.talentinvitation.dto.TalentInvitationPageResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.orm.ObjectOptimisticLockingFailureException; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.*; + +/** V42 邀约状态机、归属校验、幂等和接受后会话编排。 */ +@Service +@RequiredArgsConstructor +public class TalentInvitationService { + private static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + private static final int TTL_DAYS = 7; + private static final int COOL_DOWN_DAYS = 30; + private static final int DAILY_COMPANY_LIMIT = 100; + private static final int DAILY_JOB_LIMIT = 20; + private static final ObjectMapper JSON = new ObjectMapper(); + + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; + private final TalentInvitationRepository invitationRepository; + private final TalentInvitationHistoryRepository historyRepository; + private final UserRepository userRepository; + private final CompanyRepository companyRepository; + private final JobRepository jobRepository; + private final JobRecommendationProfileRepository profileRepository; + private final TalentInvitationCandidateResolver candidateResolver; + private final TalentInvitationConversationService conversationService; + private final TalentInvitationExpiryService expiryService; + private final BlockRelationRepository blockRelationRepository; + private final ReviewModerationService moderationService; + private final AuditService auditService; + private final SecurityAuditService securityAuditService; + + @Transactional + public CompanyTalentInvitationResponse create(Long userId, Long jobId, CreateTalentInvitationRequest request, + AuditContext context) { + if (jobId == null || jobId <= 0) throw new BusinessException(ErrorCode.BAD_REQUEST); + Company company = requireVerifiedCompany(userId); + CreateValues values = validateCreateRequest(request); + + // 公司行锁把幂等、冷却和每日限额串在同一锁顺序内；避免并发 COUNT 后同时 INSERT。 + companyRepository.findByIdForUpdate(company.getId()).orElseThrow(() -> new BusinessException(ErrorCode.COMPANY_NOT_FOUND)); + Job job = requireOwnedJob(company, jobId); + String digest = sha256(values.candidateKey()); + TalentInvitation existingByKey = invitationRepository.findByCompanyIdAndIdempotencyKey(company.getId(), values.idempotencyKey()).orElse(null); + if (existingByKey != null) { + if (existingByKey.getJobId().equals(jobId) + && digest.equals(existingByKey.getCandidateKeyDigest()) + && values.message().equals(existingByKey.getMessage())) { + return toCompanyResponse(existingByKey, job); + } + throw new BusinessException(ErrorCode.TALENT_INVITATION_IDEMPOTENCY_CONFLICT); + } + if (!"PUBLISHED".equals(job.getStatus())) throw new BusinessException(ErrorCode.INVALID_JOB_STATUS_TRANSITION); + + JobRecommendationProfile profile = profileRepository.findByJobId(jobId).orElse(null); + if (profile == null || !Boolean.TRUE.equals(profile.getEnabled()) + || !JobRecommendationProfile.APPROVED.equals(profile.getReviewStatus())) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_CANDIDATE_UNAVAILABLE); + } + LocalDateTime now = LocalDateTime.now(BUSINESS_ZONE); + TalentInvitationCandidateResolver.Resolution resolution = candidateResolver.resolve(company.getId(), jobId, values.candidateKey(), now); + if (!resolution.matched()) throw new BusinessException(ErrorCode.TALENT_INVITATION_CANDIDATE_UNAVAILABLE); + + if (invitationRepository.findByCompanyIdAndJobIdAndStudentUserIdAndStatus( + company.getId(), jobId, resolution.studentUserId(), TalentInvitation.PENDING).isPresent()) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_ALREADY_ACTIVE); + } + LocalDateTime cooldownSince = now.minusDays(COOL_DOWN_DAYS); + if (invitationRepository.existsInCooldown(company.getId(), resolution.studentUserId(), cooldownSince)) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_ALREADY_ACTIVE); + } + LocalDateTime dayStart = now.toLocalDate().atStartOfDay(); + LocalDateTime nextDay = dayStart.plusDays(1); + if (invitationRepository.countJobCreatedBetween(company.getId(), jobId, dayStart, nextDay) >= DAILY_JOB_LIMIT + || invitationRepository.countCreatedBetween(company.getId(), dayStart, nextDay) >= DAILY_COMPANY_LIMIT) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_RATE_LIMITED); + } + ReviewModerationService.ModerationResult moderation = moderationService.moderateCompanyReply(values.message()); + if (!moderation.getReasonCodes().isEmpty()) { + auditRejected(userId, company.getId(), jobId, context); + throw new BusinessException(ErrorCode.TALENT_INVITATION_CONTENT_INVALID); + } + + TalentInvitation invitation = TalentInvitation.builder() + .companyId(company.getId()).jobId(jobId).studentUserId(resolution.studentUserId()) + .candidateKeyDigest(digest).message(values.message()).idempotencyKey(values.idempotencyKey()) + .activeKey(company.getId() + ":" + jobId + ":" + resolution.studentUserId()) + .status(TalentInvitation.PENDING).expiresAt(now.plusDays(TTL_DAYS)).version(0L).build(); + try { + invitation = invitationRepository.saveAndFlush(invitation); + } catch (DataIntegrityViolationException ex) { + // 公司行锁正常情况下已串行；唯一约束是异常路径的最终防线，统一转换为业务冲突。 + throw new BusinessException(ErrorCode.TALENT_INVITATION_ALREADY_ACTIVE); + } + historyRepository.save(TalentInvitationHistory.builder().invitationId(invitation.getId()) + .action(TalentInvitationHistory.CREATED).actorUserId(userId).build()); + audit(userId, "TALENT_INVITATION_CREATED", invitation, context); + return toCompanyResponse(invitation, job); + } + + @Transactional(readOnly = true) + public TalentInvitationPageResponse listCompany(Long userId, int page, int size) { + validatePage(page, size); + Company company = requireVerifiedCompany(userId); + Page invitations = invitationRepository.findByCompanyIdOrderByCreatedAtDescIdDesc( + company.getId(), PageRequest.of(page, size)); + List jobIds = invitations.getContent().stream().map(TalentInvitation::getJobId).distinct().toList(); + Map jobs = new HashMap<>(); + jobRepository.findAllById(jobIds).forEach(job -> jobs.put(job.getId(), job)); + List items = invitations.getContent().stream() + .map(inv -> toCompanyResponse(inv, jobs.get(inv.getJobId()))).toList(); + return page(items, invitations); + } + + @Transactional(readOnly = true) + public CompanyTalentInvitationResponse getCompany(Long userId, Long invitationId, AuditContext context) { + Company company = requireVerifiedCompany(userId); + TalentInvitation invitation = invitationRepository.findById(invitationId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + if (!company.getId().equals(invitation.getCompanyId())) { + // 跨企业邀约统一按越权处理，不返回岗位/候选等任何业务字段。 + throw new BusinessException(ErrorCode.FORBIDDEN); + } + if (expireIfDue(invitation, context)) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_EXPIRED); + } + Job job = jobRepository.findById(invitation.getJobId()) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + return toCompanyResponse(invitationRepository.findById(invitationId).orElse(invitation), job); + } + + @Transactional(readOnly = true) + public TalentInvitationPageResponse listStudent(Long userId, int page, int size) { + userRoleGuard.requireStudent(userId); + validatePage(page, size); + Page invitations = invitationRepository.findByStudentUserIdOrderByCreatedAtDescIdDesc( + userId, PageRequest.of(page, size)); + List jobIds = invitations.getContent().stream().map(TalentInvitation::getJobId).distinct().toList(); + List companyIds = invitations.getContent().stream().map(TalentInvitation::getCompanyId).distinct().toList(); + Map jobs = new HashMap<>(); + Map companies = new HashMap<>(); + jobRepository.findAllById(jobIds).forEach(job -> jobs.put(job.getId(), job)); + companyRepository.findAllById(companyIds).forEach(company -> companies.put(company.getId(), company)); + List items = invitations.getContent().stream() + .map(inv -> toStudentResponse(inv, jobs.get(inv.getJobId()), companies.get(inv.getCompanyId()))).toList(); + return pageStudent(items, invitations); + } + + @Transactional + public StudentTalentInvitationResponse getStudent(Long userId, Long invitationId, AuditContext context) { + userRoleGuard.requireStudent(userId); + TalentInvitation invitation = invitationRepository.findByIdAndStudentUserId(invitationId, userId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + if (expireIfDue(invitation, context)) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_EXPIRED); + } + TalentInvitation current = invitationRepository.findById(invitationId).orElse(invitation); + Job job = jobRepository.findById(current.getJobId()) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + Company company = companyRepository.findById(current.getCompanyId()) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + return toStudentResponse(current, job, company); + } + + @Transactional + public StudentTalentInvitationResponse decide(Long userId, Long invitationId, TalentInvitationDecisionRequest request, + AuditContext context) { + userRoleGuard.requireStudent(userId); + if (request == null || request.getDecision() == null || request.getExpectedVersion() == null + || !("ACCEPT".equals(request.getDecision()) || "REJECT".equals(request.getDecision()))) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_CONTENT_INVALID); + } + TalentInvitation invitation = invitationRepository.findByIdAndStudentUserId(invitationId, userId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + LocalDateTime now = LocalDateTime.now(BUSINESS_ZONE); + if (TalentInvitation.PENDING.equals(invitation.getStatus()) && !invitation.getExpiresAt().isAfter(now)) { + if (expiryService.expireIfDue(invitationId, now, context)) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_EXPIRED); + } + } + TalentInvitation current = invitationRepository.findByIdAndStudentUserId(invitationId, userId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + String target = "ACCEPT".equals(request.getDecision()) ? TalentInvitation.ACCEPTED : TalentInvitation.REJECTED; + if (!TalentInvitation.PENDING.equals(current.getStatus())) { + if (target.equals(current.getStatus())) return studentResponse(current); + if (TalentInvitation.EXPIRED.equals(current.getStatus())) throw new BusinessException(ErrorCode.TALENT_INVITATION_EXPIRED); + throw new BusinessException(ErrorCode.TALENT_INVITATION_INVALID_STATE); + } + if (TalentInvitation.ACCEPTED.equals(target) && isBlocked(current)) { + throw new BusinessException(ErrorCode.FORBIDDEN); + } + int updated; + try { + updated = invitationRepository.decide(invitationId, userId, target, request.getExpectedVersion(), now, now); + } catch (ObjectOptimisticLockingFailureException ex) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_CONCURRENT_UPDATE); + } + if (updated != 1) { + TalentInvitation after = invitationRepository.findByIdAndStudentUserId(invitationId, userId).orElse(null); + if (after != null && target.equals(after.getStatus())) return studentResponse(after); + if (after != null && TalentInvitation.EXPIRED.equals(after.getStatus())) throw new BusinessException(ErrorCode.TALENT_INVITATION_EXPIRED); + throw new BusinessException(ErrorCode.TALENT_INVITATION_CONCURRENT_UPDATE); + } + TalentInvitation saved = invitationRepository.findByIdAndStudentUserId(invitationId, userId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + Job job = jobRepository.findById(saved.getJobId()).orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + Company company = companyRepository.findById(saved.getCompanyId()).orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + if (TalentInvitation.ACCEPTED.equals(target)) { + Long conversationId = conversationService.createForAcceptedInvitation(saved, company.getOwnerUserId(), job); + if (invitationRepository.attachConversation(saved.getId(), userId, conversationId, saved.getVersion()) != 1) { + throw new BusinessException(ErrorCode.TALENT_INVITATION_CONCURRENT_UPDATE); + } + saved = invitationRepository.findByIdAndStudentUserId(saved.getId(), userId) + .orElseThrow(() -> new BusinessException(ErrorCode.TALENT_INVITATION_NOT_FOUND)); + } + historyRepository.save(TalentInvitationHistory.builder().invitationId(saved.getId()).action( + TalentInvitation.ACCEPTED.equals(target) ? TalentInvitationHistory.ACCEPTED : TalentInvitationHistory.REJECTED) + .actorUserId(userId).build()); + audit(userId, TalentInvitation.ACCEPTED.equals(target) ? "TALENT_INVITATION_ACCEPTED" : "TALENT_INVITATION_REJECTED", saved, context); + return toStudentResponse(saved, job, company); + } + + private boolean expireIfDue(TalentInvitation invitation, AuditContext context) { + LocalDateTime now = LocalDateTime.now(BUSINESS_ZONE); + return TalentInvitation.PENDING.equals(invitation.getStatus()) && !invitation.getExpiresAt().isAfter(now) + && expiryService.expireIfDue(invitation.getId(), now, context); + } + + private boolean isBlocked(TalentInvitation invitation) { + return companyRepository.findById(invitation.getCompanyId()).map(company -> + blockRelationRepository.existsByBlockerUserIdAndBlockedUserId(company.getOwnerUserId(), invitation.getStudentUserId()) + || blockRelationRepository.existsByBlockerUserIdAndBlockedUserId(invitation.getStudentUserId(), company.getOwnerUserId()) + ).orElse(false); + } + + private TalentInvitationPageResponse page(List items, Page p) { + return TalentInvitationPageResponse.builder().items(items).total(p.getTotalElements()) + .page(p.getNumber()).size(p.getSize()).totalPages(p.getTotalPages()).build(); + } + + private TalentInvitationPageResponse pageStudent(List items, Page p) { + return TalentInvitationPageResponse.builder().items(items).total(p.getTotalElements()) + .page(p.getNumber()).size(p.getSize()).totalPages(p.getTotalPages()).build(); + } + + private CompanyTalentInvitationResponse toCompanyResponse(TalentInvitation inv, Job job) { + return CompanyTalentInvitationResponse.builder().invitationId(inv.getId()).jobId(inv.getJobId()) + .jobTitle(job == null ? null : job.getTitle()).candidateLabel("开放人才候选人") + .message(inv.getMessage()).status(inv.getStatus()).createdAt(inv.getCreatedAt()) + .expiresAt(inv.getExpiresAt()).decidedAt(inv.getDecidedAt()) + .conversationId(TalentInvitation.ACCEPTED.equals(inv.getStatus()) ? inv.getConversationId() : null).build(); + } + + private StudentTalentInvitationResponse toStudentResponse(TalentInvitation inv, Job job, Company company) { + return StudentTalentInvitationResponse.builder().invitationId(inv.getId()).companyId(inv.getCompanyId()) + .companyName(company == null ? null : company.getName()).jobId(inv.getJobId()) + .jobTitle(job == null ? null : job.getTitle()).jobCity(job == null ? null : job.getCity()) + .message(inv.getMessage()).status(inv.getStatus()).version(inv.getVersion()) + .createdAt(inv.getCreatedAt()).expiresAt(inv.getExpiresAt()).decidedAt(inv.getDecidedAt()) + .conversationId(TalentInvitation.ACCEPTED.equals(inv.getStatus()) ? inv.getConversationId() : null).build(); + } + + private StudentTalentInvitationResponse studentResponse(TalentInvitation inv) { + Job job = jobRepository.findById(inv.getJobId()).orElse(null); + Company company = companyRepository.findById(inv.getCompanyId()).orElse(null); + return toStudentResponse(inv, job, company); + } + + private Company requireVerifiedCompany(Long userId) { + User user = requireUser(userId); + if (!hasRole(user, User.Role.COMPANY)) throw new BusinessException(ErrorCode.FORBIDDEN); + Company company = companyRepository.findByOwnerUserId(userId).orElseThrow(() -> new BusinessException(ErrorCode.COMPANY_NOT_FOUND)); + if (!Boolean.TRUE.equals(company.getVerified())) throw new BusinessException(ErrorCode.FORBIDDEN); + return company; + } + + private Job requireOwnedJob(Company company, Long jobId) { + Job job = jobRepository.findById(jobId).orElseThrow(() -> new BusinessException(ErrorCode.JOB_NOT_FOUND)); + if (!company.getId().equals(job.getCompanyId())) throw new BusinessException(ErrorCode.FORBIDDEN); + return job; + } + private User requireUser(Long userId) { + if (userId == null) throw new BusinessException(ErrorCode.UNAUTHORIZED); + return userRepository.findById(userId).orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); + } + + private boolean hasRole(User user, User.Role role) { + return user != null && ((user.getRoles() != null && user.getRoles().contains(role)) || user.getRole() == role); + } + + private void validatePage(int page, int size) { + if (page < 0 || size < 1 || size > 50) throw new BusinessException(ErrorCode.BAD_REQUEST); + } + + private CreateValues validateCreateRequest(CreateTalentInvitationRequest request) { + String key = request == null ? null : trim(request.getCandidateKey()); + String message = request == null ? null : trim(request.getMessage()); + String idempotency = request == null ? null : trim(request.getIdempotencyKey()); + if (key == null || key.length() > 128 || message == null || message.length() < 1 || message.length() > 300 + || idempotency == null || idempotency.length() > 64) throw new BusinessException(ErrorCode.TALENT_INVITATION_CONTENT_INVALID); + try { UUID.fromString(idempotency); } catch (IllegalArgumentException ex) { throw new BusinessException(ErrorCode.TALENT_INVITATION_CONTENT_INVALID); } + return new CreateValues(key, message, idempotency); + } + + private String trim(String value) { if (value == null) return null; String v = value.trim(); return v.isEmpty() ? null : v; } + + private String sha256(String value) { + try { + byte[] bytes = MessageDigest.getInstance("SHA-256").digest(value.getBytes(StandardCharsets.UTF_8)); + StringBuilder out = new StringBuilder(64); + for (byte b : bytes) out.append(String.format("%02x", b)); + return out.toString(); + } catch (Exception ex) { throw new IllegalStateException("SHA-256 unavailable", ex); } + } + + private void audit(Long userId, String action, TalentInvitation invitation, AuditContext context) { + auditService.log(userId, action, "TALENT_INVITATION", invitation.getId(), auditDetails(invitation, context), requestOnly(context)); + } + + private void auditRejected(Long userId, Long companyId, Long jobId, AuditContext context) { + securityAuditService.logRejected(userId, "TALENT_INVITATION_CREATE_REJECTED", "TALENT_INVITATION", null, + "{\"jobId\":" + jobId + ",\"status\":\"REJECTED\",\"requestId\":" + + (context == null || context.getRequestId() == null ? "null" : quote(context.getRequestId())) + "}", + requestOnly(context)); + } + + private String auditDetails(TalentInvitation invitation, AuditContext context) { + return "{\"invitationId\":" + invitation.getId() + ",\"jobId\":" + invitation.getJobId() + + ",\"status\":\"" + invitation.getStatus() + "\",\"requestId\":" + + (context == null || context.getRequestId() == null ? "null" : quote(context.getRequestId())) + "}"; + } + + private AuditContext requestOnly(AuditContext context) { + return context == null ? null : AuditContext.builder().requestId(context.getRequestId()).build(); + } + + private String quote(String value) { return "\"" + value.replace("\\", "\\\\").replace("\"", "\\\"") + "\""; } + + private record CreateValues(String candidateKey, String message, String idempotencyKey) { } +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CompanyTalentInvitationResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CompanyTalentInvitationResponse.java new file mode 100644 index 0000000..4b7ed07 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CompanyTalentInvitationResponse.java @@ -0,0 +1,21 @@ +package com.mydreamjob.talentinvitation.dto; + +import lombok.Builder; +import lombok.Value; + +import java.time.LocalDateTime; + +@Value +@Builder +public class CompanyTalentInvitationResponse { + Long invitationId; + Long jobId; + String jobTitle; + String candidateLabel; + String message; + String status; + LocalDateTime createdAt; + LocalDateTime expiresAt; + LocalDateTime decidedAt; + Long conversationId; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CreateTalentInvitationRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CreateTalentInvitationRequest.java new file mode 100644 index 0000000..ac98ce6 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/CreateTalentInvitationRequest.java @@ -0,0 +1,12 @@ +package com.mydreamjob.talentinvitation.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import lombok.Data; + +@Data +public class CreateTalentInvitationRequest { + @NotBlank @Size(max = 128) private String candidateKey; + @NotBlank @Size(max = 300) private String message; + @NotBlank @Size(max = 64) private String idempotencyKey; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/StudentTalentInvitationResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/StudentTalentInvitationResponse.java new file mode 100644 index 0000000..943f062 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/StudentTalentInvitationResponse.java @@ -0,0 +1,24 @@ +package com.mydreamjob.talentinvitation.dto; + +import lombok.Builder; +import lombok.Value; + +import java.time.LocalDateTime; + +@Value +@Builder +public class StudentTalentInvitationResponse { + Long invitationId; + Long companyId; + String companyName; + Long jobId; + String jobTitle; + String jobCity; + String message; + String status; + Long version; + LocalDateTime createdAt; + LocalDateTime expiresAt; + LocalDateTime decidedAt; + Long conversationId; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationDecisionRequest.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationDecisionRequest.java new file mode 100644 index 0000000..90c6ca1 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationDecisionRequest.java @@ -0,0 +1,12 @@ +package com.mydreamjob.talentinvitation.dto; + +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Pattern; +import lombok.Data; + +@Data +public class TalentInvitationDecisionRequest { + @NotBlank @Pattern(regexp = "^(ACCEPT|REJECT)$") private String decision; + @NotNull private Long expectedVersion; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationPageResponse.java b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationPageResponse.java new file mode 100644 index 0000000..dc2afa4 --- /dev/null +++ b/mydreamjob-server/src/main/java/com/mydreamjob/talentinvitation/dto/TalentInvitationPageResponse.java @@ -0,0 +1,16 @@ +package com.mydreamjob.talentinvitation.dto; + +import lombok.Builder; +import lombok.Value; + +import java.util.List; + +@Value +@Builder +public class TalentInvitationPageResponse { + List items; + long total; + int page; + int size; + int totalPages; +} diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationController.java b/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationController.java index fb4995c..80eed45 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationController.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationController.java @@ -14,8 +14,6 @@ import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.http.ResponseEntity; -import org.springframework.security.core.Authentication; -import org.springframework.security.core.context.SecurityContextHolder; import org.springframework.web.bind.annotation.*; import java.time.LocalDateTime; @@ -34,6 +32,11 @@ import java.util.stream.Collectors; @RequiredArgsConstructor public class CompanyVerificationController { + /** R01-A3：身份只来自安全上下文，不接受请求参数传入的 userId。 */ + private final com.mydreamjob.security.CurrentUserAccessor currentUserAccessor; + /** R01-A3：requestId 只来自过滤器规范化后的唯一产出点。 */ + private final com.mydreamjob.common.logging.RequestIdAccessor requestIdAccessor; + private final CompanyVerificationService verificationService; // ── 企业：提交认证 ────────────────────────────────────────── @@ -43,10 +46,10 @@ public class CompanyVerificationController { public ResponseEntity>> submit( @Valid @RequestBody VerificationSubmitRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CompanyVerification verification = verificationService.submit(userId, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), requestIdAccessor.get(request))); } // ── 企业：查询认证状态 ────────────────────────────────────── @@ -55,9 +58,9 @@ public class CompanyVerificationController { @GetMapping("/companies/me/verification") public ResponseEntity>> getMyVerification( HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); CompanyVerification verification = verificationService.getMyVerification(userId); - return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), requestIdAccessor.get(request))); } // ── 管理员：待审核列表 ────────────────────────────────────── @@ -71,7 +74,7 @@ public class CompanyVerificationController { @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "20") int size, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); verificationService.assertAdminRole(userId); Page result = verificationService.listPending(status, from, to, page, size); Map data = new HashMap<>(); @@ -80,7 +83,7 @@ public class CompanyVerificationController { data.put("page", result.getNumber()); data.put("size", result.getSize()); data.put("totalPages", result.getTotalPages()); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 管理员：认证详情 ──────────────────────────────────────── @@ -90,10 +93,10 @@ public class CompanyVerificationController { public ResponseEntity>> getDetail( @PathVariable Long id, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); verificationService.assertAdminRole(userId); CompanyVerification verification = verificationService.getDetail(id); - return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), requestIdAccessor.get(request))); } // ── 管理员：审核决定 ──────────────────────────────────────── @@ -104,11 +107,11 @@ public class CompanyVerificationController { @PathVariable Long id, @Valid @RequestBody VerificationDecisionRequest req, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); verificationService.assertAdminRole(userId); CompanyVerification verification = verificationService.decide(userId, id, req, AuditContext.from(request)); - return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(verificationService.toView(verification), requestIdAccessor.get(request))); } // ── 管理员：审核历史 ──────────────────────────────────────── @@ -118,22 +121,12 @@ public class CompanyVerificationController { public ResponseEntity>>> listHistory( @RequestParam Long verificationId, HttpServletRequest request) { - Long userId = resolveUserId(request); + Long userId = currentUserAccessor.requireUserId(); verificationService.assertAdminRole(userId); List> data = verificationService.getHistory(verificationId); - return ResponseEntity.ok(ApiResponse.ok(data, getRequestId(request))); + return ResponseEntity.ok(ApiResponse.ok(data, requestIdAccessor.get(request))); } // ── 辅助 ──────────────────────────────────────────────────── - private Long resolveUserId(HttpServletRequest request) { - Authentication auth = SecurityContextHolder.getContext().getAuthentication(); - if (auth == null || !auth.isAuthenticated()) - throw new BusinessException(ErrorCode.UNAUTHORIZED); - return Long.valueOf(auth.getName()); - } - - private String getRequestId(HttpServletRequest request) { - return request.getHeader("X-Request-Id"); - } } \ No newline at end of file diff --git a/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationService.java b/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationService.java index 416bda8..adc4697 100644 --- a/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationService.java +++ b/mydreamjob-server/src/main/java/com/mydreamjob/verification/CompanyVerificationService.java @@ -13,6 +13,7 @@ import com.mydreamjob.verification.dto.VerificationDecisionRequest; import com.mydreamjob.verification.dto.VerificationSubmitRequest; import jakarta.persistence.EntityManager; import jakarta.persistence.PersistenceContext; +import com.mydreamjob.security.UserRoleGuard; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.dao.OptimisticLockingFailureException; @@ -34,6 +35,7 @@ public class CompanyVerificationService { private static final int MAX_PAGE_SIZE = 100; + private final com.mydreamjob.security.UserRoleGuard userRoleGuard; private final CompanyVerificationRepository verificationRepository; private final CompanyVerificationHistoryRepository historyRepository; private final CompanyRepository companyRepository; @@ -244,11 +246,7 @@ public class CompanyVerificationService { } public void assertAdminRole(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); - if (!hasRole(user, User.Role.ADMIN)) { - throw new BusinessException(ErrorCode.FORBIDDEN); - } + userRoleGuard.requireAdmin(userId); } private void recordHistory(Long verificationId, String fromStatus, String toStatus, diff --git a/mydreamjob-server/src/main/resources/application-dev.example.yml b/mydreamjob-server/src/main/resources/application-dev.example.yml index ac0f869..c8173b9 100644 --- a/mydreamjob-server/src/main/resources/application-dev.example.yml +++ b/mydreamjob-server/src/main/resources/application-dev.example.yml @@ -21,6 +21,9 @@ spring: app: jwt: secret: ${JWT_SECRET} + access-secret: ${JWT_ACCESS_SECRET} + refresh-secret: ${JWT_REFRESH_SECRET} + token-hash-secret: ${JWT_TOKEN_HASH_SECRET} expiration-ms: 86400000 refresh-expiration-ms: 604800000 diff --git a/mydreamjob-server/src/main/resources/application.yml b/mydreamjob-server/src/main/resources/application.yml index 4888c0f..6c2ad5a 100644 --- a/mydreamjob-server/src/main/resources/application.yml +++ b/mydreamjob-server/src/main/resources/application.yml @@ -74,15 +74,37 @@ spring: fail-on-unknown-properties: false # JWT +# S02：Access 与 Refresh 使用独立签名密钥，另设独立的 Token 摘要密钥。 +# 三项密钥均无默认值，缺失即启动失败（见 AppJwtProperties 校验）。 app: + company-registration: + enabled: ${COMPANY_REGISTRATION_ENABLED:false} jwt: - secret: ${JWT_SECRET} + # 旧配置迁移项：S02 签发/校验的 Token **不使用**该密钥，不得回退到它。 + # 仍保留是因为 talentdiscovery.CandidateKeyGenerator 用它派生候选人展示键； + # 该组件在密钥为空时自行失败关闭。这里改为**非强制解析**，使未配置 JWT_SECRET + # 的环境也能启动（Token 安全性完全由下面三项独立密钥承担）。 + secret: ${JWT_SECRET:} + access-secret: ${JWT_ACCESS_SECRET} + refresh-secret: ${JWT_REFRESH_SECRET} + token-hash-secret: ${JWT_TOKEN_HASH_SECRET} expiration-ms: ${JWT_EXPIRATION_MS:86400000} + refresh-expiration-ms: ${JWT_REFRESH_EXPIRATION_MS:604800000} + issuer: mydreamjob + access-audience: mydreamjob-api + refresh-audience: mydreamjob-auth + + # S03-A：一次性管理员初始化。默认关闭；手机号无默认值，必须由部署方显式提供。 + # 初始化成功后部署方必须移除该开关，普通启动不得隐式创建管理员。 + bootstrap: + admin: + enabled: ${ADMIN_BOOTSTRAP_ENABLED:false} + phone: ${ADMIN_BOOTSTRAP_PHONE:} + nickname: ${ADMIN_BOOTSTRAP_NICKNAME:平台管理员} resume: storage-type: ${RESUME_STORAGE_TYPE:local} storage-dir: ${RESUME_STORAGE_DIR:./resumes} export-dir: ${RESUME_EXPORT_DIR:./resume-exports} - refresh-expiration-ms: ${JWT_REFRESH_EXPIRATION_MS:604800000} async: resume-export: @@ -106,6 +128,17 @@ app: max-attempts: 5 lockout-seconds: ${SMS_LOCKOUT_SECONDS:300} + auth: + password: + enabled: ${PASSWORD_LOGIN_ENABLED:false} + rate-key-secret: ${PASSWORD_RATE_KEY_SECRET:} + max-failures: ${PASSWORD_MAX_FAILURES:5} + lockout-seconds: ${PASSWORD_LOCKOUT_SECONDS:900} + ip-window-seconds: ${PASSWORD_IP_WINDOW_SECONDS:600} + ip-max-attempts: ${PASSWORD_IP_MAX_ATTEMPTS:30} + operation-window-seconds: ${PASSWORD_OPERATION_WINDOW_SECONDS:600} + operation-max-attempts: ${PASSWORD_OPERATION_MAX_ATTEMPTS:10} + offer: scheduler: enabled: ${OFFER_SCHEDULER_ENABLED:true} @@ -129,27 +162,54 @@ app: header-name: X-Request-Id generate-on-missing: true + # R01-D4-2：GET 评分接口只读，快照由写侧登记任务、后台物化和补偿扫描维护。 + # 生产默认启用；测试环境可在 profile 中显式关闭，避免后台线程干扰确定性测试。 + scoring: + refresh: + enabled: ${SCORING_REFRESH_ENABLED:true} + worker-interval-ms: ${SCORING_REFRESH_WORKER_INTERVAL_MS:60000} + compensation-enabled: ${SCORING_REFRESH_COMPENSATION_ENABLED:true} + compensation-interval-ms: ${SCORING_REFRESH_COMPENSATION_INTERVAL_MS:3600000} + compensation-limit: ${SCORING_REFRESH_COMPENSATION_LIMIT:100} + batch-size: ${SCORING_REFRESH_BATCH_SIZE:20} + max-attempts: ${SCORING_REFRESH_MAX_ATTEMPTS:3} + retry-backoff-ms: ${SCORING_REFRESH_RETRY_BACKOFF_MS:300000} + processing-timeout-ms: ${SCORING_REFRESH_PROCESSING_TIMEOUT_MS:600000} + deletion: cooling-days: ${DELETION_COOLING_DAYS:30} phone-hash-secret: ${DELETION_PHONE_HASH_SECRET:mydreamjob-deletion-dev-secret-not-for-prod} - talent-match: - weight: - skill: ${TALENT_MATCH_WEIGHT_SKILL:0.40} - edu: ${TALENT_MATCH_WEIGHT_EDU:0.25} - exp: ${TALENT_MATCH_WEIGHT_EXP:0.20} - loc: ${TALENT_MATCH_WEIGHT_LOC:0.10} - score: ${TALENT_MATCH_WEIGHT_SCORE:0.05} +scoring: + ability-assessment: + enabled: ${SCORING_ABILITY_ASSESSMENT_ENABLED:false} + +recommendation: + assessment: + enabled: ${RECOMMENDATION_ASSESSMENT_ENABLED:false} management: + # S03-C：Actuator 隔离到独立管理端口，默认只绑定回环地址。 + # 业务端口不再提供 /actuator/metrics 与 /actuator/prometheus； + # 需要采集指标时由部署层通过受控网络或反向代理访问管理端口。 + server: + port: ${MANAGEMENT_SERVER_PORT:8081} + address: ${MANAGEMENT_SERVER_ADDRESS:127.0.0.1} endpoints: web: exposure: include: health,info,metrics,prometheus + # S03-C：显式开启 Prometheus 指标导出。仅暴露端点 ID 而不开启导出时， + # /actuator/prometheus 不会注册（暴露清单会指向一个不存在的端点）。 + prometheus: + metrics: + export: + enabled: true endpoint: health: - show-details: when-authorized - show-components: always + # 健康探针只返回最小 UP/DOWN，不暴露数据库、Redis、RabbitMQ、磁盘或连接池细节。 + show-details: never + show-components: never health: db: enabled: true diff --git a/mydreamjob-server/src/main/resources/db/migration/V34__riasec_assessment.sql b/mydreamjob-server/src/main/resources/db/migration/V34__riasec_assessment.sql new file mode 100644 index 0000000..a09f57b --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V34__riasec_assessment.sql @@ -0,0 +1,271 @@ +-- Flyway V34: RIASEC 职业兴趣测评模块（功能版本 V35） +-- +-- 基于 RIASEC 理论的自研题库，仅供职业兴趣探索参考，不构成心理或职业诊断。 +-- 新增 6 张表：测评定义、题目、答卷主记录、答卷抽中题目、答案、结果。 +-- 每次答卷由后端从六个维度中各随机抽取 5 道，共 30 道。 +-- dimension_scores_text / type_ranking_text 使用 TEXT 保存 JSON 字符串，不使用数据库 JSON 列， +-- 以保持 MySQL 8 与 H2 MODE=MySQL 兼容。 +-- 迁移由 Flyway 精确执行一次，不会重复插入。 + +-- 1) 测评定义 +CREATE TABLE assessment_definitions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + type_code VARCHAR(40) NOT NULL, + display_name VARCHAR(100) NOT NULL, + description VARCHAR(1000) NULL, + instructions TEXT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE', + scale_type VARCHAR(20) NOT NULL, + question_count INT NOT NULL, + attempt_question_count INT NOT NULL, + min_per_dimension INT NOT NULL, + question_set_version VARCHAR(40) NOT NULL, + rules_version VARCHAR(40) NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_assessment_definitions_type UNIQUE (type_code) +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- 2) 题目（72 道，六维各 12） +CREATE TABLE assessment_questions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + question_code VARCHAR(20) NOT NULL, + definition_id BIGINT NOT NULL, + position INT NOT NULL, + dimension VARCHAR(1) NOT NULL, + stem VARCHAR(2000) NOT NULL, + scale_type VARCHAR(20) NOT NULL, + question_version VARCHAR(40) NOT NULL, + source VARCHAR(40) NOT NULL, + reverse_scored TINYINT NOT NULL DEFAULT 0, + active TINYINT NOT NULL DEFAULT 1, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_assessment_questions_code UNIQUE (definition_id, question_code), + CONSTRAINT uk_assessment_questions_position UNIQUE (definition_id, position), + CONSTRAINT fk_assessment_questions_definition + FOREIGN KEY (definition_id) + REFERENCES assessment_definitions(id), + CONSTRAINT chk_assessment_questions_dimension + CHECK (dimension IN ('R', 'I', 'A', 'S', 'E', 'C')), + CONSTRAINT chk_assessment_questions_reverse + CHECK (reverse_scored IN (0, 1)) +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- 3) 答卷主记录 +CREATE TABLE assessment_attempts ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + student_user_id BIGINT NOT NULL, + definition_id BIGINT NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'DRAFT', + sampling_seed BIGINT NULL, + question_set_version VARCHAR(40) NOT NULL, + selected_question_count INT NOT NULL, + answered_count INT NOT NULL DEFAULT 0, + idempotency_key VARCHAR(64) NULL, + active_key VARCHAR(255) NULL, + version BIGINT NOT NULL DEFAULT 0, + started_at DATETIME NULL, + submitted_at DATETIME NULL, + completed_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_assessment_attempts_idem UNIQUE (student_user_id, idempotency_key), + -- active_key 全局唯一：DRAFT/IN_PROGRESS 时非空（studentId:definitionId:ACTIVE）， + -- COMPLETED/EXPIRED 后置 NULL。多 NULL 不冲突，从而在数据库层原子保证 + -- “同一学生、同一测评类型最多一份活跃答卷”，并发创建只会成功一份。 + CONSTRAINT uk_assessment_attempts_active UNIQUE (active_key), + CONSTRAINT chk_assessment_attempts_status + CHECK (status IN ('DRAFT', 'IN_PROGRESS', 'COMPLETED', 'EXPIRED')), + CONSTRAINT fk_assessment_attempts_user + FOREIGN KEY (student_user_id) + REFERENCES users(id) + ON DELETE CASCADE, + CONSTRAINT fk_assessment_attempts_definition + FOREIGN KEY (definition_id) + REFERENCES assessment_definitions(id), + + INDEX idx_assessment_attempts_student_created (student_user_id, created_at) +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- 4) 本次随机抽中的题目（30 道） +CREATE TABLE assessment_attempt_questions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + question_id BIGINT NOT NULL, + position INT NOT NULL, + selected_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uk_assessment_aq_attempt_question UNIQUE (attempt_id, question_id), + CONSTRAINT uk_assessment_aq_position UNIQUE (attempt_id, position), + CONSTRAINT fk_assessment_aq_attempt + FOREIGN KEY (attempt_id) + REFERENCES assessment_attempts(id) + ON DELETE CASCADE, + CONSTRAINT fk_assessment_aq_question + FOREIGN KEY (question_id) + REFERENCES assessment_questions(id), + + INDEX idx_assessment_aq_attempt (attempt_id) +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- 5) 答案 +CREATE TABLE assessment_answers ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + question_id BIGINT NOT NULL, + answer_value INT NOT NULL, + answered_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uk_assessment_answers_attempt_question UNIQUE (attempt_id, question_id), + CONSTRAINT chk_assessment_answers_value CHECK (answer_value BETWEEN 1 AND 5), + CONSTRAINT fk_assessment_answers_attempt + FOREIGN KEY (attempt_id) + REFERENCES assessment_attempts(id) + ON DELETE CASCADE, + CONSTRAINT fk_assessment_answers_question + FOREIGN KEY (question_id) + REFERENCES assessment_questions(id) +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- 6) 结果（一份答卷至多一条结果，attempt_id 唯一，用于幂等防重复生成） +CREATE TABLE assessment_results ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + primary_code VARCHAR(3) NOT NULL, + primary_type VARCHAR(1) NOT NULL, + dimension_scores_text TEXT NULL, + type_ranking_text TEXT NULL, + answered_count INT NOT NULL, + completion_rate DECIMAL(5,2) NOT NULL, + question_set_version VARCHAR(40) NOT NULL, + rules_version VARCHAR(40) NOT NULL, + generated_at DATETIME NOT NULL, + version BIGINT NOT NULL DEFAULT 0, + + CONSTRAINT uk_assessment_results_attempt UNIQUE (attempt_id), + CONSTRAINT fk_assessment_results_attempt + FOREIGN KEY (attempt_id) + REFERENCES assessment_attempts(id) + ON DELETE CASCADE +) ENGINE=InnoDB + DEFAULT CHARSET=utf8mb4 + COLLATE=utf8mb4_unicode_ci; + +-- ===================================================================== +-- 种子数据：一条测评定义 + 72 道题（R/I/A/S/E/C 各 12 道，position 1-72） +-- ===================================================================== +INSERT INTO assessment_definitions + (type_code, display_name, description, instructions, status, scale_type, + question_count, attempt_question_count, min_per_dimension, + question_set_version, rules_version) +VALUES ( + 'HOLLAND_RIASEC', + 'RIASEC 职业兴趣测评', + '基于 RIASEC 理论的自研题库，仅供职业兴趣探索参考，不构成心理或职业诊断。', + '请根据你对每项职业活动的兴趣程度作答：1=完全不感兴趣，2=不太感兴趣，3=一般，4=比较感兴趣，5=非常感兴趣。', + 'ACTIVE', + 'LIKERT_5', + 72, + 30, + 5, + 'riasec-self-v0.2', + 'riasec-scoring-v0.1' +); + +INSERT INTO assessment_questions + (question_code, definition_id, position, dimension, stem, + scale_type, question_version, source, reverse_scored, active) +SELECT q.question_code, d.id, q.position, q.dimension, q.stem, + 'LIKERT_5', 'v0.2', 'SELF_AUTHORED', 0, 1 +FROM ( + SELECT 'R01' AS question_code, 1 AS position, 'R' AS dimension, '我对使用手工工具制作物品感兴趣。' AS stem + UNION ALL SELECT 'R02', 2, 'R', '我喜欢按照图纸组装模型。' + UNION ALL SELECT 'R03', 3, 'R', '我对学习操作 3D 打印机感兴趣。' + UNION ALL SELECT 'R04', 4, 'R', '我对在户外进行现场操作类工作感兴趣。' + UNION ALL SELECT 'R05', 5, 'R', '我喜欢参与植物种植和养护。' + UNION ALL SELECT 'R06', 6, 'R', '我对拆装和更换电脑硬件部件感兴趣。' + UNION ALL SELECT 'R07', 7, 'R', '我对制作木制品感兴趣。' + UNION ALL SELECT 'R08', 8, 'R', '我对学习操作无人机感兴趣。' + UNION ALL SELECT 'R09', 9, 'R', '我对通过动手操作获得实体成果感兴趣。' + UNION ALL SELECT 'R10', 10, 'R', '我对了解建筑结构的实际施工过程感兴趣。' + UNION ALL SELECT 'R11', 11, 'R', '我喜欢观察机械装置的运动原理。' + UNION ALL SELECT 'R12', 12, 'R', '我对设备安装与调试工作感兴趣。' + UNION ALL SELECT 'I01', 13, 'I', '我喜欢探究复杂问题背后的原因和运作机制。' + UNION ALL SELECT 'I02', 14, 'I', '我对数独、逻辑推理题或解谜游戏感兴趣。' + UNION ALL SELECT 'I03', 15, 'I', '我喜欢阅读科学研究成果。' + UNION ALL SELECT 'I04', 16, 'I', '我对通过收集数据分析未知问题感兴趣。' + UNION ALL SELECT 'I05', 17, 'I', '我对阅读技术白皮书感兴趣。' + UNION ALL SELECT 'I06', 18, 'I', '我对设计测试方案验证某个假设感兴趣。' + UNION ALL SELECT 'I07', 19, 'I', '我喜欢研究数学模型。' + UNION ALL SELECT 'I08', 20, 'I', '我对核查原始事实和数据来源感兴趣。' + UNION ALL SELECT 'I09', 21, 'I', '我喜欢独立钻研专业领域的课题。' + UNION ALL SELECT 'I10', 22, 'I', '我对研究新技术产品的底层架构感兴趣。' + UNION ALL SELECT 'I11', 23, 'I', '我喜欢探究自然现象的运作机制。' + UNION ALL SELECT 'I12', 24, 'I', '我对通过实验或模拟比较不同方案感兴趣。' + UNION ALL SELECT 'A01', 25, 'A', '我对创作故事感兴趣。' + UNION ALL SELECT 'A02', 26, 'A', '我喜欢研究摄影构图。' + UNION ALL SELECT 'A03', 27, 'A', '我对创作音乐作品感兴趣。' + UNION ALL SELECT 'A04', 28, 'A', '我喜欢尝试不同的创作方法。' + UNION ALL SELECT 'A05', 29, 'A', '我喜欢参观艺术展览。' + UNION ALL SELECT 'A06', 30, 'A', '我对构思新项目的创意方案感兴趣。' + UNION ALL SELECT 'A07', 31, 'A', '我对设计短视频分镜感兴趣。' + UNION ALL SELECT 'A08', 32, 'A', '我喜欢设计具有个人特色的视觉风格。' + UNION ALL SELECT 'A09', 33, 'A', '我对从零开始构思原创作品感兴趣。' + UNION ALL SELECT 'A10', 34, 'A', '我对进行三维视觉建模感兴趣。' + UNION ALL SELECT 'A11', 35, 'A', '我对将情感转化为艺术表达感兴趣。' + UNION ALL SELECT 'A12', 36, 'A', '我对舞台视觉设计感兴趣。' + UNION ALL SELECT 'S01', 37, 'S', '我乐于倾听他人的烦恼。' + UNION ALL SELECT 'S02', 38, 'S', '我对向他人讲解新知识感兴趣。' + UNION ALL SELECT 'S03', 39, 'S', '我愿意参与社区互助活动。' + UNION ALL SELECT 'S04', 40, 'S', '我对了解他人的情绪和感受感兴趣。' + UNION ALL SELECT 'S05', 41, 'S', '我喜欢与不同背景的人交流。' + UNION ALL SELECT 'S06', 42, 'S', '我对职业规划咨询相关工作感兴趣。' + UNION ALL SELECT 'S07', 43, 'S', '我对协助团队成员增进理解感兴趣。' + UNION ALL SELECT 'S08', 44, 'S', '我对参与健康知识普及活动感兴趣。' + UNION ALL SELECT 'S09', 45, 'S', '我对帮助他人改善生活状态感兴趣。' + UNION ALL SELECT 'S10', 46, 'S', '我喜欢组织团队交流活动。' + UNION ALL SELECT 'S11', 47, 'S', '我对了解不同人的实际需求感兴趣。' + UNION ALL SELECT 'S12', 48, 'S', '我对参与青少年成长指导感兴趣。' + UNION ALL SELECT 'E01', 49, 'E', '我对负责推进团队项目感兴趣。' + UNION ALL SELECT 'E02', 50, 'E', '我对向客户介绍产品方案感兴趣。' + UNION ALL SELECT 'E03', 51, 'E', '我对参与商业项目策划感兴趣。' + UNION ALL SELECT 'E04', 52, 'E', '我喜欢研究企业的商业模式。' + UNION ALL SELECT 'E05', 53, 'E', '我对设定挑战性目标并争取达成感兴趣。' + UNION ALL SELECT 'E06', 54, 'E', '我喜欢协调不同人员共同完成目标。' + UNION ALL SELECT 'E07', 55, 'E', '我对进行公开方案演讲感兴趣。' + UNION ALL SELECT 'E08', 56, 'E', '我对评估商业机会感兴趣。' + UNION ALL SELECT 'E09', 57, 'E', '我对统筹项目整体规划感兴趣。' + UNION ALL SELECT 'E10', 58, 'E', '我对拓展职业社交圈感兴趣。' + UNION ALL SELECT 'E11', 59, 'E', '我对推动团队达成核心目标感兴趣。' + UNION ALL SELECT 'E12', 60, 'E', '我对参与突发情况下的团队决策感兴趣。' + UNION ALL SELECT 'C01', 61, 'C', '我喜欢把文件、表格或数据整理得分类清晰。' + UNION ALL SELECT 'C02', 62, 'C', '我对核对数据并找出细微差异感兴趣。' + UNION ALL SELECT 'C03', 63, 'C', '我喜欢按照明确的标准操作流程开展工作。' + UNION ALL SELECT 'C04', 64, 'C', '我对财务记账工作感兴趣。' + UNION ALL SELECT 'C05', 65, 'C', '我喜欢仔细校对文档中的文字和格式。' + UNION ALL SELECT 'C06', 66, 'C', '我偏好流程清晰、职责明确的工作环境。' + UNION ALL SELECT 'C07', 67, 'C', '我喜欢制定时间表或任务清单。' + UNION ALL SELECT 'C08', 68, 'C', '我对审阅合同条款感兴趣。' + UNION ALL SELECT 'C09', 69, 'C', '我对使用电子表格处理数据感兴趣。' + UNION ALL SELECT 'C10', 70, 'C', '我喜欢维护资料的分类和归档秩序。' + UNION ALL SELECT 'C11', 71, 'C', '我对标准明确、需要细致核验的事务感兴趣。' + UNION ALL SELECT 'C12', 72, 'C', '我对按照信息安全流程管理资料感兴趣。' +) q +JOIN assessment_definitions d ON d.type_code = 'HOLLAND_RIASEC'; \ No newline at end of file diff --git a/mydreamjob-server/src/main/resources/db/migration/V35__ability_assessment.sql b/mydreamjob-server/src/main/resources/db/migration/V35__ability_assessment.sql new file mode 100644 index 0000000..0405fba --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V35__ability_assessment.sql @@ -0,0 +1,225 @@ +-- Flyway V35: 四维能力测评模块（功能版本 V36） +-- +-- 学生端四维能力测评：LOGIC / COMMUNICATION / EXECUTION / LEARNING。 +-- 48 道自研工作情境题，每题四选一（SITUATIONAL_JUDGMENT / SEQUENCE_JUDGMENT）。 +-- 每次按四维各抽 6 题（每维三个 competencyTag 各 2 题）共 24 题。 +-- options_json / answer_key_json / scoring_rule_json / explanation 使用 TEXT 保存， +-- 不使用 MySQL JSON 列，保持 MySQL 8 与 H2 MODE=MySQL 兼容。 +-- 迁移由 Flyway 精确执行一次，不会重复插入。 + +-- 1) 测评定义 +CREATE TABLE ability_definitions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + type_code VARCHAR(40) NOT NULL, + display_name VARCHAR(100) NOT NULL, + description VARCHAR(1000) NULL, + status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE', + question_count INT NOT NULL, + attempt_question_count INT NOT NULL, + questions_per_dimension INT NOT NULL, + time_limit_minutes INT NOT NULL, + result_valid_days INT NOT NULL, + retake_window_days INT NOT NULL, + retake_max_completed INT NOT NULL, + question_set_version VARCHAR(40) NOT NULL, + rules_version VARCHAR(40) NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_ability_definitions_type UNIQUE (type_code), + CONSTRAINT chk_ability_definitions_status CHECK (status IN ('ACTIVE', 'INACTIVE')) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 2) 题目（48 道，四维各 12） +CREATE TABLE ability_questions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + definition_id BIGINT NOT NULL, + question_code VARCHAR(20) NOT NULL, + dimension VARCHAR(20) NOT NULL, + competency_tag VARCHAR(40) NOT NULL, + item_type VARCHAR(40) NOT NULL, + stem VARCHAR(2000) NOT NULL, + options_json TEXT NOT NULL, + answer_key_json TEXT NOT NULL, + scoring_rule_json TEXT NOT NULL, + explanation TEXT NOT NULL, + difficulty VARCHAR(10) NOT NULL, + discrimination DECIMAL(6,3) NULL, + question_version VARCHAR(40) NOT NULL, + source VARCHAR(40) NOT NULL, + active TINYINT NOT NULL DEFAULT 1, + position INT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_ability_questions_code UNIQUE (definition_id, question_code), + CONSTRAINT uk_ability_questions_position UNIQUE (definition_id, position), + CONSTRAINT fk_ability_questions_definition + FOREIGN KEY (definition_id) REFERENCES ability_definitions(id), + CONSTRAINT chk_ability_questions_dimension + CHECK (dimension IN ('LOGIC', 'COMMUNICATION', 'EXECUTION', 'LEARNING')), + CONSTRAINT chk_ability_questions_item_type + CHECK (item_type IN ('SITUATIONAL_JUDGMENT', 'SEQUENCE_JUDGMENT')), + CONSTRAINT chk_ability_questions_difficulty + CHECK (difficulty IN ('EASY', 'MEDIUM', 'HARD')), + CONSTRAINT chk_ability_questions_active CHECK (active IN (0, 1)), + + INDEX idx_ability_questions_def_dim (definition_id, dimension, competency_tag, active) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 3) 答卷主记录 +CREATE TABLE ability_attempts ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + student_user_id BIGINT NOT NULL, + definition_id BIGINT NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'DRAFT', + active_key VARCHAR(255) NULL, + idempotency_key VARCHAR(64) NULL, + question_set_version VARCHAR(40) NOT NULL, + answered_count INT NOT NULL DEFAULT 0, + version BIGINT NOT NULL DEFAULT 0, + started_at DATETIME NULL, + expires_at DATETIME NULL, + submitted_at DATETIME NULL, + completed_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_ability_attempts_idem UNIQUE (student_user_id, idempotency_key), + CONSTRAINT uk_ability_attempts_active UNIQUE (active_key), + CONSTRAINT chk_ability_attempts_status + CHECK (status IN ('DRAFT', 'IN_PROGRESS', 'COMPLETED', 'EXPIRED')), + CONSTRAINT fk_ability_attempts_user + FOREIGN KEY (student_user_id) REFERENCES users(id) ON DELETE CASCADE, + CONSTRAINT fk_ability_attempts_definition + FOREIGN KEY (definition_id) REFERENCES ability_definitions(id), + + INDEX idx_ability_attempts_student_status_created (student_user_id, status, created_at), + INDEX idx_ability_attempts_student_def_completed (student_user_id, definition_id, completed_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 4) 本次抽中的题目（24 道，含完整题目快照，保证后续题库更新不改历史答卷评分） +CREATE TABLE ability_attempt_questions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + question_id BIGINT NOT NULL, + position INT NOT NULL, + question_version VARCHAR(40) NOT NULL, + question_snapshot_json TEXT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT uk_ability_aq_attempt_question UNIQUE (attempt_id, question_id), + CONSTRAINT uk_ability_aq_position UNIQUE (attempt_id, position), + CONSTRAINT fk_ability_aq_attempt + FOREIGN KEY (attempt_id) REFERENCES ability_attempts(id) ON DELETE CASCADE, + CONSTRAINT fk_ability_aq_question + FOREIGN KEY (question_id) REFERENCES ability_questions(id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 5) 答案 +CREATE TABLE ability_answers ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + attempt_question_id BIGINT NOT NULL, + selected_option_id VARCHAR(4) NOT NULL, + awarded_score INT NOT NULL, + answered_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_ability_answers_attempt_aq UNIQUE (attempt_id, attempt_question_id), + CONSTRAINT chk_ability_answers_score CHECK (awarded_score IN (0, 1, 2, 4)), + CONSTRAINT fk_ability_answers_attempt + FOREIGN KEY (attempt_id) REFERENCES ability_attempts(id) ON DELETE CASCADE, + CONSTRAINT fk_ability_answers_aq + FOREIGN KEY (attempt_question_id) REFERENCES ability_attempt_questions(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 6) 结果（一份答卷至多一条结果，attempt_id 唯一，用于幂等防重复生成） +CREATE TABLE ability_results ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + attempt_id BIGINT NOT NULL, + dimension_scores_json TEXT NULL, + overall_score DECIMAL(5,2) NOT NULL, + weaknesses_json TEXT NULL, + improvement_areas_json TEXT NULL, + question_feedback_json TEXT NULL, + valid_until DATETIME NULL, + question_set_version VARCHAR(40) NOT NULL, + rules_version VARCHAR(40) NOT NULL, + generated_at DATETIME NOT NULL, + version BIGINT NOT NULL DEFAULT 0, + + CONSTRAINT uk_ability_results_attempt UNIQUE (attempt_id), + CONSTRAINT fk_ability_results_attempt + FOREIGN KEY (attempt_id) REFERENCES ability_attempts(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ===================================================================== +-- 种子数据：一条测评定义 + 48 道题（四维各 12，position 1-48） +-- ===================================================================== +INSERT INTO ability_definitions + (type_code, display_name, description, status, + question_count, attempt_question_count, questions_per_dimension, + time_limit_minutes, result_valid_days, retake_window_days, retake_max_completed, + question_set_version, rules_version) +VALUES ( + 'WORKPLACE_ABILITY', + '四维能力测评', + '基于工作情境的自研四维能力测评，用于自我了解和能力提升参考，不构成职业资格、正式招聘结论或永久能力标签。', + 'ACTIVE', + 48, 24, 6, 30, 7, 90, 3, + 'ability-v0.1', + 'ability-scoring-v0.1' +); + +INSERT INTO ability_questions + (question_code, definition_id, dimension, competency_tag, item_type, stem, options_json, answer_key_json, scoring_rule_json, explanation, difficulty, discrimination, question_version, source, active, position) +VALUES + ('LO01',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','INFORMATION_ANALYSIS','SITUATIONAL_JUDGMENT','销售报表显示本月销售额增长20%，财务报表只增长8%。你首先会怎么处理？','[{"optionId":"A","text":"核对两份报表的统计口径、时间范围和原始数据来源"},{"optionId":"B","text":"先取两个增长率的平均值作为汇报结果"},{"optionId":"C","text":"先使用财务报表，并注明另一份报表存在差异"},{"optionId":"D","text":"采用增长率较高的报表，因为结果更积极"}]','{"answerKey":"A"}','{"A":4,"B":1,"C":2,"D":0}','冲突数据应先统一口径并追溯原始来源。直接平均、择一或选择有利结果都会掩盖真正的数据问题。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,1), + ('LO02',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','INFORMATION_ANALYSIS','SITUATIONAL_JUDGMENT','一项新页面的转化率从10%升到18%，但目前只有20名访问者。你会如何判断效果？','[{"optionId":"A","text":"立即宣布新页面显著优于旧页面"},{"optionId":"B","text":"扩大样本并与同口径对照组比较后再判断"},{"optionId":"C","text":"继续观察，同时先把18%作为确定结论汇报"},{"optionId":"D","text":"说明样本较小，只能给出暂定趋势而非确定结论"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":1,"D":2}','小样本波动较大，应扩大样本并设置可比基线。仅提示不确定性有价值，但仍不足以验证变化是否来自页面本身。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,2), + ('LO03',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','INFORMATION_ANALYSIS','SEQUENCE_JUDGMENT','两份分析报告得出相反结论。以下哪组核查顺序最合理？','[{"optionId":"A","text":"比较结论→询问作者→补充少量数据→决定采用哪份"},{"optionId":"B","text":"选择更新的报告→删除旧报告→通知相关人员→结束核查"},{"optionId":"C","text":"统一指标定义→核对原始数据→比较分析方法→复算并形成结论"},{"optionId":"D","text":"先复算结果→再确认口径→挑选更可信作者→形成结论"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','先统一定义，再核查数据和方法，最后复算，才能避免在不同口径上比较结论。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,3), + ('LO04',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','INFORMATION_ANALYSIS','SITUATIONAL_JUDGMENT','必须当天决定是否上线，但关键用户数据尚未收齐。你会怎么做？','[{"optionId":"A","text":"直接按个人经验上线，后续再看结果"},{"optionId":"B","text":"延期所有工作，直到全部信息完整"},{"optionId":"C","text":"让职位最高的人直接给出判断"},{"optionId":"D","text":"列明已知、未知和关键假设，选择可回滚的小范围方案并设置观察指标"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','信息不完整时应显式管理不确定性，并优先选择可回滚、可观察的决策，控制错误成本。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,4), + ('LO05',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','CAUSAL_REASONING','SITUATIONAL_JUDGMENT','促销活动上线后订单增长了25%。如何判断增长是否主要由活动带来？','[{"optionId":"A","text":"比较同期趋势、对照群体并排查价格和流量等同时变化因素"},{"optionId":"B","text":"活动和增长同时发生，因此可以判断活动有效"},{"optionId":"C","text":"查看几条参与活动用户的正面反馈"},{"optionId":"D","text":"只比较活动前一天和活动后一天订单量"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','时间上的同时发生不等于因果关系。对照、趋势和混杂因素核查能更可靠地识别活动贡献。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,5), + ('LO06',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','CAUSAL_REASONING','SITUATIONAL_JUDGMENT','系统发布新版本后出现大量错误。最合适的第一步是什么？','[{"optionId":"A","text":"同时修改多个可疑模块，争取尽快碰到正确修复"},{"optionId":"B","text":"先控制影响并保留日志，再对比发布前后变化定位原因"},{"optionId":"C","text":"立即回滚，但不保留现场信息"},{"optionId":"D","text":"等待更多用户反馈后再开始处理"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','先止损并保存证据，再围绕版本变化定位原因，既控制业务影响，也避免破坏根因分析条件。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,6), + ('LO07',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','CAUSAL_REASONING','SITUATIONAL_JUDGMENT','数据显示加班时间越长的团队交付量越高。你会怎样解释？','[{"optionId":"A","text":"说明加班一定能提升团队效率"},{"optionId":"B","text":"建议所有团队立即增加加班时间"},{"optionId":"C","text":"检查项目规模、人员数量和紧急程度等共同影响因素"},{"optionId":"D","text":"先承认存在相关性，但暂不据此做因果决策"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','交付量和加班可能同时受到项目规模等因素影响。相关性需要结合混杂因素和对照数据解释。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,7), + ('LO08',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','CAUSAL_REASONING','SEQUENCE_JUDGMENT','你要验证“缩短注册表单能提高完成率”。哪组步骤最合理？','[{"optionId":"A","text":"修改表单→全量上线→观察总注册量→询问用户感受"},{"optionId":"B","text":"提出假设→直接上线→发现变化→补写指标定义"},{"optionId":"C","text":"观察历史数据→修改多个流程→比较前后总量→形成结论"},{"optionId":"D","text":"定义指标→设置随机对照→只改变表单长度→达到样本量后分析"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','明确指标、设置对照并控制唯一变量，是验证页面变化与转化率之间因果关系的基本路径。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,8), + ('LO09',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','PROBLEM_SOLVING','SITUATIONAL_JUDGMENT','你收到“把这个页面做得更好用”的任务。首先应该做什么？','[{"optionId":"A","text":"明确目标用户、具体场景、当前问题和验收标准"},{"optionId":"B","text":"先按常见设计规范修改一版"},{"optionId":"C","text":"只询问对方喜欢什么颜色和布局"},{"optionId":"D","text":"等待对方给出完整解决方案"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','模糊需求应先转化为用户、场景、问题和验收条件，之后才能选择合适的实现方案。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,9), + ('LO10',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','PROBLEM_SOLVING','SEQUENCE_JUDGMENT','面对一个复杂而陌生的问题，哪组处理顺序最合理？','[{"optionId":"A","text":"寻找现成答案→直接实施→发现问题→再定义目标"},{"optionId":"B","text":"明确目标→拆分子问题→确定输入输出→逐项验证并整合"},{"optionId":"C","text":"先处理最熟悉部分→逐步扩大范围→最后确认是否解决目标"},{"optionId":"D","text":"先写完整长方案→交给他人执行→根据反馈决定是否验证"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','复杂问题需要先明确目标，再拆解和定义验证条件，避免局部工作很多却没有解决核心问题。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,10), + ('LO11',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','PROBLEM_SOLVING','SITUATIONAL_JUDGMENT','你提出的方案试运行后没有达到目标。下一步最合理的是？','[{"optionId":"A","text":"继续扩大使用范围，以获得更多结果"},{"optionId":"B","text":"认为执行人员没有严格遵循方案"},{"optionId":"C","text":"对照预期与实际，检查假设、执行偏差和外部因素后再调整"},{"optionId":"D","text":"先暂停扩大，并收集失败环节的数据"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','方案无效时需要同时检查假设、执行和环境，而不是只扩大范围或归责于某一方。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,11), + ('LO12',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LOGIC','PROBLEM_SOLVING','SITUATIONAL_JUDGMENT','负责人要求估算一个尚未完全明确的任务工期。你会如何回答？','[{"optionId":"A","text":"给出一个大致天数，并说明只是个人感觉"},{"optionId":"B","text":"拒绝估算，等所有需求完全确定"},{"optionId":"C","text":"参考类似任务，直接承诺相同工期"},{"optionId":"D","text":"拆分已知范围，说明假设、区间、风险以及需要补充的信息"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','在不确定条件下，区间估算加上假设和风险说明，比伪精确承诺或完全拒绝估算更可执行。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,12), + ('CO01',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','LISTENING_UNDERSTANDING','SITUATIONAL_JUDGMENT','对方提出一个比较模糊的合作需求。你首先会怎么回应？','[{"optionId":"A","text":"用自己的话复述理解，并确认目标、对象、边界和优先级"},{"optionId":"B","text":"根据过往经验直接开始准备方案"},{"optionId":"C","text":"发送一份通用需求模板，请对方有空时补充"},{"optionId":"D","text":"要求对方想清楚全部细节后再来沟通"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','复述与确认能够尽早暴露理解偏差，同时帮助双方把模糊表达转化为共同目标和边界。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,13), + ('CO02',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','LISTENING_UNDERSTANDING','SITUATIONAL_JUDGMENT','同事正在说明一次工作失误及其困难。你最合适的做法是？','[{"optionId":"A","text":"马上告诉对方正确做法，避免继续浪费时间"},{"optionId":"B","text":"先听完并复述关键事实、影响和对方需要的支持"},{"optionId":"C","text":"先听取主要内容，再提出自己的解决建议"},{"optionId":"D","text":"保持沉默，让对方自己整理清楚"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','先完整理解事实和需求，再讨论方案，能避免把建议建立在错误假设上，也能降低对方的防御感。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,14), + ('CO03',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','LISTENING_UNDERSTANDING','SEQUENCE_JUDGMENT','三方对同一需求理解不同。哪组沟通顺序最合理？','[{"optionId":"A","text":"各自发言→多数表决→记录结果→开始执行"},{"optionId":"B","text":"负责人定调→其他人补充→形成文档→会后再澄清"},{"optionId":"C","text":"分别复述理解→识别分歧点→对齐目标和证据→确认决定与责任"},{"optionId":"D","text":"收集意见→整理共同点→由负责人决定→通知执行人员"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','先让各方显式表达理解，再定位分歧并对齐依据，才能形成真正一致且可执行的结论。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,15), + ('CO04',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','LISTENING_UNDERSTANDING','SITUATIONAL_JUDGMENT','客户表达不满，但没有明确说明具体问题。你会怎么做？','[{"optionId":"A","text":"先说明团队已经严格按流程完成工作"},{"optionId":"B","text":"请客户提交正式投诉材料后再处理"},{"optionId":"C","text":"直接提供补偿，尽快结束沟通"},{"optionId":"D","text":"确认客户感受，再询问具体场景、期望和造成的影响"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','先确认感受并提取具体事实，有助于把情绪表达转化为可以处理的问题和期望。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,16), + ('CO05',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','STRUCTURED_EXPRESSION','SITUATIONAL_JUDGMENT','你需要向非技术同事解释一次系统故障。最合适的方式是？','[{"optionId":"A","text":"先讲业务影响和处理进展，再用通俗类比说明原因并确认理解"},{"optionId":"B","text":"完整说明技术栈、日志和异常调用链"},{"optionId":"C","text":"只说系统有问题，修好后再通知"},{"optionId":"D","text":"省略不确定性，给出一个肯定恢复时间"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','面向非技术对象应从其关心的影响和行动出发，用适当语言说明原因，同时保留必要的不确定性。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,17), + ('CO06',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','STRUCTURED_EXPRESSION','SITUATIONAL_JUDGMENT','发送一条需要对方行动的重要工作消息，应该如何组织？','[{"optionId":"A","text":"只写“请尽快处理”，减少阅读时间"},{"optionId":"B","text":"说明背景、当前问题、所需行动、负责人和截止时间"},{"optionId":"C","text":"先给结论和行动要求，再附上必要背景"},{"optionId":"D","text":"把全部聊天记录转发过去，让对方自行理解"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','清晰的工作消息应让接收者迅速知道为什么、做什么、谁负责以及何时完成。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,18), + ('CO07',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','STRUCTURED_EXPRESSION','SITUATIONAL_JUDGMENT','你需要指出同事提交材料中的严重问题。怎样表达最有效？','[{"optionId":"A","text":"直接说“你做事不够认真”"},{"optionId":"B","text":"只修改材料，不再提及问题"},{"optionId":"C","text":"描述具体问题、造成的影响、修改标准和可获得的支持"},{"optionId":"D","text":"私下指出具体错误，并提醒以后注意"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','高质量反馈针对可观察行为和影响，并给出明确标准与支持，不把问题上升为人格评价。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,19), + ('CO08',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','STRUCTURED_EXPRESSION','SEQUENCE_JUDGMENT','汇报一个延期项目时，哪组顺序最合理？','[{"optionId":"A","text":"说明困难→解释原因→请求理解→承诺尽快完成"},{"optionId":"B","text":"汇报已完成工作→省略延期风险→等待追问→再解释"},{"optionId":"C","text":"说明延期→列出责任方→描述过程→等待负责人决定"},{"optionId":"D","text":"先报结论和影响→说明原因与证据→给出方案→明确需要的决定"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','延期汇报应优先呈现事实和影响，再提供可验证原因、解决方案和明确决策请求。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,20), + ('CO09',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','COLLABORATION_CONFLICT','SITUATIONAL_JUDGMENT','你与同事对方案选择意见相反。你会如何推进？','[{"optionId":"A","text":"先确认共同目标，再区分事实与偏好，用统一标准比较方案"},{"optionId":"B","text":"请更多同事投票，按人数决定"},{"optionId":"C","text":"暂时接受对方方案，避免影响关系"},{"optionId":"D","text":"重点证明自己的方案更专业"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','以共同目标和一致评价标准处理分歧，能够把立场冲突转化为可比较的方案决策。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,21), + ('CO10',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','COLLABORATION_CONFLICT','SEQUENCE_JUDGMENT','跨团队依赖已经延期。哪种沟通方式最合理？','[{"optionId":"A","text":"在公共群指出对方延期→要求承诺→抄送负责人→等待结果"},{"optionId":"B","text":"确认事实和影响→了解阻塞→共同制定新节点→记录责任和升级条件"},{"optionId":"C","text":"先私下询问进度→协商新时间→定期跟进"},{"optionId":"D","text":"自行绕过依赖→完成后再告知对方"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','跨团队协作需要共同确认事实、阻塞和新承诺，并提前约定何时升级，避免指责或信息缺失。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,22), + ('CO11',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','COLLABORATION_CONFLICT','SITUATIONAL_JUDGMENT','同事临时要求你承担一项会影响原计划的工作。你会怎么回应？','[{"optionId":"A","text":"直接答应，之后再想办法补原任务"},{"optionId":"B","text":"直接拒绝，因为这不属于原计划"},{"optionId":"C","text":"说明当前承诺和影响，确认优先级并提出替代时间或资源方案"},{"optionId":"D","text":"先了解紧急程度，再决定是否帮助"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','边界沟通既要说明已有承诺，也要讨论优先级和替代方案，避免无条件接受或简单拒绝。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,23), + ('CO12',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'COMMUNICATION','COLLABORATION_CONFLICT','SITUATIONAL_JUDGMENT','你发现自己的表达让对方产生了误解。最合适的处理方式是？','[{"optionId":"A","text":"详细解释当时为什么会那样表达"},{"optionId":"B","text":"不再提及，避免让情况更尴尬"},{"optionId":"C","text":"先做出对方希望的承诺，之后再调整"},{"optionId":"D","text":"承认造成的影响，澄清真实意图并共同确认修正行动"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','修复误解应同时处理影响、意图和后续行动，而不是只解释动机或给出无法兑现的承诺。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,24), + ('EX01',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','PLANNING_PRIORITIZATION','SITUATIONAL_JUDGMENT','三个任务都临近截止时间，但现有资源只能优先完成一个。你会怎么做？','[{"optionId":"A","text":"按业务影响、紧急程度和依赖关系排序，并同步取舍方案"},{"optionId":"B","text":"三个任务同时开始，尽量都推进一些"},{"optionId":"C","text":"先完成最容易交付的任务"},{"optionId":"D","text":"等待负责人主动指定优先级"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','资源冲突时应基于影响、时效和依赖做明确取舍，并让相关方及时知道后果和安排。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,25), + ('EX02',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','PLANNING_PRIORITIZATION','SITUATIONAL_JUDGMENT','开始一个跨两周的新任务时，你首先会建立什么？','[{"optionId":"A","text":"一份尽可能详细、覆盖所有可能情况的计划"},{"optionId":"B","text":"明确交付结果、关键步骤、依赖、负责人和检查节点"},{"optionId":"C","text":"先确定最终期限和几个主要步骤"},{"optionId":"D","text":"先从最熟悉的部分开始，再逐步补计划"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','可执行计划要连接目标、步骤、依赖、责任与检查点，既能推进，也能尽早发现偏差。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,26), + ('EX03',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','PLANNING_PRIORITIZATION','SITUATIONAL_JUDGMENT','需求范围比预计大，但截止日期没有变化。你会怎样处理？','[{"optionId":"A","text":"保持原计划，靠加班完成新增范围"},{"optionId":"B","text":"先完成原范围，新增部分到期后再解释"},{"optionId":"C","text":"评估新增工作量和影响，提出范围、资源或时间的取舍方案"},{"optionId":"D","text":"记录需求变化，并提醒负责人可能延期"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','范围、资源和时间相互制约。范围变化后应量化影响并推动明确取舍，而不是默默承担风险。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,27), + ('EX04',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','PLANNING_PRIORITIZATION','SEQUENCE_JUDGMENT','把一个目标转成可执行计划，哪组顺序最合理？','[{"optionId":"A","text":"列任务→安排人员→确定目标→检查结果"},{"optionId":"B","text":"确定期限→开始执行→补充资源→最后验收"},{"optionId":"C","text":"选择工具→分配任务→同步进度→根据结果调整目标"},{"optionId":"D","text":"明确结果→拆分任务→识别依赖和风险→设置节点与验收标准"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','计划应从结果出发，再拆解任务、依赖、风险和验收节点，保证每一步都服务于最终目标。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,28), + ('EX05',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','RISK_FOLLOWUP','SITUATIONAL_JUDGMENT','你发现一个依赖项可能导致项目延期。你会怎么管理这项风险？','[{"optionId":"A","text":"记录触发条件、概率、影响、负责人和应对方案，并持续检查"},{"optionId":"B","text":"在周会上提醒一次，让大家注意"},{"optionId":"C","text":"先准备一个备用方案，但暂不告诉其他人"},{"optionId":"D","text":"等风险真正发生后再处理，避免过度反应"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','风险管理需要可观察的触发条件、责任人和预案，并持续跟踪，而不只是一次提醒或被动等待。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,29), + ('EX06',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','RISK_FOLLOWUP','SITUATIONAL_JUDGMENT','你的任务被另一个团队阻塞，且已经影响当前节点。你会怎么做？','[{"optionId":"A","text":"绕开对方直接修改其负责内容"},{"optionId":"B","text":"说明阻塞事实和影响，提出备选方案并约定升级时间"},{"optionId":"C","text":"持续跟进对方进度，同时调整自己可先做的工作"},{"optionId":"D","text":"记录阻塞，等负责人下次检查时再汇报"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','处理阻塞不仅要跟进，还要透明说明影响、准备替代路径并约定升级条件，防止风险继续扩大。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,30), + ('EX07',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','RISK_FOLLOWUP','SITUATIONAL_JUDGMENT','项目进度看似正常，但关键任务一直没有可验证产出。你会怎么处理？','[{"optionId":"A","text":"继续相信负责人汇报，避免打断执行"},{"optionId":"B","text":"增加每日进度汇报次数"},{"optionId":"C","text":"把关键任务拆成可验收的小节点，用产出和风险重新评估进度"},{"optionId":"D","text":"要求负责人尽快提供一个演示版本"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','进度应由可验证产出而非主观百分比衡量。拆成小节点可以提前暴露真实偏差和风险。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,31), + ('EX08',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','RISK_FOLLOWUP','SEQUENCE_JUDGMENT','线上发生严重故障时，哪组执行顺序最合理？','[{"optionId":"A","text":"查找根因→修改代码→通知用户→恢复服务"},{"optionId":"B","text":"重启服务→观察结果→继续修改→故障后补记录"},{"optionId":"C","text":"通知负责人→等待决定→组织排查→发布修复"},{"optionId":"D","text":"控制影响→保留证据→同步状态→恢复服务→复盘根因"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','故障处置首先控制影响，同时保留分析证据并保持信息同步；恢复后再完成系统性根因复盘。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,32), + ('EX09',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','DELIVERY_REVIEW','SITUATIONAL_JUDGMENT','截止时间临近，但交付物仍存在质量风险。你会怎么处理？','[{"optionId":"A","text":"识别关键质量门槛，缩小非核心范围，分阶段交付并同步风险"},{"optionId":"B","text":"优先保证所有功能完成，测试可以之后补"},{"optionId":"C","text":"继续优化细节，必要时到期后再解释"},{"optionId":"D","text":"直接推迟交付，直到所有问题完全解决"}]','{"answerKey":"A"}','{"A":4,"B":0,"C":1,"D":2}','临近截止时间应守住关键质量底线，并通过范围取舍和分阶段交付透明管理风险。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,33), + ('EX10',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','DELIVERY_REVIEW','SEQUENCE_JUDGMENT','向他人交接一项进行中的任务，哪组顺序最合理？','[{"optionId":"A","text":"发送文件→说明截止日期→让对方有问题再问→退出任务"},{"optionId":"B","text":"说明目标和现状→移交材料与风险→明确责任和节点→确认对方理解"},{"optionId":"C","text":"口头说明主要事项→发送材料→约定一次后续检查"},{"optionId":"D","text":"把任务重新做一遍→整理文件→通知对方结果"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','有效交接需要共同理解目标、现状、材料、风险、责任和检查节点，而不仅是发送文件。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,34), + ('EX11',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','DELIVERY_REVIEW','SITUATIONAL_JUDGMENT','任务完成后结果没有达到预期。最有价值的复盘方式是？','[{"optionId":"A","text":"确定主要责任人并避免再次由其负责"},{"optionId":"B","text":"记录最终结果，提醒团队以后更认真"},{"optionId":"C","text":"比较目标与实际，分析过程证据，形成有负责人和期限的改进动作"},{"optionId":"D","text":"讨论主要问题并总结经验，供下次参考"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','复盘的价值在于从证据中找到可改变因素，并把经验转成有负责人和期限的行动。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,35), + ('EX12',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'EXECUTION','DELIVERY_REVIEW','SITUATIONAL_JUDGMENT','开发工作已经完成，怎样才算真正完成交付闭环？','[{"optionId":"A","text":"代码已经合并，可以把任务标记完成"},{"optionId":"B","text":"部署完成且没有立即出现错误"},{"optionId":"C","text":"把剩余事项记录在自己的待办中"},{"optionId":"D","text":"按验收标准确认结果，补齐文档、监控、交接和明确遗留项"}]','{"answerKey":"D"}','{"A":1,"B":2,"C":0,"D":4}','完成实现不等于完成交付；验收、文档、运行保障、交接和遗留事项都应形成闭环。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,36), + ('LE01',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','INFORMATION_ACQUISITION','SITUATIONAL_JUDGMENT','第一次接触一项工作需要的新工具时，你会怎么开始？','[{"optionId":"A","text":"明确使用目标，阅读权威入门资料，完成小练习后应用到任务"},{"optionId":"B","text":"先看几个热门视频，再边做边查"},{"optionId":"C","text":"直接在正式任务中尝试，遇到问题再处理"},{"optionId":"D","text":"请熟悉工具的同事替自己完成关键部分"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','目标、可靠资料、小范围练习和真实应用形成完整学习闭环，能兼顾效率和风险。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,37), + ('LE02',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','INFORMATION_ACQUISITION','SITUATIONAL_JUDGMENT','网上对同一技术方案存在互相矛盾的观点。你会怎样判断？','[{"optionId":"A","text":"选择点赞和转发最多的观点"},{"optionId":"B","text":"比较来源、发布时间、证据、适用条件，并做小范围验证"},{"optionId":"C","text":"优先参考官方文档，再结合一项实践案例"},{"optionId":"D","text":"选择与自己原有经验一致的观点"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','可靠判断既需要评价信息来源和适用条件，也需要在自己的场景中验证，而不能只看热度或偏好。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,38), + ('LE03',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','INFORMATION_ACQUISITION','SEQUENCE_JUDGMENT','快速进入一个陌生业务领域，哪组学习顺序最合理？','[{"optionId":"A","text":"收集大量资料→全部阅读→整理术语→开始参与工作"},{"optionId":"B","text":"跟随一名同事→模仿做法→遇到问题再查资料→形成经验"},{"optionId":"C","text":"明确任务问题→建立基础框架→结合案例实践→用反馈补齐知识"},{"optionId":"D","text":"阅读概览→询问关键术语→尝试一项小任务→继续自学"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','围绕真实问题建立知识框架，再通过实践和反馈迭代，比无目标囤积资料更有效。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,39), + ('LE04',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','INFORMATION_ACQUISITION','SITUATIONAL_JUDGMENT','你只有两小时了解一个新主题并给出初步建议。你会怎么安排？','[{"optionId":"A","text":"尽量阅读更多文章，以覆盖所有观点"},{"optionId":"B","text":"询问熟悉主题的人并直接采用其建议"},{"optionId":"C","text":"先写出自己的看法，再搜索资料验证"},{"optionId":"D","text":"明确输出问题，优先权威概览和关键证据，并标明未知与后续验证项"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','时间有限时，应围绕输出目标选择高价值信息，并明确区分结论、假设和待验证内容。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,40), + ('LE05',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','FEEDBACK_REFLECTION','SITUATIONAL_JUDGMENT','你收到“方案不够清晰”的反馈。最有效的回应是？','[{"optionId":"A","text":"请对方指出具体难以理解之处，修改后再次确认是否解决"},{"optionId":"B","text":"详细解释自己当时的设计思路"},{"optionId":"C","text":"接受反馈，并在下一次方案中注意"},{"optionId":"D","text":"找其他同事判断这条反馈是否合理"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','将模糊反馈转化为具体例子，并通过修改后的再次验证，才能真正形成可观察的学习改进。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,41), + ('LE06',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','FEEDBACK_REFLECTION','SITUATIONAL_JUDGMENT','一次重要尝试失败后，你最应该优先做什么？','[{"optionId":"A","text":"立即换一种完全不同的方法重新尝试"},{"optionId":"B","text":"还原目标、过程和关键决策，区分假设错误、执行偏差与外部因素"},{"optionId":"C","text":"先记录失败现象和可能原因，再选择一个方向验证"},{"optionId":"D","text":"等待更多类似失败出现后一起复盘"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','有效复盘需要还原过程并区分不同原因类型，避免在没有证据时只更换方法或延后学习。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,42), + ('LE07',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','FEEDBACK_REFLECTION','SITUATIONAL_JUDGMENT','怎样最能验证自己真正掌握了一项新知识？','[{"optionId":"A","text":"能够完整复述资料中的定义"},{"optionId":"B","text":"完成课程并通过课程自带的小测"},{"optionId":"C","text":"能用自己的话解释、应用到新问题，并根据结果修正理解"},{"optionId":"D","text":"尝试向别人讲解，并接受对方提问"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','真正掌握不仅是记忆，还包括解释、迁移、实践和基于结果修正认知。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,43), + ('LE08',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','FEEDBACK_REFLECTION','SEQUENCE_JUDGMENT','根据反馈持续改进一项技能，哪组顺序最合理？','[{"optionId":"A","text":"收集反馈→一次修改全部问题→长期练习→最终检查"},{"optionId":"B","text":"确定目标→大量练习→请人评价→记录结果"},{"optionId":"C","text":"模仿优秀示例→反复练习→比较差距→继续模仿"},{"optionId":"D","text":"设定具体目标→刻意练习→获得反馈→调整方法并再次验证"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','学习闭环应围绕具体目标，通过练习、反馈、调整和再验证不断缩小差距。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,44), + ('LE09',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','TRANSFER_ADAPTATION','SITUATIONAL_JUDGMENT','学会一种分析方法后，你遇到一个相似但条件不同的新问题。你会怎么做？','[{"optionId":"A","text":"识别共同原理和条件差异，调整方法并用结果验证"},{"optionId":"B","text":"先按原步骤完整执行，再根据结果修改"},{"optionId":"C","text":"重新寻找专门针对新问题的现成方法"},{"optionId":"D","text":"认为条件不同，原方法没有参考价值"}]','{"answerKey":"A"}','{"A":4,"B":2,"C":1,"D":0}','知识迁移的关键是识别稳定原理与变化条件，并通过调整和验证把旧知识应用到新场景。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,45), + ('LE10',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','TRANSFER_ADAPTATION','SITUATIONAL_JUDGMENT','你遇到一个自己长时间无法解决的问题，需要向同事求助。怎样提问最有效？','[{"optionId":"A","text":"把全部材料发给对方，请对方帮忙看看"},{"optionId":"B","text":"说明目标、现象、已尝试方法、当前判断和希望获得的帮助"},{"optionId":"C","text":"整理出最小问题、错误信息和已排除项后提问"},{"optionId":"D","text":"直接请对方演示正确做法，自己跟着学习"}]','{"answerKey":"B"}','{"A":0,"B":4,"C":2,"D":1}','高质量求助能让对方快速理解上下文，也暴露自己的思考过程，从而获得可迁移的指导而非代做。','MEDIUM',NULL,'ability-v0.1','SELF_AUTHORED',1,46), + ('LE11',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','TRANSFER_ADAPTATION','SITUATIONAL_JUDGMENT','你熟悉的工具即将停止维护，团队需要迁移到新工具。你会怎么应对？','[{"optionId":"A","text":"继续使用旧工具，直到它真正无法运行"},{"optionId":"B","text":"立即把所有工作迁移到最热门的新工具"},{"optionId":"C","text":"比较需求和迁移成本，做小范围验证，形成学习与分阶段迁移计划"},{"optionId":"D","text":"先试用几个候选工具并记录主要差异"}]','{"answerKey":"C"}','{"A":1,"B":0,"C":4,"D":2}','面对变化应结合实际需求、成本和验证结果规划迁移，同时安排学习，避免被动拖延或盲目追新。','HARD',NULL,'ability-v0.1','SELF_AUTHORED',1,47), + ('LE12',(SELECT id FROM ability_definitions WHERE type_code='WORKPLACE_ABILITY'),'LEARNING','TRANSFER_ADAPTATION','SEQUENCE_JUDGMENT','制定一项与目标岗位相关的学习计划，哪组顺序最合理？','[{"optionId":"A","text":"购买课程→安排时间→完成课程→更新简历"},{"optionId":"B","text":"收集热门技能→选择感兴趣内容→集中学习→寻找应用机会"},{"optionId":"C","text":"参考他人路线→复制学习清单→定期检查完成量→继续补课"},{"optionId":"D","text":"分析岗位要求和当前差距→设定可验证目标→练习应用→根据反馈调整"}]','{"answerKey":"D"}','{"A":2,"B":1,"C":0,"D":4}','有效学习计划从真实目标和差距出发，用可验证练习和反馈调整方向，而不是以课程数量衡量成长。','EASY',NULL,'ability-v0.1','SELF_AUTHORED',1,48); diff --git a/mydreamjob-server/src/main/resources/db/migration/V36__risk_governance.sql b/mydreamjob-server/src/main/resources/db/migration/V36__risk_governance.sql new file mode 100644 index 0000000..c0c42cf --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V36__risk_governance.sql @@ -0,0 +1,95 @@ +-- Flyway V36: 风险概览与运营规则配置（功能版本 V37） +-- +-- 仅供 ADMIN 的风险概览/趋势/分布/事件/规则/人工标记，基于既有拒绝型安全审计（audit_logs） +-- 做确定性、规则化检测。规则输入 action 仅限 REPORT_RATE_LIMITED 与 BLOCKED_SEND_PROHIBITED。 +-- 全部表均为增量新增；仅在本迁移中为 audit_logs 增加风险扫描复合索引，不改任何既有语义。 + +-- 1) 规则配置表（scoring_rule_configs） +CREATE TABLE scoring_rule_configs ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + rule_code VARCHAR(60) NOT NULL, + source_action VARCHAR(60) NOT NULL, + threshold_count INT NOT NULL, + window_minutes INT NOT NULL, + severity VARCHAR(10) NOT NULL, + enabled TINYINT NOT NULL DEFAULT 1, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_scoring_rule_configs_code UNIQUE (rule_code), + CONSTRAINT chk_scoring_rule_threshold CHECK (threshold_count BETWEEN 1 AND 100), + CONSTRAINT chk_scoring_rule_window CHECK (window_minutes BETWEEN 1 AND 1440), + CONSTRAINT chk_scoring_rule_severity CHECK (severity IN ('LOW', 'MEDIUM', 'HIGH')), + CONSTRAINT chk_scoring_rule_enabled CHECK (enabled IN (0, 1)) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 2) 风险事件表（scoring_risk_events） +CREATE TABLE scoring_risk_events ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + rule_config_id BIGINT NOT NULL, + subject_user_id BIGINT NOT NULL, + source_audit_log_id BIGINT NOT NULL, + source_action VARCHAR(60) NOT NULL, + severity VARCHAR(10) NOT NULL, + window_started_at DATETIME NOT NULL, + window_ended_at DATETIME NOT NULL, + occurrence_count INT NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'OPEN', + detected_at DATETIME NOT NULL, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_scoring_risk_events_rule_audit UNIQUE (rule_config_id, source_audit_log_id), + CONSTRAINT fk_scoring_risk_events_rule + FOREIGN KEY (rule_config_id) REFERENCES scoring_rule_configs(id), + CONSTRAINT chk_scoring_risk_status CHECK (status IN ('OPEN', 'ACKNOWLEDGED', 'DISMISSED')), + CONSTRAINT chk_scoring_risk_severity CHECK (severity IN ('LOW', 'MEDIUM', 'HIGH')), + + INDEX idx_scoring_risk_detected_status (detected_at, status), + INDEX idx_scoring_risk_severity_detected (severity, detected_at), + INDEX idx_scoring_risk_rule_detected (rule_config_id, detected_at), + INDEX idx_scoring_risk_subject_detected (subject_user_id, detected_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 3) 风险事件人工操作（scoring_risk_actions，受控 reasonCode，无自由文本备注） +CREATE TABLE scoring_risk_actions ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + risk_event_id BIGINT NOT NULL, + operator_user_id BIGINT NOT NULL, + action VARCHAR(20) NOT NULL, + reason_code VARCHAR(40) NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT fk_scoring_risk_actions_event + FOREIGN KEY (risk_event_id) REFERENCES scoring_risk_events(id) ON DELETE CASCADE, + CONSTRAINT chk_scoring_risk_action_type CHECK (action IN ('ACKNOWLEDGE', 'DISMISS')), + CONSTRAINT chk_scoring_risk_reason + CHECK (reason_code IN ('MONITORING', 'CONFIRMED_FALSE_POSITIVE', 'OUT_OF_BAND_ESCALATED')), + + INDEX idx_scoring_risk_actions_event (risk_event_id, created_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 4) 扫描游标（仅一条 checkpoint_key=RISK_EVENT_DETECTOR） +CREATE TABLE scoring_risk_scan_checkpoints ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + checkpoint_key VARCHAR(40) NOT NULL, + last_audit_log_id BIGINT NOT NULL DEFAULT 0, + version BIGINT NOT NULL DEFAULT 0, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + CONSTRAINT uk_scoring_risk_checkpoint_key UNIQUE (checkpoint_key) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +INSERT INTO scoring_risk_scan_checkpoints (checkpoint_key, last_audit_log_id) VALUES ('RISK_EVENT_DETECTOR', 0); + +-- 5) 种子规则（两档初始阈值）：REPORT_RATE_LIMITED 一次即 HIGH；BLOCKED_SEND_PROHIBITED 窗口 3 次即 MEDIUM +INSERT INTO scoring_rule_configs + (rule_code, source_action, threshold_count, window_minutes, severity, enabled, version) +VALUES + ('REPORT_RATE_LIMIT_BURST', 'REPORT_RATE_LIMITED', 1, 60, 'HIGH', 1, 0), + ('BLOCKED_MESSAGE_BURST', 'BLOCKED_SEND_PROHIBITED', 3, 15, 'MEDIUM', 1, 0); + +-- 6) 仅优化风险扫描的审计复合索引：不改任何既有审计语义 +CREATE INDEX idx_audit_risk_scan ON audit_logs (action, user_id, created_at, id); \ No newline at end of file diff --git a/mydreamjob-server/src/main/resources/db/migration/V37__job_recommendation_profiles.sql b/mydreamjob-server/src/main/resources/db/migration/V37__job_recommendation_profiles.sql new file mode 100644 index 0000000..9dd4df7 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V37__job_recommendation_profiles.sql @@ -0,0 +1,77 @@ +-- V39：测评驱动岗位推荐。分类字典由平台维护，企业只可选择已启用条目。 + +CREATE TABLE job_recommendation_taxonomies ( + code VARCHAR(64) PRIMARY KEY, + parent_code VARCHAR(64) NULL, + taxonomy_type VARCHAR(20) NOT NULL, + display_name VARCHAR(80) NOT NULL, + enabled TINYINT NOT NULL DEFAULT 1, + sort_order INT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT chk_job_rec_taxonomy_type CHECK (taxonomy_type IN ('INDUSTRY','JOB_FAMILY')), + CONSTRAINT fk_job_rec_taxonomy_parent FOREIGN KEY (parent_code) + REFERENCES job_recommendation_taxonomies(code) +); + +CREATE TABLE job_recommendation_profiles ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + job_id BIGINT NOT NULL, + industry_code VARCHAR(64) NOT NULL, + job_family_code VARCHAR(64) NOT NULL, + riasec_weights_json TEXT NULL, + ability_expectations_json TEXT NULL, + enabled TINYINT NOT NULL DEFAULT 1, + review_status VARCHAR(20) NOT NULL DEFAULT 'PENDING_REVIEW', + review_reason VARCHAR(40) NULL, + reviewed_by_user_id BIGINT NULL, + reviewed_at DATETIME NULL, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT uk_job_rec_profile_job UNIQUE (job_id), + CONSTRAINT chk_job_rec_profile_status CHECK (review_status IN ('PENDING_REVIEW','APPROVED','REJECTED','DISABLED')), + CONSTRAINT fk_job_rec_profile_job FOREIGN KEY (job_id) REFERENCES jobs(id), + CONSTRAINT fk_job_rec_profile_industry FOREIGN KEY (industry_code) REFERENCES job_recommendation_taxonomies(code), + CONSTRAINT fk_job_rec_profile_family FOREIGN KEY (job_family_code) REFERENCES job_recommendation_taxonomies(code), + INDEX idx_job_rec_profile_eligible (review_status, enabled, updated_at), + INDEX idx_job_rec_profile_industry_family (industry_code, job_family_code) +); + +CREATE TABLE student_job_recommendation_feedback ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + student_user_id BIGINT NOT NULL, + job_id BIGINT NOT NULL, + feedback_type VARCHAR(32) NOT NULL, + reason_type VARCHAR(40) NULL, + feedback_key VARCHAR(220) NOT NULL, + idempotency_key VARCHAR(64) NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE', + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT uk_student_job_feedback_key UNIQUE (feedback_key), + CONSTRAINT uk_student_job_feedback_idem UNIQUE (student_user_id, idempotency_key), + CONSTRAINT chk_student_job_feedback_type CHECK (feedback_type IN ('NOT_INTERESTED','REASON_HELPFUL','REASON_NOT_HELPFUL')), + CONSTRAINT chk_student_job_feedback_status CHECK (status IN ('ACTIVE','REVOKED')), + CONSTRAINT fk_student_job_feedback_user FOREIGN KEY (student_user_id) REFERENCES users(id), + CONSTRAINT fk_student_job_feedback_job FOREIGN KEY (job_id) REFERENCES jobs(id), + INDEX idx_student_job_feedback_active (student_user_id, status, feedback_type, job_id) +); + +INSERT INTO job_recommendation_taxonomies(code, parent_code, taxonomy_type, display_name, sort_order) VALUES +('INTERNET', NULL, 'INDUSTRY', '互联网/信息技术', 10), +('FINANCE', NULL, 'INDUSTRY', '金融', 20), +('MANUFACTURING', NULL, 'INDUSTRY', '制造业', 30), +('HEALTHCARE', NULL, 'INDUSTRY', '医疗健康', 40), +('EDUCATION', NULL, 'INDUSTRY', '教育', 50), +('RETAIL', NULL, 'INDUSTRY', '零售/消费', 60), +('IT_SOFTWARE', 'INTERNET', 'JOB_FAMILY', '软件研发', 101), +('IT_PRODUCT', 'INTERNET', 'JOB_FAMILY', '产品/运营', 102), +('IT_DESIGN', 'INTERNET', 'JOB_FAMILY', '设计/创意', 103), +('FIN_ANALYSIS', 'FINANCE', 'JOB_FAMILY', '金融分析/风控', 201), +('MFG_ENGINEERING', 'MANUFACTURING', 'JOB_FAMILY', '工程/制造', 301), +('MFG_QUALITY', 'MANUFACTURING', 'JOB_FAMILY', '质量/供应链', 302), +('HEALTH_SERVICE', 'HEALTHCARE', 'JOB_FAMILY', '医疗服务', 401), +('EDU_TEACHING', 'EDUCATION', 'JOB_FAMILY', '教学/培训', 501), +('RETAIL_SALES', 'RETAIL', 'JOB_FAMILY', '销售/客户服务', 601); diff --git a/mydreamjob-server/src/main/resources/db/migration/V38__company_review_replies.sql b/mydreamjob-server/src/main/resources/db/migration/V38__company_review_replies.sql new file mode 100644 index 0000000..240bd5e --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V38__company_review_replies.sql @@ -0,0 +1,51 @@ +-- Flyway V38: 企业岗位评价官方回复（功能版本 V40） +-- 仅新增回复事实与生命周期历史，不修改 V1-V37 已执行迁移。 + +CREATE TABLE company_review_replies ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + review_id BIGINT NOT NULL, + company_id BIGINT NOT NULL, + content VARCHAR(500) NOT NULL, + idempotency_key VARCHAR(64) NOT NULL, + moderation_status VARCHAR(20) NOT NULL DEFAULT 'PENDING', + moderation_reason VARCHAR(500), + moderation_score DECIMAL(5,2), + risk_level VARCHAR(20), + reviewed_by_user_id BIGINT NULL, + reviewed_at DATETIME NULL, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT uk_company_review_replies_review UNIQUE (review_id), + CONSTRAINT uk_company_review_replies_idempotency UNIQUE (company_id, idempotency_key), + CONSTRAINT fk_company_review_replies_review FOREIGN KEY (review_id) + REFERENCES job_reviews(id) ON DELETE CASCADE, + CONSTRAINT fk_company_review_replies_company FOREIGN KEY (company_id) + REFERENCES companies(id), + CONSTRAINT fk_company_review_replies_reviewer FOREIGN KEY (reviewed_by_user_id) + REFERENCES users(id), + CONSTRAINT ck_company_review_replies_status CHECK ( + moderation_status IN ('AUTO_APPROVED', 'PENDING', 'APPROVED', 'REJECTED') + ), + INDEX idx_company_review_replies_company_status_updated (company_id, moderation_status, updated_at), + INDEX idx_company_review_replies_status_created (moderation_status, created_at), + INDEX idx_company_review_replies_review (review_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +CREATE TABLE company_review_reply_history ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + reply_id BIGINT NOT NULL, + action VARCHAR(30) NOT NULL, + actor_user_id BIGINT NULL, + reason_codes VARCHAR(500), + human_reason VARCHAR(500), + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + CONSTRAINT fk_company_review_reply_history_reply FOREIGN KEY (reply_id) + REFERENCES company_review_replies(id) ON DELETE CASCADE, + CONSTRAINT fk_company_review_reply_history_actor FOREIGN KEY (actor_user_id) + REFERENCES users(id), + CONSTRAINT ck_company_review_reply_history_action CHECK ( + action IN ('CREATED', 'AUTO_APPROVED', 'PENDING', 'RESUBMITTED', 'APPROVED', 'REJECTED') + ), + INDEX idx_company_review_reply_history_reply_created (reply_id, created_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; diff --git a/mydreamjob-server/src/main/resources/db/migration/V39__enterprise_talent_discovery.sql b/mydreamjob-server/src/main/resources/db/migration/V39__enterprise_talent_discovery.sql new file mode 100644 index 0000000..ba7c705 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V39__enterprise_talent_discovery.sql @@ -0,0 +1,16 @@ +-- Flyway V39：企业人才发现授权（功能版本 V41）。 +-- 仅保存学生对“被企业发现”的显式授权，不保存企业浏览、岗位、测评或联系方式数据。 + +CREATE TABLE student_talent_discovery_preferences ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + student_user_id BIGINT NOT NULL, + enabled TINYINT NOT NULL DEFAULT 0, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT uk_student_talent_discovery_preferences_student UNIQUE (student_user_id), + CONSTRAINT fk_student_talent_discovery_preferences_student FOREIGN KEY (student_user_id) + REFERENCES users(id), + CONSTRAINT ck_student_talent_discovery_preferences_enabled CHECK (enabled IN (0, 1)), + INDEX idx_student_talent_discovery_preferences_enabled_student (enabled, student_user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; diff --git a/mydreamjob-server/src/main/resources/db/migration/V40__enterprise_talent_invitations.sql b/mydreamjob-server/src/main/resources/db/migration/V40__enterprise_talent_invitations.sql new file mode 100644 index 0000000..dc32d8d --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V40__enterprise_talent_invitations.sql @@ -0,0 +1,48 @@ +-- Flyway V40：企业人才邀约与授权沟通（功能版本 V42）。 +-- 仅新增邀约事实、状态历史和接受后的会话关联，不修改 V1-V39。 + +CREATE TABLE talent_invitations ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + company_id BIGINT NOT NULL, + job_id BIGINT NOT NULL, + student_user_id BIGINT NOT NULL, + candidate_key_digest CHAR(64) NOT NULL, + message VARCHAR(300) NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT 'PENDING', + idempotency_key VARCHAR(64) NOT NULL, + active_key VARCHAR(200) NULL, + conversation_id BIGINT NULL, + expires_at DATETIME NOT NULL, + decided_at DATETIME NULL, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT fk_talent_invitations_company FOREIGN KEY (company_id) REFERENCES companies(id), + CONSTRAINT fk_talent_invitations_job FOREIGN KEY (job_id) REFERENCES jobs(id), + CONSTRAINT fk_talent_invitations_student FOREIGN KEY (student_user_id) REFERENCES users(id), + CONSTRAINT fk_talent_invitations_conversation FOREIGN KEY (conversation_id) REFERENCES conversations(id), + CONSTRAINT ck_talent_invitations_status CHECK (status IN ('PENDING', 'ACCEPTED', 'REJECTED', 'EXPIRED')), + CONSTRAINT uk_talent_invitations_idempotency UNIQUE (company_id, idempotency_key), + CONSTRAINT uk_talent_invitations_active UNIQUE (active_key), + CONSTRAINT uk_talent_invitations_conversation UNIQUE (conversation_id), + INDEX idx_talent_invitations_student_status_created (student_user_id, status, created_at), + INDEX idx_talent_invitations_company_status_created (company_id, status, created_at), + INDEX idx_talent_invitations_job_status_created (job_id, status, created_at), + INDEX idx_talent_invitations_status_expires (status, expires_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +CREATE TABLE talent_invitation_history ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + invitation_id BIGINT NOT NULL, + action VARCHAR(30) NOT NULL, + actor_user_id BIGINT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + CONSTRAINT fk_talent_invitation_history_invitation FOREIGN KEY (invitation_id) + REFERENCES talent_invitations(id) ON DELETE CASCADE, + CONSTRAINT fk_talent_invitation_history_actor FOREIGN KEY (actor_user_id) + REFERENCES users(id), + CONSTRAINT ck_talent_invitation_history_action CHECK ( + action IN ('CREATED', 'ACCEPTED', 'REJECTED', 'EXPIRED') + ), + INDEX idx_talent_invitation_history_invitation_created (invitation_id, created_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; diff --git a/mydreamjob-server/src/main/resources/db/migration/V41__message_recall.sql b/mydreamjob-server/src/main/resources/db/migration/V41__message_recall.sql new file mode 100644 index 0000000..1f8ad5c --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V41__message_recall.sql @@ -0,0 +1,6 @@ +ALTER TABLE messages ADD COLUMN status VARCHAR(20) NOT NULL DEFAULT 'SENT'; +ALTER TABLE messages ADD COLUMN recalled_at DATETIME NULL; +ALTER TABLE messages ADD COLUMN version BIGINT NOT NULL DEFAULT 0; + +ALTER TABLE messages + ADD CONSTRAINT chk_messages_status CHECK (status IN ('SENT', 'RECALLED')); diff --git a/mydreamjob-server/src/main/resources/db/migration/V42__auth_token_sessions.sql b/mydreamjob-server/src/main/resources/db/migration/V42__auth_token_sessions.sql new file mode 100644 index 0000000..0c001e9 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V42__auth_token_sessions.sql @@ -0,0 +1,28 @@ +-- S02：Access/Refresh Token 隔离、轮换与吊销 +-- +-- 扩展 auth_tokens，使其能表达“登录会话 + Refresh Token 轮换 + 撤销”： +-- session_id 每次登录的会话 UUID +-- token_jti Refresh Token 的 jti（唯一） +-- parent_token_id 轮换前一条记录 +-- consumed_at 成功刷新时的消费时间 +-- revoked_at 撤销时间 +-- revocation_reason 固定白名单原因 +-- version 乐观锁/条件更新版本 +-- +-- 约束： +-- * 不修改既有列、不删除既有数据、不新增级联删除； +-- * 旧记录 session_id 为 NULL，永远不被新鉴权逻辑视为活动会话； +-- * token_hash 的业务含义固定为 Refresh Token 的 HMAC-SHA256 摘要； +-- * token_jti 允许 NULL（旧行），UNIQUE 在 MySQL 与 H2 下均允许多个 NULL。 + +ALTER TABLE auth_tokens ADD COLUMN session_id VARCHAR(36) NULL; +ALTER TABLE auth_tokens ADD COLUMN token_jti VARCHAR(36) NULL; +ALTER TABLE auth_tokens ADD COLUMN parent_token_id BIGINT NULL; +ALTER TABLE auth_tokens ADD COLUMN consumed_at DATETIME NULL; +ALTER TABLE auth_tokens ADD COLUMN revoked_at DATETIME NULL; +ALTER TABLE auth_tokens ADD COLUMN revocation_reason VARCHAR(40) NULL; +ALTER TABLE auth_tokens ADD COLUMN version BIGINT NOT NULL DEFAULT 0; + +ALTER TABLE auth_tokens ADD INDEX idx_auth_tokens_session_active (session_id, revoked, consumed_at, expired_at); +ALTER TABLE auth_tokens ADD INDEX idx_auth_tokens_user_session (user_id, session_id); +ALTER TABLE auth_tokens ADD CONSTRAINT uk_auth_tokens_token_jti UNIQUE (token_jti); diff --git a/mydreamjob-server/src/main/resources/db/migration/V43__disable_legacy_seed_accounts.sql b/mydreamjob-server/src/main/resources/db/migration/V43__disable_legacy_seed_accounts.sql new file mode 100644 index 0000000..bdb72b1 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V43__disable_legacy_seed_accounts.sql @@ -0,0 +1,40 @@ +-- S03-A：禁用仍保持 V1_1 原始指纹的 Flyway 演示账号 +-- +-- 背景：V1_1__seed_data.sql 无环境隔离地插入了 ADMIN / STUDENT / COMPANY 三个演示账号， +-- 并带有公开的 bcrypt 口令哈希。这些账号不能在生产继续可用。 +-- +-- 原则： +-- * 只将 users.is_active 由 1 置为 0；不删除用户、角色、审计或任何业务数据，不重置自增； +-- * 不依赖固定 id（不使用 id = 1/2/3）； +-- * 每条 UPDATE 同时匹配 V1_1 中的**原始手机号 + 原始邮箱 + 原始公开 bcrypt 哈希 + +-- 原始主角色 + is_active = 1**；任一指纹被运营人员改过的账号都不会命中，因而保持不受影响； +-- * 幂等：命中行被置为 is_active = 0 后，再次执行不会再匹配（条件含 is_active = 1）。 +-- +-- 认证签发链已拒绝 inactive 用户，因此被禁用的账号无法再取得会话。 + +-- ADMIN +UPDATE users + SET is_active = 0 + WHERE phone = '13800000001' + AND email = 'admin@mydreamjob.com' + AND password_hash = '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi' + AND role = 'ADMIN' + AND is_active = 1; + +-- STUDENT +UPDATE users + SET is_active = 0 + WHERE phone = '13800000002' + AND email = 'student@mydreamjob.com' + AND password_hash = '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi' + AND role = 'STUDENT' + AND is_active = 1; + +-- COMPANY +UPDATE users + SET is_active = 0 + WHERE phone = '13800000003' + AND email = 'company@mydreamjob.com' + AND password_hash = '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi' + AND role = 'COMPANY' + AND is_active = 1; diff --git a/mydreamjob-server/src/main/resources/db/migration/V44__candidate_scoring_refresh_tasks.sql b/mydreamjob-server/src/main/resources/db/migration/V44__candidate_scoring_refresh_tasks.sql new file mode 100644 index 0000000..1a94ecd --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V44__candidate_scoring_refresh_tasks.sql @@ -0,0 +1,31 @@ +-- V44__candidate_scoring_refresh_tasks.sql +-- R01-D4-1：评分快照刷新任务表（持久化物化基础设施） +-- 只登记"该学生+周期需要重新物化"，不保存评分源数据；GET 兜底写入在 D4-2 前保留。 + +CREATE TABLE candidate_scoring_refresh_tasks ( + id BIGINT AUTO_INCREMENT PRIMARY KEY, + student_user_id BIGINT NOT NULL, + target_period VARCHAR(7) NOT NULL COMMENT 'yyyy-MM', + status VARCHAR(20) NOT NULL DEFAULT 'PENDING', + requested_at DATETIME NOT NULL, + processing_started_at DATETIME NULL, + processed_at DATETIME NULL, + next_attempt_at DATETIME NULL, + attempts INT NOT NULL DEFAULT 0, + last_error_code VARCHAR(40) NULL, + version BIGINT NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + CONSTRAINT uk_refresh_task_student_period UNIQUE (student_user_id, target_period), + CONSTRAINT ck_refresh_task_status CHECK (status IN ('PENDING', 'PROCESSING', 'RETRY', 'COMPLETED', 'FAILED')), + INDEX idx_refresh_task_claim (status, next_attempt_at), + CONSTRAINT fk_refresh_task_student FOREIGN KEY (student_user_id) REFERENCES users(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- 补偿扫描持久游标：跨实例、跨重启延续扫描位置；单轮只处理配置预算内的学生。 +CREATE TABLE candidate_scoring_refresh_scan_checkpoints ( + scan_key VARCHAR(40) PRIMARY KEY, + last_user_id BIGINT NOT NULL DEFAULT 0, + version BIGINT NOT NULL DEFAULT 0, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; diff --git a/mydreamjob-server/src/main/resources/db/migration/V45__add_scoring_refresh_claim_token.sql b/mydreamjob-server/src/main/resources/db/migration/V45__add_scoring_refresh_claim_token.sql new file mode 100644 index 0000000..823efd6 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V45__add_scoring_refresh_claim_token.sql @@ -0,0 +1,13 @@ +-- V45__add_scoring_refresh_claim_token.sql +-- R01-D4-2 claim fence 定向整改：为刷新任务引入不可复用的领取令牌。 +-- +-- 背景：V44 的 processing_started_at 为秒级 DATETIME，当租约回收与重新领取落在同一秒时， +-- 新旧两次领取得到完全相同的所有权标识，旧 Worker 的 PENDING 回退会误改新持有者。 +-- 本迁移新增 claim_token：每次成功领取写入全新随机 UUID，终态/PENDING 时清空。 +-- +-- 只新增列，不改动 V1–V44，不改动业务数据，不新增公网接口或 ErrorCode。 +-- processing_started_at 继续保留用于超时扫描与观测，但不再承担所有权证明。 + +ALTER TABLE candidate_scoring_refresh_tasks + ADD COLUMN claim_token VARCHAR(36) NULL + COMMENT '本次领取的不可复用令牌（UUID），终态/待处理时清空；仅用于并发所有权判定'; diff --git a/mydreamjob-server/src/main/resources/db/migration/V46__password_authentication.sql b/mydreamjob-server/src/main/resources/db/migration/V46__password_authentication.sql new file mode 100644 index 0000000..6c84c83 --- /dev/null +++ b/mydreamjob-server/src/main/resources/db/migration/V46__password_authentication.sql @@ -0,0 +1,5 @@ +-- V46: password credential lifecycle metadata. +-- The password hash already exists in V1; this timestamp is separate from updated_at +-- so profile edits cannot be mistaken for credential changes. +ALTER TABLE users + ADD COLUMN password_changed_at DATETIME NULL; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityAttemptServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityAttemptServiceTest.java new file mode 100644 index 0000000..22e1815 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityAttemptServiceTest.java @@ -0,0 +1,218 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.databind.node.JsonNodeFactory; +import com.mydreamjob.ability.dto.AbilityHistoryItem; +import com.mydreamjob.ability.dto.CreateAbilityAttemptRequest; +import com.mydreamjob.ability.dto.SaveAbilityAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +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 org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; + +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.time.ZoneOffset; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyList; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class AbilityAttemptServiceTest { + + @Mock private AbilityDefinitionRepository definitionRepository; + @Mock private AbilityQuestionRepository questionRepository; + @Mock private AbilityAttemptRepository attemptRepository; + @Mock private AbilityAttemptQuestionRepository attemptQuestionRepository; + @Mock private AbilityAnswerRepository answerRepository; + @Mock private AbilityResultRepository resultRepository; + @Mock private AbilityResultService resultService; + @Mock private AbilityResultComputer resultComputer; + @Mock private AbilityAttemptWriter attemptWriter; + @Mock private AbilitySnapshotCodec snapshotCodec; + @Mock private UserRepository userRepository; + @Mock private AuditService auditService; + @Mock private Clock clock; + + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; + @InjectMocks private AbilityAttemptService service; + + private final AuditContext ctx = AuditContext.builder().requestId("r").build(); + + @BeforeEach + void time() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + + org.mockito.Mockito.lenient().when(clock.getZone()).thenReturn(ZoneId.systemDefault()); + org.mockito.Mockito.lenient().when(clock.instant()).thenReturn(Instant.parse("2026-09-03T08:00:00Z")); + } + + private User student() { + return User.builder().id(77L).phone("p").role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)).build(); + } + + private AbilityDefinition activeDef(int maxCompleted) { + return AbilityDefinition.builder().id(1L).typeCode("WORKPLACE_ABILITY").status("ACTIVE") + .attemptQuestionCount(24).questionsPerDimension(6).timeLimitMinutes(30) + .resultValidDays(7).retakeWindowDays(90).retakeMaxCompleted(maxCompleted) + .questionSetVersion("ability-v0.1").rulesVersion("ability-scoring-v0.1").build(); + } + + @Test + void create_typeNotFound_whenDefinitionMissing() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode(anyString())).thenReturn(Optional.empty()); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(77L, newReq(), ctx)); + assertEquals(ErrorCode.ABILITY_TYPE_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_activeConflict_returns9808() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode(anyString())) + .thenReturn(Optional.of(activeDef(3))); + when(attemptRepository.findTimedOutActiveByUserAndDef(any(), any(), any())).thenReturn(List.of()); + when(attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn(any(), any(), any())) + .thenReturn(true); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(77L, newReq(), ctx)); + assertEquals(ErrorCode.ABILITY_DUPLICATE_ACTIVE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_retakeLimit_returns9811() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode(anyString())) + .thenReturn(Optional.of(activeDef(1))); + when(attemptRepository.findTimedOutActiveByUserAndDef(any(), any(), any())).thenReturn(List.of()); + when(attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn(any(), any(), any())) + .thenReturn(false); + when(attemptRepository.findByStudentUserIdAndDefinitionIdAndStatusOrderByCompletedAtDesc(any(), any(), anyString())) + .thenReturn(List.of()); + when(attemptRepository.countByStudentUserIdAndDefinitionIdAndStatusAndCompletedAtGreaterThanEqual( + any(), any(), anyString(), any())).thenReturn(1); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(77L, newReq(), ctx)); + assertEquals(ErrorCode.ABILITY_RETAKE_LIMIT.getCode(), ex.getErrorCodeInt()); + } + + @Test + void submit_perDimensionCheck_queriesAnswersOnce_notPerQuestion() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + when(definitionRepository.findById(1L)).thenReturn(Optional.of(activeDef(3))); + AbilityAttempt attempt = AbilityAttempt.builder().id(9L).studentUserId(77L).definitionId(1L) + .status(AbilityAttempt.STATUS_IN_PROGRESS).questionSetVersion("ability-v0.1") + .expiresAt(LocalDateTime.now(clock).plusMinutes(30)).build(); + when(attemptRepository.findById(9L)).thenReturn(Optional.of(attempt)); + when(answerRepository.countByAttemptId(9L)).thenReturn(24L); + List aqs = new ArrayList<>(); + for (int i = 0; i < 24; i++) { + aqs.add(AbilityAttemptQuestion.builder().id(1000L + i).attemptId(9L).position(i + 1).build()); + } + when(attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(9L)).thenReturn(aqs); + // 空答案 → 四维未答满 → 9806；借此验证 perDimensionAnswered 只批量取一次答案、不逐题查询 + when(answerRepository.findByAttemptId(9L)).thenReturn(List.of()); + + BusinessException ex = assertThrows(BusinessException.class, + () -> service.submit(77L, 9L, ctx)); + assertEquals(ErrorCode.ABILITY_INCOMPLETE.getCode(), ex.getErrorCodeInt()); + + verify(answerRepository, times(1)).findByAttemptId(anyLong()); + } + + @Test + void saveAnswers_24Questions_batchLoadOnce_saveAllOnce() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + AbilityAttempt attempt = AbilityAttempt.builder().id(9L).studentUserId(77L).definitionId(1L) + .status(AbilityAttempt.STATUS_IN_PROGRESS).questionSetVersion("ability-v0.1") + .expiresAt(LocalDateTime.now(clock).plusMinutes(30)).build(); + when(attemptRepository.findById(9L)).thenReturn(Optional.of(attempt)); + when(definitionRepository.findById(1L)).thenReturn(Optional.of(activeDef(3))); + + List aqs = new ArrayList<>(); + for (int i = 0; i < 24; i++) { + aqs.add(AbilityAttemptQuestion.builder().id(1000L + i).attemptId(9L).position(i + 1).build()); + } + when(attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(9L)).thenReturn(aqs); + when(snapshotCodec.optionExists(any(), any())).thenReturn(true); + when(snapshotCodec.awardedScore(any(), any())).thenReturn(4); + when(snapshotCodec.parse(any())).thenReturn(JsonNodeFactory.instance.objectNode()); + // 部分题目已存在答案（模拟混合 upsert 的既有数据路径） + when(answerRepository.findByAttemptIdAndAttemptQuestionIdIn(anyLong(), anyList())) + .thenReturn(List.of(AbilityAnswer.builder().id(9L).attemptId(9L) + .attemptQuestionId(1000L).selectedOptionId("A").awardedScore(0).build())); + when(answerRepository.countByAttemptId(9L)).thenReturn(24L); + when(answerRepository.findByAttemptId(9L)).thenReturn(List.of()); + when(attemptRepository.saveAndFlush(any())).thenReturn(attempt); + + SaveAbilityAnswersRequest req = new SaveAbilityAnswersRequest(); + List items = new ArrayList<>(); + for (int i = 0; i < 24; i++) { + SaveAbilityAnswersRequest.AnswerItem it = new SaveAbilityAnswersRequest.AnswerItem(); + it.setAttemptQuestionId(1000L + i); + it.setSelectedOptionId("A"); + items.add(it); + } + req.setAnswers(items); + + service.saveAnswers(77L, 9L, req, ctx); + + // 24 题整体保存只触发一次批量查询与一次批量持久化；单题查询方法已删除，结构上不可能逐题查询 + verify(answerRepository, times(1)).findByAttemptIdAndAttemptQuestionIdIn(anyLong(), anyList()); + verify(answerRepository, times(1)).saveAll(any()); + } + + @Test + void listMine_loadsDefinitionsInBatch_notPerItem() { + when(userRepository.findById(77L)).thenReturn(Optional.of(student())); + AbilityAttempt a1 = AbilityAttempt.builder().id(1L).studentUserId(77L).definitionId(1L) + .status(AbilityAttempt.STATUS_COMPLETED).questionSetVersion("ability-v0.1").build(); + AbilityAttempt a2 = AbilityAttempt.builder().id(2L).studentUserId(77L).definitionId(2L) + .status(AbilityAttempt.STATUS_COMPLETED).questionSetVersion("ability-v0.1").build(); + when(attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(any(), any())) + .thenReturn(new PageImpl<>(List.of(a1, a2))); + when(resultRepository.findByAttemptIdIn(any())).thenReturn(List.of()); + when(definitionRepository.findAllById(any())).thenReturn(List.of()); + + Page page = service.listMine(77L, 0, 20); + assertEquals(2, page.getContent().size()); + + verify(definitionRepository, never()).findById(anyLong()); + verify(definitionRepository, times(1)).findAllById(any()); + } + + private CreateAbilityAttemptRequest newReq() { + CreateAbilityAttemptRequest r = new CreateAbilityAttemptRequest(); + r.setTypeCode("WORKPLACE_ABILITY"); + return r; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityCatalogServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityCatalogServiceTest.java new file mode 100644 index 0000000..0e70f11 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityCatalogServiceTest.java @@ -0,0 +1,39 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityTypeResponse; +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.util.List; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class AbilityCatalogServiceTest { + + @Mock private AbilityDefinitionRepository definitionRepository; + @InjectMocks private AbilityCatalogService catalogService; + + @Test + void listTypes_returnsActiveDefinitionsMapped() { + AbilityDefinition def = AbilityDefinition.builder() + .id(1L).typeCode("WORKPLACE_ABILITY").displayName("四维能力测评") + .description("desc").status("ACTIVE").questionCount(48).attemptQuestionCount(24) + .questionsPerDimension(6).timeLimitMinutes(30).resultValidDays(7).build(); + when(definitionRepository.findAllByStatusOrderByCreatedAtAsc("ACTIVE")) + .thenReturn(List.of(def)); + + List types = catalogService.listTypes(); + assertEquals(1, types.size()); + AbilityTypeResponse t = types.get(0); + assertEquals("WORKPLACE_ABILITY", t.getTypeCode()); + assertEquals(48, t.getQuestionCount()); + assertEquals(24, t.getAttemptQuestionCount()); + assertEquals(30, t.getTimeLimitMinutes()); + assertEquals(7, t.getResultValidDays()); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityControllerTest.java new file mode 100644 index 0000000..62b1f77 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityControllerTest.java @@ -0,0 +1,162 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; +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 AbilityControllerTest { + + private static final AtomicLong PHONE = new AtomicLong(6000); + + @Autowired private MockMvc mockMvc; + @Autowired private ObjectMapper objectMapper; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private UserRepository userRepository; + + @MockBean private RedisTemplate redisTemplate; + + private Long studentUserId; + private Long companyUserId; + private Long adminUserId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + studentUserId = createUser(User.Role.STUDENT); + companyUserId = createUser(User.Role.COMPANY); + adminUserId = createUser(User.Role.ADMIN); + } + + @AfterEach + void tearDown() { + userRepository.deleteById(adminUserId); + userRepository.deleteById(companyUserId); + userRepository.deleteById(studentUserId); + } + + private Long createUser(User.Role role) { + User u = userRepository.save(User.builder() + .phone("17" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(role).roles(Set.of(role)).active(true).verified(true).build()); + return u.getId(); + } + + private String token(Long userId, User.Role role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); + } + + @Test + void anonymous_create_returns401() throws Exception { + mockMvc.perform(post("/abilities/attempts").contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"WORKPLACE_ABILITY\"}")).andExpect(status().isUnauthorized()); + } + + @Test + void studentListTypes_returns200() throws Exception { + mockMvc.perform(get("/abilities/types").header("Authorization", token(studentUserId, User.Role.STUDENT))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.[0].typeCode").value("WORKPLACE_ABILITY")); + } + + @Test + void companyAndAdmin_create_returns403() throws Exception { + mockMvc.perform(post("/abilities/attempts").header("Authorization", token(companyUserId, User.Role.COMPANY)) + .contentType(MediaType.APPLICATION_JSON).content("{\"typeCode\":\"WORKPLACE_ABILITY\"}")) + .andExpect(status().isForbidden()); + mockMvc.perform(post("/abilities/attempts").header("Authorization", token(adminUserId, User.Role.ADMIN)) + .contentType(MediaType.APPLICATION_JSON).content("{\"typeCode\":\"WORKPLACE_ABILITY\"}")) + .andExpect(status().isForbidden()); + } + + @Test + void fullStudentFlow_createSaveSubmitResult_repeatIdempotent_noSensitiveLeak() throws Exception { + String tk = token(studentUserId, User.Role.STUDENT); + + JsonNode create = objectMapper.readTree(mockMvc.perform(post("/abilities/attempts") + .header("Authorization", tk).contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"WORKPLACE_ABILITY\",\"idempotencyKey\":\"http-key-1\"}")) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString()); + long attemptId = create.path("data").path("attemptId").asLong(); + assertEquals(24, create.path("data").path("questions").size()); + + List> answers = new ArrayList<>(); + for (JsonNode q : create.path("data").path("questions")) { + answers.add(Map.of("attemptQuestionId", q.path("attemptQuestionId").asLong(), + "selectedOptionId", "A")); + } + String body = objectMapper.writeValueAsString(Map.of("answers", answers)); + + mockMvc.perform(patch("/abilities/attempts/{id}/answers", attemptId) + .header("Authorization", tk).contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.answeredCount").value(24)); + + JsonNode submitted = objectMapper.readTree(mockMvc.perform(post("/abilities/attempts/{id}/submit", attemptId) + .header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.status").value("COMPLETED")) + .andReturn().getResponse().getContentAsString()); + + // 结果脱敏：完整 result JSON 不得包含题库内部字段 + String submitedRaw = submitted.toString(); + assertFalse(submitedRaw.contains("studentUserId")); + assertFalse(submitedRaw.contains("phone")); + assertFalse(submitedRaw.contains("email")); + assertFalse(submitedRaw.contains("answerKey"), "result must not contain answerKey"); + assertFalse(submitedRaw.contains("scoringRule"), "result must not contain scoringRule"); + assertFalse(submitedRaw.contains("questionCode"), "result must not contain questionCode"); + assertFalse(submitedRaw.contains("competencyTag"), "result must not contain competencyTag"); + assertFalse(submitedRaw.contains("source"), "result must not contain source"); + assertFalse(submitedRaw.contains("difficulty"), "result must not contain difficulty"); + assertFalse(submitedRaw.contains("discrimination"), "result must not contain discrimination"); + assertTrue(submitedRaw.contains("disclaimer")); + assertEquals(4, submitted.path("data").path("dimensionScores").size()); + + // 重复提交幂等：同一综合分 + JsonNode resub = objectMapper.readTree(mockMvc.perform(post("/abilities/attempts/{id}/submit", attemptId) + .header("Authorization", tk)).andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString()); + assertEquals(submitted.path("data").path("overallScore").asText(), + resub.path("data").path("overallScore").asText()); + + // GET result 200 + mockMvc.perform(get("/abilities/attempts/{id}/result", attemptId).header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.validityStatus").value("VALID")); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityPersistenceIntegrationTest.java new file mode 100644 index 0000000..64c7b18 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityPersistenceIntegrationTest.java @@ -0,0 +1,391 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityAttemptResponse; +import com.mydreamjob.ability.dto.CreateAbilityAttemptRequest; +import com.mydreamjob.ability.dto.SaveAbilityAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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 java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@SpringBootTest +@ActiveProfiles("integration-test") +class AbilityPersistenceIntegrationTest { + + private static final AtomicLong PHONE = new AtomicLong(5000); + private LocalDateTime base = LocalDateTime.of(2026, 9, 3, 8, 0, 0); + + @Autowired private AbilityAttemptService attemptService; + @Autowired private AbilityDefinitionRepository definitionRepository; + @Autowired private AbilityAttemptRepository attemptRepository; + @Autowired private AbilityAttemptQuestionRepository attemptQuestionRepository; + @Autowired private AbilityAnswerRepository answerRepository; + @Autowired private AbilityResultRepository resultRepository; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository dimensionScoreRepository; + @Autowired private AuditLogRepository auditLogRepository; + + @MockBean private RedisTemplate redisTemplate; + @MockBean private Clock clock; + + private final AuditContext ctx = AuditContext.builder().requestId("req").build(); + private final List createdUsers = new ArrayList<>(); + + @BeforeEach + void setUp() { + when(redisTemplate.opsForValue()).thenReturn(mock(org.springframework.data.redis.core.ValueOperations.class)); + when(redisTemplate.hasKey(any())).thenReturn(false); + time(base); + } + + @AfterEach + void tearDown() { + for (Long id : createdUsers) { + userRepository.deleteById(id); + } + createdUsers.clear(); + } + + private void time(LocalDateTime t) { + when(clock.getZone()).thenReturn(ZoneId.of("Asia/Shanghai")); + when(clock.instant()).thenReturn(t.atZone(ZoneId.of("Asia/Shanghai")).toInstant()); + } + + private Long createUser() { + User u = userRepository.save(User.builder() + .phone("18" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).active(true).verified(true).build()); + createdUsers.add(u.getId()); + return u.getId(); + } + + private CreateAbilityAttemptRequest createReq(String key) { + CreateAbilityAttemptRequest r = new CreateAbilityAttemptRequest(); + r.setTypeCode("WORKPLACE_ABILITY"); + r.setIdempotencyKey(key); + return r; + } + + private SaveAbilityAnswersRequest answers(AbilityAttemptResponse resp, int start, int end, String option) { + List items = new ArrayList<>(); + for (int i = start; i < end && i < resp.getQuestions().size(); i++) { + var q = resp.getQuestions().get(i); + SaveAbilityAnswersRequest.AnswerItem it = new SaveAbilityAnswersRequest.AnswerItem(); + it.setAttemptQuestionId(q.getAttemptQuestionId()); + it.setSelectedOptionId(option); + items.add(it); + } + SaveAbilityAnswersRequest r = new SaveAbilityAnswersRequest(); + r.setAnswers(items); + return r; + } + + @Test + void create_returns24QuestionsFourDimsSixEach_andNoLeakyFields() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("k1"), ctx); + assertEquals(24, resp.getQuestions().size()); + assertEquals(24, resp.getTotalQuestions()); + assertEquals("DRAFT", resp.getStatus()); + assertNull(resp.getStartedAt()); + assertEquals(24, attemptQuestionRepository.countByAttemptId(resp.getAttemptId())); + resp.getQuestions().forEach(q -> { + assertNotNull(q.getAttemptQuestionId()); + assertNotNull(q.getStem()); + assertEquals(4, q.getOptions().size()); + }); + } + + @Test + void attemptResponse_hasNoAnswerOrScoringExposed() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("k2"), ctx); + String json = resp.getQuestions().toString(); + assertFalse(json.contains("answerKey")); + assertFalse(json.contains("scoringRule")); + assertFalse(json.contains("awardedScore")); + } + + @Test + void idempotentSameKey_returnsSameAttempt() { + Long u = createUser(); + AbilityAttemptResponse a = attemptService.create(u, createReq("idem1"), ctx); + AbilityAttemptResponse b = attemptService.create(u, createReq("idem1"), ctx); + assertEquals(a.getAttemptId(), b.getAttemptId()); + } + + @Test + void activeDuplicate_returns9808() { + Long u = createUser(); + attemptService.create(u, createReq("act1"), ctx); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.create(u, createReq("act2"), ctx)); + assertEquals(ErrorCode.ABILITY_DUPLICATE_ACTIVE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void firstSave_startsTimer_subsequentSaveDoesNotExtend() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("t1"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 1, "B"), ctx); + var a = attemptRepository.findById(resp.getAttemptId()).get(); + assertEquals("IN_PROGRESS", a.getStatus()); + assertEquals(base, a.getStartedAt().withNano(0).withSecond(0)); + assertEquals(base.plusMinutes(30), a.getExpiresAt().withNano(0).withSecond(0)); + + time(base.plusMinutes(5)); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 1, 2, "C"), ctx); + var a2 = attemptRepository.findById(resp.getAttemptId()).get(); + assertEquals(base.plusMinutes(30), a2.getExpiresAt().withNano(0).withSecond(0), "must not extend"); + } + + @Test + void saveAnswers_mixedExistingAndNew_shouldUpsert() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("upsert"), ctx); + // 先答第 0、1 题（option A） + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 2, "A"), ctx); + + Long aq0 = resp.getQuestions().get(0).getAttemptQuestionId(); + Long aq2 = resp.getQuestions().get(2).getAttemptQuestionId(); + Long aq3 = resp.getQuestions().get(3).getAttemptQuestionId(); + // 混合保存：覆盖第 0 题(改 D) + 新增第 2、3 题(B) + SaveAbilityAnswersRequest req = new SaveAbilityAnswersRequest(); + SaveAbilityAnswersRequest.AnswerItem i0 = new SaveAbilityAnswersRequest.AnswerItem(); + i0.setAttemptQuestionId(aq0); + i0.setSelectedOptionId("D"); + SaveAbilityAnswersRequest.AnswerItem i2 = new SaveAbilityAnswersRequest.AnswerItem(); + i2.setAttemptQuestionId(aq2); + i2.setSelectedOptionId("B"); + SaveAbilityAnswersRequest.AnswerItem i3 = new SaveAbilityAnswersRequest.AnswerItem(); + i3.setAttemptQuestionId(aq3); + i3.setSelectedOptionId("B"); + req.setAnswers(List.of(i0, i2, i3)); + attemptService.saveAnswers(u, resp.getAttemptId(), req, ctx); + + // 持久化断言：1 条覆盖 + 2 条新增，加上最初的第 1 题，共 4 条；覆盖题的选项已更新 + List saved = answerRepository.findByAttemptId(resp.getAttemptId()); + assertEquals(4, saved.size(), "1 overwrite + 2 insert + 1 original"); + AbilityAnswer ans0 = saved.stream().filter(a -> a.getAttemptQuestionId().equals(aq0)) + .findFirst().orElseThrow(); + assertEquals("D", ans0.getSelectedOptionId(), "existing answer must be overwritten"); + assertTrue(saved.stream().anyMatch(a -> a.getAttemptQuestionId().equals(aq2))); + assertTrue(saved.stream().anyMatch(a -> a.getAttemptQuestionId().equals(aq3))); + } + + @Test + void timeout_expiresAttempt_andReleasesActiveKey() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("t2"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 1, "B"), ctx); + time(base.plusMinutes(31)); + AbilityAttemptResponse g = attemptService.get(u, resp.getAttemptId()); + assertEquals("EXPIRED", g.getStatus()); + var a = attemptRepository.findById(resp.getAttemptId()).get(); + assertNull(a.getActiveKey()); + } + + @Test + void injection_fromAnotherAttempt_isRejected9805() { + Long u = createUser(); + AbilityAttemptResponse a = attemptService.create(u, createReq("inj1"), ctx); + attemptService.saveAnswers(u, a.getAttemptId(), answers(a, 0, 24, "B"), ctx); + attemptService.submit(u, a.getAttemptId(), ctx); // 完成 a，释放 active + try { + time(base.plusDays(8)); // 让结果过期，允许重测创建 b + } catch (Exception ignored) { + } + AbilityAttemptResponse b = attemptService.create(u, createReq("inj2"), ctx); + var req = new SaveAbilityAnswersRequest(); + SaveAbilityAnswersRequest.AnswerItem item = new SaveAbilityAnswersRequest.AnswerItem(); + item.setAttemptQuestionId(a.getQuestions().get(0).getAttemptQuestionId()); // a 的第一题 + item.setSelectedOptionId("A"); + req.setAnswers(List.of(item)); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.saveAnswers(u, b.getAttemptId(), req, ctx)); + assertEquals(ErrorCode.ABILITY_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + } + + @Test + void invalidOption_isRejected9805_noTimerStart() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("inv1"), ctx); + var req = new SaveAbilityAnswersRequest(); + SaveAbilityAnswersRequest.AnswerItem item = new SaveAbilityAnswersRequest.AnswerItem(); + item.setAttemptQuestionId(resp.getQuestions().get(0).getAttemptQuestionId()); + item.setSelectedOptionId("Z"); + req.setAnswers(List.of(item)); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.saveAnswers(u, resp.getAttemptId(), req, ctx)); + assertEquals(ErrorCode.ABILITY_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + var a = attemptRepository.findById(resp.getAttemptId()).get(); + assertNull(a.getStartedAt(), "invalid save must not start timer"); + } + + @Test + void submit_23of24_returns9806() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("s1"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 23, "B"), ctx); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.submit(u, resp.getAttemptId(), ctx)); + assertEquals(ErrorCode.ABILITY_INCOMPLETE.getCode(), ex.getErrorCodeInt()); + } + + // 24/24 提交 → 结果；重复提交幂等；result 唯一；审计一条 + @Test + void submit24_thenRepeatIdempotent_singleResultAndAudit() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("s2"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 24, "B"), ctx); + var r1 = attemptService.submit(u, resp.getAttemptId(), ctx); + assertEquals("COMPLETED", r1.getStatus()); + assertNotNull(r1.getOverallScore()); + assertEquals(4, r1.getDimensionScores().size()); + assertEquals(24, r1.getQuestionFeedback().size()); + + var r2 = attemptService.submit(u, resp.getAttemptId(), ctx); + assertEquals(r1.getOverallScore(), r2.getOverallScore()); + + assertEquals(1, countResults(resp.getAttemptId())); + assertEquals(1, countSubmitAudits(resp.getAttemptId())); + assertNotNull(r1.getImprovementAreas()); + assertFalse(r1.getImprovementAreas().isEmpty()); + } + + @Test + void completedResult_triggersRetakeCooldown_9810() { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("c1"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 24, "A"), ctx); + attemptService.submit(u, resp.getAttemptId(), ctx); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.create(u, createReq("c2"), ctx)); + assertEquals(ErrorCode.ABILITY_RETAKE_COOLDOWN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void concurrentCreate_onlyOneSuccess_others9808() throws Exception { + Long u = createUser(); + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue results = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + final String key = "cc-" + u + "-" + i; + pool.submit(() -> { + await(start); + try { + attemptService.create(u, createReq(key), ctx); + results.add(0); + } catch (BusinessException be) { + results.add(be.getErrorCodeInt()); + } catch (Exception e) { + results.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(30, TimeUnit.SECONDS)); + pool.shutdown(); + assertEquals(1, results.stream().filter(c -> c == 0).count(), "exactly one success"); + assertEquals(n - 1, results.stream().filter(c -> c == ErrorCode.ABILITY_DUPLICATE_ACTIVE.getCode()).count()); + assertEquals(0, results.stream().filter(c -> c == -1).count(), "no 500"); + assertTrue(attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(u, + org.springframework.data.domain.PageRequest.of(0, 50)).getContent().stream() + .filter(a -> a.getActiveKey() != null).count() == 1, "one active_key"); + } + + @Test + void concurrentSubmit_singleResultAndAudit_no500() throws Exception { + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("cs"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 24, "B"), ctx); + int n = 2; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue codes = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + attemptService.submit(u, resp.getAttemptId(), ctx); + codes.add(0); + } catch (Exception e) { + codes.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(30, TimeUnit.SECONDS)); + pool.shutdown(); + assertEquals(0, codes.stream().filter(c -> c < 0).count(), "no 500"); + assertEquals(1, countResults(resp.getAttemptId())); + assertEquals(1, countSubmitAudits(resp.getAttemptId())); + } + + @Test + void candidateDimensionScores_unchanged() { + long before = dimensionScoreRepository.count(); + Long u = createUser(); + AbilityAttemptResponse resp = attemptService.create(u, createReq("cds"), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answers(resp, 0, 24, "B"), ctx); + attemptService.submit(u, resp.getAttemptId(), ctx); + assertEquals(before, dimensionScoreRepository.count(), "must not write candidate_dimension_scores"); + } + + private void await(CountDownLatch latch) { + try { + latch.await(); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + + private long countResults(Long attemptId) { + return resultRepository.findByAttemptId(attemptId).isPresent() ? 1 : 0; + } + + private long countSubmitAudits(Long attemptId) { + return auditLogRepository.findAll().stream() + .filter(l -> "ABILITY_ATTEMPT_SUBMITTED".equals(l.getAction()) + && Long.toString(attemptId).equals(String.valueOf(l.getEntityId()))) + .count(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityQuestionBankTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityQuestionBankTest.java new file mode 100644 index 0000000..4803cdb --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityQuestionBankTest.java @@ -0,0 +1,128 @@ +package com.mydreamjob.ability; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.core.io.ClassPathResource; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * 题库对账测试（V36）：把数据库迁移后的 ability_questions 与权威 JSON 逐题对账， + * 并校验总数 48 / 四维各 12 / 12 个 competencyTag 各 4（通过各维 3 标签×4）/ + * 最优答案 A/B/C/D 各 12（四维各 12）/ position 1-48 唯一 / 每题 {0,1,2,4} / answerKey=4 分 / explanation 非空 / + * questionVersion / source / active。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AbilityQuestionBankTest { + + @Autowired private AbilityQuestionRepository questionRepository; + @Autowired private AbilityDefinitionRepository definitionRepository; + @Autowired private ObjectMapper objectMapper; + + @MockBean private RedisTemplate redisTemplate; + + private JsonNode bank; + + @BeforeEach + void loadBank() throws Exception { + bank = objectMapper.readTree(new ClassPathResource("ability-question-bank-v0.1.json").getInputStream()); + } + + @Test + void bankReconciledWithDatabase_andDistributionsHold() throws Exception { + Long defId = definitionRepository.findByTypeCode("WORKPLACE_ABILITY").orElseThrow().getId(); + List rows = questionRepository.findAllByDefinitionIdOrderByPositionAsc(defId); + assertEquals(48, rows.size(), "total questions"); + + // 权威 JSON + JsonNode qs = bank.path("questions"); + assertEquals(48, qs.size()); + + // DB 侧分布 + Map dimCount = new HashMap<>(); + Map tagCount = new HashMap<>(); + Map bestCount = new HashMap<>(); + Set positions = new HashSet<>(); + Map byPos = new HashMap<>(); + for (AbilityQuestion q : rows) { + dimCount.merge(q.getDimension(), 1, Integer::sum); + tagCount.merge(q.getCompetencyTag(), 1, Integer::sum); + positions.add(q.getPosition()); + byPos.put(q.getPosition(), q); + JsonNode rule = objectMapper.readTree(q.getScoringRuleJson()); + for (String opt : List.of("A", "B", "C", "D")) { + rule.get(opt); + } + bestCount.merge(objectMapper.readTree(q.getAnswerKeyJson()).path("answerKey").asText(), 1, Integer::sum); + } + for (String d : List.of("LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING")) { + assertEquals(12, dimCount.getOrDefault(d, 0), "dim " + d); + } + assertEquals(12, tagCount.size(), "competencyTag count"); + tagCount.values().forEach(c -> assertEquals(4, c)); + for (String l : List.of("A", "B", "C", "D")) { + assertEquals(12, bestCount.getOrDefault(l, 0), "best " + l); + } + assertEquals(48, positions.size(), "positions unique"); + assertEquals(48, positions.stream().mapToInt(Integer::intValue).max().orElse(0), "max position"); + + // 逐题对账 + for (JsonNode aqJson : qs) { + int pos = aqJson.path("position").asInt(); + AbilityQuestion db = byPos.get(pos); + assertNotNull(db, "missing position " + pos); + assertEquals(aqJson.path("questionCode").asText(), db.getQuestionCode()); + assertEquals(aqJson.path("dimension").asText(), db.getDimension()); + assertEquals(aqJson.path("competencyTag").asText(), db.getCompetencyTag()); + assertEquals(aqJson.path("itemType").asText(), db.getItemType()); + assertEquals(aqJson.path("stem").asText(), db.getStem()); + assertEquals(aqJson.path("difficulty").asText(), db.getDifficulty()); + assertEquals("ability-v0.1", db.getQuestionVersion()); + assertEquals("SELF_AUTHORED", db.getSource()); + assertTrue(db.getActive()); + assertTrue(db.getExplanation() != null && !db.getExplanation().isBlank()); + + // options 逐项一致 + JsonNode optJson = aqJson.path("options"); + JsonNode optDb = objectMapper.readTree(db.getOptionsJson()); + assertEquals(optJson.size(), optDb.size(), pos + " options size"); + for (int i = 0; i < optJson.size(); i++) { + assertEquals(optJson.get(i).path("optionId").asText(), optDb.get(i).path("optionId").asText()); + assertEquals(optJson.get(i).path("text").asText(), optDb.get(i).path("text").asText()); + } + // scoringRule 与 answerKey 一致 + JsonNode ruleJson = aqJson.path("scoringRule"); + JsonNode ruleDb = objectMapper.readTree(db.getScoringRuleJson()); + Set scoreSet = new HashSet<>(); + for (String opt : List.of("A", "B", "C", "D")) { + assertEquals(ruleJson.get(opt).asInt(), ruleDb.get(opt).asInt(), pos + " score " + opt); + scoreSet.add(ruleDb.get(opt).asInt()); + } + assertEquals(Set.of(0, 1, 2, 4), scoreSet, pos + " scoring set"); + assertEquals(aqJson.path("answerKey").asText(), + objectMapper.readTree(db.getAnswerKeyJson()).path("answerKey").asText()); + // answerKey 对应的分值必须为 4 + assertEquals(4, ruleDb.get(aqJson.path("answerKey").asText()).asInt(), pos + " answerKey not 4"); + assertEquals(aqJson.path("explanation").asText(), db.getExplanation()); + } + } + + @AfterEach + void reset() { + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityResultComputerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityResultComputerTest.java new file mode 100644 index 0000000..a8190af --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilityResultComputerTest.java @@ -0,0 +1,111 @@ +package com.mydreamjob.ability; + +import com.mydreamjob.ability.dto.AbilityResultResponse; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +class AbilityResultComputerTest { + + private final AbilityResultComputer computer = new AbilityResultComputer(); + + private List items(int[] perDimScore, String[] dims, + String[][] tags) { + List out = new ArrayList<>(); + long aid = 0; + for (int d = 0; d < dims.length; d++) { + int[] scores = java.util.Arrays.copyOf(perDimScore, 6); + for (int i = 0; i < 6; i++) { + out.add(new AbilityResultComputer.Answered(dims[d], tags[d][i % tags[d].length], + "stem-" + dims[d] + i, "exp-" + dims[d] + i, scores[i], ++aid, d * 6 + i + 1, "B")); + } + } + return out; + } + + @Test + void computesDimensionsOverallWeaknessImprovementRadarFeedback() { + int[] log = {4, 4, 4, 4, 4, 4}; // 100 + int[] com = {2, 2, 2, 2, 2, 2}; // 50 + int[] exe = {1, 1, 1, 1, 1, 1}; // 25 + int[] lea = {0, 0, 0, 0, 0, 0}; // 0 + String[] dims = {"LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"}; + String[][] tags = { + {"INFORMATION_ANALYSIS", "CAUSAL_REASONING", "PROBLEM_SOLVING"}, + {"LISTENING_UNDERSTANDING", "STRUCTURED_EXPRESSION", "COLLABORATION_CONFLICT"}, + {"PLANNING_PRIORITIZATION", "RISK_FOLLOWUP", "DELIVERY_REVIEW"}, + {"INFORMATION_ACQUISITION", "FEEDBACK_REFLECTION", "TRANSFER_ADAPTATION"}}; + List list = new ArrayList<>(); + list.addAll(items(log, dims, tags)); // default perDimScore arrays reused? recompute below + list = new ArrayList<>(); + int row = 0; + List built = new ArrayList<>(); + for (int d = 0; d < 4; d++) { + int base = switch (d) { + case 0 -> 4; + case 1 -> 2; + case 2 -> 1; + default -> 0; + }; + for (int i = 0; i < 6; i++) { + built.add(new AbilityResultComputer.Answered(dims[d], tags[d][i % 3], + "s" + row, "e" + row, base, ++row, row, "A")); + } + } + var computed = computer.compute(built, 6); + + assertEquals(4, computed.dimensionScores().size()); + assertEquals(new BigDecimal("100.00"), score(computed, "LOGIC")); + assertEquals(new BigDecimal("50.00"), score(computed, "COMMUNICATION")); + assertEquals(new BigDecimal("25.00"), score(computed, "EXECUTION")); + assertEquals(new BigDecimal("0.00"), score(computed, "LEARNING")); + assertEquals(new BigDecimal("43.75"), computed.overallScore()); + + assertEquals(1, computed.weaknesses().size()); + assertEquals("LEARNING", computed.weaknesses().get(0).getCode()); + assertEquals(new BigDecimal("0.00"), computed.weaknesses().get(0).getScore()); + + assertEquals(1, computed.improvementAreas().size()); + assertEquals("LEARNING", computed.improvementAreas().get(0).getDimension()); + // competencyTag 字段已从 DTO 删除；仅保留 dimension/currentScore/summary/actions + assertNotNull(computed.improvementAreas().get(0).getSummary()); + assertFalse(computed.improvementAreas().get(0).getActions().isEmpty()); + + assertEquals(4, computed.radar().size()); + assertEquals(24, computed.questionFeedback().size()); + assertEquals(4, computed.questionFeedback().get(0).getAwardedScore()); + assertNotNull(computed.questionFeedback().get(0).getExplanation()); + } + + @Test + void weaknessReturnsAllTiedDimensions() { + List built = new ArrayList<>(); + int row = 0; + String[] dims = {"LOGIC", "COMMUNICATION", "EXECUTION", "LEARNING"}; + String[][] tags = { + {"INFORMATION_ANALYSIS"}, {"LISTENING_UNDERSTANDING"}, + {"PLANNING_PRIORITIZATION"}, {"INFORMATION_ACQUISITION"}}; + // LOGIC 与 COMMUNICATION 并列最低（全 0） + for (String d : dims) { + int base = (d.equals("EXECUTION") || d.equals("LEARNING")) ? 4 : 0; + for (int i = 0; i < 6; i++) { + built.add(new AbilityResultComputer.Answered(d, tags[0][0] + (d.equals("LOGIC") ? 0 : 1), + "s" + row, "e" + row, base, ++row, row, "A")); + } + } + var c = computer.compute(built, 6); + assertEquals(2, c.weaknesses().size()); + assertEquals(new BigDecimal("0.00"), c.weaknesses().get(0).getScore()); + assertTrue(c.weaknesses().stream().anyMatch(w -> w.getCode().equals("LOGIC"))); + assertTrue(c.weaknesses().stream().anyMatch(w -> w.getCode().equals("COMMUNICATION"))); + } + + private BigDecimal score(AbilityResultComputer.ComputedResult c, String code) { + return c.dimensionScores().stream().filter(d -> d.getCode().equals(code)) + .findFirst().map(AbilityResultResponse.DimensionScore::getScore).orElseThrow(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilitySchemaValidationSmokeTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilitySchemaValidationSmokeTest.java new file mode 100644 index 0000000..35bb78c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/ability/AbilitySchemaValidationSmokeTest.java @@ -0,0 +1,62 @@ +package com.mydreamjob.ability; + +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.lang.reflect.Field; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * V36 启动/schema 校验冒烟测试：ability_questions.active 为 TINYINT（非 BIT）， + * 实体 Boolean 以 @JdbcTypeCode(TINYINT) 映射，避免与迁移类型冲突；六张表 + 迁移(48 题)可加载。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AbilitySchemaValidationSmokeTest { + + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private RedisTemplate redisTemplate; + + @Test + void contextBoots_andAbilityColumnsAreTinyInt() { + List> cols = jdbcTemplate.queryForList( + "SELECT column_name, data_type, is_nullable FROM information_schema.columns " + + "WHERE LOWER(table_name) = 'ability_questions' AND LOWER(column_name) = 'active'"); + assertEquals(1, cols.size()); + String type = String.valueOf(cols.get(0).get("DATA_TYPE")).toUpperCase(); + assertTrue(type.contains("INT"), "ability_questions.active must be TINYINT, got " + type); + assertEquals("NO", String.valueOf(cols.get(0).get("IS_NULLABLE")).toUpperCase()); + + // 实体映射为 TINYINT + assertEquals(SqlTypes.TINYINT, fieldJdbcType("active")); + assertTrue(questionCount() == 48, "ability_questions must seed 48"); + } + + private Long questionCount() { + return jdbcTemplate.queryForObject("SELECT COUNT(*) FROM ability_questions", Long.class); + } + + private int fieldJdbcType(String name) { + try { + Field f = AbilityQuestion.class.getDeclaredField(name); + JdbcTypeCode code = f.getAnnotation(JdbcTypeCode.class); + assertNotNull(code, name + " must carry @JdbcTypeCode"); + return code.value(); + } catch (NoSuchFieldException e) { + throw new AssertionError(e); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationControllerTest.java index af989fe..576c74b 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationControllerTest.java @@ -78,18 +78,15 @@ class ApplicationControllerTest { } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken( - COMPANY_USER_ID, "1", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(COMPANY_USER_ID, "COMPANY"); } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken( - STUDENT_USER_ID, "1", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_USER_ID, "STUDENT"); } private String adminToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken( - ADMIN_USER_ID, "1", Map.of("roles", "ADMIN")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(ADMIN_USER_ID, "ADMIN"); } private void mockCompanyExists() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationServiceTest.java index 6d56944..0af13ac 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/application/ApplicationServiceTest.java @@ -6,32 +6,25 @@ import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.application.dto.ApplicationCreateRequest; import com.mydreamjob.application.dto.ApplicationStatusRequest; import com.mydreamjob.application.dto.CandidateDetailView; -import com.mydreamjob.application.dto.CandidateItemView; -import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; -import com.mydreamjob.candidatescore.CandidateScoringCalculator; -import com.mydreamjob.common.api.PageResponse; -import com.mydreamjob.privacy.PrivacySettingsService; +import com.mydreamjob.application.dto.CandidateListResponse; import com.mydreamjob.profile.StudentProfile; -import com.mydreamjob.recommend.TalentMatchScorer; +import jakarta.persistence.EntityManager; +import jakarta.persistence.TypedQuery; import org.junit.jupiter.api.BeforeEach; 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 org.springframework.data.domain.Page; -import org.springframework.data.domain.PageImpl; -import org.springframework.data.domain.Pageable; +import org.springframework.test.util.ReflectionTestUtils; import java.util.*; -import java.util.stream.Collectors; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.any; -import static org.mockito.ArgumentMatchers.anyLong; import static org.mockito.ArgumentMatchers.anyString; -import static org.mockito.ArgumentMatchers.anyList; -import static org.mockito.ArgumentMatchers.argThat; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.eq; import static org.mockito.Mockito.*; @ExtendWith(MockitoExtension.class) @@ -43,10 +36,8 @@ class ApplicationServiceTest { @Mock private AuditService auditService; @Mock private ApplicationStatusHistoryRepository historyRepository; @Mock private com.mydreamjob.notification.NotificationService notificationService; - @Mock private PrivacySettingsService privacySettingsService; - @Mock private TalentMatchScorer talentMatchScorer; - @Mock private CandidateScoringCalculator scoringCalculator; - @Mock private CandidateDimensionScoreRepository dimensionScoreRepository; + @Mock private EntityManager em; + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; @InjectMocks private ApplicationService applicationService; private static final Long STUDENT_ID = 100L; @@ -58,13 +49,9 @@ class ApplicationServiceTest { @BeforeEach void setUp() { + ReflectionTestUtils.setField(applicationService, "em", em); publishedJob = com.mydreamjob.job.Job.builder().id(JOB_ID).companyId(COMPANY_ID).title("Java").status("PUBLISHED").build(); application = Application.builder().id(APP_ID).jobId(JOB_ID).studentUserId(STUDENT_ID).status("SUBMITTED").build(); - // 候选人列表现对所有排序都计算 matchScore：为无关用例提供默认桩，避免 Mockito 返回 null/遗漏 - lenient().when(dimensionScoreRepository.findUpToPeriod(anyList(), anyString())) - .thenReturn(Collections.emptyList()); - lenient().when(talentMatchScorer.match(any(), any(), any())) - .thenReturn(new TalentMatchScorer.MatchResult(88, List.of("x"))); } private void mockStudentRole() { @@ -180,34 +167,35 @@ class ApplicationServiceTest { // ── 企业候选人列表 ───────────────────────────────────────── @SuppressWarnings("unchecked") - private Page mockCandidatePage(Object[]... rows) { - return new PageImpl<>(List.of(rows)); + private TypedQuery mockCountQuery(long total) { + TypedQuery q = mock(TypedQuery.class); + when(q.getSingleResult()).thenReturn(total); + return q; + } + + @SuppressWarnings("unchecked") + private TypedQuery mockDataQuery(Object[]... rows) { + TypedQuery q = mock(TypedQuery.class); + when(q.getResultList()).thenReturn(List.of(rows)); + return q; } private Object[] buildRow(Long appId, Long jobId, String jobTitle, String status, String name, String school, String edu, Short gradYear, String avatarUrl) { - // 与 listCompanyCandidates 的实体元组查询 SELECT a, j, sp, u 对齐 - Application a = Application.builder().id(appId).jobId(jobId).status(status) - .createdAt(java.time.LocalDateTime.now()) - .updatedAt(java.time.LocalDateTime.now()).build(); - com.mydreamjob.job.Job j = com.mydreamjob.job.Job.builder() - .id(jobId).companyId(COMPANY_ID).title(jobTitle).build(); - StudentProfile sp = name == null ? null : StudentProfile.builder() - .userId(1L).realName(name).school(school).education(edu) - .graduationYear(gradYear).build(); - com.mydreamjob.auth.User u = mock(com.mydreamjob.auth.User.class); - when(u.getAvatarUrl()).thenReturn(avatarUrl); - return new Object[]{a, j, sp, u}; + return new Object[]{appId, jobId, jobTitle, status, name, school, edu, gradYear, avatarUrl, + java.time.LocalDateTime.now(), java.time.LocalDateTime.now()}; } @Test void listCompanyCandidates_shouldReturnPaginatedResults() { Object[] row = buildRow(200L, JOB_ID, "Java工程师", "SUBMITTED", "张三", "清华大学", "本科", (short)2026, "https://img/1.png"); - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(row)); + TypedQuery countQ = mockCountQuery(1L); + TypedQuery dataQ = mockDataQuery(row); + when(em.createQuery(anyString(), eq(Long.class))).thenReturn(countQ); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(dataQ); - PageResponse resp = applicationService.listCompanyCandidates( + CandidateListResponse resp = applicationService.listCompanyCandidates( COMPANY_ID, null, null, null, null, null, 0, 20); assertEquals(1, resp.getItems().size()); assertEquals("张三", resp.getItems().get(0).getCandidateName()); @@ -217,10 +205,12 @@ class ApplicationServiceTest { @Test void listCompanyCandidates_shouldFilterByJobId() { Object[] row = buildRow(200L, JOB_ID, "Java", "SUBMITTED", "张三", "清华", "本科", null, null); - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(row)); + TypedQuery countQ = mockCountQuery(1L); + TypedQuery dataQ = mockDataQuery(row); + when(em.createQuery(anyString(), eq(Long.class))).thenReturn(countQ); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(dataQ); - PageResponse resp = applicationService.listCompanyCandidates( + CandidateListResponse resp = applicationService.listCompanyCandidates( COMPANY_ID, JOB_ID, null, null, null, null, 0, 20); assertEquals(1, resp.getItems().size()); assertEquals(JOB_ID, resp.getItems().get(0).getJobId()); @@ -229,19 +219,23 @@ class ApplicationServiceTest { @Test void listCompanyCandidates_shouldFilterByStatus() { Object[] row = buildRow(200L, JOB_ID, "Java", "SUBMITTED", "张三", "清华", "本科", null, null); - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(row)); + TypedQuery countQ = mockCountQuery(1L); + TypedQuery dataQ = mockDataQuery(row); + when(em.createQuery(anyString(), eq(Long.class))).thenReturn(countQ); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(dataQ); - PageResponse resp = applicationService.listCompanyCandidates( + CandidateListResponse resp = applicationService.listCompanyCandidates( COMPANY_ID, null, "SUBMITTED", null, null, null, 0, 20); assertEquals("SUBMITTED", resp.getItems().get(0).getStatus()); } @Test void listCompanyCandidates_shouldReturnEmptyForNoResults() { - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage()); + TypedQuery countQ = mockCountQuery(0L); + TypedQuery dataQ = mockDataQuery(); + when(em.createQuery(anyString(), eq(Long.class))).thenReturn(countQ); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(dataQ); - PageResponse resp = applicationService.listCompanyCandidates( + CandidateListResponse resp = applicationService.listCompanyCandidates( COMPANY_ID, null, null, null, null, null, 0, 20); assertEquals(0, resp.getItems().size()); assertEquals(0, resp.getTotal()); @@ -286,57 +280,16 @@ class ApplicationServiceTest { @Test void listCompanyCandidates_shouldSortByUpdatedAt() { Object[] row = buildRow(200L, JOB_ID, "Java", "SUBMITTED", "张三", "清华", "本科", null, null); - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(row)); + TypedQuery countQ = mockCountQuery(1L); + TypedQuery dataQ = mockDataQuery(row); + when(em.createQuery(anyString(), eq(Long.class))).thenReturn(countQ); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(dataQ); - PageResponse resp = applicationService.listCompanyCandidates( + CandidateListResponse resp = applicationService.listCompanyCandidates( COMPANY_ID, null, null, null, "updatedAt", "asc", 0, 20); assertEquals(1, resp.getItems().size()); } - @Test void listCompanyCandidates_shouldComputeMatchPercentile() { - // 同一岗位 3 名候选人，matchScore 90/60/30 → 百分位 100/50/0（口径 countLower/(n-1)） - Object[] high = buildRow(200L, JOB_ID, "Java", "SUBMITTED", "张三", "清华", "本科", null, null); - Object[] mid = buildRow(201L, JOB_ID, "Java", "SUBMITTED", "李四", "北大", "硕士", null, null); - Object[] low = buildRow(202L, JOB_ID, "Java", "SUBMITTED", "王五", "复旦", "本科", null, null); - StudentProfile spHigh = (StudentProfile) high[2]; - StudentProfile spMid = (StudentProfile) mid[2]; - StudentProfile spLow = (StudentProfile) low[2]; - - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(high, mid, low)); - // percentile cohort = 该岗位全量候选人（同岗位 3 人） - when(applicationRepository.findCompanyCandidatesForMatch(anyLong(), any(), any(), any())) - .thenReturn(List.of(high, mid, low)); - when(talentMatchScorer.match(any(), argThat(sp -> sp == spHigh), any())) - .thenReturn(new TalentMatchScorer.MatchResult(90, List.of("x"))); - when(talentMatchScorer.match(any(), argThat(sp -> sp == spMid), any())) - .thenReturn(new TalentMatchScorer.MatchResult(60, List.of("x"))); - when(talentMatchScorer.match(any(), argThat(sp -> sp == spLow), any())) - .thenReturn(new TalentMatchScorer.MatchResult(30, List.of("x"))); - - PageResponse resp = applicationService.listCompanyCandidates( - COMPANY_ID, null, null, null, null, null, 0, 20); - Map pctByApp = resp.getItems().stream() - .collect(Collectors.toMap(CandidateItemView::getApplicationId, CandidateItemView::getMatchPercentile)); - assertEquals(Integer.valueOf(100), pctByApp.get(200L)); // 2/(3-1)*100 - assertEquals(Integer.valueOf(50), pctByApp.get(201L)); // 1/(3-1)*100 - assertEquals(Integer.valueOf(0), pctByApp.get(202L)); // 0/(3-1)*100 - } - - @Test void listCompanyCandidates_cohortLessThan2_shouldOmitPercentile() { - // 同岗位仅 1 名候选人 → 百分位不可计算 → null（配合 NON_NULL 省略） - Object[] row = buildRow(200L, JOB_ID, "Java", "SUBMITTED", "张三", "清华", "本科", null, null); - when(applicationRepository.findCompanyCandidates(anyLong(), any(), any(), any(), any(Pageable.class))) - .thenReturn(mockCandidatePage(row)); - when(applicationRepository.findCompanyCandidatesForMatch(anyLong(), any(), any(), any())) - .thenReturn(Collections.singletonList(row)); - - PageResponse resp = applicationService.listCompanyCandidates( - COMPANY_ID, null, null, null, null, null, 0, 20); - assertNull(resp.getItems().get(0).getMatchPercentile()); - } - // ── 企业候选人详情 ───────────────────────────────────────── @Test void getCompanyCandidateDetail_shouldReturnDetail() { @@ -350,13 +303,13 @@ class ApplicationServiceTest { .location("北京").graduationYear((short)2026).skillsJson("[\"Java\",\"Spring\"]").build(); com.mydreamjob.auth.User u = mock(com.mydreamjob.auth.User.class); when(u.getAvatarUrl()).thenReturn("https://img/1.png"); - when(u.getPhone()).thenReturn("13800000001"); - when(u.getEmail()).thenReturn("stu@example.com"); Object[] row = new Object[]{app, job, sp, u}; - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(row)); - when(privacySettingsService.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(true); - when(privacySettingsService.canViewContact(STUDENT_ID)).thenReturn(true); + @SuppressWarnings("unchecked") + TypedQuery detailQuery = mock(TypedQuery.class); + when(detailQuery.setParameter(anyString(), any())).thenReturn(detailQuery); + when(detailQuery.getResultList()).thenReturn(Collections.singletonList(row)); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(detailQuery); CandidateDetailView detail = applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID); assertEquals("张三", detail.getCandidateName()); @@ -364,45 +317,10 @@ class ApplicationServiceTest { assertEquals("北京", detail.getJobCity()); assertEquals(2, detail.getCandidateSkills().size()); assertEquals("https://img/1.png", detail.getCandidateAvatarUrl()); - assertEquals("清华", detail.getCandidateSchool()); - assertEquals("13800000001", detail.getCandidatePhone()); - assertEquals("stu@example.com", detail.getCandidateEmail()); - // 详情一致返回岗位匹配度与理由（企业内部分数，与列表面板同源） - assertEquals(Integer.valueOf(88), detail.getMatchScore()); - assertEquals(List.of("x"), detail.getMatchReasons()); // 成功详情查询不产生额外 Repository 查询（无 N+1） verify(applicationRepository, never()).findById(anyLong()); } - @Test void getCompanyCandidateDetail_shouldComputeMatchPercentile() { - // 目标候选人同岗位另有 1 人且 matchScore 更低 → 百分位 round(1/(2-1)*100)=100 - Application app = Application.builder().id(APP_ID).jobId(JOB_ID) - .studentUserId(STUDENT_ID).status("SUBMITTED").build(); - com.mydreamjob.job.Job job = com.mydreamjob.job.Job.builder() - .id(JOB_ID).companyId(COMPANY_ID).title("Java").build(); - StudentProfile mine = StudentProfile.builder().userId(STUDENT_ID).realName("张三").build(); - Object[] myRow = new Object[]{app, job, mine, null}; - com.mydreamjob.auth.User otherUser = mock(com.mydreamjob.auth.User.class); - StudentProfile other = StudentProfile.builder().userId(999L).realName("李四").build(); - Object[] otherRow = new Object[]{ - Application.builder().id(999L).jobId(JOB_ID).studentUserId(999L).status("SUBMITTED").build(), - job, other, otherUser}; - - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(myRow)); - when(privacySettingsService.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(false); - when(privacySettingsService.canViewContact(STUDENT_ID)).thenReturn(false); - // percentile cohort = 该岗位全量候选人（目标 + 同岗位另 1 人） - when(applicationRepository.findCompanyCandidatesForMatch(anyLong(), any(), any(), any())) - .thenReturn(List.of(myRow, otherRow)); - when(talentMatchScorer.match(any(), argThat(sp -> sp == mine), any())) - .thenReturn(new TalentMatchScorer.MatchResult(90, List.of("x"))); - when(talentMatchScorer.match(any(), argThat(sp -> sp == other), any())) - .thenReturn(new TalentMatchScorer.MatchResult(40, List.of("x"))); - - CandidateDetailView detail = applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID); - assertEquals(Integer.valueOf(100), detail.getMatchPercentile()); - } - @Test void getCompanyCandidateDetail_wrongCompany_shouldThrow() { // 投递存在，但岗位 companyId 与当前企业不匹配 → APPLICATION_OWNER_MISMATCH Application app = Application.builder().id(APP_ID).jobId(JOB_ID) @@ -410,7 +328,11 @@ class ApplicationServiceTest { com.mydreamjob.job.Job job = com.mydreamjob.job.Job.builder() .id(JOB_ID).companyId(COMPANY_ID).title("Java").build(); Object[] row = new Object[]{app, job, null, null}; - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(row)); + @SuppressWarnings("unchecked") + TypedQuery detailQuery = mock(TypedQuery.class); + when(detailQuery.setParameter(anyString(), any())).thenReturn(detailQuery); + when(detailQuery.getResultList()).thenReturn(Collections.singletonList(row)); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(detailQuery); var ex = assertThrows(BusinessException.class, () -> applicationService.getCompanyCandidateDetail(999L, APP_ID)); @@ -420,7 +342,11 @@ class ApplicationServiceTest { } @Test void getCompanyCandidateDetail_appNotFound_shouldThrow() { - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.emptyList()); + @SuppressWarnings("unchecked") + TypedQuery detailQuery = mock(TypedQuery.class); + when(detailQuery.setParameter(anyString(), any())).thenReturn(detailQuery); + when(detailQuery.getResultList()).thenReturn(Collections.emptyList()); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(detailQuery); var ex = assertThrows(BusinessException.class, () -> applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID)); @@ -436,7 +362,11 @@ class ApplicationServiceTest { .id(JOB_ID).companyId(COMPANY_ID).title("Java").build(); Object[] row = new Object[]{app, job, null, null}; - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(row)); + @SuppressWarnings("unchecked") + TypedQuery detailQuery = mock(TypedQuery.class); + when(detailQuery.setParameter(anyString(), any())).thenReturn(detailQuery); + when(detailQuery.getResultList()).thenReturn(Collections.singletonList(row)); + when(em.createQuery(anyString(), eq(Object[].class))).thenReturn(detailQuery); CandidateDetailView detail = applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID); assertNull(detail.getCandidateName()); @@ -444,62 +374,6 @@ class ApplicationServiceTest { assertNull(detail.getCoverLetter()); } - @Test void getCompanyCandidateDetail_resumeNotVisible_hidesResumeFieldsKeepsIdentity() { - // 学生 ResumeVisibility=PRIVATE（canCompanyViewResume=false）→ 隐藏简历要素，保留姓名/头像/coverLetter - Application app = Application.builder().id(APP_ID).jobId(JOB_ID) - .studentUserId(STUDENT_ID).status("SUBMITTED").coverLetter("cover").build(); - com.mydreamjob.job.Job job = com.mydreamjob.job.Job.builder() - .id(JOB_ID).companyId(COMPANY_ID).title("Java").build(); - StudentProfile sp = StudentProfile.builder().userId(STUDENT_ID) - .realName("张三").school("清华").education("本科").bio("bio") - .location("北京").graduationYear((short)2026).skillsJson("[\"Java\",\"Spring\"]").build(); - com.mydreamjob.auth.User u = mock(com.mydreamjob.auth.User.class); - when(u.getAvatarUrl()).thenReturn("https://img/1.png"); - - Object[] row = new Object[]{app, job, sp, u}; - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(row)); - when(privacySettingsService.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(false); - when(privacySettingsService.canViewContact(STUDENT_ID)).thenReturn(false); - - CandidateDetailView detail = applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID); - // 简历要素被隐藏 - assertNull(detail.getCandidateSchool()); - assertNull(detail.getCandidateEducation()); - assertNull(detail.getCandidateGraduationYear()); - assertTrue(detail.getCandidateSkills().isEmpty()); - assertNull(detail.getCandidateBio()); - assertNull(detail.getCandidateLocation()); - // 联系方式不返回 - assertNull(detail.getCandidatePhone()); - assertNull(detail.getCandidateEmail()); - // 身份识别与投递信息保留 - assertEquals("张三", detail.getCandidateName()); - assertEquals("https://img/1.png", detail.getCandidateAvatarUrl()); - assertEquals("cover", detail.getCoverLetter()); - } - - @Test void getCompanyCandidateDetail_contactNotVisible_phoneEmailNull() { - // 简历可见但 contactVisible=false → 联系方式仍省略 - Application app = Application.builder().id(APP_ID).jobId(JOB_ID) - .studentUserId(STUDENT_ID).status("SUBMITTED").build(); - com.mydreamjob.job.Job job = com.mydreamjob.job.Job.builder() - .id(JOB_ID).companyId(COMPANY_ID).title("Java").build(); - StudentProfile sp = StudentProfile.builder().userId(STUDENT_ID) - .realName("张三").school("清华").build(); - com.mydreamjob.auth.User u = mock(com.mydreamjob.auth.User.class); - when(u.getAvatarUrl()).thenReturn("https://img/1.png"); - - Object[] row = new Object[]{app, job, sp, u}; - when(applicationRepository.findCandidateDetailById(APP_ID)).thenReturn(Collections.singletonList(row)); - when(privacySettingsService.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(true); - when(privacySettingsService.canViewContact(STUDENT_ID)).thenReturn(false); - - CandidateDetailView detail = applicationService.getCompanyCandidateDetail(COMPANY_ID, APP_ID); - assertEquals("清华", detail.getCandidateSchool()); // 简历仍可见 - assertNull(detail.getCandidatePhone()); // 联系方式隐藏 - assertNull(detail.getCandidateEmail()); - } - // ── getTimeline 已知行为回归 ──────────────────────────────── @Test void getTimeline_companyUser_knownBehavior() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeAccessPolicyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeAccessPolicyTest.java new file mode 100644 index 0000000..6fdf1dc --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeAccessPolicyTest.java @@ -0,0 +1,320 @@ +package com.mydreamjob.application; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.privacy.ResumeVisibility; +import com.mydreamjob.privacy.StudentPrivacySettings; +import com.mydreamjob.privacy.StudentPrivacySettingsRepository; +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 org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; + +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.when; + +/** + * S03-B 企业简历授权决策矩阵（设计 §4.3）。 + * + *

    真实策略 + Mock Repository；覆盖三种可见性 × 全部投递状态 × 公司归属 × 跨企业 × 未认证， + * 以及下载入口的拒绝语义与错误码。

    + */ +@ExtendWith(MockitoExtension.class) +// 决策矩阵用例会一次性准备好「企业 + 岗位 + 投递 + 隐私」的完整上下文， +// 而拒绝分支会提前返回、不消费全部 stub —— 这是刻意覆盖矩阵的必然结果， +// 因此关闭「未使用 stub」的严格校验，断言本身仍逐条生效。 +@MockitoSettings(strictness = Strictness.LENIENT) +class CompanyResumeAccessPolicyTest { + + private static final Long STUDENT_ID = 100L; + private static final Long COMPANY_ID = 200L; + private static final Long OTHER_COMPANY_ID = 201L; + private static final Long COMPANY_USER_ID = 300L; + private static final Long APP_ID = 400L; + private static final Long JOB_ID = 500L; + + private static final List ALL_STATUSES = List.of( + "SUBMITTED", "VIEWED", "INTERVIEW", "HIRED", "REJECTED", "WITHDRAWN"); + private static final List EFFECTIVE = List.of("SUBMITTED", "VIEWED", "INTERVIEW", "HIRED"); + private static final List INEFFECTIVE = List.of("REJECTED", "WITHDRAWN"); + + @Mock private CompanyRepository companyRepository; + @Mock private ApplicationRepository applicationRepository; + @Mock private JobRepository jobRepository; + @Mock private StudentPrivacySettingsRepository privacyRepository; + + @InjectMocks private CompanyResumeAccessPolicy policy; + + // ── 工具 ──────────────────────────────────────────────────── + + private void givenApplication(String status) { + when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of( + Application.builder().id(APP_ID).jobId(JOB_ID).studentUserId(STUDENT_ID).status(status).build())); + } + + private void givenJobOwnedBy(Long companyId) { + when(jobRepository.findById(JOB_ID)).thenReturn(Optional.of( + Job.builder().id(JOB_ID).companyId(companyId).build())); + } + + private void givenVisibility(ResumeVisibility visibility) { + when(privacyRepository.findByStudentUserId(STUDENT_ID)).thenReturn(Optional.of( + StudentPrivacySettings.builder().studentUserId(STUDENT_ID) + .resumeVisibility(visibility).contactVisible(false).version(0L).build())); + } + + private void givenCompany(Long companyId, boolean verified) { + when(companyRepository.findById(companyId)).thenReturn(Optional.of( + Company.builder().id(companyId).verified(verified).build())); + } + + // ── 参数与记录缺失：一律拒绝 ──────────────────────────────── + + @Test + void nullArgumentsAreRejected() { + assertFalse(policy.isVisible(null, COMPANY_ID, APP_ID)); + assertFalse(policy.isVisible(STUDENT_ID, null, APP_ID)); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, null)); + } + + @Test + void missingApplicationIsRejected() { + when(applicationRepository.findById(APP_ID)).thenReturn(Optional.empty()); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + @Test + void studentMismatchIsRejected() { + when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of( + Application.builder().id(APP_ID).jobId(JOB_ID).studentUserId(999L).status("SUBMITTED").build())); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + @Test + void missingJobIsRejected() { + givenApplication("SUBMITTED"); + when(jobRepository.findById(JOB_ID)).thenReturn(Optional.empty()); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + // ── PRIVATE / 无记录 ─────────────────────────────────────── + + @Test + void privateIsRejectedForEveryStatusEvenWhenCompanyVerified() { + for (String status : ALL_STATUSES) { + givenApplication(status); + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.PRIVATE); + givenCompany(COMPANY_ID, true); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), "PRIVATE 必须拒绝：" + status); + } + } + + @Test + void noSettingsRecordIsTreatedAsPrivate() { + for (String status : ALL_STATUSES) { + givenApplication(status); + givenJobOwnedBy(COMPANY_ID); + when(privacyRepository.findByStudentUserId(STUDENT_ID)).thenReturn(Optional.empty()); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), "无记录必须按 PRIVATE 拒绝：" + status); + } + } + + @Test + void nullVisibilityIsTreatedAsPrivate() { + givenApplication("SUBMITTED"); + givenJobOwnedBy(COMPANY_ID); + when(privacyRepository.findByStudentUserId(STUDENT_ID)).thenReturn(Optional.of( + StudentPrivacySettings.builder().studentUserId(STUDENT_ID) + .resumeVisibility(null).contactVisible(false).version(0L).build())); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + // ── APPLIED_COMPANIES ────────────────────────────────────── + + @Test + void appliedCompaniesAllowsOnlyEffectiveStatusesWhenCompanyOwnsJob() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String status : ALL_STATUSES) { + givenApplication(status); + boolean expected = EFFECTIVE.contains(status); + assertEquals(expected, policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "APPLIED_COMPANIES 状态 " + status + " 判定不符"); + } + } + + // ── APPLIED_COMPANIES 必须是白名单（失败关闭）────────────── + + @Test + void appliedCompaniesAllowsExactlyFourReviewedStatuses() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + + for (String status : ALL_STATUSES) { + givenApplication(status); + boolean expected = EFFECTIVE.contains(status); + assertEquals(expected, policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "只有四个已审阅状态可放行：" + status); + } + } + + @Test + void appliedCompaniesRejectsNullStatus() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + givenApplication(null); + + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), "null 状态必须拒绝"); + } + + @Test + void appliedCompaniesRejectsBlankStatus() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String blank : new String[]{"", " ", " ", "\t"}) { + givenApplication(blank); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), "空白状态必须拒绝：'" + blank + "'"); + } + } + + @Test + void appliedCompaniesRejectsUnknownStatus() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String unknown : new String[]{"PENDING", "DRAFT", "ARCHIVED", "DELETED", "REVIEWING"}) { + givenApplication(unknown); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), "未知状态必须拒绝：" + unknown); + } + } + + @Test + void appliedCompaniesRejectsLowercaseStatus() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String lower : new String[]{"submitted", "viewed", "interview", "hired"}) { + givenApplication(lower); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "大小写变体必须拒绝（不得宽松匹配）：" + lower); + } + } + + @Test + void appliedCompaniesRejectsOtherCompanyEvenWithEffectiveApplication() { + givenJobOwnedBy(OTHER_COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String status : EFFECTIVE) { + givenApplication(status); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "跨企业必须拒绝（投递属于其他公司的岗位）：" + status); + } + } + + // ── VERIFIED_COMPANIES ───────────────────────────────────── + + @Test + void verifiedCompaniesAllowsAnyStatusWhenVerifiedAndOwnsJob() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.VERIFIED_COMPANIES); + givenCompany(COMPANY_ID, true); + for (String status : ALL_STATUSES) { + givenApplication(status); + assertTrue(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "VERIFIED_COMPANIES 已认证且拥有岗位时状态不额外限制：" + status); + } + } + + @Test + void verifiedCompaniesRejectsUnverifiedCompany() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.VERIFIED_COMPANIES); + givenCompany(COMPANY_ID, false); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + @Test + void verifiedCompaniesRejectsUnknownCompany() { + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.VERIFIED_COMPANIES); + when(companyRepository.findById(COMPANY_ID)).thenReturn(Optional.empty()); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)); + } + + @Test + void verifiedCompaniesRejectsWhenCompanyDoesNotOwnJob() { + givenJobOwnedBy(OTHER_COMPANY_ID); + givenVisibility(ResumeVisibility.VERIFIED_COMPANIES); + givenCompany(COMPANY_ID, true); + for (String status : ALL_STATUSES) { + givenApplication(status); + assertFalse(policy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID), + "已验证企业也必须拥有该投递岗位：" + status); + } + } + + // ── 下载入口的拒绝语义 ──────────────────────────────────── + + @Test + void authorizeForDownloadRejectsUserWithoutCompany() { + when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)).thenReturn(Optional.empty()); + BusinessException ex = assertThrows(BusinessException.class, + () -> policy.authorizeForDownload(COMPANY_USER_ID, APP_ID)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void authorizeForDownloadReturnsNotFoundForMissingApplication() { + when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)).thenReturn(Optional.of( + Company.builder().id(COMPANY_ID).verified(true).build())); + when(applicationRepository.findById(APP_ID)).thenReturn(Optional.empty()); + + BusinessException ex = assertThrows(BusinessException.class, + () -> policy.authorizeForDownload(COMPANY_USER_ID, APP_ID)); + assertEquals(ErrorCode.APPLICATION_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void authorizeForDownloadRejectsCrossCompanyWithForbidden() { + when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)).thenReturn(Optional.of( + Company.builder().id(COMPANY_ID).verified(true).build())); + givenApplication("SUBMITTED"); + givenJobOwnedBy(OTHER_COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + + BusinessException ex = assertThrows(BusinessException.class, + () -> policy.authorizeForDownload(COMPANY_USER_ID, APP_ID)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void authorizeForDownloadReturnsStudentIdWhenAllowed() { + when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)).thenReturn(Optional.of( + Company.builder().id(COMPANY_ID).verified(false).build())); + givenApplication("SUBMITTED"); + givenJobOwnedBy(COMPANY_ID); + givenVisibility(ResumeVisibility.APPLIED_COMPANIES); + + assertEquals(STUDENT_ID, policy.authorizeForDownload(COMPANY_USER_ID, APP_ID).studentUserId()); + } + + @Test + void authorizeForDownloadRejectsNullArguments() { + assertEquals(ErrorCode.FORBIDDEN.getCode(), + assertThrows(BusinessException.class, + () -> policy.authorizeForDownload(null, APP_ID)).getErrorCodeInt()); + assertEquals(ErrorCode.FORBIDDEN.getCode(), + assertThrows(BusinessException.class, + () -> policy.authorizeForDownload(COMPANY_USER_ID, null)).getErrorCodeInt()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeDownloadIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeDownloadIntegrationTest.java new file mode 100644 index 0000000..aa70296 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/application/CompanyResumeDownloadIntegrationTest.java @@ -0,0 +1,606 @@ +package com.mydreamjob.application; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.support.TestAuthTokens; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.job.JobStatus; +import com.mydreamjob.privacy.ResumeVisibility; +import com.mydreamjob.privacy.StudentPrivacySettings; +import com.mydreamjob.privacy.StudentPrivacySettingsRepository; +import com.mydreamjob.profile.StudentProfile; +import com.mydreamjob.profile.StudentProfileRepository; +import com.mydreamjob.profile.storage.ResumeStorageService; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.mock.web.MockMultipartFile; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.web.servlet.MockMvc; + +import java.nio.charset.StandardCharsets; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +/** + * S03-B 企业简历下载权限矩阵（设计 §4.3），真实 SecurityFilterChain + 真实 H2 + 真实本地存储。 + * + *

    只用一个计数包装器包住存储实现，用于证明**拒绝路径零文件读取**； + * 授权链本身完全真实，未被 Mock。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +@TestPropertySource(properties = "app.resume.storage-dir=target/s03-test-resumes") +class CompanyResumeDownloadIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(8800); + private static final List ALL_STATUSES = + List.of("SUBMITTED", "VIEWED", "INTERVIEW", "HIRED", "REJECTED", "WITHDRAWN"); + private static final List EFFECTIVE = List.of("SUBMITTED", "VIEWED", "INTERVIEW", "HIRED"); + + /** 统计 read() 调用次数，用于断言拒绝路径不触碰文件。 */ + static final AtomicInteger READ_CALLS = new AtomicInteger(); + + @TestConfiguration + static class CountingStorageConfig { + @Bean + @Primary + ResumeStorageService countingResumeStorageService( + com.mydreamjob.profile.storage.LocalResumeStorageService delegate) { + return new ResumeStorageService() { + @Override + public String store(Long userId, org.springframework.web.multipart.MultipartFile file) { + return delegate.store(userId, file); + } + + @Override + public byte[] read(String storagePath) { + READ_CALLS.incrementAndGet(); + return delegate.read(storagePath); + } + + @Override + public void delete(String storagePath) { + delegate.delete(storagePath); + } + }; + } + } + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private MockMvc mockMvc; + @Autowired private UserRepository userRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private JobRepository jobRepository; + @Autowired private ApplicationRepository applicationRepository; + @Autowired private StudentProfileRepository profileRepository; + @Autowired private StudentPrivacySettingsRepository privacyRepository; + @Autowired private ResumeStorageService resumeStorageService; + @Autowired private org.springframework.jdbc.core.JdbcTemplate jdbcTemplate; + + private Long companyUserId; + private Long otherCompanyUserId; + private Long companyId; + private Long otherCompanyId; + private Long studentUserId; + private Long adminUserId; + private Long jobId; + private Long applicationId; + private String storagePath; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + READ_CALLS.set(0); + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + companyUserId = createUser(User.Role.COMPANY, "S03 企业"); + otherCompanyUserId = createUser(User.Role.COMPANY, "S03 他企"); + studentUserId = createUser(User.Role.STUDENT, "S03 学生"); + adminUserId = createUser(User.Role.ADMIN, "S03 管理员"); + + companyId = companyRepository.save(Company.builder() + .ownerUserId(companyUserId).name("S03 甲企业").verified(false).build()).getId(); + otherCompanyId = companyRepository.save(Company.builder() + .ownerUserId(otherCompanyUserId).name("S03 乙企业").verified(true).build()).getId(); + + jobId = jobRepository.save(Job.builder() + .companyId(companyId).title("S03 岗位").description("d").city("杭州") + .employmentType("FULL_TIME").status(JobStatus.PUBLISHED.name()).build()).getId(); + + applicationId = applicationRepository.save(Application.builder() + .jobId(jobId).studentUserId(studentUserId).status("SUBMITTED").build()).getId(); + + // 真实写入一个 PDF 文件并挂到学生档案 + MockMultipartFile file = new MockMultipartFile("file", "resume.pdf", "application/pdf", + "%PDF-1.4 s03 content".getBytes(StandardCharsets.UTF_8)); + storagePath = resumeStorageService.store(studentUserId, file); + profileRepository.save(StudentProfile.builder() + .userId(studentUserId) + .resumeUrl(storagePath) + .resumeOriginalName("我的简历.pdf") + .resumeContentType("application/pdf") + .resumeSize(file.getSize()) + .build()); + } + + @AfterEach + void tearDown() { + if (storagePath != null) { + resumeStorageService.delete(storagePath); + } + profileRepository.findByUserId(studentUserId).ifPresent(profileRepository::delete); + privacyRepository.findByStudentUserId(studentUserId).ifPresent(privacyRepository::delete); + if (applicationId != null) applicationRepository.deleteById(applicationId); + if (jobId != null) jobRepository.deleteById(jobId); + if (companyId != null) companyRepository.deleteById(companyId); + if (otherCompanyId != null) companyRepository.deleteById(otherCompanyId); + List.of(companyUserId, otherCompanyUserId, studentUserId, adminUserId) + .forEach(id -> { if (id != null) userRepository.deleteById(id); }); + } + + private Long createUser(User.Role role, String nickname) { + return userRepository.save(User.builder() + .phone("17" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname(nickname) + .role(role) + .roles(Set.of(role)) + .active(true) + .verified(true) + .build()).getId(); + } + + private void setVisibility(ResumeVisibility visibility) { + privacyRepository.findByStudentUserId(studentUserId) + .ifPresent(privacyRepository::delete); + if (visibility != null) { + privacyRepository.saveAndFlush(StudentPrivacySettings.builder() + .studentUserId(studentUserId).resumeVisibility(visibility) + .contactVisible(false).version(0L).build()); + } + } + + private void setStatus(String status) { + Application app = applicationRepository.findById(applicationId).orElseThrow(); + app.setStatus(status); + applicationRepository.saveAndFlush(app); + } + + private String url() { + return "/company/candidates/" + applicationId + "/resume"; + } + + private String companyToken() { + return TestAuthTokens.bearer(companyUserId, "COMPANY"); + } + + // ── 决策矩阵：3 种可见性 × 6 种状态 ───────────────────────── + + @Test + void privateIsDeniedForEveryStatusAndNeverReadsFile() { + setVisibility(ResumeVisibility.PRIVATE); + for (String status : ALL_STATUSES) { + setStatus(status); + READ_CALLS.set(0); + int code = perform(companyToken()); + assertThat(code).as("PRIVATE 必须 403：" + status).isEqualTo(403); + assertThat(READ_CALLS.get()).as("拒绝路径不得读取文件：" + status).isZero(); + } + } + + @Test + void missingSettingsIsDeniedAsPrivate() { + setVisibility(null); + for (String status : ALL_STATUSES) { + setStatus(status); + READ_CALLS.set(0); + assertThat(perform(companyToken())).as("无设置按 PRIVATE 拒绝：" + status).isEqualTo(403); + assertThat(READ_CALLS.get()).isZero(); + } + } + + @Test + void appliedCompaniesAllowsOnlyEffectiveStatusesForOwningCompany() throws Exception { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + for (String status : ALL_STATUSES) { + setStatus(status); + READ_CALLS.set(0); + if (EFFECTIVE.contains(status)) { + mockMvc.perform(get(url()).header("Authorization", companyToken())) + .andExpect(status().isOk()) + .andExpect(header().string("Cache-Control", "no-store")) + .andExpect(content().contentType("application/pdf")); + assertThat(READ_CALLS.get()).as("授权通过应读取一次：" + status).isEqualTo(1); + } else { + assertThat(perform(companyToken())).as("WITHDRAWN/REJECTED 应 403：" + status).isEqualTo(403); + assertThat(READ_CALLS.get()).as("拒绝路径不得读取文件：" + status).isZero(); + } + } + } + + @Test + void verifiedCompaniesAllowsAnyStatusOnlyForVerifiedOwningCompany() { + // 甲企业未认证 → 全部拒绝 + setVisibility(ResumeVisibility.VERIFIED_COMPANIES); + for (String status : ALL_STATUSES) { + setStatus(status); + READ_CALLS.set(0); + assertThat(perform(companyToken())).as("未认证企业应 403：" + status).isEqualTo(403); + assertThat(READ_CALLS.get()).isZero(); + } + + // 认证后 → 全部状态允许 + Company company = companyRepository.findById(companyId).orElseThrow(); + company.setVerified(true); + companyRepository.saveAndFlush(company); + for (String status : ALL_STATUSES) { + setStatus(status); + READ_CALLS.set(0); + assertThat(perform(companyToken())).as("已认证且拥有岗位应 200：" + status).isEqualTo(200); + assertThat(READ_CALLS.get()).isEqualTo(1); + } + } + + // ── APPLIED_COMPANIES 白名单：退化状态必须 403 且零读取 ────── + + @Test + void appliedCompaniesUnknownStatusReturns403WithoutReadingStorage() throws Exception { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + + for (String unknown : new String[]{"PENDING", "DRAFT", "ARCHIVED", "submitted"}) { + setStatus(unknown); + READ_CALLS.set(0); + + var result = mockMvc.perform(get(url()).header("Authorization", companyToken())) + .andReturn().getResponse(); + assertThat(result.getStatus()).as("未知/变体状态必须 403：" + unknown).isEqualTo(403); + assertThat(result.getContentAsString()).as("业务码必须 2002：" + unknown).contains("\"code\":2002"); + assertThat(READ_CALLS.get()).as("拒绝路径不得读取文件：" + unknown).isZero(); + } + } + + @Test + void appliedCompaniesBlankStatusReturns403WithoutReadingStorage() throws Exception { + // 说明：applications.status 在 V2 中是 NOT NULL，因此 DB 层无法保存 NULL； + // NULL 情形由 CompanyResumeAccessPolicyTest 在内存中覆盖，这里用可达的空白值验证。 + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + + for (String blank : new String[]{"", " "}) { + setStatus(blank); + READ_CALLS.set(0); + + var result = mockMvc.perform(get(url()).header("Authorization", companyToken())) + .andReturn().getResponse(); + assertThat(result.getStatus()).as("空白状态必须 403").isEqualTo(403); + assertThat(result.getContentAsString()).as("业务码必须 2002").contains("\"code\":2002"); + assertThat(READ_CALLS.get()).as("拒绝路径不得读取文件").isZero(); + } + } + + // ── 跨企业 ───────────────────────────────────────────────── + + @Test + void otherCompanyIsAlwaysDenied() { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + READ_CALLS.set(0); + assertThat(perform(TestAuthTokens.bearer(otherCompanyUserId, "COMPANY"))) + .as("跨企业必须 403").isEqualTo(403); + assertThat(READ_CALLS.get()).isZero(); + + setVisibility(ResumeVisibility.VERIFIED_COMPANIES); + READ_CALLS.set(0); + assertThat(perform(TestAuthTokens.bearer(otherCompanyUserId, "COMPANY"))) + .as("其他企业即使已认证也必须 403").isEqualTo(403); + assertThat(READ_CALLS.get()).isZero(); + } + + // ── 角色与非认证 ─────────────────────────────────────────── + + @Test + void studentAdminAndAnonymousAreDenied() { + READ_CALLS.set(0); + setVisibility(ResumeVisibility.VERIFIED_COMPANIES); + Company company = companyRepository.findById(companyId).orElseThrow(); + company.setVerified(true); + companyRepository.saveAndFlush(company); + + assertThat(perform(TestAuthTokens.bearer(studentUserId, "STUDENT"))).as("STUDENT 应 403").isEqualTo(403); + assertThat(perform(TestAuthTokens.bearer(adminUserId, "ADMIN"))).as("ADMIN 应 403").isEqualTo(403); + assertThat(performNoAuth()).as("匿名应 401").isEqualTo(401); + assertThat(READ_CALLS.get()).as("拒绝路径不得读取文件").isZero(); + } + + @Test + void nonexistentApplicationIsNotFound() { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + READ_CALLS.set(0); + String token = companyToken(); + int code; + try { + code = mockMvc.perform(get("/company/candidates/99999999/resume").header("Authorization", token)) + .andReturn().getResponse().getStatus(); + } catch (Exception e) { + code = -1; + } + assertThat(code).as("不存在的投递应 404").isEqualTo(404); + assertThat(READ_CALLS.get()).isZero(); + } + + @Test + void missingResumeIsProfileNotFound() { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + StudentProfile profile = profileRepository.findByUserId(studentUserId).orElseThrow(); + profile.setResumeUrl(null); + profileRepository.saveAndFlush(profile); + + assertThat(perform(companyToken())).as("授权通过但无简历应 404").isEqualTo(404); + } + + // ── 响应脱敏 ─────────────────────────────────────────────── + + @Test + void responseDoesNotLeakPathOrIdentity() throws Exception { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + + String body = mockMvc.perform(get(url()).header("Authorization", companyToken())) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + + assertThat(body).as("不得回显存储路径").doesNotContain(storagePath); + assertThat(body).doesNotContain("resumeUrl"); + assertThat(body).doesNotContain(String.valueOf(studentUserId)); + assertThat(body).doesNotContain("studentUserId"); + } + + @Test + void contentDispositionUsesSanitizedOriginalName() throws Exception { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + + mockMvc.perform(get(url()).header("Authorization", companyToken())) + .andExpect(status().isOk()) + .andExpect(header().string("Content-Disposition", + org.hamcrest.Matchers.containsString("attachment"))) + .andExpect(header().string("Content-Disposition", + org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("../")))) + .andExpect(header().string("Cache-Control", "no-store")); + } + + // ── 企业候选人列表/详情仍不含 resumeUrl ───────────────────── + + @Test + void companyCandidateEndpointsStillExcludeResumeUrl() throws Exception { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + String token = companyToken(); + + String detail = mockMvc.perform(get("/company/candidates/" + applicationId) + .header("Authorization", token)) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + assertThat(detail).doesNotContain("resumeUrl"); + + String list = mockMvc.perform(get("/company/candidates").header("Authorization", token)) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + assertThat(list).doesNotContain("resumeUrl"); + } + + // ── 运行时 OpenAPI 契约（S03 只新增一个企业下载 operation）── + + @Test + void openApiContractForCompanyResumeDownload() throws Exception { + String json = mockMvc.perform(get("/v3/api-docs")) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + + var root = new com.fasterxml.jackson.databind.ObjectMapper().readTree(json); + var paths = root.path("paths"); + var schemas = root.path("components").path("schemas"); + + long pathCount = paths.size(); + long opCount = 0; + var it = paths.fieldNames(); + while (it.hasNext()) { + var ops = paths.path(it.next()); + var f = ops.fieldNames(); + while (f.hasNext()) { + if (java.util.Set.of("get", "post", "put", "delete", "patch") + .contains(f.next())) { + opCount++; + } + } + } + assertThat(pathCount).as("密码登录与企业注册/入驻新增路径后应为 182 paths").isEqualTo(182); + assertThat(opCount).as("密码登录与企业注册/入驻新增 operation 后应为 220 operations").isEqualTo(220); + + var download = paths.path("/company/candidates/{applicationId}/resume").path("get"); + assertThat(download.isMissingNode()).as("必须存在企业简历下载 GET").isFalse(); + assertThat(download.has("requestBody")).as("下载接口不得有 requestBody").isFalse(); + + // 不得存在按 studentUserId / candidateKey 下载简历的入口 + var names = new java.util.ArrayList(); + paths.fieldNames().forEachRemaining(names::add); + for (String p : names) { + String lower = p.toLowerCase(); + if (lower.contains("resume") || lower.contains("download")) { + assertThat(lower).as("不得按 studentUserId 下载：" + p).doesNotContain("studentuserid"); + assertThat(lower).as("不得按 candidateKey 下载：" + p).doesNotContain("candidatekey"); + } + } + + // 企业候选人 DTO 不得含 resumeUrl / studentUserId / phone / email / storagePath + for (String dto : new String[]{"CandidateDetailView", "CandidateItemView"}) { + var node = schemas.path(dto); + if (node.isMissingNode()) { + continue; + } + String text = node.toString(); + for (String forbidden : new String[]{"resumeUrl", "studentUserId", "phone", "email", "storagePath"}) { + assertThat(text).as(dto + " 不得包含 " + forbidden).doesNotContain(forbidden); + } + } + + // Actuator 不得进入业务 OpenAPI + for (String p : names) { + assertThat(p).as("Actuator 不得出现在业务契约").doesNotStartWith("/actuator"); + } + + // 开发辅助：-Ds03.openapi.snapshot=<目录> 时导出快照 + String snapshotDir = System.getProperty("s03.openapi.snapshot"); + if (snapshotDir != null && !snapshotDir.isBlank()) { + java.nio.file.Files.write( + java.nio.file.Paths.get(snapshotDir, "openapi-rc.json"), + json.getBytes(StandardCharsets.UTF_8)); + } + } + + // ── 副作用：企业下载只读 ─────────────────────────────────── + + /** + * 表名**固定白名单**（不做任意外部表名拼接）+ 每张表明确选择的稳定业务字段。 + * 字段名以真实表结构为准。 + */ + private static java.util.Map digestColumns() { + java.util.Map m = new java.util.LinkedHashMap<>(); + m.put("users", "id, phone, email, role, is_active, is_verified, updated_at"); + m.put("user_roles", "user_id, role"); + m.put("student_profiles", + "id, user_id, resume_url, resume_original_name, resume_content_type, resume_size, updated_at"); + m.put("resume_versions", + "id, user_id, version_no, status, file_storage_path, file_name, content_type, file_size, updated_at"); + m.put("applications", "id, job_id, student_user_id, status, updated_at"); + m.put("jobs", "id, company_id, status, updated_at"); + m.put("companies", "id, owner_user_id, verified, name, updated_at"); + m.put("auth_tokens", "id, user_id, session_id, revoked, consumed_at, revoked_at, version, created_at"); + m.put("audit_logs", "id, user_id, action, entity_type, entity_id, details, created_at"); + m.put("candidate_dimension_scores", + "id, student_user_id, dimension, period, score, status, weight, rules_version, calculated_at, version"); + m.put("notifications", "id, user_id, type, title, is_read, read_at, created_at"); + m.put("messages", "id, conversation_id, sender_user_id, content, status, recalled_at, version, created_at"); + m.put("scoring_risk_events", + "id, rule_config_id, subject_user_id, source_action, severity, occurrence_count, status, detected_at, version"); + m.put("scoring_risk_actions", "id, risk_event_id, operator_user_id, action, reason_code, created_at"); + m.put("talent_invitations", + "id, company_id, job_id, student_user_id, status, expires_at, decided_at, version, created_at"); + return m; + } + + /** + * 行级快照：按选定字段排序后取全部行，做深比较。 + * + *

    不使用 COUNT / SUM(id) / CRC32(id) 这类弱摘要；查询异常直接抛出使测试失败， + * 不允许被吞掉后写入占位值。

    + */ + private java.util.Map>> snapshot() { + java.util.Map>> out = new java.util.LinkedHashMap<>(); + for (java.util.Map.Entry e : digestColumns().entrySet()) { + String columns = e.getValue(); + String sql = "SELECT " + columns + " FROM " + e.getKey() + " ORDER BY " + columns; + out.put(e.getKey(), jdbcTemplate.queryForList(sql)); + } + return out; + } + + @Test + void companyDownloadHasNoSideEffectsOnBusinessTables() { + setVisibility(ResumeVisibility.APPLIED_COMPANIES); + + // 先取 token：测试夹具在签发时会写入 auth_tokens/users，必须发生在基线快照之前， + // 否则夹具自身的记录会被误判为「下载接口的副作用」。 + String token = companyToken(); + + var before = snapshot(); + + assertThat(perform(token)).as("授权通过应 200").isEqualTo(200); + + var after = snapshot(); + for (String table : before.keySet()) { + assertThat(after.get(table)) + .as(table + " 不得因企业下载而变化（逐行内容比较）") + .isEqualTo(before.get(table)); + } + } + + /** + * 反证：摘要必须能发现单行变化，否则前面的「零变化」断言没有说服力。 + */ + @Test + void snapshotDetectsSingleRowChange() { + var before = snapshot(); + + Application app = applicationRepository.findById(applicationId).orElseThrow(); + String original = app.getStatus(); + app.setStatus(original.equals("INTERVIEW") ? "HIRED" : "INTERVIEW"); + applicationRepository.saveAndFlush(app); + + try { + var after = snapshot(); + assertThat(after.get("applications")) + .as("单行 status 变化必须被摘要发现").isNotEqualTo(before.get("applications")); + } finally { + Application restore = applicationRepository.findById(applicationId).orElseThrow(); + restore.setStatus(original); + applicationRepository.saveAndFlush(restore); + } + } + + @Test + void snapshotCoversEveryRequiredTableAndColumn() { + var snap = snapshot(); + for (String table : new String[]{ + "users", "user_roles", "student_profiles", "resume_versions", "applications", + "jobs", "companies", "auth_tokens", "audit_logs", "candidate_dimension_scores", + "notifications", "messages", "scoring_risk_events", "scoring_risk_actions", + "talent_invitations"}) { + assertThat(snap).as("必须覆盖 " + table).containsKey(table); + } + // 抽查关键字段确实被取到（而非空 Map） + assertThat(snap.get("applications").get(0)).containsKeys("status", "updated_at"); + assertThat(snap.get("auth_tokens").get(0)).containsKeys("revoked", "version"); + } + + // ── 工具 ─────────────────────────────────────────────────── + + private int perform(String token) { + try { + return mockMvc.perform(get(url()).header("Authorization", token)) + .andReturn().getResponse().getStatus(); + } catch (Exception e) { + return -1; + } + } + + private int performNoAuth() { + try { + return mockMvc.perform(get(url())).andReturn().getResponse().getStatus(); + } catch (Exception e) { + return -1; + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentAttemptServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentAttemptServiceTest.java new file mode 100644 index 0000000..f9b15c7 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentAttemptServiceTest.java @@ -0,0 +1,296 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.assessment.dto.AssessmentResultResponse; +import com.mydreamjob.assessment.dto.CreateAssessmentAttemptRequest; +import com.mydreamjob.assessment.dto.SaveAssessmentAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +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 org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; +import org.springframework.dao.OptimisticLockingFailureException; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +/** + * 答卷服务单测（V34/V35）。 + * + *

    覆盖身份校验、活跃答卷重复 9708、幂等冲突 9709、答案不属于本答卷 9705、 + * 版本并发 9707、29 题提交失败 9706、重复提交幂等返回原结果。

    + */ +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class AssessmentAttemptServiceTest { + + private static final Long STUDENT = 100L; + private static final Long COMPANY = 200L; + private static final Long ATTEMPT_ID = 1L; + + @Mock private AssessmentDefinitionRepository definitionRepository; + @Mock private AssessmentQuestionRepository questionRepository; + @Mock private AssessmentAttemptRepository attemptRepository; + @Mock private AssessmentAttemptQuestionRepository attemptQuestionRepository; + @Mock private AssessmentAnswerRepository answerRepository; + @Mock private AssessmentResultRepository resultRepository; + @Mock private AssessmentResultService resultService; + @Mock private AssessmentResultComputer resultComputer; + @Mock private UserRepository userRepository; + @Mock private AuditService auditService; + + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; + @InjectMocks private AssessmentAttemptService service; + + private final AuditContext ctx = AuditContext.builder().requestId("req").build(); + + @BeforeEach + void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + + when(attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(anyLong())).thenReturn(List.of()); + when(answerRepository.findByAttemptId(anyLong())).thenReturn(List.of()); + } + + private User student() { + User u = User.builder().id(STUDENT).phone("1").role(User.Role.STUDENT).build(); + u.setRoles(Set.of(User.Role.STUDENT)); + return u; + } + + private User company() { + User u = User.builder().id(COMPANY).phone("2").role(User.Role.COMPANY).build(); + u.setRoles(Set.of(User.Role.COMPANY)); + return u; + } + + private AssessmentDefinition definition() { + return AssessmentDefinition.builder().id(10L).typeCode("HOLLAND_RIASEC").status("ACTIVE") + .questionCount(72).attemptQuestionCount(30).minPerDimension(5) + .questionSetVersion("riasec-self-v0.2").rulesVersion("riasec-scoring-v0.1").build(); + } + + private AssessmentAttempt attempt(String status) { + return AssessmentAttempt.builder().id(ATTEMPT_ID).studentUserId(STUDENT).definitionId(10L) + .status(status).selectedQuestionCount(30).questionSetVersion("riasec-self-v0.2") + .version(0L).answeredCount(0).build(); + } + + @Test + void companyUser_create_returnsForbidden() { + when(userRepository.findById(COMPANY)).thenReturn(Optional.of(company())); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(COMPANY, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").build(), ctx)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_duplicateActive_returns9708() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(definition())); + when(attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn(anyLong(), anyLong(), anyList())) + .thenReturn(true); + + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(STUDENT, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").build(), ctx)); + assertEquals(ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_sameKeyDifferentDefinition_returns9709() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(definition())); + AssessmentAttempt existing = attempt("DRAFT"); + existing.setId(99L); + existing.setDefinitionId(999L); // 定义不同 → 冲突 + when(attemptRepository.findByStudentUserIdAndIdempotencyKey(STUDENT, "k")).thenReturn(Optional.of(existing)); + + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(STUDENT, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").idempotencyKey("k").build(), ctx)); + assertEquals(ErrorCode.ASSESSMENT_IDEMPOTENCY_CONFLICT.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_sameKeySameDefinition_returnsOriginalAttempt() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(definition())); + AssessmentAttempt existing = attempt("DRAFT"); + existing.setId(99L); + when(attemptRepository.findByStudentUserIdAndIdempotencyKey(STUDENT, "k")).thenReturn(Optional.of(existing)); + + var resp = service.create(STUDENT, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").idempotencyKey("k").build(), ctx); + assertEquals(99L, resp.getAttemptId()); + verify(attemptRepository, never()).saveAndFlush(any()); + } + + @Test + void saveAnswers_questionNotOnAttempt_returns9705() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(attempt("DRAFT"))); + when(attemptQuestionRepository.existsByAttemptIdAndQuestionId(ATTEMPT_ID, 999L)).thenReturn(false); + + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(0L) + .answers(List.of(SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(999L).value(4).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.saveAnswers(STUDENT, ATTEMPT_ID, req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + } + + @Test + void saveAnswers_versionMismatch_returns9707() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + AssessmentAttempt a = attempt("DRAFT"); + a.setVersion(5L); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(a)); + + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(4L) + .answers(List.of(SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(301L).value(4).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.saveAnswers(STUDENT, ATTEMPT_ID, req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void saveAnswers_optimisticLockConflict_returns9707() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(attempt("DRAFT"))); + when(attemptQuestionRepository.existsByAttemptIdAndQuestionId(ATTEMPT_ID, 301L)).thenReturn(true); + when(answerRepository.findByAttemptIdAndQuestionId(ATTEMPT_ID, 301L)).thenReturn(Optional.empty()); + when(answerRepository.countByAttemptId(ATTEMPT_ID)).thenReturn(1L); + doThrow(new OptimisticLockingFailureException("stale")) + .when(attemptRepository).saveAndFlush(any()); + + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(0L) + .answers(List.of(SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(301L).value(4).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.saveAnswers(STUDENT, ATTEMPT_ID, req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void submit_incomplete_returns9706() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(attempt("IN_PROGRESS"))); + when(answerRepository.countByAttemptId(ATTEMPT_ID)).thenReturn(29L); + + BusinessException ex = assertThrows(BusinessException.class, + () -> service.submit(STUDENT, ATTEMPT_ID, ctx)); + assertEquals(ErrorCode.ASSESSMENT_INCOMPLETE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void submit_completed_idempotentReturnsExistingResult() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + AssessmentAttempt a = attempt("COMPLETED"); + a.setSubmittedAt(java.time.LocalDateTime.now()); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(a)); + AssessmentResult r = AssessmentResult.builder().attemptId(ATTEMPT_ID).primaryCode("SIC") + .primaryType("S").answeredCount(30).build(); + when(resultRepository.findByAttemptId(ATTEMPT_ID)).thenReturn(Optional.of(r)); + AssessmentResultResponse resp = AssessmentResultResponse.builder().attemptId(ATTEMPT_ID) + .primaryCode("SIC").build(); + when(resultService.toResponse(a, r)).thenReturn(resp); + + var out = service.submit(STUDENT, ATTEMPT_ID, ctx); + + assertEquals("SIC", out.getPrimaryCode()); + verify(resultService).toResponse(a, r); + verify(auditService, never()).log(anyLong(), eq("ASSESSMENT_ATTEMPT_SUBMITTED"), + anyString(), anyLong(), anyString(), any()); + } + + @Test + void adminUser_create_returnsForbidden() { + User u = User.builder().id(999L).phone("3").role(User.Role.ADMIN).build(); + u.setRoles(Set.of(User.Role.ADMIN)); + when(userRepository.findById(999L)).thenReturn(Optional.of(u)); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(999L, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").build(), ctx)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_inactiveType_returns9701() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of( + AssessmentDefinition.builder().id(10L).typeCode("HOLLAND_RIASEC").status("INACTIVE").build())); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(STUDENT, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").build(), ctx)); + assertEquals(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_insufficientBankOnADimension_rejects() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(definition())); + when(attemptRepository.existsByStudentUserIdAndDefinitionIdAndStatusIn(anyLong(), anyLong(), anyList())) + .thenReturn(false); + // 六维齐全但 R 维度仅 3 道（<5），不能静默减题 + List bank = new ArrayList<>(); + Map perDim = new LinkedHashMap<>( + Map.of("R", 3, "I", 5, "A", 5, "S", 5, "E", 5, "C", 5)); + long seq = 1; + for (Map.Entry e : perDim.entrySet()) { + for (int i = 0; i < e.getValue(); i++) { + bank.add(AssessmentQuestion.builder().id(seq++).dimension(e.getKey()).build()); + } + } + when(questionRepository.findByDefinitionIdAndActiveTrueOrderByPositionAsc(10L)).thenReturn(bank); + + BusinessException ex = assertThrows(BusinessException.class, + () -> service.create(STUDENT, CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").build(), ctx)); + assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); + } + + @Test + void saveAnswers_duplicateQuestionIdInSameRequest_returns9705() { + when(userRepository.findById(STUDENT)).thenReturn(Optional.of(student())); + when(attemptRepository.findById(ATTEMPT_ID)).thenReturn(Optional.of(attempt("DRAFT"))); + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(0L) + .answers(List.of( + SaveAssessmentAnswersRequest.AnswerItem.builder().questionId(301L).value(4).build(), + SaveAssessmentAnswersRequest.AnswerItem.builder().questionId(301L).value(5).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.saveAnswers(STUDENT, ATTEMPT_ID, req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentCatalogServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentCatalogServiceTest.java new file mode 100644 index 0000000..ead71b8 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentCatalogServiceTest.java @@ -0,0 +1,99 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.assessment.dto.AssessmentQuestionResponse; +import com.mydreamjob.assessment.dto.AssessmentTypeResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +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 org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; + +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.when; + +/** + * 测评目录服务单测（V34/V35）。 + * + *

    覆盖类型列表（仅 ACTIVE）、题目列表隐藏 dimension/reverseScored/source/questionVersion、 + * 未知类型 404/9701。

    + */ +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class AssessmentCatalogServiceTest { + + @Mock private AssessmentDefinitionRepository definitionRepository; + @Mock private AssessmentQuestionRepository questionRepository; + + @InjectMocks private AssessmentCatalogService service; + + @Test + void listTypes_returnsOnlyActive() { + AssessmentDefinition active = AssessmentDefinition.builder().id(1L).typeCode("HOLLAND_RIASEC") + .displayName("RIASEC").status("ACTIVE").questionCount(72).attemptQuestionCount(30) + .minPerDimension(5).scaleType("LIKERT_5") + .questionSetVersion("riasec-self-v0.2").rulesVersion("riasec-scoring-v0.1").build(); + AssessmentDefinition inactive = AssessmentDefinition.builder().id(2L).typeCode("OTHER") + .status("DISABLED").build(); + when(definitionRepository.findAll()).thenReturn(List.of(active, inactive)); + + List types = service.listTypes(); + + assertEquals(1, types.size()); + assertEquals("HOLLAND_RIASEC", types.get(0).getTypeCode()); + assertEquals(30, types.get(0).getAttemptQuestionCount()); + } + + @Test + void listQuestions_hidesInternalFields_andMapsPublicOnes() { + AssessmentDefinition def = AssessmentDefinition.builder().id(1L).typeCode("HOLLAND_RIASEC") + .status("ACTIVE").build(); + AssessmentQuestion q = AssessmentQuestion.builder().id(301L).questionCode("R01") + .position(1).dimension("R").stem("我对使用手工工具制作物品感兴趣。") + .scaleType("LIKERT_5").build(); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(def)); + when(questionRepository.findByDefinitionIdAndActiveTrueOrderByPositionAsc(1L)).thenReturn(List.of(q)); + + List items = service.listQuestions("HOLLAND_RIASEC"); + + assertEquals(1, items.size()); + AssessmentQuestionResponse r = items.get(0); + assertEquals(301L, r.getId()); + assertEquals(1, r.getPosition()); + assertEquals("我对使用手工工具制作物品感兴趣。", r.getStem()); + assertEquals("LIKERT_5", r.getScaleType()); + // 内部字段一律不暴露：序列化后 JSON 不含这些字段，value 默认 null + assertNull(r.getValue()); + String json = assertDoesNotThrow(() -> + new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsString(r)); + assertFalse(json.contains("dimension"), "must not serialize dimension"); + assertFalse(json.contains("reverseScored"), "must not serialize reverseScored"); + assertFalse(json.contains("questionVersion"), "must not serialize questionVersion"); + assertFalse(json.contains("questionCode"), "must not serialize dimension-carrying questionCode"); + assertFalse(json.contains("source"), "must not serialize source"); + } + + @Test + void listQuestions_inactiveType_returns9701() { + AssessmentDefinition def = AssessmentDefinition.builder().id(9L).typeCode("HOLLAND_RIASEC") + .status("INACTIVE").build(); + when(definitionRepository.findByTypeCode("HOLLAND_RIASEC")).thenReturn(Optional.of(def)); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.listQuestions("HOLLAND_RIASEC")); + assertEquals(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void listQuestions_unknownType_returns9701() { + when(definitionRepository.findByTypeCode("NOPE")).thenReturn(Optional.empty()); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.listQuestions("NOPE")); + assertEquals(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentControllerTest.java new file mode 100644 index 0000000..d401545 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentControllerTest.java @@ -0,0 +1,279 @@ +package com.mydreamjob.assessment; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.MvcResult; + +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * RIASEC 测评控制器集成测试（真实 Service + H2）。 + * + *

    覆盖 401、题目响应不返回 dimension、创建 200、全流程保存/提交/结果、 + * COMPANY 创建 403、结果不含隐私字段。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AssessmentControllerTest { + + private static final AtomicLong PHONE = new AtomicLong(700); + + @Autowired private MockMvc mockMvc; + @Autowired private ObjectMapper objectMapper; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository dimensionScoreRepository; + + @MockBean private RedisTemplate redisTemplate; + + private Long studentUserId; + private Long companyUserId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + studentUserId = createUser(User.Role.STUDENT); + companyUserId = createUser(User.Role.COMPANY); + } + + @AfterEach + void tearDown() { + // 仅删除自建用户（级联删除其答卷/答案/结果），保留迁移种子（定义+72题） + userRepository.deleteById(studentUserId); + userRepository.deleteById(companyUserId); + } + + private Long createUser(User.Role role) { + User u = userRepository.save(User.builder() + .phone("17" + String.format("%08d", PHONE.incrementAndGet())) + .nickname("u").role(role).roles(Set.of(role)).active(true).verified(true).build()); + return u.getId(); + } + + private String token(Long userId, User.Role role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); + } + + @Test + void types_requiresAuth_returns401() throws Exception { + mockMvc.perform(get("/assessments/types")) + .andExpect(status().isUnauthorized()); + } + + @Test + void questions_hidesDimensionFields() throws Exception { + String tk = token(studentUserId, User.Role.STUDENT); + mockMvc.perform(get("/assessments/HOLLAND_RIASEC/questions").header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data[0].id").exists()) + .andExpect(jsonPath("$.data[0].stem").exists()) + .andExpect(jsonPath("$.data[0].dimension").doesNotExist()) + .andExpect(jsonPath("$.data[0].reverseScored").doesNotExist()) + .andExpect(jsonPath("$.data[0].source").doesNotExist()) + .andExpect(jsonPath("$.data[0].questionVersion").doesNotExist()) + .andExpect(jsonPath("$.data[0].questionCode").doesNotExist()); + } + + @Test + void company_cannotCreateAttempt_returns403() throws Exception { + String tk = token(companyUserId, User.Role.COMPANY); + mockMvc.perform(post("/assessments/attempts") + .header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"HOLLAND_RIASEC\"}")) + .andExpect(status().isForbidden()); + } + + @Test + void fullFlow_createAnswerSubmitResult() throws Exception { + long dimBefore = dimensionScoreRepository.count(); + String tk = token(studentUserId, User.Role.STUDENT); + + MvcResult create = mockMvc.perform(post("/assessments/attempts") + .header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"HOLLAND_RIASEC\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.attemptId").exists()) + .andExpect(jsonPath("$.data.totalQuestions").value(30)) + .andExpect(jsonPath("$.data.questions.length()").value(30)) + .andReturn(); + + String body = create.getResponse().getContentAsString(); + JsonNode data = objectMapper.readTree(body).path("data"); + long attemptId = data.path("attemptId").asLong(); + int version = data.path("version").asInt(); + JsonNode questions = data.path("questions"); + assertEquals(30, questions.size()); + + StringBuilder answers = new StringBuilder("{\"version\":").append(version).append(",\"answers\":["); + for (int i = 0; i < questions.size(); i++) { + if (i > 0) answers.append(','); + answers.append("{\"questionId\":").append(questions.get(i).path("id").asLong()) + .append(",\"value\":4}"); + } + answers.append("]}"); + + mockMvc.perform(patch("/assessments/attempts/{id}/answers", attemptId) + .header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content(answers.toString())) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.answeredCount").value(30)) + .andExpect(jsonPath("$.data.completionRate").value(100.0)); + + MvcResult submit = mockMvc.perform(post("/assessments/attempts/{id}/submit", attemptId) + .header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.primaryCode").exists()) + .andExpect(jsonPath("$.data.disclaimer").value("本结果仅供职业兴趣探索参考，不构成心理或职业诊断。")) + .andReturn(); + JsonNode resultData = objectMapper.readTree(submit.getResponse().getContentAsString()).path("data"); + assertEquals(3, resultData.path("primaryCode").asText().length()); + + mockMvc.perform(get("/assessments/attempts/{id}/result", attemptId) + .header("Authorization", tk)) + .andExpect(status().isOk()) + // 脱敏：结果不含隐私字段与国家内部标识 + .andExpect(jsonPath("$.data.studentUserId").doesNotExist()) + .andExpect(jsonPath("$.data.phone").doesNotExist()) + .andExpect(jsonPath("$.data.email").doesNotExist()) + .andExpect(jsonPath("$.data.password").doesNotExist()) + // 探索方向使用"可能感兴趣"文案 + .andExpect(jsonPath("$.data.explorationDirections").isArray()); + + // 不写入候选评分引擎 + assertEquals(dimBefore, dimensionScoreRepository.count()); + } + + @Test + void concurrentCreate_differentKeys_onlyOne200_others409_9708() throws Exception { + String tk = token(studentUserId, User.Role.STUDENT); + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue httpResults = new ConcurrentLinkedQueue<>(); // {status, code} + for (int i = 0; i < n; i++) { + final String key = "http-cc-" + studentUserId + "-" + i; + pool.submit(() -> { + await(start); + try { + MvcResult r = mockMvc.perform(post("/assessments/attempts") + .header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"HOLLAND_RIASEC\",\"idempotencyKey\":\"" + key + "\"}")) + .andReturn(); + int status = r.getResponse().getStatus(); + int code = -1; + try { + code = objectMapper.readTree(r.getResponse().getContentAsString()).path("errorCode").isMissingNode() + ? objectMapper.readTree(r.getResponse().getContentAsString()).path("code").asInt(-1) + : objectMapper.readTree(r.getResponse().getContentAsString()).path("errorCode").asInt(-1); + } catch (Exception ignore) { } + httpResults.add(new int[]{status, code}); + } catch (Exception ex) { + httpResults.add(new int[]{-1, -1}); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS)); + pool.shutdown(); + int[] statuses = httpResults.stream().mapToInt(r -> r[0]).toArray(); + assertEquals(1, countOf(statuses, 200), "exactly one HTTP 200"); + assertEquals(n - 1, countOf(statuses, 409), "losers must be HTTP 409: " + java.util.Arrays.toString(statuses)); + assertEquals(0, countOf(statuses, 500), "no HTTP 500"); + assertEquals(0, countOf(statuses, -1), "no empty/unreachable responses"); + // 所有失败请求的 JSON code 都必须是 9708 + assertEquals(n - 1, httpResults.stream().filter(r -> r[0] == 409 && r[1] == 9708).count(), + "all 409 must carry code 9708"); + } + + @Test + void concurrentCreate_sameKey_all200_sameAttemptId() throws Exception { + String tk = token(studentUserId, User.Role.STUDENT); + String key = "http-cidem-" + studentUserId; + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue ids = new ConcurrentLinkedQueue<>(); + ConcurrentLinkedQueue badStatus = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + MvcResult r = mockMvc.perform(post("/assessments/attempts") + .header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"typeCode\":\"HOLLAND_RIASEC\",\"idempotencyKey\":\"" + key + "\"}")) + .andReturn(); + if (r.getResponse().getStatus() != 200) { + badStatus.add(r.getResponse().getStatus()); + } else { + ids.add(objectMapper.readTree(r.getResponse().getContentAsString()) + .path("data").path("attemptId").asLong()); + } + } catch (Exception ex) { + badStatus.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS)); + pool.shutdown(); + assertEquals(0, badStatus.size(), "same idempotencyKey concurrent create must all be 200: " + badStatus); + assertEquals(n, ids.size()); + assertEquals(1, ids.stream().distinct().count(), "all requests must return the same attemptId"); + } + + private int countOf(int[] arr, int v) { + int c = 0; + for (int x : arr) if (x == v) c++; + return c; + } + + private void await(CountDownLatch latch) { + try { latch.await(); } catch (InterruptedException e) { Thread.currentThread().interrupt(); } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentPersistenceIntegrationTest.java new file mode 100644 index 0000000..1a9430e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentPersistenceIntegrationTest.java @@ -0,0 +1,430 @@ +package com.mydreamjob.assessment; + +import com.mydreamjob.assessment.dto.AssessmentAttemptResponse; +import com.mydreamjob.assessment.dto.AssessmentQuestionResponse; +import com.mydreamjob.assessment.dto.CreateAssessmentAttemptRequest; +import com.mydreamjob.assessment.dto.SaveAssessmentAnswersRequest; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; + +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.atomic.AtomicLong; +import java.util.stream.Collectors; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * RIASEC 测评持久化集成测试（H2 + Flyway V34 真实表结构）。 + * + *

    覆盖 V34 迁移成功、抽题 30 且每维 5、无重复、固定顺序、答案归属校验、 + * 29 题提交失败、30 题提交成功、重复提交幂等、幂等键、活跃答卷重复、候选评分不写入、 + * 唯一/CHECK 约束。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AssessmentPersistenceIntegrationTest { + + private static final AtomicLong PHONE = new AtomicLong(800); + + @Autowired private AssessmentAttemptService attemptService; + @Autowired private AssessmentCatalogService catalogService; + @Autowired private AssessmentDefinitionRepository definitionRepository; + @Autowired private AssessmentQuestionRepository questionRepository; + @Autowired private AssessmentAttemptRepository attemptRepository; + @Autowired private AssessmentAttemptQuestionRepository attemptQuestionRepository; + @Autowired private AssessmentAnswerRepository answerRepository; + @Autowired private AssessmentResultRepository resultRepository; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository dimensionScoreRepository; + @Autowired private AuditLogRepository auditLogRepository; + + @MockBean private RedisTemplate redisTemplate; + + private final AuditContext ctx = AuditContext.builder().requestId("req").build(); + private final List createdUsers = new ArrayList<>(); + private Long studentUserId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + studentUserId = createUser(); + } + + @AfterEach + void tearDown() { + // 仅删除自建用户（级联删除其答卷/答案/结果），保留迁移种子 + for (Long id : createdUsers) { + userRepository.deleteById(id); + } + createdUsers.clear(); + } + + private Long createUser() { + User u = userRepository.save(User.builder() + .phone("18" + String.format("%08d", PHONE.incrementAndGet())) + .nickname("u").role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)) + .active(true).verified(true).build()); + createdUsers.add(u.getId()); + return u.getId(); + } + + private CreateAssessmentAttemptRequest createReq(String key) { + return CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").idempotencyKey(key).build(); + } + + private SaveAssessmentAnswersRequest answerReq(AssessmentAttemptResponse resp, int value) { + List items = resp.getQuestions().stream() + .map(q -> SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(q.getId()).value(value).build()) + .collect(Collectors.toList()); + return SaveAssessmentAnswersRequest.builder().version(resp.getVersion()).answers(items).build(); + } + + private SaveAssessmentAnswersRequest partialReq(AssessmentAttemptResponse resp, int count) { + List items = resp.getQuestions().subList(0, count).stream() + .map(q -> SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(q.getId()).value(4).build()) + .collect(Collectors.toList()); + return SaveAssessmentAnswersRequest.builder().version(resp.getVersion()).answers(items).build(); + } + + // ── 迁移 & 抽题 ───────────────────────────────────────── + + @Test + void v34Migration_seedsDefinitionAnd72Questions() { + var def = definitionRepository.findByTypeCode("HOLLAND_RIASEC").orElseThrow(); + assertEquals(72, def.getQuestionCount()); + assertEquals(30, def.getAttemptQuestionCount()); + assertEquals(5, def.getMinPerDimension()); + assertEquals(72, questionRepository.findByDefinitionIdAndActiveTrueOrderByPositionAsc(def.getId()).size()); + assertEquals(1, catalogService.listTypes().stream().filter(t -> "ACTIVE".equals(t.getStatus())).count()); + } + + @Test + void create_sampled30_fivePerDimension_noDuplicatesFixedOrder() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-create"), ctx); + // 恰好 30 题 + assertEquals(30, resp.getTotalQuestions()); + assertEquals(30, resp.getQuestions().size()); + // 无重复 + Set ids = new HashSet<>(); + for (AssessmentQuestionResponse q : resp.getQuestions()) { + assertTrue(ids.add(q.getId()), "no duplicate question expected"); + } + // 每维恰好 5 题 + List qids = resp.getQuestions().stream().map(AssessmentQuestionResponse::getId).toList(); + Map byDim = questionRepository.findAllById(qids).stream() + .collect(Collectors.groupingBy(AssessmentQuestion::getDimension, Collectors.counting())); + for (String dim : List.of("R", "I", "A", "S", "E", "C")) { + assertEquals(5L, byDim.getOrDefault(dim, 0L), "dimension " + dim); + } + // 刷新（重查）顺序不变 + AssessmentAttemptResponse again = attemptService.get(studentUserId, resp.getAttemptId()); + assertEquals(resp.getQuestions().stream().map(AssessmentQuestionResponse::getId).toList(), + again.getQuestions().stream().map(AssessmentQuestionResponse::getId).toList()); + } + + @Test + void create_duplicateActive_returns9708() { + attemptService.create(studentUserId, createReq("k-active-1"), ctx); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.create(studentUserId, createReq("k-active-2"), ctx)); + assertEquals(ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void create_sameKeySameBody_returnsOriginalAttempt() { + AssessmentAttemptResponse first = attemptService.create(studentUserId, createReq("k-idem"), ctx); + AssessmentAttemptResponse second = attemptService.create(studentUserId, createReq("k-idem"), ctx); + assertEquals(first.getAttemptId(), second.getAttemptId()); + long attempts = attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(studentUserId, + org.springframework.data.domain.PageRequest.of(0, 50)).getTotalElements(); + assertEquals(1L, attempts); + } + + // ── 保存答案 ──────────────────────────────────────────── + + @Test + void saveAnswers_questionNotOnAttempt_returns9705() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-save-1"), ctx); + Long foreignQuestionId = questionRepository.findAll().stream() + .map(AssessmentQuestion::getId) + .filter(id -> resp.getQuestions().stream().noneMatch(q -> q.getId().equals(id))) + .findFirst().orElseThrow(); + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(resp.getVersion()) + .answers(List.of(SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(foreignQuestionId).value(4).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.saveAnswers(studentUserId, resp.getAttemptId(), req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + } + + @Test + void saveAnswers_invalidValue_returns9705() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-save-2"), ctx); + Long qid = resp.getQuestions().get(0).getId(); + SaveAssessmentAnswersRequest req = SaveAssessmentAnswersRequest.builder() + .version(resp.getVersion()) + .answers(List.of(SaveAssessmentAnswersRequest.AnswerItem.builder() + .questionId(qid).value(6).build())) + .build(); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.saveAnswers(studentUserId, resp.getAttemptId(), req, ctx)); + assertEquals(ErrorCode.ASSESSMENT_ANSWER_INVALID.getCode(), ex.getErrorCodeInt()); + } + + // ── 提交 ──────────────────────────────────────────────── + + @Test + void submit_29Answered_returns9706() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-sub-29"), ctx); + attemptService.saveAnswers(studentUserId, resp.getAttemptId(), + partialReq(resp, 29), ctx); + BusinessException ex = assertThrows(BusinessException.class, + () -> attemptService.submit(studentUserId, resp.getAttemptId(), ctx)); + assertEquals(ErrorCode.ASSESSMENT_INCOMPLETE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void submit_30Answered_succeeds_andRepeatedIdempotent() { + long dimBefore = dimensionScoreRepository.count(); + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-sub-30"), ctx); + attemptService.saveAnswers(studentUserId, resp.getAttemptId(), answerReq(resp, 4), ctx); + assertEquals(30, answerRepository.countByAttemptId(resp.getAttemptId())); + + var result = attemptService.submit(studentUserId, resp.getAttemptId(), ctx); + assertEquals("COMPLETED", result.getStatus()); + assertEquals(30, result.getAnsweredCount()); + assertEquals(100.0, result.getCompletionRate().doubleValue()); + assertNotNull(result.getPrimaryCode()); + assertEquals(3, result.getPrimaryCode().length()); + assertEquals(30, attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(resp.getAttemptId()).size()); + + // 重复提交幂等：不再新增结果 + var again = attemptService.submit(studentUserId, resp.getAttemptId(), ctx); + assertEquals(result.getPrimaryCode(), again.getPrimaryCode()); + assertEquals(1, resultRepository.findByAttemptId(resp.getAttemptId()).isPresent() ? 1 : 0); + + // 不写入候选评分引擎 + assertEquals(dimBefore, dimensionScoreRepository.count()); + } + + @Test + void fullFlow_statusAndResultPersisted() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-flow"), ctx); + attemptService.saveAnswers(studentUserId, resp.getAttemptId(), answerReq(resp, 3), ctx); + + var detail = attemptService.get(studentUserId, resp.getAttemptId()); + assertEquals("IN_PROGRESS", detail.getStatus()); + assertEquals(30, detail.getAnsweredCount()); + + var result = attemptService.submit(studentUserId, resp.getAttemptId(), ctx); + var attemptRow = attemptRepository.findById(resp.getAttemptId()).orElseThrow(); + assertEquals(AssessmentAttempt.STATUS_COMPLETED, attemptRow.getStatus()); + assertNotNull(attemptRow.getSubmittedAt()); + assertNotNull(resultRepository.findByAttemptId(resp.getAttemptId()).orElseThrow().getGeneratedAt()); + } + + // ── 约束校验 ──────────────────────────────────────────── + + @Test + void inactiveDefinition_createAndList_returns9701() { + AssessmentDefinition inactive = definitionRepository.save(AssessmentDefinition.builder() + .typeCode("INACTIVE_TEST").displayName("x").description("d").instructions("i") + .status("INACTIVE").scaleType("LIKERT_5") + .questionCount(30).attemptQuestionCount(30).minPerDimension(5) + .questionSetVersion("v0.2").rulesVersion("v0.1").build()); + try { + BusinessException createEx = assertThrows(BusinessException.class, + () -> attemptService.create(studentUserId, CreateAssessmentAttemptRequest.builder() + .typeCode("INACTIVE_TEST").build(), ctx)); + assertEquals(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND.getCode(), createEx.getErrorCodeInt()); + + BusinessException listEx = assertThrows(BusinessException.class, + () -> catalogService.listQuestions("INACTIVE_TEST")); + assertEquals(ErrorCode.ASSESSMENT_TYPE_NOT_FOUND.getCode(), listEx.getErrorCodeInt()); + } finally { + definitionRepository.delete(inactive); + } + } + + @Test + void concurrentCreate_sameStudentSameType_onlyOneSucceedsRestAre9708() throws Exception { + Long u = createUser(); + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + java.util.concurrent.ConcurrentLinkedQueue results = new java.util.concurrent.ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + final String key = "ccp-" + u + "-" + i; + pool.submit(() -> { + await(start); + try { + attemptService.create(u, createReq(key), ctx); + results.add(0); // 成功 + } catch (BusinessException be) { + results.add(be.getErrorCodeInt()); // 9708 + } catch (Exception other) { + results.add(-1); // 出现 AssertionFailure/500 等即失败 + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS), "concurrent create should finish"); + pool.shutdown(); + assertEquals(1, results.stream().filter(c -> c == 0).count(), "exactly one concurrent create must win (200)"); + assertEquals(n - 1, results.stream().filter(c -> c == ErrorCode.ASSESSMENT_DUPLICATE_ACTIVE.getCode()).count(), + "all losers must be BusinessException 9708"); + assertEquals(0, results.stream().filter(c -> c < 0).count(), "no AssertionFailure/500/other exceptions allowed"); + + long attemptRows = attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(u, + PageRequest.of(0, 50)).getTotalElements(); + assertEquals(1, attemptRows, "DB must contain exactly 1 attempt row"); + long activeKeys = attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(u, + PageRequest.of(0, 50)).getContent().stream() + .filter(a -> a.getActiveKey() != null).count(); + assertEquals(1, activeKeys, "DB must contain exactly 1 non-null active_key"); + Long winnerId = attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(u, PageRequest.of(0, 50)) + .getContent().get(0).getId(); + assertEquals(30, attemptQuestionRepository.findByAttemptIdOrderByPositionAsc(winnerId).size(), + "winning attempt must have 30 attempt_questions"); + } + + @Test + void concurrentCreate_sameIdempotencyKey_returnsSameAttempt() throws Exception { + Long u = createUser(); + String idem = "cidem-" + u; + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + java.util.concurrent.ConcurrentLinkedQueue attemptIds = new java.util.concurrent.ConcurrentLinkedQueue<>(); + java.util.concurrent.ConcurrentLinkedQueue errors = new java.util.concurrent.ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + AssessmentAttemptResponse r = attemptService.create(u, + CreateAssessmentAttemptRequest.builder() + .typeCode("HOLLAND_RIASEC").idempotencyKey(idem).build(), ctx); + attemptIds.add(r.getAttemptId()); + } catch (BusinessException be) { + errors.add(be.getErrorCodeInt()); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS), "concurrent idem create should finish"); + pool.shutdown(); + assertEquals(0, errors.size(), "same idempotencyKey concurrent create must not error: " + errors); + assertEquals(n, attemptIds.size(), "every request must return an attemptId (idempotent 200)"); + assertEquals(1, attemptIds.stream().distinct().count(), "all requests must share the same attemptId"); + assertEquals(1, attemptRepository.findByStudentUserIdOrderByCreatedAtDesc(u, + PageRequest.of(0, 50)).getTotalElements(), "only one attempt row persisted"); + } + + @Test + void concurrentSubmit_onlyOneResultAndOneSubmitAudit() throws Exception { + Long u = createUser(); + AssessmentAttemptResponse resp = attemptService.create(u, createReq("cs-" + u), ctx); + attemptService.saveAnswers(u, resp.getAttemptId(), answerReq(resp, 4), ctx); + + int n = 2; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + attemptService.submit(u, resp.getAttemptId(), ctx); + } catch (Exception ignored) { + // 并发幂等，允许 9703/原有结果 + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS), "concurrent submit should finish"); + pool.shutdown(); + + assertEquals(1, resultRepository.findByAttemptId(resp.getAttemptId()).isPresent() ? 1 : 0, + "concurrent submit must produce exactly one result"); + long submitAudits = auditLogRepository.findAll().stream() + .filter(a -> "ASSESSMENT_ATTEMPT_SUBMITTED".equals(a.getAction()) + && resp.getAttemptId().equals(a.getEntityId())) + .count(); + assertEquals(1, submitAudits, "concurrent submit must write exactly one submit audit"); + + var attemptRow = attemptRepository.findById(resp.getAttemptId()).orElseThrow(); + assertEquals(AssessmentAttempt.STATUS_COMPLETED, attemptRow.getStatus()); + assertNull(attemptRow.getActiveKey(), "active_key must be released after completion"); + } + + @Test + void dbConstraints_uniqueAndCheckEnforced() { + AssessmentAttemptResponse resp = attemptService.create(studentUserId, createReq("k-cons"), ctx); + Long attemptId = resp.getAttemptId(); + Long q1 = resp.getQuestions().get(0).getId(); + Long q2 = resp.getQuestions().get(1).getId(); + + answerRepository.saveAndFlush(AssessmentAnswer.builder() + .attemptId(attemptId).questionId(q1).value(4).build()); + // 唯一(attempt,question) → 重复插入违反唯一约束 + assertThrows(DataIntegrityViolationException.class, + () -> answerRepository.saveAndFlush(AssessmentAnswer.builder() + .attemptId(attemptId).questionId(q1).value(5).build())); + // CHECK value BETWEEN 1 AND 5 → 越界 + assertThrows(DataIntegrityViolationException.class, + () -> answerRepository.saveAndFlush(AssessmentAnswer.builder() + .attemptId(attemptId).questionId(q2).value(6).build())); + } + + private void await(CountDownLatch latch) { + try { + latch.await(); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentQuestionBankTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentQuestionBankTest.java new file mode 100644 index 0000000..bece479 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentQuestionBankTest.java @@ -0,0 +1,105 @@ +package com.mydreamjob.assessment; + +import org.junit.jupiter.api.Test; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * 题库种子迁移校验（V34/V35）。 + * + *

    解析 V34__riasec_assessment.sql 的题目插入： + * 72 道、六维各 12、position 1-72 唯一、reverse_scored=0、source=SELF_AUTHORED、active=1。

    + */ +class AssessmentQuestionBankTest { + + private static final Pattern ROW = Pattern.compile( + "SELECT '([RIAESC]\\d+)'\\s*,\\s*(\\d+)\\s*,\\s*'([RIAESC])'\\s*,\\s*'(.*?)'"); + + private record Row(String code, int position, String dimension, String stem) {} + + private List parseRows() throws IOException { + try (InputStream in = getClass().getResourceAsStream("/db/migration/V34__riasec_assessment.sql")) { + assertNotNull(in, "V34 migration must exist on classpath"); + String sql = new String(in.readAllBytes(), StandardCharsets.UTF_8); + // 仅取题目 INSERT 段 + int start = sql.indexOf("INSERT INTO assessment_questions"); + assertTrue(start >= 0, "questions insert section must exist"); + String section = sql.substring(start); + int end = section.indexOf(") q"); + section = section.substring(0, end >= 0 ? end : section.length()); + // 归一化：去除短形式/长形式的列别名，统一为 "SELECT 'C01', 1, 'R', '题干'" 形式 + section = section.replaceAll("\\s+AS\\s+[A-Za-z_]+", ""); + + List rows = new ArrayList<>(); + Matcher m = ROW.matcher(section.trim()); + while (m.find()) { + rows.add(new Row(m.group(1), Integer.parseInt(m.group(2)), m.group(3), m.group(4))); + } + return rows; + } + } + + @Test + void seeds_72Questions_sixDimensions12Each_uniquePositions() throws IOException { + List rows = parseRows(); + assertEquals(72, rows.size(), "total questions must be 72"); + + Map byDim = new HashMap<>(); + Set positions = new HashSet<>(); + Set codes = new HashSet<>(); + for (Row r : rows) { + byDim.merge(r.dimension(), 1, Integer::sum); + positions.add(r.position()); + codes.add(r.code()); + } + for (String dim : List.of("R", "I", "A", "S", "E", "C")) { + assertEquals(12, byDim.getOrDefault(dim, 0), "dimension " + dim + " must have 12 questions"); + } + assertEquals(72, positions.size(), "positions must be unique"); + assertEquals(72, codes.size(), "question codes must be unique"); + // position 覆盖 1-72 + for (int i = 1; i <= 72; i++) { + assertTrue(positions.contains(i), "position " + i + " missing"); + } + } + + @Test + void seeds_constantFields_selfAuthoredNotReversedActive() throws IOException { + String sql = new String(getClass().getResourceAsStream("/db/migration/V34__riasec_assessment.sql") + .readAllBytes(), StandardCharsets.UTF_8); + int start = sql.indexOf("INSERT INTO assessment_questions"); + String section = sql.substring(start); + int end = section.indexOf(") q"); + section = section.substring(0, end >= 0 ? end : section.length()); + // 常量校验：source / reverse / active 在 INSERT 外层 SELECT 中为常量，作用于全部 72 行 + assertTrue(section.contains("'SELF_AUTHORED'"), "source must be SELF_AUTHORED"); + assertTrue(section.contains("'SELF_AUTHORED', 0, 1"), "reverse_scored=0 and active=1"); + assertEquals(1, countOccurrences(section, "'SELF_AUTHORED'"), + "self-authored constant appears exactly once as outer SELECT literal"); + assertTrue(sql.contains("'riasec-self-v0.2'"), "question_set_version must be riasec-self-v0.2"); + assertTrue(sql.contains("'riasec-scoring-v0.1'"), "rules_version must be riasec-scoring-v0.1"); + assertTrue(sql.contains("72"), "definition question_count=72"); + } + + private int countOccurrences(String s, String needle) { + int count = 0; + int idx = 0; + while ((idx = s.indexOf(needle, idx)) >= 0) { + count++; + idx += needle.length(); + } + return count; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentResultComputerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentResultComputerTest.java new file mode 100644 index 0000000..5e7e900 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentResultComputerTest.java @@ -0,0 +1,94 @@ +package com.mydreamjob.assessment; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * RIASEC 计分引擎单测（V34/V35）。 + * + *

    验证 percentage = raw/25 × 100（HALF_UP, scale2）、六维降序、同分按维度字母升序、 + * 前三组成 primaryCode、维度分数规范顺序输出。

    + */ +class AssessmentResultComputerTest { + + private final AssessmentResultComputer computer = new AssessmentResultComputer(); + + private AssessmentResultComputer.DimensionValue v(String dim, int value) { + return new AssessmentResultComputer.DimensionValue(dim, value); + } + + @Test + void compute_fullScores_matchesExpectedPercentagesAndPrimaryCode() { + List answers = List.of( + v("S", 5), v("S", 5), v("S", 5), v("S", 5), v("S", 4), // 24 → 96.00 + v("I", 4), v("I", 5), v("I", 5), v("I", 4), v("I", 4), // 22 → 88.00 + v("C", 4), v("C", 4), v("C", 4), v("C", 4), v("C", 4), // 20 → 80.00 + v("R", 4), v("R", 3), v("R", 4), v("R", 4), v("R", 4), // 19 → 76.00 + v("A", 4), v("A", 4), v("A", 3), v("A", 4), v("A", 3), // 18 → 72.00 + v("E", 3), v("E", 4), v("E", 4), v("E", 3), v("E", 3) // 17 → 68.00 + ); + + var result = computer.compute(answers, 5, 5); + + assertEquals(new BigDecimal("96.00"), score(result, "S")); + assertEquals(new BigDecimal("88.00"), score(result, "I")); + assertEquals(new BigDecimal("80.00"), score(result, "C")); + assertEquals(new BigDecimal("76.00"), score(result, "R")); + assertEquals(new BigDecimal("72.00"), score(result, "A")); + assertEquals(new BigDecimal("68.00"), score(result, "E")); + + assertEquals(List.of("S", "I", "C", "R", "A", "E"), result.typeRanking()); + assertEquals("SIC", result.primaryCode()); + assertEquals("S", result.primaryType()); + // 规范顺序输出六维 + assertEquals(6, result.dimensionScores().size()); + assertEquals("R", result.dimensionScores().get(0).dimension()); + } + + @Test + void compute_tie_orderedAlphabetically() { + // 所有维度都 60.00，排序按字母升序：A < C < E < I < R < S + List answers = List.of( + v("S", 3), v("S", 3), v("S", 3), v("S", 3), v("S", 3), + v("I", 3), v("I", 3), v("I", 3), v("I", 3), v("I", 3), + v("A", 3), v("A", 3), v("A", 3), v("A", 3), v("A", 3), + v("C", 3), v("C", 3), v("C", 3), v("C", 3), v("C", 3), + v("E", 3), v("E", 3), v("E", 3), v("E", 3), v("E", 3), + v("R", 3), v("R", 3), v("R", 3), v("R", 3), v("R", 3) + ); + + var result = computer.compute(answers, 5, 5); + + assertEquals(List.of("A", "C", "E", "I", "R", "S"), result.typeRanking()); + assertEquals("ACE", result.primaryCode()); + assertEquals("A", result.primaryType()); + } + + @Test + void compute_halfUp_rounding() { + // 每个维度 values 总和为奇数时产生 .33 → 截断为两位 HALF_UP + List answers = List.of( + v("R", 4), v("R", 4), v("R", 4), v("R", 4), v("R", 4) // 20 → 80.00 + ); + var result = computer.compute(answers, 5, 5); + // 未答维度 raw=0 → 0.00 + assertEquals(new BigDecimal("0.00"), score(result, "I")); + // 精度校验：1 题 3 分、其余缺失（仅测 answeredCount 兜底） + List partial = List.of(v("E", 3)); + var r2 = computer.compute(partial, 5, 5); + assertEquals(new BigDecimal("12.00"), score(r2, "E")); // 3/25*100 + } + + private BigDecimal score(AssessmentResultComputer.ComputedResult result, String dim) { + return result.dimensionScores().stream() + .filter(d -> d.dimension().equals(dim)) + .findFirst() + .map(AssessmentResultComputer.DimensionScoreResult::score) + .orElseThrow(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentSchemaValidationSmokeTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentSchemaValidationSmokeTest.java new file mode 100644 index 0000000..11c8c67 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/assessment/AssessmentSchemaValidationSmokeTest.java @@ -0,0 +1,80 @@ +package com.mydreamjob.assessment; + +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * V35 启动 / schema 校验冒烟测试。 + * + *

    真实启动完整上下文（H2 MODE=MySQL + Flyway V34）。校验 + * {@code assessment_questions.active / reverse_scored}： + * ① 数据库列为 NOT NULL 整数（TINYINT 家族，绝非 BIT）； + * ② 实体 Boolean 字段均标注 {@code @JdbcTypeCode(TINYINT)}， + * 使 Hibernate 在 MySQL/H2 下均按 tinyint 校验，避免默认 Boolean→BIT 与 TINYINT 冲突。

    + * + *

    注：此处不做全局 {@code ddl-auto=validate}（会触发既有 V1-V33 无关实体 + * {@code auth_tokens.revoked} 在 H2 的 BOOLEAN/TINYINT 校验外观问题），仅针对 assessment 列与映射断言。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AssessmentSchemaValidationSmokeTest { + + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private RedisTemplate redisTemplate; + + @Test + void assessmentQuestion_integerColumnsAndTinyIntMapping() { + // ① 上下文能加载 → Flyway V34 正常；列类型为整数（TINYINT），NOT NULL + List> cols = jdbcTemplate.queryForList( + "SELECT column_name, data_type, is_nullable FROM information_schema.columns " + + "WHERE LOWER(table_name) = 'assessment_questions' " + + "AND LOWER(column_name) IN ('active', 'reverse_scored')"); + assertEquals(2, cols.size(), "both boolean-ish columns must exist"); + + Set types = new HashSet<>(); + Set names = new HashSet<>(); + for (Map col : cols) { + names.add(String.valueOf(col.get("COLUMN_NAME")).toLowerCase()); + types.add(String.valueOf(col.get("DATA_TYPE")).toUpperCase()); + assertEquals("NO", String.valueOf(col.get("IS_NULLABLE")).toUpperCase(), "column must be NOT NULL"); + } + assertTrue(names.containsAll(Set.of("active", "reverse_scored")), "expected columns: " + names); + // TINYINT 系列整数类型（H2/MySQL 均含 'INT'），绝不允许映射成 BIT + assertTrue(types.stream().allMatch(t -> t.contains("INT")), + "active/reverse_scored must be integer (TINYINT) columns, got: " + types); + + // ② 实体字段带 @JdbcTypeCode(TINYINT)，双向一致 → 不出现 TINYINT/BIT 冲突 + assertEquals(SqlTypes.TINYINT, fieldJdbcType("active"), "active must map to TINYINT"); + assertEquals(SqlTypes.TINYINT, fieldJdbcType("reverseScored"), "reverse_scored must map to TINYINT"); + + // ③ Boolean 读取 72 行无类型异常 + List actives = jdbcTemplate.queryForList("SELECT active FROM assessment_questions", Boolean.class); + assertEquals(72, actives.size()); + } + + private int fieldJdbcType(String fieldName) { + try { + java.lang.reflect.Field f = AssessmentQuestion.class.getDeclaredField(fieldName); + JdbcTypeCode code = f.getAnnotation(JdbcTypeCode.class); + assertNotNull(code, fieldName + " must be annotated with @JdbcTypeCode"); + return code.value(); + } catch (NoSuchFieldException e) { + throw new AssertionError("missing field " + fieldName, e); + } + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapConcurrencyLoggingTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapConcurrencyLoggingTest.java new file mode 100644 index 0000000..231248f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapConcurrencyLoggingTest.java @@ -0,0 +1,299 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.classic.spi.IThrowableProxy; +import ch.qos.logback.classic.spi.StackTraceElementProxy; +import ch.qos.logback.core.read.ListAppender; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.*; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * S03 定向整改：管理员初始化并发冲突**不得**把完整手机号写进任何日志。 + * + *

    并发竞争由数据库唯一约束兜底时，Hibernate 的 {@code SqlExceptionHelper} 会在业务代码 + * 捕获异常**之前**记录整条 SQL 与绑定参数 —— 手机号因此进入日志。本类捕获 + * root / {@code com.mydreamjob} / {@code org.hibernate} / {@code org.springframework.jdbc} + * 四类 logger，并把 {@code throwableProxy} 的完整文本（含 cause 链与堆栈）纳入扫描。

    + */ +@SpringBootTest(properties = { + "app.bootstrap.admin.enabled=true", + "app.bootstrap.admin.phone=13800000666", + "app.bootstrap.admin.nickname=并发引导管理员", +}) +@ActiveProfiles("integration-test") +class AdminBootstrapConcurrencyLoggingTest { + + private static final String BOOTSTRAP_PHONE = "13800000666"; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private AdminBootstrapRunner runner; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private final List> appenders = new ArrayList<>(); + private final List attachedLoggers = new ArrayList<>(); + private final List deactivatedAdmins = new ArrayList<>(); + + private static final String[] CAPTURED_LOGGERS = { + org.slf4j.Logger.ROOT_LOGGER_NAME, + "com.mydreamjob", + "org.hibernate", + "org.springframework.jdbc", + }; + + @BeforeEach + void setUp() { + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", + BOOTSTRAP_PHONE); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + + // 保证「无活动 ADMIN」前置条件与执行顺序无关 + deactivatedAdmins.clear(); + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE role = 'ADMIN' AND is_active = 1", Long.class)) { + jdbcTemplate.update("UPDATE users SET is_active = 0 WHERE id = ?", id); + deactivatedAdmins.add(id); + } + + for (String name : CAPTURED_LOGGERS) { + Logger logger = (Logger) LoggerFactory.getLogger(name); + ListAppender appender = new ListAppender<>(); + appender.start(); + logger.addAppender(appender); + // 刻意**不**下调级别：按应用自身配置（root=WARN、com.mydreamjob=INFO）捕获， + // 扫描结果才等于「生产到底写出了什么」。 + // 框架在 TRACE 下的绑定参数日志不属于生产可见输出，不应计入本断言。 + appenders.add(appender); + attachedLoggers.add(logger); + } + } + + @AfterEach + void tearDown() { + for (int i = 0; i < attachedLoggers.size(); i++) { + attachedLoggers.get(i).detachAppender(appenders.get(i)); + appenders.get(i).stop(); + } + attachedLoggers.clear(); + appenders.clear(); + + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", + BOOTSTRAP_PHONE); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + for (Long id : deactivatedAdmins) { + jdbcTemplate.update("UPDATE users SET is_active = 1 WHERE id = ?", id); + } + deactivatedAdmins.clear(); + } + + // ── 日志采集（含 throwableProxy 全文）──────────────────────── + + /** 把 throwableProxy 的类名、message、堆栈与 cause 链完整渲染为文本。 */ + private static String renderThrowable(IThrowableProxy proxy) { + if (proxy == null) { + return ""; + } + StringBuilder sb = new StringBuilder(); + sb.append(proxy.getClassName()).append(": ").append(proxy.getMessage()).append('\n'); + StackTraceElementProxy[] stack = proxy.getStackTraceElementProxyArray(); + if (stack != null) { + for (StackTraceElementProxy s : stack) { + sb.append(" at ").append(s.getStackTraceElement()).append('\n'); + } + } + if (proxy.getCause() != null) { + sb.append("Caused by: ").append(renderThrowable(proxy.getCause())); + } + return sb.toString(); + } + + /** + * 所有被捕获 logger 的完整文本：formattedMessage + 参数 + throwable 全文。 + * + *

    排除 {@code org.springframework.test.*}：测试框架自身会在 DEBUG 记录 + * 上下文缓存键（其中包含本次 {@code @SpringBootTest} 的属性列表，因而含手机号）。 + * 那是测试基础设施的输出，不是产品日志 —— 生产运行不存在该 logger。

    + */ + private String capturedText() { + StringBuilder sb = new StringBuilder(); + for (ListAppender appender : appenders) { + for (ILoggingEvent e : appender.list) { + if (e.getLoggerName() != null && e.getLoggerName().startsWith("org.springframework.test")) { + continue; + } + sb.append(e.getFormattedMessage()).append('\n'); + Object[] args = e.getArgumentArray(); + if (args != null) { + for (Object a : args) { + sb.append(String.valueOf(a)).append('\n'); + } + } + sb.append(renderThrowable(e.getThrowableProxy())); + } + } + return sb.toString(); + } + + /** 扫描器有效性探针：注入一个标记，必须能被同一个扫描函数命中。 */ + @Test + void scannerDetectsInjectedProbe() { + Logger logger = (Logger) LoggerFactory.getLogger("com.mydreamjob"); + String probe = "S03_SCANNER_PROBE_" + BOOTSTRAP_PHONE; + logger.error("probe {}", probe); + assertThat(capturedText()).as("扫描器必须能命中注入的探针，证明不是空转") + .contains(probe); + } + + // ── 并发冲突不得泄漏手机号 ────────────────────────────────── + + private List runConcurrently() throws Exception { + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch ready = new CountDownLatch(2); + List> futures = new ArrayList<>(); + for (int i = 0; i < 2; i++) { + futures.add(pool.submit(() -> { + ready.countDown(); + start.await(20, TimeUnit.SECONDS); + try { + runner.run(null); + return "SUCCESS"; + } catch (Throwable t) { + return t.getClass().getName(); + } + })); + } + assertThat(ready.await(20, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + List results = new ArrayList<>(); + for (Future f : futures) { + results.add(f.get(60, TimeUnit.SECONDS)); + } + pool.shutdownNow(); + return results; + } + + @Test + void adminBootstrapConcurrentConflictNeverLogsConfiguredPhone() throws Exception { + runConcurrently(); + + String log = capturedText(); + assertThat(log).as("完整管理员手机号不得出现在任何 logger（含 throwableProxy）") + .doesNotContain(BOOTSTRAP_PHONE); + assertThat(log).as("不得出现 SQL 绑定参数回显").doesNotContain("binding parameter"); + assertThat(log).as("不得出现 User.toString()").doesNotContain("User(id="); + assertThat(log).as("不得出现 password/token/secret 值") + .doesNotContainIgnoringCase("password=") + .doesNotContainIgnoringCase("secret="); + } + + @Test + void concurrentBootstrapNeverLogsPhoneAcrossAllLoggers() throws Exception { + List results = runConcurrently(); + + String log = capturedText(); + assertThat(log).doesNotContain(BOOTSTRAP_PHONE); + + // 冲突方不得把原始 Hibernate/JDBC 异常带出来 + assertThat(results).as("并发结果不得包含原始约束异常类型") + .noneMatch(r -> r.contains("DataIntegrityViolationException") + || r.contains("ConstraintViolationException") + || r.contains("SQLException")); + } + + @Test + void concurrentBootstrapProducesOneValidAdmin() throws Exception { + runConcurrently(); + + assertThat(countByPhone()).as("并发后同手机号用户恰好一行").isEqualTo(1); + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles ur JOIN users u ON u.id = ur.user_id " + + "WHERE u.phone = ? AND ur.role = 'ADMIN'", Integer.class, BOOTSTRAP_PHONE)) + .as("user_roles 中 ADMIN 恰好一行").isEqualTo(1); + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles ur JOIN users u ON u.id = ur.user_id " + + "WHERE u.phone = ? AND ur.role IN ('STUDENT','COMPANY')", Integer.class, BOOTSTRAP_PHONE)) + .as("不得出现 STUDENT/COMPANY 附加角色").isZero(); + + List> row = jdbcTemplate.queryForList( + "SELECT is_active, is_verified, password_hash FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + assertThat(row).hasSize(1); + assertThat(((Number) row.get(0).get("is_active")).intValue()).isEqualTo(1); + assertThat(((Number) row.get(0).get("is_verified")).intValue()).isEqualTo(1); + assertThat(row.get(0).get("password_hash")).as("不得设置默认密码").isNull(); + } + + @Test + void repeatedBootstrapRemainsIdempotent() { + runner.run(null); + runner.run(null); + runner.run(null); + + assertThat(countByPhone()).isEqualTo(1); + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE role='ADMIN' AND is_active=1", Integer.class)) + .isEqualTo(1); + } + + @Test + void existingStudentWithSamePhoneStillFailsWithoutPrivilegeEscalation() { + jdbcTemplate.update( + "INSERT INTO users (phone, nickname, password_hash, role, is_active, is_verified) " + + "VALUES (?, '普通学生', NULL, 'STUDENT', 1, 1)", BOOTSTRAP_PHONE); + + try { + assertThat(org.junit.jupiter.api.Assertions.assertThrows(RuntimeException.class, + () -> runner.run(null)).getMessage()) + .as("冲突文案必须固定且不含手机号") + .doesNotContain(BOOTSTRAP_PHONE); + } finally { + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + } + + assertThat(capturedText()).as("冲突路径也不得把手机号写进日志") + .doesNotContain(BOOTSTRAP_PHONE); + } + + @Test + void conflictExceptionHasNoSensitiveCause() { + jdbcTemplate.update( + "INSERT INTO users (phone, nickname, password_hash, role, is_active, is_verified) " + + "VALUES (?, '占位用户', NULL, 'STUDENT', 1, 1)", BOOTSTRAP_PHONE); + + try { + RuntimeException ex = org.junit.jupiter.api.Assertions.assertThrows(RuntimeException.class, + () -> runner.run(null)); + assertThat(ex.getMessage()).doesNotContain(BOOTSTRAP_PHONE); + assertThat(ex.getCause()).as("不得携带原始数据库异常作为 cause").isNull(); + assertThat(ex.getClass().getName()).doesNotContain("DataIntegrityViolation"); + } finally { + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + } + } + + private int countByPhone() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = ?", Integer.class, BOOTSTRAP_PHONE); + return n == null ? 0 : n; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapDisabledByDefaultTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapDisabledByDefaultTest.java new file mode 100644 index 0000000..b1a0356 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapDisabledByDefaultTest.java @@ -0,0 +1,41 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AdminBootstrapProperties; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ApplicationContext; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.test.context.ActiveProfiles; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * S03-A：不显式开启时，初始化器**不得**被装配，普通启动不会隐式创建管理员。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AdminBootstrapDisabledByDefaultTest { + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private ApplicationContext context; + + @Autowired + private AdminBootstrapProperties properties; + + @Test + void runnerIsNotAssembledByDefault() { + assertThat(context.getBeanNamesForType(AdminBootstrapRunner.class)) + .as("默认（开关未开启）不得装配管理员初始化器").isEmpty(); + } + + @Test + void defaultPropertiesAreDisabledAndHaveNoPhone() { + assertThat(properties.getEnabled()).isEqualTo("false"); + assertThat(properties.getPhone()).isEmpty(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapIntegrationTest.java new file mode 100644 index 0000000..d4934ef --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapIntegrationTest.java @@ -0,0 +1,235 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AdminBootstrapProperties; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ApplicationContext; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.List; +import java.util.concurrent.*; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * S03-A 管理员初始化的真实上下文验证：条件装配、真实 H2 建号、 + * {@code users.role} 与 {@code user_roles} 一致、幂等、并发冲突。 + */ +@SpringBootTest(properties = { + "app.bootstrap.admin.enabled=true", + "app.bootstrap.admin.phone=13800000777", + "app.bootstrap.admin.nickname=引导管理员", +}) +@ActiveProfiles("integration-test") +class AdminBootstrapIntegrationTest { + + private static final String BOOTSTRAP_PHONE = "13800000777"; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private ApplicationContext context; + + @Autowired + private AdminBootstrapRunner runner; + + @Autowired + private AdminBootstrapProperties properties; + + @Autowired + private UserRepository userRepository; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private ch.qos.logback.core.read.ListAppender appender; + private ch.qos.logback.classic.Logger appLogger; + /** 用例开始前被临时停用、结束后需恢复的其他 ADMIN id。 */ + private final java.util.List deactivatedAdmins = new java.util.ArrayList<>(); + + @BeforeEach + void clearBootstrapArtifacts() { + // 清掉本测试可能留下的引导账号，使「无活动 ADMIN」前置条件成立 + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", + BOOTSTRAP_PHONE); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + + // 其他测试类可能留下活动 ADMIN，破坏「无活动 ADMIN」前置条件。这里临时停用它们， + // 用例结束恢复，使本类的断言不依赖测试执行顺序。 + deactivatedAdmins.clear(); + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE role = 'ADMIN' AND is_active = 1", Long.class)) { + jdbcTemplate.update("UPDATE users SET is_active = 0 WHERE id = ?", id); + deactivatedAdmins.add(id); + } + + appLogger = (ch.qos.logback.classic.Logger) + org.slf4j.LoggerFactory.getLogger("com.mydreamjob"); + appender = new ch.qos.logback.core.read.ListAppender<>(); + appender.start(); + appLogger.addAppender(appender); + appLogger.setLevel(ch.qos.logback.classic.Level.TRACE); + } + + @AfterEach + void tearDown() { + if (appLogger != null && appender != null) { + appLogger.detachAppender(appender); + appender.stop(); + } + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", + BOOTSTRAP_PHONE); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + + // 恢复本用例开始前临时停用的其他 ADMIN + for (Long id : deactivatedAdmins) { + jdbcTemplate.update("UPDATE users SET is_active = 1 WHERE id = ?", id); + } + deactivatedAdmins.clear(); + } + + private long activeAdmins() { + return userRepository.countByRoleAndActiveTrue(User.Role.ADMIN); + } + + @Test + void runnerIsAssembledWhenPropertyIsTrue() { + assertThat(runner).as("开关为 true 时应装配初始化器").isNotNull(); + assertThat(properties.getNickname()).isEqualTo("引导管理员"); + } + + @Test + void createsAdminConsistentAcrossUsersAndUserRoles() { + runner.run(null); + + List> rows = jdbcTemplate.queryForList( + "SELECT id, role, is_active, is_verified FROM users WHERE phone = ?", BOOTSTRAP_PHONE); + assertThat(rows).hasSize(1); + assertThat(rows.get(0).get("role")).isEqualTo("ADMIN"); + assertThat(((Number) rows.get(0).get("is_active")).intValue()).isEqualTo(1); + assertThat(((Number) rows.get(0).get("is_verified")).intValue()).isEqualTo(1); + + Long id = ((Number) rows.get(0).get("id")).longValue(); + List roles = jdbcTemplate.queryForList( + "SELECT role FROM user_roles WHERE user_id = ?", String.class, id); + assertThat(roles).as("user_roles 必须与 users.role 一致").containsExactly("ADMIN"); + + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = ?", Integer.class, BOOTSTRAP_PHONE)).isEqualTo(1); + } + + @Test + void repeatedRunIsIdempotent() { + runner.run(null); + long afterFirst = activeAdmins(); + + runner.run(null); + runner.run(null); + + assertThat(activeAdmins()).as("重复启动不得创建第二个管理员").isEqualTo(afterFirst); + assertThat(countByPhone()).isEqualTo(1); + } + + /** + * 并发初始化的部署契约（**方案 A**）：一个线程创建成功，另一个重新查询后判定现存账号 + * 正是本次配置要求的合法 ADMIN，返回**幂等成功** —— 两个调用均不泄漏异常，且最终只有 + * 一条 users 与一条 ADMIN user_roles。不使用任何 JVM 锁。 + */ + @Test + void concurrentBootstrapCannotCreateTwoAdmins() throws Exception { + // 前置条件：不得已有活动 ADMIN，否则初始化器会按设计跳过，本用例失去意义。 + assertThat(activeAdmins()).as("并发用例前置条件：不得已有活动 ADMIN").isZero(); + + int threads = 2; + ExecutorService pool = Executors.newFixedThreadPool(threads); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch ready = new CountDownLatch(threads); + CountDownLatch finished = new CountDownLatch(threads); + + List> outcomes = new java.util.ArrayList<>(); + for (int i = 0; i < threads; i++) { + outcomes.add(pool.submit(() -> { + ready.countDown(); + start.await(20, TimeUnit.SECONDS); // 屏障：两线程同时开始 + try { + runner.run(null); + return "SUCCESS"; // 方案 A：创建成功或幂等成功 + } catch (Throwable t) { + return "UNKNOWN:" + t.getClass().getName(); + } finally { + finished.countDown(); + } + })); + } + + assertThat(ready.await(20, TimeUnit.SECONDS)).as("两线程都已到达屏障").isTrue(); + start.countDown(); + + List results = new java.util.ArrayList<>(); + for (Future f : outcomes) { + results.add(f.get(60, TimeUnit.SECONDS)); + } + pool.shutdownNow(); + assertThat(finished.await(5, TimeUnit.SECONDS)).as("两线程都已结束").isTrue(); + + long success = results.stream().filter("SUCCESS"::equals).count(); + long unknown = results.stream().filter(r -> r.startsWith("UNKNOWN")).count(); + + // 方案 A：一个创建、一个幂等成功 —— 两个调用都必须成功，且都不得抛出异常。 + assertThat(success).as("两个调用都应成功（实测 " + results + "）").isEqualTo(2); + assertThat(unknown).as("未知异常必须为 0（实测 " + results + "）").isZero(); + + // 最终数据状态 + assertThat(countByPhone()).as("同手机号用户恰好 1 个").isEqualTo(1); + assertThat(activeAdmins()).as("活动 ADMIN 恰好 1 个").isEqualTo(1); + assertThat(adminRoleRows()).as("user_roles 中 ADMIN 恰好 1 行").isEqualTo(1); + assertThat(templateHash()).as("不得设置默认密码").isNull(); + assertThat(otherRoleRows()).as("不得出现 STUDENT/COMPANY 角色").isZero(); + + // 异常与日志不得泄漏手机号、SQL 参数或用户对象 + String log = logAppenderText(); + assertThat(log).as("日志不得包含手机号").doesNotContain(BOOTSTRAP_PHONE); + assertThat(log).as("日志不得包含 SQL 参数占位").doesNotContain("bind"); + assertThat(log).as("日志不得包含用户对象").doesNotContain("User(id="); + } + + private int adminRoleRows() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles ur JOIN users u ON u.id = ur.user_id " + + "WHERE u.phone = ? AND ur.role = 'ADMIN'", Integer.class, BOOTSTRAP_PHONE); + return n == null ? 0 : n; + } + + private int otherRoleRows() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles ur JOIN users u ON u.id = ur.user_id " + + "WHERE u.phone = ? AND ur.role IN ('STUDENT','COMPANY')", + Integer.class, BOOTSTRAP_PHONE); + return n == null ? 0 : n; + } + + private String templateHash() { + return jdbcTemplate.queryForObject( + "SELECT password_hash FROM users WHERE phone = ?", String.class, BOOTSTRAP_PHONE); + } + + private String logAppenderText() { + return appender == null ? "" + : appender.list.stream() + .map(ch.qos.logback.classic.spi.ILoggingEvent::getFormattedMessage) + .collect(java.util.stream.Collectors.joining("\n")); + } + + private int countByPhone() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = ?", Integer.class, BOOTSTRAP_PHONE); + return n == null ? 0 : n; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapRunnerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapRunnerTest.java new file mode 100644 index 0000000..63bda52 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapRunnerTest.java @@ -0,0 +1,262 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import com.mydreamjob.config.AdminBootstrapProperties; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.slf4j.LoggerFactory; + +import java.util.List; +import java.util.Optional; +import java.util.stream.Collectors; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +/** + * S03-A 管理员初始化的规则分支（设计 §3.2）。 + * + *

    真实 {@link AdminBootstrapRunner} + Mock 仓储，逐条覆盖任务书 §四 要求的场景。 + * 日志脱敏用真实 Logback 捕获验证。

    + */ +@ExtendWith(MockitoExtension.class) +class AdminBootstrapRunnerTest { + + private static final String PHONE = "13800000009"; + private static final String OTHER_PHONE = "13800000008"; + + @Mock private UserRepository userRepository; + /** S03 整改后创建走独立事务组件（JdbcTemplate），单测以 mock 替代。 */ + @Mock private AdminBootstrapCreator creator; + + private AdminBootstrapProperties properties; + private AdminBootstrapRunner runner; + + private ListAppender appender; + private Logger appLogger; + + @BeforeEach + void setUp() { + properties = new AdminBootstrapProperties(); + runner = new AdminBootstrapRunner(properties, userRepository, creator); + + appLogger = (Logger) LoggerFactory.getLogger("com.mydreamjob"); + appender = new ListAppender<>(); + appender.start(); + appLogger.addAppender(appender); + appLogger.setLevel(Level.TRACE); + } + + @AfterEach + void tearDown() { + if (appLogger != null && appender != null) { + appLogger.detachAppender(appender); + appender.stop(); + } + } + + private String capturedLog() { + return appender.list.stream().map(ILoggingEvent::getFormattedMessage).collect(Collectors.joining("\n")); + } + + private void enableWith(String phone) { + properties.setEnabled("true"); + properties.setPhone(phone); + } + + // ── 关闭 / 未启用 ────────────────────────────────────────── + + @Test + void disabledDoesNothing() { + properties.setEnabled("false"); + properties.setPhone(PHONE); + + runner.run(null); + + verifyNoInteractions(userRepository); + verifyNoInteractions(creator); + } + + @Test + void nonLiteralTrueValueDoesNotEnable() { + // 只有字面量 "true" 才算启用；大小写变体一律不生效。 + for (String value : new String[]{"TRUE", "True", "yes", "1", "on", " true "}) { + properties.setEnabled(value); + properties.setPhone(PHONE); + runner.run(null); + } + verifyNoInteractions(userRepository); + verifyNoInteractions(creator); + } + + // ── 手机号校验 ───────────────────────────────────────────── + + @Test + void missingPhoneFailsAtStartup() { + properties.setEnabled("true"); + properties.setPhone(""); + + IllegalStateException ex = assertThrows(IllegalStateException.class, () -> runner.run(null)); + assertEquals(AdminBootstrapRunner.ERROR_INVALID_PHONE, ex.getMessage()); + verifyNoInteractions(userRepository); + verifyNoInteractions(creator); + } + + @Test + void invalidPhoneFailsAtStartup() { + for (String bad : new String[]{"123", "1380000000", "138000000012", "1380000000a", " 1380000000a "}) { + properties.setEnabled("true"); + properties.setPhone(bad); + IllegalStateException ex = assertThrows(IllegalStateException.class, () -> runner.run(null)); + assertEquals(AdminBootstrapRunner.ERROR_INVALID_PHONE, ex.getMessage()); + } + verifyNoInteractions(userRepository); + verifyNoInteractions(creator); + } + + // ── 已有活动 ADMIN ───────────────────────────────────────── + + @Test + void existingActiveAdminIsSkippedWithoutSideEffects() { + enableWith(PHONE); + when(userRepository.countByRoleAndActiveTrue(User.Role.ADMIN)).thenReturn(1L); + + runner.run(null); + + verify(creator, never()).createAdmin(any(), any()); + assertTrue(capturedLog().contains("admin bootstrap skipped"), "应输出固定跳过文本"); + } + + // ── 手机号已被占用 ───────────────────────────────────────── + + @Test + void phoneBelongingToStudentFails() { + enableWith(PHONE); + when(creator.findByPhone(PHONE)).thenReturn(Optional.of( + new AdminBootstrapCreator.BootstrapUser(9L, "STUDENT", true, true, true, List.of("STUDENT")))); + + IllegalStateException ex = assertThrows(IllegalStateException.class, () -> runner.run(null)); + assertEquals(AdminBootstrapRunner.ERROR_PHONE_IN_USE, ex.getMessage()); + verify(creator, never()).createAdmin(any(), any()); + } + + @Test + void phoneBelongingToCompanyFails() { + enableWith(PHONE); + when(creator.findByPhone(PHONE)).thenReturn(Optional.of( + new AdminBootstrapCreator.BootstrapUser(9L, "COMPANY", true, true, true, List.of("COMPANY")))); + + assertThrows(IllegalStateException.class, () -> runner.run(null)); + verify(creator, never()).createAdmin(any(), any()); + } + + @Test + void phoneBelongingToInactiveUserFailsAndIsNotRevived() { + enableWith(PHONE); + when(creator.findByPhone(PHONE)).thenReturn(Optional.of( + new AdminBootstrapCreator.BootstrapUser(9L, "ADMIN", false, true, true, List.of("ADMIN")))); + + assertThrows(IllegalStateException.class, () -> runner.run(null)); + verify(creator, never()).createAdmin(any(), any()); + } + + @Test + void activeAdminMissingAdminRoleCannotBypassStrictIdempotencyCheck() { + assertInvalidExistingAdminRejected( + new AdminBootstrapCreator.BootstrapUser(9L, "ADMIN", true, true, true, List.of())); + } + + @Test + void activeAdminWithAdditionalRoleCannotBypassStrictIdempotencyCheck() { + assertInvalidExistingAdminRejected( + new AdminBootstrapCreator.BootstrapUser( + 9L, "ADMIN", true, true, true, List.of("ADMIN", "STUDENT"))); + } + + @Test + void activeAdminWithPasswordCannotBypassStrictIdempotencyCheck() { + assertInvalidExistingAdminRejected( + new AdminBootstrapCreator.BootstrapUser(9L, "ADMIN", true, true, false, List.of("ADMIN"))); + } + + // ── 正常创建 ─────────────────────────────────────────────── + + @Test + void createsActiveVerifiedAdminWithConsistentRole() { + enableWith(PHONE); + when(userRepository.countByRoleAndActiveTrue(User.Role.ADMIN)).thenReturn(0L); + when(creator.findByPhone(PHONE)).thenReturn(Optional.empty()); + when(creator.createAdmin(any(), any())).thenReturn(AdminBootstrapCreator.CreateResult.CREATED); + + runner.run(null); + + // 创建由独立事务组件完成（JdbcTemplate），单测只验证编排参数； + // 「users.role / user_roles 一致、active、verified、password_hash 为空」由 + // AdminBootstrapIntegrationTest 与 AdminBootstrapConcurrencyLoggingTest 在真实库上断言。 + verify(creator).createAdmin(eq(PHONE), any()); + verify(userRepository, never()).save(any()); + } + + @Test + void customNicknameIsApplied() { + enableWith(PHONE); + properties.setNickname("运维管理员"); + when(userRepository.countByRoleAndActiveTrue(User.Role.ADMIN)).thenReturn(0L); + when(creator.findByPhone(PHONE)).thenReturn(Optional.empty()); + when(creator.createAdmin(any(), any())).thenReturn(AdminBootstrapCreator.CreateResult.CREATED); + + runner.run(null); + + verify(creator).createAdmin(PHONE, "运维管理员"); + } + + // ── 日志脱敏 ─────────────────────────────────────────────── + + @Test + void logNeverContainsPhone() { + enableWith(PHONE); + when(userRepository.countByRoleAndActiveTrue(User.Role.ADMIN)).thenReturn(0L); + when(creator.findByPhone(OTHER_PHONE)).thenReturn(Optional.empty()); + when(creator.createAdmin(any(), any())).thenReturn(AdminBootstrapCreator.CreateResult.CREATED); + properties.setPhone(OTHER_PHONE); + + runner.run(null); + + String log = capturedLog(); + assertThatNotContains(log, OTHER_PHONE); + assertThatNotContains(log, PHONE); + } + + @Test + void failureMessagesNeverContainPhone() { + enableWith(PHONE); + when(creator.findByPhone(PHONE)).thenReturn(Optional.of( + new AdminBootstrapCreator.BootstrapUser(9L, "STUDENT", true, true, true, List.of("STUDENT")))); + + IllegalStateException ex = assertThrows(IllegalStateException.class, () -> runner.run(null)); + assertThatNotContains(ex.getMessage(), PHONE); + } + + private static void assertThatNotContains(String haystack, String needle) { + assertFalse(haystack != null && haystack.contains(needle), + "输出不得包含手机号"); + } + + private void assertInvalidExistingAdminRejected(AdminBootstrapCreator.BootstrapUser existing) { + enableWith(PHONE); + when(creator.findByPhone(PHONE)).thenReturn(Optional.of(existing)); + + IllegalStateException ex = assertThrows(IllegalStateException.class, () -> runner.run(null)); + + assertEquals(AdminBootstrapRunner.ERROR_PHONE_IN_USE, ex.getMessage()); + verify(creator, never()).createAdmin(any(), any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapTransactionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapTransactionTest.java new file mode 100644 index 0000000..5361a1d --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdminBootstrapTransactionTest.java @@ -0,0 +1,112 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.dao.DataAccessResourceFailureException; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.transaction.PlatformTransactionManager; + +import javax.sql.DataSource; +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.startsWith; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.spy; + +/** + * S03 定向整改：{@code users} 与 {@code user_roles} 必须**同事务**提交 —— + * 角色写入失败时用户创建整体回滚，不得留下「有用户、无角色」的半个管理员。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AdminBootstrapTransactionTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(8600); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private DataSource dataSource; + + @Autowired + private PlatformTransactionManager transactionManager; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private String phone; + + @BeforeEach + void setUp() { + phone = "13" + String.format("%09d", PHONE_SEQ.incrementAndGet()); + } + + @AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", phone); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", phone); + } + + private int userRows() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = ?", Integer.class, phone); + return n == null ? 0 : n; + } + + private int roleRows() { + Integer n = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles ur JOIN users u ON u.id = ur.user_id WHERE u.phone = ?", + Integer.class, phone); + return n == null ? 0 : n; + } + + @Test + void successfulCreateWritesUserAndRoleInSameTransaction() { + AdminBootstrapCreator creator = new AdminBootstrapCreator(jdbcTemplate, transactionManager); + + assertThat(creator.createAdmin(phone, "事务管理员")) + .isEqualTo(AdminBootstrapCreator.CreateResult.CREATED); + assertThat(userRows()).as("用户恰好一行").isEqualTo(1); + assertThat(roleRows()).as("user_roles 恰好一行").isEqualTo(1); + } + + @Test + void roleInsertFailureRollsBackUser() { + JdbcTemplate failing = spy(new JdbcTemplate(dataSource)); + // 让 user_roles 的写入失败，users 的写入成功 —— 验证两者同事务。 + doThrow(new DataAccessResourceFailureException("simulated role insert failure")) + .when(failing).update(startsWith("INSERT INTO user_roles"), any(Object[].class)); + + AdminBootstrapCreator creator = new AdminBootstrapCreator(failing, transactionManager); + + assertThat(creator.createAdmin(phone, "回滚管理员")) + .as("角色写入失败必须返回 CONFLICT，而不是抛出携带原始信息的异常") + .isEqualTo(AdminBootstrapCreator.CreateResult.CONFLICT); + + assertThat(userRows()).as("users 必须随角色失败整体回滚").isZero(); + assertThat(roleRows()).isZero(); + } + + @Test + void concurrentCreateLeavesExactlyOneUserAndOneRole() { + AdminBootstrapCreator creator = new AdminBootstrapCreator(jdbcTemplate, transactionManager); + + AdminBootstrapCreator.CreateResult first = creator.createAdmin(phone, "并发甲"); + AdminBootstrapCreator.CreateResult second = creator.createAdmin(phone, "并发乙"); + + assertThat(List.of(first, second)) + .as("第二次同号创建必须被识别为冲突").contains(AdminBootstrapCreator.CreateResult.CONFLICT); + assertThat(userRows()).as("并发后用户恰好一行").isEqualTo(1); + assertThat(roleRows()).as("并发后 ADMIN 角色恰好一行").isEqualTo(1); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdvancingClock.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdvancingClock.java new file mode 100644 index 0000000..0e3b3e1 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AdvancingClock.java @@ -0,0 +1,55 @@ +package com.mydreamjob.auth; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneId; +import java.util.concurrent.atomic.AtomicInteger; + +/** + * 测试专用时钟：第一次 {@link #instant()} 返回 T，之后返回一个**明显不同**的时间（T + 偏移）。 + * + *

    用途：证明认证入口只读取一次 Clock。若某个入口读了两次，第二次取到的是 T+偏移， + * 于是 JWT {@code iat}/{@code exp}、数据库 {@code created_at}/{@code expired_at} + * 或审计时间就会出现两个不同的值，测试即可捕获。

    + * + *

    固定使用项目业务时区 {@code Asia/Shanghai}，不依赖系统默认时区。

    + */ +class AdvancingClock extends Clock { + + static final ZoneId ZONE = ZoneId.of("Asia/Shanghai"); + + private final Instant first; + private final Instant subsequent; + private final AtomicInteger calls = new AtomicInteger(); + + AdvancingClock(Instant first, Instant subsequent) { + this.first = first; + this.subsequent = subsequent; + } + + @Override + public ZoneId getZone() { + return ZONE; + } + + @Override + public Clock withZone(ZoneId zone) { + return this; + } + + @Override + public Instant instant() { + int call = calls.incrementAndGet(); + return call == 1 ? first : subsequent; + } + + /** 已读取次数。 */ + int callCount() { + return calls.get(); + } + + /** 每个入口开始前重置，便于分别断言。 */ + void reset() { + calls.set(0); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshConcurrencyIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshConcurrencyIntegrationTest.java new file mode 100644 index 0000000..eb462e3 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshConcurrencyIntegrationTest.java @@ -0,0 +1,319 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import com.mydreamjob.auth.AuthSessionService.SessionTokens; + +import java.time.Instant; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.*; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * S02 并发刷新与登出竞态（设计 D17，任务书 §十八）。 + * + *

    真实 Service + Repository + 事务 + EntityManager，两个线程用 CountDownLatch + * 同时开始，不 Mock 条件更新。

    + * + *

    独立复验整改后：重放被识别时要求该会话**活动 Token 数为 0**（而不是 ≤1）， + * 且并发胜出方刚签发的 Access Token 也必须失效。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AuthRefreshConcurrencyIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9600); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AuthTokenRepository authTokenRepository; + + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = userRepository.save(User.builder() + .phone("16" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 并发") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + if (userId != null) { + userRepository.deleteById(userId); + } + } + + private AuthSessionService.SessionTokens newSession() { + return authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + } + + /** 该会话下仍满足"活动"条件的 Refresh 记录数。 */ + private long activeCount(String sessionId) { + return authTokenRepository.countActiveSessionTokens(userId, sessionId, AuthSessionService.toLocal(Instant.now())); + } + + private record Attempt(boolean success, SessionTokens tokens, Throwable error) { + } + + private record AttemptOutcome(List attempts) { + long successes() { + return attempts.stream().filter(Attempt::success).count(); + } + + List failures() { + return attempts.stream().filter(a -> !a.success()).map(Attempt::error).toList(); + } + } + + private AttemptOutcome refreshConcurrently(String refreshToken) throws Exception { + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch ready = new CountDownLatch(2); + List> futures = new ArrayList<>(); + for (int i = 0; i < 2; i++) { + futures.add(pool.submit(() -> { + ready.countDown(); + start.await(10, TimeUnit.SECONDS); + try { + return new Attempt(true, authSessionService.refresh(refreshToken, Instant.now(), null), null); + } catch (Throwable t) { + return new Attempt(false, null, t); + } + })); + } + assertThat(ready.await(10, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + List results = new ArrayList<>(); + for (Future f : futures) { + results.add(f.get(30, TimeUnit.SECONDS)); + } + pool.shutdownNow(); + return new AttemptOutcome(results); + } + + private void assertOnlyBusinessFailure(AttemptOutcome outcome) { + outcome.failures().forEach(t -> assertThat(t) + .as("并发失败方只能是既定的业务拒绝，不得泄漏锁异常或 500") + .isInstanceOf(InvalidTokenException.class)); + } + + // ── 并发刷新：恰好一个成功 ─────────────────────────────────── + + @Test + void concurrentRefreshOnlyOneRequestSucceeds() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + AttemptOutcome outcome = refreshConcurrently(session.refreshToken()); + + assertThat(outcome.successes()).as("同一 Refresh Token 最多一个刷新成功").isEqualTo(1); + assertOnlyBusinessFailure(outcome); + } + + // ── 重放处置：整个会话必须被撤销 ───────────────────────────── + + @Test + void concurrentRefreshReplayRevokesEntireSession() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + AttemptOutcome outcome = refreshConcurrently(session.refreshToken()); + assertThat(outcome.successes()).isEqualTo(1); + assertOnlyBusinessFailure(outcome); + + assertThat(activeCount(session.sessionId())) + .as("重放处置后该会话不得残留任何活动 Refresh Token") + .isZero(); + assertThat(authSessionService.isSessionActive(userId, session.sessionId(), Instant.now())) + .as("该会话必须处于失效状态") + .isFalse(); + } + + @Test + void concurrentRefreshLeavesAtMostOneActiveSuccessor() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + AttemptOutcome outcome = refreshConcurrently(session.refreshToken()); + assertOnlyBusinessFailure(outcome); + + List active = authTokenRepository + .findByUserIdAndSessionIdOrderByIdAsc(userId, session.sessionId()).stream() + .filter(t -> !Boolean.TRUE.equals(t.getRevoked())) + .filter(t -> t.getConsumedAt() == null) + .toList(); + assertThat(active).as("不得留下两个活动后继 Token（重放后应为 0）").isEmpty(); + } + + @Test + void concurrentRefreshInvalidatesWinningAccessTokenAfterReplay() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + AttemptOutcome outcome = refreshConcurrently(session.refreshToken()); + assertOnlyBusinessFailure(outcome); + + // 并发胜出方刚签发的 Access Token 也必须失效 + String winningAccess = outcome.attempts().stream() + .filter(Attempt::success).map(a -> a.tokens().accessToken()).findFirst().orElseThrow(); + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + winningAccess)) + .andExpect(status().isUnauthorized()); + + // 原 Access Token 同样失效 + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + session.accessToken())) + .andExpect(status().isUnauthorized()); + } + + @Test + void concurrentReplayDoesNotRevokeOtherSession() throws Exception { + AuthSessionService.SessionTokens victim = newSession(); + AuthSessionService.SessionTokens other = newSession(); + + AttemptOutcome outcome = refreshConcurrently(victim.refreshToken()); + assertOnlyBusinessFailure(outcome); + assertThat(activeCount(victim.sessionId())).isZero(); + + assertThat(authSessionService.isSessionActive(userId, other.sessionId(), Instant.now())) + .as("其他设备会话不受影响").isTrue(); + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + other.accessToken())) + .andExpect(status().isOk()); + } + + @Test + void concurrentRefreshDoesNotLeakLockExceptionAs500() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + AttemptOutcome outcome = refreshConcurrently(session.refreshToken()); + + // 失败方不得出现锁异常、乐观锁异常或任何非业务异常 + outcome.failures().forEach(t -> assertThat(t) + .as("不得出现未处理的锁异常或 500 级异常") + .isNotInstanceOf(org.springframework.dao.DataAccessException.class) + .isInstanceOf(InvalidTokenException.class)); + } + + // ── 重放（串行）与其他会话 ─────────────────────────────────── + + @Test + void refreshReplayRevokesOnlyCurrentSession() throws Exception { + AuthSessionService.SessionTokens victim = newSession(); + AuthSessionService.SessionTokens other = newSession(); + assertThat(victim.sessionId()).isNotEqualTo(other.sessionId()); + + authSessionService.refresh(victim.refreshToken(), Instant.now(), null); + try { + authSessionService.refresh(victim.refreshToken(), Instant.now(), null); + } catch (InvalidTokenException expected) { + // 预期 + } + + assertThat(activeCount(victim.sessionId())).isZero(); + assertThat(activeCount(other.sessionId())).isPositive(); + } + + @Test + void differentSessionsRefreshIndependently() throws Exception { + AuthSessionService.SessionTokens a = newSession(); + AuthSessionService.SessionTokens b = newSession(); + + authSessionService.refresh(a.refreshToken(), Instant.now(), null); + authSessionService.refresh(b.refreshToken(), Instant.now(), null); + + assertThat(authSessionService.isSessionActive(userId, a.sessionId(), Instant.now())).isTrue(); + assertThat(authSessionService.isSessionActive(userId, b.sessionId(), Instant.now())).isTrue(); + } + + // ── 登出与刷新竞态 ────────────────────────────────────────── + + @Test + void logoutRacingWithRefreshLeavesNoActiveSuccessorWithoutCleanupLogout() throws Exception { + AuthSessionService.SessionTokens session = newSession(); + + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch ready = new CountDownLatch(2); + + Future refresher = pool.submit(() -> { + ready.countDown(); + try { + start.await(10, TimeUnit.SECONDS); + authSessionService.refresh(session.refreshToken(), Instant.now(), null); + return null; + } catch (InvalidTokenException expected) { + // 与登出竞争时唯一的预期业务异常 + return expected; + } catch (Throwable unexpected) { + return unexpected; + } + }); + Future logger = pool.submit(() -> { + ready.countDown(); + try { + start.await(10, TimeUnit.SECONDS); + authSessionService.logout(userId, session.sessionId(), Instant.now(), null); + return null; + } catch (Throwable unexpected) { + return unexpected; + } + }); + + assertThat(ready.await(10, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + Throwable refreshError = refresher.get(30, TimeUnit.SECONDS); + Throwable logoutError = logger.get(30, TimeUnit.SECONDS); + pool.shutdownNow(); + + // 只允许既定的业务异常；登出本身不应失败 + assertThat(logoutError).as("登出不应抛异常").isNull(); + if (refreshError != null) { + assertThat(refreshError) + .as("刷新失败时只能是 InvalidTokenException") + .isInstanceOf(InvalidTokenException.class); + } + + // 线程结束后直接检查最终状态：不得再补一次 logout（那会掩盖竞争缺陷） + assertThat(activeCount(session.sessionId())) + .as("登出与刷新竞争后不得残留活动 Token").isZero(); + assertThat(authSessionService.isSessionActive(userId, session.sessionId(), Instant.now())).isFalse(); + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + session.accessToken())) + .andExpect(status().isUnauthorized()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshControllerTest.java new file mode 100644 index 0000000..2af6f9f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshControllerTest.java @@ -0,0 +1,138 @@ +package com.mydreamjob.auth; + +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.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * S02 刷新接口的入参校验（设计 9.2，任务书 §十四）。 + * + *

    请求体只允许 {@code refreshToken}，且必须有合理的必填与长度约束。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AuthRefreshControllerTest { + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + + private static String body(String json) { + return json; + } + + @Test + void missingRefreshTokenIsRejected() throws Exception { + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(body("{}"))) + .andExpect(status().is4xxClientError()); + } + + @Test + void blankRefreshTokenIsRejected() throws Exception { + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(body("{\"refreshToken\":\" \"}"))) + .andExpect(status().is4xxClientError()); + } + + @Test + void oversizedRefreshTokenIsRejected() throws Exception { + String huge = "x".repeat(5000); + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(body("{\"refreshToken\":\"" + huge + "\"}"))) + .andExpect(status().is4xxClientError()); + } + + @Test + void refreshEndpointIsReachableWithoutAuthentication() throws Exception { + // permitAll 表示可进入 Controller；是否成功仍取决于 Token 校验。 + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(body("{\"refreshToken\":\"not-a-valid-token\"}"))) + .andExpect(status().isUnauthorized()); + } + + @Test + void logoutRequiresAuthentication() throws Exception { + mockMvc.perform(post("/auth/logout")) + .andExpect(status().isUnauthorized()); + } + + // ── OpenAPI 契约（S02 新增两个 operation）──────────────────── + + @Test + void openApiExposesExactlyTheTwoNewAuthOperations() throws Exception { + String json = mockMvc.perform(org.springframework.test.web.servlet.request.MockMvcRequestBuilders + .get("/v3/api-docs")) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + + com.fasterxml.jackson.databind.JsonNode root = new com.fasterxml.jackson.databind.ObjectMapper().readTree(json); + com.fasterxml.jackson.databind.JsonNode paths = root.path("paths"); + com.fasterxml.jackson.databind.JsonNode components = root.path("components").path("schemas"); + + org.assertj.core.api.Assertions.assertThat(paths.has("/auth/refresh")).isTrue(); + org.assertj.core.api.Assertions.assertThat(paths.has("/auth/logout")).isTrue(); + + com.fasterxml.jackson.databind.JsonNode refresh = paths.path("/auth/refresh").path("post"); + com.fasterxml.jackson.databind.JsonNode logout = paths.path("/auth/logout").path("post"); + org.assertj.core.api.Assertions.assertThat(refresh.isMissingNode()).isFalse(); + org.assertj.core.api.Assertions.assertThat(logout.isMissingNode()).isFalse(); + + // 刷新请求体只允许 refreshToken + com.fasterxml.jackson.databind.JsonNode bodySchema = deref( + refresh.path("requestBody").path("content").path("application/json").path("schema"), components); + java.util.List properties = new java.util.ArrayList<>(); + bodySchema.path("properties").fieldNames().forEachRemaining(properties::add); + org.assertj.core.api.Assertions.assertThat(properties) + .as("刷新请求体只允许 refreshToken").containsExactly("refreshToken"); + + // 登出无请求体 + org.assertj.core.api.Assertions.assertThat(logout.has("requestBody")) + .as("登出不得声明 requestBody").isFalse(); + + // 刷新响应不得泄漏数据库字段 + String refreshJson = refresh.toString(); + for (String forbidden : new String[]{"tokenHash", "refreshTokenHash", "sessionId", "phone", "secret"}) { + org.assertj.core.api.Assertions.assertThat(refreshJson) + .as("刷新响应 schema 不得包含 " + forbidden).doesNotContain(forbidden); + } + + // 登录原有字段不得删除 + com.fasterxml.jackson.databind.JsonNode login = paths.path("/auth/login").path("post"); + org.assertj.core.api.Assertions.assertThat(login.isMissingNode()).isFalse(); + + // 开发辅助：-Ds02.openapi.snapshot=<目录> 时导出快照 + String snapshotDir = System.getProperty("s02.openapi.snapshot"); + if (snapshotDir != null && !snapshotDir.isBlank()) { + java.nio.file.Files.write( + java.nio.file.Paths.get(snapshotDir, "openapi-rc.json"), + json.getBytes(java.nio.charset.StandardCharsets.UTF_8)); + } + } + + private static com.fasterxml.jackson.databind.JsonNode deref(com.fasterxml.jackson.databind.JsonNode node, + com.fasterxml.jackson.databind.JsonNode components) { + if (node.has("$ref")) { + String ref = node.path("$ref").asText(); + String name = ref.substring(ref.lastIndexOf('/') + 1); + return components.path(name); + } + return node; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshHttpIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshHttpIntegrationTest.java new file mode 100644 index 0000000..6a6b38d --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthRefreshHttpIntegrationTest.java @@ -0,0 +1,212 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.Instant; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.not; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * S02 刷新接口的 HTTP 语义（设计 D08 / D09 / D11，任务书 §十四 与 §十九 HTTP 组）。 + * + *

    覆盖：匿名携带有效 Refresh 刷新成功、轮换后旧 Token 永久失效、 + * 二次使用触发重放处置并撤销当前会话、以及错误响应不泄漏。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AuthRefreshHttpIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9400); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AuthTokenRepository authTokenRepository; + + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = userRepository.save(User.builder() + .phone("17" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 刷新") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + if (userId != null) { + userRepository.deleteById(userId); + } + } + + private AuthSessionService.SessionTokens newSession() { + return authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + } + + private String refreshBody(String refreshToken) { + return "{\"refreshToken\":\"" + refreshToken + "\"}"; + } + + // ── 正常轮换 ──────────────────────────────────────────────── + + @Test + void anonymousRefreshWithValidTokenRotatesPair() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.accessToken").isNotEmpty()) + .andExpect(jsonPath("$.data.refreshToken").isNotEmpty()) + .andExpect(jsonPath("$.data.expiresIn").value(86400)) + // 响应不得回显数据库字段或会话标识 + .andExpect(content().string(not(containsString("sessionId")))) + .andExpect(content().string(not(containsString("tokenHash")))); + } + + @Test + void rotatedAccessTokenWorksAndOldRefreshIsConsumed() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + String body = mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + + String newAccess = body.replaceAll(".*\"accessToken\":\"([^\"]+)\".*", "$1"); + + // 新的 Access Token 可用 + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + newAccess)) + .andExpect(status().isOk()); + + // 旧 Refresh Token 已被消费 + AuthToken consumed = authTokenRepository.findTopByTokenHashOrderByIdDesc( + new AuthTokenHasher(hashProperties()).hash(first.refreshToken())).orElseThrow(); + org.junit.jupiter.api.Assertions.assertNotNull(consumed.getConsumedAt()); + } + + // ── 二次使用 / 重放 ──────────────────────────────────────── + + @Test + void sameRefreshTokenCannotBeConsumedTwice() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isOk()); + + // 二次使用同一 Refresh Token → 401，且不说明已消费/已撤销 + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString("consumed")))) + .andExpect(content().string(not(containsString("revoked")))) + .andExpect(content().string(not(containsString("sessionId")))); + } + + @Test + void replayRevokesCurrentSessionSoOldAccessStopsWorking() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isOk()); + + // 重放：撤销当前会话 + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.refreshToken()))) + .andExpect(status().isUnauthorized()); + + // 该会话的原 Access Token 随即失效 + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + first.accessToken())) + .andExpect(status().isUnauthorized()); + } + + // ── 非 Refresh Token 一律拒绝 ─────────────────────────────── + + @Test + void accessTokenAndGarbageAreRejectedAtRefresh() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody(first.accessToken()))) + .andExpect(status().isUnauthorized()); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content(refreshBody("not-a-token"))) + .andExpect(status().isUnauthorized()); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"refreshToken\":\"\"}")) + .andExpect(status().is4xxClientError()); + } + + @Test + void refreshTokenCannotBePassedAsQueryParameter() throws Exception { + AuthSessionService.SessionTokens first = newSession(); + + // Token 只能出现在请求体；作为 query 参数不产生任何效果。 + mockMvc.perform(post("/auth/refresh?refreshToken=" + first.refreshToken()) + .contentType(MediaType.APPLICATION_JSON) + .content("{}")) + .andExpect(status().is4xxClientError()); + } + + private com.mydreamjob.config.AppJwtProperties hashProperties() { + com.mydreamjob.config.AppJwtProperties p = new com.mydreamjob.config.AppJwtProperties(); + p.setTokenHashSecret("test-token-hash-secret-key-for-integration-tests-only-not-for-production"); + return p; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthServiceTest.java index afc76f2..53db2d4 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthServiceTest.java @@ -1,5 +1,6 @@ package com.mydreamjob.auth; +import com.mydreamjob.audit.AuditContext; import com.mydreamjob.audit.AuditService; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; @@ -14,21 +15,33 @@ import org.mockito.InjectMocks; import org.mockito.Mock; import org.mockito.junit.jupiter.MockitoExtension; -import java.util.Optional; +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; import java.util.Map; +import java.util.Optional; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.*; import static org.mockito.Mockito.*; +/** + * S02 {@link AuthService} 单元测试。 + * + *

    登录链路改为「验证码校验 → 用户解析 → 创建服务端会话」，因此 Mockito 目标 + * 由旧的 {@code JwtTokenProvider} 换成 {@link AuthSessionService}； + * 原有断言语义（响应字段、自动建号、注销墓碑、验证码用途透传）保持不变。

    + */ @ExtendWith(MockitoExtension.class) class AuthServiceTest { + private static final Instant FIXED_NOW = Instant.parse("2026-09-14T02:00:00Z"); + @Mock private UserRepository userRepository; @Mock - private JwtTokenProvider jwtTokenProvider; + private AuthSessionService authSessionService; @Mock private SmsVerificationService smsVerificationService; @@ -42,9 +55,18 @@ class AuthServiceTest { @Mock private AccountDeletionPhoneHasher accountDeletionPhoneHasher; + @Mock + private Clock clock; + @InjectMocks private AuthService authService; + private void stubSessionIssuance() { + when(clock.instant()).thenReturn(FIXED_NOW); + when(authSessionService.createSession(any(), any(), any())) + .thenReturn(new AuthSessionService.SessionTokens("access-token", "refresh-token", "sid-1")); + } + @Test void mockLogin_shouldReturnTokenWhenCodeValid() { User user = User.builder() @@ -53,17 +75,19 @@ class AuthServiceTest { when(smsVerificationService.verifyCode("13800000001", "123456", "login")).thenReturn(true); when(userRepository.findByPhone("13800000001")).thenReturn(Optional.of(user)); - when(jwtTokenProvider.generateAccessToken(anyLong(), anyString(), anyMap())) - .thenReturn("access-token"); - when(jwtTokenProvider.generateRefreshToken(anyLong(), anyString())) - .thenReturn("refresh-token"); + stubSessionIssuance(); Map result = authService.mockLogin("13800000001", "123456", "login", "req-1", "10.0.0.1", "JUnit"); assertEquals("access-token", result.get("accessToken")); assertEquals("refresh-token", result.get("refreshToken")); assertEquals(1L, result.get("userId")); - verify(auditService, times(1)).logLogin(1L, "10.0.0.1", "JUnit", "req-1"); + // expiresIn 契约保持不变（设计 D04） + assertEquals(86400L, result.get("expiresIn")); + // 登录审计仍写入，且时间来自入口单次捕获的 capturedNow + verify(auditService, times(1)).log(eq(1L), eq("LOGIN"), eq("USER"), eq(1L), + eq("User logged in"), any(AuditContext.class), + eq(LocalDateTime.ofInstant(FIXED_NOW, AuthSessionService.BUSINESS_ZONE))); } @Test @@ -75,10 +99,7 @@ class AuthServiceTest { u.setId(99L); return u; }); - when(jwtTokenProvider.generateAccessToken(anyLong(), anyString(), anyMap())) - .thenReturn("access-token"); - when(jwtTokenProvider.generateRefreshToken(anyLong(), anyString())) - .thenReturn("refresh-token"); + stubSessionIssuance(); Map result = authService.mockLogin("13800000099", "123456", "login", null, null, null); @@ -92,10 +113,7 @@ class AuthServiceTest { .thenReturn(true); User user = User.builder().id(1L).phone("13800000001").role(User.Role.STUDENT).active(true).verified(true).build(); when(userRepository.findByPhone("13800000001")).thenReturn(Optional.of(user)); - when(jwtTokenProvider.generateAccessToken(anyLong(), anyString(), anyMap())) - .thenReturn("token"); - when(jwtTokenProvider.generateRefreshToken(anyLong(), anyString())) - .thenReturn("refresh"); + stubSessionIssuance(); authService.mockLogin("13800000001", "123456", "password-reset", null, null, null); verify(smsVerificationService, times(1)).verifyCode("13800000001", "123456", "password-reset"); @@ -108,6 +126,8 @@ class AuthServiceTest { assertThrows(BusinessException.class, () -> authService.mockLogin("13800000001", "000000", "login", null, null, null)); + // 验证码失败不得创建任何会话 + verify(authSessionService, never()).createSession(any(), any(), any()); } @Test @@ -123,6 +143,7 @@ class AuthServiceTest { assertEquals(ErrorCode.ACCOUNT_DELETED.getCode(), ex.getErrorCodeInt()); // 不得自动创建新用户 verify(userRepository, never()).save(any()); + verify(authSessionService, never()).createSession(any(), any(), any()); } @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionPersistenceIntegrationTest.java new file mode 100644 index 0000000..74b0a73 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionPersistenceIntegrationTest.java @@ -0,0 +1,219 @@ +package com.mydreamjob.auth; + +import jakarta.persistence.EntityManager; +import jakarta.persistence.PersistenceContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.transaction.annotation.Transactional; + +import java.time.Instant; +import java.time.LocalDateTime; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S02 持久化契约（设计第七节，任务书 §九）。 + * + *

    覆盖：V42 迁移字段、新记录字段正确、token_jti 唯一、默认 version=0、 + * 乐观锁冲突、旧格式行仍可存在、数据库不保存 Token 原文。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AuthSessionPersistenceIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9900); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AuthTokenRepository authTokenRepository; + + @Autowired + private JdbcTemplate jdbcTemplate; + + @PersistenceContext + private EntityManager entityManager; + + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = userRepository.save(User.builder() + .phone("14" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 持久化") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + if (userId != null) { + userRepository.deleteById(userId); + } + } + + // ── 迁移字段 ──────────────────────────────────────────────── + + @Test + void v42ColumnsExist() { + List columns = jdbcTemplate.queryForList( + "SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE UPPER(TABLE_NAME) = 'AUTH_TOKENS'", + String.class); + + assertThat(columns.stream().map(String::toLowerCase).toList()).contains( + "session_id", "token_jti", "parent_token_id", + "consumed_at", "revoked_at", "revocation_reason", "version"); + } + + @Test + void newSessionRecordHasExpectedFields() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + + List rows = authTokenRepository.findByUserIdAndSessionIdOrderByIdAsc(userId, session.sessionId()); + assertThat(rows).hasSize(1); + + AuthToken row = rows.get(0); + assertThat(row.getSessionId()).isEqualTo(session.sessionId()); + assertThat(row.getTokenJti()).isNotBlank(); + assertThat(row.getTokenType()).isEqualTo(AuthToken.TYPE_REFRESH); + assertThat(row.getRevoked()).isFalse(); + assertThat(row.getConsumedAt()).isNull(); + assertThat(row.getRevokedAt()).isNull(); + assertThat(row.getVersion()).as("新记录默认 version=0").isZero(); + assertThat(row.getExpiredAt()).isAfter(LocalDateTime.now()); + } + + @Test + void databaseDoesNotStoreRawJwt() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + + List hashes = jdbcTemplate.queryForList( + "SELECT token_hash FROM auth_tokens WHERE session_id = ?", String.class, session.sessionId()); + + assertThat(hashes).hasSize(1); + String stored = hashes.get(0); + assertThat(stored).as("必须是固定长度摘要").hasSize(64); + assertThat(stored).matches("[0-9a-f]{64}"); + // 原文的两个部分都不得出现 + assertThat(stored).doesNotContain(session.refreshToken()); + assertThat(session.refreshToken()).doesNotContain(stored); + } + + @Test + void refreshJtiIsUnique() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + AuthToken existing = authTokenRepository + .findByUserIdAndSessionIdOrderByIdAsc(userId, session.sessionId()).get(0); + + assertThatThrownBy(() -> jdbcTemplate.update( + "INSERT INTO auth_tokens (user_id, token_hash, token_type, expired_at, revoked, session_id, token_jti, version, created_at)" + + " VALUES (?, ?, 'REFRESH', ?, 0, ?, ?, 0, CURRENT_TIMESTAMP)", + userId, "a".repeat(64), LocalDateTime.now().plusDays(1), + "other-session", existing.getTokenJti())) + .as("token_jti 必须唯一") + .isInstanceOf(org.springframework.dao.DataIntegrityViolationException.class); + } + + @Test + void legacyRowsWithoutSessionIdRemainAllowed() { + // 迁移前写入的旧格式行（session_id IS NULL）必须仍然可以存在 + jdbcTemplate.update( + "INSERT INTO auth_tokens (user_id, token_hash, token_type, expired_at, revoked, created_at)" + + " VALUES (?, ?, 'ACCESS', ?, 0, CURRENT_TIMESTAMP)", + userId, "b".repeat(64), LocalDateTime.now().plusDays(1)); + + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM auth_tokens WHERE user_id = ? AND session_id IS NULL", + Integer.class, userId)).isPositive(); + + // 且旧行永远不会被新鉴权逻辑视为活动会话 + assertThat(authSessionService.isSessionActive(userId, null, Instant.now())).isFalse(); + } + + // ── 乐观锁 / 条件更新 ─────────────────────────────────────── + + @Test + @Transactional + void consumeIfCurrentRejectsStaleVersion() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + AuthToken row = authTokenRepository + .findByUserIdAndSessionIdOrderByIdAsc(userId, session.sessionId()).get(0); + + Long staleVersion = row.getVersion(); + LocalDateTime now = LocalDateTime.now(); + + // 第一次消费成功并把 version 递增 + assertThat(authTokenRepository.consumeIfCurrent(row.getId(), staleVersion, now, now)).isEqualTo(1); + // 用旧 version 再次消费必须失败（条件更新失效） + assertThat(authTokenRepository.consumeIfCurrent(row.getId(), staleVersion, now, now)).isZero(); + } + + @Test + @Transactional + void consumeIfCurrentRejectsRevokedConsumedOrExpired() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + AuthToken row = authTokenRepository + .findByUserIdAndSessionIdOrderByIdAsc(userId, session.sessionId()).get(0); + LocalDateTime now = LocalDateTime.now(); + + // 过期后不可消费 + assertThat(authTokenRepository.consumeIfCurrent( + row.getId(), row.getVersion(), now, row.getExpiredAt().plusSeconds(1))).isZero(); + + // 已撤销不可消费 + authTokenRepository.revokeSession(userId, session.sessionId(), now, AuthSessionService.REASON_LOGOUT); + AuthToken reloaded = authTokenRepository.findById(row.getId()).orElseThrow(); + assertThat(authTokenRepository.consumeIfCurrent( + reloaded.getId(), reloaded.getVersion(), now, now)).isZero(); + } + + @Test + @Transactional + void conditionUpdateReturnsAffectedRowsAndIsChecked() { + AuthSessionService.SessionTokens session = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + + int first = authTokenRepository.revokeSession( + userId, session.sessionId(), LocalDateTime.now(), AuthSessionService.REASON_LOGOUT); + int second = authTokenRepository.revokeSession( + userId, session.sessionId(), LocalDateTime.now(), AuthSessionService.REASON_LOGOUT); + + assertThat(first).isEqualTo(1); + assertThat(second).as("重复撤销不再影响任何行").isZero(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionRevocationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionRevocationIntegrationTest.java new file mode 100644 index 0000000..cc64a96 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionRevocationIntegrationTest.java @@ -0,0 +1,200 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.deletion.AccountDeletion; +import com.mydreamjob.deletion.AccountDeletionCompletionWorker; +import com.mydreamjob.deletion.AccountDeletionRepository; +import com.mydreamjob.deletion.DeletionStatus; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; + +import java.time.Instant; +import java.time.LocalDateTime; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S02 会话撤销语义（设计 D11 / D12，任务书 §十五 与 §十九 生命周期组）。 + * + *

    覆盖：登出只撤销当前设备、多设备隔离、重复撤销幂等、 + * 注销完成撤销全部会话、其他用户不受影响。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AuthSessionRevocationIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9800); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AccountDeletionRepository accountDeletionRepository; + + @Autowired + private AccountDeletionCompletionWorker accountDeletionCompletionWorker; + + private Long userId; + private Long otherUserId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = createUser("S02 撤销"); + otherUserId = createUser("S02 他人"); + } + + @AfterEach + void tearDown() { + accountDeletionRepository.findByUserId(userId).ifPresent(accountDeletionRepository::delete); + accountDeletionRepository.findByUserId(otherUserId).ifPresent(accountDeletionRepository::delete); + userRepository.deleteById(otherUserId); + userRepository.deleteById(userId); + } + + private Long createUser(String nickname) { + return userRepository.save(User.builder() + .phone("15" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname(nickname) + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + private AuthSessionService.SessionTokens sessionFor(Long uid) { + return authSessionService.createSession(userRepository.findById(uid).orElseThrow(), Instant.now(), null); + } + + // ── 单设备登出 ────────────────────────────────────────────── + + @Test + void logoutRevokesOnlyCurrentSession() { + AuthSessionService.SessionTokens deviceA = sessionFor(userId); + AuthSessionService.SessionTokens deviceB = sessionFor(userId); + assertThat(deviceA.sessionId()).isNotEqualTo(deviceB.sessionId()); + + authSessionService.logout(userId, deviceA.sessionId(), Instant.now(), null); + + assertThat(authSessionService.isSessionActive(userId, deviceA.sessionId(), Instant.now())).isFalse(); + assertThat(authSessionService.isSessionActive(userId, deviceB.sessionId(), Instant.now())) + .as("其他设备会话不得被误伤").isTrue(); + } + + @Test + void repeatedLogoutIsIdempotent() { + AuthSessionService.SessionTokens device = sessionFor(userId); + + authSessionService.logout(userId, device.sessionId(), Instant.now(), null); + // 第二次登出不得抛异常 + authSessionService.logout(userId, device.sessionId(), Instant.now(), null); + + assertThat(authSessionService.isSessionActive(userId, device.sessionId(), Instant.now())).isFalse(); + } + + @Test + void logoutDoesNotAffectOtherUsers() { + AuthSessionService.SessionTokens mine = sessionFor(userId); + AuthSessionService.SessionTokens theirs = sessionFor(otherUserId); + + authSessionService.logout(userId, mine.sessionId(), Instant.now(), null); + + assertThat(authSessionService.isSessionActive(otherUserId, theirs.sessionId(), Instant.now())) + .as("其他用户会话不受影响").isTrue(); + } + + // ── 注销完成撤销全部会话 ──────────────────────────────────── + + @Test + void accountDeletionCompletionRevokesAllSessions() { + AuthSessionService.SessionTokens deviceA = sessionFor(userId); + AuthSessionService.SessionTokens deviceB = sessionFor(userId); + AuthSessionService.SessionTokens other = sessionFor(otherUserId); + + requestDeletionPastCooling(userId); + assertThat(accountDeletionCompletionWorker.completeIfExpired(userId)).isTrue(); + + assertThat(authSessionService.isSessionActive(userId, deviceA.sessionId(), Instant.now())).isFalse(); + assertThat(authSessionService.isSessionActive(userId, deviceB.sessionId(), Instant.now())).isFalse(); + assertThat(authSessionService.isSessionActive(otherUserId, other.sessionId(), Instant.now())) + .as("其他用户会话不受影响").isTrue(); + } + + @Test + void pendingDeletionDoesNotForceLogout() { + AuthSessionService.SessionTokens device = sessionFor(userId); + + // 尚在冷静期（未到期）的 PENDING 不应撤销会话 + accountDeletionRepository.save(AccountDeletion.builder() + .userId(userId).status(DeletionStatus.PENDING) + .requestedAt(LocalDateTime.now()) + .effectiveAt(LocalDateTime.now().plusDays(30)) + .build()); + assertThat(accountDeletionCompletionWorker.completeIfExpired(userId)).isFalse(); + + assertThat(authSessionService.isSessionActive(userId, device.sessionId(), Instant.now())) + .as("注销申请 PENDING 时不强制退出").isTrue(); + } + + @Test + void cancelledDeletionDoesNotRestoreRevokedSessions() { + AuthSessionService.SessionTokens device = sessionFor(userId); + + requestDeletionPastCooling(userId); + assertThat(accountDeletionCompletionWorker.completeIfExpired(userId)).isTrue(); + assertThat(authSessionService.isSessionActive(userId, device.sessionId(), Instant.now())).isFalse(); + + // 回退注销状态（等价于取消）不得让已撤销的会话复活 + AccountDeletion rec = accountDeletionRepository.findByUserId(userId).orElseThrow(); + rec.setStatus(DeletionStatus.NONE); + accountDeletionRepository.saveAndFlush(rec); + + assertThat(authSessionService.isSessionActive(userId, device.sessionId(), Instant.now())) + .as("取消注销不恢复旧 session").isFalse(); + } + + @Test + void revokeAllUserSessionsReportsAffectedRows() { + sessionFor(userId); + sessionFor(userId); + sessionFor(userId); + + int affected = authSessionService.revokeAllUserSessions( + userId, AuthSessionService.REASON_USER_DISABLED, Instant.now()); + + assertThat(affected).as("应撤销该用户全部活动会话").isGreaterThanOrEqualTo(3); + // 再次吊销：已无活动会话，受影响行数为 0（幂等） + assertThat(authSessionService.revokeAllUserSessions( + userId, AuthSessionService.REASON_USER_DISABLED, Instant.now())).isZero(); + } + + private void requestDeletionPastCooling(Long uid) { + accountDeletionRepository.save(AccountDeletion.builder() + .userId(uid).status(DeletionStatus.PENDING) + .requestedAt(LocalDateTime.now().minusDays(31)) + .effectiveAt(LocalDateTime.now().minusDays(1)) + .build()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionServiceTest.java new file mode 100644 index 0000000..0512796 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthSessionServiceTest.java @@ -0,0 +1,118 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.audit.AuditService; +import org.junit.jupiter.api.BeforeEach; +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 org.springframework.dao.DataAccessResourceFailureException; +import org.springframework.transaction.PlatformTransactionManager; + +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.when; + +/** + * S02 会话服务的单元级语义（失败关闭、权限判定）。 + * + *

    并发与持久化由集成测试覆盖；这里只验证拒绝路径不产生副作用。

    + */ +@ExtendWith(MockitoExtension.class) +class AuthSessionServiceTest { + + private static final ZoneId ZONE = ZoneId.of("Asia/Shanghai"); + + @Mock + private AuthTokenRepository authTokenRepository; + + @Mock + private AuthTokenHasher authTokenHasher; + + @Mock + private JwtTokenProvider jwtTokenProvider; + + @Mock + private UserRepository userRepository; + + @Mock + private AuditService auditService; + + @Mock + private PlatformTransactionManager transactionManager; + + @InjectMocks + private AuthSessionService authSessionService; + + private User activeUser; + + @BeforeEach + void setUp() { + activeUser = User.builder().id(1L).active(true).role(User.Role.STUDENT).build(); + } + + @Test + void isSessionActiveReturnsFalseForNullArguments() { + assertThat(authSessionService.isSessionActive(null, "sid", java.time.Instant.now())).isFalse(); + assertThat(authSessionService.isSessionActive(1L, null, java.time.Instant.now())).isFalse(); + assertThat(authSessionService.isSessionActive(1L, " ", java.time.Instant.now())).isFalse(); + } + + @Test + void isSessionActiveReturnsFalseWhenUserMissingOrInactive() { + when(userRepository.findById(1L)).thenReturn(Optional.empty()); + assertThat(authSessionService.isSessionActive(1L, "sid", java.time.Instant.now())).isFalse(); + + User inactive = User.builder().id(2L).active(false).role(User.Role.STUDENT).build(); + when(userRepository.findById(2L)).thenReturn(Optional.of(inactive)); + assertThat(authSessionService.isSessionActive(2L, "sid", java.time.Instant.now())).isFalse(); + + User nullActive = User.builder().id(3L).active(null).role(User.Role.STUDENT).build(); + when(userRepository.findById(3L)).thenReturn(Optional.of(nullActive)); + assertThat(authSessionService.isSessionActive(3L, "sid", java.time.Instant.now())).isFalse(); + } + + @Test + void isSessionActiveFailsClosedWhenDatabaseErrors() { + when(userRepository.findById(1L)).thenReturn(Optional.of(activeUser)); + when(authTokenRepository.countActiveSessionTokens(anyLong(), anyString(), any(LocalDateTime.class))) + .thenThrow(new DataAccessResourceFailureException("db down")); + + assertThat(authSessionService.isSessionActive(1L, "sid", java.time.Instant.now())) + .as("数据库异常必须失败关闭").isFalse(); + } + + @Test + void isSessionActiveTrueOnlyWhenActiveRecordExists() { + when(userRepository.findById(1L)).thenReturn(Optional.of(activeUser)); + when(authTokenRepository.countActiveSessionTokens(eq(1L), eq("sid"), any(LocalDateTime.class))) + .thenReturn(1L); + + assertThat(authSessionService.isSessionActive(1L, "sid", java.time.Instant.now())).isTrue(); + } + + @Test + void revokeAllUserSessionsReturnsZeroForNullUser() { + assertThat(authSessionService.revokeAllUserSessions( + null, AuthSessionService.REASON_USER_DISABLED, java.time.Instant.now())).isZero(); + } + + @Test + void logoutRejectsBlankSessionId() { + org.junit.jupiter.api.Assertions.assertThrows(InvalidTokenException.class, + () -> authSessionService.logout(1L, " ", java.time.Instant.now(), null)); + } + + @Test + void sessionRefIsIrreversibleAndFixedLength() { + when(authTokenHasher.hash(anyString())).thenReturn("0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"); + String ref = authSessionService.sessionRef("session-1"); + assertThat(ref).hasSize(16); + assertThat(ref).matches("[0-9a-f]{16}"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenClockConsistencyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenClockConsistencyTest.java new file mode 100644 index 0000000..7b84c3a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenClockConsistencyTest.java @@ -0,0 +1,254 @@ +package com.mydreamjob.auth; + +import io.jsonwebtoken.Claims; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import javax.crypto.SecretKey; +import java.nio.charset.StandardCharsets; +import java.sql.Timestamp; +import java.time.*; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S02 单次时间捕获（设计 D13，任务书 §十七）。 + * + *

    使用 {@link AdvancingClock}：第一次读返回 T，之后返回明显不同的时间。 + * 只要某个入口读了两次 Clock，断言就会失败。每个入口（登录/刷新/登出） + * 分别验证：调用次数恰为 1，且 JWT、数据库与审计时间全部来自 T。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AuthTokenClockConsistencyTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9500); + private static final Instant T = Instant.parse("2026-01-02T03:04:05Z"); + /** 第二次及以后读取返回的时间：跨月，确保一旦被使用就能被识别。 */ + private static final Instant T_LATER = Instant.parse("2026-02-05T07:08:09Z"); + private static final ZoneId ZONE = AdvancingClock.ZONE; + + @TestConfiguration + static class AdvancingClockConfiguration { + @Bean + @Primary + AdvancingClock advancingClock() { + return new AdvancingClock(T, T_LATER); + } + } + + @MockBean + private RedisTemplate redisTemplate; + + @MockBean + private SmsVerificationService smsVerificationService; + + @Autowired + private AdvancingClock clock; + + @Autowired + private AuthService authService; + + @Autowired + private UserRepository userRepository; + + @Autowired + private JdbcTemplate jdbcTemplate; + + @Value("${app.jwt.expiration-ms}") + private long accessTtlMs; + + @Value("${app.jwt.refresh-expiration-ms}") + private long refreshTtlMs; + + @Value("${app.jwt.access-secret}") + private String accessSecret; + + @Value("${app.jwt.refresh-secret}") + private String refreshSecret; + + private Long userId; + private String phone; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(smsVerificationService.verifyCode(any(), any(), any())).thenReturn(true); + + phone = "12" + String.format("%09d", PHONE_SEQ.incrementAndGet()); + userId = userRepository.save(User.builder() + .phone(phone) + .nickname("S02 时钟") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + clock.reset(); + } + + @AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM audit_logs WHERE action LIKE 'AUTH_%' AND user_id = ?", userId); + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", userId); + if (userId != null) { + userRepository.deleteById(userId); + } + } + + // ── 工具 ──────────────────────────────────────────────────── + + private Claims rawClaims(String token, String secret) { + SecretKey key = Keys.hmacShaKeyFor(secret.getBytes(StandardCharsets.UTF_8)); + return Jwts.parser().verifyWith(key).clock(() -> java.util.Date.from(Instant.EPOCH)) + .build().parseSignedClaims(token).getPayload(); + } + + private LocalDateTime at(Instant instant) { + return LocalDateTime.ofInstant(instant, ZONE); + } + + private Timestamp queryTimestamp(String sql, Object... args) { + return jdbcTemplate.queryForObject(sql, Timestamp.class, args); + } + + @SuppressWarnings("unchecked") + private Map login() { + return authService.mockLogin(phone, "123456", "login", "req-clock", null, null); + } + + // ── 登录 ──────────────────────────────────────────────────── + + @Test + void loginCapturesClockExactlyOnce() { + clock.reset(); + Map result = login(); + + assertThat(clock.callCount()).as("登录入口只能读取一次 Clock").isEqualTo(1); + + String access = (String) result.get("accessToken"); + String refresh = (String) result.get("refreshToken"); + + Claims accessClaims = rawClaims(access, accessSecret); + assertThat(accessClaims.getIssuedAt().toInstant()).isEqualTo(T); + assertThat(accessClaims.getExpiration().toInstant()).isEqualTo(T.plusMillis(accessTtlMs)); + + Claims refreshClaims = rawClaims(refresh, refreshSecret); + assertThat(refreshClaims.getIssuedAt().toInstant()).isEqualTo(T); + assertThat(refreshClaims.getExpiration().toInstant()).isEqualTo(T.plusMillis(refreshTtlMs)); + + String sessionId = refreshClaims.get("sid", String.class); + Timestamp createdAt = queryTimestamp( + "SELECT created_at FROM auth_tokens WHERE session_id = ?", sessionId); + Timestamp expiredAt = queryTimestamp( + "SELECT expired_at FROM auth_tokens WHERE session_id = ?", sessionId); + + assertThat(createdAt.toLocalDateTime()) + .as("auth_tokens.created_at 必须来自 capturedNow") + .isEqualTo(at(T)); + assertThat(expiredAt.toLocalDateTime()).isEqualTo(at(T.plusMillis(refreshTtlMs))); + + Timestamp auditCreatedAt = queryTimestamp( + "SELECT created_at FROM audit_logs WHERE action = 'AUTH_SESSION_CREATED' AND user_id = ?", userId); + assertThat(auditCreatedAt.toLocalDateTime()).isEqualTo(at(T)); + } + + // ── 刷新 ──────────────────────────────────────────────────── + + @Test + void refreshCapturesClockExactlyOnce() { + Map loginResult = login(); + String refreshToken = (String) loginResult.get("refreshToken"); + String sessionId = rawClaims(refreshToken, refreshSecret).get("sid", String.class); + + clock.reset(); + AuthSessionService.SessionTokens rotated = authService.refresh(refreshToken, "req-refresh", null, null); + + assertThat(clock.callCount()).as("刷新入口只能读取一次 Clock").isEqualTo(1); + + Claims rotatedClaims = rawClaims(rotated.accessToken(), accessSecret); + assertThat(rotatedClaims.getIssuedAt().toInstant()).isEqualTo(T); + assertThat(rotatedClaims.getExpiration().toInstant()).isEqualTo(T.plusMillis(accessTtlMs)); + + Timestamp consumedAt = queryTimestamp(""" + SELECT consumed_at FROM auth_tokens + WHERE session_id = ? AND consumed_at IS NOT NULL + """, sessionId); + assertThat(consumedAt.toLocalDateTime()).as("消费时间来自 capturedNow").isEqualTo(at(T)); + + Timestamp successorCreatedAt = queryTimestamp(""" + SELECT created_at FROM auth_tokens + WHERE session_id = ? AND consumed_at IS NULL + """, sessionId); + assertThat(successorCreatedAt.toLocalDateTime()).as("后继记录 created_at 来自 capturedNow").isEqualTo(at(T)); + + Timestamp auditCreatedAt = queryTimestamp( + "SELECT created_at FROM audit_logs WHERE action = 'AUTH_TOKEN_REFRESHED' AND user_id = ?", userId); + assertThat(auditCreatedAt.toLocalDateTime()).isEqualTo(at(T)); + } + + // ── 登出 ──────────────────────────────────────────────────── + + @Test + void logoutCapturesClockExactlyOnce() { + Map loginResult = login(); + String refreshToken = (String) loginResult.get("refreshToken"); + String sessionId = rawClaims(refreshToken, refreshSecret).get("sid", String.class); + + clock.reset(); + authService.logout(userId, sessionId, "req-logout", null, null); + + assertThat(clock.callCount()).as("登出入口只能读取一次 Clock").isEqualTo(1); + + Timestamp revokedAt = queryTimestamp( + "SELECT revoked_at FROM auth_tokens WHERE session_id = ?", sessionId); + assertThat(revokedAt.toLocalDateTime()).as("撤销时间来自 capturedNow").isEqualTo(at(T)); + + Timestamp auditCreatedAt = queryTimestamp( + "SELECT created_at FROM audit_logs WHERE action = 'AUTH_SESSION_REVOKED' AND user_id = ?", userId); + assertThat(auditCreatedAt.toLocalDateTime()).isEqualTo(at(T)); + } + + // ── 第二次读取的值不得混入 ────────────────────────────────── + + @Test + void laterClockValueNeverLeaksIntoPersistedStateOrAudit() { + clock.reset(); + login(); + + String laterText = at(T_LATER).toString(); + for (String column : new String[]{"created_at", "expired_at"}) { + String value = jdbcTemplate.queryForObject( + "SELECT CAST(" + column + " AS VARCHAR) FROM auth_tokens WHERE user_id = ?", String.class, userId); + assertThat(value).as(column + " 不得混入第二次读取的时钟值").doesNotContain(laterText); + } + String auditValue = jdbcTemplate.queryForObject( + "SELECT CAST(created_at AS VARCHAR) FROM audit_logs WHERE user_id = ? ORDER BY id DESC LIMIT 1", + String.class, userId); + assertThat(auditValue).as("审计时间不得混入第二次读取的时钟值").doesNotContain(laterText); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenHasherTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenHasherTest.java new file mode 100644 index 0000000..bedb521 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenHasherTest.java @@ -0,0 +1,69 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AppJwtProperties; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * S02 Refresh Token 摘要（设计 D07 / 第八节）。 + * + *

    只验证确定性、长度与常量时间比较的语义；不依赖 Spring 上下文。

    + */ +class AuthTokenHasherTest { + + private static final String HASH_SECRET = "test-token-hash-secret-key-for-unit-tests-only-not-for-production"; + private static final String OTHER_SECRET = "another-token-hash-secret-key-for-unit-tests-only-not-for-prod"; + + private static AuthTokenHasher hasher(String secret) { + AppJwtProperties p = new AppJwtProperties(); + p.setAccessSecret("test-access-secret-key-for-unit-tests-only-not-for-production"); + p.setRefreshSecret("test-refresh-secret-key-for-unit-tests-only-not-for-production"); + p.setTokenHashSecret(secret); + return new AuthTokenHasher(p); + } + + @Test + void hashIsStableForSameInput() { + AuthTokenHasher hasher = hasher(HASH_SECRET); + String a = hasher.hash("refresh-token-value"); + String b = hasher.hash("refresh-token-value"); + assertEquals(a, b, "同一输入必须得到同一摘要"); + } + + @Test + void hashIsFixedLengthLowercaseHex() { + String hash = hasher(HASH_SECRET).hash("refresh-token-value"); + assertEquals(64, hash.length(), "HmacSHA256 十六进制摘要固定 64 字符"); + assertTrue(hash.matches("[0-9a-f]{64}"), "必须是规范小写十六进制"); + } + + @Test + void differentInputsProduceDifferentHashes() { + AuthTokenHasher hasher = hasher(HASH_SECRET); + assertNotEquals(hasher.hash("token-a"), hasher.hash("token-b")); + } + + @Test + void differentSecretsProduceDifferentHashes() { + String a = hasher(HASH_SECRET).hash("same-input"); + String b = hasher(OTHER_SECRET).hash("same-input"); + assertNotEquals(a, b, "摘要必须依赖密钥，不能是无密钥裸摘要"); + } + + @Test + void nullAndEmptyAreHandledDeterministically() { + AuthTokenHasher hasher = hasher(HASH_SECRET); + assertEquals(hasher.hash(""), hasher.hash(null)); + } + + @Test + void matchesIsConstantTimeComparisonSemantics() { + AuthTokenHasher hasher = hasher(HASH_SECRET); + String hash = hasher.hash("value"); + assertTrue(hasher.matches(hash, hash)); + assertFalse(hasher.matches(hash, hasher.hash("other"))); + assertFalse(hasher.matches(hash, null)); + assertFalse(hasher.matches(null, hash)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenRedactionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenRedactionTest.java new file mode 100644 index 0000000..84278b5 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthTokenRedactionTest.java @@ -0,0 +1,180 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.Instant; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; +import java.util.stream.Collectors; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S02 日志与审计脱敏（设计第十二节，任务书 §十六）。 + * + *

    日志断言捕获**真实 Logback 输出**（不是 Mockito verify logger）； + * 审计断言读取真实 audit_logs 行并校验 details 白名单。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AuthTokenRedactionTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9700); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AuthTokenHasher authTokenHasher; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private Long userId; + private ListAppender appender; + private Logger appLogger; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = userRepository.save(User.builder() + .phone("13" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 脱敏") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + + appLogger = (Logger) LoggerFactory.getLogger("com.mydreamjob"); + appender = new ListAppender<>(); + appender.start(); + appLogger.addAppender(appender); + appLogger.setLevel(Level.TRACE); + } + + @AfterEach + void tearDown() { + if (appLogger != null && appender != null) { + appLogger.detachAppender(appender); + appender.stop(); + } + jdbcTemplate.update("DELETE FROM audit_logs WHERE action LIKE 'AUTH_%' AND user_id = ?", userId); + if (userId != null) { + userRepository.deleteById(userId); + } + } + + private String capturedLog() { + return appender.list.stream() + .map(ILoggingEvent::getFormattedMessage) + .collect(Collectors.joining("\n")); + } + + @Test + void loginRefreshAndLogoutNeverLogTokensOrHashes() { + AuthSessionService.SessionTokens first = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + AuthSessionService.SessionTokens rotated = + authSessionService.refresh(first.refreshToken(), Instant.now(), null); + authSessionService.logout(userId, rotated.sessionId(), Instant.now(), null); + + // 重放路径同样不得泄漏 + try { + authSessionService.refresh(first.refreshToken(), Instant.now(), null); + } catch (InvalidTokenException expected) { + // 预期 + } + + String log = capturedLog(); + for (String secret : List.of(first.accessToken(), first.refreshToken(), + rotated.accessToken(), rotated.refreshToken())) { + assertThat(log).as("日志不得包含 Token 原文").doesNotContain(secret); + } + String sessionHash = authTokenHasher.hash("sid:" + first.sessionId()); + assertThat(log).as("日志不得包含会话摘要").doesNotContain(sessionHash); + assertThat(log).doesNotContain("Bearer "); + assertThat(log).doesNotContain("Authorization"); + } + + @Test + void auditDetailsUseWhitelistOnly() { + AuthSessionService.SessionTokens first = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + AuthSessionService.SessionTokens rotated = + authSessionService.refresh(first.refreshToken(), Instant.now(), null); + authSessionService.logout(userId, rotated.sessionId(), Instant.now(), null); + try { + authSessionService.refresh(first.refreshToken(), Instant.now(), null); + } catch (InvalidTokenException expected) { + // 预期 + } + + List> rows = jdbcTemplate.queryForList( + "SELECT action, details FROM audit_logs WHERE user_id = ? AND action LIKE 'AUTH_%'", userId); + + assertThat(rows).as("应写入会话相关审计").isNotEmpty(); + for (Map row : rows) { + String action = (String) row.get("action"); + assertThat(action).isIn( + "AUTH_SESSION_CREATED", "AUTH_TOKEN_REFRESHED", + "AUTH_SESSION_REVOKED", "AUTH_REFRESH_REUSE_DETECTED"); + + String details = String.valueOf(row.get("details")); + assertThat(details).as("审计 details 不得包含 Token/摘要/手机号") + .doesNotContain("accessToken") + .doesNotContain("refreshToken") + .doesNotContain("Bearer") + .doesNotContain("tokenHash") + .doesNotContain(first.refreshToken()) + .doesNotContain(first.accessToken()); + // 只允许 sessionRef / reason 两个键 + assertThat(details).contains("\"sessionRef\""); + } + } + + @Test + void auditNeverContainsRawTokens() { + AuthSessionService.SessionTokens tokens = + authSessionService.createSession(userRepository.findById(userId).orElseThrow(), Instant.now(), null); + + List allDetails = jdbcTemplate.queryForList( + "SELECT details FROM audit_logs WHERE user_id = ?", String.class, userId); + + for (String details : allDetails) { + assertThat(details).doesNotContain(tokens.accessToken()); + assertThat(details).doesNotContain(tokens.refreshToken()); + // 数据库里的摘要也不得出现在审计中 + assertThat(details).doesNotContain(authTokenHasher.hash(tokens.refreshToken())); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthenticationBoundaryIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthenticationBoundaryIntegrationTest.java new file mode 100644 index 0000000..347a276 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/AuthenticationBoundaryIntegrationTest.java @@ -0,0 +1,431 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.job.JobStatus; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Value; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import javax.crypto.SecretKey; +import java.nio.charset.StandardCharsets; +import java.util.Comparator; +import java.util.Date; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.concurrent.atomic.AtomicLong; +import java.util.stream.Stream; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.not; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.patch; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * S01 认证与授权边界（真实 SecurityFilterChain + 真实 H2 Service）。 + * + *

    覆盖任务书第三节与第九节 C 组： + * 匿名写请求必须是 401（修复前为 500），越权请求不得产生业务写入， + * 公开 GET 语义保持不变，且失败响应不得回显 anonymousUser、非法 principal 或内部类名。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AuthenticationBoundaryIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(7100); + private static final String BAD_PRINCIPAL = "INTERNAL_BAD_PRINCIPAL_SECRET"; + private static final String VALID_JOB_BODY = """ + {"title":"安全边界测试岗位","description":"desc","city":"杭州","employmentType":"FULL_TIME"} + """; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + + @Autowired + private JwtTokenProvider jwtTokenProvider; + + @Autowired + private UserRepository userRepository; + + @Autowired + private CompanyRepository companyRepository; + + @Autowired + private JobRepository jobRepository; + + @Value("${app.jwt.secret}") + private String jwtSecret; + + private Long companyUserId; + private Long otherCompanyUserId; + private Long studentUserId; + private Long adminUserId; + private Long companyId; + private Long otherCompanyId; + private Long jobId; + + private ListAppender appender; + private Logger appLogger; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + companyUserId = createUser(User.Role.COMPANY); + otherCompanyUserId = createUser(User.Role.COMPANY); + studentUserId = createUser(User.Role.STUDENT); + adminUserId = createUser(User.Role.ADMIN); + + companyId = createCompany(companyUserId, "安全边界甲公司"); + otherCompanyId = createCompany(otherCompanyUserId, "安全边界乙公司"); + + jobId = jobRepository.save(Job.builder() + .companyId(companyId) + .title("边界夹具岗位") + .description("fixture") + .city("杭州") + .employmentType("FULL_TIME") + .status(JobStatus.DRAFT.name()) + .build()).getId(); + + appLogger = (Logger) LoggerFactory.getLogger("com.mydreamjob"); + appender = new ListAppender<>(); + appender.start(); + appLogger.addAppender(appender); + appLogger.setLevel(Level.TRACE); + } + + @AfterEach + void tearDown() { + if (appLogger != null && appender != null) { + appLogger.detachAppender(appender); + appender.stop(); + } + // 本测试类与其他集成测试共用同一 JVM 内的 H2 命名库，必须清理自身夹具（FK 安全顺序）， + // 否则残留的 companies 行会让后续 AuthIntegrationTest 的 userRepository.deleteAll() 触发 FK 约束错误。 + List myCompanyIds = Stream.of(companyId, otherCompanyId) + .filter(Objects::nonNull).toList(); + if (!myCompanyIds.isEmpty()) { + jobRepository.deleteAll(jobRepository.findAll().stream() + .filter(j -> myCompanyIds.contains(j.getCompanyId())) + .toList()); + companyRepository.deleteAllById(myCompanyIds); + } + List myUserIds = Stream.of(companyUserId, otherCompanyUserId, studentUserId, adminUserId) + .filter(Objects::nonNull).toList(); + if (!myUserIds.isEmpty()) { + userRepository.deleteAllById(myUserIds); + } + } + + // ── A. 匿名写请求必须 401，不得 500，且无业务写入 ────────────── + + @Test + void anonymousPostJobsMustReturn401InsteadOf500() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(post("/jobs").contentType(MediaType.APPLICATION_JSON).content(VALID_JOB_BODY)) + .andExpect(status().isUnauthorized()) + .andExpect(jsonPath("$.code").value(401)) + .andExpect(content().string(not(containsString("anonymousUser")))) + .andExpect(content().string(not(containsString("NumberFormatException")))) + .andExpect(content().string(not(containsString("Exception")))) + .andExpect(content().string(not(containsString("com.mydreamjob")))) + .andExpect(content().string(not(containsString("java.")))); + + assertThat(snapshotJobs()).as("匿名创建不得写入任何岗位").isEqualTo(before); + } + + @Test + void anonymousCannotCreateJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(post("/jobs").contentType(MediaType.APPLICATION_JSON).content(VALID_JOB_BODY)) + .andExpect(status().isUnauthorized()); + + assertThat(snapshotJobs()) + .as("jobs 表完整内容不得变化（不只是行数）") + .isEqualTo(before); + } + + @Test + void anonymousCannotUpdateJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(put("/jobs/" + jobId) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"title\":\"被篡改\"}")) + .andExpect(status().isUnauthorized()); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + @Test + void anonymousCannotDeleteJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(delete("/jobs/" + jobId)) + .andExpect(status().isUnauthorized()); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + @Test + void anonymousCannotPublishOrCloseJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(patch("/jobs/" + jobId + "/status") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"status\":\"PUBLISHED\"}")) + .andExpect(status().isUnauthorized()); + + assertThat(snapshotJobs()).isEqualTo(before); + assertThat(jobRepository.findById(jobId).orElseThrow().getStatus()) + .isEqualTo(JobStatus.DRAFT.name()); + } + + @Test + void anonymousAuthenticationTokenMustBeRejectedBeforeControllerBusinessLogic() throws Exception { + List before = snapshotJobs(); + + // 匿名请求会被 Spring Security 包装为 AnonymousAuthenticationToken（isAuthenticated() == true）。 + // 修复前：命中 permitAll → 进入 Controller → Long.valueOf("anonymousUser") → 500。 + mockMvc.perform(post("/jobs").contentType(MediaType.APPLICATION_JSON).content(VALID_JOB_BODY)) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString("anonymousUser")))); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + @Test + void nonNumericPrincipalMustReturn401WithoutEcho() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(post("/jobs") + .contentType(MediaType.APPLICATION_JSON) + .content(VALID_JOB_BODY) + .header("Authorization", "Bearer " + signedTokenWithSubject(BAD_PRINCIPAL))) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString(BAD_PRINCIPAL)))) + .andExpect(content().string(not(containsString("NumberFormatException")))) + .andExpect(content().string(not(containsString("java.")))); + + assertThat(capturedLogs()) + .as("日志不得回显非法 principal") + .doesNotContain(BAD_PRINCIPAL); + assertThat(snapshotJobs()).isEqualTo(before); + } + + // ── B. 公开 GET 语义保持不变 ─────────────────────────────────── + + @Test + void anonymousCanListPublishedJobs() throws Exception { + mockMvc.perform(get("/jobs")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.items").isArray()); + } + + @Test + void anonymousCanReadPublicJobDetailIfExistingContractAllows() throws Exception { + Job job = jobRepository.findById(jobId).orElseThrow(); + job.setStatus(JobStatus.PUBLISHED.name()); + jobRepository.save(job); + + mockMvc.perform(get("/jobs/public/" + jobId)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)); + } + + @Test + void anonymousCanSearchAndFilterJobs() throws Exception { + mockMvc.perform(get("/jobs/search")).andExpect(status().isOk()); + mockMvc.perform(get("/jobs/filters")).andExpect(status().isOk()); + } + + // ── C. 已登录但非企业主体：不得创建岗位 ─────────────────────── + + @Test + void studentCannotCreateJob() throws Exception { + List before = snapshotJobs(); + + // 既有语义：非 COMPANY 角色 → FORBIDDEN(2002) → HTTP 403 + mockMvc.perform(post("/jobs") + .contentType(MediaType.APPLICATION_JSON) + .content(VALID_JOB_BODY) + .header("Authorization", token(studentUserId))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(ErrorCode.FORBIDDEN.getCode())); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + @Test + void adminCannotCreateJob() throws Exception { + List before = snapshotJobs(); + + // 既有语义：ADMIN 也不是 COMPANY 角色 → FORBIDDEN(2002) → HTTP 403 + mockMvc.perform(post("/jobs") + .contentType(MediaType.APPLICATION_JSON) + .content(VALID_JOB_BODY) + .header("Authorization", token(adminUserId))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(ErrorCode.FORBIDDEN.getCode())); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + // ── D. 企业主体：可创建；他企业不得修改 ──────────────────────── + + @Test + void companyCanCreateJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(post("/jobs") + .contentType(MediaType.APPLICATION_JSON) + .content(VALID_JOB_BODY) + .header("Authorization", token(companyUserId))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.status").value(JobStatus.DRAFT.name())); + + List after = snapshotJobs(); + assertThat(after).hasSize(before.size() + 1); + assertThat(jobRepository.findAll()) + .anySatisfy(j -> { + assertThat(j.getTitle()).isEqualTo("安全边界测试岗位"); + assertThat(j.getCompanyId()).isEqualTo(companyOf(companyUserId)); + }); + } + + @Test + void otherCompanyCannotModifyOwnedJob() throws Exception { + List before = snapshotJobs(); + + // 既有语义：归属校验失败为 JOB_OWNER_MISMATCH(7002) → HTTP 400（本轮不改变错误码） + mockMvc.perform(put("/jobs/" + jobId) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"title\":\"他企业篡改\"}") + .header("Authorization", token(otherCompanyUserId))) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(ErrorCode.JOB_OWNER_MISMATCH.getCode())); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + @Test + void otherCompanyCannotPublishOwnedJob() throws Exception { + List before = snapshotJobs(); + + mockMvc.perform(patch("/jobs/" + jobId + "/status") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"status\":\"PUBLISHED\"}") + .header("Authorization", token(otherCompanyUserId))) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(ErrorCode.JOB_OWNER_MISMATCH.getCode())); + + assertThat(snapshotJobs()).isEqualTo(before); + } + + // ── 辅助 ────────────────────────────────────────────────────── + + private List snapshotJobs() { + return jobRepository.findAll().stream() + .sorted(Comparator.comparing(Job::getId)) + .map(j -> String.join("|", + String.valueOf(j.getId()), String.valueOf(j.getCompanyId()), + String.valueOf(j.getTitle()), String.valueOf(j.getDescription()), + String.valueOf(j.getCity()), String.valueOf(j.getEmploymentType()), + String.valueOf(j.getStatus()), + String.valueOf(j.getSalaryMin()), String.valueOf(j.getSalaryMax()), + String.valueOf(j.getPublishedAt()), String.valueOf(j.getUpdatedAt()))) + .toList(); + } + + private String capturedLogs() { + StringBuilder sb = new StringBuilder(); + for (ILoggingEvent event : appender.list) { + sb.append(event.getLevel()).append(' ').append(event.getFormattedMessage()).append('\n'); + if (event.getThrowableProxy() != null) { + sb.append(event.getThrowableProxy().getMessage()).append('\n'); + } + } + return sb.toString(); + } + + private String token(Long userId) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); + } + + private String signedTokenWithSubject(String subject) { + SecretKey key = Keys.hmacShaKeyFor(jwtSecret.getBytes(StandardCharsets.UTF_8)); + long now = System.currentTimeMillis(); + return Jwts.builder() + .subject(subject) + .issuedAt(new Date(now)) + .expiration(new Date(now + 3_600_000L)) + .signWith(key) + .compact(); + } + + private Long createUser(User.Role role) { + return userRepository.save(User.builder() + .phone("17" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("边界用户") + .role(role) + // 角色集合为 @ElementCollection，业务角色校验读取的是 roles 而非 role + .roles(new java.util.HashSet<>(java.util.Set.of(role))) + .active(true) + .verified(true) + .build()).getId(); + } + + private Long createCompany(Long ownerUserId, String name) { + return companyRepository.save(Company.builder() + .ownerUserId(ownerUserId) + .name(name) + .build()).getId(); + } + + private Long companyOf(Long ownerUserId) { + return companyRepository.findByOwnerUserId(ownerUserId).orElseThrow().getId(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtAuthenticationTypeIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtAuthenticationTypeIntegrationTest.java new file mode 100644 index 0000000..e0a41fa --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtAuthenticationTypeIntegrationTest.java @@ -0,0 +1,270 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.job.JobStatus; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import javax.crypto.SecretKey; +import java.nio.charset.StandardCharsets; +import java.time.Instant; +import java.util.Date; +import java.util.List; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.atomic.AtomicLong; + +import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.not; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * S02 认证过滤器的类型隔离与失败关闭（设计 D01/D14，任务书 §五 与 §十三）。 + * + *

    真实 SecurityFilterChain + 真实 H2。核心断言： + * Refresh Token 不能访问普通业务接口，Access Token 不能用于刷新， + * 无 type / 未知 type / 非法 claim 一律 401，且响应不泄漏内部信息。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class JwtAuthenticationTypeIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9200); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + + @Autowired + private UserRepository userRepository; + + @Autowired + private CompanyRepository companyRepository; + + @Autowired + private JobRepository jobRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private JwtTokenProvider jwtTokenProvider; + + @org.springframework.beans.factory.annotation.Value("${app.jwt.access-secret}") + private String accessSecret; + + @org.springframework.beans.factory.annotation.Value("${app.jwt.refresh-secret}") + private String refreshSecret; + + private Long userId; + private Long jobId; + private Long companyId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + userId = userRepository.save(User.builder() + .phone("18" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 类型隔离") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + + companyId = companyRepository.save(Company.builder() + .ownerUserId(userId).name("S02 公司").build()).getId(); + jobId = jobRepository.save(Job.builder() + .companyId(companyId).title("S02 岗位").description("d").city("杭州") + .employmentType("FULL_TIME").status(JobStatus.PUBLISHED.name()).build()).getId(); + } + + @AfterEach + void tearDown() { + jobRepository.deleteAll(jobRepository.findAll().stream() + .filter(j -> companyId != null && companyId.equals(j.getCompanyId())).toList()); + if (companyId != null) { + companyRepository.deleteById(companyId); + } + if (userId != null) { + userRepository.deleteById(userId); + } + } + + private AuthSessionService.SessionTokens newSession() { + User user = userRepository.findById(userId).orElseThrow(); + return authSessionService.createSession(user, Instant.now(), null); + } + + // ── 核心缺陷：Refresh Token 访问普通接口 ───────────────────── + + @Test + void refreshTokenCannotAuthenticateOrdinaryEndpoint() throws Exception { + AuthSessionService.SessionTokens tokens = newSession(); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + tokens.refreshToken())) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString("Bearer")))) + .andExpect(content().string(not(containsString("com.mydreamjob")))); + } + + @Test + void accessTokenCanAuthenticateOrdinaryEndpoint() throws Exception { + AuthSessionService.SessionTokens tokens = newSession(); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + tokens.accessToken())) + .andExpect(status().isOk()); + } + + // ── Access 不能用于刷新 ───────────────────────────────────── + + @Test + void accessTokenCannotBeUsedAtRefreshEndpoint() throws Exception { + AuthSessionService.SessionTokens tokens = newSession(); + + mockMvc.perform(post("/auth/refresh") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"refreshToken\":\"" + tokens.accessToken() + "\"}")) + .andExpect(status().isUnauthorized()); + } + + // ── 无 type / 未知 type / 非法 claim ──────────────────────── + + @Test + void legacyTokenWithoutTypeIsRejected() throws Exception { + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + legacyToken())) + .andExpect(status().isUnauthorized()); + } + + @Test + void unknownTypeIsRejected() throws Exception { + String token = Jwts.builder() + .subject(String.valueOf(userId)) + .id(UUID.randomUUID().toString()) + .claim("type", "ACCESS") + .claim("sid", UUID.randomUUID().toString()) + .claim("role", "STUDENT") + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .issuedAt(new Date()) + .expiration(new Date(System.currentTimeMillis() + 3_600_000L)) + .signWith(key(accessSecret)) + .compact(); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + token)) + .andExpect(status().isUnauthorized()); + } + + @Test + void nonPositiveSubjectIsRejectedWithout500() throws Exception { + String token = Jwts.builder() + .subject("-1") + .id(UUID.randomUUID().toString()) + .claim("type", "access") + .claim("sid", UUID.randomUUID().toString()) + .claim("role", "STUDENT") + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .issuedAt(new Date()) + .expiration(new Date(System.currentTimeMillis() + 3_600_000L)) + .signWith(key(accessSecret)) + .compact(); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + token)) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString("NumberFormatException")))) + .andExpect(content().string(not(containsString("Exception")))); + } + + @Test + void malformedTokenIsRejectedWithoutLeakingInternals() throws Exception { + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer not.a.jwt")) + .andExpect(status().isUnauthorized()) + .andExpect(content().string(not(containsString("io.jsonwebtoken")))) + .andExpect(content().string(not(containsString("com.mydreamjob")))); + } + + // ── 撤销与禁用 ────────────────────────────────────────────── + + @Test + void revokedSessionCannotAuthenticate() throws Exception { + AuthSessionService.SessionTokens tokens = newSession(); + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + tokens.accessToken())) + .andExpect(status().isOk()); + + authSessionService.logout(userId, tokens.sessionId(), Instant.now(), null); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + tokens.accessToken())) + .andExpect(status().isUnauthorized()); + } + + @Test + void inactiveUserCannotAuthenticate() throws Exception { + AuthSessionService.SessionTokens tokens = newSession(); + + User user = userRepository.findById(userId).orElseThrow(); + user.setActive(false); + userRepository.saveAndFlush(user); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + tokens.accessToken())) + .andExpect(status().isUnauthorized()); + } + + @Test + void tokenForUnknownUserIsRejected() throws Exception { + // 签名合法、claim 齐备，但 sub 指向不存在的用户：服务端会话校验必须失败关闭。 + long unknownUserId = 999_999_999L; + String token = jwtTokenProvider.generateAccessToken( + unknownUserId, "STUDENT", UUID.randomUUID().toString(), UUID.randomUUID().toString(), Instant.now()) + .token(); + + mockMvc.perform(get("/auth/me").header("Authorization", "Bearer " + token)) + .andExpect(status().isUnauthorized()); + } + + // ── 工具 ──────────────────────────────────────────────────── + + private static SecretKey key(String secret) { + return Keys.hmacShaKeyFor(secret.getBytes(StandardCharsets.UTF_8)); + } + + /** 迁移前签发的旧格式 Token：无 type、无 sid、无 jti、无 iss/aud。 */ + private String legacyToken() { + return Jwts.builder() + .subject(String.valueOf(userId)) + .claim("phone", "13800000000") + .claim("role", "STUDENT") + .issuedAt(new Date()) + .expiration(new Date(System.currentTimeMillis() + 3_600_000L)) + .signWith(key(accessSecret)) + .compact(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtSecretOptionalStartupIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtSecretOptionalStartupIntegrationTest.java new file mode 100644 index 0000000..0d0a337 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtSecretOptionalStartupIntegrationTest.java @@ -0,0 +1,88 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AppJwtProperties; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ApplicationContext; +import org.springframework.data.redis.core.RedisTemplate; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.time.Instant; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * S02 复核项：只配置三个新密钥、**不配置旧 JWT_SECRET** 时应用仍可启动（任务书 §五）。 + * + *

    旧 {@code app.jwt.secret} 对 S02 的 Token 已无任何作用，但仍被 + * {@code talentdiscovery.CandidateKeyGenerator} 使用（该组件在密钥为空时自行失败关闭）， + * 因此保留属性但改为非强制解析。本测试证明： + * 1) 旧密钥为空时全量上下文仍能启动；2) 三项 S02 密钥正确绑定； + * 3) {@code application.yml} 中的旧密钥占位符带默认值，不再阻塞启动。

    + */ +@SpringBootTest(properties = { + "app.jwt.secret=", + "app.jwt.access-secret=test-access-secret-key-for-integration-tests-only-not-for-production", + "app.jwt.refresh-secret=test-refresh-secret-key-for-integration-tests-only-not-for-production", + "app.jwt.token-hash-secret=test-token-hash-secret-key-for-integration-tests-only-not-for-production", +}) +@org.springframework.test.context.ActiveProfiles("integration-test") +class JwtSecretOptionalStartupIntegrationTest { + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private ApplicationContext applicationContext; + + @Autowired + private AppJwtProperties jwtProperties; + + @Autowired + private JwtTokenProvider jwtTokenProvider; + + @Autowired + private AuthSessionService authSessionService; + + @Test + void contextStartsWithOnlyTheThreeNewSecrets() { + assertThat(applicationContext).isNotNull(); + assertThat(jwtTokenProvider).isNotNull(); + assertThat(authSessionService).isNotNull(); + + assertThat(jwtProperties.getSecret()) + .as("旧密钥为空也必须能启动").isNullOrEmpty(); + assertThat(jwtProperties.getAccessSecret()).isNotBlank(); + assertThat(jwtProperties.getRefreshSecret()).isNotBlank(); + assertThat(jwtProperties.getTokenHashSecret()).isNotBlank(); + assertThat(jwtProperties.getAccessSecret()) + .isNotEqualTo(jwtProperties.getRefreshSecret()); + } + + @Test + void accessAndRefreshNeverFallBackToLegacySecret() throws Exception { + // 旧密钥为空时，S02 的两类 Token 仍必须能正常签发与校验 —— 证明没有回退到它。 + Instant now = Instant.now(); + String sid = java.util.UUID.randomUUID().toString(); + IssuedToken access = jwtTokenProvider.generateAccessToken( + 1L, "STUDENT", sid, java.util.UUID.randomUUID().toString(), now); + IssuedToken refresh = jwtTokenProvider.generateRefreshToken( + 1L, sid, java.util.UUID.randomUUID().toString(), now); + + assertThat(jwtTokenProvider.parseAndValidateAccessToken(access.token(), now).userId()).isEqualTo(1L); + assertThat(jwtTokenProvider.parseAndValidateRefreshToken(refresh.token(), now).userId()).isEqualTo(1L); + } + + @Test + void applicationYmlNoLongerForcesLegacySecret() throws Exception { + Path yml = Path.of("src/main/resources/application.yml"); + String content = Files.readString(yml); + assertThat(content) + .as("旧密钥占位符必须带默认值，否则未配置 JWT_SECRET 的环境无法启动") + .contains("secret: ${JWT_SECRET:}"); + assertThat(content).doesNotContain("secret: ${JWT_SECRET}\n"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenProviderTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenProviderTest.java index 027fd71..8206512 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenProviderTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenProviderTest.java @@ -1,54 +1,85 @@ package com.mydreamjob.auth; -import io.jsonwebtoken.*; -import io.jsonwebtoken.security.Keys; +import com.mydreamjob.config.AppJwtProperties; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; -import java.nio.charset.StandardCharsets; -import java.util.Map; +import java.time.Instant; +import java.util.UUID; import static org.junit.jupiter.api.Assertions.*; +/** + * S02 {@link JwtTokenProvider} 基础行为。 + * + *

    原用例（生成、校验、过期、非法 Token）在 S02 新 API 下重写， + * 断言语义保持不变：合法 Token 可解析出用户、过期与非法 Token 一律拒绝。

    + * + *

    Access/Refresh 的类型与密钥隔离矩阵见 {@code JwtTokenTypeIsolationTest}。

    + */ class JwtTokenProviderTest { - private JwtTokenProvider jwtTokenProvider; + private static final Instant NOW = Instant.parse("2026-09-14T02:00:00Z"); + + private JwtTokenProvider provider; @BeforeEach void setUp() { - String secret = "test-secret-key-for-jwt-testing-at-least-256-bits-required-for-security"; - jwtTokenProvider = new JwtTokenProvider(secret, 3600000L, 86400000L); + provider = new JwtTokenProvider(properties(3_600_000L, 86_400_000L)); + } + + static AppJwtProperties properties(long accessMs, long refreshMs) { + AppJwtProperties p = new AppJwtProperties(); + p.setAccessSecret("test-access-secret-key-for-unit-tests-only-not-for-production"); + p.setRefreshSecret("test-refresh-secret-key-for-unit-tests-only-not-for-production"); + p.setTokenHashSecret("test-token-hash-secret-key-for-unit-tests-only-not-for-production"); + p.setExpirationMs(accessMs); + p.setRefreshExpirationMs(refreshMs); + p.setIssuer("mydreamjob"); + p.setAccessAudience("mydreamjob-api"); + p.setRefreshAudience("mydreamjob-auth"); + return p; + } + + static String uuid() { + return UUID.randomUUID().toString(); } @Test void testTokenGenerationAndValidation() { - String token = jwtTokenProvider.generateAccessToken(1L, "13800000001", Map.of("role", "STUDENT")); - assertNotNull(token); - assertTrue(jwtTokenProvider.validateToken(token)); - assertEquals(1L, jwtTokenProvider.parseUserId(token)); + IssuedToken issued = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + + assertNotNull(issued.token()); + AccessTokenClaims claims = provider.parseAndValidateAccessToken(issued.token(), NOW); + assertEquals(1L, claims.userId()); + assertEquals("STUDENT", claims.role()); + assertEquals(issued.sessionId(), claims.sessionId()); + assertEquals(issued.tokenId(), claims.tokenId()); } @Test void testRefreshToken() { - String token = jwtTokenProvider.generateRefreshToken(2L, "13800000002"); - assertNotNull(token); - assertTrue(jwtTokenProvider.validateToken(token)); - assertEquals(2L, jwtTokenProvider.parseUserId(token)); + IssuedToken issued = provider.generateRefreshToken(2L, uuid(), uuid(), NOW); + + assertNotNull(issued.token()); + RefreshTokenClaims claims = provider.parseAndValidateRefreshToken(issued.token(), NOW); + assertEquals(2L, claims.userId()); + assertEquals(issued.tokenId(), claims.tokenId()); } @Test void testExpiredToken() { - JwtTokenProvider shortLived = new JwtTokenProvider( - "test-secret-key-for-jwt-testing-at-least-256-bits-required-for-security", 1L, 86400000L); - try { - Thread.sleep(10); - } catch (InterruptedException ignored) {} - String token = shortLived.generateAccessToken(1L, "13800000001", null); - assertTrue(shortLived.isTokenExpired(token)); + // exp = NOW + 1ms；在 NOW + 2ms 校验即过期（边界为 exp <= capturedNow）。 + JwtTokenProvider shortLived = new JwtTokenProvider(properties(1L, 86_400_000L)); + IssuedToken issued = shortLived.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + + assertThrows(InvalidTokenException.class, () -> + shortLived.parseAndValidateAccessToken(issued.token(), NOW.plusMillis(2))); } @Test void testInvalidToken() { - assertFalse(jwtTokenProvider.validateToken("invalid-token")); + assertThrows(InvalidTokenException.class, () -> + provider.parseAndValidateAccessToken("invalid-token", NOW)); } } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenTypeIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenTypeIsolationTest.java new file mode 100644 index 0000000..621371f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/JwtTokenTypeIsolationTest.java @@ -0,0 +1,260 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.config.AppJwtProperties; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import javax.crypto.SecretKey; +import java.nio.charset.StandardCharsets; +import java.time.Instant; +import java.util.Date; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * S02 Token 类型与密钥隔离（设计 D01 / D02 / D06，任务书 §五 与 §十九）。 + * + *

    覆盖：类型 claim、独立签名密钥、issuer/audience、subject/sid/jti 校验、 + * 过期边界，以及新 Token 不再包含手机号。

    + */ +class JwtTokenTypeIsolationTest { + + private static final String ACCESS_SECRET = "test-access-secret-key-for-unit-tests-only-not-for-production"; + private static final String REFRESH_SECRET = "test-refresh-secret-key-for-unit-tests-only-not-for-production"; + private static final Instant NOW = Instant.parse("2026-09-14T02:00:00Z"); + + private JwtTokenProvider provider; + + @BeforeEach + void setUp() { + provider = new JwtTokenProvider(JwtTokenProviderTest.properties(3_600_000L, 86_400_000L)); + } + + private static String uuid() { + return UUID.randomUUID().toString(); + } + + // ── 类型隔离 ──────────────────────────────────────────────── + + @Test + void accessTokenCanOnlyBeParsedAsAccess() { + IssuedToken access = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + + AccessTokenClaims claims = provider.parseAndValidateAccessToken(access.token(), NOW); + assertEquals(1L, claims.userId()); + // accessTokenCannotBeUsedAtRefreshEndpoint（Provider 层） + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateRefreshToken(access.token(), NOW)); + } + + @Test + void refreshTokenCanOnlyBeParsedAsRefresh() { + IssuedToken refresh = provider.generateRefreshToken(1L, uuid(), uuid(), NOW); + + RefreshTokenClaims claims = provider.parseAndValidateRefreshToken(refresh.token(), NOW); + assertEquals(1L, claims.userId()); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(refresh.token(), NOW)); + } + + @Test + void accessAndRefreshTokensCannotCrossVerify() { + // 即使忽略 type，两类 Token 也因使用不同密钥而无法交叉验签（第二道隔离）。 + IssuedToken access = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + IssuedToken refresh = provider.generateRefreshToken(1L, uuid(), uuid(), NOW); + + String strippedAccess = resign(access.token(), ACCESS_SECRET, b -> b.claim("type", "refresh")); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateRefreshToken(strippedAccess, NOW)); + + String strippedRefresh = resign(refresh.token(), REFRESH_SECRET, b -> b.claim("type", "access")); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(strippedRefresh, NOW)); + } + + // ── 旧 Token / 未知 type ──────────────────────────────────── + + @Test + void legacyTokenWithoutTypeIsRejected() { + String legacy = Jwts.builder() + .subject("1") + .id(uuid()) + .claim("sid", uuid()) + .claim("role", "STUDENT") + .issuedAt(Date.from(NOW)) + .expiration(Date.from(NOW.plusSeconds(3600))) + .signWith(secretKey(ACCESS_SECRET)) + .compact(); + + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(legacy, NOW)); + } + + @Test + void unknownTypeIsRejected() { + String unknown = Jwts.builder() + .subject("1") + .id(uuid()) + .claim("type", "ACCESS") // 大小写不匹配，必须区分大小写 + .claim("sid", uuid()) + .claim("role", "STUDENT") + .issuedAt(Date.from(NOW)) + .expiration(Date.from(NOW.plusSeconds(3600))) + .signWith(secretKey(ACCESS_SECRET)) + .compact(); + + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(unknown, NOW)); + } + + // ── issuer / audience ─────────────────────────────────────── + + @Test + void wrongIssuerIsRejected() { + IssuedToken access = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + String wrongIssuer = resign(access.token(), ACCESS_SECRET, b -> b.issuer("somebody-else")); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(wrongIssuer, NOW)); + } + + @Test + void wrongAudienceIsRejected() { + IssuedToken access = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + String wrongAudience = resign(access.token(), ACCESS_SECRET, + b -> b.audience().clear().add("wrong-audience").and()); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(wrongAudience, NOW)); + } + + // ── claim 合法性 ──────────────────────────────────────────── + + @Test + void nonPositiveOrNonNumericSubjectIsRejected() { + for (String subject : new String[]{"0", "-5", "abc", ""}) { + String token = baseAccess(subject, uuid(), uuid()); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(token, NOW), + "subject 非法必须拒绝: " + subject); + } + } + + @Test + void nonUuidSidOrJtiIsRejected() { + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(baseAccess("1", "not-a-uuid", uuid()), NOW)); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(baseAccess("1", uuid(), "not-a-uuid"), NOW)); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(baseAccess("1", null, uuid()), NOW)); + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(baseAccess("1", uuid(), null), NOW)); + } + + @Test + void accessTokenWithoutRoleIsRejected() { + String token = Jwts.builder() + .subject("1") + .id(uuid()) + .claim("type", "access") + .claim("sid", uuid()) + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .issuedAt(Date.from(NOW)) + .expiration(Date.from(NOW.plusSeconds(3600))) + .signWith(secretKey(ACCESS_SECRET)) + .compact(); + + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(token, NOW)); + } + + // ── 过期边界 ──────────────────────────────────────────────── + + @Test + void expiryBoundaryIsExpLessOrEqualCapturedNow() { + JwtTokenProvider p = new JwtTokenProvider(JwtTokenProviderTest.properties(60_000L, 60_000L)); + IssuedToken access = p.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + Instant expiresAt = access.expiresAt(); + + // 边界前一刻仍有效 + assertEquals(1L, p.parseAndValidateAccessToken(access.token(), expiresAt.minusMillis(1)).userId()); + // 恰好到期即视为过期 + assertThrows(InvalidTokenException.class, + () -> p.parseAndValidateAccessToken(access.token(), expiresAt)); + assertThrows(InvalidTokenException.class, + () -> p.parseAndValidateAccessToken(access.token(), expiresAt.plusMillis(1))); + } + + // ── 不含手机号 ────────────────────────────────────────────── + + @Test + void newTokensDoNotContainPhone() { + IssuedToken access = provider.generateAccessToken(1L, "STUDENT", uuid(), uuid(), NOW); + IssuedToken refresh = provider.generateRefreshToken(1L, uuid(), uuid(), NOW); + + for (var entry : java.util.Map.of(access.token(), ACCESS_SECRET, refresh.token(), REFRESH_SECRET).entrySet()) { + var payload = rawParse(entry.getKey(), entry.getValue()); + assertFalse(payload.containsKey("phone"), "S02 新 Token 不得包含手机号"); + assertFalse(payload.containsKey("email")); + assertFalse(payload.containsKey("nickname")); + assertFalse(payload.containsKey("resumeUrl")); + } + } + + // ── 工具 ──────────────────────────────────────────────────── + + private static SecretKey secretKey(String secret) { + return Keys.hmacShaKeyFor(secret.getBytes(StandardCharsets.UTF_8)); + } + + /** 以合法 access token 的 claim 为底，替换 subject/sid/jti 后重新签名。 */ + private static String baseAccess(String subject, String sid, String jti) { + var b = Jwts.builder() + .claim("type", "access") + .claim("role", "STUDENT") + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .issuedAt(Date.from(NOW)) + .expiration(Date.from(NOW.plusSeconds(3600))); + if (subject != null) { + b.subject(subject); + } + if (sid != null) { + b.claim("sid", sid); + } + if (jti != null) { + b.id(jti); + } + return b.signWith(secretKey(ACCESS_SECRET)).compact(); + } + + /** 复制一个已签名 token 的 claim 并改写后重新签名（模拟攻击者无密钥伪造的等价物）。 */ + private static String resign(String token, String secret, + java.util.function.UnaryOperator mutate) { + var claims = rawParse(token, secret); + var builder = Jwts.builder() + .subject(claims.getSubject()) + .id(claims.getId()) + .issuedAt(claims.getIssuedAt()) + .expiration(claims.getExpiration()); + for (var e : claims.entrySet()) { + builder.claim(e.getKey(), e.getValue()); + } + return mutate.apply(builder).signWith(secretKey(secret)).compact(); + } + + /** + * 原始解析：仅用于测试构造与断言，时钟固定在很早的时间以免被真实时间判定过期。 + */ + private static io.jsonwebtoken.Claims rawParse(String token, String secret) { + return Jwts.parser() + .verifyWith(secretKey(secret)) + .clock(() -> Date.from(Instant.EPOCH)) + .build() + .parseSignedClaims(token) + .getPayload(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/LegacySeedAccountDisableMigrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/LegacySeedAccountDisableMigrationTest.java new file mode 100644 index 0000000..93029ec --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/LegacySeedAccountDisableMigrationTest.java @@ -0,0 +1,223 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.core.io.ClassPathResource; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * S03-A {@code V43__disable_legacy_seed_accounts.sql} 的行为验证。 + * + *

    直接读取并执行迁移文件中的语句，验证：完整指纹命中、任一单字段偏差不命中、 + * 非固定 ID 也能命中、重复执行幂等、关联数据保留、迁移文件本身的约束。

    + * + *

    V1_1 的种子账号仍占用原始手机号（唯一约束），因此用例开始前把它们移到哨兵指纹， + * 结束时原样恢复；用例自身插入的行按昵称前缀清理。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class LegacySeedAccountDisableMigrationTest { + + private static final String HASH = "$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi"; + private static final String TAG = "V43TEST_"; + private static final List SEED_PHONES = List.of("13800000001", "13800000002", "13800000003"); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private String migrationSql; + private final List> movedSeedRows = new ArrayList<>(); + + @BeforeEach + void setUp() throws IOException { + ClassPathResource res = new ClassPathResource("db/migration/V43__disable_legacy_seed_accounts.sql"); + migrationSql = new String(res.getInputStream().readAllBytes(), StandardCharsets.UTF_8); + + cleanupOwnRows(); + moveSeedRowsAside(); + } + + @AfterEach + void tearDown() { + cleanupOwnRows(); + restoreSeedRows(); + } + + private String seedPhoneList() { + return SEED_PHONES.stream().map(p -> "'" + p + "'").reduce((a, b) -> a + "," + b).orElse("''"); + } + + /** 把 V1_1 种子行移到哨兵指纹，腾出原始手机号与邮箱。 */ + private void moveSeedRowsAside() { + movedSeedRows.clear(); + movedSeedRows.addAll(jdbcTemplate.queryForList( + "SELECT id, phone, email FROM users WHERE phone IN (" + seedPhoneList() + ")")); + jdbcTemplate.update( + "UPDATE users SET phone = CONCAT('SEEDMVD', id), email = CONCAT('seedmvd', id, '@example.invalid') " + + "WHERE phone IN (" + seedPhoneList() + ")"); + } + + /** 把种子行恢复为最初的位置（不改动它们的 is_active 等状态）。 */ + private void restoreSeedRows() { + for (Map row : movedSeedRows) { + jdbcTemplate.update("UPDATE users SET phone = ?, email = ? WHERE id = ?", + row.get("phone"), row.get("email"), row.get("id")); + } + movedSeedRows.clear(); + } + + private void cleanupOwnRows() { + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE nickname LIKE ?)", TAG + "%"); + jdbcTemplate.update("DELETE FROM users WHERE nickname LIKE ?", TAG + "%"); + } + + /** + * 执行迁移文件中的全部 UPDATE 语句。 + * + *

    必须先逐行剥离 {@code --} 注释，否则首个语句块会以注释开头而被整体跳过 + * （那样"不命中"类断言会假通过）。

    + */ + private void runMigration() { + StringBuilder stripped = new StringBuilder(); + for (String line : migrationSql.split("\n")) { + if (line.trim().startsWith("--")) { + continue; + } + stripped.append(line).append('\n'); + } + for (String stmt : stripped.toString().split(";")) { + String s = stmt.trim(); + if (s.isEmpty()) { + continue; + } + jdbcTemplate.update(s); + } + } + + private long insertUser(String phone, String email, String hash, String role, int active, String nickname) { + jdbcTemplate.update( + "INSERT INTO users (phone, email, nickname, password_hash, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, ?, ?, 1)", + phone, email, nickname, hash, role, active); + Long id = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, ?)", id, role); + return id; + } + + private int activeOf(long id) { + Integer v = jdbcTemplate.queryForObject("SELECT is_active FROM users WHERE id = ?", Integer.class, id); + return v == null ? -1 : v; + } + + // ── 完整指纹命中 ──────────────────────────────────────────── + + @Test + void fullFingerprintMatchIsDisabled() { + long admin = insertUser("13800000001", "admin@mydreamjob.com", HASH, "ADMIN", 1, TAG + "admin"); + long student = insertUser("13800000002", "student@mydreamjob.com", HASH, "STUDENT", 1, TAG + "student"); + long company = insertUser("13800000003", "company@mydreamjob.com", HASH, "COMPANY", 1, TAG + "company"); + + runMigration(); + + assertThat(activeOf(admin)).as("ADMIN 原始指纹应被禁用").isZero(); + assertThat(activeOf(student)).as("STUDENT 原始指纹应被禁用").isZero(); + assertThat(activeOf(company)).as("COMPANY 原始指纹应被禁用").isZero(); + } + + @Test + void hitsRegardlessOfNumericId() { + long id = insertUser("13800000001", "admin@mydreamjob.com", HASH, "ADMIN", 1, TAG + "nonfixed"); + assertThat(id).as("用例应使用 1/2/3 之外的 id").isNotIn(1L, 2L, 3L); + + runMigration(); + assertThat(activeOf(id)).isZero(); + } + + // ── 任一单字段偏差不命中 ──────────────────────────────────── + + @Test + void singleFieldDeviationIsNotDisabled() { + long phoneChanged = insertUser("13800000099", "admin@mydreamjob.com", HASH, "ADMIN", 1, TAG + "phone"); + long emailChanged = insertUser("13800000001", "ops@mydreamjob.com", HASH, "ADMIN", 1, TAG + "email"); + long hashChanged = insertUser("13800000002", "student@mydreamjob.com", "$2a$10$DIFFERENTHASHVALUE", "STUDENT", 1, TAG + "hash"); + long roleChanged = insertUser("13800000003", "company@mydreamjob.com", HASH, "STUDENT", 1, TAG + "role"); + + runMigration(); + + assertThat(activeOf(phoneChanged)).as("改过手机号不应被禁用").isEqualTo(1); + assertThat(activeOf(emailChanged)).as("改过邮箱不应被禁用").isEqualTo(1); + assertThat(activeOf(hashChanged)).as("改过口令哈希不应被禁用").isEqualTo(1); + assertThat(activeOf(roleChanged)).as("改过角色不应被禁用").isEqualTo(1); + } + + @Test + void alreadyInactiveAccountIsNotMatched() { + long id = insertUser("13800000001", "admin@mydreamjob.com", HASH, "ADMIN", 0, TAG + "inactive"); + runMigration(); + assertThat(activeOf(id)).as("条件含 is_active = 1，已禁用行不再命中").isZero(); + } + + // ── 重复执行 ──────────────────────────────────────────────── + + @Test + void repeatedExecutionIsStable() { + long id = insertUser("13800000001", "admin@mydreamjob.com", HASH, "ADMIN", 1, TAG + "repeat"); + runMigration(); + assertThat(activeOf(id)).isZero(); + + runMigration(); + runMigration(); + + assertThat(activeOf(id)).as("重复执行后仍为 disabled").isZero(); + Integer rows = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = '13800000001' AND nickname = ?", Integer.class, TAG + "repeat"); + assertThat(rows).as("不得产生或删除记录").isEqualTo(1); + } + + // ── 关联数据保留 ──────────────────────────────────────────── + + @Test + void relatedRowsArePreserved() { + long id = insertUser("13800000003", "company@mydreamjob.com", HASH, "COMPANY", 1, TAG + "assoc"); + + runMigration(); + + Integer stillThere = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, id); + assertThat(stillThere).as("迁移不得删除用户记录").isEqualTo(1); + List> roles = jdbcTemplate.queryForList( + "SELECT role FROM user_roles WHERE user_id = ?", id); + assertThat(roles).as("迁移不得删除 user_roles 记录").hasSize(1); + assertThat(roles.get(0).get("role")).isEqualTo("COMPANY"); + } + + // ── 迁移文件本身的约束 ────────────────────────────────────── + + @Test + void migrationFileOnlyUpdatesIsActiveWithFiveFingerprints() { + assertThat(migrationSql).as("只允许 UPDATE users").doesNotContainIgnoringCase("DELETE FROM"); + assertThat(migrationSql).doesNotContainIgnoringCase("DROP "); + assertThat(migrationSql).doesNotContainIgnoringCase("TRUNCATE"); + for (String clause : new String[]{"phone =", "email =", "password_hash =", "role =", "is_active = 1"}) { + assertThat(migrationSql).as("匹配条件必须包含 " + clause).contains(clause); + } + int updates = migrationSql.split("(?i)UPDATE users").length - 1; + assertThat(updates).as("ADMIN/STUDENT/COMPANY 三条").isEqualTo(3); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationConcurrencyMySqlTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationConcurrencyMySqlTest.java new file mode 100644 index 0000000..d844d66 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationConcurrencyMySqlTest.java @@ -0,0 +1,180 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.auth.password.PasswordAuthenticationService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.script.RedisScript; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.test.annotation.DirtiesContext; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.time.Instant; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.when; + +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) +class PasswordAuthenticationConcurrencyMySqlTest { + + private static final AtomicLong PHONE_SEQUENCE = new AtomicLong(98200000000L); + private static final String OLD_PASSWORD = "Old-strong-password-2026"; + private static final String NEW_PASSWORD = "New-strong-password-2026"; + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("password_concurrency") + .withUsername("password_test") + .withPassword("password-test-only"); + + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate"); + registry.add("app.auth.password.enabled", () -> "true"); + registry.add("app.auth.password.rate-key-secret", + () -> "mysql-password-concurrency-secret-0001"); + } + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private UserRepository userRepository; + @Autowired private AuthTokenRepository authTokenRepository; + @Autowired private PasswordEncoder passwordEncoder; + @Autowired private PasswordAuthenticationService passwordAuthenticationService; + @Autowired private AuthSessionService authSessionService; + + private final List userIds = new ArrayList<>(); + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(redisTemplate.execute(any(RedisScript.class), anyList(), any(Object[].class))).thenReturn(1L); + } + + @AfterEach + void tearDown() { + for (Long userId : userIds) { + authTokenRepository.findAll().stream() + .filter(token -> userId.equals(token.getUserId())) + .forEach(authTokenRepository::delete); + userRepository.deleteById(userId); + } + userIds.clear(); + } + + @Test + void passwordLoginRacingWithChangeLeavesNoSessionAuthenticatedByOldPassword() throws Exception { + for (int round = 0; round < 10; round++) { + User user = createUser(); + RaceResult race = race( + () -> passwordAuthenticationService.login(user.getPhone(), OLD_PASSWORD, + "login-race", "127.0.0.1", "test"), + () -> passwordAuthenticationService.changePassword(user.getId(), OLD_PASSWORD, NEW_PASSWORD, + "change-race", "127.0.0.1", "test")); + + assertThat(race.rightError()).isNull(); + if (race.leftError() != null) { + assertThat(race.leftError()).isInstanceOf(BusinessException.class); + assertThat(((BusinessException) race.leftError()).getErrorCodeInt()) + .isEqualTo(ErrorCode.CREDENTIALS_INVALID.getCode()); + } + assertThat(passwordEncoder.matches(NEW_PASSWORD, + userRepository.findById(user.getId()).orElseThrow().getPasswordHash())).isTrue(); + assertThat(authTokenRepository.findByUserIdAndRevokedFalse(user.getId())).isEmpty(); + } + } + + @Test + void refreshRacingWithChangeLeavesNoActiveSuccessor() throws Exception { + for (int round = 0; round < 10; round++) { + User user = createUser(); + AuthSessionService.SessionTokens session = authSessionService.createSession(user, Instant.now(), null); + RaceResult race = race( + () -> authSessionService.refresh(session.refreshToken(), Instant.now(), null), + () -> passwordAuthenticationService.changePassword(user.getId(), OLD_PASSWORD, NEW_PASSWORD, + "refresh-change-race", "127.0.0.1", "test")); + + assertThat(race.rightError()).isNull(); + if (race.leftError() != null) { + assertThat(race.leftError()).isInstanceOf(InvalidTokenException.class); + } + assertThat(authTokenRepository.findByUserIdAndRevokedFalse(user.getId())).isEmpty(); + assertThat(authSessionService.isSessionActive(user.getId(), session.sessionId(), Instant.now())).isFalse(); + } + } + + private User createUser() { + User user = userRepository.save(User.builder() + .phone(Long.toString(PHONE_SEQUENCE.incrementAndGet())) + .nickname("密码并发测试") + .passwordHash(passwordEncoder.encode(OLD_PASSWORD)) + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()); + userIds.add(user.getId()); + return user; + } + + private RaceResult race(ThrowingCall left, ThrowingCall right) throws Exception { + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch ready = new CountDownLatch(2); + CountDownLatch start = new CountDownLatch(1); + Future leftResult = pool.submit(() -> invoke(left, ready, start)); + Future rightResult = pool.submit(() -> invoke(right, ready, start)); + assertThat(ready.await(10, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + Throwable leftError = leftResult.get(30, TimeUnit.SECONDS); + Throwable rightError = rightResult.get(30, TimeUnit.SECONDS); + pool.shutdownNow(); + return new RaceResult(leftError, rightError); + } + + private Throwable invoke(ThrowingCall call, CountDownLatch ready, CountDownLatch start) { + ready.countDown(); + try { + start.await(10, TimeUnit.SECONDS); + call.run(); + return null; + } catch (Throwable error) { + return error; + } + } + + @FunctionalInterface + private interface ThrowingCall { + void run() throws Exception; + } + + private record RaceResult(Throwable leftError, Throwable rightError) {} +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationDisabledIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationDisabledIntegrationTest.java new file mode 100644 index 0000000..4cac722 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationDisabledIntegrationTest.java @@ -0,0 +1,66 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.auth.password.PasswordAuthenticationService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.security.crypto.password.PasswordEncoder; +import org.springframework.test.context.ActiveProfiles; + +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.verifyNoInteractions; + +@SpringBootTest +@ActiveProfiles("integration-test") +class PasswordAuthenticationDisabledIntegrationTest { + + private static final AtomicLong PHONE_SEQUENCE = new AtomicLong(98300000000L); + + @MockBean private RedisTemplate redisTemplate; + @Autowired private UserRepository userRepository; + @Autowired private PasswordEncoder passwordEncoder; + @Autowired private PasswordAuthenticationService passwordAuthenticationService; + + private Long userId; + + @AfterEach + void tearDown() { + if (userId != null) { + userRepository.deleteById(userId); + } + } + + @Test + void disabledModuleRejectsPasswordChangeBeforePasswordOrSessionMutation() { + String originalHash = passwordEncoder.encode("Old-strong-password-2026"); + User user = userRepository.save(User.builder() + .phone(Long.toString(PHONE_SEQUENCE.incrementAndGet())) + .nickname("关闭开关测试") + .passwordHash(originalHash) + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()); + userId = user.getId(); + + assertThatThrownBy(() -> passwordAuthenticationService.changePassword( + userId, "Old-strong-password-2026", "New-strong-password-2026", + "disabled-test", "127.0.0.1", "test")) + .isInstanceOf(BusinessException.class) + .extracting(error -> ((BusinessException) error).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + + assertThat(userRepository.findById(userId).orElseThrow().getPasswordHash()).isEqualTo(originalHash); + verifyNoInteractions(redisTemplate); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationIntegrationTest.java new file mode 100644 index 0000000..4aa95da --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/PasswordAuthenticationIntegrationTest.java @@ -0,0 +1,216 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.auth.support.TestAuthTokens; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.script.RedisScript; +import org.springframework.http.MediaType; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.Instant; +import java.time.LocalDateTime; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.not; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +@TestPropertySource(properties = { + "app.auth.password.enabled=true", + "app.auth.password.rate-key-secret=01234567890123456789012345678901" +}) +class PasswordAuthenticationIntegrationTest { + + private static final AtomicLong SEQ = new AtomicLong(97000000000L); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private MockMvc mockMvc; + @Autowired + private UserRepository userRepository; + @Autowired + private AuthTokenRepository authTokenRepository; + @Autowired + private SmsVerificationCodeRepository codeRepository; + @Autowired + private PasswordEncoder passwordEncoder; + @Autowired + private AuthSessionService authSessionService; + + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(redisTemplate.execute(any(RedisScript.class), anyList(), any(Object[].class))).thenReturn(1L); + + String phone = Long.toString(SEQ.incrementAndGet()); + userId = userRepository.save(User.builder() + .phone(phone) + .nickname("密码测试") + .passwordHash(passwordEncoder.encode("Old-strong-password-2026")) + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + if (userId != null) { + authTokenRepository.findAll().stream() + .filter(token -> userId.equals(token.getUserId())) + .forEach(authTokenRepository::delete); + codeRepository.deleteAll(codeRepository.findByPhoneAndCreatedAtAfter( + userRepository.findById(userId).map(User::getPhone).orElse(""), + LocalDateTime.now().minusDays(1))); + userRepository.deleteById(userId); + } + } + + @Test + void passwordLoginReturnsTokensAndWrongPasswordIsUniform401() throws Exception { + String phone = userRepository.findById(userId).orElseThrow().getPhone(); + + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + phone + "\",\"password\":\"Old-strong-password-2026\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.accessToken").isString()) + .andExpect(jsonPath("$.data.refreshToken").isString()); + + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + phone + "\",\"password\":\"wrong-password-2026\"}")) + .andExpect(status().isUnauthorized()) + .andExpect(jsonPath("$.code").value(2005)) + .andExpect(jsonPath("$.message").value("手机号或密码错误")) + .andExpect(content().string(not(containsString(phone)))); + + String unknownPhone = "97123456789"; + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + unknownPhone + "\",\"password\":\"wrong-password-2026\"}")) + .andExpect(status().isUnauthorized()) + .andExpect(jsonPath("$.code").value(2005)) + .andExpect(jsonPath("$.message").value("手机号或密码错误")) + .andExpect(content().string(not(containsString(unknownPhone)))); + } + + @Test + void setPasswordUsesPurposeSpecificSmsCodeForUsersWithoutPassword() throws Exception { + User user = userRepository.findById(userId).orElseThrow(); + user.setPasswordHash(null); + userRepository.saveAndFlush(user); + AuthSessionService.SessionTokens session = authSessionService.createSession(user, Instant.now(), null); + codeRepository.save(SmsVerificationCode.builder() + .phone(user.getPhone()).purpose("password-set").code("654321") + .attempts(0).maxAttempts(5).used(false) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build()); + + mockMvc.perform(post("/auth/password/set") + .header("Authorization", "Bearer " + session.accessToken()) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"smsCode\":\"654321\",\"newPassword\":\"Set-strong-password-2026\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.passwordConfigured").value(true)) + .andExpect(jsonPath("$.data.reauthenticationRequired").value(true)); + + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + user.getPhone() + + "\",\"password\":\"Set-strong-password-2026\"}")) + .andExpect(status().isOk()); + } + + @Test + void changePasswordRevokesExistingSessionsAndNewPasswordLogsIn() throws Exception { + User user = userRepository.findById(userId).orElseThrow(); + AuthSessionService.SessionTokens session = authSessionService.createSession(user, Instant.now(), null); + String phone = user.getPhone(); + + mockMvc.perform(post("/auth/password/change") + .header("Authorization", "Bearer " + session.accessToken()) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"currentPassword\":\"Old-strong-password-2026\"," + + "\"newPassword\":\"New-strong-password-2026\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.reauthenticationRequired").value(true)); + + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + phone + "\",\"password\":\"New-strong-password-2026\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)); + } + + @Test + void resetPasswordRequiresPurposeSpecificSmsCode() throws Exception { + User user = userRepository.findById(userId).orElseThrow(); + String phone = user.getPhone(); + codeRepository.save(SmsVerificationCode.builder() + .phone(phone).purpose("password-reset").code("123456") + .attempts(0).maxAttempts(5).used(false) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build()); + + mockMvc.perform(post("/auth/password/reset") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + phone + "\",\"smsCode\":\"123456\"," + + "\"newPassword\":\"Reset-strong-password-2026\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)); + + mockMvc.perform(post("/auth/password/login") + .contentType(MediaType.APPLICATION_JSON) + .content("{\"phone\":\"" + phone + "\",\"password\":\"Reset-strong-password-2026\"}")) + .andExpect(status().isOk()); + } + + @Test + @SuppressWarnings("unchecked") + void redisFailurePreventsPasswordChangeAndLeavesExistingSessionActive() throws Exception { + User user = userRepository.findById(userId).orElseThrow(); + AuthSessionService.SessionTokens session = authSessionService.createSession(user, Instant.now(), null); + String originalHash = user.getPasswordHash(); + when(redisTemplate.execute(any(RedisScript.class), anyList(), any(Object[].class))) + .thenThrow(new IllegalStateException("redis unavailable probe")); + + mockMvc.perform(post("/auth/password/change") + .header("Authorization", "Bearer " + session.accessToken()) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"currentPassword\":\"Old-strong-password-2026\"," + + "\"newPassword\":\"New-strong-password-2026\"}")) + .andExpect(status().isServiceUnavailable()) + .andExpect(jsonPath("$.code").value(503)) + .andExpect(jsonPath("$.message") + .value("authentication service temporarily unavailable")) + .andExpect(content().string(not(containsString("redis unavailable probe")))); + + assertThat(userRepository.findById(userId).orElseThrow().getPasswordHash()).isEqualTo(originalHash); + assertThat(authSessionService.isSessionActive(userId, session.sessionId(), Instant.now())).isTrue(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02InactiveUserSessionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02InactiveUserSessionTest.java new file mode 100644 index 0000000..4f5ba42 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02InactiveUserSessionTest.java @@ -0,0 +1,121 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.Instant; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S02 复核项：不可用（active=false）用户不得获得会话或 Token（任务书 §五）。 + * + *

    要求**失败关闭**：不能先签发 Token 再依赖认证过滤器拒绝。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class S02InactiveUserSessionTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9300); + + @MockBean + private RedisTemplate redisTemplate; + + @MockBean + private SmsVerificationService smsVerificationService; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private AuthService authService; + + @Autowired + private UserRepository userRepository; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private Long inactiveUserId; + private String phone; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(smsVerificationService.verifyCode(any(), any(), any())).thenReturn(true); + + phone = "11" + String.format("%09d", PHONE_SEQ.incrementAndGet()); + inactiveUserId = userRepository.save(User.builder() + .phone(phone) + .nickname("S02 停用用户") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(false) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM audit_logs WHERE user_id = ?", inactiveUserId); + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", inactiveUserId); + if (inactiveUserId != null) { + userRepository.deleteById(inactiveUserId); + } + } + + private long tokenRows() { + return jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM auth_tokens WHERE user_id = ?", Long.class, inactiveUserId); + } + + @Test + void inactiveUserCannotCreateSession() { + User inactive = userRepository.findById(inactiveUserId).orElseThrow(); + + assertThatThrownBy(() -> authSessionService.createSession(inactive, Instant.now(), null)) + .as("停用用户不得创建会话") + .isInstanceOf(InvalidTokenException.class); + + assertThat(tokenRows()).as("不得写入任何 auth_tokens 记录").isZero(); + } + + @Test + void inactiveUserLoginDoesNotReturnTokenPair() { + assertThatThrownBy(() -> authService.mockLogin(phone, "123456", "login", "req", null, null)) + .as("停用用户登录必须失败关闭"); + + assertThat(tokenRows()).as("登录失败不得留下 Token 记录").isZero(); + } + + @Test + void inactiveUserLoginDoesNotPersistAuthToken() { + try { + Map result = authService.mockLogin(phone, "123456", "login", "req", null, null); + // 若未来语义变化为返回结果，则绝不允许携带 Token + assertThat(result).doesNotContainKeys("accessToken", "refreshToken"); + } catch (RuntimeException expected) { + // 预期路径：失败关闭 + } + assertThat(tokenRows()).isZero(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentClockAcceptanceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentClockAcceptanceTest.java new file mode 100644 index 0000000..5fc8cfd --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentClockAcceptanceTest.java @@ -0,0 +1,86 @@ +package com.mydreamjob.auth; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.sql.Timestamp; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** Independent S02 acceptance reproduction for persisted timestamp consistency. */ +@SpringBootTest +@ActiveProfiles("integration-test") +class S02IndependentClockAcceptanceTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(9800); + private static final Instant CAPTURED_NOW = Instant.parse("2026-01-02T03:04:05Z"); + private static final ZoneId ZONE = ZoneId.of("Asia/Shanghai"); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private UserRepository userRepository; + + @Autowired + private AuthSessionService authSessionService; + + @Autowired + private JdbcTemplate jdbcTemplate; + + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations operations = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(operations); + + userId = userRepository.save(User.builder() + .phone("12" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S02 independent clock") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true) + .verified(true) + .build()).getId(); + } + + @AfterEach + void tearDown() { + if (userId != null) { + jdbcTemplate.update("DELETE FROM audit_logs WHERE user_id = ?", userId); + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", userId); + userRepository.deleteById(userId); + } + } + + @Test + void persistedTokenCreatedAtMustUseCapturedNow() { + AuthSessionService.SessionTokens tokens = authSessionService.createSession( + userRepository.findById(userId).orElseThrow(), CAPTURED_NOW, null); + + Timestamp createdAt = jdbcTemplate.queryForObject( + "SELECT created_at FROM auth_tokens WHERE session_id = ?", + Timestamp.class, + tokens.sessionId()); + + assertThat(createdAt.toLocalDateTime()) + .isEqualTo(LocalDateTime.ofInstant(CAPTURED_NOW, ZONE)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentTokenValidationAcceptanceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentTokenValidationAcceptanceTest.java new file mode 100644 index 0000000..43bd8da --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/S02IndependentTokenValidationAcceptanceTest.java @@ -0,0 +1,65 @@ +package com.mydreamjob.auth; + +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.nio.charset.StandardCharsets; +import java.time.Instant; +import java.util.Date; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.assertThrows; + +/** Independent S02 acceptance reproductions; not part of the implementation test suite. */ +class S02IndependentTokenValidationAcceptanceTest { + + private static final String ACCESS_SECRET = + "test-access-secret-key-for-unit-tests-only-not-for-production"; + private static final Instant NOW = Instant.parse("2026-09-14T02:00:00Z"); + + private JwtTokenProvider provider; + + @BeforeEach + void setUp() { + provider = new JwtTokenProvider(JwtTokenProviderTest.properties(3_600_000L, 86_400_000L)); + } + + @Test + void accessTokenWithoutIssuedAtMustBeRejected() { + String token = Jwts.builder() + .subject("1") + .id(UUID.randomUUID().toString()) + .claim("type", "access") + .claim("sid", UUID.randomUUID().toString()) + .claim("role", "STUDENT") + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .expiration(Date.from(NOW.plusSeconds(3600))) + .signWith(Keys.hmacShaKeyFor(ACCESS_SECRET.getBytes(StandardCharsets.UTF_8))) + .compact(); + + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(token, NOW)); + } + + @Test + void accessTokenIssuedInFutureMustBeRejected() { + String token = Jwts.builder() + .subject("1") + .id(UUID.randomUUID().toString()) + .claim("type", "access") + .claim("sid", UUID.randomUUID().toString()) + .claim("role", "STUDENT") + .issuer("mydreamjob") + .audience().add("mydreamjob-api").and() + .issuedAt(Date.from(NOW.plusSeconds(60))) + .expiration(Date.from(NOW.plusSeconds(3600))) + .signWith(Keys.hmacShaKeyFor(ACCESS_SECRET.getBytes(StandardCharsets.UTF_8))) + .compact(); + + assertThrows(InvalidTokenException.class, + () -> provider.parseAndValidateAccessToken(token, NOW)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsEmptyPropertyStartupIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsEmptyPropertyStartupIntegrationTest.java new file mode 100644 index 0000000..13db68f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsEmptyPropertyStartupIntegrationTest.java @@ -0,0 +1,79 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.auth.sms.UnavailableSmsCodeSender; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ApplicationContext; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S01 定向整改 F3 核心回归：{@code app.sms.mock.enabled=} 空值下的 + * 全应用上下文启动。 + * + *

    整改前该取值会使两个互斥 {@code @ConditionalOnProperty} 都不匹配 → 0 个 + * {@code SmsCodeSender} Bean → 应用以 + * {@code APPLICATION FAILED TO START ... required a bean of type 'SmsCodeSender'} + * 直接启动失败。

    + * + *

    本测试以真实全量 Spring 上下文（H2 + Flyway）启动，证明：上下文启动成功、 + * {@link SmsVerificationService} 可注入、恰好一个 {@link SmsCodeSender}、 + * 类型为 {@link UnavailableSmsCodeSender}，且调用发送时安全失败。

    + */ +@SpringBootTest(properties = {"app.sms.mock.enabled="}) +@ActiveProfiles("integration-test") +class SmsEmptyPropertyStartupIntegrationTest { + + private static final String PHONE = "19900005678"; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private ApplicationContext applicationContext; + + @Autowired + private SmsVerificationService smsVerificationService; + + @BeforeEach + @SuppressWarnings("unchecked") + void stubRedis() { + // 不触发锁定/限流分支，使流程到达发送器调用 + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(redisTemplate.opsForValue()).thenReturn(mock(ValueOperations.class)); + } + + @Test + void emptyPropertyStartsContextWithExactlyOneUnavailableSender() { + assertThat(applicationContext.getBeanNamesForType(SmsCodeSender.class)) + .as("空值必须恰好装配一个 SmsCodeSender") + .hasSize(1); + assertThat(applicationContext.getBean(SmsCodeSender.class)) + .isInstanceOf(UnavailableSmsCodeSender.class); + assertThat(applicationContext) + .as("SmsVerificationService 必须可注入") + .isNotNull(); + assertThat(smsVerificationService).isNotNull(); + } + + @Test + void emptyPropertySenderFailsSafely() { + assertThatThrownBy(() -> smsVerificationService.sendCode(PHONE, "login", null, null, null)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> assertThat(((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode())); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsPurposeAllowlistTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsPurposeAllowlistTest.java new file mode 100644 index 0000000..ae205c8 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsPurposeAllowlistTest.java @@ -0,0 +1,27 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.common.exception.BusinessException; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.data.redis.core.RedisTemplate; + +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +@ExtendWith(MockitoExtension.class) +class SmsPurposeAllowlistTest { + @Mock SmsVerificationCodeRepository codes; + @Mock RedisTemplate redis; + @Mock AuditService audit; + @Mock SmsCodeSender sender; + + @Test + void rejectsArbitraryPurposeBeforeWritingCode() { + SmsVerificationService service = new SmsVerificationService(codes, redis, audit, sender); + assertThatThrownBy(() -> service.sendCode("19900000112", "arbitrary-purpose", null, null, null)) + .isInstanceOf(BusinessException.class); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsSenderConfigurationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsSenderConfigurationTest.java new file mode 100644 index 0000000..fade500 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsSenderConfigurationTest.java @@ -0,0 +1,230 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import com.mydreamjob.auth.sms.MockSmsCodeSender; +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.auth.sms.SmsSenderConfiguration; +import com.mydreamjob.auth.sms.UnavailableSmsCodeSender; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.Test; +import org.slf4j.LoggerFactory; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * S01 定向整改 F3：{@code app.sms.mock.enabled} 在 + * true / false / 缺失 / 空值 / 仅空白 / 大写 / 非法值下都必须装配 + * 恰好一个 {@link SmsCodeSender}，且只有显式 true 才启用 Mock。 + * + *

    全部用例使用真实 {@link ApplicationContextRunner} 装配（不直接 new 配置类、 + * 不测试字符串解析辅助函数、不使用 Mockito 验证）。

    + * + *

    {@link SenderConsumerProbe} 是消费者探针：它以构造参数方式依赖 + * {@link SmsCodeSender}，用于复现“构造注入时缺少 Bean”的原始缺陷场景； + * 它不生产 any SmsCodeSender，因此不会掩盖生产 Bean 缺失。

    + */ +class SmsSenderConfigurationTest { + + /** 仅消费、不生产 SmsCodeSender 的探针。 */ + static class SenderConsumerProbe { + final SmsCodeSender sender; + + SenderConsumerProbe(SmsCodeSender sender) { + this.sender = sender; + } + } + + private final ApplicationContextRunner runner = new ApplicationContextRunner() + .withUserConfiguration(SmsSenderConfiguration.class, SenderConsumerProbe.class); + + private static final String ACC_PHONE = "19900009999"; + private static final String ACC_CODE = "739251"; + + // ── 7 类取值行为 ──────────────────────────────────────────── + + @Test + void trueUsesMockSender() { + runner.withPropertyValues("app.sms.mock.enabled=true").run(context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(MockSmsCodeSender.class); + assertThat(context).doesNotHaveBean(UnavailableSmsCodeSender.class); + }); + } + + @Test + void falseUsesUnavailableSender() { + runner.withPropertyValues("app.sms.mock.enabled=false").run(context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(UnavailableSmsCodeSender.class); + assertThat(context).doesNotHaveBean(MockSmsCodeSender.class); + }); + } + + @Test + void missingPropertyUsesUnavailableSender() { + runner.run(context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(UnavailableSmsCodeSender.class); + }); + } + + @Test + void blankPropertyUsesUnavailableSender() { + // F3 核心回归：空值曾导致 0 个 Bean 与模糊 Spring 装配启动失败 + runner.withPropertyValues("app.sms.mock.enabled=").run(context -> { + assertThat(context) + .as("空值必须仍能启动且装配一个可用实现") + .hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(UnavailableSmsCodeSender.class); + assertThat(context).doesNotHaveBean(MockSmsCodeSender.class); + }); + } + + @Test + void whitespacePropertyUsesUnavailableSender() { + runner.withPropertyValues("app.sms.mock.enabled= ").run(context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(UnavailableSmsCodeSender.class); + assertThat(context).doesNotHaveBean(MockSmsCodeSender.class); + }); + } + + @Test + void invalidPropertyNeverEnablesMockSender() { + for (String invalid : new String[]{"yes", "1", "on", "enabled", "TRUE1", "mock", "null"}) { + runner.withPropertyValues("app.sms.mock.enabled=" + invalid).run(context -> { + assertThat(context).as("非法值 %s 不应导致启动失败", invalid).hasNotFailed(); + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)) + .as("非法值 %s 绝不允许启用 Mock", invalid) + .isInstanceOf(UnavailableSmsCodeSender.class); + assertThat(context).doesNotHaveBean(MockSmsCodeSender.class); + }); + } + } + + @Test + void uppercaseTrueBehaviorIsExplicit() { + // 明确语义：大小写不敏感 + 忽略两侧空白 → TRUE / True / " true " 视为启用 Mock + for (String accepted : new String[]{"TRUE", "True", " true ", "tRuE"}) { + runner.withPropertyValues("app.sms.mock.enabled=" + accepted).run(context -> { + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)) + .as("取值 [%s] 应视为显式启用 Mock", accepted) + .isInstanceOf(MockSmsCodeSender.class); + }); + } + } + + @Test + void everySupportedConfigurationCreatesExactlyOneSenderBean() { + String[] values = {"true", "false", "", " ", "TRUE", "yes", "1", "on", "null"}; + for (String value : values) { + runner.withPropertyValues("app.sms.mock.enabled=" + value).run(context -> { + assertThat(context).as("取值 [%s]", value).hasNotFailed(); + assertThat(context.getBeanNamesForType(SmsCodeSender.class)) + .as("取值 [%s] 必须恰好一个 SmsCodeSender Bean", value) + .hasSize(1); + }); + } + // 缺失属性 + runner.run(context -> { + assertThat(context).hasNotFailed(); + assertThat(context.getBeanNamesForType(SmsCodeSender.class)) + .as("缺失属性时必须恰好一个 SmsCodeSender Bean") + .hasSize(1); + }); + } + + // ── 空值场景的完整证据链（消费者注入 + 安全失败 + 无敏感日志）──── + + @Test + void blankPropertyStillAllowsConstructorInjectionIntoConsumer() { + runner.withPropertyValues("app.sms.mock.enabled=").run(context -> { + assertThat(context).hasNotFailed(); + // 复现原始缺陷场景：构造参数注入必须成功（曾因 0 个 Bean 失败） + SenderConsumerProbe probe = context.getBean(SenderConsumerProbe.class); + assertThat(probe.sender).isNotNull().isInstanceOf(UnavailableSmsCodeSender.class); + // 同一实例，证明容器内只有一个 Bean + assertThat(probe.sender).isSameAs(context.getBean(SmsCodeSender.class)); + }); + } + + @Test + void blankPropertySenderFailsSafelyWithoutLeakingOrLogging() { + ListAppender appender = new ListAppender<>(); + appender.start(); + Logger logger = (Logger) LoggerFactory.getLogger("com.mydreamjob.auth.sms"); + logger.addAppender(appender); + logger.setLevel(Level.TRACE); + try { + runner.withPropertyValues("app.sms.mock.enabled=").run(context -> { + SmsCodeSender sender = context.getBean(SmsCodeSender.class); + + assertThatThrownBy(() -> sender.sendVerificationCode(ACC_PHONE, "login", ACC_CODE)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> { + BusinessException be = (BusinessException) e; + assertThat(be.getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + assertThat(be.getMessage()) + .as("固定安全文本契约") + .isEqualTo("sms sender unavailable") + .doesNotContain(ACC_PHONE) + .doesNotContain(ACC_CODE) + .doesNotContainIgnoringCase("mock") + .doesNotContain("app.sms"); + }); + + String logs = appender.list.stream() + .map(ILoggingEvent::getFormattedMessage) + .reduce("", (a, b) -> a + '\n' + b); + assertThat(logs) + .doesNotContain(ACC_CODE) + .doesNotContain(ACC_PHONE) + .doesNotContain("app.sms.mock.enabled"); + }); + } finally { + logger.detachAppender(appender); + appender.stop(); + } + } + + @Test + void unavailableSenderDoesNotReturnFalseSuccess() { + runner.withPropertyValues("app.sms.mock.enabled=false").run(context -> { + SmsCodeSender sender = context.getBean(SmsCodeSender.class); + + assertThatThrownBy(() -> sender.sendVerificationCode(ACC_PHONE, "login", ACC_CODE)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> { + BusinessException be = (BusinessException) e; + assertThat(be.getErrorCodeInt()).isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + assertThat(be.getMessage()) + .doesNotContain(ACC_PHONE) + .doesNotContain(ACC_CODE) + .doesNotContainIgnoringCase("mock"); + }); + }); + } + + @Test + void mockSenderLoadsOnlyWhenExplicitlyEnabled() { + runner.withPropertyValues("app.sms.mock.enabled=true").run(context -> { + assertThat(context).hasSingleBean(SmsCodeSender.class); + assertThat(context.getBean(SmsCodeSender.class)).isInstanceOf(MockSmsCodeSender.class); + assertThat(context).doesNotHaveBean(UnavailableSmsCodeSender.class); + }); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsUnavailableSenderRollbackIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsUnavailableSenderRollbackIntegrationTest.java new file mode 100644 index 0000000..8f96813 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsUnavailableSenderRollbackIntegrationTest.java @@ -0,0 +1,115 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.auth.sms.UnavailableSmsCodeSender; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ApplicationContext; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S01 定向整改 —— 补充回归：不可用发送实现下的事务回滚。 + * + *

    本测试使用真实 Spring 上下文 + 真实 H2 + Flyway + 真实 + * {@link SmsVerificationService} 与真实 {@code @Transactional} 代理， + * 并在本测试类中把 {@code app.sms.mock.enabled} 覆盖为 {@code false}， + * 因此容器装配的是 {@link UnavailableSmsCodeSender}。

    + * + *

    测试类本身不加 {@code @Transactional}，以保证 + * {@code sendCode} 的事务独立提交/回滚，从而真实验证“发送失败不残留可用验证码”。

    + */ +@SpringBootTest(properties = {"app.sms.mock.enabled=false"}) +@ActiveProfiles("integration-test") +class SmsUnavailableSenderRollbackIntegrationTest { + + private static final String PHONE = "19900001234"; + private static final String PURPOSE = "login"; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired + private ApplicationContext applicationContext; + + @Autowired + private SmsVerificationService smsVerificationService; + + @Autowired + private SmsVerificationCodeRepository codeRepository; + + @Autowired + private AuditLogRepository auditLogRepository; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + } + + @Test + void containerProvidesExactlyOneUnavailableSenderWhenMockDisabled() { + assertThat(applicationContext.getBeanNamesForType(SmsCodeSender.class)) + .as("mock=false 时必须恰好一个 SmsCodeSender") + .hasSize(1); + assertThat(applicationContext.getBean(SmsCodeSender.class)) + .isInstanceOf(UnavailableSmsCodeSender.class); + } + + @Test + void unavailableSenderFailureLeavesNoVerificationCodeRow() { + // 清理本测试手机号的既有数据，保证断言只反映本次调用 + List pre = codeRepository.findByPhoneAndPurposeOrderByCreatedAtDesc(PHONE, PURPOSE); + if (!pre.isEmpty()) { + codeRepository.deleteAll(pre); + } + long beforeTotal = codeRepository.count(); + LocalDateTime since = LocalDateTime.now().minusMinutes(1); + long auditBefore = auditLogRepository.findByCreatedAtAfter(since).stream() + .filter(a -> "SMS_SEND".equals(a.getAction())) + .count(); + + assertThatThrownBy(() -> smsVerificationService.sendCode(PHONE, PURPOSE, "rollback-test", null, null)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> assertThat(((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode())); + + // 事务已回滚：不得残留该手机号的任何验证码行（不只是数量相等） + assertThat(codeRepository.findByPhoneAndPurposeOrderByCreatedAtDesc(PHONE, PURPOSE)) + .as("发送失败后不得残留可用验证码") + .isEmpty(); + assertThat(codeRepository.count()).isEqualTo(beforeTotal); + + // 失败不得产生“发送成功”审计 + long auditAfter = auditLogRepository.findByCreatedAtAfter(since).stream() + .filter(a -> "SMS_SEND".equals(a.getAction())) + .count(); + assertThat(auditAfter).isEqualTo(auditBefore); + } + + @Test + void unavailableSenderFailureDoesNotReturnFalseSuccess() { + assertThatThrownBy(() -> smsVerificationService.sendCode(PHONE, PURPOSE, null, null, null)) + .isInstanceOf(BusinessException.class) + .isNotInstanceOf(NumberFormatException.class); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationAtomicConsumptionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationAtomicConsumptionTest.java new file mode 100644 index 0000000..5dd6e4b --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationAtomicConsumptionTest.java @@ -0,0 +1,92 @@ +package com.mydreamjob.auth; + +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +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 org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; + +import java.time.LocalDateTime; +import java.util.stream.Stream; + +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class SmsVerificationAtomicConsumptionTest { + @Mock SmsVerificationCodeRepository codes; + @Mock RedisTemplate redis; + @Mock ValueOperations values; + @Mock AuditService audit; + @Mock SmsCodeSender sender; + @InjectMocks SmsVerificationService service; + + @BeforeEach + void noLockout() { + lenient().when(redis.hasKey(anyString())).thenReturn(false); + lenient().when(redis.opsForValue()).thenReturn(values); + } + + @Test + void successfulCodeUsesConditionalUpdateAndNeverEntitySave() { + SmsVerificationCode code = code(false, 0, 5); + when(codes.streamLatestUnusedByPhoneAndPurpose("19900000201", "company-register")) + .thenReturn(Stream.of(code)); + when(codes.consumeIfValid(eq(7L), any())).thenReturn(1); + code.setId(7L); + + assertTrue(service.verifyCode("19900000201", "123456", "company-register")); + verify(codes).consumeIfValid(eq(7L), any()); + verify(codes, never()).save(any(SmsVerificationCode.class)); + } + + @Test + void zeroAffectedRowsIsAConsumedOrInvalidCode() { + SmsVerificationCode code = code(false, 0, 5); + code.setId(8L); + when(codes.streamLatestUnusedByPhoneAndPurpose("19900000202", "company-register")) + .thenReturn(Stream.of(code)); + when(codes.consumeIfValid(eq(8L), any())).thenReturn(0); + + assertThatThrownBy(() -> service.verifyCode("19900000202", "123456", "company-register")) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt").isEqualTo(ErrorCode.SMS_CODE_INVALID.getCode()); + verify(codes, never()).save(any(SmsVerificationCode.class)); + } + + @Test + void unsupportedPurposeIsRejectedBeforeAnyReadOrUpdate() { + assertThatThrownBy(() -> service.verifyCode("19900000203", "123456", "arbitrary")) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt").isEqualTo(ErrorCode.BAD_REQUEST.getCode()); + verifyNoInteractions(codes); + } + + @Test + void attemptsAtLimitAreNotConsumedAgain() { + SmsVerificationCode code = code(false, 5, 5); + code.setId(9L); + when(codes.streamLatestUnusedByPhoneAndPurpose("19900000204", "company-register")) + .thenReturn(Stream.of(code)); + + assertThatThrownBy(() -> service.verifyCode("19900000204", "123456", "company-register")) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt").isEqualTo(ErrorCode.SMS_CODE_ATTEMPTS_EXCEEDED.getCode()); + verify(codes, never()).consumeIfValid(anyLong(), any()); + } + + private SmsVerificationCode code(boolean used, int attempts, int maxAttempts) { + return SmsVerificationCode.builder().id(7L).phone("19900000201").code("123456") + .purpose("company-register").used(used).attempts(attempts).maxAttempts(maxAttempts) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationSecurityTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationSecurityTest.java new file mode 100644 index 0000000..fafbff4 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationSecurityTest.java @@ -0,0 +1,336 @@ +package com.mydreamjob.auth; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.sms.MockSmsCodeSender; +import com.mydreamjob.auth.sms.SmsCodeSender; +import com.mydreamjob.auth.sms.UnavailableSmsCodeSender; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.slf4j.LoggerFactory; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.test.util.ReflectionTestUtils; + +import java.time.Duration; +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.TimeUnit; +import java.util.stream.Stream; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.lenient; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * S01 短信安全：验证码与手机号不得泄露到日志。 + * + *

    本测试不使用 Mockito 校验日志，而是挂载真实 Logback {@link ListAppender} + * 捕获实际日志事件后做字符串断言。

    + * + *

    生产语义不动：长度、有效期、最大尝试次数、锁定时间、一次性消费保持不变。

    + */ +@ExtendWith(MockitoExtension.class) +class SmsVerificationSecurityTest { + + /** 唯一敏感标记：手机号 */ + private static final String SENSITIVE_PHONE = "19900009999"; + private static final String PURPOSE = "login"; + private static final int EXPECTED_CODE_LENGTH = 6; + private static final int EXPECTED_EXPIRE_SECONDS = 300; + private static final int EXPECTED_MAX_ATTEMPTS = 5; + private static final int EXPECTED_LOCKOUT_SECONDS = 300; + + @Mock + private SmsVerificationCodeRepository codeRepository; + + @Mock + private RedisTemplate redisTemplate; + + @Mock + private ValueOperations valueOperations; + + @Mock + private AuditService auditService; + + @Mock + private SmsCodeSender smsCodeSender; + + @InjectMocks + private SmsVerificationService service; + + private Logger rootLogger; + private Logger appLogger; + private ListAppender appender; + private Level originalRootLevel; + private Level originalAppLevel; + + @BeforeEach + void setUp() { + ReflectionTestUtils.setField(service, "codeLength", EXPECTED_CODE_LENGTH); + ReflectionTestUtils.setField(service, "expireSeconds", EXPECTED_EXPIRE_SECONDS); + ReflectionTestUtils.setField(service, "maxAttempts", EXPECTED_MAX_ATTEMPTS); + ReflectionTestUtils.setField(service, "lockoutSeconds", EXPECTED_LOCKOUT_SECONDS); + lenient().when(redisTemplate.opsForValue()).thenReturn(valueOperations); + + // ── 挂载真实 Logback 捕获器（root + 应用包，覆盖 INFO/WARN/ERROR/DEBUG）── + rootLogger = (Logger) LoggerFactory.getLogger(Logger.ROOT_LOGGER_NAME); + appLogger = (Logger) LoggerFactory.getLogger("com.mydreamjob"); + originalRootLevel = rootLogger.getLevel(); + originalAppLevel = appLogger.getLevel(); + rootLogger.setLevel(Level.TRACE); + appLogger.setLevel(Level.TRACE); + appender = new ListAppender<>(); + appender.start(); + rootLogger.addAppender(appender); + } + + @AfterEach + void tearDown() { + rootLogger.detachAppender(appender); + appender.stop(); + rootLogger.setLevel(originalRootLevel); + appLogger.setLevel(originalAppLevel); + } + + private void stubSendAllowed() { + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(codeRepository.save(any(SmsVerificationCode.class))) + .thenAnswer(invocation -> invocation.getArgument(0)); + } + + private String capturedLogText() { + StringBuilder sb = new StringBuilder(); + for (ILoggingEvent event : appender.list) { + sb.append(event.getLevel()).append(' ') + .append(event.getFormattedMessage()).append('\n'); + if (event.getThrowableProxy() != null) { + sb.append(event.getThrowableProxy().getMessage()).append('\n'); + } + } + return sb.toString(); + } + + // ── 核心：生产语义下不得泄露验证码/手机号 ────────────────────── + + @Test + void productionProfileMustNotLogVerificationCodeOrFullPhone() { + stubSendAllowed(); + ArgumentCaptor captor = ArgumentCaptor.forClass(SmsVerificationCode.class); + + service.sendCode(SENSITIVE_PHONE, PURPOSE, "req-1", "127.0.0.1", "junit"); + + verify(codeRepository).save(captor.capture()); + String generatedCode = captor.getValue().getCode(); + assertThat(generatedCode).hasSize(EXPECTED_CODE_LENGTH); + + String logs = capturedLogText(); + assertThat(logs) + .as("日志不得包含验证码明文") + .doesNotContain(generatedCode); + assertThat(logs) + .as("日志不得包含完整手机号") + .doesNotContain(SENSITIVE_PHONE); + assertThat(logs) + .as("日志不得包含完整验证码的任何形式") + .doesNotContain("code=" + generatedCode); + } + + @Test + void smsLogsNeverContainCodePhoneTokenPasswordOrSecret() { + stubSendAllowed(); + ArgumentCaptor captor = ArgumentCaptor.forClass(SmsVerificationCode.class); + + service.sendCode(SENSITIVE_PHONE, PURPOSE, "req-2", "127.0.0.1", "junit"); + + // 同时触发锁定与限流分支，覆盖 WARN 级日志 + when(redisTemplate.hasKey(eq("sms:lockout:" + SENSITIVE_PHONE))).thenReturn(true); + assertThatThrownBy(() -> service.sendCode(SENSITIVE_PHONE, PURPOSE, "req-3", "127.0.0.1", "junit")) + .isInstanceOf(BusinessException.class); + + verify(codeRepository).save(captor.capture()); + String generatedCode = captor.getValue().getCode(); + + String logs = capturedLogText(); + assertThat(logs) + .doesNotContain(generatedCode) + .doesNotContain(SENSITIVE_PHONE) + .doesNotContainIgnoringCase("password") + .doesNotContainIgnoringCase("secret"); + } + + @Test + void auditDetailsMustNotContainFullPhone() { + stubSendAllowed(); + + service.sendCode(SENSITIVE_PHONE, PURPOSE, "req-4", "127.0.0.1", "junit"); + + ArgumentCaptor details = ArgumentCaptor.forClass(String.class); + verify(auditService).log(any(), eq("SMS_SEND"), eq("PHONE"), any(), details.capture(), + any(), any(), any()); + + assertThat(details.getValue()) + .as("审计明细不得记录完整手机号") + .doesNotContain(SENSITIVE_PHONE); + } + + // ── 生产语义回归：长度/有效期/尝试次数/锁定/一次性消费 ────────── + + @Test + void verificationExpiryRemainsUnchanged() { + stubSendAllowed(); + ArgumentCaptor captor = ArgumentCaptor.forClass(SmsVerificationCode.class); + LocalDateTime before = LocalDateTime.now(); + + service.sendCode(SENSITIVE_PHONE, PURPOSE, null, null, null); + + verify(codeRepository).save(captor.capture()); + SmsVerificationCode saved = captor.getValue(); + assertThat(saved.getCode()).hasSize(EXPECTED_CODE_LENGTH); + assertThat(saved.getExpiredAt()) + .isAfter(before.plusSeconds(EXPECTED_EXPIRE_SECONDS - 5)) + .isBefore(before.plusSeconds(EXPECTED_EXPIRE_SECONDS + 5)); + assertThat(saved.getMaxAttempts()).isEqualTo(EXPECTED_MAX_ATTEMPTS); + assertThat(saved.getUsed()).isFalse(); + assertThat(saved.getAttempts()).isZero(); + } + + @Test + void verificationAttemptLimitRemainsUnchanged() { + SmsVerificationCode stored = code("111111", 0, false); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(codeRepository.streamLatestUnusedByPhoneAndPurpose(SENSITIVE_PHONE, PURPOSE)) + .thenReturn(Stream.of(stored)); + ArgumentCaptor captor = ArgumentCaptor.forClass(SmsVerificationCode.class); + + assertThatThrownBy(() -> service.verifyCode(SENSITIVE_PHONE, "999999", PURPOSE)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> assertThat(((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SMS_CODE_INVALID.getCode())); + + verify(codeRepository).save(captor.capture()); + assertThat(captor.getValue().getAttempts()).isEqualTo(1); + assertThat(stored.getUsed()).isFalse(); + } + + @Test + void verificationLockoutRemainsUnchanged() { + SmsVerificationCode stored = code("111111", EXPECTED_MAX_ATTEMPTS, false); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(codeRepository.streamLatestUnusedByPhoneAndPurpose(SENSITIVE_PHONE, PURPOSE)) + .thenReturn(Stream.of(stored)); + + assertThatThrownBy(() -> service.verifyCode(SENSITIVE_PHONE, "111111", PURPOSE)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> assertThat(((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SMS_CODE_ATTEMPTS_EXCEEDED.getCode())); + + verify(valueOperations).set("sms:lockout:" + SENSITIVE_PHONE, "1", + (long) EXPECTED_LOCKOUT_SECONDS, TimeUnit.SECONDS); + } + + @Test + void successfulVerificationStillConsumesCodeOnce() { + SmsVerificationCode stored = code("654321", 0, false); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(codeRepository.streamLatestUnusedByPhoneAndPurpose(SENSITIVE_PHONE, PURPOSE)) + .thenReturn(Stream.of(stored)); + when(codeRepository.consumeIfValid(any(), any())).thenAnswer(invocation -> { + stored.setUsed(true); + return 1; + }); + + assertThat(service.verifyCode(SENSITIVE_PHONE, "654321", PURPOSE)).isTrue(); + assertThat(stored.getUsed()).isTrue(); + verify(codeRepository).consumeIfValid(any(), any()); + + // 重放：已使用记录不再被查询命中 + when(codeRepository.streamLatestUnusedByPhoneAndPurpose(SENSITIVE_PHONE, PURPOSE)) + .thenReturn(Stream.empty()); + assertThatThrownBy(() -> service.verifyCode(SENSITIVE_PHONE, "654321", PURPOSE)) + .isInstanceOf(BusinessException.class); + } + + @Test + void expiredCodeStillRejected() { + SmsVerificationCode expired = SmsVerificationCode.builder() + .phone(SENSITIVE_PHONE).code("222222").purpose(PURPOSE) + .expiredAt(LocalDateTime.now().minus(Duration.ofSeconds(1))) + .attempts(0).maxAttempts(EXPECTED_MAX_ATTEMPTS).used(false) + .createdAt(LocalDateTime.now().minus(Duration.ofMinutes(6))) + .build(); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + when(codeRepository.streamLatestUnusedByPhoneAndPurpose(SENSITIVE_PHONE, PURPOSE)) + .thenReturn(Stream.of(expired)); + + assertThatThrownBy(() -> service.verifyCode(SENSITIVE_PHONE, "222222", PURPOSE)) + .isInstanceOf(BusinessException.class) + .satisfies(e -> assertThat(((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SMS_CODE_EXPIRED.getCode())); + verify(codeRepository, never()).save(any(SmsVerificationCode.class)); + } + + // ── 发送实现安全边界 ─────────────────────────────────────────── + + @Test + void mockSenderMustNotLogCodeOrPhone() { + ListAppender senderAppender = new ListAppender<>(); + senderAppender.start(); + Logger senderLogger = (Logger) LoggerFactory.getLogger(MockSmsCodeSender.class); + senderLogger.addAppender(senderAppender); + senderLogger.setLevel(Level.TRACE); + try { + new MockSmsCodeSender().sendVerificationCode(SENSITIVE_PHONE, PURPOSE, "739251"); + + String logs = senderAppender.list.stream() + .map(ILoggingEvent::getFormattedMessage) + .reduce("", (a, b) -> a + '\n' + b); + assertThat(logs).doesNotContain("739251").doesNotContain(SENSITIVE_PHONE); + } finally { + senderLogger.detachAppender(senderAppender); + senderAppender.stop(); + } + } + + @Test + void unavailableSenderFailsSafelyWithoutLeaking() { + assertThatThrownBy(() -> + new UnavailableSmsCodeSender().sendVerificationCode(SENSITIVE_PHONE, PURPOSE, "739251")) + .isInstanceOf(BusinessException.class) + .satisfies(e -> { + BusinessException be = (BusinessException) e; + assertThat(be.getErrorCodeInt()).isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + assertThat(be.getMessage()) + .doesNotContain(SENSITIVE_PHONE) + .doesNotContain("739251") + .doesNotContainIgnoringCase("mock") + .doesNotContain("app.sms"); + }); + } + + private SmsVerificationCode code(String value, int attempts, boolean used) { + return SmsVerificationCode.builder() + .phone(SENSITIVE_PHONE).code(value).purpose(PURPOSE) + .expiredAt(LocalDateTime.now().plusSeconds(EXPECTED_EXPIRE_SECONDS)) + .attempts(attempts).maxAttempts(EXPECTED_MAX_ATTEMPTS).used(used) + .createdAt(LocalDateTime.now()) + .build(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationServiceTest.java index d3b689d..d0ef351 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/SmsVerificationServiceTest.java @@ -1,6 +1,7 @@ package com.mydreamjob.auth; import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.sms.SmsCodeSender; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import org.junit.jupiter.api.BeforeEach; @@ -35,6 +36,9 @@ class SmsVerificationServiceTest { @Mock private AuditService auditService; + @Mock + private SmsCodeSender smsCodeSender; + @InjectMocks private SmsVerificationService smsVerificationService; @@ -70,10 +74,10 @@ class SmsVerificationServiceTest { when(redisTemplate.hasKey(anyString())).thenReturn(false); when(codeRepository.streamLatestUnusedByPhoneAndPurpose("13800000001", "login")) .thenReturn(java.util.stream.Stream.of(code)); + when(codeRepository.consumeIfValid(any(), any())).thenReturn(1); assertDoesNotThrow(() -> smsVerificationService.verifyCode("13800000001", "123456", "login")); - assertTrue(code.getUsed()); - verify(codeRepository, times(1)).save(code); + verify(codeRepository, times(1)).consumeIfValid(any(), any()); } @Test @@ -83,6 +87,7 @@ class SmsVerificationServiceTest { // 第一次验证通过后 used=true when(codeRepository.streamLatestUnusedByPhoneAndPurpose("13800000001", "login")) .thenReturn(java.util.stream.Stream.of(code)); + when(codeRepository.consumeIfValid(any(), any())).thenReturn(1); // 第一次成功 smsVerificationService.verifyCode("13800000001", "123456", "login"); @@ -137,6 +142,7 @@ class SmsVerificationServiceTest { // repository 按 createdAt DESC 返回，第一个是最新的 when(codeRepository.streamLatestUnusedByPhoneAndPurpose("13800000001", "login")) .thenReturn(java.util.stream.Stream.of(newCode)); + when(codeRepository.consumeIfValid(any(), any())).thenReturn(1); assertDoesNotThrow(() -> smsVerificationService.verifyCode("13800000001", "123456", "login")); // 旧验证码 999999 不应被验证通过 diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationConcurrencyMySqlTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationConcurrencyMySqlTest.java new file mode 100644 index 0000000..ae6ab09 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationConcurrencyMySqlTest.java @@ -0,0 +1,119 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.auth.*; +import com.mydreamjob.company.CompanyRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +@Testcontainers(disabledWithoutDocker = false) +@SpringBootTest +@ActiveProfiles("mysql-it") +class CompanyRegistrationConcurrencyMySqlTest { + private static final String PHONE = "19900000321"; + private static final String CODE = "123456"; + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("company_registration_concurrency") + .withUsername("company_registration_test") + .withPassword("company-registration-test"); + + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("app.company-registration.enabled", () -> "true"); + } + + @Autowired CompanyRegistrationService service; + @Autowired SmsVerificationCodeRepository codes; + @Autowired UserRepository users; + @Autowired CompanyRepository companies; + @Autowired JdbcTemplate jdbc; + @MockBean RedisTemplate redis; + + @AfterEach + void cleanup() { + jdbc.update("DELETE FROM auth_tokens WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM companies WHERE owner_user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM users WHERE phone = ?", PHONE); + jdbc.update("DELETE FROM sms_verification_codes WHERE phone = ?", PHONE); + } + + @Test + void oneCodeCanCreateOnlyOneCompanyIdentityWithoutTimingSleeps() throws Exception { + when(redis.hasKey(anyString())).thenReturn(false); + codes.saveAndFlush(SmsVerificationCode.builder().phone(PHONE).purpose("company-register") + .code(CODE).attempts(0).maxAttempts(5).used(false) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build()); + + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch ready = new CountDownLatch(2); + CountDownLatch start = new CountDownLatch(1); + List> futures = new ArrayList<>(); + for (int i = 0; i < 2; i++) { + futures.add(pool.submit(() -> { + ready.countDown(); + assertThat(start.await(10, TimeUnit.SECONDS)).isTrue(); + try { + return service.register(request(), AuditContext.builder().build()); + } catch (Throwable error) { + return error; + } + })); + } + assertThat(ready.await(10, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + Object first = futures.get(0).get(30, TimeUnit.SECONDS); + Object second = futures.get(1).get(30, TimeUnit.SECONDS); + pool.shutdownNow(); + + long successes = List.of(first, second).stream().filter(CompanyRegistrationResponse.class::isInstance).count(); + assertThat(successes).isEqualTo(1); + assertThat(users.findAll().stream().filter(u -> PHONE.equals(u.getPhone())).count()).isEqualTo(1); + Long userId = users.findByPhone(PHONE).orElseThrow().getId(); + assertThat(jdbc.queryForList("SELECT role FROM user_roles WHERE user_id = ?", String.class, userId)) + .containsExactly("COMPANY"); + assertThat(companies.findByOwnerUserId(userId)).isPresent(); + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM auth_tokens WHERE user_id = ?", Long.class, userId)) + .isEqualTo(1L); + assertThat(List.of(first, second).stream().filter(Throwable.class::isInstance) + .map(Object::toString).allMatch(text -> !text.contains("SQL") && !text.contains("phone"))).isTrue(); + } + + private CompanyRegistrationRequest request() { + CompanyRegistrationRequest request = new CompanyRegistrationRequest(); + request.setPhone(PHONE); request.setCode(CODE); request.setPassword("Company-strong-password-2026"); + CompanyRegistrationRequest.CompanyDetails details = new CompanyRegistrationRequest.CompanyDetails(); + details.setName("并发企业"); details.setIndustry("互联网"); details.setDescription("简介"); details.setAddress("地址"); + request.setCompany(details); + return request; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationFeatureFlagTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationFeatureFlagTest.java new file mode 100644 index 0000000..79eb411 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationFeatureFlagTest.java @@ -0,0 +1,55 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.Test; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Configuration; + +import static org.assertj.core.api.Assertions.assertThat; + +class CompanyRegistrationFeatureFlagTest { + @Test + void defaultIsClosed() { + assertThat(new CompanyRegistrationProperties().isEnabled()).isFalse(); + } + + @Test + void onlyBooleanTrueEnablesTheSwitch() { + CompanyRegistrationProperties properties = new CompanyRegistrationProperties(); + properties.setEnabled("true"); + assertThat(properties.isEnabled()).isTrue(); + properties.setEnabled("false"); + assertThat(properties.isEnabled()).isFalse(); + } + + @Test + void springBindingAcceptsOnlyExactLowercaseTrue() { + ApplicationContextRunner runner = new ApplicationContextRunner() + .withUserConfiguration(BindingConfiguration.class); + + for (String value : new String[]{"TRUE", "True", "yes", "1", "on", "false"}) { + runner.withPropertyValues("app.company-registration.enabled=" + value) + .run(context -> assertThat(context.getBean(CompanyRegistrationProperties.class).isEnabled()) + .as("feature flag value %s", value) + .isFalse()); + } + + runner.withPropertyValues("app.company-registration.enabled=true") + .run(context -> assertThat(context.getBean(CompanyRegistrationProperties.class).isEnabled()) + .isTrue()); + } + + @Test + void disabledErrorIsStableAndDoesNotExposeRequestData() { + BusinessException error = new BusinessException(ErrorCode.COMPANY_REGISTRATION_DISABLED); + assertThat(error.getErrorMessage()).isEqualTo("company registration is disabled"); + assertThat(error.getMessage()).doesNotContain("phone", "password", "code"); + } + + @Configuration(proxyBeanMethods = false) + @EnableConfigurationProperties(CompanyRegistrationProperties.class) + static class BindingConfiguration { + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationIntegrationTest.java new file mode 100644 index 0000000..ba80642 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationIntegrationTest.java @@ -0,0 +1,133 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.auth.AuthTokenRepository; +import com.mydreamjob.auth.SmsVerificationCode; +import com.mydreamjob.auth.SmsVerificationCodeRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +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.http.MediaType; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.TestPropertySource; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +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") +@TestPropertySource(properties = "app.company-registration.enabled=true") +class CompanyRegistrationIntegrationTest { + private static final String PHONE = "19900000121"; + private static final String CODE = "123456"; + private static final String PASSWORD = "Company-strong-password-2026"; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private org.springframework.test.web.servlet.MockMvc mockMvc; + @Autowired private UserRepository userRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private SmsVerificationCodeRepository codeRepository; + @Autowired private AuthTokenRepository authTokenRepository; + @Autowired private PasswordEncoder passwordEncoder; + @Autowired private JdbcTemplate jdbcTemplate; + + @Test + @Transactional + void companyRegisterCreatesCompanyIdentityAndSessionAndOnboardingView() throws Exception { + when(redisTemplate.hasKey(anyString())).thenReturn(false); + codeRepository.saveAndFlush(SmsVerificationCode.builder() + .phone(PHONE).purpose("company-register").code(CODE) + .attempts(0).maxAttempts(5).used(false) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build()); + + String body = """ + {"phone":"%s","code":"%s","password":"%s","company": + {"name":"示例科技","industry":"互联网","description":"企业简介", + "website":"https://example.com","address":"上海"}} + """.formatted(PHONE, CODE, PASSWORD); + + String response = mockMvc.perform(post("/auth/company/register") + .contentType(MediaType.APPLICATION_JSON).content(body) + .header("X-Request-Id", "company-register-it")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.userId").isNumber()) + .andExpect(jsonPath("$.data.companyId").isNumber()) + .andExpect(jsonPath("$.data.role").value("COMPANY")) + .andExpect(jsonPath("$.data.onboardingStatus").value("UNVERIFIED")) + .andExpect(jsonPath("$.data.accessToken").isString()) + .andExpect(jsonPath("$.data.refreshToken").isString()) + .andReturn().getResponse().getContentAsString(); + + assertThat(response).doesNotContain(PASSWORD).doesNotContain("passwordHash"); + User user = userRepository.findByPhone(PHONE).orElseThrow(); + assertThat(user.getRole()).isEqualTo(User.Role.COMPANY); + assertThat(user.getRoles()).containsExactly(User.Role.COMPANY); + assertThat(user.getActive()).isTrue(); + assertThat(user.getVerified()).isFalse(); + assertThat(user.getPasswordChangedAt()).isNotNull(); + assertThat(passwordEncoder.matches(PASSWORD, user.getPasswordHash())).isTrue(); + + Company company = companyRepository.findByOwnerUserId(user.getId()).orElseThrow(); + assertThat(company.getVerified()).isFalse(); + assertThat(jdbcTemplate.queryForList( + "SELECT role FROM user_roles WHERE user_id = ?", String.class, user.getId())) + .containsExactly("COMPANY"); + assertThat(authTokenRepository.findAll().stream() + .filter(token -> user.getId().equals(token.getUserId())).toList()).hasSize(1); + assertThat(codeRepository.findByPhoneAndPurposeOrderByCreatedAtDesc(PHONE, "company-register")) + .first().extracting(SmsVerificationCode::getUsed).isEqualTo(true); + + String accessToken = com.fasterxml.jackson.databind.json.JsonMapper.builder().build() + .readTree(response).path("data").path("accessToken").asText(); + mockMvc.perform(get("/companies/me/onboarding") + .header("Authorization", "Bearer " + accessToken)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.onboardingStatus").value("UNVERIFIED")) + .andExpect(jsonPath("$.data.company.verified").value(false)) + .andExpect(jsonPath("$.data.missingFields").isArray()) + .andExpect(jsonPath("$.data.allowedActions[0]").value("UPDATE_PROFILE")); + } + + @Test + void invalidRequestShapeIsRejectedBeforePersistence() throws Exception { + mockMvc.perform(post("/auth/company/register") + .contentType(MediaType.APPLICATION_JSON) + .content(""" + {"phone":"bad","code":"123","password":"weak","company":null} + """)) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(400)); + } + + @Test + void companyRegisterDoesNotAcceptClientRoleOrVerificationFields() throws Exception { + mockMvc.perform(post("/auth/company/register") + .contentType(MediaType.APPLICATION_JSON) + .content(""" + {"phone":"19900000122","code":"123456","password":"Company-strong-password-2026", + "role":"ADMIN","verified":true,"passwordHash":"leak", + "company":{"name":"示例科技","industry":"互联网","description":"企业简介","address":"上海"}} + """)) + .andExpect(status().isBadRequest()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationSensitiveDataTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationSensitiveDataTest.java new file mode 100644 index 0000000..286e80d --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationSensitiveDataTest.java @@ -0,0 +1,76 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.AuthSessionService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.password.PasswordPolicy; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.deletion.AccountDeletionPhoneHasher; +import com.mydreamjob.deletion.AccountDeletionRepository; +import org.junit.jupiter.api.Test; +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +class CompanyRegistrationSensitiveDataTest { + @Test + void responseAndAuditContainNoPasswordCodePhoneHashOrToken() { + String phone = "19900000301"; + String password = "Company-strong-password-2026"; + CompanyRegistrationProperties properties = new CompanyRegistrationProperties(); + properties.setEnabled("true"); + SmsVerificationService sms = mock(SmsVerificationService.class); + UserRepository users = mock(UserRepository.class); + CompanyRepository companies = mock(CompanyRepository.class); + AccountDeletionRepository deletions = mock(AccountDeletionRepository.class); + AccountDeletionPhoneHasher hasher = mock(AccountDeletionPhoneHasher.class); + AuthSessionService sessions = mock(AuthSessionService.class); + AuditService audit = mock(AuditService.class); + when(hasher.hash(phone)).thenReturn("h"); + when(deletions.findByDeletedPhoneHash("h")).thenReturn(Optional.empty()); + when(users.findByPhoneForUpdate(phone)).thenReturn(Optional.empty()); + when(users.saveAndFlush(any(User.class))).thenAnswer(invocation -> { + User user = invocation.getArgument(0); + user.setId(301L); + return user; + }); + when(companies.saveAndFlush(any(Company.class))).thenAnswer(invocation -> { + Company company = invocation.getArgument(0); + company.setId(401L); + return company; + }); + when(sessions.createSession(any(), any(), any())) + .thenReturn(new AuthSessionService.SessionTokens("access-secret", "refresh-secret", "sid")); + + CompanyRegistrationService service = new CompanyRegistrationService(properties, sms, users, companies, + new PasswordPolicy(), new BCryptPasswordEncoder(), deletions, hasher, sessions, audit, + Clock.fixed(Instant.parse("2026-09-22T00:00:00Z"), ZoneOffset.UTC)); + CompanyRegistrationRequest request = new CompanyRegistrationRequest(); + request.setPhone(phone); + request.setCode("123456"); + request.setPassword(password); + CompanyRegistrationRequest.CompanyDetails details = new CompanyRegistrationRequest.CompanyDetails(); + details.setName("安全测试企业"); + details.setIndustry("互联网"); + details.setDescription("简介"); + details.setAddress("地址"); + request.setCompany(details); + + CompanyRegistrationResponse response = service.register(request, AuditContext.builder().build()); + assertThat(response.toString()).doesNotContain(phone, password); + verify(audit).logRequired(anyLong(), eq("COMPANY_REGISTERED"), anyString(), anyLong(), + argThat(detailsText -> !detailsText.contains(phone) && !detailsText.contains(password)), + any(), any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationServiceTest.java new file mode 100644 index 0000000..03397ce --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationServiceTest.java @@ -0,0 +1,144 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.AuthSessionService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.password.PasswordPolicy; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.deletion.AccountDeletionPhoneHasher; +import com.mydreamjob.deletion.AccountDeletionRepository; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.dao.DataAccessResourceFailureException; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class CompanyRegistrationServiceTest { + private static final String PHONE = "19900000111"; + + @Mock SmsVerificationService sms; + @Mock UserRepository users; + @Mock CompanyRepository companies; + @Mock AccountDeletionRepository deletions; + @Mock AccountDeletionPhoneHasher hasher; + @Mock AuthSessionService sessions; + @Mock AuditService audit; + + private final PasswordEncoder encoder = new BCryptPasswordEncoder(); + private final PasswordPolicy policy = new PasswordPolicy(); + private CompanyRegistrationProperties properties; + private CompanyRegistrationService service; + + @BeforeEach + void setUp() { + properties = new CompanyRegistrationProperties(); + properties.setEnabled("true"); + service = new CompanyRegistrationService(properties, sms, users, companies, policy, encoder, + deletions, hasher, sessions, audit, + Clock.fixed(Instant.parse("2026-09-22T00:00:00Z"), ZoneOffset.UTC)); + } + + @Test + void createsCompanyUserCompanyAndSession() { + when(hasher.hash(PHONE)).thenReturn("phone-hash"); + when(deletions.findByDeletedPhoneHash("phone-hash")).thenReturn(Optional.empty()); + when(users.findByPhoneForUpdate(PHONE)).thenReturn(Optional.empty()); + when(users.saveAndFlush(any(User.class))).thenAnswer(inv -> { + User u = inv.getArgument(0); + u.setId(11L); + return u; + }); + when(companies.saveAndFlush(any(Company.class))).thenAnswer(inv -> { + Company c = inv.getArgument(0); + c.setId(21L); + return c; + }); + when(sessions.createSession(any(), any(), any())) + .thenReturn(new AuthSessionService.SessionTokens("access", "refresh", "sid")); + + CompanyRegistrationResponse result = service.register(request(), AuditContext.builder().build()); + + assertThat(result.role()).isEqualTo("COMPANY"); + assertThat(result.onboardingStatus()).isEqualTo("UNVERIFIED"); + verify(sms).verifyCode(PHONE, "123456", "company-register"); + verify(users).saveAndFlush(argThat(u -> u.getRole() == User.Role.COMPANY + && u.getRoles().contains(User.Role.COMPANY) + && u.getRoles().size() == 1 + && !u.getVerified() + && u.getPasswordHash() != null)); + verify(companies).saveAndFlush(argThat(c -> c.getOwnerUserId().equals(11L) + && !c.getVerified())); + verify(audit).logRequired(eq(11L), eq("COMPANY_REGISTERED"), eq("COMPANY"), eq(21L), + anyString(), any(), any()); + } + + @Test + void disabledRegistrationFailsBeforeSmsConsumption() { + properties.setEnabled("false"); + assertThatThrownBy(() -> service.register(request(), AuditContext.builder().build())) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt").isEqualTo(ErrorCode.COMPANY_REGISTRATION_DISABLED.getCode()); + verifyNoInteractions(sms, users, companies); + } + + @Test + void dependencyFailureIsMappedToStableServiceUnavailableCode() { + when(sms.verifyCode(anyString(), anyString(), eq("company-register"))) + .thenThrow(new DataAccessResourceFailureException("connection details must not escape")); + + assertThatThrownBy(() -> service.register(request(), AuditContext.builder().build())) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt") + .isEqualTo(ErrorCode.COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE.getCode()); + verifyNoInteractions(users, companies, sessions, audit); + } + + @Test + void allExistingPrincipalRolesUseTheSameConflictResponse() { + when(hasher.hash(PHONE)).thenReturn("phone-hash"); + when(deletions.findByDeletedPhoneHash("phone-hash")).thenReturn(Optional.empty()); + for (User.Role role : User.Role.values()) { + reset(users); + User existing = User.builder().id(100L).phone(PHONE).role(role).roles(java.util.Set.of(role)).build(); + when(users.findByPhoneForUpdate(PHONE)).thenReturn(Optional.of(existing)); + assertThatThrownBy(() -> service.register(request(), AuditContext.builder().build())) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt") + .isEqualTo(ErrorCode.COMPANY_REGISTRATION_CONFLICT.getCode()); + } + } + + private CompanyRegistrationRequest request() { + CompanyRegistrationRequest request = new CompanyRegistrationRequest(); + request.setPhone(PHONE); + request.setCode("123456"); + request.setPassword("StrongCompanyPassword#1"); + CompanyRegistrationRequest.CompanyDetails details = new CompanyRegistrationRequest.CompanyDetails(); + details.setName("示例企业"); + details.setIndustry("互联网"); + details.setDescription("企业简介"); + details.setAddress("上海"); + request.setCompany(details); + return request; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationTransactionRollbackTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationTransactionRollbackTest.java new file mode 100644 index 0000000..dc72e0e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/company/CompanyRegistrationTransactionRollbackTest.java @@ -0,0 +1,145 @@ +package com.mydreamjob.auth.company; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.*; +import com.mydreamjob.auth.password.PasswordPolicy; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.company.Company; +import org.junit.jupiter.api.AfterEach; +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.boot.test.mock.mockito.SpyBean; +import org.springframework.dao.DataAccessResourceFailureException; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.TestPropertySource; +import org.h2.api.Trigger; + +import java.sql.Connection; +import java.sql.SQLException; +import java.time.LocalDateTime; +import java.time.Instant; + +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.doThrow; + +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +@TestPropertySource(properties = "app.company-registration.enabled=true") +class CompanyRegistrationTransactionRollbackTest { + private static final String PHONE = "19900000311"; + @Autowired CompanyRegistrationService service; + @Autowired SmsVerificationCodeRepository codes; + @Autowired UserRepository users; + @Autowired CompanyRepository companies; + @Autowired AuthTokenRepository tokens; + @Autowired JdbcTemplate jdbc; + @MockBean RedisTemplate redis; + @MockBean AuditService audit; + @SpyBean UserRepository userRepositorySpy; + @SpyBean CompanyRepository companyRepositorySpy; + @SpyBean AuthSessionService authSessionServiceSpy; + + @AfterEach + void cleanup() { + jdbc.update("DELETE FROM auth_tokens WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM companies WHERE owner_user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", PHONE); + jdbc.update("DELETE FROM users WHERE phone = ?", PHONE); + jdbc.update("DELETE FROM sms_verification_codes WHERE phone = ?", PHONE); + } + + @Test + void auditFailureRollsBackUserRoleCompanySessionAndCodeConsumption() { + doThrow(new DataAccessResourceFailureException("audit unavailable")).when(audit) + .logRequired(anyLong(), eq("COMPANY_REGISTERED"), anyString(), anyLong(), anyString(), any(), any()); + assertRollbackAfterInjectedFailure("audit"); + } + + @Test + void userSaveFailureRollsBackAllRowsAndCodeConsumption() { + doThrow(new DataAccessResourceFailureException("user store unavailable")) + .when(userRepositorySpy).saveAndFlush(any(User.class)); + assertRollbackAfterInjectedFailure("user"); + } + + @Test + void userRoleFlushFailureRollsBackAllRowsAndCodeConsumption() { + createUserRoleFailureTrigger(); + try { + assertRollbackAfterInjectedFailure("user-role"); + } finally { + jdbc.execute("DROP TRIGGER IF EXISTS phase_a_fail_user_roles"); + } + } + + @Test + void companySaveFailureRollsBackAllRowsAndCodeConsumption() { + doThrow(new DataAccessResourceFailureException("company store unavailable")) + .when(companyRepositorySpy).saveAndFlush(any(Company.class)); + assertRollbackAfterInjectedFailure("company"); + } + + @Test + void sessionCreationFailureRollsBackAllRowsAndCodeConsumption() { + doThrow(new DataAccessResourceFailureException("session store unavailable")) + .when(authSessionServiceSpy).createSession(any(User.class), any(Instant.class), any(AuditContext.class)); + assertRollbackAfterInjectedFailure("session"); + } + + private void assertRollbackAfterInjectedFailure(String suffix) { + org.mockito.Mockito.when(redis.hasKey(anyString())).thenReturn(false); + codes.saveAndFlush(SmsVerificationCode.builder().phone(PHONE).purpose("company-register") + .code("123456").attempts(0).maxAttempts(5).used(false) + .createdAt(LocalDateTime.now()).expiredAt(LocalDateTime.now().plusMinutes(5)).build()); + + CompanyRegistrationRequest request = new CompanyRegistrationRequest(); + request.setPhone(PHONE); request.setCode("123456"); request.setPassword("Company-strong-password-2026"); + CompanyRegistrationRequest.CompanyDetails details = new CompanyRegistrationRequest.CompanyDetails(); + details.setName("回滚企业-" + suffix); details.setIndustry("互联网"); details.setDescription("简介"); details.setAddress("地址"); + request.setCompany(details); + + assertThatThrownBy(() -> service.register(request, AuditContext.builder().build())) + .isInstanceOf(com.mydreamjob.common.exception.BusinessException.class); + assertThat(users.findByPhone(PHONE)).isEmpty(); + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", Long.class, PHONE)).isZero(); + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM companies WHERE name = ?", Long.class, "回滚企业-" + suffix)).isZero(); + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM auth_tokens WHERE user_id IN (SELECT id FROM users WHERE phone = ?)", Long.class, PHONE)).isZero(); + assertThat(codes.findByPhoneAndPurposeOrderByCreatedAtDesc(PHONE, "company-register")) + .singleElement().extracting(SmsVerificationCode::getUsed).isEqualTo(false); + } + + private void createUserRoleFailureTrigger() { + jdbc.execute("CREATE TRIGGER phase_a_fail_user_roles BEFORE INSERT ON user_roles " + + "FOR EACH ROW CALL '" + FailUserRoleInsertTrigger.class.getName() + "'"); + } + + /** H2-only failure injector: the production transaction still executes real SQL. */ + public static final class FailUserRoleInsertTrigger implements Trigger { + @Override + public void init(Connection conn, String schemaName, String triggerName, + String tableName, boolean before, int type) { + } + + @Override + public void fire(Connection conn, Object[] oldRow, Object[] newRow) throws SQLException { + throw new SQLException("user role store unavailable"); + } + + @Override + public void close() { + } + + @Override + public void remove() { + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordPolicyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordPolicyTest.java new file mode 100644 index 0000000..7b179cd --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordPolicyTest.java @@ -0,0 +1,44 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.Test; +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +class PasswordPolicyTest { + + private final PasswordPolicy policy = new PasswordPolicy(); + private final BCryptPasswordEncoder encoder = new BCryptPasswordEncoder(); + + @Test + void acceptsStrongPasswordAndNormalizesNfc() { + assertThat(policy.normalize(" Pássword-安全-2026 ")) + .isEqualTo(" Pássword-安全-2026 "); + policy.validateNewPassword("Pássword-安全-2026", "13800000001", null, encoder); + } + + @Test + void rejectsCommonShortPhoneContainingAndReusedPasswords() { + assertInvalid("short"); + assertInvalid("password123"); + assertInvalid("My13800000001StrongPassword"); + + String oldHash = encoder.encode("A-strong-password-2026"); + assertThatThrownBy(() -> policy.validateNewPassword( + "A-strong-password-2026", "13800000001", oldHash, encoder)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.PASSWORD_POLICY_INVALID.getCode()); + } + + private void assertInvalid(String password) { + assertThatThrownBy(() -> policy.validateNewPassword( + password, "13800000001", null, encoder)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.PASSWORD_POLICY_INVALID.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterRedisIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterRedisIntegrationTest.java new file mode 100644 index 0000000..6020af9 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterRedisIntegrationTest.java @@ -0,0 +1,116 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer; +import org.springframework.data.redis.serializer.StringRedisSerializer; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; +import org.testcontainers.utility.DockerImageName; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +@Testcontainers(disabledWithoutDocker = true) +class PasswordRateLimiterRedisIntegrationTest { + + @Container + static final GenericContainer REDIS = new GenericContainer<>(DockerImageName.parse("redis:7-alpine")) + .withExposedPorts(6379); + + private LettuceConnectionFactory connectionFactory; + private RedisTemplate redisTemplate; + private PasswordRateLimiter limiter; + + @BeforeEach + void setUp() { + connectionFactory = new LettuceConnectionFactory(REDIS.getHost(), REDIS.getMappedPort(6379)); + connectionFactory.afterPropertiesSet(); + connectionFactory.start(); + + redisTemplate = new RedisTemplate<>(); + redisTemplate.setConnectionFactory(connectionFactory); + redisTemplate.setKeySerializer(new StringRedisSerializer()); + redisTemplate.setHashKeySerializer(new StringRedisSerializer()); + redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer()); + redisTemplate.setHashValueSerializer(new GenericJackson2JsonRedisSerializer()); + redisTemplate.afterPropertiesSet(); + redisTemplate.getConnectionFactory().getConnection().serverCommands().flushDb(); + + PasswordAuthenticationProperties properties = new PasswordAuthenticationProperties(); + properties.setEnabled(true); + properties.setRateKeySecret("redis-integration-test-secret-00000001"); + properties.validate(); + limiter = new PasswordRateLimiter(redisTemplate, properties); + } + + @AfterEach + void tearDown() { + if (connectionFactory != null) { + connectionFactory.destroy(); + } + } + + @Test + void operationCounterAndTtlAreCreatedAtomically() { + String phone = "13800000001"; + for (int i = 0; i < 10; i++) { + limiter.checkOperationAllowed(phone); + } + assertThatThrownBy(() -> limiter.checkOperationAllowed(phone)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.PASSWORD_RATE_LIMITED.getCode()); + + String key = redisTemplate.keys("auth:pwd:operation:*").stream().findFirst().orElseThrow(); + assertThat(redisTemplate.getExpire(key, TimeUnit.SECONDS)).isBetween(1L, 600L); + } + + @Test + void concurrentFailureIncrementsLoseNoUpdatesAndLockTtlIsNotExtended() throws Exception { + String phone = "13800000002"; + int attempts = 20; + ExecutorService pool = Executors.newFixedThreadPool(attempts); + CountDownLatch ready = new CountDownLatch(attempts); + CountDownLatch start = new CountDownLatch(1); + List> futures = new ArrayList<>(); + for (int i = 0; i < attempts; i++) { + futures.add(pool.submit(() -> { + ready.countDown(); + start.await(10, TimeUnit.SECONDS); + limiter.recordFailure(phone); + return null; + })); + } + assertThat(ready.await(10, TimeUnit.SECONDS)).isTrue(); + start.countDown(); + for (Future future : futures) { + future.get(20, TimeUnit.SECONDS); + } + pool.shutdownNow(); + + String failureKey = redisTemplate.keys("auth:pwd:fail:*").stream().findFirst().orElseThrow(); + String lockKey = redisTemplate.keys("auth:pwd:locked:*").stream().findFirst().orElseThrow(); + assertThat(redisTemplate.opsForValue().get(failureKey)).isEqualTo(attempts); + assertThat(redisTemplate.getExpire(failureKey, TimeUnit.SECONDS)).isBetween(1L, 900L); + assertThat(redisTemplate.getExpire(lockKey, TimeUnit.SECONDS)).isBetween(1L, 900L); + assertThatThrownBy(() -> limiter.checkAllowed(phone, "127.0.0.1")) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.PASSWORD_RATE_LIMITED.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterTest.java new file mode 100644 index 0000000..9d9e059 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/password/PasswordRateLimiterTest.java @@ -0,0 +1,88 @@ +package com.mydreamjob.auth.password; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.Test; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.script.RedisScript; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +class PasswordRateLimiterTest { + + private static PasswordAuthenticationProperties enabledProperties() { + PasswordAuthenticationProperties properties = new PasswordAuthenticationProperties(); + properties.setEnabled(true); + properties.setRateKeySecret("01234567890123456789012345678901"); + return properties; + } + + @SuppressWarnings("unchecked") + @Test + void keysAreHmacReferencesAndRedisFailureFailsClosed() { + RedisTemplate redis = mock(RedisTemplate.class); + PasswordRateLimiter limiter = new PasswordRateLimiter(redis, enabledProperties()); + + String ref = limiter.ref("13800000001"); + assertThat(ref).hasSize(64).doesNotContain("13800000001"); + when(redis.hasKey(anyString())).thenThrow(new IllegalStateException("redis down")); + + assertThatThrownBy(() -> limiter.checkAllowed("13800000001", "127.0.0.1")) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + } + + @SuppressWarnings("unchecked") + @Test + void failureCounterUsesOneAtomicScriptWithTtlAndNonExtendingLock() { + RedisTemplate redis = mock(RedisTemplate.class); + when(redis.execute(any(RedisScript.class), anyList(), any(Object[].class))) + .thenReturn(1L, 2L, 3L, 4L, 5L); + PasswordRateLimiter limiter = new PasswordRateLimiter(redis, enabledProperties()); + + for (int i = 0; i < 5; i++) { + limiter.recordFailure("13800000001"); + } + verify(redis, times(5)).execute(argThat(script -> { + String source = ((RedisScript) script).getScriptAsString(); + return source.contains("INCR") && source.contains("EXPIRE") + && source.contains("SET") && source.contains("NX"); + }), anyList(), any(Object[].class)); + verify(redis, never()).opsForValue(); + } + + @SuppressWarnings("unchecked") + @Test + void eleventhPasswordOperationIsRateLimited() { + RedisTemplate redis = mock(RedisTemplate.class); + when(redis.execute(any(RedisScript.class), anyList(), any(Object[].class))) + .thenReturn(1L, 2L, 3L, 4L, 5L, 6L, 7L, 8L, 9L, 10L, 11L); + PasswordRateLimiter limiter = new PasswordRateLimiter(redis, enabledProperties()); + + for (int i = 0; i < 10; i++) { + limiter.checkOperationAllowed("13800000001"); + } + assertThatThrownBy(() -> limiter.checkOperationAllowed("13800000001")) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.PASSWORD_RATE_LIMITED.getCode()); + } + + @Test + void disabledRateLimiterFailsClosedInsteadOfSilentlyAllowingPasswordLogin() { + PasswordAuthenticationProperties properties = new PasswordAuthenticationProperties(); + PasswordRateLimiter limiter = new PasswordRateLimiter(mock(RedisTemplate.class), properties); + assertThatThrownBy(() -> limiter.checkAllowed("13800000001", "127.0.0.1")) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + assertThatThrownBy(() -> limiter.checkOperationAllowed("13800000001")) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCodeInt()) + .isEqualTo(ErrorCode.SERVICE_UNAVAILABLE.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokens.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokens.java new file mode 100644 index 0000000..737791c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokens.java @@ -0,0 +1,189 @@ +package com.mydreamjob.auth.support; + +import com.mydreamjob.auth.AuthTokenHasher; +import com.mydreamjob.auth.IssuedToken; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.config.AppJwtProperties; +import org.springframework.jdbc.core.JdbcTemplate; + +import javax.sql.DataSource; +import java.sql.Connection; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.ConcurrentHashMap; + +/** + * 测试专用：签发**可通过 S02 过滤器**的 Access Token。 + * + *

    S02 之后认证过滤器除验签外还要求：{@code type=access}、由 access 密钥签发、 + * 且对应一个真实存在的活动登录会话与可用用户。既有测试大量直接调用 + * {@code jwtTokenProvider.generateAccessToken(userId, phone, claims)}， + * 在新规则下会全部 401；本类让它们只需替换辅助方法体。

    + * + *

    为什么要按数据库登记

    + *

    Spring 会按类缓存测试上下文，而本仓库允许用 {@code @TestPropertySource} 覆盖 + * {@code spring.datasource.url} 隔离各自的 H2 库（例如 {@code CareerProgressControllerTest} + * 使用 {@code integrationdb_careerprogress}）。因此夹具必须记住**每一个**出现过的测试库， + * 并在签发时把会话行写入全部已知库 —— 这样无论当前测试读的是哪个库，都能看到会话。 + * 相比「只记第一个」或「记最后一个」，这是唯一与上下文缓存顺序无关的做法。

    + * + *

    夹具用固定有效期构造自己的 {@link JwtTokenProvider}，不读取任何注入的 Clock， + * 因此不受 {@code @MockBean Clock} 影响。

    + * + *

    仅存在于 src/test，不会进入生产制品。

    + */ +public final class TestAuthTokens { + + /** 与生产一致的固定业务时区。 */ + private static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + + /** + * 夹具签发时间：固定为足够早的过去时刻。 + * + *

    S02 的解析契约是 {@code iat <= capturedNow < exp}，而部分既有测试会把 + * {@code Clock} 固定在一个较早的时间（例如消息撤回的 HTTP 集成测试）。 + * 若夹具用"真实当前时间"签发，这些测试下就会命中"iat 在未来"而被拒绝。 + * 因此夹具统一使用一个远早于所有测试时钟的 iat，配合超长有效期。

    + */ + private static final Instant FIXTURE_BASE = Instant.parse("2020-01-01T00:00:00Z"); + + /** 夹具有效期：30 年，覆盖 2020–2050 之间的任何测试时钟。 */ + private static final long FIXTURE_TTL_MS = 30L * 365 * 24 * 60 * 60 * 1000; + + /** 已登记的测试库：JDBC URL -> 写入器。 */ + private static final Map LIBRARIES = new ConcurrentHashMap<>(); + + private TestAuthTokens() { + } + + private record Library(JdbcTemplate jdbc, JwtTokenProvider provider, AuthTokenHasher hasher) { + } + + /** + * 登记一个测试上下文使用的数据库。由 + * {@link TestAuthTokensAutoConfiguration} 在每个上下文启动时调用；同一 URL 只登记一次。 + */ + static void register(DataSource dataSource, AppJwtProperties source) { + String url = jdbcUrl(dataSource); + if (url == null) { + return; + } + LIBRARIES.computeIfAbsent(url, key -> { + AppJwtProperties fixture = new AppJwtProperties(); + fixture.setAccessSecret(source.getAccessSecret()); + fixture.setRefreshSecret(source.getRefreshSecret()); + fixture.setTokenHashSecret(source.getTokenHashSecret()); + fixture.setIssuer(source.getIssuer()); + fixture.setAccessAudience(source.getAccessAudience()); + fixture.setRefreshAudience(source.getRefreshAudience()); + fixture.setExpirationMs(FIXTURE_TTL_MS); + fixture.setRefreshExpirationMs(FIXTURE_TTL_MS); + return new Library(new JdbcTemplate(dataSource), + new JwtTokenProvider(fixture), new AuthTokenHasher(fixture)); + }); + } + + /** 返回可直接放入 Authorization 头的完整值。 */ + public static String bearer(Long userId, String role) { + return "Bearer " + accessToken(userId, role); + } + + /** 常用角色重载。 */ + public static String bearer(Long userId, Enum role) { + return bearer(userId, role == null ? "STUDENT" : role.name()); + } + + /** 返回 Access Token 原文。 */ + public static synchronized String accessToken(Long userId, String role) { + return mintPair(userId, role).access(); + } + + /** 返回可通过 S02 过滤器的 Refresh Token 原文（type=refresh、refresh 密钥、真实会话）。 */ + public static synchronized String refreshToken(Long userId, String role) { + return mintPair(userId, role).refresh(); + } + + /** 同时签发 Access/Refresh 并登记会话；返回对。 */ + private static IssuedPair mintPair(Long userId, String role) { + if (LIBRARIES.isEmpty()) { + throw new IllegalStateException( + "TestAuthTokens is not initialized: no test datasource was registered"); + } + String effectiveRole = (role == null || role.isBlank()) ? "STUDENT" : role; + Library mint = LIBRARIES.values().iterator().next(); + + String sessionId = UUID.randomUUID().toString(); + IssuedToken access = mint.provider() + .generateAccessToken(userId, effectiveRole, sessionId, UUID.randomUUID().toString(), FIXTURE_BASE); + IssuedToken refresh = mint.provider() + .generateRefreshToken(userId, sessionId, UUID.randomUUID().toString(), FIXTURE_BASE); + + String refreshHash = mint.hasher().hash(refresh.token()); + LocalDateTime expiresAt = LocalDateTime.ofInstant(refresh.expiresAt(), BUSINESS_ZONE); + LocalDateTime now = LocalDateTime.now(BUSINESS_ZONE); + + // 写入所有已知测试库：当前测试读哪个库都能看到该会话。 + boolean written = false; + for (Map.Entry entry : LIBRARIES.entrySet()) { + try { + writeSession(entry.getValue().jdbc(), userId, effectiveRole, refreshHash, + refresh.tokenId(), expiresAt, sessionId, now); + written = true; + } catch (RuntimeException e) { + // 已失效的上下文（连接池关闭等）自行登记移除，不影响其余库。 + LIBRARIES.remove(entry.getKey()); + } + } + if (!written) { + throw new IllegalStateException( + "TestAuthTokens could not write a session into any registered test datasource"); + } + return new IssuedPair(access.token(), refresh.token()); + } + + private record IssuedPair(String access, String refresh) { + } + + private static void writeSession(JdbcTemplate jdbc, Long userId, String role, String refreshHash, + String refreshJti, LocalDateTime expiresAt, + String sessionId, LocalDateTime now) { + Integer count = jdbc.queryForObject("SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, userId); + if (count == null || count == 0) { + // 既有测试常用固定 userId（如 100）但从不建用户行；S02 过滤器会校验用户存在且 active。 + // phone 使用非数字前缀，避免与真实测试号的唯一约束冲突。 + jdbc.update( + "INSERT INTO users (id, phone, nickname, role, is_active, is_verified) VALUES (?, ?, ?, ?, 1, 1)", + userId, "t" + userId, "test-user-" + userId, role); + } + jdbc.update(""" + INSERT INTO auth_tokens + (user_id, token_hash, token_type, expired_at, revoked, + session_id, token_jti, version, created_at) + VALUES (?, ?, 'REFRESH', ?, 0, ?, ?, 0, CURRENT_TIMESTAMP) + """, + userId, refreshHash, Timestamp.valueOf(expiresAt), sessionId, refreshJti); + + Integer visible = jdbc.queryForObject(""" + SELECT COUNT(*) FROM auth_tokens + WHERE user_id = ? AND session_id = ? AND revoked = 0 + AND consumed_at IS NULL AND expired_at > ? + """, + Integer.class, userId, sessionId, Timestamp.valueOf(now)); + if (visible == null || visible == 0) { + throw new IllegalStateException("fixture session not visible"); + } + } + + private static String jdbcUrl(DataSource dataSource) { + try (Connection connection = dataSource.getConnection()) { + return connection.getMetaData().getURL(); + } catch (SQLException e) { + return null; + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokensAutoConfiguration.java b/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokensAutoConfiguration.java new file mode 100644 index 0000000..8549b69 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/auth/support/TestAuthTokensAutoConfiguration.java @@ -0,0 +1,38 @@ +package com.mydreamjob.auth.support; + +import com.mydreamjob.config.AppJwtProperties; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.context.annotation.Bean; + +import javax.sql.DataSource; + +/** + * 测试专用自动配置：把上下文里的 {@link DataSource} 与 JWT 配置登记给 {@link TestAuthTokens}。 + * + *

    使用 {@code @AutoConfiguration}（而非 {@code spring.factories} 的 + * {@code TestExecutionListener}）：后者会替换 Spring 的默认执行监听器， + * 导致依赖注入等基础能力失效。

    + * + *

    {@code @WebMvcTest} 切片没有 DataSource 与 JWT 配置，通过 + * {@code ObjectProvider} 安全跳过（不用 {@code @ConditionalOnBean}： + * 它在自动配置阶段顺序敏感，可能先于 DataSourceAutoConfiguration 求值）。

    + */ +@AutoConfiguration +public class TestAuthTokensAutoConfiguration { + + @Bean + public TestAuthTokensInstaller testAuthTokensInstaller( + org.springframework.beans.factory.ObjectProvider dataSource, + org.springframework.beans.factory.ObjectProvider jwtProperties) { + DataSource ds = dataSource.getIfAvailable(); + AppJwtProperties props = jwtProperties.getIfAvailable(); + if (ds != null && props != null) { + TestAuthTokens.register(ds, props); + } + return new TestAuthTokensInstaller(); + } + + /** 仅用于确保自动配置被加载的占位 Bean。 */ + public static final class TestAuthTokensInstaller { + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchControllerTest.java index 8012fa3..a922bfb 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/ApplicationMatchControllerTest.java @@ -58,11 +58,11 @@ class ApplicationMatchControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(STUDENT_ID, "2", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_ID, "STUDENT"); } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(COMPANY_ID, "3", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(COMPANY_ID, "COMPANY"); } private ApplicationMatchRecord record() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/MatchRuleServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/MatchRuleServiceTest.java index 0643bbe..20105c3 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/MatchRuleServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/bidirectionalmatch/MatchRuleServiceTest.java @@ -2,11 +2,14 @@ package com.mydreamjob.bidirectionalmatch; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; import com.mydreamjob.company.CompanyRepository; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; import org.mockito.Mock; @@ -24,11 +27,19 @@ import static org.mockito.Mockito.*; @ExtendWith(MockitoExtension.class) class MatchRuleServiceTest { + @BeforeEach + void wireRoleGuard() { + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + } + @Mock private CompanyMatchRuleRepository companyRuleRepository; @Mock private StudentMatchRuleRepository studentRuleRepository; @Mock private CompanyRepository companyRepository; @Mock private UserRepository userRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private MatchRuleService matchRuleService; private static final Long COMPANY_USER_ID = 10L; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSourceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSourceTest.java new file mode 100644 index 0000000..f613652 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityAssessmentScoreSourceTest.java @@ -0,0 +1,87 @@ +package com.mydreamjob.candidatescore; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; + +import java.sql.ResultSet; +import java.sql.Timestamp; +import java.time.LocalDateTime; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +/** + * V38：AbilityAssessmentScoreSource 单测。用 mock JdbcTemplate 断言单次查询契约与行映射， + * 并覆盖无结果/参数空返回 null。真实数据选择行为由 AbilityScoreIntegrationTest 覆盖。 + */ +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class AbilityAssessmentScoreSourceTest { + + @Mock private JdbcTemplate jdbcTemplate; + @InjectMocks private AbilityAssessmentScoreSource source; + + private static final Long SID = 2L; + private static final LocalDateTime NOW = LocalDateTime.now(); + + @Test + void findLatest_singleQuery_noNplus1() { + when(jdbcTemplate.query(anyString(), any(RowMapper.class), any(Object[].class))) + .thenReturn(List.of()); + source.findLatestValidCompletedResult(SID, NOW); + verify(jdbcTemplate, times(1)).query(anyString(), any(RowMapper.class), any(Object[].class)); + } + + @Test + void findLatest_mapsRow_toProjection() throws Exception { + ResultSet rs = mock(ResultSet.class); + when(rs.getLong("resultId")).thenReturn(123L); + when(rs.getTimestamp("completedAt")).thenReturn(Timestamp.valueOf(NOW.minusDays(1))); + when(rs.getTimestamp("validUntil")).thenReturn(Timestamp.valueOf(NOW.plusDays(6))); + when(rs.getString("questionSetVersion")).thenReturn("ability-v0.1"); + when(rs.getString("assessmentRulesVersion")).thenReturn("ability-v0.1"); + when(rs.getInt("answeredCount")).thenReturn(24); + when(rs.getString("dimensionScoresJson")).thenReturn("[]"); + + when(jdbcTemplate.query(anyString(), any(RowMapper.class), any(Object[].class))) + .thenAnswer(inv -> { + RowMapper rm = inv.getArgument(1); + Object mapped = rm.mapRow(rs, 0); + return java.util.List.of(mapped); + }); + + AbilityAssessmentScoreSource.AbilityResultProjection p = + source.findLatestValidCompletedResult(SID, NOW); + assertNotNull(p); + assertEquals(123L, p.resultId()); + assertEquals(NOW.minusDays(1), p.completedAt()); + assertEquals(NOW.plusDays(6), p.validUntil()); + assertEquals("ability-v0.1", p.questionSetVersion()); + assertEquals("ability-v0.1", p.assessmentRulesVersion()); + assertEquals(24, p.answeredCount()); + assertEquals("[]", p.dimensionScoresJson()); + } + + @Test + void findLatest_empty_noResult_null() { + when(jdbcTemplate.query(anyString(), any(RowMapper.class), any(Object[].class))) + .thenReturn(List.of()); + assertNull(source.findLatestValidCompletedResult(SID, NOW)); + } + + @Test + void findLatest_nullParams_returnsNull() { + assertNull(source.findLatestValidCompletedResult(null, NOW)); + assertNull(source.findLatestValidCompletedResult(SID, null)); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreIntegrationTest.java new file mode 100644 index 0000000..4fcd701 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreIntegrationTest.java @@ -0,0 +1,303 @@ +package com.mydreamjob.candidatescore; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; +import com.mydreamjob.ability.AbilityAttempt; +import com.mydreamjob.ability.AbilityAttemptRepository; +import com.mydreamjob.ability.AbilityDefinition; +import com.mydreamjob.ability.AbilityDefinitionRepository; +import com.mydreamjob.ability.AbilityResult; +import com.mydreamjob.ability.AbilityResultRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.dto.CandidateScoringOverviewResponse; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.time.Clock; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * V38：四维能力结果接入候选评分——真实 H2 集成测试。 + *

    覆盖来源选择（最新有效 COMPLETED/WORKPLACE_ABILITY/过期排除）、V36 submit 不写快照、 + * 评分触发才写 ABILITY 快照、结果过期后 PENDING。企业脱敏与版本切换由 EngineService 单测覆盖。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class AbilityScoreIntegrationTest { + + private static final AtomicLong PHONE = new AtomicLong(7100); + + @Autowired private UserRepository userRepository; + @Autowired private AbilityDefinitionRepository definitionRepository; + @Autowired private AbilityAttemptRepository attemptRepository; + @Autowired private AbilityResultRepository resultRepository; + @Autowired private AbilityAssessmentScoreSource scoreSource; + @Autowired private CandidateScoringEngineService engineService; + @Autowired private CandidateDimensionScoreRepository dimensionScoreRepository; + @Autowired private CandidateScoringCalculator calculator; + + @MockBean private RedisTemplate redisTemplate; + + private final List createdUsers = new ArrayList<>(); + private Long defId; + + private static final String DIMS_OK = + "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":65,\"answeredCount\":6}]"; + // 历史高分（早提交）+ 更新低分（晚提交）用于验证“取最新而非最高” + private static final String DIMS_HIGH = + "[{\"code\":\"LOGIC\",\"score\":100,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":100,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":100,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":100,\"answeredCount\":6}]"; + + @BeforeEach + void setUp() { + when(redisTemplate.opsForValue()).thenReturn(mock(org.springframework.data.redis.core.ValueOperations.class)); + when(redisTemplate.hasKey(any())).thenReturn(false); + // WORKPLACE_ABILITY 由既有 Flyway 迁移种子化；复用而非新建，避免唯一键冲突 + AbilityDefinition def = definitionRepository.findAll().stream() + .filter(d -> "WORKPLACE_ABILITY".equals(d.getTypeCode())) + .findFirst().orElseThrow(() -> new IllegalStateException("WORKPLACE_ABILITY must be seeded")); + defId = def.getId(); + } + + @AfterEach + void tearDown() { + for (Long id : createdUsers) { + userRepository.deleteById(id); + } + createdUsers.clear(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", false); + Clock system = Clock.systemDefaultZone(); + ReflectionTestUtils.setField(calculator, "clock", system); + ReflectionTestUtils.setField(engineService, "clock", system); + } + + private Long createUser() { + User u = userRepository.save(User.builder() + .phone("19" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).active(true).verified(true).build()); + createdUsers.add(u.getId()); + return u.getId(); + } + + private Long attempt(Long studentId, String status, LocalDateTime completedAt, + int answeredCount) { + AbilityAttempt a = attemptRepository.save(AbilityAttempt.builder() + .studentUserId(studentId).definitionId(defId).status(status) + .answeredCount(answeredCount).questionSetVersion("ability-v0.1") + .completedAt(completedAt) + .build()); + return a.getId(); + } + + private Long result(Long attemptId, String dimsJson, LocalDateTime validUntil) { + AbilityResult r = resultRepository.save(AbilityResult.builder() + .attemptId(attemptId).dimensionScoresJson(dimsJson) + .overallScore(new BigDecimal("70.00")) + .questionSetVersion("ability-v0.1").rulesVersion("ability-v0.1") + .validUntil(validUntil).generatedAt(LocalDateTime.now()) + .build()); + return r.getId(); + } + + @Test + void source_picksLatestValidCompleted_ignoringHistoricalHighScore() { + Long u = createUser(); + LocalDateTime now = LocalDateTime.now(); + // 较早提交的高分（100）+ 更晚提交的有效低分（74.25） + Long earlyResultId = result(attempt(u, "COMPLETED", now.minusDays(2), 24), + DIMS_HIGH, now.plusDays(5)); + Long lateResultId = result(attempt(u, "COMPLETED", now.minusDays(1), 24), + DIMS_OK, now.plusDays(5)); + + AbilityAssessmentScoreSource.AbilityResultProjection p = + scoreSource.findLatestValidCompletedResult(u, now); + assertNotNull(p); + assertEquals(lateResultId, p.resultId(), "must pick latest completed, not historical highest"); + assertEquals(now.minusDays(1).truncatedTo(java.time.temporal.ChronoUnit.SECONDS), + p.completedAt().truncatedTo(java.time.temporal.ChronoUnit.SECONDS)); + assertEquals(DIMS_OK, p.dimensionScoresJson()); + } + + @Test + void source_excludesExpiredOrNonCompletedOrOtherType() { + Long u = createUser(); + LocalDateTime now = LocalDateTime.now(); + // 过期结果不被选 + Long expiredId = attempt(u, "COMPLETED", now.minusDays(1), 24); + result(expiredId, DIMS_OK, now.minusDays(1)); + // DRAFT/IN_PROGRESS 不被选 + attempt(u, "DRAFT", null, 0); + attempt(u, "IN_PROGRESS", null, 12); + // 其他类型定义（使用未被种子占用的自定义类型码） + AbilityDefinition other = definitionRepository.save(AbilityDefinition.builder() + .typeCode("FIXTURE_OTHER_99").displayName("其他").status("ACTIVE") + .questionCount(3).attemptQuestionCount(3).questionsPerDimension(1) + .timeLimitMinutes(10).resultValidDays(7).retakeWindowDays(90).retakeMaxCompleted(3) + .questionSetVersion("v0.1").rulesVersion("v0.1").build()); + Long otherAttemptId = attemptRepository.save(AbilityAttempt.builder() + .studentUserId(u).definitionId(other.getId()).status("COMPLETED") + .answeredCount(3).questionSetVersion("v0.1").completedAt(now).build()).getId(); + result(otherAttemptId, "[{\"code\":\"X\",\"score\":100,\"answeredCount\":3}]", now.plusDays(7)); + + assertNull(scoreSource.findLatestValidCompletedResult(u, now)); + } + + @Test + void source_validUntilEqualsCapturedNow_notSelected() { + Long u = createUser(); + // 统一截断到秒，保证 valid_until 与传入的 capturedNow 严格相等（H2/MySQL 时间精度差异无关） + LocalDateTime now = LocalDateTime.now().withNano(0); + Long aid = attempt(u, "COMPLETED", now.minusDays(1), 24); + result(aid, DIMS_OK, now); + assertNull(scoreSource.findLatestValidCompletedResult(u, now), + "valid_until == capturedNow must not be selected"); + } + + @Test + void source_validUntilAfterCapturedNow_selected() { + Long u = createUser(); + LocalDateTime now = LocalDateTime.now(); + Long aid = attempt(u, "COMPLETED", now.minusDays(1), 24); + Long rid = result(aid, DIMS_OK, now.plusMinutes(1)); + AbilityAssessmentScoreSource.AbilityResultProjection p = + scoreSource.findLatestValidCompletedResult(u, now); + assertNotNull(p, "valid_until > capturedNow must be selected"); + assertEquals(rid, p.resultId()); + } + + @Test + void expiredResult_recomputeBecomesPending() { + Long u = createUser(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", true); + LocalDateTime now = LocalDateTime.now(); + Long aid = attempt(u, "COMPLETED", now.minusDays(1), 24); + result(aid, DIMS_OK, now.plusDays(6)); + + // 有效期内在评分后写入 OK 快照（getOverview 内部 @Transactional 触发既有 upsert） + CandidateScoringOverviewResponse r1 = engineService.getOverview(u); + assertEquals("OK", dimensionStatus(r1, "ABILITY")); + + // 强制过期后重算 → PENDING + resultRepository.findByAttemptId(aid).ifPresent(rr -> { + rr.setValidUntil(now.minusDays(1)); + resultRepository.save(rr); + }); + CandidateScoringOverviewResponse r2 = engineService.getOverview(u); + assertEquals("PENDING", dimensionStatus(r2, "ABILITY")); + } + + @Test + void engineDetail_validUntilEqualCapturedNow_isExpiredAndRedacted() throws Exception { + Long u = createUser(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", true); + LocalDateTime captured = LocalDateTime.of(2026, 9, 9, 12, 0); + Clock fixed = Clock.fixed(captured.atZone(ZoneId.of("Asia/Shanghai")).toInstant(), + ZoneId.of("Asia/Shanghai")); + ReflectionTestUtils.setField(calculator, "clock", fixed); + ReflectionTestUtils.setField(engineService, "clock", fixed); + Long aid = attempt(u, "COMPLETED", captured.minusDays(1), 24); + result(aid, DIMS_OK, captured); + + var detail = engineService.getDimensionDetail(u, "ABILITY"); + + assertEquals("PENDING", detail.getStatus()); + assertNull(detail.getScore()); + assertNotNull(detail.getValidity()); + assertTrue(detail.getValidity().getExpired()); + assertEquals(captured, detail.getCalculatedAt()); + String json = new ObjectMapper().registerModule(new JavaTimeModule()).writeValueAsString(detail); + for (String banned : List.of("resultId", "attemptId", "answerKey", "scoringRule", + "questionCode", "competencyTag", "selectedOptionId", "stem")) { + assertFalse(json.contains(banned), "ABILITY detail must not expose " + banned); + } + } + + @Test + void engineDetail_validUntilAfterCapturedNow_isValidAndContributionsReconcile() throws Exception { + Long u = createUser(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", true); + LocalDateTime captured = LocalDateTime.of(2026, 9, 9, 12, 0); + Clock fixed = Clock.fixed(captured.atZone(ZoneId.of("Asia/Shanghai")).toInstant(), + ZoneId.of("Asia/Shanghai")); + ReflectionTestUtils.setField(calculator, "clock", fixed); + ReflectionTestUtils.setField(engineService, "clock", fixed); + Long aid = attempt(u, "COMPLETED", captured.minusDays(1), 24); + result(aid, DIMS_OK, captured.plusSeconds(1)); + + var detail = engineService.getDimensionDetail(u, "ABILITY"); + + assertEquals("OK", detail.getStatus()); + assertEquals(new BigDecimal("74.25"), detail.getScore()); + assertNotNull(detail.getValidity()); + assertFalse(detail.getValidity().getExpired()); + assertEquals(captured.plusSeconds(1), detail.getValidity().getValidUntil()); + BigDecimal contributionSum = detail.getRuleContributions().stream() + .map(c -> c.getContribution() == null ? BigDecimal.ZERO : c.getContribution()) + .reduce(BigDecimal.ZERO, BigDecimal::add); + assertEquals(detail.getScore(), contributionSum); + String json = new ObjectMapper().registerModule(new JavaTimeModule()).writeValueAsString(detail); + for (String banned : List.of("resultId", "attemptId", "answerKey", "scoringRule", + "questionCode", "competencyTag", "selectedOptionId", "stem")) { + assertFalse(json.contains(banned), "ABILITY detail must not expose " + banned); + } + } + + @Test + void engineDetail_nullValidUntil_isInvalidAndNeverReportedAsExpired() throws Exception { + Long u = createUser(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", true); + LocalDateTime captured = LocalDateTime.of(2026, 9, 9, 12, 0); + Clock fixed = Clock.fixed(captured.atZone(ZoneId.of("Asia/Shanghai")).toInstant(), + ZoneId.of("Asia/Shanghai")); + ReflectionTestUtils.setField(calculator, "clock", fixed); + ReflectionTestUtils.setField(engineService, "clock", fixed); + Long aid = attempt(u, "COMPLETED", captured.minusDays(1), 24); + result(aid, DIMS_OK, null); + + var detail = engineService.getDimensionDetail(u, "ABILITY"); + + assertEquals("PENDING", detail.getStatus()); + assertNull(detail.getScore()); + assertNull(detail.getValidity(), "missing validity is invalid data, not an expired validity window"); + assertEquals(1, detail.getRuleContributions().size()); + assertEquals("ABILITY_RESULT_INVALID", detail.getRuleContributions().get(0).getRuleCode()); + assertEquals("UNAVAILABLE", detail.getRuleContributions().get(0).getOutcome()); + String json = new ObjectMapper().registerModule(new JavaTimeModule()).writeValueAsString(detail); + assertFalse(json.contains("ABILITY_RESULT_EXPIRED")); + for (String banned : List.of("resultId", "attemptId", "answerKey", "scoringRule", + "questionCode", "competencyTag", "selectedOptionId", "stem")) { + assertFalse(json.contains(banned), "ABILITY detail must not expose " + banned); + } + } + + private String dimensionStatus(CandidateScoringOverviewResponse resp, String dim) { + return resp.getDimensions().stream() + .filter(d -> dim.equals(d.getDimension())) + .findFirst().map(CandidateScoringOverviewResponse.DimensionItem::getStatus) + .orElseThrow(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreMapperTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreMapperTest.java new file mode 100644 index 0000000..8dfd522 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/AbilityScoreMapperTest.java @@ -0,0 +1,181 @@ +package com.mydreamjob.candidatescore; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * V38：AbilityScoreMapper 纯函数测试。 + *

    覆盖固定权重公式与 HALF_UP、结构防御（缺维/重复维/越界/错题数非6/总数非24/非法JSON）， + * 以及不依赖答案键或题目级数据。

    + */ +class AbilityScoreMapperTest { + + private final AbilityScoreMapper mapper = new AbilityScoreMapper(); + + private String dims(int l, int c, int e, int r, int perDimAnswered) { + return dimsWithAnswered(l, c, e, r, String.valueOf(perDimAnswered)); + } + + private String dimsWithAnswered(int l, int c, int e, int r, String perDimAnswered) { + return "[{\"code\":\"LOGIC\",\"score\":" + l + ",\"answeredCount\":" + perDimAnswered + "}," + + "{\"code\":\"COMMUNICATION\",\"score\":" + c + ",\"answeredCount\":" + perDimAnswered + "}," + + "{\"code\":\"EXECUTION\",\"score\":" + e + ",\"answeredCount\":" + perDimAnswered + "}," + + "{\"code\":\"LEARNING\",\"score\":" + r + ",\"answeredCount\":" + perDimAnswered + "}]"; + } + + @Test + void validDimensions_weightedFormulaHALFUP() { + // 80*0.35 + 75*0.30 + 70*0.20 + 65*0.15 = 74.25 + Optional m = mapper.map(dims(80, 65, 75, 70, 6), 24); + assertTrue(m.isPresent()); + assertEquals(new BigDecimal("74.25"), m.get().abilityScore()); + assertEquals(2, m.get().abilityScore().scale()); + } + + @Test + void validDimensions_halfUpRounding_scale2() { + // 三十三点三三 每维：33.33*0.35 + 33.33*0.30 + 33.33*0.20 + 33.33*0.15 = 33.33 + String json = "[{\"code\":\"LOGIC\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":33.33,\"answeredCount\":6}]"; + Optional m = mapper.map(json, 24); + assertTrue(m.isPresent()); + assertEquals(2, m.get().abilityScore().scale()); + assertEquals(new BigDecimal("33.33"), m.get().abilityScore()); + } + + @Test + void validDimensions_halfUp_boundaryRoundUp() { + // LOGIC=66.67, 其他=0 => 66.67*0.35 = 23.3345 -> HALF_UP scale2 = 23.33 + String json = "[{\"code\":\"LOGIC\",\"score\":66.67,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":0,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":0,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":0,\"answeredCount\":6}]"; + Optional m = mapper.map(json, 24); + assertTrue(m.isPresent()); + assertEquals(new BigDecimal("23.33"), m.get().abilityScore()); + } + + @Test + void missingDimension_unavailable() { + String json = "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}]"; + assertTrue(mapper.map(json, 18).isEmpty()); + } + + @Test + void duplicateDimension_unavailable() { + String json = "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}]"; + assertTrue(mapper.map(json, 24).isEmpty()); + } + + @Test + void unexpectedDimension_unavailable() { + String json = "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXTRA\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}]"; + assertTrue(mapper.map(json, 24).isEmpty()); + } + + @Test + void outOfRangeScore_unavailable() { + assertTrue(mapper.map(dims(110, 65, 75, 70, 6), 24).isEmpty()); + assertTrue(mapper.map(dims(-1, 65, 75, 70, 6), 24).isEmpty()); + assertTrue(mapper.map(dims(80, 65, 75, 101, 6), 24).isEmpty()); + } + + @Test + void nonFiniteScore_unavailable() { + String json = "[{\"code\":\"LOGIC\",\"score\":NaN,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":65,\"answeredCount\":6}]"; + assertTrue(mapper.map(json, 24).isEmpty()); + } + + @Test + void answeredCountNot6_unavailable() { + String json = "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":5}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":65,\"answeredCount\":6}]"; + assertTrue(mapper.map(json, 23).isEmpty()); + } + + @Test + void totalAnsweredNot24_unavailable() { + // 每维 6 => 总数 24 满足；但 attempt 上 answered_count=23 视为不完整 + assertTrue(mapper.map(dims(80, 65, 75, 70, 6), 23).isEmpty()); + } + + @Test + void attemptAnsweredNull_returnsEmpty() { + // V38 P1：attemptAnsweredCount 必须非空且严格等于 24 + assertTrue(mapper.map(dims(80, 65, 75, 70, 6), null).isEmpty()); + } + + @Test + void attemptAnsweredNot24_returnsEmpty() { + assertTrue(mapper.map(dims(80, 65, 75, 70, 6), 23).isEmpty()); + assertTrue(mapper.map(dims(80, 65, 75, 70, 6), 25).isEmpty()); + } + + @Test + void perDimAnsweredDecimalNotExact_returnsEmpty() { + // 6.9 会被 JSON 解析为浮点数；不得因 intValue 截断成 6 + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "6.9"), 24).isEmpty()); + // 6.5 同理不可用 + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "6.5"), 24).isEmpty()); + } + + @Test + void perDimAnsweredStringDecimal_returnsEmpty() { + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "\"6.5\""), 24).isEmpty()); + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "\"6.9\""), 24).isEmpty()); + } + + @Test + void perDimAnsweredOverflowOrBlank_returnsEmpty() { + // 2147483648 超出 int 精确取值范围（intValueExact 抛 ArithmeticException → null） + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "2147483648"), 24).isEmpty()); + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "\"\""), 24).isEmpty()); + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "null"), 24).isEmpty()); + } + + @Test + void perDimAnsweredExactSixAsDecimalOrString_ok() { + // 数值意义等于 6 的整数表示：JSON 数字 6.0 与字符串 "6" / "6.0" 均接受 + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "6.0"), 24).isPresent()); + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "\"6\""), 24).isPresent()); + assertTrue(mapper.map(dimsWithAnswered(80, 65, 75, 70, "\"6.0\""), 24).isPresent()); + } + + @Test + void illegalJson_unavailable() { + assertTrue(mapper.map("not json{{{", 24).isEmpty()); + assertTrue(mapper.map(null, 24).isEmpty()); + assertTrue(mapper.map("", 24).isEmpty()); + assertTrue(mapper.map("[]", 24).isEmpty()); + } + + @Test + void stringScoredValues_parsed() { + String json = "[{\"code\":\"LOGIC\",\"score\":\"80\",\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":\"75\",\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":\"70\",\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":\"65\",\"answeredCount\":6}]"; + Optional m = mapper.map(json, 24); + assertTrue(m.isPresent()); + assertEquals(new BigDecimal("74.25"), m.get().abilityScore()); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicyTest.java new file mode 100644 index 0000000..7255b19 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateOverviewStatusPolicyTest.java @@ -0,0 +1,78 @@ +package com.mydreamjob.candidatescore; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; + +class CandidateOverviewStatusPolicyTest { + + @Test + void nullComputedResultsPreserveHistoricalFailFastBehavior() { + assertThrows(NullPointerException.class, + () -> CandidateOverviewStatusPolicy.fromComputedResults(null, 8)); + } + + @Test + void computedResultsPreserveFixedEightDimensionContract() { + assertEquals("PENDING", CandidateOverviewStatusPolicy.fromComputedResults(List.of(), 8)); + assertEquals("OK", CandidateOverviewStatusPolicy.fromComputedResults(results(8, "OK", "80"), 8)); + + List partial = new ArrayList<>(results(1, "OK", "80")); + partial.addAll(results(7, "PENDING", null)); + assertEquals("PARTIAL", CandidateOverviewStatusPolicy.fromComputedResults(partial, 8)); + assertEquals("PENDING", CandidateOverviewStatusPolicy.fromComputedResults(results(8, "PENDING", null), 8)); + assertEquals("INSUFFICIENT_DATA", + CandidateOverviewStatusPolicy.fromComputedResults(results(8, "INSUFFICIENT_DATA", null), 8)); + } + + @Test + void computedResultRequiresScoreEvenWhenStatusLooksComputable() { + assertEquals("INSUFFICIENT_DATA", + CandidateOverviewStatusPolicy.fromComputedResults(results(8, "OK", null), 8)); + } + + @Test + void snapshotsPreserveExistingSnapshotCountAndStatusContract() { + assertEquals("INSUFFICIENT_DATA", CandidateOverviewStatusPolicy.fromSnapshots(null)); + assertEquals("INSUFFICIENT_DATA", CandidateOverviewStatusPolicy.fromSnapshots(List.of())); + assertEquals("OK", CandidateOverviewStatusPolicy.fromSnapshots(snapshots("OK", "ESTIMATED"))); + assertEquals("PARTIAL", CandidateOverviewStatusPolicy.fromSnapshots(snapshots("OK", "PENDING"))); + assertEquals("PENDING", CandidateOverviewStatusPolicy.fromSnapshots(snapshots("PENDING", "PENDING"))); + assertEquals("INSUFFICIENT_DATA", + CandidateOverviewStatusPolicy.fromSnapshots(snapshots("INSUFFICIENT_DATA", "PENDING"))); + } + + @Test + void snapshotsKeepHistoricalStatusOnlyComputabilityEvenWithNullScore() { + CandidateDimensionScore snapshot = snapshot("OK"); + snapshot.setScore(null); + assertEquals("OK", CandidateOverviewStatusPolicy.fromSnapshots(List.of(snapshot))); + } + + private List results(int count, String status, String score) { + List values = new ArrayList<>(); + for (int i = 0; i < count; i++) { + CandidateScoringCalculator.DimensionResult result = + new CandidateScoringCalculator.DimensionResult("D" + i); + result.status = status; + result.score = score == null ? null : new BigDecimal(score); + values.add(result); + } + return values; + } + + private List snapshots(String... statuses) { + List values = new ArrayList<>(); + for (String status : statuses) values.add(snapshot(status)); + return values; + } + + private CandidateDimensionScore snapshot(String status) { + return CandidateDimensionScore.builder().status(status).score(new BigDecimal("80")).build(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoreCardControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoreCardControllerTest.java index cfa24c4..b808f09 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoreCardControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoreCardControllerTest.java @@ -56,18 +56,15 @@ class CandidateScoreCardControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "13800138000", - Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(200L, "13800138001", - Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(200L, "COMPANY"); } private String adminToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(300L, "13800138002", - Map.of("roles", "ADMIN")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(300L, "ADMIN"); } private CandidateScoreCardResponse buildScoreCard(String status, int sampleCount) { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringCalculatorTest.java index 0bf6ea4..ec50c23 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringCalculatorTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringCalculatorTest.java @@ -15,6 +15,7 @@ import org.mockito.ArgumentCaptor; import org.mockito.ArgumentMatchers; import org.mockito.InjectMocks; import org.mockito.Mock; +import org.mockito.Spy; import org.mockito.junit.jupiter.MockitoExtension; import org.mockito.junit.jupiter.MockitoSettings; import org.mockito.quality.Strictness; @@ -24,7 +25,9 @@ import org.springframework.test.util.ReflectionTestUtils; import java.math.BigDecimal; import java.time.LocalDateTime; +import java.util.LinkedHashMap; import java.util.List; +import java.util.Map; import java.util.Optional; import static org.junit.jupiter.api.Assertions.*; @@ -40,14 +43,17 @@ class CandidateScoringCalculatorTest { @Mock private UserRepository userRepository; @Mock private JdbcTemplate jdbcTemplate; @Mock private EntityManager entityManager; + @Mock private AbilityAssessmentScoreSource abilityScoreSource; + @Spy private AbilityScoreMapper abilityScoreMapper = new AbilityScoreMapper(); @InjectMocks private CandidateScoringCalculator calculator; + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringSnapshotWriter snapshotWriter; private static final Long STUDENT_ID = 2L; private Query queryMock; @BeforeEach void setUp() { - ReflectionTestUtils.setField(calculator, "entityManager", entityManager); + // R01-D4-1：快照写入已委托 snapshotWriter，Calculator 不再持有 entityManager。 queryMock = mock(Query.class); when(queryMock.setParameter(anyInt(), any())).thenReturn(queryMock); when(entityManager.createNativeQuery(anyString())).thenReturn(queryMock); @@ -121,7 +127,149 @@ class CandidateScoringCalculatorTest { @Test void internshipAndAbility_shouldBePending() { assertEquals("PENDING", calculator.computeInternship().status); - assertEquals("PENDING", calculator.computeAbility().status); + assertEquals("PENDING", calculator.computeAbility(STUDENT_ID, LocalDateTime.now()).status); + } + + // ── V38 ABILITY 接入：开关关闭/开启 ───────────────────────── + + private static final LocalDateTime NOW = LocalDateTime.now(); + + private AbilityAssessmentScoreSource.AbilityResultProjection proj(String dimJson, int answered) { + return new AbilityAssessmentScoreSource.AbilityResultProjection( + 123L, NOW.minusDays(1), NOW.plusDays(6), + "ability-v0.1", "ability-v0.1", answered, dimJson); + } + + private String dimsJson(int l, int c, int e, int r) { + return "[{\"code\":\"LOGIC\",\"score\":" + l + ",\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":" + c + ",\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":" + e + ",\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":" + r + ",\"answeredCount\":6}]"; + } + + @Test void ability_switchOff_noSourceCall_pendingV01() { + setEnabled(false); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("PENDING", r.status); + assertNull(r.score); + verify(abilityScoreSource, never()).findLatestValidCompletedResult(anyLong(), any()); + assertEquals("candidate-scoring-v0.1", calculator.currentRulesVersion()); + } + + @Test void ability_switchOn_validComplete_okAndV02() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(proj(dimsJson(80, 65, 75, 70), 24)); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("OK", r.status); + // 80*0.35 + 75*0.30 + 70*0.20 + 65*0.15 = 28 + 22.5 + 14 + 9.75 = 74.25 + assertEquals(new BigDecimal("74.25"), r.score); + assertEquals("candidate-scoring-v0.2", calculator.currentRulesVersion()); + assertEquals(4, r.subScores.size()); + assertNotNull(r.abilitySnapshotTrace); + // 白名单溯源字段，不含题目/答案/结果ID暴露层字段之外的内容 + assertEquals(123L, r.abilitySnapshotTrace.resultId()); + assertEquals(35, r.abilitySnapshotTrace.weights().get("LOGIC")); + } + + @Test void ability_switchOn_noResult_pending() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(null); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("PENDING", r.status); + assertNull(r.score); + assertEquals("candidate-scoring-v0.2", calculator.currentRulesVersion()); + } + + @Test void ability_switchOn_expiredProjection_isPendingWithExpiredExplanation() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(new AbilityAssessmentScoreSource.AbilityResultProjection( + 124L, NOW.minusDays(8), NOW, "ability-v0.1", "ability-v0.1", 24, + dimsJson(80, 65, 75, 70))); + CandidateScoringCalculator.DimensionResult r = calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("PENDING", r.status); + assertNull(r.score); + assertEquals("ABILITY_RESULT_EXPIRED", r.ruleContributions.get(0).ruleCode()); + assertEquals("EXPIRED", r.ruleContributions.get(0).outcome()); + } + + @Test void ability_decimalContributions_reconcileWithOverallRoundedScore() { + setEnabled(true); + var projection = new AbilityAssessmentScoreSource.AbilityResultProjection( + 125L, NOW.minusDays(1), NOW.plusDays(1), "ability-v0.1", "ability-v0.1", 24, + "[{\"code\":\"LOGIC\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":33.33,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":33.33,\"answeredCount\":6}]"); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), eq(NOW))) + .thenReturn(projection); + CandidateScoringCalculator.DimensionResult r = calculator.computeAbility(STUDENT_ID, NOW); + BigDecimal sum = r.ruleContributions.stream() + .map(c -> c.contribution() == null ? BigDecimal.ZERO : c.contribution()) + .reduce(BigDecimal.ZERO, BigDecimal::add); + assertEquals(r.score, sum); + assertTrue(r.ruleContributions.stream() + .anyMatch(c -> "SCORE_ROUNDING_ADJUSTMENT".equals(c.ruleCode()))); + } + + @Test void ability_switchOn_malformedJson_pendingNo500() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(proj("[{\"code\":\"LOGIC\"}]", 24)); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("PENDING", r.status); + assertNull(r.score); + } + + @Test void ability_switchOn_outOfRangeDimension_pending() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(proj(dimsJson(110, 65, 75, 70), 24)); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + assertEquals("PENDING", r.status); + assertNull(r.score); + } + + @Test void ability_onnlyOnceSourceQuery_noNplus1() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(proj(dimsJson(80, 65, 75, 70), 24)); + calculator.computeAbility(STUDENT_ID, NOW); + verify(abilityScoreSource, times(1)).findLatestValidCompletedResult(eq(STUDENT_ID), any()); + } + + @Test void ability_upsertWritesMinimalTraceJson_withoutSensitiveWords() { + setEnabled(true); + when(abilityScoreSource.findLatestValidCompletedResult(eq(STUDENT_ID), any())) + .thenReturn(proj(dimsJson(80, 65, 75, 70), 24)); + CandidateScoringCalculator.DimensionResult r = + calculator.computeAbility(STUDENT_ID, NOW); + calculator.upsertSnapshots(STUDENT_ID, List.of(r), "2026-08"); + + // R01-D4-1：写入委托 snapshotWriter；其 ABILITY 溯源 trace 不得含敏感字段。 + @SuppressWarnings("unchecked") + ArgumentCaptor> captor = + ArgumentCaptor.forClass(java.util.List.class); + verify(snapshotWriter).upsertIfChanged(eq(STUDENT_ID), captor.capture(), + eq("2026-08"), any(java.time.LocalDateTime.class), eq("candidate-scoring-v0.2")); + CandidateScoringCalculator.DimensionResult sent = captor.getValue().get(0); + assertNotNull(sent.abilitySnapshotTrace); + assertEquals(123L, sent.abilitySnapshotTrace.resultId()); + // 写入参数不携带任何问题/答案/敏感内容：XML 溯源仅保留 source/sourceResultId/validUntil/版本/权重/维度 + var payload = sent.abilitySnapshotTrace; + assertNotNull(payload.dimensionScores()); + // 同一次 ABILITY 写入使用 v0.2 规则版本（verify 中已断言 rulesVersion 传参） + } + + private void setEnabled(boolean enabled) { + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", enabled); } // ── COMPLIANCE ──────────────────────────────────────────── @@ -229,22 +377,24 @@ class CandidateScoringCalculatorTest { verify(jdbcTemplate, times(1)).queryForObject(anyString(), eq(Long.class), any(Object[].class)); } - // ── upsert SQL（原生 ON DUPLICATE KEY UPDATE） ───────────── + // ── upsert 委托（R01-D4-1：普通快照写入委托唯一 Writer） ────── - @Test void upsertSnapshots_shouldUseOnDuplicateKeyUpdate() { + @Test void upsertSnapshots_shouldDelegateToWriter() { CandidateScoringCalculator.DimensionResult r = calculator.computeEducation(StudentProfile.builder().userId(STUDENT_ID) .education("本科").school("清华大学").build()); calculator.upsertSnapshots(STUDENT_ID, List.of(r), "2026-08"); - ArgumentCaptor sql = ArgumentCaptor.forClass(String.class); - verify(entityManager).createNativeQuery(sql.capture()); - assertTrue(sql.getValue().contains("ON DUPLICATE KEY UPDATE")); - assertTrue(sql.getValue().contains("version=version+1")); - verify(entityManager.createNativeQuery(anyString())).executeUpdate(); + @SuppressWarnings("unchecked") + ArgumentCaptor> captor = + ArgumentCaptor.forClass(java.util.List.class); + verify(snapshotWriter).upsertIfChanged(eq(STUDENT_ID), captor.capture(), + eq("2026-08"), any(java.time.LocalDateTime.class), anyString()); + assertEquals(1, captor.getValue().size()); + assertEquals("EDUCATION", captor.getValue().get(0).dimension); } - // ── recomputeAndSnapshot ────────────────────────────────── + // ── recomputeAndSnapshot（Governance 强制版本路径委托 Writer） ── @Test void recomputeAndSnapshot_shouldRecomputeAndWritePeriod() { when(userRepository.findById(STUDENT_ID)).thenReturn(Optional.of(user())); @@ -256,9 +406,9 @@ class CandidateScoringCalculatorTest { calculator.recomputeAndSnapshot(STUDENT_ID, "EDUCATION", "2026-06"); assertEquals("EDUCATION", r.dimension); assertEquals(new BigDecimal("76.75"), r.score); - // period 作为绑定参数写入（写 2026-06 周期快照） - verify(queryMock).setParameter(anyInt(), eq("2026-06")); - verify(queryMock).executeUpdate(); + // 强制版本推进路径：委托 snapshotWriter.upsertForcingVersion + verify(snapshotWriter).upsertForcingVersion(eq(STUDENT_ID), eq(r), + eq("2026-06"), any(java.time.LocalDateTime.class), anyString()); } @Test void recomputeAndSnapshot_invalidDimension_should400() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockBoundaryIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockBoundaryIntegrationTest.java new file mode 100644 index 0000000..cb97818 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockBoundaryIntegrationTest.java @@ -0,0 +1,114 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * N02 的真实 H2 SQL 边界证据：不 Mock JdbcTemplate 或 Calculator，直接执行正式数据采集路径。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +@Transactional +class CandidateScoringClockBoundaryIntegrationTest { + + private static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + private static final LocalDateTime CAPTURED = LocalDateTime.of(2026, 9, 9, 12, 0); + private static final AtomicLong PHONE = new AtomicLong(930000000L); + + @Autowired private CandidateScoringCalculator calculator; + @Autowired private UserRepository userRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private JobRepository jobRepository; + @Autowired private org.springframework.jdbc.core.JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + @Test + void exactThirtyDaysAuditBoundary_isIncludedAndEarlierRecordExcluded() { + User user = createStudent(); + insertAudit(user.getId(), "LOGIN", CAPTURED.minusDays(30)); + insertAudit(user.getId(), "LOGIN", CAPTURED.minusDays(30).minusSeconds(1)); + + List results = calculator.computeAll(user.getId(), CAPTURED); + + CandidateScoringCalculator.DimensionResult stability = result(results, "STABILITY"); + CandidateScoringCalculator.DimensionResult activity = result(results, "ACTIVITY"); + assertEquals("OK", stability.status); + assertEquals(new BigDecimal("60.00"), stability.score, + "one exact-boundary login is included without changing the existing formula"); + assertEquals(new BigDecimal("0.00"), activity.score, + "a single login is below the activity threshold"); + } + + @Test + void exactNinetyDaysApplicationBoundary_isIncludedAndEarlierRecordExcluded() { + User user = createStudent(); + Company company = companyRepository.save(Company.builder() + .ownerUserId(user.getId()).name("clock-boundary-company").verified(true).build()); + Job exact = createJob(company.getId(), "clock-exact"); + Job earlier = createJob(company.getId(), "clock-earlier"); + insertApplication(exact.getId(), user.getId(), CAPTURED.minusDays(90)); + insertApplication(earlier.getId(), user.getId(), CAPTURED.minusDays(90).minusSeconds(1)); + + List results = calculator.computeAll(user.getId(), CAPTURED); + + CandidateScoringCalculator.DimensionResult activity = result(results, "ACTIVITY"); + assertEquals("OK", activity.status); + assertEquals(new BigDecimal("20.00"), activity.score, + "only the exact-boundary application contributes one recent application"); + } + + private User createStudent() { + User user = User.builder() + .phone("1" + PHONE.incrementAndGet()) + .nickname("clock-boundary-student") + .role(User.Role.STUDENT) + .roles(new HashSet<>(Set.of(User.Role.STUDENT))) + .active(true).verified(true).build(); + return userRepository.save(user); + } + + private Job createJob(Long companyId, String title) { + return jobRepository.save(Job.builder().companyId(companyId).title(title) + .description("clock boundary fixture").city("上海") + .employmentType("FULL_TIME").status("PUBLISHED").build()); + } + + private void insertAudit(Long userId, String action, LocalDateTime createdAt) { + jdbcTemplate.update("INSERT INTO audit_logs (user_id, action, created_at) VALUES (?, ?, ?)", + userId, action, createdAt); + } + + private void insertApplication(Long jobId, Long studentId, LocalDateTime createdAt) { + jdbcTemplate.update("INSERT INTO applications (job_id, student_user_id, status, created_at) VALUES (?, ?, ?, ?)", + jobId, studentId, "SUBMITTED", createdAt); + } + + private CandidateScoringCalculator.DimensionResult result( + List results, String dimension) { + return results.stream().filter(r -> dimension.equals(r.dimension)).findFirst().orElseThrow(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockConsistencyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockConsistencyTest.java new file mode 100644 index 0000000..ab8bf3b --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringClockConsistencyTest.java @@ -0,0 +1,314 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.auth.User; +import com.mydreamjob.candidatescore.explanation.RuleContribution; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.ArgumentMatchers; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; +import org.springframework.test.util.ReflectionTestUtils; +import jakarta.persistence.EntityManager; + +import java.math.BigDecimal; +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.List; +import java.util.Optional; +import java.util.concurrent.atomic.AtomicInteger; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class CandidateScoringClockConsistencyTest { + + @Mock CandidateScoringCalculator calculator; + @Mock CandidateDimensionScoreRepository snapshotRepository; + @Mock com.mydreamjob.company.CompanyRepository companyRepository; + @Mock com.mydreamjob.application.ApplicationRepository applicationRepository; + @Mock com.mydreamjob.job.JobService jobService; + @Mock com.mydreamjob.profile.StudentProfileRepository profileRepository; + @Mock com.mydreamjob.preference.StudentPreferenceRepository preferenceRepository; + @Mock com.mydreamjob.auth.UserRepository userRepository; + @Mock JdbcTemplate jdbcTemplate; + @Mock AbilityAssessmentScoreSource abilityScoreSource; + @Mock EntityManager entityManager; + + private static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + private static final LocalDateTime CAPTURED = LocalDateTime.of(2026, 9, 9, 12, 0); + + @Test + void overviewUsesOneCapturedTimeForComputeAndResponseWithoutSnapshotWrite() { + CandidateScoringEngineService service = new CandidateScoringEngineService( + calculator, snapshotRepository, companyRepository, applicationRepository, jobService); + LocalDateTime captured = LocalDateTime.of(2026, 9, 9, 12, 0); + service.setClock(Clock.fixed(captured.atZone(BUSINESS_ZONE).toInstant(), BUSINESS_ZONE)); + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = java.math.BigDecimal.TEN; + when(calculator.computeAll(eq(7L), any(LocalDateTime.class))).thenReturn(List.of(result)); + when(calculator.currentRulesVersion()).thenReturn(CandidateScoringCalculator.RULES_VERSION); + + var overview = service.getOverview(7L); + + ArgumentCaptor computeTime = ArgumentCaptor.forClass(LocalDateTime.class); + verify(calculator).computeAll(eq(7L), computeTime.capture()); + assertEquals(captured, computeTime.getValue()); + assertEquals(captured.atZone(BUSINESS_ZONE).toInstant(), overview.getGeneratedAt()); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); + } + + @Test + void exactThirtyDays_usesExistingBoundarySemantics() { + BoundaryCapture capture = new BoundaryCapture(); + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, capture); + List results = real.computeAll(7L, CAPTURED); + + assertEquals(new BigDecimal("20.00"), results.stream() + .filter(r -> "ACTIVITY".equals(r.dimension)).findFirst().orElseThrow().score); + // queryAudit uses created_at >= capturedNow.minusDays(30), including the exact boundary. + assertEquals(CAPTURED.minusDays(30), capture.auditBoundary); + } + + @Test + void exactNinetyDays_usesExistingBoundarySemantics() { + BoundaryCapture capture = new BoundaryCapture(); + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, capture); + List results = real.computeAll(7L, CAPTURED); + + assertEquals(new BigDecimal("20.00"), results.stream() + .filter(r -> "ACTIVITY".equals(r.dimension)).findFirst().orElseThrow().score); + // queryApps uses created_at >= capturedNow.minusDays(90); messages remain unwindowed. + assertEquals(CAPTURED.minusDays(90), capture.applicationBoundary); + } + + @Test + void accountAgeSixAndTwelveMonths_preservesStrictThresholds() { + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, new BoundaryCapture()); + var exactSix = real.computeStability(CAPTURED.minusMonths(6), 1, 0, 0, CAPTURED); + var overSix = real.computeStability(CAPTURED.minusMonths(7), 1, 0, 0, CAPTURED); + var exactTwelve = real.computeStability(CAPTURED.minusMonths(12), 1, 0, 0, CAPTURED); + var overTwelve = real.computeStability(CAPTURED.minusMonths(13), 1, 0, 0, CAPTURED); + + assertEquals(new BigDecimal("65.00"), exactSix.score); + assertEquals(new BigDecimal("80.00"), overSix.score); + assertEquals(new BigDecimal("80.00"), exactTwelve.score); + assertEquals(new BigDecimal("90.00"), overTwelve.score); + } + + @Test + void resumeUpdateExactlyNinetyDays_preservesExistingComparison() { + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, new BoundaryCapture()); + var exact = real.computeGrowth(1, CAPTURED.minusDays(90), 0, CAPTURED); + var newer = real.computeGrowth(1, CAPTURED.minusDays(89), 0, CAPTURED); + + assertEquals(new BigDecimal("40.00"), exact.score); + assertEquals(new BigDecimal("55.00"), newer.score); + } + + @Test + void abilityValidUntilEqualsCapturedNow_isExpiredOrUnavailable() { + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, new BoundaryCapture()); + ReflectionTestUtils.setField(real, "abilityAssessmentEnabled", true); + var projection = new AbilityAssessmentScoreSource.AbilityResultProjection( + 101L, CAPTURED.minusDays(1), CAPTURED, "ability-v0.1", "ability-v0.1", 24, + abilityJson(80, 70, 60, 50)); + when(abilityScoreSource.findLatestValidCompletedResult(7L, CAPTURED)).thenReturn(projection); + + var result = real.computeAbility(7L, CAPTURED); + + assertEquals("PENDING", result.status); + assertNull(result.score); + assertEquals("EXPIRED", result.ruleContributions.get(0).outcome()); + assertEquals("ABILITY_RESULT_EXPIRED", result.ruleContributions.get(0).ruleCode()); + } + + @Test + void abilityValidUntilAfterCapturedNow_isValid() { + CandidateScoringCalculator real = calculatorWithJdbcAggregates(CAPTURED, new BoundaryCapture()); + ReflectionTestUtils.setField(real, "abilityAssessmentEnabled", true); + var projection = new AbilityAssessmentScoreSource.AbilityResultProjection( + 102L, CAPTURED.minusDays(1), CAPTURED.plusNanos(1), "ability-v0.1", "ability-v0.1", 24, + abilityJson(80, 70, 60, 50)); + when(abilityScoreSource.findLatestValidCompletedResult(7L, CAPTURED)).thenReturn(projection); + + var result = real.computeAbility(7L, CAPTURED); + + assertEquals("OK", result.status); + assertEquals(new BigDecimal("66.50"), result.score); + assertEquals("ABILITY_LOGIC", result.ruleContributions.get(0).ruleCode()); + assertEquals(4, result.ruleContributions.size()); + } + + @Test + void advancingClockWithinOneRequest_usesOnlyInitialCapturedNow() { + CandidateScoringEngineService service = new CandidateScoringEngineService( + calculator, snapshotRepository, companyRepository, applicationRepository, jobService); + AdvancingClock advancing = new AdvancingClock(CAPTURED, BUSINESS_ZONE); + service.setClock(advancing); + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = BigDecimal.TEN; + result.ruleContributions = List.of(new RuleContribution("EDUCATION_LEVEL", "APPLIED", + BigDecimal.TEN, new BigDecimal("100"), "教育背景信息", "测试输入", "测试输入")); + when(calculator.computeAll(eq(7L), any(LocalDateTime.class))).thenReturn(List.of(result)); + when(calculator.currentRulesVersion()).thenReturn(CandidateScoringCalculator.RULES_VERSION); + + var overview = service.getOverview(7L); + + ArgumentCaptor computeTime = ArgumentCaptor.forClass(LocalDateTime.class); + verify(calculator).computeAll(eq(7L), computeTime.capture()); + assertEquals(CAPTURED, computeTime.getValue()); + assertEquals(CAPTURED.atZone(BUSINESS_ZONE).toInstant(), overview.getGeneratedAt()); + assertEquals(1, advancing.instantCalls.get()); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); + } + + @Test + void companyScoring_usesOneCapturedClockWithoutSnapshotWrite() { + CandidateScoringEngineService service = new CandidateScoringEngineService( + calculator, snapshotRepository, companyRepository, applicationRepository, jobService); + AdvancingClock advancing = new AdvancingClock(CAPTURED, BUSINESS_ZONE); + service.setClock(advancing); + when(companyRepository.findByOwnerUserId(200L)).thenReturn(Optional.of( + com.mydreamjob.company.Company.builder().id(9L).ownerUserId(200L).build())); + when(applicationRepository.findById(5L)).thenReturn(Optional.of( + com.mydreamjob.application.Application.builder().id(5L).jobId(50L).studentUserId(7L).build())); + when(jobService.getJob(50L)).thenReturn(com.mydreamjob.job.Job.builder().id(50L).companyId(9L).build()); + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = BigDecimal.TEN; + when(calculator.computeAll(eq(7L), any(LocalDateTime.class))).thenReturn(List.of(result)); + when(calculator.currentRulesVersion()).thenReturn(CandidateScoringCalculator.RULES_VERSION); + + var response = service.getCompanyScoring(200L, 5L); + + ArgumentCaptor computeTime = ArgumentCaptor.forClass(LocalDateTime.class); + verify(calculator).computeAll(eq(7L), computeTime.capture()); + assertEquals(CAPTURED, computeTime.getValue()); + assertEquals(CAPTURED.atZone(BUSINESS_ZONE).toInstant(), response.getGeneratedAt()); + assertEquals(1, advancing.instantCalls.get()); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); + } + + @Test + void detailCalculatedAndUpdatedAtUseSameCapturedTimeWithoutSnapshotWrite() { + CandidateScoringEngineService service = new CandidateScoringEngineService( + calculator, snapshotRepository, companyRepository, applicationRepository, jobService); + AdvancingClock advancing = new AdvancingClock(CAPTURED, BUSINESS_ZONE); + service.setClock(advancing); + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = BigDecimal.TEN; + result.ruleContributions = List.of(new RuleContribution("EDUCATION_LEVEL", "APPLIED", + BigDecimal.TEN, new BigDecimal("100"), "教育背景信息", "测试输入", "测试输入")); + when(calculator.computeAll(eq(7L), any(LocalDateTime.class))).thenReturn(List.of(result)); + when(calculator.currentRulesVersion()).thenReturn(CandidateScoringCalculator.RULES_VERSION); + + var detail = service.getDimensionDetail(7L, "EDUCATION"); + + ArgumentCaptor computeTime = ArgumentCaptor.forClass(LocalDateTime.class); + verify(calculator).computeAll(eq(7L), computeTime.capture()); + assertEquals(CAPTURED, computeTime.getValue()); + assertEquals(CAPTURED, detail.getCalculatedAt()); + assertEquals(CAPTURED, detail.getUpdatedAt()); + assertEquals(1, advancing.instantCalls.get()); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); + } + + private CandidateScoringCalculator calculatorWithJdbcAggregates(LocalDateTime captured, + BoundaryCapture capture) { + when(userRepository.findById(7L)).thenReturn(Optional.of(User.builder().id(7L) + .createdAt(captured.minusMonths(24)).build())); + when(profileRepository.findByUserId(7L)).thenReturn(Optional.of( + com.mydreamjob.profile.StudentProfile.builder().userId(7L) + .education("本科").school("清华大学").build())); + when(preferenceRepository.findByStudentUserId(7L)).thenReturn(Optional.empty()); + when(jdbcTemplate.queryForObject(anyString(), ArgumentMatchers.>any(), any(), any(), any())) + .thenAnswer(invocation -> { + String sql = invocation.getArgument(0); + if (sql.contains("FROM audit_logs")) { + capture.auditBoundary = invocation.getArgument(2, LocalDateTime.class); + return new CandidateScoringCalculator.AuditAgg(1, 1); + } + throw new AssertionError("unexpected three-parameter aggregate SQL: " + sql); + }); + when(jdbcTemplate.queryForObject(anyString(), ArgumentMatchers.>any(), any())) + .thenAnswer(invocation -> { + String sql = invocation.getArgument(0); + if (sql.contains("FROM offers")) return new CandidateScoringCalculator.OfferAgg(0, 0); + if (sql.contains("FROM candidate_feedback")) return new CandidateScoringCalculator.FbAgg(0, 0); + if (sql.contains("FROM resume_versions")) return new CandidateScoringCalculator.ResumeAgg(0, null); + throw new AssertionError("unexpected one-parameter aggregate SQL: " + sql); + }); + when(jdbcTemplate.queryForObject(anyString(), ArgumentMatchers.>any(), any(), any())) + .thenAnswer(invocation -> { + String sql = invocation.getArgument(0); + if (sql.contains("FROM applications")) { + capture.applicationBoundary = invocation.getArgument(2, LocalDateTime.class); + return new CandidateScoringCalculator.AppAgg(1, 0, captured.minusMonths(1), 1); + } + if (sql.contains("FROM audit_logs")) { + capture.auditBoundary = invocation.getArgument(2, LocalDateTime.class); + return new CandidateScoringCalculator.AuditAgg(1, 1); + } + if (sql.contains("FROM offers")) return new CandidateScoringCalculator.OfferAgg(0, 0); + if (sql.contains("FROM candidate_feedback")) return new CandidateScoringCalculator.FbAgg(0, 0); + if (sql.contains("FROM resume_versions")) return new CandidateScoringCalculator.ResumeAgg(0, null); + throw new AssertionError("unexpected aggregate SQL: " + sql); + }); + when(jdbcTemplate.queryForObject(anyString(), eq(Long.class), any(Object[].class))).thenReturn(0L); + CandidateScoringCalculator real = new CandidateScoringCalculator( + profileRepository, preferenceRepository, userRepository, jdbcTemplate, + abilityScoreSource, new AbilityScoreMapper(), + org.mockito.Mockito.mock( + com.mydreamjob.candidatescore.refresh.CandidateScoringSnapshotWriter.class)); + return real; + } + + private static String abilityJson(int logic, int communication, int execution, int learning) { + return "[{\"code\":\"LOGIC\",\"score\":" + logic + ",\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":" + communication + ",\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":" + execution + ",\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":" + learning + ",\"answeredCount\":6}]"; + } + + private static final class BoundaryCapture { + private LocalDateTime applicationBoundary; + private LocalDateTime auditBoundary; + } + + private static final class AdvancingClock extends Clock { + private final LocalDateTime first; + private final ZoneId zone; + private final AtomicInteger instantCalls = new AtomicInteger(); + + private AdvancingClock(LocalDateTime first, ZoneId zone) { + this.first = first; + this.zone = zone; + } + + @Override + public ZoneId getZone() { return zone; } + + @Override + public Clock withZone(ZoneId zone) { return new AdvancingClock(first, zone); } + + @Override + public Instant instant() { + int call = instantCalls.getAndIncrement(); + return first.plusDays(call).atZone(zone).toInstant(); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringControllerTest.java index bf364ec..09cc9bc 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringControllerTest.java @@ -53,15 +53,15 @@ class CandidateScoringControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "13800138000", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(200L, "13800138001", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(200L, "COMPANY"); } private String adminToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(300L, "13800138002", Map.of("roles", "ADMIN")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(300L, "ADMIN"); } private CandidateScoringOverviewResponse buildOverview() { @@ -74,6 +74,31 @@ class CandidateScoringControllerTest { .rulesVersion("candidate-scoring-v0.1").generatedAt(Instant.now()).build(); } + @Test void getOverview_explanationFieldsAreStudentOnlyAndStructured() throws Exception { + CandidateScoringOverviewResponse response = CandidateScoringOverviewResponse.builder() + .candidateId(100L).status("PARTIAL").overallScore(new BigDecimal("76.75")) + .rulesVersion("candidate-scoring-v0.1").explanationVersion("candidate-scoring-explanation-v1") + .comparabilityNotice("不同参与维度集合的综合分不适合直接横向比较") + .coverage(CandidateScoringOverviewResponse.Coverage.builder() + .computableDimensions(1).totalDimensions(8).includedDimensions(List.of("EDUCATION")) + .excludedDimensions(List.of(CandidateScoringOverviewResponse.ExcludedDimension.builder() + .dimension("INTERNSHIP").status("PENDING").reason("数据源未接入").build())).build()) + .dimensions(List.of(CandidateScoringOverviewResponse.DimensionItem.builder() + .dimension("EDUCATION").score(new BigDecimal("76.75")).status("OK") + .weight(new BigDecimal("12.50")).summary("教育背景信息").build())) + .build(); + when(scoringEngineService.getOverview(100L)).thenReturn(response); + String body = mockMvc.perform(get("/profile/me/candidate-scoring").header("Authorization", studentToken())) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.explanationVersion").value("candidate-scoring-explanation-v1")) + .andExpect(jsonPath("$.data.coverage.computableDimensions").value(1)) + .andExpect(jsonPath("$.data.coverage.totalDimensions").value(8)) + .andReturn().getResponse().getContentAsString(); + for (String banned : List.of("answerKey", "scoringRule", "questionCode", "competencyTag", "phone", "email")) { + org.junit.jupiter.api.Assertions.assertFalse(body.contains(banned), "must not expose " + banned); + } + } + private CompanyCandidateScoringResponse buildCompanyScoring() { return CompanyCandidateScoringResponse.builder() .applicationId(5L).overallScore(new BigDecimal("92.79")).status("PARTIAL") @@ -129,6 +154,21 @@ class CandidateScoringControllerTest { .andExpect(status().isBadRequest()); } + @Test + void getDimension_explanationInternalFailure_isSanitized() throws Exception { + when(scoringEngineService.getDimensionDetail(eq(100L), eq("EDUCATION"))) + .thenThrow(new IllegalStateException( + "candidate scoring explanation contains an unsupported rule: INTERNAL_SQL_COLUMN secret")); + + String body = mockMvc.perform(get("/profile/me/candidate-scoring/dimensions/EDUCATION") + .header("Authorization", studentToken())) + .andExpect(status().isInternalServerError()) + .andReturn().getResponse().getContentAsString(); + + org.junit.jupiter.api.Assertions.assertFalse(body.contains("INTERNAL_SQL_COLUMN")); + org.junit.jupiter.api.Assertions.assertFalse(body.contains("secret")); + } + @Test void getDimension_company_shouldReturn403() throws Exception { mockMvc.perform(get("/profile/me/candidate-scoring/dimensions/EDUCATION") .header("Authorization", companyToken())) @@ -175,7 +215,35 @@ class CandidateScoringControllerTest { .andExpect(content().string(not(containsString("candidateId")))) .andExpect(content().string(not(containsString("phone")))) .andExpect(content().string(not(containsString("email")))) - .andExpect(content().string(not(containsString("resumeUrl")))); + .andExpect(content().string(not(containsString("resumeUrl")))) + .andExpect(content().string(not(containsString("explanationVersion")))) + .andExpect(content().string(not(containsString("coverage")))) + .andExpect(content().string(not(containsString("comparabilityNotice")))) + .andExpect(content().string(not(containsString("displayName")))) + .andExpect(content().string(not(containsString("ruleContributions")))) + .andExpect(content().string(not(containsString("reasons")))) + .andExpect(content().string(not(containsString("dataSources")))) + .andExpect(content().string(not(containsString("limitations")))) + .andExpect(content().string(not(containsString("improvementActions")))) + .andExpect(content().string(not(containsString("evidenceLevel")))) + .andExpect(content().string(not(containsString("validity")))) + .andExpect(content().string(not(containsString("completedAt")))) + .andExpect(content().string(not(containsString("validUntil")))) + .andExpect(content().string(not(containsString("LOGIC")))) + .andExpect(content().string(not(containsString("COMMUNICATION")))) + .andExpect(content().string(not(containsString("EXECUTION")))) + .andExpect(content().string(not(containsString("LEARNING")))) + .andExpect(content().string(not(containsString("resultId")))) + .andExpect(content().string(not(containsString("attemptId")))) + .andExpect(content().string(not(containsString("questionCode")))) + .andExpect(content().string(not(containsString("answerKey")))) + .andExpect(content().string(not(containsString("scoringRule")))) + .andExpect(content().string(not(containsString("competencyTag")))) + .andExpect(content().string(not(containsString("auditLogs")))) + .andExpect(content().string(not(containsString("messageContent")))) + .andExpect(content().string(not(containsString("password")))) + .andExpect(content().string(not(containsString("token")))) + .andExpect(content().string(not(containsString("secret")))); } @Test void getCompanyScoring_crossCompany_shouldReturn403() throws Exception { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringEngineServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringEngineServiceTest.java index ea03ff1..79b3840 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringEngineServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringEngineServiceTest.java @@ -1,11 +1,15 @@ package com.mydreamjob.candidatescore; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.SerializationFeature; +import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; import com.mydreamjob.application.Application; import com.mydreamjob.application.ApplicationRepository; import com.mydreamjob.candidatescore.dto.CandidateScoringOverviewResponse; import com.mydreamjob.candidatescore.dto.CandidateScoringTrendResponse; import com.mydreamjob.candidatescore.dto.CompanyCandidateScoringResponse; import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; +import com.mydreamjob.candidatescore.explanation.RuleContribution; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; @@ -22,6 +26,7 @@ import org.mockito.junit.jupiter.MockitoSettings; import org.mockito.quality.Strictness; import java.math.BigDecimal; +import java.time.LocalDateTime; import java.util.List; import java.util.Optional; @@ -48,6 +53,20 @@ class CandidateScoringEngineServiceTest { CandidateScoringCalculator.DimensionResult r = new CandidateScoringCalculator.DimensionResult(name); r.score = score == null ? null : new BigDecimal(score); r.status = status; + String ruleCode = switch (name) { + case "EDUCATION" -> "EDUCATION_LEVEL"; + case "INTERNSHIP" -> "INTERNSHIP_SOURCE_UNAVAILABLE"; + case "ABILITY" -> "ABILITY_RESULT_MISSING"; + case "COMPLIANCE" -> "PREFERENCE_SALARY_PRESENT"; + case "STABILITY" -> "STABILITY_BASE"; + case "GROWTH" -> "GROWTH_BASE"; + case "INTEGRITY" -> "INTEGRITY_BASE"; + case "ACTIVITY" -> "ACTIVITY_APPLICATIONS"; + default -> throw new IllegalArgumentException("unsupported test dimension"); + }; + String outcome = r.score == null ? ("INTERNSHIP".equals(name) ? "UNAVAILABLE" : "MISSING") : "APPLIED"; + r.ruleContributions = List.of(new RuleContribution(ruleCode, outcome, r.score, + r.score == null ? null : new BigDecimal("100"), name, "test fixture", "test fixture")); return r; } @@ -65,13 +84,13 @@ class CandidateScoringEngineServiceTest { @BeforeEach void setUp() { - doNothing().when(calculator).upsertSnapshots(anyLong(), anyList(), anyString()); + when(calculator.currentRulesVersion()).thenReturn("candidate-scoring-v0.1"); } // ── 综合评分卡 ────────────────────────────────────────────── - @Test void getOverview_shouldAssembleAndUpsert() { - when(calculator.computeAll(STUDENT_ID)).thenReturn(sixComputable()); + @Test void getOverview_shouldAssembleWithoutWritingSnapshots() { + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(sixComputable()); CandidateScoringOverviewResponse resp = service.getOverview(STUDENT_ID); assertEquals(STUDENT_ID, resp.getCandidateId()); @@ -80,14 +99,14 @@ class CandidateScoringEngineServiceTest { assertEquals("PARTIAL", resp.getStatus()); assertEquals(8, resp.getDimensions().size()); assertEquals(new BigDecimal("12.50"), resp.getWeights().get("EDUCATION")); - verify(calculator, times(1)).computeAll(STUDENT_ID); - verify(calculator, times(1)).upsertSnapshots(eq(STUDENT_ID), anyList(), anyString()); + verify(calculator, times(1)).computeAll(eq(STUDENT_ID), any(LocalDateTime.class)); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); } @Test void getOverview_allPending_shouldBePending() { List allPending = List.of( dim("INTERNSHIP", null, "PENDING"), dim("ABILITY", null, "PENDING")); - when(calculator.computeAll(STUDENT_ID)).thenReturn(allPending); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(allPending); CandidateScoringOverviewResponse resp = service.getOverview(STUDENT_ID); assertEquals("PENDING", resp.getStatus()); assertNull(resp.getOverallScore()); @@ -98,26 +117,110 @@ class CandidateScoringEngineServiceTest { dim("EDUCATION", null, "INSUFFICIENT_DATA"), dim("COMPLIANCE", null, "INSUFFICIENT_DATA"), dim("INTERNSHIP", null, "PENDING")); - when(calculator.computeAll(STUDENT_ID)).thenReturn(all); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(all); CandidateScoringOverviewResponse resp = service.getOverview(STUDENT_ID); assertEquals("INSUFFICIENT_DATA", resp.getStatus()); assertNull(resp.getOverallScore()); } + // ── V38：开关开启规则版本 / 学生单维四维白名单 / 企业脱敏 ───── + + private static final ObjectMapper MAPPER = new ObjectMapper() + .registerModule(new JavaTimeModule()) + .disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); + + @Test void getOverview_switchOn_rulesVersionV02() { + when(calculator.currentRulesVersion()).thenReturn("candidate-scoring-v0.2"); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(sixComputable()); + CandidateScoringOverviewResponse resp = service.getOverview(STUDENT_ID); + assertEquals("candidate-scoring-v0.2", resp.getRulesVersion()); + } + + @Test void getDimensionDetail_ability_hasFourWhitelistedSubScores() throws Exception { + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(List.of(abilityDim("74.25"))); + DimensionScoreDetailResponse detail = service.getDimensionDetail(STUDENT_ID, "ABILITY"); + assertEquals("ABILITY", detail.getDimension()); + assertEquals("OK", detail.getStatus()); + assertEquals(new BigDecimal("74.25"), detail.getScore()); + assertEquals(4, detail.getSubScores().size()); + assertEquals(new BigDecimal("35"), detail.getSubScores().get(0).getWeight()); + assertEquals("逻辑能力", detail.getSubScores().get(0).getName()); + + // 真实 JSON 序列化脱敏断言（V38 P1：不再只调 DTO.toString()） + String json = MAPPER.writeValueAsString(detail); + // 学生 ABILITY 单维详情可含四维聚合分、权重、有效期 + assertTrue(json.contains("逻辑能力"), "must expose 逻辑能力"); + assertTrue(json.contains("执行能力")); + assertTrue(json.contains("学习能力")); + assertTrue(json.contains("沟通能力")); + assertTrue(json.contains("测评有效期"), "must expose validity period"); + for (String banned : List.of("sourceResultId", "attemptId", "resultId", "answerKey", "questionCode", + "competencyTag", "selectedOptionId", "scoringRule", "stem")) { + assertFalse(json.toLowerCase().contains(banned.toLowerCase()), "student detail must not leak " + banned); + } + } + + @Test void getCompanyScoring_abilityOnlyAggregate_noFourDimOrSourceLeak() throws Exception { + when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) + .thenReturn(Optional.of(Company.builder().id(1L).ownerUserId(COMPANY_USER_ID).build())); + when(applicationRepository.findById(APP_ID)) + .thenReturn(Optional.of(Application.builder().id(APP_ID).jobId(50L).studentUserId(STUDENT_ID).build())); + when(jobService.getJob(50L)).thenReturn(Job.builder().id(50L).companyId(1L).build()); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(List.of(abilityDim("74.25"), dim("EDUCATION", "76.75", "OK"))); + CompanyCandidateScoringResponse resp = service.getCompanyScoring(COMPANY_USER_ID, APP_ID); + assertEquals(2, resp.getDimensions().size()); + + String json = MAPPER.writeValueAsString(resp); + for (String banned : List.of("explanationVersion", "coverage", "comparabilityNotice", "displayName", + "ruleContributions", "reasons", "dataSources", "limitations", "improvementActions", + "evidenceLevel", "validity", "completedAt", "validUntil", "LOGIC", "COMMUNICATION", + "EXECUTION", "LEARNING", "studentUserId", "candidateId", "resultId", "attemptId", + "questionCode", "answerKey", "scoringRule", "competencyTag", "auditLogs", "messageContent", + "phone", "email", "resumeUrl", "password", "token", "secret", "selectedOptionId", "stem", + "subScores", "weights", "dimensionScores")) { + assertFalse(json.contains(banned), "company response must not leak " + banned); + } + } + + private CandidateScoringCalculator.DimensionResult abilityDim(String scoreStr) { + CandidateScoringCalculator.DimensionResult r = new CandidateScoringCalculator.DimensionResult("ABILITY"); + r.status = "OK"; + r.score = new BigDecimal(scoreStr); + r.subScores.add(sub("逻辑能力", "80.00", "35")); + r.subScores.add(sub("执行能力", "75.00", "30")); + r.subScores.add(sub("学习能力", "70.00", "20")); + r.subScores.add(sub("沟通能力", "65.00", "15")); + r.dataSources.add(DimensionScoreDetailResponse.DataSourceItem.builder() + .source("四维能力测评").time(LocalDateTime.now()).note("测评有效期").build()); + r.reasons.add("映射规则版本 ability-assessment-scoring-v0.1"); + r.ruleContributions = List.of( + new RuleContribution("ABILITY_LOGIC", "APPLIED", new BigDecimal("28.00"), new BigDecimal("35"), "逻辑能力", "测评聚合分", "固定权重"), + new RuleContribution("ABILITY_EXECUTION", "APPLIED", new BigDecimal("22.50"), new BigDecimal("30"), "执行能力", "测评聚合分", "固定权重"), + new RuleContribution("ABILITY_LEARNING", "APPLIED", new BigDecimal("14.00"), new BigDecimal("20"), "学习能力", "测评聚合分", "固定权重"), + new RuleContribution("ABILITY_COMMUNICATION", "APPLIED", new BigDecimal("9.75"), new BigDecimal("15"), "沟通能力", "测评聚合分", "固定权重")); + return r; + } + + private DimensionScoreDetailResponse.SubScore sub(String name, String score, String weight) { + return DimensionScoreDetailResponse.SubScore.builder() + .name(name).score(new BigDecimal(score)).weight(new BigDecimal(weight)).build(); + } + // ── 单维度明细 ──────────────────────────────────────────── @Test void getDimensionDetail_invalid_should400() { - when(calculator.computeAll(STUDENT_ID)).thenReturn(sixComputable()); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(sixComputable()); BusinessException ex = assertThrows(BusinessException.class, () -> service.getDimensionDetail(STUDENT_ID, "BOGUS")); assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); } @Test void getDimensionDetail_education_shouldReturnDetail() { - when(calculator.computeAll(STUDENT_ID)).thenReturn(sixComputable()); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(sixComputable()); DimensionScoreDetailResponse detail = service.getDimensionDetail(STUDENT_ID, "EDUCATION"); assertEquals("EDUCATION", detail.getDimension()); assertEquals("candidate-scoring-v0.1", detail.getRulesVersion()); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); } // ── 趋势 ───────────────────────────────────────────────── @@ -181,21 +284,27 @@ class CandidateScoringEngineServiceTest { assertEquals(ErrorCode.APPLICATION_OWNER_MISMATCH.getCode(), ex.getErrorCodeInt()); } - @Test void getCompanyScoring_success_whitelistOnly() { + @Test void getCompanyScoring_success_whitelistOnly() throws Exception { when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) .thenReturn(Optional.of(Company.builder().id(1L).ownerUserId(COMPANY_USER_ID).build())); when(applicationRepository.findById(APP_ID)) .thenReturn(Optional.of(Application.builder().id(APP_ID).jobId(50L).studentUserId(STUDENT_ID).build())); when(jobService.getJob(50L)).thenReturn(Job.builder().id(50L).companyId(1L).build()); - when(calculator.computeAll(STUDENT_ID)).thenReturn(sixComputable()); + when(calculator.computeAll(eq(STUDENT_ID), any(LocalDateTime.class))).thenReturn(sixComputable()); CompanyCandidateScoringResponse resp = service.getCompanyScoring(COMPANY_USER_ID, APP_ID); + verify(calculator, never()).upsertSnapshots(anyLong(), anyList(), anyString(), any(LocalDateTime.class)); assertEquals(APP_ID, resp.getApplicationId()); assertEquals("candidate-scoring-v0.1", resp.getRulesVersion()); assertEquals(8, resp.getDimensions().size()); - String json = resp.toString(); - for (String banned : List.of("studentUserId", "candidateId", "phone", "email", "resumeUrl", "passwordHash")) { - assertFalse(json.toLowerCase().contains(banned.toLowerCase())); + String json = MAPPER.writeValueAsString(resp); + for (String banned : List.of("explanationVersion", "coverage", "comparabilityNotice", "displayName", + "ruleContributions", "reasons", "dataSources", "limitations", "improvementActions", + "evidenceLevel", "validity", "completedAt", "validUntil", "LOGIC", "COMMUNICATION", + "EXECUTION", "LEARNING", "studentUserId", "candidateId", "resultId", "attemptId", + "questionCode", "answerKey", "scoringRule", "competencyTag", "auditLogs", "messageContent", + "phone", "email", "resumeUrl", "password", "token", "secret")) { + assertFalse(json.toLowerCase().contains(banned.toLowerCase()), "company response must not leak " + banned); } } } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationAssemblerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationAssemblerTest.java new file mode 100644 index 0000000..7d531af --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationAssemblerTest.java @@ -0,0 +1,170 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; +import com.mydreamjob.candidatescore.explanation.CandidateScoringExplanationAssembler; +import com.mydreamjob.candidatescore.explanation.RuleContribution; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +class CandidateScoringExplanationAssemblerTest { + + private static final LocalDateTime NOW = LocalDateTime.of(2026, 9, 9, 12, 0); + + @Test + void contributionSumAndValidityAreMappedFromCalculatorFacts() { + var result = new CandidateScoringCalculator.DimensionResult("ABILITY"); + result.status = "OK"; + result.score = new BigDecimal("74.25"); + result.ruleContributions = List.of( + new RuleContribution("ABILITY_LOGIC", "APPLIED", new BigDecimal("28.00"), new BigDecimal("35"), "逻辑能力", "测评聚合分", "按固定权重映射"), + new RuleContribution("ABILITY_EXECUTION", "APPLIED", new BigDecimal("22.50"), new BigDecimal("30"), "执行能力", "测评聚合分", "按固定权重映射"), + new RuleContribution("ABILITY_LEARNING", "APPLIED", new BigDecimal("14.00"), new BigDecimal("20"), "学习能力", "测评聚合分", "按固定权重映射"), + new RuleContribution("ABILITY_COMMUNICATION", "APPLIED", new BigDecimal("9.75"), new BigDecimal("15"), "沟通能力", "测评聚合分", "按固定权重映射")); + result.abilitySnapshotTrace = new CandidateScoringCalculator.AbilitySnapshotTrace( + 9L, NOW.minusHours(1), NOW.plusDays(6), "ability-v0.1", "candidate-scoring-v0.2", + java.util.Map.of("LOGIC", 35, "EXECUTION", 30, "LEARNING", 20, "COMMUNICATION", 15), + java.util.Map.of("LOGIC", new BigDecimal("80"), "EXECUTION", new BigDecimal("75"), + "LEARNING", new BigDecimal("70"), "COMMUNICATION", new BigDecimal("65"))); + + DimensionScoreDetailResponse response = CandidateScoringExplanationAssembler.assemble( + result, "candidate-scoring-v0.2", NOW); + + BigDecimal contributionSum = response.getRuleContributions().stream() + .map(DimensionScoreDetailResponse.RuleContribution::getContribution) + .reduce(BigDecimal.ZERO, BigDecimal::add); + assertEquals(new BigDecimal("74.25"), contributionSum); + assertEquals("candidate-scoring-explanation-v1", response.getExplanationVersion()); + assertNotNull(response.getValidity()); + assertFalse(response.getValidity().getExpired()); + assertEquals(NOW, response.getCalculatedAt()); + assertEquals(NOW, response.getUpdatedAt()); + } + + @Test + void unknownInternalRuleCodeFailsClosedWithoutEchoingInternalValue() { + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = new BigDecimal("76.75"); + result.ruleContributions = List.of( + new RuleContribution("EDUCATION_LEVEL", "APPLIED", new BigDecimal("38.50"), new BigDecimal("55"), "学历层次", "本科", "固定映射"), + new RuleContribution("INTERNAL_SQL_COLUMN", "APPLIED", new BigDecimal("38.25"), new BigDecimal("45"), "内部", "secret", "内部对象")); + IllegalStateException ex = assertThrows(IllegalStateException.class, + () -> CandidateScoringExplanationAssembler.assemble(result, "candidate-scoring-v0.1", NOW)); + assertEquals("candidate scoring explanation contains an unsupported rule", ex.getMessage()); + assertFalse(ex.getMessage().contains("INTERNAL_SQL_COLUMN")); + assertFalse(ex.getMessage().contains("secret")); + } + + @Test + void unknownOutcomeFailsClosedWithoutEchoingInternalValue() { + var result = result("OK", new BigDecimal("10.00")); + result.ruleContributions = List.of(new RuleContribution( + "EDUCATION_LEVEL", "FORGED", new BigDecimal("10.00"), + new BigDecimal("100"), "内部标签", "secret", "内部对象")); + + IllegalStateException ex = assertThrows(IllegalStateException.class, + () -> CandidateScoringExplanationAssembler.assemble( + result, "candidate-scoring-v0.1", NOW)); + + assertEquals("candidate scoring explanation contains an unsupported rule", ex.getMessage()); + assertFalse(ex.getMessage().contains("FORGED")); + assertFalse(ex.getMessage().contains("secret")); + } + + @Test + void nullOrBlankOutcomeFailsClosed() { + for (String outcome : new String[]{null, "", " "}) { + var result = result("OK", new BigDecimal("10.00")); + result.ruleContributions = List.of(new RuleContribution( + "EDUCATION_LEVEL", outcome, new BigDecimal("10.00"), + new BigDecimal("100"), "教育背景信息", "测试", "测试")); + assertSafeFailure(result); + } + } + + @Test + void allSupportedOutcomesRemainAccepted() { + for (String outcome : List.of("APPLIED", "NOT_APPLIED", "MISSING", "EXPIRED", "UNAVAILABLE")) { + var result = result("PENDING", null); + result.ruleContributions = List.of(new RuleContribution( + "ABILITY_RESULT_MISSING", outcome, null, null, + "四维能力测评", "安全说明", "安全说明")); + + var response = CandidateScoringExplanationAssembler.assemble( + result, "candidate-scoring-v0.1", NOW); + + assertEquals(outcome, response.getRuleContributions().get(0).getOutcome()); + } + } + + @Test + void knownContributionsThatDoNotReconcileFailClosed() { + var result = new CandidateScoringCalculator.DimensionResult("EDUCATION"); + result.status = "OK"; + result.score = new BigDecimal("76.75"); + result.ruleContributions = List.of( + new RuleContribution("EDUCATION_LEVEL", "APPLIED", new BigDecimal("38.50"), new BigDecimal("55"), "学历层次", "本科", "固定映射"), + new RuleContribution("EDUCATION_SCHOOL_TIER", "APPLIED", new BigDecimal("38.00"), new BigDecimal("45"), "学校层次", "其他", "固定映射")); + IllegalStateException ex = assertThrows(IllegalStateException.class, + () -> CandidateScoringExplanationAssembler.assemble(result, "candidate-scoring-v0.1", NOW)); + assertEquals("candidate scoring explanation contains an unsupported rule", ex.getMessage()); + } + + @Test + void nullContributionListFailsClosed() { + var result = result("PENDING", null); + result.ruleContributions = null; + assertSafeFailure(result); + } + + @Test + void emptyContributionListWithScoreFailsClosed() { + var result = result("OK", new BigDecimal("76.75")); + result.ruleContributions = List.of(); + assertSafeFailure(result); + } + + @Test + void pendingWithoutDiagnosticContributionFailsClosed() { + var result = result("PENDING", null); + result.ruleContributions = List.of(); + assertSafeFailure(result); + } + + @Test + void nullContributionElementFailsClosed() { + var result = result("OK", BigDecimal.TEN); + result.ruleContributions = new java.util.ArrayList<>(); + result.ruleContributions.add(null); + assertSafeFailure(result); + } + + @Test + void validDiagnosticContributionWithoutScoreSucceeds() { + var result = result("PENDING", null); + result.ruleContributions = List.of(new RuleContribution( + "ABILITY_RESULT_MISSING", "MISSING", null, null, + "四维能力测评", "没有可用结果", "没有可用结果")); + var response = CandidateScoringExplanationAssembler.assemble(result, "candidate-scoring-v0.1", NOW); + assertNull(response.getScore()); + assertEquals(1, response.getRuleContributions().size()); + } + + private CandidateScoringCalculator.DimensionResult result(String status, BigDecimal score) { + var result = new CandidateScoringCalculator.DimensionResult("ABILITY"); + result.status = status; + result.score = score; + return result; + } + + private void assertSafeFailure(CandidateScoringCalculator.DimensionResult result) { + IllegalStateException ex = assertThrows(IllegalStateException.class, + () -> CandidateScoringExplanationAssembler.assemble(result, "candidate-scoring-v0.1", NOW)); + assertEquals("candidate scoring explanation contains an unsupported rule", ex.getMessage()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationCatalogTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationCatalogTest.java new file mode 100644 index 0000000..a8f9638 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationCatalogTest.java @@ -0,0 +1,53 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.candidatescore.explanation.CandidateScoringExplanationCatalog; +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +class CandidateScoringExplanationCatalogTest { + + @Test + void catalogContainsNeutralMetadataForAllEightDimensions() { + List dimensions = List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + for (String dimension : dimensions) { + var metadata = CandidateScoringExplanationCatalog.metadata(dimension); + assertNotBlank(metadata.displayName()); + assertNotBlank(metadata.whatItMeasures()); + assertNotBlank(metadata.interpretation()); + assertFalse(metadata.limitations().isEmpty()); + assertFalse(metadata.improvementActions().isEmpty()); + assertTrue(List.of("DIRECT_RULE", "SELF_REPORTED", "BEHAVIOR_PROXY", "UNVALIDATED_PROXY") + .contains(metadata.evidenceLevel())); + } + } + + @Test + void catalogUsesRequiredNeutralSafetyLanguage() { + var integrity = CandidateScoringExplanationCatalog.metadata("INTEGRITY"); + assertTrue(integrity.limitations().stream().anyMatch(s -> s.contains("不是个人征信") && s.contains("人格判断"))); + assertFalse(CandidateScoringExplanationCatalog.metadata("GROWTH").interpretation().contains("成长潜力")); + assertFalse(CandidateScoringExplanationCatalog.metadata("STABILITY").interpretation().contains("忠诚度")); + assertFalse(CandidateScoringExplanationCatalog.metadata("COMPLIANCE").interpretation().contains("服从性")); + assertFalse(CandidateScoringExplanationCatalog.metadata("ACTIVITY").interpretation().contains("工作积极性")); + assertTrue(CandidateScoringExplanationCatalog.metadata("EDUCATION").limitations().stream() + .anyMatch(s -> s.contains("不能代表智力") && s.contains("录用适合度"))); + assertTrue(CandidateScoringExplanationCatalog.metadata("ABILITY").limitations().stream() + .anyMatch(s -> s.contains("不代表确定性工作能力") && s.contains("录用结论"))); + } + + @Test + void unknownDimensionAndRuleCodeAreNotExposed() { + assertThrows(IllegalArgumentException.class, () -> CandidateScoringExplanationCatalog.metadata("UNKNOWN")); + assertFalse(CandidateScoringExplanationCatalog.isKnownRuleCode("INTERNAL_SQL_COLUMN")); + assertTrue(CandidateScoringExplanationCatalog.isKnownRuleCode("SCORE_CAP_ADJUSTMENT")); + } + + private static void assertNotBlank(String value) { + assertNotNull(value); + assertFalse(value.isBlank()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationIntegrationTest.java new file mode 100644 index 0000000..666ef4a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringExplanationIntegrationTest.java @@ -0,0 +1,68 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.preference.StudentPreferenceRepository; +import com.mydreamjob.profile.StudentProfile; +import com.mydreamjob.profile.StudentProfileRepository; +import jakarta.persistence.EntityManager; +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 org.springframework.jdbc.core.JdbcTemplate; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +@ExtendWith(MockitoExtension.class) +class CandidateScoringExplanationIntegrationTest { + @Mock StudentProfileRepository profileRepository; + @Mock StudentPreferenceRepository preferenceRepository; + @Mock UserRepository userRepository; + @Mock JdbcTemplate jdbcTemplate; + @Mock EntityManager entityManager; + @Mock AbilityAssessmentScoreSource abilityScoreSource; + @Mock AbilityScoreMapper abilityScoreMapper; + @InjectMocks CandidateScoringCalculator calculator; + + @Test + void realCalculatorBranchesProduceContributionsThatReconcileToScore() { + var captured = LocalDateTime.of(2026, 9, 9, 12, 0); + var education = calculator.computeEducation( + StudentProfile.builder().education("本科").school("清华大学").build(), captured); + var stability = calculator.computeStability(captured.minusMonths(24), 3, 0, 2, captured); + var growth = calculator.computeGrowth(2, captured.minusDays(10), 5, captured); + var integrity = calculator.computeIntegrity(2, 0, 3, 4.5, true, captured); + var activity = calculator.computeActivity(6, 3, 1, captured); + + for (var result : List.of(education, stability, growth, integrity, activity)) { + assertNotNull(result.score, result.dimension + " score"); + BigDecimal sum = result.ruleContributions.stream() + .map(r -> r.contribution() == null ? BigDecimal.ZERO : r.contribution()) + .reduce(BigDecimal.ZERO, BigDecimal::add); + assertEquals(result.score, sum, result.dimension + " contribution reconciliation"); + assertTrue(result.dataSources.stream().noneMatch(source -> source.getSource().contains(".") || source.getSource().contains("/")), + result.dimension + " must use semantic source labels"); + } + assertTrue(integrity.ruleContributions.stream().anyMatch(r -> "INTEGRITY_BASE".equals(r.ruleCode()))); + assertTrue(activity.ruleContributions.stream().anyMatch(r -> "ACTIVITY_MESSAGES".equals(r.ruleCode()))); + } + + @Test + void missingAndUnavailableBranchesDoNotPretendToContributeZero() { + var missing = calculator.computeEducation(null, LocalDateTime.of(2026, 9, 9, 12, 0)); + assertEquals("INSUFFICIENT_DATA", missing.status); + assertNull(missing.score); + assertEquals("MISSING", missing.ruleContributions.get(0).outcome()); + assertNull(missing.ruleContributions.get(0).contribution()); + + var internship = calculator.computeInternship(LocalDateTime.of(2026, 9, 9, 12, 0)); + assertEquals("PENDING", internship.status); + assertEquals("UNAVAILABLE", internship.ruleContributions.get(0).outcome()); + assertNull(internship.ruleContributions.get(0).contribution()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringPersistenceIntegrationTest.java index 2d7da1a..ae43fca 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringPersistenceIntegrationTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/CandidateScoringPersistenceIntegrationTest.java @@ -4,8 +4,10 @@ import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; import com.mydreamjob.candidatescore.dto.CandidateScoringOverviewResponse; import com.mydreamjob.candidatescore.dto.CandidateScoringTrendResponse; +import org.junit.jupiter.api.AfterEach; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; +import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.boot.test.mock.mockito.MockBean; @@ -14,6 +16,7 @@ import org.springframework.data.redis.core.ValueOperations; import org.springframework.test.context.ActiveProfiles; import java.time.LocalDate; +import java.time.LocalDateTime; import java.util.HashSet; import java.util.List; import java.util.Set; @@ -28,23 +31,69 @@ import static org.mockito.Mockito.when; class CandidateScoringPersistenceIntegrationTest { @Autowired private CandidateScoringEngineService service; + @Autowired private CandidateScoringCalculator calculator; @Autowired private UserRepository userRepository; @Autowired private CandidateDimensionScoreRepository snapshotRepository; + @Autowired private JdbcTemplate jdbcTemplate; @MockBean private RedisTemplate redisTemplate; + /** + * 本测试**独占**的手机号段。用于： + *
      + *
    1. 前置断言"独占键不存在"，避免上一轮残留被静默覆盖而掩盖污染；
      2. + *
    2. 收尾按精确条件清理本测试创建的数据。
      3. + *
    + */ + private static final List OWN_PHONES = + List.of("13900009901", "13900009902", "13900009903"); + + /** 本测试创建的用户 id（每个用例自建，收尾按精确 id 清理）。 */ + private final List ownUserIds = new java.util.ArrayList<>(); + @BeforeEach @SuppressWarnings("unchecked") void setUp() { ValueOperations ops = mock(ValueOperations.class); when(redisTemplate.opsForValue()).thenReturn(ops); when(redisTemplate.hasKey(any())).thenReturn(false); + + // 前置断言：独占手机号不得预先存在。若上一轮清理失效，这里立即失败， + // 而不是让残留数据静默参与断言（也会污染同期其它测试的期间统计）。 + for (String phone : OWN_PHONES) { + Integer existing = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone = ?", Integer.class, phone); + assertTrue(existing == null || existing == 0, + "独占夹具手机号 " + phone + " 已存在，说明上轮清理失效（不得静默覆盖）"); + } + ownUserIds.clear(); + } + + /** + * 收尾：按**精确 id** 删除本测试创建的数据，遵循外键顺序（快照 → 角色 → 用户）。 + * + *

    背景：本类会以 {@code currentPeriod()} 物化 8 条维度快照。这些行若残留， + * 会进入同一 H2 库中其它测试对"当前期间"的总体统计 + * （例如 {@code FairnessMonitoringHttpIntegrationTest} 的 {@code populationSize}）， + * 造成顺序相关的误失败。此处只删除自有 id，**不使用 {@code deleteAll}**， + * 不触碰任何其它测试的数据。

    + */ + @AfterEach + void cleanUpOwnFixture() { + for (Long userId : ownUserIds) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id = ?", userId); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", userId); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", userId); + } + ownUserIds.clear(); } private User createStudent(String phone) { User u = User.builder().phone(phone).nickname("scoring-test") .role(User.Role.STUDENT).active(true).verified(true).build(); u.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); - return userRepository.save(u); + User saved = userRepository.save(u); + ownUserIds.add(saved.getId()); + return saved; } private String currentPeriod() { @@ -52,30 +101,41 @@ class CandidateScoringPersistenceIntegrationTest { return String.format("%04d-%02d", d.getYear(), d.getMonthValue()); } + private CandidateScoringOverviewResponse computeAndMaterialize(Long studentId) { + LocalDateTime capturedNow = LocalDateTime.now(); + CandidateScoringOverviewResponse response = service.getOverview(studentId); + calculator.upsertSnapshots(studentId, calculator.computeAll(studentId, capturedNow), + currentPeriod(), capturedNow); + return response; + } + @Test - void upsertSnapshots_shouldBeIdempotentAndIncrementVersion() { + void upsertSnapshots_shouldBeIdempotentInValuesAndPersistEightRows() { + // R01-D4-1 契约：评分输入未变化时，普通物化必须幂等（值不变 → version 不变）。 User u = createStudent("13900009901"); String period = currentPeriod(); - CandidateScoringOverviewResponse first = service.getOverview(u.getId()); + CandidateScoringOverviewResponse first = computeAndMaterialize(u.getId()); List rows1 = snapshotRepository.findByStudentUserIdAndPeriod(u.getId(), period); assertEquals(8, rows1.size()); // 新用户无数据：全部 INSUFFICIENT_DATA / PENDING，overallScore=null assertEquals("INSUFFICIENT_DATA", first.getStatus()); assertNull(first.getOverallScore()); - Long version1 = rows1.get(0).getVersion(); - // 再次调用：同周期覆盖，version 递增，行数不变 - service.getOverview(u.getId()); + // 再次调用：值未变化 → version 不变（幂等物化），行数不变 + computeAndMaterialize(u.getId()); List rows2 = snapshotRepository.findByStudentUserIdAndPeriod(u.getId(), period); assertEquals(8, rows2.size()); - assertEquals(version1 + 1, rows2.get(0).getVersion()); + for (int i = 0; i < rows1.size(); i++) { + assertEquals(rows1.get(i).getVersion(), rows2.get(i).getVersion(), + "重复相同值 upsert 不得推进 version: " + rows1.get(i).getDimension()); + } } @Test void upsert_rulesVersionPersisted() { User u = createStudent("13900009902"); - service.getOverview(u.getId()); + computeAndMaterialize(u.getId()); List rows = snapshotRepository.findByStudentUserIdAndPeriod(u.getId(), currentPeriod()); assertTrue(rows.stream().allMatch(r -> "candidate-scoring-v0.1".equals(r.getRulesVersion()))); assertTrue(rows.stream().allMatch(r -> r.getWeight().doubleValue() == 12.50)); @@ -84,7 +144,7 @@ class CandidateScoringPersistenceIntegrationTest { @Test void trend_shouldReadSnapshotsOfCurrentPeriod() { User u = createStudent("13900009903"); - service.getOverview(u.getId()); + computeAndMaterialize(u.getId()); CandidateScoringTrendResponse trend = service.getTrend(u.getId(), 6); assertEquals(1, trend.getItems().size()); assertEquals(currentPeriod(), trend.getItems().get(0).getPeriod()); diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/R01D4GetWritesSnapshotEvidenceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/R01D4GetWritesSnapshotEvidenceTest.java new file mode 100644 index 0000000..0fdf9a1 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/R01D4GetWritesSnapshotEvidenceTest.java @@ -0,0 +1,113 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.dto.CandidateScoringOverviewResponse; +import com.mydreamjob.candidatescore.dto.CandidateScoringTrendResponse; +import com.mydreamjob.candidatescore.dto.DimensionScoreDetailResponse; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 契约证据：评分 GET 只实时计算响应，不写 candidate_dimension_scores。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class R01D4GetWritesSnapshotEvidenceTest { + + @Autowired private CandidateScoringEngineService service; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private Long studentId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + User u = User.builder().phone("133" + String.format("%08d", System.nanoTime() % 100_000_000L)) + .nickname("r01d4-evidence").role(User.Role.STUDENT) + .active(true).verified(true).build(); + u.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + studentId = userRepository.save(u).getId(); + } + + private List> snapshotRows() { + return jdbcTemplate.queryForList(""" + SELECT id, student_user_id, dimension, score, status, weight, period, + rules_version, version, created_at, updated_at + FROM candidate_dimension_scores + ORDER BY id + """); + } + + private long countRows(String table) { + Long c = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM " + table, Long.class); + return c == null ? -1 : c; + } + + @Test + void overviewGet_returnsRealtimeResultWithoutWritingSnapshots() { + List> before = snapshotRows(); + CandidateScoringOverviewResponse first = service.getOverview(studentId); + CandidateScoringOverviewResponse second = service.getOverview(studentId); + assertEquals(before, snapshotRows(), "overview GET 必须保持快照表逐字段不变"); + assertEquals(first.getOverallScore(), second.getOverallScore()); + assertEquals(first.getStatus(), second.getStatus()); + } + + @Test + void dimensionDetailGet_returnsRealtimeResultWithoutWritingSnapshots() { + List> before = snapshotRows(); + DimensionScoreDetailResponse detail = service.getDimensionDetail(studentId, "EDUCATION"); + assertNotNull(detail); + assertEquals(before, snapshotRows(), "单维度 GET 必须保持快照表逐字段不变"); + } + + @Test + void trendGet_isReadOnly() { + List> before = snapshotRows(); + CandidateScoringTrendResponse t1 = service.getTrend(studentId, 6); + CandidateScoringTrendResponse t2 = service.getTrend(studentId, 6); + assertEquals(before, snapshotRows(), "trend GET 必须保持快照表逐字段不变"); + assertEquals(t1.getItems().size(), t2.getItems().size()); + } + + @Test + void invalidDimensionGet_doesNotWrite() { + List> before = snapshotRows(); + assertThrows(com.mydreamjob.common.exception.BusinessException.class, + () -> service.getDimensionDetail(studentId, "BOGUS")); + assertEquals(before, snapshotRows(), "非法 dimension 不得写库"); + } + + @Test + void overviewGet_doesNotWriteAuditOrNotifications() { + service.getOverview(studentId); + long audit = countRows("audit_logs"); + long notif = countRows("notifications"); + service.getOverview(studentId); + service.getOverview(studentId); + assertEquals(audit, countRows("audit_logs"), "GET 评分不得写 audit_logs"); + assertEquals(notif, countRows("notifications"), "GET 评分不得写 notifications"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/V38AbilityRankingIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/V38AbilityRankingIntegrationTest.java new file mode 100644 index 0000000..c792cd0 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/V38AbilityRankingIntegrationTest.java @@ -0,0 +1,188 @@ +package com.mydreamjob.candidatescore; + +import com.mydreamjob.ability.AbilityAttempt; +import com.mydreamjob.ability.AbilityAttemptRepository; +import com.mydreamjob.ability.AbilityDefinition; +import com.mydreamjob.ability.AbilityDefinitionRepository; +import com.mydreamjob.ability.AbilityResult; +import com.mydreamjob.ability.AbilityResultRepository; +import com.mydreamjob.application.Application; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.competition.CompetitionRankingCalculator; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * V38 → V32 排名回归（真实快照写路径 + 真实 CompetitionRankingCalculator）。 + * + *

    不伪造 ABILITY 快照：开关开启且存在最新有效 V36 结果时，先经 + * {@link CandidateScoringCalculator} 的真实候选评分物化路径， + * 使 ABILITY 以既定权重公式计入综合分，再交排名组件计算 overallScore/rank/percentile。 + * 开关关闭时 ABILITY 保持 PENDING，综合分与既有口径一致（无可计算维度 → 本人无分）。

    + * + *

    避免写 student_profiles 等易引跨类 FK 污染的关联表：基线用无资料、无活跃数据的 + * 学生，OFF 时无可计算维度；peer 的快照在内存构造（仅作排名对照，非被测对象）。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class V38AbilityRankingIntegrationTest { + + private static final AtomicLong PHONE = new AtomicLong(8200); + + private static final String DIMS_OK = + "[{\"code\":\"LOGIC\",\"score\":80,\"answeredCount\":6}," + + "{\"code\":\"EXECUTION\",\"score\":75,\"answeredCount\":6}," + + "{\"code\":\"LEARNING\",\"score\":70,\"answeredCount\":6}," + + "{\"code\":\"COMMUNICATION\",\"score\":65,\"answeredCount\":6}]"; + + @Autowired private UserRepository userRepository; + @Autowired private AbilityDefinitionRepository definitionRepository; + @Autowired private AbilityAttemptRepository attemptRepository; + @Autowired private AbilityResultRepository resultRepository; + @Autowired private CandidateScoringCalculator calculator; + @Autowired private CompetitionRankingCalculator rankingCalculator; + + @MockBean private RedisTemplate redisTemplate; + + private final List createdUsers = new ArrayList<>(); + private Long defId; + + @BeforeEach + void setUp() { + when(redisTemplate.opsForValue()).thenReturn(mock(org.springframework.data.redis.core.ValueOperations.class)); + when(redisTemplate.hasKey(any())).thenReturn(false); + AbilityDefinition def = definitionRepository.findAll().stream() + .filter(d -> "WORKPLACE_ABILITY".equals(d.getTypeCode())) + .findFirst().orElseThrow(() -> new IllegalStateException("WORKPLACE_ABILITY must be seeded")); + defId = def.getId(); + } + + @AfterEach + void tearDown() { + for (Long id : createdUsers) { + userRepository.deleteById(id); + } + createdUsers.clear(); + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", false); + } + + private Long createUser() { + User u = userRepository.save(User.builder() + .phone("20" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).active(true).verified(true).build()); + createdUsers.add(u.getId()); + return u.getId(); + } + + private void giveValidAbilityResult(Long userId) { + LocalDateTime now = LocalDateTime.now(); + AbilityAttempt a = attemptRepository.save(AbilityAttempt.builder() + .studentUserId(userId).definitionId(defId).status("COMPLETED").answeredCount(24) + .questionSetVersion("ability-v0.1").completedAt(now.minusDays(1)).build()); + resultRepository.save(AbilityResult.builder() + .attemptId(a.getId()).dimensionScoresJson(DIMS_OK).overallScore(new BigDecimal("70.00")) + .questionSetVersion("ability-v0.1").rulesVersion("ability-v0.1") + .validUntil(now.plusDays(6)).generatedAt(now).build()); + } + + private String currentMonth() { + return String.format("%04d-%02d", LocalDate.now().getYear(), LocalDate.now().getMonthValue()); + } + + private Application app(Long studentId, LocalDateTime createdAt) { + return Application.builder().jobId(99L).studentUserId(studentId) + .status("SUBMITTED").createdAt(createdAt).build(); + } + + private CandidateDimensionScore educationSnap(Long studentId, String score) { + return CandidateDimensionScore.builder().studentUserId(studentId) + .dimension("EDUCATION").score(new BigDecimal(score)).status("OK") + .period(currentMonth()).rulesVersion("candidate-scoring-v0.1") + .weight(new BigDecimal("12.50")).build(); + } + + private void setEnabled(boolean b) { + ReflectionTestUtils.setField(calculator, "abilityAssessmentEnabled", b); + } + + private void materialize(Long studentId) { + LocalDateTime capturedNow = LocalDateTime.now(); + calculator.upsertSnapshots(studentId, calculator.computeAll(studentId, capturedNow), + currentMonth(), capturedNow); + } + + /** + * me 为无资料/无活跃数据学生；peer 由内存快照给出 EDUCATION=70（仅作对照组）。 + * 开关关闭：me 无可计算维度 → overall=null、rank=null、percentile=null（ABILITY=PENDING）。 + * 开关开启且 me 有最新有效 V36 结果：经真实评分写快照路径 ABILITY=OK 74.25， + * me overall=74.25 → rank1 / percentile100。排名只因 ABILITY 按既定公式变化。 + */ + @Test + void ranking_pendingVsAbilityOk_effectsOnlyByFormula() { + Long me = createUser(); + Long peer = createUser(); + String month = currentMonth(); + LocalDateTime tMe = LocalDateTime.now().minusHours(2); + LocalDateTime tPeer = LocalDateTime.now().minusHours(1); + List cohort = List.of(app(me, tMe), app(peer, tPeer)); + Map> peerOnly = + Map.of(peer, List.of(educationSnap(peer, "70.00"))); + + // 关闭：ABILITY=PENDING，me 无可计算维度 + setEnabled(false); + materialize(me); + Map> offSnaps = + new HashMap<>(rankingCalculator.loadLatestSnapshots(List.of(me), month)); + offSnaps.putAll(peerOnly); + CompetitionRankingCalculator.CohortRanking off = + rankingCalculator.rankCohort(cohort, offSnaps, me); + assertNull(off.overallScore, "OFF: no computable dimension → overall null"); + assertNull(off.rank, "OFF: unscored → rank null"); + assertNull(off.percentile, "OFF: unscored → percentile null"); + assertEquals("PENDING", off.meSnaps.stream() + .filter(s -> "ABILITY".equals(s.getDimension())).findFirst().get().getStatus()); + + // 开启：显式走真实物化写入口 → ABILITY=OK 74.25 计入综合分 + setEnabled(true); + giveValidAbilityResult(me); + materialize(me); + Map> onSnaps = + new HashMap<>(rankingCalculator.loadLatestSnapshots(List.of(me), month)); + onSnaps.putAll(peerOnly); + CompetitionRankingCalculator.CohortRanking on = + rankingCalculator.rankCohort(cohort, onSnaps, me); + + assertEquals(new BigDecimal("74.25"), on.overallScore, "ON: (76.75→nothing else) ABILITY alone=74.25"); + assertEquals(1, on.rank, "me(74.25) > peer(70) → rank1"); + assertEquals(new BigDecimal("100.00"), on.percentile, "strictly-less(peer)=1 over scored-1 → 100"); + assertEquals("OK", on.meSnaps.stream() + .filter(s -> "ABILITY".equals(s.getDimension())).findFirst().get().getStatus()); + + assertNotEquals(on.overallScore, off.overallScore, "ABILITY 计入后综合分必须按既定公式变化"); + assertNotEquals(on.rank, off.rank); + assertNotEquals(on.percentile, off.percentile); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculatorTest.java new file mode 100644 index 0000000..3f2bbb1 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CandidatePercentileCalculatorTest.java @@ -0,0 +1,87 @@ +package com.mydreamjob.candidatescore.dashboard; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; + +class CandidatePercentileCalculatorTest { + + @Test + void emptySingleAndNullOnlySamplesRemainUndisclosed() { + assertEquals(List.of(), CandidatePercentileCalculator.calculate(List.of())); + assertEquals(list((BigDecimal) null), CandidatePercentileCalculator.calculate(list(decimal("80")))); + assertEquals(list(null, null), CandidatePercentileCalculator.calculate(list(null, null))); + } + + @Test + void preservesInputOrderAndNullPositions() { + assertEquals(list(decimal("100.00"), null, decimal("0.00"), decimal("50.00")), + CandidatePercentileCalculator.calculate( + list(decimal("90"), null, decimal("70"), decimal("80")))); + } + + @Test + void tiedScoresUseStrictlyLowerCount() { + assertEquals(list(decimal("0.00"), decimal("0.00"), decimal("100.00")), + CandidatePercentileCalculator.calculate( + list(decimal("80.0"), decimal("80.00"), decimal("90")))); + } + + @Test + void matchesHistoricalQuadraticFormulaAcrossGeneratedMatrix() { + List domain = list(null, decimal("0"), decimal("1.0"), decimal("1.00"), decimal("2.5")); + for (int size = 0; size <= 6; size++) { + compareEveryCombination(domain, new ArrayList<>(), size); + } + } + + @Test + void nullInputPreservesHistoricalFailFastBehavior() { + assertThrows(NullPointerException.class, () -> CandidatePercentileCalculator.calculate(null)); + } + + private void compareEveryCombination(List domain, List current, int targetSize) { + if (current.size() == targetSize) { + assertEquals(legacy(current), CandidatePercentileCalculator.calculate(current), current::toString); + return; + } + for (BigDecimal value : domain) { + current.add(value); + compareEveryCombination(domain, current, targetSize); + current.remove(current.size() - 1); + } + } + + private List legacy(List scores) { + List scored = scores.stream().filter(java.util.Objects::nonNull).toList(); + if (scored.size() < 2) return scores.stream().map(ignored -> (BigDecimal) null).toList(); + List result = new ArrayList<>(); + for (BigDecimal score : scores) { + if (score == null) { + result.add(null); + continue; + } + long lower = scored.stream().filter(candidate -> candidate.compareTo(score) < 0).count(); + result.add(BigDecimal.valueOf(lower) + .divide(BigDecimal.valueOf(scored.size() - 1L), 10, RoundingMode.HALF_UP) + .multiply(BigDecimal.valueOf(100)) + .setScale(2, RoundingMode.HALF_UP)); + } + return java.util.Collections.unmodifiableList(result); + } + + private BigDecimal decimal(String value) { + return new BigDecimal(value); + } + + @SafeVarargs + private final List list(T... values) { + return java.util.Arrays.asList(values); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardControllerTest.java index f589e34..d3b2481 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/dashboard/CompanyScoringDashboardControllerTest.java @@ -58,7 +58,7 @@ class CompanyScoringDashboardControllerTest { } private String token(long uid, String role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(uid, "1", Map.of("roles", role)); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(uid, role); } @Test void overview_company_should200_andMasked() throws Exception { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceControllerTest.java index 6b1d008..032d725 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceControllerTest.java @@ -50,7 +50,7 @@ class CandidateScoringGovernanceControllerTest { } private String token(long uid, String role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(uid, "1", Map.of("roles", role)); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(uid, role); } private AppealResponse buildAppeal(Long id, String status) { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceServiceTest.java index b2571eb..4b4c8b9 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/governance/CandidateScoringGovernanceServiceTest.java @@ -4,6 +4,8 @@ import com.mydreamjob.audit.AuditContext; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.candidatescore.CandidateDimensionScore; import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; import com.mydreamjob.candidatescore.CandidateScoringCalculator; @@ -28,11 +30,15 @@ import org.springframework.dao.OptimisticLockingFailureException; import org.springframework.test.util.ReflectionTestUtils; import java.math.BigDecimal; +import java.time.Clock; +import java.time.Instant; import java.time.LocalDateTime; +import java.time.ZoneId; import java.util.HashSet; import java.util.List; import java.util.Optional; import java.util.Set; +import java.util.concurrent.atomic.AtomicInteger; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.*; @@ -51,6 +57,9 @@ class CandidateScoringGovernanceServiceTest { @Mock private UserRepository userRepository; @Mock private AuditService auditService; @Mock private EntityManager entityManager; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private CandidateScoringGovernanceService service; private static final Long STUDENT_ID = 2L; @@ -60,6 +69,9 @@ class CandidateScoringGovernanceServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + ReflectionTestUtils.setField(service, "entityManager", entityManager); Query nativeQ = mock(Query.class); when(nativeQ.setParameter(anyInt(), any())).thenReturn(nativeQ); @@ -260,7 +272,7 @@ class CandidateScoringGovernanceServiceTest { .thenReturn(List.of(before), List.of(afterSnap)); // 第一次读回滚前、第二次读回滚后 CandidateScoringCalculator.DimensionResult after = new CandidateScoringCalculator.DimensionResult(appeal.getDimension()); after.score = new BigDecimal("80.00"); after.status = "OK"; - when(calculator.recomputeAndSnapshot(eq(STUDENT_ID), eq(appeal.getDimension()), eq(appeal.getPeriod()))).thenReturn(after); + when(calculator.recomputeAndSnapshot(eq(STUDENT_ID), eq(appeal.getDimension()), eq(appeal.getPeriod()), any(LocalDateTime.class))).thenReturn(after); } @Test void rollback_notApproved_should8606() { @@ -296,6 +308,42 @@ class CandidateScoringGovernanceServiceTest { verify(auditService).log(eq(ADMIN_ID), eq("APPEAL_ROLLBACK"), eq("CANDIDATE_SCORING_APPEAL"), any(), any(), any()); } + @Test void rollback_usesOneCapturedClockForRecomputeAndState() { + CandidateScoringAppeal a = appeal(1L, "APPROVED"); + stubRollbackData(a, 1); + LocalDateTime captured = LocalDateTime.of(2026, 9, 9, 12, 0); + AdvancingClock advancing = new AdvancingClock(captured, ZoneId.of("Asia/Shanghai")); + service.setClock(advancing); + + service.rollbackAppeal(ADMIN_ID, 1L, ctx); + + org.mockito.ArgumentCaptor recomputeTime = + org.mockito.ArgumentCaptor.forClass(LocalDateTime.class); + verify(calculator).recomputeAndSnapshot(eq(STUDENT_ID), eq("EDUCATION"), eq("2026-08"), + recomputeTime.capture()); + assertEquals(captured, recomputeTime.getValue()); + assertEquals(captured, a.getRollbackAt()); + assertEquals(2026, captured.getYear()); + assertEquals(1, advancing.instantCalls.get(), "rollback entry must capture time exactly once"); + } + + private static final class AdvancingClock extends Clock { + private final LocalDateTime first; + private final ZoneId zone; + private final AtomicInteger instantCalls = new AtomicInteger(); + + private AdvancingClock(LocalDateTime first, ZoneId zone) { + this.first = first; + this.zone = zone; + } + + @Override public ZoneId getZone() { return zone; } + @Override public Clock withZone(ZoneId zone) { return new AdvancingClock(first, zone); } + @Override public Instant instant() { + return first.plusMonths(instantCalls.getAndIncrement()).atZone(zone).toInstant(); + } + } + @Test void rollback_alreadyRolledBack_shouldIdempotent() { when(appealRepository.findById(1L)).thenReturn(Optional.of(appeal(1L, "ROLLED_BACK"))); AppealResponse resp = service.rollbackAppeal(ADMIN_ID, 1L, ctx); diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshBatchIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshBatchIsolationTest.java new file mode 100644 index 0000000..11da9df --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshBatchIsolationTest.java @@ -0,0 +1,156 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 次生缺陷：单个任务失败不得阻止同批后续任务。 + * + *

    缺陷背景：{@code recordFailure} 在更新 0 行时抛 IllegalStateException，异常点位于 + * Worker 的 catch 块内，而 {@code processDue} 的 for 循环没有保护 —— 单个任务的失败会 + * 让同批剩余任务本轮全部不被处理。

    + * + *

    本测试通过 mock 计算器精确制造"指定学生计算失败"，断言真实数据库中的批次终态。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateScoringRefreshBatchIsolationTest { + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + @MockBean private CandidateScoringCalculator calculator; + + private static final AtomicLong SEQ = new AtomicLong(11000); + + private Long okA; + private Long okB; + private Long failing; + + private String statusOf(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + private String errorCodeOf(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + private Long newStudent(String tag) { + User u = User.builder() + .phone("191" + String.format("%08d", SEQ.incrementAndGet())) + .nickname(tag).role(User.Role.STUDENT).active(true).verified(true).build(); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + return userRepository.save(u).getId(); + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + + okA = newStudent("隔离A"); + okB = newStudent("隔离B"); + failing = newStudent("失败C"); + + when(calculator.currentRulesVersion()).thenReturn("candidate-scoring-v0.1"); + when(calculator.computeAll(eq(okA), any(LocalDateTime.class))).thenReturn(List.of()); + when(calculator.computeAll(eq(okB), any(LocalDateTime.class))).thenReturn(List.of()); + // 计算失败：异常 message 故意夹带敏感形态内容，用于验证错误分类不落异常原文 + when(calculator.computeAll(eq(failing), any(LocalDateTime.class))) + .thenThrow(new BusinessException(ErrorCode.BAD_REQUEST, + "compute failed for phone=13800001111 token=eyJhbGciOiJIUzI1NiJ9.secret.sig")); + } + + @org.junit.jupiter.api.AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + } + + @Test + void firstTaskFails_secondTaskStillProcessed() { + requestService.requestRefresh(failing, LocalDateTime.now()); + requestService.requestRefresh(okA, LocalDateTime.now()); + + int processed = worker.processDue(10); + + assertEquals("RETRY", statusOf(failing), "失败任务应进入 RETRY"); + assertEquals("COMPLETED", statusOf(okA), + "同批后续任务必须仍然被处理（单任务失败不得阻断批次）"); + assertEquals(1, processed, "成功计数只统计被处理的任务"); + } + + @Test + void failingTaskInMiddle_doesNotBlockRemainingTasks() { + requestService.requestRefresh(okA, LocalDateTime.now()); + requestService.requestRefresh(failing, LocalDateTime.now()); + requestService.requestRefresh(okB, LocalDateTime.now()); + + worker.processDue(10); + + assertEquals("COMPLETED", statusOf(okA), "失败项之前的任务应完成"); + assertEquals("COMPLETED", statusOf(okB), "失败项之后的任务也必须完成"); + assertEquals("RETRY", statusOf(failing)); + } + + @Test + void lastErrorCode_neverLeaksExceptionMessage() { + requestService.requestRefresh(failing, LocalDateTime.now()); + + worker.processDue(10); + + String code = errorCodeOf(failing); + assertNotNull(code); + assertEquals("COMPUTE_FAILED", code, "只允许固定错误分类"); + assertFalse(code.contains("13800001111"), "错误分类不得包含手机号"); + assertFalse(code.contains("eyJ"), "错误分类不得包含 Token"); + assertFalse(code.contains("compute failed"), "错误分类不得包含异常原文"); + assertTrue(code.length() <= 40, "错误分类长度受列定义约束"); + } + + @Test + void batchTerminalState_matchesRealOutcome() { + requestService.requestRefresh(okA, LocalDateTime.now()); + requestService.requestRefresh(failing, LocalDateTime.now()); + requestService.requestRefresh(okB, LocalDateTime.now()); + + worker.processDue(10); + + List statuses = jdbcTemplate.queryForList( + "SELECT status FROM candidate_scoring_refresh_tasks ORDER BY student_user_id", String.class); + assertFalse(statuses.contains("PROCESSING"), "批次结束后不得残留 PROCESSING"); + assertEquals(2, statuses.stream().filter("COMPLETED"::equals).count(), "两个成功项"); + assertEquals(1, statuses.stream().filter("RETRY"::equals).count(), "一个重试项"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimFenceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimFenceTest.java new file mode 100644 index 0000000..d92342b --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimFenceTest.java @@ -0,0 +1,232 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 次生缺陷：Worker 领取所有权（claim fence）与 stale claim 处置。 + * + *

    缺陷背景：{@code materialize} 的「回到 PENDING」回退分支只校验 + * {@code status='PROCESSING'} 而不校验领取所有权；当原 Worker 因租约超时已被重新领取时， + * 慢返回的旧 Worker 会把新 Worker 正在处理的任务改回 PENDING。同时 + * {@code recordFailure} 在更新 0 行时抛 IllegalStateException，异常点位于 Worker 的 + * catch 块内、{@code processDue} 的 for 循环无保护 → 同批剩余任务本轮全部不处理。

    + * + *

    本测试断言真实数据库状态，不使用 sleep，不使用 JVM 锁。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateScoringRefreshClaimFenceTest { + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshTaskExecutor taskExecutor; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private static final AtomicLong SEQ = new AtomicLong(9000); + + private Long sid; + private String period; + + private String status(Long taskId) { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId); + } + + private LocalDateTime processingStartedAt(Long taskId) { + return jdbcTemplate.queryForObject( + "SELECT processing_started_at FROM candidate_scoring_refresh_tasks WHERE id=?", + LocalDateTime.class, taskId); + } + + private Long newTask() { + requestService.requestRefresh(sid, LocalDateTime.now()); + return jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + + User u = User.builder() + .phone("193" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("Fence学生").role(User.Role.STUDENT).active(true).verified(true).build(); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + sid = userRepository.save(u).getId(); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + // 与 CandidateScoringRefreshRequestService 保持一致：period = capturedNow 所在 yyyy-MM + LocalDateTime n = LocalDateTime.now(); + period = String.format("%04d-%02d", n.getYear(), n.getMonthValue()); + } + + /** 清理本类产生的行，避免污染同一 JVM 内共享的 H2 内存库。 */ + @org.junit.jupiter.api.AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id=?", sid); + } + + // ── claim fence ──────────────────────────────────────────── + + @Test + void claim_exposesProcessingStartedAtAsOwnershipFence() { + Long taskId = newTask(); + LocalDateTime t1 = LocalDateTime.now().withNano(0); + CandidateScoringRefreshTaskExecutor.ClaimedTask claimed = taskExecutor.claim(taskId, t1); + + assertNotNull(claimed, "首次 claim 应成功"); + assertEquals("PROCESSING", status(taskId)); + assertEquals(t1, processingStartedAt(taskId), "claim 必须记录所有权标识"); + assertNotNull(claimed, "ClaimedTask 必须携带领取信息"); + } + + @Test + void staleWorkerCompletion_cannotOverwriteNewWorkerClaim() { + Long taskId = newTask(); + LocalDateTime t1 = LocalDateTime.now().withNano(0).minusMinutes(20); + CandidateScoringRefreshTaskExecutor.ClaimedTask oldClaim = taskExecutor.claim(taskId, t1); + assertNotNull(oldClaim); + + // 模拟租约超时回收 + 另一个 Worker 重新领取 + taskExecutor.recoverStale(LocalDateTime.now(), LocalDateTime.now(), 3); + LocalDateTime t2 = LocalDateTime.now().withNano(0); + CandidateScoringRefreshTaskExecutor.ClaimedTask newClaim = taskExecutor.claim(taskId, t2); + assertNotNull(newClaim, "回收后应可被重新领取"); + assertEquals("PROCESSING", status(taskId)); + assertEquals(t2, processingStartedAt(taskId)); + + // 旧 Worker 迟到完成：必须更新 0 行并安静退出，不得改动新 Worker 的 PROCESSING + assertDoesNotThrow(() -> taskExecutor.materialize(oldClaim, LocalDateTime.now()), + "stale claim 的完成路径必须安静退出而不是抛异常"); + + assertEquals("PROCESSING", status(taskId), "旧 Worker 不得覆盖新 Worker 的领取状态"); + assertEquals(t2, processingStartedAt(taskId), "旧 Worker 不得改动所有权标识"); + + // 新 Worker 正常完成 + taskExecutor.materialize(newClaim, LocalDateTime.now()); + assertEquals("COMPLETED", status(taskId), "持有者应能正常完成"); + } + + @Test + void staleWorkerFailure_cannotOverwriteNewWorkerClaim() { + Long taskId = newTask(); + LocalDateTime t1 = LocalDateTime.now().withNano(0).minusMinutes(20); + CandidateScoringRefreshTaskExecutor.ClaimedTask oldClaim = taskExecutor.claim(taskId, t1); + assertNotNull(oldClaim); + + taskExecutor.recoverStale(LocalDateTime.now(), LocalDateTime.now(), 3); + LocalDateTime t2 = LocalDateTime.now().withNano(0); + taskExecutor.claim(taskId, t2); + + // 旧 Worker 迟到失败登记（携带旧的所有权令牌）：必须安静退出 + assertDoesNotThrow(() -> taskExecutor.recordFailure(taskId, "WRITE_FAILED", + LocalDateTime.now(), 3, 1000L, oldClaim.claimToken()), + "stale claim 的失败登记必须安静退出而不是抛异常"); + assertEquals("PROCESSING", status(taskId), "旧 Worker 的失败登记不得覆盖新 Worker"); + } + + @Test + void requestDuringSameClaim_completionFallsBackToPending() { + Long taskId = newTask(); + LocalDateTime t1 = LocalDateTime.now().withNano(0); + CandidateScoringRefreshTaskExecutor.ClaimedTask claimed = taskExecutor.claim(taskId, t1); + assertNotNull(claimed); + + // 同一次领取期间到达新请求 → version 推进，但所有权标识不变 + requestService.requestRefresh(sid, t1.plusNanos(1)); + assertEquals("PROCESSING", status(taskId), "处理期间新请求不得改变 PROCESSING"); + assertEquals(t1, processingStartedAt(taskId), "处理期间新请求不得改变所有权标识"); + + taskExecutor.materialize(claimed, LocalDateTime.now()); + + assertEquals("PENDING", status(taskId), + "同一 claim 期间收到新请求时，完成路径必须回到 PENDING 而不是 COMPLETED"); + } + + // ── 单任务失败隔离 ───────────────────────────────────────── + + @Test + void processDue_skipsTasksAlreadyClaimedByAnotherWorker_andProcessesTheRest() { + Long taskA = newTask(); + Long taskB = newTaskFor(newStudent("隔离B")); + Long taskC = newTaskFor(newStudent("隔离C")); + + // 模拟 taskA 已被另一个 Worker 持有 + assertNotNull(taskExecutor.claim(taskA, LocalDateTime.now().withNano(0))); + + int processed = worker.processDue(10); + + assertEquals(2, processed, "被并发持有的任务应被跳过，其余任务仍被处理"); + assertEquals("COMPLETED", status(taskB), "同批第二个任务应被处理"); + assertEquals("COMPLETED", status(taskC), "同批第三个任务应被处理"); + } + + @Test + void processDue_batchEndsConsistently_evenWithStaleClaimsPresent() { + Long a = newTask(); + + int processed = worker.processDue(10); + + assertTrue(processed >= 0); + List all = jdbcTemplate.queryForList( + "SELECT status FROM candidate_scoring_refresh_tasks", String.class); + assertFalse(all.contains("PROCESSING"), "批次结束后不得残留 PROCESSING"); + assertEquals("COMPLETED", status(a)); + } + + private Long newStudent(String tag) { + User u = User.builder() + .phone("192" + String.format("%08d", SEQ.incrementAndGet())) + .nickname(tag).role(User.Role.STUDENT).active(true).verified(true).build(); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + return userRepository.save(u).getId(); + } + + private Long newTaskFor(Long studentId) { + requestService.requestRefresh(studentId, LocalDateTime.now()); + return jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, studentId); + } + + /** R01-C 阶段二：本类会以**当前 period** 物化快照。残留行会进入同库中其它测试 + * 对"当前期间"的总体统计（如 Fairness 的 populationSize），造成顺序相关误失败。 + * 此处按本类**独占手机号前缀**解析出精确 id，再按外键顺序删除；不使用 deleteAll。 */ + @AfterEach + void cleanupOwnFixture() { + for (String prefix : java.util.List.of("193", "192")) { + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE phone LIKE ?", Long.class, prefix + "%")) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimTokenTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimTokenTest.java new file mode 100644 index 0000000..391460a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshClaimTokenTest.java @@ -0,0 +1,428 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 claim fence 定向整改：不可复用 claim token。 + * + *

    缺陷背景：旧实现以 {@code processing_started_at} 作为所有权标识，而该列是秒级 + * {@code DATETIME}。当租约回收与重新领取落在同一秒时，新旧 claim 的 fence 完全相同， + * 旧 Worker 的 PENDING 回退会误改新持有者（已由 {@code iv-fence2.sql} 在真实 MySQL 复现）。

    + * + *

    本测试使用固定时间值（两次领取传入完全相同的 {@code LocalDateTime}）， + * 不依赖跨秒等待。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateScoringRefreshClaimTokenTest { + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshTaskExecutor taskExecutor; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private static final AtomicLong SEQ = new AtomicLong(13000); + + /** 两次领取刻意使用同一个时间值。 */ + private static final LocalDateTime SAME_INSTANT = LocalDateTime.of(2026, 9, 16, 12, 0, 0); + + private Long sid; + private String period; + + private String status(Long taskId) { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId); + } + + private String claimToken(Long taskId) { + return jdbcTemplate.queryForObject( + "SELECT claim_token FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId); + } + + private int attempts(Long taskId) { + Integer v = jdbcTemplate.queryForObject( + "SELECT attempts FROM candidate_scoring_refresh_tasks WHERE id=?", Integer.class, taskId); + return v == null ? -1 : v; + } + + private LocalDateTime processingStartedAt(Long taskId) { + return jdbcTemplate.queryForObject( + "SELECT processing_started_at FROM candidate_scoring_refresh_tasks WHERE id=?", + LocalDateTime.class, taskId); + } + + private Long newTask() { + requestService.requestRefresh(sid, LocalDateTime.now()); + return jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + } + + /** 模拟租约回收（把 PROCESSING 置为 RETRY，processing_started_at 清空）。 */ + private void recover(Long taskId) { + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET status='RETRY', " + + "processing_started_at=NULL, attempts=attempts+1, version=version+1 WHERE id=?", taskId); + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + + User u = User.builder() + .phone("190" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("Token学生").role(User.Role.STUDENT).active(true).verified(true).build(); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + sid = userRepository.save(u).getId(); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + LocalDateTime n = LocalDateTime.now(); + period = String.format("%04d-%02d", n.getYear(), n.getMonthValue()); + } + + @AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id=?", sid); + } + + // ── 缺陷复现：同一时间值下两次领取，旧 Worker 不得影响新持有者 ── + + @Test + void sameTimestamp_staleWorkerPendingRevert_mustNotTouchNewClaim() { + Long taskId = newTask(); + + // Worker A 领取 + CandidateScoringRefreshTaskExecutor.ClaimedTask a = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(a, "A 应领取成功"); + assertEquals(SAME_INSTANT, processingStartedAt(taskId)); + + // 租约回收 → Worker B 在**完全相同的时间值**下重新领取 + recover(taskId); + CandidateScoringRefreshTaskExecutor.ClaimedTask b = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(b, "B 应领取成功"); + assertEquals(SAME_INSTANT, processingStartedAt(taskId), + "两次领取的 processing_started_at 完全相同（当前实现的固有精度）"); + assertEquals("PROCESSING", status(taskId)); + + // A 迟到：完成尝试（version 已变 → 应 0 行） + taskExecutor.materialize(a, SAME_INSTANT); + assertEquals("PROCESSING", status(taskId), + "A 的完成路径不得把 B 的 PROCESSING 改成其它状态"); + + // 再补一次 B 的重领取，确保状态干净（A 的 PENDING 回退是本次的核心缺陷点） + if (!"PROCESSING".equals(status(taskId))) { + recover(taskId); + b = taskExecutor.claim(taskId, SAME_INSTANT); + } + assertNotNull(b); + assertEquals("PROCESSING", status(taskId)); + + // B 正常完成 + taskExecutor.materialize(b, SAME_INSTANT); + assertEquals("COMPLETED", status(taskId), "B 应能正常完成"); + } + + @Test + void sameTimestamp_staleWorkerFailure_mustNotTouchNewClaim() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask a = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(a); + recover(taskId); + CandidateScoringRefreshTaskExecutor.ClaimedTask b = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(b); + assertEquals("PROCESSING", status(taskId)); + + // 记录失败登记前的基线（recover() 辅助方法自身会递增 attempts，故用差值判断） + int attemptsBefore = attempts(taskId); + String tokenBefore = claimToken(taskId); + + taskExecutor.recordFailure(taskId, "WRITE_FAILED", SAME_INSTANT, 3, 1000L, a.claimToken()); + + assertEquals("PROCESSING", status(taskId), "A 的失败登记不得覆盖 B 的 PROCESSING"); + assertEquals(attemptsBefore, attempts(taskId), "A 的失败登记不得改动 B 的 attempts"); + assertNull(jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId), + "A 的失败登记不得写入 last_error_code"); + assertEquals(tokenBefore, claimToken(taskId), "A 的失败登记不得清空 B 的 claim token"); + } + + // ── claim token 语义 ────────────────────────────────────── + + @Test + void twoClaimsAtSameInstant_getDifferentTokens() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask a = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(a); + String ta = claimToken(taskId); + assertNotNull(ta, "领取后必须写入 claim_token"); + + recover(taskId); + CandidateScoringRefreshTaskExecutor.ClaimedTask b = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(b); + String tb = claimToken(taskId); + + assertEquals(SAME_INSTANT, processingStartedAt(taskId), "时间值相同"); + assertNotEquals(ta, tb, "同一时间值下两次领取必须得到不同 claim token"); + } + + @Test + void claim_repeatedOnDifferentTasks_producesDistinctTokens() { + Long t1 = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c1 = taskExecutor.claim(t1, SAME_INSTANT); + assertNotNull(c1); + String token1 = claimToken(t1); + + Long sid2 = newStudent(); + requestService.requestRefresh(sid2, LocalDateTime.now()); + Long t2 = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid2); + CandidateScoringRefreshTaskExecutor.ClaimedTask c2 = taskExecutor.claim(t2, SAME_INSTANT); + assertNotNull(c2); + String token2 = claimToken(t2); + + assertNotEquals(token1, token2, "不同任务的 token 必须不同"); + } + + @Test + void currentHolder_canCompleteNormally() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + taskExecutor.materialize(c, SAME_INSTANT); + assertEquals("COMPLETED", status(taskId)); + } + + @Test + void requestDuringSameClaim_versionAdvances_completionFallsBackToPending() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + + requestService.requestRefresh(sid, SAME_INSTANT.plusNanos(1)); + assertEquals("PROCESSING", status(taskId)); + + taskExecutor.materialize(c, SAME_INSTANT); + assertEquals("PENDING", status(taskId), + "同一 claim 期间新请求推进 version → 必须回到 PENDING 而不是 COMPLETED"); + } + + @Test + void staleRecovery_generatesNewTokenOnNextClaim() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask a = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(a); + String ta = claimToken(taskId); + + taskExecutor.recoverStale(LocalDateTime.now(), LocalDateTime.now(), 3); + assertEquals("RETRY", status(taskId)); + assertNull(claimToken(taskId), "回收后应清空 claim_token"); + + CandidateScoringRefreshTaskExecutor.ClaimedTask b = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(b); + assertNotEquals(ta, claimToken(taskId), "stale recovery 后的新领取必须生成新 token"); + } + + @Test + void terminalAndPendingStates_clearClaimToken() { + // COMPLETED + Long t1 = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c1 = taskExecutor.claim(t1, SAME_INSTANT); + assertNotNull(c1); + taskExecutor.materialize(c1, SAME_INSTANT); + assertEquals("COMPLETED", status(t1)); + assertNull(claimToken(t1), "COMPLETED 必须清空 claim_token"); + + // PENDING 回退 + Long sid2 = newStudent(); + requestService.requestRefresh(sid2, LocalDateTime.now()); + Long t2 = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid2); + CandidateScoringRefreshTaskExecutor.ClaimedTask c2 = taskExecutor.claim(t2, SAME_INSTANT); + assertNotNull(c2); + requestService.requestRefresh(sid2, SAME_INSTANT.plusNanos(1)); + taskExecutor.materialize(c2, SAME_INSTANT); + assertEquals("PENDING", status(t2)); + assertNull(claimToken(t2), "PENDING 回退必须清空 claim_token"); + + // RETRY + Long sid3 = newStudent(); + requestService.requestRefresh(sid3, LocalDateTime.now()); + Long t3 = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid3); + CandidateScoringRefreshTaskExecutor.ClaimedTask c3 = taskExecutor.claim(t3, SAME_INSTANT); + assertNotNull(c3); + taskExecutor.recordFailure(t3, "WRITE_FAILED", SAME_INSTANT, 3, 1000L, c3.claimToken()); + assertEquals("RETRY", status(t3)); + assertNull(claimToken(t3), "RETRY 必须清空 claim_token"); + } + + @Test + void failedTerminalState_clearsClaimToken() { + Long taskId = newTask(); + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET attempts=2 WHERE id=?", taskId); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + // maxAttempts=3，attempts=2 → attempts+1 >= 3 → FAILED + taskExecutor.recordFailure(taskId, "COMPUTE_FAILED", SAME_INSTANT, 3, 1000L, c.claimToken()); + assertEquals("FAILED", status(taskId)); + assertNull(claimToken(taskId), "FAILED 必须清空 claim_token"); + } + + @Test + void tokenIsUuidShaped_andNotDerivedFromIds() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + String token = claimToken(taskId); + assertNotNull(token); + assertEquals(36, token.length(), "token 应为固定长度 UUID 字符串"); + assertTrue(token.matches("[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-" + + "[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"), + "token 必须为 UUID 形态，实际: " + token); + // token 必须是随机 UUID：不得等于/以任务或学生 ID 起头，也不得其字符串形式 + assertNotEquals(String.valueOf(taskId), token); + assertNotEquals(String.valueOf(sid), token); + assertFalse(token.startsWith(String.valueOf(taskId)), "token 不得由任务 ID 派生"); + assertTrue(token.matches(".*[0-9a-f]{8}-.*"), "token 必须是随机 UUID 形态而非 ID 拼接"); + // 再领一次必须得到不同 token（不可复用）—— 用独立学生，避免 (student,period) 合并 + Long otherStudent = newStudent(); + requestService.requestRefresh(otherStudent, LocalDateTime.now()); + Long t2 = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, otherStudent); + CandidateScoringRefreshTaskExecutor.ClaimedTask c2 = taskExecutor.claim(t2, SAME_INSTANT); + assertNotNull(c2, "独立任务应可领取"); + assertNotEquals(token, claimToken(t2), "token 必须不可复用"); + } + + // ── 双 Worker 长时间循环 ────────────────────────────────── + + @Test + void doubleWorkerLoop_100Rounds_noOverwrite_noStuckProcessing_noLostRequest() { + final int rounds = 100; + for (int i = 0; i < rounds; i++) { + Long taskId = newTask(); + + // A 领取 + CandidateScoringRefreshTaskExecutor.ClaimedTask a = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(a, "round " + i + ": A 领取失败"); + + // 租约回收 → B 在**同一时间值**下重新领取（fence 时间完全相同） + recover(taskId); + CandidateScoringRefreshTaskExecutor.ClaimedTask b = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(b, "round " + i + ": B 领取失败"); + assertEquals(SAME_INSTANT, processingStartedAt(taskId), "round " + i); + + // A 的三种迟到写：完成 / 失败 / （完成路径内含的 PENDING 回退） + taskExecutor.materialize(a, SAME_INSTANT); + taskExecutor.recordFailure(taskId, "WRITE_FAILED", SAME_INSTANT, 3, 1000L, a.claimToken()); + taskExecutor.materialize(a, SAME_INSTANT); + + assertEquals("PROCESSING", status(taskId), + "round " + i + ": 旧 Worker A 覆盖了新持有者 B"); + assertEquals(b.claimToken(), claimToken(taskId), + "round " + i + ": A 改动了 B 的 claim token"); + + // B 正常完成 + taskExecutor.materialize(b, SAME_INSTANT); + assertEquals("COMPLETED", status(taskId), "round " + i + ": B 未能完成"); + assertNull(claimToken(taskId), "round " + i + ": COMPLETED 未清空 token"); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks WHERE id=?", taskId); + } + long stuck = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks WHERE status='PROCESSING'", + Long.class); + assertEquals(0L, stuck, "循环结束后不得残留 PROCESSING"); + assertEquals(rounds, 100); + } + + // ── token 不泄露 ───────────────────────────────────────── + + @Test + void claimToken_doesNotLeakIntoAuditOrNotificationTables() { + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + String token = c.claimToken(); + assertNotNull(token); + + for (String table : List.of("audit_logs", "notifications", "messages")) { + Long hits = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM " + table + " WHERE CAST(" + + ("messages".equals(table) ? "content" : "audit_logs".equals(table) ? "details" : "content") + + " AS VARCHAR) LIKE ?", Long.class, "%" + token + "%"); + assertEquals(0L, hits, table + " 不得出现 claim token"); + } + // 错误分类为固定枚举，不含 token + taskExecutor.recordFailure(taskId, "WRITE_FAILED", SAME_INSTANT, 3, 1000L, "stale-token-value"); + String code = jdbcTemplate.queryForObject( + "SELECT COALESCE(last_error_code,'') FROM candidate_scoring_refresh_tasks WHERE id=?", + String.class, taskId); + assertFalse(code.contains("stale-token-value"), "错误分类不得包含 token"); + assertTrue(List.of("COMPUTE_FAILED", "WRITE_FAILED", "UNKNOWN_REFRESH_FAILURE", "WORKER_TIMEOUT", "") + .contains(code), + "错误分类必须为固定枚举，实际: " + code); + } + + @Test + void claimToken_rowNeverExposedInTaskStatusQueriesUsedByObservability() { + // 任务表本身持有 token 属预期；此处确认 token 不会被写入其它可观测载体 + Long taskId = newTask(); + CandidateScoringRefreshTaskExecutor.ClaimedTask c = taskExecutor.claim(taskId, SAME_INSTANT); + assertNotNull(c); + String token = c.claimToken(); + Long inScores = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_dimension_scores WHERE CAST(sub_scores_json AS VARCHAR) LIKE ?", + Long.class, "%" + token + "%"); + assertEquals(0L, inScores, "快照 JSON 不得出现 claim token"); + } + + private Long newStudent() { + User u = User.builder() + .phone("189" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("Token学生x").role(User.Role.STUDENT).active(true).verified(true).build(); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + return userRepository.save(u).getId(); + } + + /** R01-C 阶段二：本类会以**当前 period** 物化快照。残留行会进入同库中其它测试 + * 对"当前期间"的总体统计（如 Fairness 的 populationSize），造成顺序相关误失败。 + * 此处按本类**独占手机号前缀**解析出精确 id，再按外键顺序删除；不使用 deleteAll。 */ + @AfterEach + void cleanupOwnFixture() { + for (String prefix : java.util.List.of("190", "189")) { + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE phone LIKE ?", Long.class, prefix + "%")) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshFailureTransactionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshFailureTransactionTest.java new file mode 100644 index 0000000..4a2020f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshFailureTransactionTest.java @@ -0,0 +1,144 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.support.TransactionTemplate; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.when; + +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateScoringRefreshFailureTransactionTest { + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository snapshotRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private PlatformTransactionManager transactionManager; + @MockBean private CandidateScoringCalculator calculator; + @MockBean private RedisTemplate redisTemplate; + + private Long failingStudent; + private Long successfulStudent; + + @BeforeEach + void setUp() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + failingStudent = student("failure-tx-1"); + successfulStudent = student("failure-tx-2"); + when(calculator.currentRulesVersion()).thenReturn("candidate-scoring-v0.1"); + when(calculator.computeAll(any(), any())).thenAnswer(invocation -> { + Long studentId = invocation.getArgument(0); + return results(studentId.equals(failingStudent)); + }); + } + + @Test + void databaseWriteFailureRollsBackAllDimensionsAndPersistsRetry() { + requestService.requestRefresh(failingStudent, LocalDateTime.now()); + + assertEquals(0, worker.processDue(10)); + + assertTrue(snapshotRepository.findByStudentUserId(failingStudent).isEmpty(), + "第4维写失败时前三维也必须回滚"); + assertEquals("RETRY", status(failingStudent)); + assertEquals("WRITE_FAILED", error(failingStudent)); + } + + @Test + void oneFailedTaskDoesNotRollbackSuccessfulSibling() { + requestService.requestRefresh(failingStudent, LocalDateTime.now()); + requestService.requestRefresh(successfulStudent, LocalDateTime.now()); + + assertEquals(1, worker.processDue(10)); + + assertEquals("RETRY", status(failingStudent)); + assertEquals("COMPLETED", status(successfulStudent)); + assertEquals(8, snapshotRepository.findByStudentUserId(successfulStudent).size()); + } + + @Test + void outerBusinessRollbackRemovesRefreshRegistration() { + TransactionTemplate transaction = new TransactionTemplate(transactionManager); + transaction.executeWithoutResult(status -> { + requestService.requestRefresh(successfulStudent, LocalDateTime.now()); + status.setRollbackOnly(); + }); + Long count = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, successfulStudent); + assertEquals(0L, count); + } + + private Long student(String nickname) { + String phone = "130" + String.format("%08d", Math.abs(System.nanoTime() % 100_000_000L)); + User user = User.builder().phone(phone).nickname(nickname).role(User.Role.STUDENT) + .active(true).verified(true).build(); + user.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + return userRepository.saveAndFlush(user).getId(); + } + + private List results(boolean failAtFourth) { + String[] dimensions = {"EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"}; + List results = new ArrayList<>(); + for (int i = 0; i < 8; i++) { + CandidateScoringCalculator.DimensionResult result = + new CandidateScoringCalculator.DimensionResult(failAtFourth && i == 3 ? null : dimensions[i]); + result.score = BigDecimal.valueOf(50 + i); + result.status = "OK"; + results.add(result); + } + return results; + } + + private String status(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + private String error(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + /** R01-C 阶段二：本类会以**当前 period** 物化快照。残留行会进入同库中其它测试 + * 对"当前期间"的总体统计（如 Fairness 的 populationSize），造成顺序相关误失败。 + * 此处按本类**独占手机号前缀**解析出精确 id，再按外键顺序删除；不使用 deleteAll。 */ + @AfterEach + void cleanupOwnFixture() { + for (String prefix : java.util.List.of("130")) { + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE phone LIKE ?", Long.class, prefix + "%")) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshInfrastructureTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshInfrastructureTest.java new file mode 100644 index 0000000..4c073ac --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshInfrastructureTest.java @@ -0,0 +1,405 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScore; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-1 基础设施与写侧接入综合测试（H2 集成）。 + * 覆盖任务登记合并、PROCESSING 防丢失、并发领取、Worker 原子完成、 + * Writer 幂等 version 语义、写侧登记范围与不接入项、GET 零副作用保持。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateScoringRefreshInfrastructureTest { + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private CandidateScoringRefreshTaskExecutor taskExecutor; + @Autowired private CandidateScoringSnapshotWriter writer; + @Autowired private CandidateScoringRefreshCompensationScanner compensationScanner; + @Autowired private CandidateScoringCalculator calculator; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository snapshotRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private Long sid; + private String period; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + User u = User.builder().phone("132" + String.format("%08d", System.nanoTime() % 100_000_000L)) + .nickname("r01d41").role(User.Role.STUDENT) + .active(true).verified(true).build(); + u.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + sid = userRepository.save(u).getId(); + LocalDate d = LocalDate.now(); + period = String.format("%04d-%02d", d.getYear(), d.getMonthValue()); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_scan_checkpoints"); + } + + private long taskCount() { + Long c = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM candidate_scoring_refresh_tasks", Long.class); + return c == null ? -1 : c; + } + + private String taskStatus() { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE student_user_id=? AND target_period=?", + String.class, sid, period); + } + + private LocalDateTime now() { + return LocalDateTime.now(); + } + + // 1. 重复登记只保留一条任务 + @Test + void duplicateRefreshRequestCreatesOneTask() { + requestService.requestRefresh(sid, now()); + LocalDateTime t1 = jdbcTemplate.queryForObject( + "SELECT requested_at FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", LocalDateTime.class, sid); + requestService.requestRefresh(sid, now()); + assertEquals(1, taskCount(), "同学生同周期重复登记只保留一条任务"); + LocalDateTime t2 = jdbcTemplate.queryForObject( + "SELECT requested_at FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", LocalDateTime.class, sid); + assertFalse(t2.isBefore(t1), "重复登记应更新 requested_at 而非新增"); + } + + // 2. COMPLETED 任务再次登记 → 回到 PENDING 且 attempts 归零 + @Test + void completedTaskCanBeRequestedAgain() { + requestService.requestRefresh(sid, now()); + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET status='COMPLETED', attempts=5 WHERE student_user_id=?", + sid); + requestService.requestRefresh(sid, now()); + assertEquals("PENDING", taskStatus()); + Integer attempts = jdbcTemplate.queryForObject( + "SELECT attempts FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Integer.class, sid); + assertEquals(0, attempts, "重新登记后 attempts 应归零"); + } + + // 3. PROCESSING 期间新请求不丢失：状态保持 PROCESSING、requested_at 持续推进；完成后可处理 + @Test + void requestDuringProcessingIsNotLost() { + requestService.requestRefresh(sid, now()); + LocalDateTime pst = now().minusSeconds(5); + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET status='PROCESSING', processing_started_at=?, " + + "requested_at=? WHERE student_user_id=?", pst, pst, sid); + // 处理期间产生新请求（requested_at 更新，status 保持不变，任务仍唯一） + requestService.requestRefresh(sid, now()); + assertEquals("PROCESSING", taskStatus(), "处理期间新请求不得覆盖 PROCESSING 状态"); + assertEquals(1, taskCount(), "处理期间新请求不得新增任务行"); + // 完成语义：若 requested_at 晚于 processing_started_at，Worker 完成时回退 PENDING（数据可验证） + LocalDateTime req2 = jdbcTemplate.queryForObject( + "SELECT requested_at FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", LocalDateTime.class, sid); + assertTrue(req2.isAfter(pst), "处理期间新请求必须推进 requested_at（不丢失）"); + // 使用真实完成路径：领取版本早于处理期间的新请求，完成时必须回到 PENDING。 + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET status='PENDING', processing_started_at=NULL " + + "WHERE student_user_id=?", sid); + Long taskId = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + LocalDateTime claimedAt = now(); + CandidateScoringRefreshTaskExecutor.ClaimedTask claimed = taskExecutor.claim(taskId, claimedAt); + assertNotNull(claimed); + requestService.requestRefresh(sid, claimedAt.plusNanos(1)); + taskExecutor.materialize(claimed, claimedAt); + assertEquals("PENDING", taskStatus(), "处理期间的新请求必须让真实完成路径回到 PENDING"); + } + + // 4. 两个并发 Worker 只能有效处理一次（数据库条件领取） + @Test + void twoWorkersCannotProcessSameTaskTwice() throws Exception { + requestService.requestRefresh(sid, now()); + List ids = jdbcTemplate.queryForList( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + Long taskId = ids.get(0); + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch ready = new CountDownLatch(2); + CountDownLatch start = new CountDownLatch(1); + List> futures = java.util.stream.IntStream.range(0, 2).>mapToObj(i -> + pool.submit(() -> { + ready.countDown(); + start.await(5, TimeUnit.SECONDS); + return worker.processOne(taskId, now()); + })).toList(); + assertTrue(ready.await(5, TimeUnit.SECONDS)); + start.countDown(); + boolean r1 = futures.get(0).get(30, TimeUnit.SECONDS); + boolean r2 = futures.get(1).get(30, TimeUnit.SECONDS); + pool.shutdownNow(); + assertEquals(1, (r1 ? 1 : 0) + (r2 ? 1 : 0), "同一任务并发只能有一个 Worker 有效处理"); + List snaps = snapshotRepository.findByStudentUserIdAndPeriod(sid, period); + assertTrue(snaps.size() == 8, "并发处理恰一次物化（8 维）"); + } + + // 6/9. 相同计算值重复 Writer 写入不增 version；Worker 重放同结果不增 + @Test + void sameCalculatedValuesDoNotIncrementSnapshotVersion() { + List results = + calculator.computeAll(sid, now()); + writer.upsertIfChanged(sid, results, period, now(), calculator.currentRulesVersion()); + List r1 = snapshotRepository.findByStudentUserIdAndPeriod(sid, period); + assertEquals(8, r1.size()); + writer.upsertIfChanged(sid, results, period, now(), calculator.currentRulesVersion()); + List r2 = snapshotRepository.findByStudentUserIdAndPeriod(sid, period); + for (int i = 0; i < r1.size(); i++) { + assertEquals(r1.get(i).getVersion(), r2.get(i).getVersion(), "值不变不得推进 version: " + r1.get(i).getDimension()); + } + } + + // 8. rulesVersion 变化强制递增 + @Test + void rulesVersionChangeIncrementsVersion() { + List results = calculator.computeAll(sid, now()); + writer.upsertIfChanged(sid, results, period, now(), "candidate-scoring-v0.1"); + writer.upsertIfChanged(sid, results, period, now(), "candidate-scoring-v0.2"); + List rows = snapshotRepository.findByStudentUserIdAndPeriod(sid, period); + assertTrue(rows.stream().allMatch(s -> s.getVersion() == 1L), "rulesVersion 变化应强制 version+1"); + } + + // 21. 任务错误分类为固定值且不含异常原文/SQL/手机号/堆栈 + @Test + void taskErrorCategoryIsFixedAndSafe() { + requestService.requestRefresh(sid, now()); + Long taskId = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + CandidateScoringRefreshTaskExecutor.ClaimedTask claimed = taskExecutor.claim(taskId, now()); + assertNotNull(claimed); + taskExecutor.recordFailure(taskId, "UNKNOWN_REFRESH_FAILURE", now(), 3, 1000L, claimed.claimToken()); + String code = jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId); + assertTrue(Set.of("COMPUTE_FAILED", "WRITE_FAILED", "UNKNOWN_REFRESH_FAILURE", "WORKER_TIMEOUT").contains(code), + "错误分类必须为固定值，实际: " + code); + assertFalse(code.contains("Exception") || code.contains(" at com.mydreamjob"), + "错误分类不得含异常原文/堆栈"); + } + + // 22. Worker 不发布 RabbitMQ/Notification（快照仅有 8 维行，无 notifications 行） + @Test + void workerDoesNotPublishRabbitMqOrNotification() { + requestService.requestRefresh(sid, now()); + long notifBefore = count("notifications"); + worker.processDue(10); + assertEquals(notifBefore, count("notifications"), "Worker 物化不得写 notifications"); + } + + // 20. 普通刷新路径不写 snapshot_history + @Test + void noRefreshPathWritesSnapshotHistory() { + requestService.requestRefresh(sid, now()); + long histBefore = count("candidate_scoring_snapshot_history"); + worker.processDue(10); + assertEquals(histBefore, count("candidate_scoring_snapshot_history"), + "普通物化不得写 candidate_scoring_snapshot_history（仅申诉决定/回滚写入）"); + } + + // 5. 到期 RETRY 重新领取 + 未到期不领取 + @Test + void retryTaskClaimedOnlyWhenDue() { + requestService.requestRefresh(sid, now()); + Long taskId = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET status='RETRY', next_attempt_at=? WHERE id=?", + now().plusHours(1), taskId); + assertFalse(worker.processOne(taskId, now()), "未到 next_attempt_at 不得领取"); + jdbcTemplate.update("UPDATE candidate_scoring_refresh_tasks SET next_attempt_at=NULL WHERE id=?", taskId); + assertTrue(worker.processOne(taskId, now()), "到期任务应可领取"); + } + + @Test + void staleProcessingLeaseIsRecoveredAndCanBeClaimedAgain() { + requestService.requestRefresh(sid, now()); + Long taskId = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", Long.class, sid); + LocalDateTime claimedAt = now().minusMinutes(20); + assertNotNull(taskExecutor.claim(taskId, claimedAt)); + + assertEquals(1, taskExecutor.recoverStale(now().minusMinutes(10), now(), 3)); + assertEquals("RETRY", taskStatus()); + assertEquals("WORKER_TIMEOUT", jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE id=?", String.class, taskId)); + assertNotNull(taskExecutor.claim(taskId, now()), "恢复后的租约必须可被其他实例重新领取"); + } + + // 无外层事务时登记独立提交成功；外层回滚由专门事务测试覆盖。 + @Test + void requestRegistrationCommitsIndependently() { + requestService.requestRefresh(sid, now()); + assertEquals(1, taskCount()); + } + + @Test + void compensationScanTraversesMoreThanThreePagesWithoutStarvation() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + List expected = new java.util.ArrayList<>(); + for (int i = 0; i < 7; i++) { + User u = User.builder().phone("131" + String.format("%08d", i + 7000)) + .nickname("scan-" + i).role(User.Role.STUDENT) + .active(true).verified(true).build(); + u.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + Long id = userRepository.saveAndFlush(u).getId(); + expected.add(id); + jdbcTemplate.update("INSERT INTO audit_logs(user_id,action,created_at) VALUES (?,'LOGIN',?)", + id, now()); + } + jdbcTemplate.update(""" + INSERT INTO candidate_scoring_refresh_scan_checkpoints + (scan_key,last_user_id,version,updated_at) + VALUES ('ACTIVE_STUDENTS',?,0,CURRENT_TIMESTAMP) + """, expected.get(0) - 1L); + + int first = compensationScanner.scanDueStudents(2); + long cursorAfterFirst = jdbcTemplate.queryForObject( + "SELECT last_user_id FROM candidate_scoring_refresh_scan_checkpoints WHERE scan_key='ACTIVE_STUDENTS'", + Long.class); + int second = compensationScanner.scanDueStudents(2); + int third = compensationScanner.scanDueStudents(2); + int fourth = compensationScanner.scanDueStudents(2); + List actual = jdbcTemplate.queryForList( + "SELECT student_user_id FROM candidate_scoring_refresh_tasks WHERE student_user_id IN (" + + String.join(",", java.util.Collections.nCopies(expected.size(), "?")) + ")", + Long.class, expected.toArray()); + + assertEquals(2, first, "单轮必须严格受预算限制"); + assertTrue(cursorAfterFirst > 0L, "游标必须持久化以供下一轮或重启后续扫"); + assertTrue(second <= 2 && third <= 2 && fourth <= 2, "每轮不得突破固定预算"); + assertEquals(Set.copyOf(expected), Set.copyOf(actual), + "持久 keyset 游标必须跨四轮覆盖每个合格学生"); + } + + // ── F4：ABILITY 快照 payload 敏感字段防泄漏（真实 Writer → 真实 DB → 递归断言） ── + + /** 禁止作为 JSON key 出现的字段名（小写精确匹配，避免 questionSetVersion 之类白名单字段误报）。 */ + private static final java.util.List BANNED_KEYS = java.util.List.of( + "answer", "answers", "rawanswer", "rawanswers", + "question", "questions", "questionid", "questioncode", "questionstem", + "option", "options", "optionid", "selectedoption", "selectedoptionid", + "answerkey", "competencytag", "stem", + "scoringrule", "awardedscore", "explanation", + "phone", "email", "mobile", "token", "password", "accesstoken"); + + private void assertNoBannedKeyDeep(com.fasterxml.jackson.databind.JsonNode node, + String path, java.util.List hits) { + if (node == null) return; + if (node.isObject()) { + java.util.Iterator it = node.fieldNames(); + java.util.List names = new java.util.ArrayList<>(); + it.forEachRemaining(names::add); + for (String name : names) { + String lower = name.toLowerCase(); + if (BANNED_KEYS.contains(lower)) hits.add(path + "." + name); + assertNoBannedKeyDeep(node.get(name), path + "." + name, hits); + } + } else if (node.isArray()) { + for (int i = 0; i < node.size(); i++) { + assertNoBannedKeyDeep(node.get(i), path + "[" + i + "]", hits); + } + } + } + + @Test + void abilitySnapshotPayload_hasNoSensitiveFields_andKeepsWhitelistedKeys() throws Exception { + String p = period; + CandidateScoringCalculator.DimensionResult r = + new CandidateScoringCalculator.DimensionResult("ABILITY"); + r.score = new java.math.BigDecimal("74.25"); + r.status = "OK"; + r.abilitySnapshotTrace = new CandidateScoringCalculator.AbilitySnapshotTrace( + 123L, now(), now().plusDays(30), "qs-v1", "ar-v1", + Map.of("KNOWLEDGE", 30, "SKILL", 70), + Map.of("KNOWLEDGE", new java.math.BigDecimal("70.00"), + "SKILL", new java.math.BigDecimal("78.50"))); + + writer.upsertIfChanged(sid, List.of(r), p, now(), "candidate-scoring-v0.2"); + + String json = jdbcTemplate.queryForObject( + "SELECT sub_scores_json FROM candidate_dimension_scores " + + "WHERE student_user_id=? AND dimension='ABILITY' AND period=?", + String.class, sid, p); + assertNotNull(json, "ABILITY 快照 JSON 必须经真实 Writer 写入数据库"); + + com.fasterxml.jackson.databind.JsonNode node = + new com.fasterxml.jackson.databind.ObjectMapper().readTree(json); + + // 正向：白名单字段必须存在且取值正确 + for (String allowed : List.of("source", "sourceResultId", "validUntil", "questionSetVersion", + "assessmentRulesVersion", "mappingRulesVersion", "weights", "dimensionScores")) { + assertTrue(node.has(allowed), "允许字段必须存在: " + allowed); + } + assertEquals("V36_ABILITY_ASSESSMENT", node.get("source").asText()); + assertEquals(123L, node.get("sourceResultId").asLong()); + assertTrue(node.get("weights").has("KNOWLEDGE"), "weights 应保留白名单内的维度键"); + assertTrue(node.get("dimensionScores").has("SKILL"), "dimensionScores 应保留白名单内的维度键"); + + // 负向（递归，含嵌套对象与数组，大小写不敏感） + java.util.List hits = new java.util.ArrayList<>(); + assertNoBannedKeyDeep(node, "$", hits); + assertTrue(hits.isEmpty(), "ABILITY payload 递归不得含敏感字段，命中: " + hits); + + // 负向（原始 JSON 文本层，禁止出现这些 key 字面量） + String lower = json.toLowerCase(); + for (String banned : List.of("answer", "answers", "rawanswer", "questionid", "questioncode", + "optionid", "selectedoption", "answerkey", "competencytag", "stem", + "scoringrule", "awardedscore", "explanation", "phone", "email", "token")) { + assertFalse(lower.contains("\"" + banned + "\""), + "原始 JSON 不得出现敏感 key 字面量: " + banned); + } + } + + private long count(String table) { + Long c = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM " + table, Long.class); + return c == null ? -1 : c; + } + + /** R01-C 阶段二：本类会以**当前 period** 物化快照。残留行会进入同库中其它测试 + * 对"当前期间"的总体统计（如 Fairness 的 populationSize），造成顺序相关误失败。 + * 此处按本类**独占手机号前缀**解析出精确 id，再按外键顺序删除；不使用 deleteAll。 */ + @AfterEach + void cleanupOwnFixture() { + for (String prefix : java.util.List.of("132", "13107")) { + for (Long id : jdbcTemplate.queryForList( + "SELECT id FROM users WHERE phone LIKE ?", Long.class, prefix + "%")) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks WHERE student_user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshMySqlIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshMySqlIntegrationTest.java new file mode 100644 index 0000000..2b0941f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshMySqlIntegrationTest.java @@ -0,0 +1,274 @@ +package com.mydreamjob.candidatescore.refresh; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.annotation.DirtiesContext; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.when; + +/** R01-D4-1 真实 MySQL 8.4 网关：正式 Flyway、validate、锁与事务语义。 */ +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) +class CandidateScoringRefreshMySqlIntegrationTest { + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("mydreamjob_r01_d4") + .withUsername("r01d4") + .withPassword("r01-d4-test-only"); + + @DynamicPropertySource + static void datasource(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate"); + } + + @Autowired private CandidateScoringRefreshRequestService requestService; + @Autowired private CandidateScoringRefreshTaskExecutor executor; + @Autowired private CandidateScoringRefreshWorker worker; + @Autowired private CandidateScoringRefreshCompensationScanner compensationScanner; + @Autowired private CandidateScoringSnapshotWriter writer; + @Autowired private CandidateDimensionScoreRepository snapshotRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private CandidateScoringCalculator calculator; + @MockBean private RedisTemplate redisTemplate; + + private Long failingStudent; + private Long successfulStudent; + private final LocalDateTime now = LocalDateTime.of(2026, 9, 16, 12, 0); + + @BeforeEach + void setUp() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_scan_checkpoints"); + snapshotRepository.deleteAll(); + failingStudent = student("mysql-failing"); + successfulStudent = student("mysql-success"); + when(calculator.currentRulesVersion()).thenReturn("candidate-scoring-v0.1"); + when(calculator.computeAll(any(), any())).thenAnswer(call -> + results(call.getArgument(0).equals(failingStudent))); + } + + @Test + void v44MigrationAndSchemaValidationAreApplied() { + Integer success = jdbcTemplate.queryForObject(""" + SELECT success FROM flyway_schema_history + WHERE version='44' AND description='candidate scoring refresh tasks' + """, Integer.class); + assertEquals(1, success); + Long columns = jdbcTemplate.queryForObject(""" + SELECT COUNT(*) FROM information_schema.columns + WHERE table_schema=DATABASE() AND table_name='candidate_scoring_refresh_tasks' + """, Long.class); + // V44 建表 13 列；R01-D4-2 claim fence 整改的 V45 追加 claim_token → 14 列 + assertEquals(14L, columns); + Long claimTokenColumns = jdbcTemplate.queryForObject(""" + SELECT COUNT(*) FROM information_schema.columns + WHERE table_schema=DATABASE() AND table_name='candidate_scoring_refresh_tasks' + AND column_name='claim_token' + """, Long.class); + assertEquals(1L, claimTokenColumns, "V45 必须新增 claim_token 列"); + + // V45 自身必须成功且唯一 + Integer v45 = jdbcTemplate.queryForObject(""" + SELECT success FROM flyway_schema_history WHERE version='45' + """, Integer.class); + assertEquals(1, v45, "V45 必须成功"); + Long v45Rows = jdbcTemplate.queryForObject(""" + SELECT COUNT(*) FROM flyway_schema_history WHERE version='45' + """, Long.class); + assertEquals(1L, v45Rows, "V45 必须唯一"); + + Long checkpointColumns = jdbcTemplate.queryForObject(""" + SELECT COUNT(*) FROM information_schema.columns + WHERE table_schema=DATABASE() AND table_name='candidate_scoring_refresh_scan_checkpoints' + """, Long.class); + assertEquals(4L, checkpointColumns); + } + + @Test + void mysqlWriterIsIdempotentAndForcePathStillAdvancesVersion() { + List values = results(false); + writer.upsertIfChanged(successfulStudent, values, "2026-09", now, "candidate-scoring-v0.1"); + var first = snapshotRepository.findByStudentUserIdAndPeriod(successfulStudent, "2026-09"); + assertEquals(8, first.size()); + assertTrue(first.stream().allMatch(row -> row.getVersion() == 0L)); + + writer.upsertIfChanged(successfulStudent, values, "2026-09", now.plusMinutes(1), + "candidate-scoring-v0.1"); + var unchanged = snapshotRepository.findByStudentUserIdAndPeriod(successfulStudent, "2026-09"); + assertTrue(unchanged.stream().allMatch(row -> row.getVersion() == 0L)); + + values.get(0).score = new BigDecimal("88.00"); + writer.upsertIfChanged(successfulStudent, values, "2026-09", now.plusMinutes(2), + "candidate-scoring-v0.1"); + var changed = snapshotRepository.findByStudentUserIdAndPeriod(successfulStudent, "2026-09"); + assertEquals(1L, changed.stream().filter(row -> "EDUCATION".equals(row.getDimension())) + .findFirst().orElseThrow().getVersion()); + assertTrue(changed.stream().filter(row -> !"EDUCATION".equals(row.getDimension())) + .allMatch(row -> row.getVersion() == 0L)); + + writer.upsertForcingVersion(successfulStudent, values.get(0), "2026-09", now.plusMinutes(3), + "candidate-scoring-v0.1"); + assertEquals(2L, snapshotRepository.findByStudentUserIdAndPeriod(successfulStudent, "2026-09") + .stream().filter(row -> "EDUCATION".equals(row.getDimension())) + .findFirst().orElseThrow().getVersion()); + } + + @Test + void mysqlConcurrentClaimHasExactlyOneWinner() throws Exception { + requestService.requestRefresh(successfulStudent, now); + Long taskId = taskId(successfulStudent); + ExecutorService pool = Executors.newFixedThreadPool(2); + CountDownLatch ready = new CountDownLatch(2); + CountDownLatch start = new CountDownLatch(1); + List> futures = new ArrayList<>(); + for (int i = 0; i < 2; i++) { + futures.add(pool.submit(() -> { + ready.countDown(); + start.await(10, TimeUnit.SECONDS); + return executor.claim(taskId, now); + })); + } + assertTrue(ready.await(10, TimeUnit.SECONDS)); + start.countDown(); + long winners = 0; + for (Future future : futures) { + if (future.get(30, TimeUnit.SECONDS) != null) winners++; + } + pool.shutdownNow(); + assertEquals(1L, winners); + } + + @Test + void mysqlFailureRollsBackPartialSnapshotsAndDoesNotRollbackSibling() { + requestService.requestRefresh(failingStudent, now); + requestService.requestRefresh(successfulStudent, now); + + assertEquals(1, worker.processDue(10)); + assertTrue(snapshotRepository.findByStudentUserId(failingStudent).isEmpty()); + assertEquals(8, snapshotRepository.findByStudentUserId(successfulStudent).size()); + assertEquals("RETRY", status(failingStudent)); + assertEquals("WRITE_FAILED", error(failingStudent)); + assertEquals("COMPLETED", status(successfulStudent)); + } + + @Test + void mysqlProcessingReregistrationAndStaleRecoveryDoNotLoseWork() { + requestService.requestRefresh(successfulStudent, now); + Long taskId = taskId(successfulStudent); + var claimed = executor.claim(taskId, now); + assertNotNull(claimed); + requestService.requestRefresh(successfulStudent, now.plusSeconds(1)); + executor.materialize(claimed, now); + assertEquals("PENDING", status(successfulStudent)); + + var staleClaim = executor.claim(taskId, now.minusMinutes(20)); + assertNotNull(staleClaim); + assertEquals(1, executor.recoverStale(now.minusMinutes(10), now, 3)); + assertEquals("RETRY", status(successfulStudent)); + assertNotNull(executor.claim(taskId, now)); + } + + @Test + void mysqlCompensationCursorPersistsAndHonorsPerRunBudget() { + List students = new ArrayList<>(); + for (int i = 0; i < 5; i++) { + Long id = student("mysql-scan-" + i); + students.add(id); + jdbcTemplate.update("INSERT INTO audit_logs(user_id,action,created_at) VALUES (?,'LOGIN',?)", id, now); + } + jdbcTemplate.update(""" + INSERT INTO candidate_scoring_refresh_scan_checkpoints + (scan_key,last_user_id,version,updated_at) + VALUES ('ACTIVE_STUDENTS',?,0,CURRENT_TIMESTAMP) + """, students.get(0) - 1L); + + assertEquals(2, compensationScanner.scanDueStudents(2)); + long cursor = jdbcTemplate.queryForObject(""" + SELECT last_user_id FROM candidate_scoring_refresh_scan_checkpoints + WHERE scan_key='ACTIVE_STUDENTS' + """, Long.class); + assertEquals(students.get(1).longValue(), cursor); + assertEquals(2, compensationScanner.scanDueStudents(2)); + assertEquals(1, compensationScanner.scanDueStudents(2)); + Long registered = jdbcTemplate.queryForObject(""" + SELECT COUNT(*) FROM candidate_scoring_refresh_tasks + WHERE student_user_id IN (?,?,?,?,?) + """, Long.class, students.toArray()); + assertEquals(5L, registered); + } + + private Long student(String nickname) { + User user = User.builder() + .phone("131" + String.format("%08d", Math.abs(System.nanoTime() % 100_000_000L))) + .nickname(nickname).role(User.Role.STUDENT).active(true).verified(true).build(); + user.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + return userRepository.saveAndFlush(user).getId(); + } + + private Long taskId(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, studentId); + } + + private String status(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT status FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + private String error(Long studentId) { + return jdbcTemplate.queryForObject( + "SELECT last_error_code FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + } + + private List results(boolean failAtFourth) { + String[] dimensions = {"EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"}; + List values = new ArrayList<>(); + for (int i = 0; i < dimensions.length; i++) { + var value = new CandidateScoringCalculator.DimensionResult(failAtFourth && i == 3 ? null : dimensions[i]); + value.score = BigDecimal.valueOf(60L + i); + value.status = "OK"; + values.add(value); + } + return values; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorkerLoopIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorkerLoopIsolationTest.java new file mode 100644 index 0000000..9cc72c0 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/candidatescore/refresh/CandidateScoringRefreshWorkerLoopIsolationTest.java @@ -0,0 +1,110 @@ +package com.mydreamjob.candidatescore.refresh; + +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 org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; +import org.springframework.jdbc.core.JdbcTemplate; + +import java.time.LocalDateTime; +import java.util.List; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 次生缺陷：{@code processDue} 的批次循环必须逐任务隔离。 + * + *

    缺陷背景：{@code recordFailure} 更新 0 行时抛 IllegalStateException，该异常在 + * Worker 的 catch 块内抛出，而 {@code processDue} 的 for 循环没有保护 —— 会导致同批 + * 剩余任务本轮全部不被处理。

    + * + *

    纯单元测试：精确控制"第一项失败且失败登记也抛异常"的时序，不依赖 sleep 或 JVM 锁。

    + */ +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class CandidateScoringRefreshWorkerLoopIsolationTest { + + @Mock private JdbcTemplate jdbcTemplate; + @Mock private CandidateScoringRefreshTaskExecutor taskExecutor; + + @InjectMocks private CandidateScoringRefreshWorker worker; + + /** 固定时间，保证 record 的 equals 在参数匹配时可稳定比较。 */ + private static final LocalDateTime CLAIMED_AT = LocalDateTime.of(2026, 9, 16, 12, 0); + + private CandidateScoringRefreshTaskExecutor.ClaimedTask claim(long id) { + return new CandidateScoringRefreshTaskExecutor.ClaimedTask(id, id * 10, "2026-09", + CLAIMED_AT, "token-" + id, 0L); + } + + @Test + void recordFailureThrowing_doesNotAbortRemainingTasksInBatch() { + when(jdbcTemplate.queryForList(anyString(), eq(Long.class), any(), anyInt())) + .thenReturn(List.of(1L, 2L, 3L)); + when(taskExecutor.claim(anyLong(), any(LocalDateTime.class))) + .thenAnswer(inv -> claim(inv.getArgument(0))); + when(taskExecutor.recoverStale(any(), any(), anyInt())).thenReturn(0); + + // 第一个任务计算失败 + doThrow(new RuntimeException("compute blew up")) + .when(taskExecutor).materialize(eq(claim(1L)), any(LocalDateTime.class)); + // 且其失败登记也抛异常（旧实现会抛出 IllegalStateException） + doThrow(new IllegalStateException("refresh task failure state conflict")) + .when(taskExecutor).recordFailure(eq(1L), anyString(), any(LocalDateTime.class), + anyInt(), anyLong(), anyString()); + + worker.processDue(10); + + // 关键：后续两个任务必须仍被处理 + verify(taskExecutor, times(1)).materialize(eq(claim(2L)), any(LocalDateTime.class)); + verify(taskExecutor, times(1)).materialize(eq(claim(3L)), any(LocalDateTime.class)); + } + + @Test + void recordFailureThrowingInMiddle_doesNotAbortRemainingTasks() { + when(jdbcTemplate.queryForList(anyString(), eq(Long.class), any(), anyInt())) + .thenReturn(List.of(11L, 12L, 13L)); + when(taskExecutor.claim(anyLong(), any(LocalDateTime.class))) + .thenAnswer(inv -> claim(inv.getArgument(0))); + when(taskExecutor.recoverStale(any(), any(), anyInt())).thenReturn(0); + + doThrow(new RuntimeException("boom")).when(taskExecutor) + .materialize(eq(claim(12L)), any(LocalDateTime.class)); + doThrow(new IllegalStateException("state conflict")).when(taskExecutor) + .recordFailure(eq(12L), anyString(), any(LocalDateTime.class), anyInt(), anyLong(), + anyString()); + + worker.processDue(10); + + verify(taskExecutor, times(1)).materialize(eq(claim(11L)), any(LocalDateTime.class)); + verify(taskExecutor, times(1)).materialize(eq(claim(13L)), any(LocalDateTime.class)); + } + + @Test + void claimLosing_skipsTaskWithoutRecordingFailure() { + when(jdbcTemplate.queryForList(anyString(), eq(Long.class), any(), anyInt())) + .thenReturn(List.of(21L, 22L)); + when(taskExecutor.recoverStale(any(), any(), anyInt())).thenReturn(0); + // 21 被并发 Worker 抢走（claim 返回 null） + when(taskExecutor.claim(eq(21L), any(LocalDateTime.class))).thenReturn(null); + when(taskExecutor.claim(eq(22L), any(LocalDateTime.class))).thenReturn(claim(22L)); + + worker.processDue(10); + + verify(taskExecutor, never()).recordFailure(eq(21L), anyString(), any(LocalDateTime.class), + anyInt(), anyLong(), anyString()); + verify(taskExecutor, times(1)).materialize(eq(claim(22L)), any(LocalDateTime.class)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressControllerTest.java index e9d2ff7..c750f5e 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressControllerTest.java @@ -182,8 +182,7 @@ class CareerProgressControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } // ── 权限矩阵 ────────────────────────────────────────────── diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressServiceTest.java index 5443ba8..e4becbb 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/careerprogress/CareerProgressServiceTest.java @@ -82,9 +82,12 @@ class CareerProgressServiceTest { @BeforeEach void setUp() { calculator = spy(new CompetitionRankingCalculator(dimensionScoreRepository, scoringCalculator)); - service = new CareerProgressService(applicationRepository, interviewRepository, + // R01-B/B1：角色授权已收束到 UserRoleGuard。此处装配**真实** guard 并复用本测试 + // 已 stub 的 userRepository，使断言目标（角色不符 → FORBIDDEN）与收束前完全一致。 + service = new CareerProgressService(new com.mydreamjob.security.UserRoleGuard(userRepository), + applicationRepository, interviewRepository, interviewScoreRepository, offerRepository, notificationRepository, - jobRepository, companyRepository, userRepository, calculator); + jobRepository, companyRepository, userRepository, calculator, scoringCalculator); when(scoringCalculator.overallScoreFromSnapshots(anyList())).thenAnswer(inv -> { List snaps = inv.getArgument(0); @@ -190,7 +193,7 @@ class CareerProgressServiceTest { anyLong(), anyCollection(), anyString())).thenReturn(List.of(s1, s2)); // Offer：一条 SENT 有效 + 一条 DRAFT（不应返回 DRAFT） - Offer sent = offer(14L, app.getId(), "SENT", "2026-09-05T23:59:59"); + Offer sent = offer(14L, app.getId(), "SENT", LocalDateTime.now().plusDays(1).withNano(0).toString()); when(offerRepository.findByCandidateIdAndStatusNotOrderByCreatedAtDesc(anyLong(), anyString())) .thenReturn(List.of(sent)); @@ -439,4 +442,4 @@ class CareerProgressServiceTest { private static String yearMonth(LocalDate d) { return String.format("%04d-%02d", d.getYear(), d.getMonthValue()); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerAccountDeletionTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerAccountDeletionTest.java index 5770dc1..abeacd1 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerAccountDeletionTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerAccountDeletionTest.java @@ -19,7 +19,7 @@ class GlobalExceptionHandlerAccountDeletionTest { @BeforeEach void setUp() { - handler = new GlobalExceptionHandler(); + handler = new GlobalExceptionHandler(new com.mydreamjob.common.logging.RequestIdAccessor(), new ErrorHttpStatusRegistry()); request = new MockHttpServletRequest(); request.setRequestURI("/api/v1/profile/me/deletion"); } @@ -42,4 +42,4 @@ class GlobalExceptionHandlerAccountDeletionTest { assertEquals(code.getCode(), resp.getBody().getCode()); } } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerHttpStatusTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerHttpStatusTest.java index e21eadf..88f613e 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerHttpStatusTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerHttpStatusTest.java @@ -16,7 +16,7 @@ class GlobalExceptionHandlerHttpStatusTest { @BeforeEach void setUp() { - handler = new GlobalExceptionHandler(); + handler = new GlobalExceptionHandler(new com.mydreamjob.common.logging.RequestIdAccessor(), new ErrorHttpStatusRegistry()); request = new MockHttpServletRequest(); request.setRequestURI("/api/v1/test"); } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerReportBlockTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerReportBlockTest.java index b37edcb..deb6f8a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerReportBlockTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerReportBlockTest.java @@ -22,7 +22,7 @@ class GlobalExceptionHandlerReportBlockTest { @BeforeEach void setUp() { - handler = new GlobalExceptionHandler(); + handler = new GlobalExceptionHandler(new com.mydreamjob.common.logging.RequestIdAccessor(), new ErrorHttpStatusRegistry()); request = new MockHttpServletRequest(); request.setRequestURI("/api/v1/reports"); } @@ -87,4 +87,4 @@ class GlobalExceptionHandlerReportBlockTest { void blockedSend_externallyUsesForbidden_shouldReturnHttp403() { assertEquals(HttpStatus.FORBIDDEN.value(), statusOf(ErrorCode.FORBIDDEN)); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerStatusContractTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerStatusContractTest.java new file mode 100644 index 0000000..8d322ae --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/exception/GlobalExceptionHandlerStatusContractTest.java @@ -0,0 +1,115 @@ +package com.mydreamjob.common.exception; + +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.logging.RequestIdAccessor; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.mock.web.MockHttpServletRequest; + +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +/** Locks the pre-R01-B public HTTP contract for every existing business error code. */ +class GlobalExceptionHandlerStatusContractTest { + + private static final Set FORBIDDEN = Set.of( + "FORBIDDEN", "INTERVIEW_ACCESS_DENIED", "APPLICATION_OWNER_MISMATCH", + "MATCH_REQUIRED_FOR_CONVERSATION", "OFFER_COMPARE_NOT_OWNER"); + + private static final Set NOT_FOUND = Set.of( + "COMPANY_NOT_FOUND", "PROFILE_NOT_FOUND", "JOB_NOT_FOUND", "APPLICATION_NOT_FOUND", + "OFFER_NOT_FOUND", "OFFER_COUNTER_OFFER_NOT_FOUND", "RESUME_VERSION_NOT_FOUND", + "RESUME_EXPORT_TASK_NOT_FOUND", "USER_NOT_FOUND", "REVIEW_NOT_FOUND", + "FEEDBACK_NOT_FOUND", "CONVERSATION_NOT_FOUND", "MESSAGE_NOT_FOUND", + "APPEAL_NOT_FOUND", "DATA_EXPORT_TASK_NOT_FOUND", "REVIEW_REPLY_NOT_FOUND", + "TALENT_INVITATION_NOT_FOUND", "VERIFICATION_NOT_FOUND", "INTERVIEW_SCORE_NOT_FOUND", + "REPORT_NOT_FOUND", "ASSESSMENT_TYPE_NOT_FOUND", "ASSESSMENT_ATTEMPT_NOT_FOUND", + "ABILITY_TYPE_NOT_FOUND", "ABILITY_ATTEMPT_NOT_FOUND", "ABILITY_RESULT_NOT_FOUND", + "RISK_RULE_NOT_FOUND", "RISK_EVENT_NOT_FOUND"); + + private static final Set CONFLICT = Set.of( + "COMPANY_ALREADY_EXISTS", "APPLICATION_DUPLICATE", "INVALID_APPLICATION_STATUS_TRANSITION", + "INVALID_JOB_STATUS_TRANSITION", "DUPLICATE_REVIEW", "DUPLICATE_FEEDBACK", + "DUPLICATE_OFFER", "INVALID_OFFER_STATUS_TRANSITION", "OFFER_EXPIRED", + "OFFER_NOT_EDITABLE", "OFFER_REMINDER_DUPLICATE", "OFFER_COUNTER_OFFER_EXISTS", + "OFFER_COUNTER_OFFER_NOT_PENDING", "OFFER_COUNTER_OFFER_EXPIRED", + "DEFAULT_RESUME_DELETE_NOT_ALLOWED", "RESUME_EXPORT_IN_PROGRESS", + "DUPLICATE_DEFAULT_RESUME", "RESUME_EXPORT_NOT_READY", "MATCH_CLOSED", + "MATCH_SCORES_LOCKED", "APPLICATION_NOT_MATCHED", "REVIEW_ALREADY_DECIDED", + "INVALID_INTERVIEW_STATUS_TRANSITION", "INTERVIEW_COMPLETE_NOT_READY", + "INTERVIEW_ALREADY_RESPONDED", "REVIEW_REPLY_ALREADY_EXISTS", + "REVIEW_REPLY_INVALID_STATE", "REVIEW_REPLY_CONCURRENT_UPDATE", + "REVIEW_REPLY_IDEMPOTENCY_CONFLICT", "MESSAGE_RECALL_WINDOW_EXPIRED", + "MESSAGE_RECALL_CONCURRENT_UPDATE", "TALENT_INVITATION_CANDIDATE_UNAVAILABLE", + "TALENT_INVITATION_ALREADY_ACTIVE", "TALENT_INVITATION_INVALID_STATE", + "TALENT_INVITATION_EXPIRED", "TALENT_INVITATION_CONCURRENT_UPDATE", + "TALENT_INVITATION_IDEMPOTENCY_CONFLICT", "VERIFICATION_ALREADY_PENDING", + "VERIFICATION_ALREADY_APPROVED", "INVALID_VERIFICATION_STATUS_TRANSITION", + "REVIEW_WEIGHT_CONCURRENT_UPDATE", "PRIVACY_SETTINGS_CONCURRENT_UPDATE", + "INVALID_DELETION_STATE", "ACCOUNT_DELETION_PENDING", "ACCOUNT_DELETED", + "ACCOUNT_DELETION_CONCURRENT_UPDATE", "ACCOUNT_DELETION_CANCEL_DEADLINE_PASSED", + "LAST_ADMIN_CANNOT_DELETE", "APPEAL_DUPLICATE", "APPEAL_ALREADY_DECIDED", + "APPEAL_ROLLBACK_LIMIT_EXCEEDED", "APPEAL_INVALID_TRANSITION", + "APPEAL_IDEMPOTENCY_CONFLICT", "DATA_EXPORT_DUPLICATE", "DATA_EXPORT_NOT_READY", + "DATA_EXPORT_EXPIRED", "DATA_EXPORT_FAILED", "DATA_EXPORT_FILE_NOT_FOUND", + "INTERVIEW_SCORE_CONCURRENT_UPDATE", "INTERVIEW_NOT_COMPLETED", + "INTERVIEW_SCORE_SUBMITTED", "REPORT_DUPLICATE", "REPORT_ALREADY_DECIDED", + "REPORT_INVALID_TRANSITION", "REPORT_IDEMPOTENCY_CONFLICT", + "ASSESSMENT_ATTEMPT_INVALID_STATE", "ASSESSMENT_CONCURRENT_UPDATE", + "ASSESSMENT_DUPLICATE_ACTIVE", "ASSESSMENT_IDEMPOTENCY_CONFLICT", + "ABILITY_ATTEMPT_INVALID_STATE", "ABILITY_CONCURRENT_UPDATE", "ABILITY_DUPLICATE_ACTIVE", + "ABILITY_IDEMPOTENCY_CONFLICT", "ABILITY_RETAKE_COOLDOWN", + "RISK_RULE_CONCURRENT_UPDATE", "RISK_EVENT_CONCURRENT_UPDATE", "RISK_INVALID_ACTION", + "COMPANY_REGISTRATION_CONFLICT", "COMPANY_ONBOARDING_INCONSISTENT_STATE"); + + private static final Set TOO_MANY_REQUESTS = Set.of( + "REPORT_RATE_LIMITED", "ABILITY_RETAKE_LIMIT", "TALENT_INVITATION_RATE_LIMITED", + "PASSWORD_RATE_LIMITED"); + + private static final Set UNAUTHORIZED = Set.of("CREDENTIALS_INVALID"); + private static final Set SERVICE_UNAVAILABLE = Set.of( + "COMPANY_REGISTRATION_DISABLED", "COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE"); + + private final GlobalExceptionHandler handler = new GlobalExceptionHandler(new RequestIdAccessor(), new ErrorHttpStatusRegistry()); + + @ParameterizedTest(name = "{0}") + @EnumSource(ErrorCode.class) + void everyExistingErrorCodeKeepsItsHttpStatusAndResponseFields(ErrorCode errorCode) { + MockHttpServletRequest request = new MockHttpServletRequest(); + request.setRequestURI("/api/v1/contract"); + request.setAttribute("requestId", "r01b-contract"); + + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(errorCode), request); + + assertEquals(expectedStatus(errorCode), response.getStatusCode(), errorCode.name()); + assertNotNull(response.getBody()); + assertEquals(errorCode.getCode(), response.getBody().getCode()); + assertEquals(errorCode.getMessage(), response.getBody().getMessage()); + assertEquals("r01b-contract", response.getBody().getRequestId()); + } + + @Test + void unknownBusinessCodeKeepsBadRequestFallback() { + // R01-B/B2：解析入口由 GlobalExceptionHandler 的私有方法收束到 ErrorHttpStatusRegistry， + // 断言目标（未知码仍回退 400）保持不变，不再依赖反射。 + assertEquals(HttpStatus.BAD_REQUEST, new ErrorHttpStatusRegistry().resolve(123456789)); + } + + private HttpStatus expectedStatus(ErrorCode errorCode) { + String name = errorCode.name(); + if (FORBIDDEN.contains(name)) return HttpStatus.FORBIDDEN; + if (NOT_FOUND.contains(name)) return HttpStatus.NOT_FOUND; + if (CONFLICT.contains(name)) return HttpStatus.CONFLICT; + if (TOO_MANY_REQUESTS.contains(name)) return HttpStatus.TOO_MANY_REQUESTS; + if ("PASSWORD_STATE_CONFLICT".equals(name)) return HttpStatus.CONFLICT; + if (UNAUTHORIZED.contains(name)) return HttpStatus.UNAUTHORIZED; + if (SERVICE_UNAVAILABLE.contains(name)) return HttpStatus.SERVICE_UNAVAILABLE; + return HttpStatus.BAD_REQUEST; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..918a393 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestContextMigrationIntegrationTest.java @@ -0,0 +1,386 @@ +package com.mydreamjob.common.logging; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.support.TestAuthTokens; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.slf4j.MDC; +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.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.MvcResult; +import org.springframework.web.servlet.HandlerInterceptor; +import org.springframework.web.servlet.config.annotation.InterceptorRegistry; +import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A：请求上下文收束的**端到端**证据。 + * + *

    使用真实的 {@code SecurityFilterChain}、{@link RequestIdFilter} 与 MVC 派发， + * 而不是 Mock 掉新组件后断言 mock 值。覆盖：requestId 在响应头 / 响应体 / MDC / + * {@code AuditContext} 中同源、并发不串号、过滤器结束后清理 MDC、八类非法 principal + * 得到 401 而非 500、错误响应不回显 principal、拒绝请求不产生业务写入。

    + * + *

    被迁移的 8 个 Controller 全部被真实调用一次。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class RequestContextMigrationIntegrationTest { + + private static final String REQUEST_ID_HEADER = "X-Request-Id"; + private static final String BAD_PRINCIPAL = "INTERNAL_BAD_PRINCIPAL_SECRET"; + /** + * 测试专属手机号段（986_000_000 起）。 + * + *

    隔离修复：此前使用 930_000_000 与 {@code AccountDeletionControllerTest} 撞段， + * 且本类不清理所创建的 users，导致共享 H2 库（integrationdb）中残留该号码， + * 使后运行的同类首次 createUser 触发唯一键冲突。

    + */ + private static final AtomicLong PHONE = new AtomicLong(986_000_000L); + + /** 8 个已迁移 Controller 各自的真实入口 + 预期状态码（STUDENT 身份）。 */ + private static final List ENDPOINTS = List.of( + new MigratedEndpoint("/profile/me", 200, "ProfileController"), + new MigratedEndpoint("/profile/me/preferences", 200, "PreferenceController"), + new MigratedEndpoint("/profile/me/privacy", 200, "PrivacySettingsController"), + new MigratedEndpoint("/profile/me/resume-versions", 200, "ResumeVersionController"), + new MigratedEndpoint("/profile/me/data-export-tasks", 200, "PersonalDataExportController"), + new MigratedEndpoint("/assessments/me", 200, "AssessmentController"), + new MigratedEndpoint("/abilities/me", 200, "AbilityController"), + new MigratedEndpoint("/jobs/99999999/competition-ranking", 404, "CompetitionRankingController")); + + private record MigratedEndpoint(String path, int expectedStatus, String controller) { + } + + /** 在真实 MVC 派发过程中抓取 MDC 与 AuditContext，避免只看过滤器自身。 */ + static final class RequestContextProbe { + static final ThreadLocal MDC_VALUE = new ThreadLocal<>(); + static final ThreadLocal AUDIT_VALUE = new ThreadLocal<>(); + + static void clear() { + MDC_VALUE.remove(); + AUDIT_VALUE.remove(); + } + } + + @TestConfiguration + static class RequestContextProbeConfig implements WebMvcConfigurer { + @Override + public void addInterceptors(InterceptorRegistry registry) { + registry.addInterceptor(new HandlerInterceptor() { + @Override + public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { + RequestContextProbe.MDC_VALUE.set(MDC.get(RequestIdFilter.REQUEST_ID_ATTRIBUTE)); + RequestContextProbe.AUDIT_VALUE.set(AuditContext.from(request).getRequestId()); + return true; + } + }); + } + } + + @Autowired private MockMvc mockMvc; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private RedisTemplate redisTemplate; + + private final ObjectMapper mapper = new ObjectMapper(); + private long studentId; + + @BeforeEach + void setUp() { + studentId = userRepository.save(User.builder() + .phone(String.valueOf(PHONE.getAndIncrement())) + .nickname("r01a-context-student") + .role(User.Role.STUDENT) + .roles(Set.of(User.Role.STUDENT)) + .active(true).verified(true).build()).getId(); + } + + @AfterEach + void tearDown() { + RequestContextProbe.clear(); + MDC.clear(); + // 隔离修复：精确清理本测试创建的 user（仅本测试记录，不整表删除）， + // 避免残留污染共享 H2 库（integrationdb）中后运行的其他集成测试类。 + if (studentId > 0) { + userRepository.findById(studentId).ifPresent(userRepository::delete); + studentId = 0L; + } + } + + // ── 3. 响应头、响应体、MDC、AuditContext 同源 ──────────────── + + @Test + void requestIdIsIdenticalAcrossHeaderBodyMdcAndAuditContext() throws Exception { + String requestId = "r01a-consistent-001"; + + for (MigratedEndpoint endpoint : ENDPOINTS) { + RequestContextProbe.clear(); + MvcResult result = mockMvc.perform(get(endpoint.path()) + .header("Authorization", studentToken()) + .header(REQUEST_ID_HEADER, requestId)) + .andExpect(status().is(endpoint.expectedStatus())) + .andReturn(); + + String where = endpoint.controller() + " " + endpoint.path(); + assertThat(result.getResponse().getHeader(REQUEST_ID_HEADER)) + .as("%s：响应头", where).isEqualTo(requestId); + assertThat(bodyRequestId(result)) + .as("%s：响应体 requestId", where).isEqualTo(requestId); + assertThat(RequestContextProbe.MDC_VALUE.get()) + .as("%s：MDC requestId", where).isEqualTo(requestId); + assertThat(RequestContextProbe.AUDIT_VALUE.get()) + .as("%s：AuditContext requestId", where).isEqualTo(requestId); + } + } + + @Test + void overlongRequestIdIsBoundedAndStillConsistentEverywhere() throws Exception { + String overlong = "L".repeat(120); + + RequestContextProbe.clear(); + MvcResult result = mockMvc.perform(get("/profile/me/privacy") + .header("Authorization", studentToken()) + .header(REQUEST_ID_HEADER, overlong)) + .andExpect(status().isOk()) + .andReturn(); + + String expected = overlong.substring(0, 32); + assertThat(result.getResponse().getHeader(REQUEST_ID_HEADER)).isEqualTo(expected); + assertThat(bodyRequestId(result)).isEqualTo(expected); + assertThat(RequestContextProbe.MDC_VALUE.get()).isEqualTo(expected); + assertThat(RequestContextProbe.AUDIT_VALUE.get()).isEqualTo(expected); + assertThat(bodyRequestId(result)).isNotEqualTo(overlong); + } + + // ── 4. 并发不串号 ──────────────────────────────────────────── + + @Test + void concurrentRequestsDoNotLeakRequestIdAcrossThreads() throws Exception { + int concurrency = 8; + ExecutorService pool = Executors.newFixedThreadPool(concurrency); + CountDownLatch start = new CountDownLatch(1); + ConcurrentLinkedQueue failures = new ConcurrentLinkedQueue<>(); + + try { + List> futures = new ArrayList<>(); + for (int i = 0; i < concurrency; i++) { + String expected = "r01a-concurrent-" + i; + futures.add(pool.submit(() -> { + try { + start.await(); + MvcResult result = mockMvc.perform(get("/profile/me/preferences") + .header("Authorization", studentToken()) + .header(REQUEST_ID_HEADER, expected)) + .andExpect(status().isOk()) + .andReturn(); + String header = result.getResponse().getHeader(REQUEST_ID_HEADER); + String body = bodyRequestId(result); + if (!expected.equals(header) || !expected.equals(body)) { + failures.add(expected + " -> header=" + header + ", body=" + body); + } + } catch (Exception e) { + failures.add(expected + " -> " + e); + } + return null; + })); + } + start.countDown(); + for (var future : futures) { + future.get(60, TimeUnit.SECONDS); + } + } finally { + pool.shutdownNow(); + } + + assertThat(failures).as("并发请求不得互相串用 requestId").isEmpty(); + } + + // ── 5. 过滤器结束后清理 MDC ───────────────────────────────── + + @Test + void mdcIsClearedAfterRequestCompletes() throws Exception { + mockMvc.perform(get("/profile/me/privacy") + .header("Authorization", studentToken()) + .header(REQUEST_ID_HEADER, "r01a-mdc-cleanup")) + .andExpect(status().isOk()); + + assertThat(MDC.get(RequestIdFilter.REQUEST_ID_ATTRIBUTE)) + .as("请求结束后不得残留 requestId").isNull(); + } + + // ── 6./7. 非法 principal → 401，不回显 principal ────────────── + + @Test + void illegalPrincipalsReturn401InsteadOf500AndNeverEchoThePrincipal() throws Exception { + List cases = List.of( + new PrincipalCase("匿名令牌", new AnonymousAuthenticationToken( + "r01a-key", "anonymousUser", AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"))), + new PrincipalCase("已认证但名称为 anonymousUser", + UsernamePasswordAuthenticationToken.authenticated("anonymousUser", null, List.of())), + new PrincipalCase("空白主体", + UsernamePasswordAuthenticationToken.authenticated(" ", null, List.of())), + new PrincipalCase("非数字主体", + UsernamePasswordAuthenticationToken.authenticated(BAD_PRINCIPAL, null, List.of())), + new PrincipalCase("Unicode 数字主体", + UsernamePasswordAuthenticationToken.authenticated("٤٢", null, List.of())), + new PrincipalCase("带正号主体", + UsernamePasswordAuthenticationToken.authenticated("+42", null, List.of())), + new PrincipalCase("带负号主体", + UsernamePasswordAuthenticationToken.authenticated("-7", null, List.of())), + new PrincipalCase("零主体", + UsernamePasswordAuthenticationToken.authenticated("0", null, List.of())), + new PrincipalCase("负数主体", + UsernamePasswordAuthenticationToken.authenticated("-1", null, List.of())), + new PrincipalCase("Long 溢出主体", + UsernamePasswordAuthenticationToken.authenticated("99999999999999999999", null, List.of()))); + + for (PrincipalCase principalCase : cases) { + MvcResult result = mockMvc.perform(get("/profile/me/privacy") + .with(authentication(principalCase.authentication())) + .header(REQUEST_ID_HEADER, "r01a-bad-principal")) + .andReturn(); + + String as = principalCase.label(); + assertThat(result.getResponse().getStatus()) + .as("%s：必须是 401 而不是 5xx（迁移前会因 NumberFormatException 逃逸为 500）", as) + .isEqualTo(401); + assertThat(result.getResponse().getContentAsString()) + .as("%s：错误响应不得回显 principal", as) + .doesNotContain(BAD_PRINCIPAL) + .doesNotContain("anonymousUser") + .doesNotContain("NumberFormatException") + .doesNotContain("at com.mydreamjob"); + } + } + + @Test + void noCredentialsAtAllReturns401WithoutServerError() throws Exception { + MvcResult result = mockMvc.perform(get("/profile/me/privacy") + .header(REQUEST_ID_HEADER, "r01a-no-credentials")) + .andReturn(); + + assertThat(result.getResponse().getStatus()).isEqualTo(401); + assertThat(result.getResponse().getContentAsString()).doesNotContain("at com.mydreamjob"); + } + + /** + * 反例边界：一个「非匿名但 isAuthenticated()==false」的合成令牌会在**安全过滤器链** + * 就被判定为拒绝（403），根本到不了 Controller 与 {@code CurrentUserAccessor}。 + * + *

    这是迁移前既有的链行为，R01-A 明确不把原 403 改成 401。此处只锁定 + * 「不是 5xx、不回显 principal」，避免为了凑一个 401 而改动安全语义。

    + */ + @Test + void syntheticUnauthenticatedTokenIsRejectedByChainWithoutServerError() throws Exception { + Authentication synthetic = new UsernamePasswordAuthenticationToken(BAD_PRINCIPAL, null); + + MvcResult result = mockMvc.perform(get("/profile/me/privacy") + .with(authentication(synthetic)) + .header(REQUEST_ID_HEADER, "r01a-synthetic")) + .andReturn(); + + int status = result.getResponse().getStatus(); + assertThat(status) + .as("必须是 4xx 客户端拒绝，不得是 5xx") + .isBetween(400, 499) + .isNotEqualTo(200); + assertThat(result.getResponse().getContentAsString()) + .as("错误响应不得回显 principal") + .doesNotContain(BAD_PRINCIPAL) + .doesNotContain("at com.mydreamjob"); + } + + private record PrincipalCase(String label, Authentication authentication) { + } + + // ── 9. 拒绝请求无业务写入 ──────────────────────────────────── + + @Test + void rejectedRequestsPerformNoBusinessWrite() throws Exception { + List tables = List.of( + new BusinessTable("student_privacy_settings", "student_user_id"), + new BusinessTable("student_preferences", "student_user_id"), + new BusinessTable("resume_versions", "user_id"), + new BusinessTable("personal_data_export_tasks", "user_id"), + new BusinessTable("assessment_attempts", "student_user_id"), + new BusinessTable("ability_attempts", "student_user_id")); + var before = rowCounts(tables, studentId); + + mockMvc.perform(get("/profile/me/privacy") + .with(authentication(UsernamePasswordAuthenticationToken.authenticated( + BAD_PRINCIPAL, null, List.of())))) + .andExpect(status().isUnauthorized()); + mockMvc.perform(get("/profile/me/privacy")) + .andExpect(status().isUnauthorized()); + mockMvc.perform(get("/profile/me/preferences") + .with(authentication(new AnonymousAuthenticationToken( + "r01a-key", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"))))) + .andExpect(status().isUnauthorized()); + + assertThat(rowCounts(tables, studentId)) + .as("被拒绝的请求不得写入任何业务表") + .isEqualTo(before); + } + + private record BusinessTable(String name, String ownerColumn) { + } + + private List rowCounts(List tables, long userId) { + List counts = new ArrayList<>(); + for (BusinessTable table : tables) { + Long count = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM " + table.name() + " WHERE " + table.ownerColumn() + " = ?", + Long.class, userId); + counts.add(table.name() + "=" + count); + } + return counts; + } + + // ── 辅助 ───────────────────────────────────────────────────── + + private String studentToken() { + return TestAuthTokens.bearer(studentId, "STUDENT"); + } + + private String bodyRequestId(MvcResult result) throws Exception { + JsonNode root = mapper.readTree(result.getResponse().getContentAsString()); + JsonNode requestId = root.get("requestId"); + return requestId == null ? null : requestId.asText(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestIdAccessorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestIdAccessorTest.java new file mode 100644 index 0000000..85e6874 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/logging/RequestIdAccessorTest.java @@ -0,0 +1,150 @@ +package com.mydreamjob.common.logging; + +import jakarta.servlet.http.HttpServletRequest; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; + +import java.util.concurrent.atomic.AtomicReference; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * R01-A requestId 读取器边界。 + * + *

    核心约束：accessor 只能复用 {@link RequestIdFilter} 产出的规范化值， + * 不得自建第二套生成规则，也不得把超长/非法客户端头原样返回。

    + */ +class RequestIdAccessorTest { + + private final RequestIdFilter filter = new RequestIdFilter(); + private final RequestIdAccessor accessor = new RequestIdAccessor(); + + // ── 1. 合法客户端 requestId 原样使用 ──────────────────────── + + @Test + void legalClientRequestIdIsUsedVerbatimAcrossAllOutputs() throws Exception { + String clientId = "client-abc_123"; + MockHttpServletRequest request = new MockHttpServletRequest(); + request.addHeader(RequestIdFilter.REQUEST_ID_HEADER, clientId); + MockHttpServletResponse response = new MockHttpServletResponse(); + AtomicReference seenByController = new AtomicReference<>(); + AtomicReference seenInMdc = new AtomicReference<>(); + + filter.doFilter(request, response, (wrapped, ignored) -> { + HttpServletRequest req = (HttpServletRequest) wrapped; + seenByController.set(accessor.get(req)); + seenInMdc.set(org.slf4j.MDC.get(RequestIdFilter.REQUEST_ID_ATTRIBUTE)); + }); + + assertEquals(clientId, seenByController.get(), "合法客户端值必须原样使用"); + assertEquals(seenByController.get(), response.getHeader(RequestIdFilter.REQUEST_ID_HEADER), + "响应头必须与 Controller 读到的一致"); + assertEquals(seenByController.get(), seenInMdc.get(), "MDC 必须与 Controller 读到的一致"); + } + + // ── 2. 缺失 / 空白 / 超长时使用过滤器规范化值 ──────────────── + + @Test + void missingBlankAndOverlongIdsUseFilterNormalizedValue() throws Exception { + record Case(String header, int expectedLength, String label) { + } + Case[] cases = { + new Case(null, 16, "缺失"), + new Case(" ", 16, "纯空白"), + new Case("\t", 16, "制表符"), + new Case("x".repeat(33), 32, "刚好超一位"), + new Case("y".repeat(200), 32, "远超声明的 32 字符上限"), + }; + + for (Case testCase : cases) { + MockHttpServletRequest request = new MockHttpServletRequest(); + if (testCase.header() != null) { + request.addHeader(RequestIdFilter.REQUEST_ID_HEADER, testCase.header()); + } + MockHttpServletResponse response = new MockHttpServletResponse(); + AtomicReference seenByController = new AtomicReference<>(); + + filter.doFilter(request, response, (wrapped, ignored) -> + seenByController.set(accessor.get((HttpServletRequest) wrapped))); + + String value = seenByController.get(); + assertNotNull(value, testCase.label() + "：必须有值"); + assertEquals(testCase.expectedLength(), value.length(), testCase.label() + "：长度必须被收敛"); + assertEquals(response.getHeader(RequestIdFilter.REQUEST_ID_HEADER), value, + testCase.label() + "：与响应头同源"); + if (testCase.header() == null) { + continue; + } + assertNotEquals(testCase.header(), value, testCase.label() + "：不得原样回显客户端头"); + } + } + + @ParameterizedTest + @ValueSource(strings = { + "bad id", "bad\tid", "bad\nid", "bad\rid", "中文", "", "a b")) { + for (String path : PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(principal("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("\r").doesNotContain("\n") + .doesNotContain("<").doesNotContain(">").doesNotContain(" "); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + assertThat(r.getResponse().getHeader("Injected")).isNull(); + String body = r.getResponse().getContentAsString(); + assertThat(body).contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("独立复验：真实 Accessor bean 可解析合法主体") + void realAccessor_resolvesLegalPrincipal() { + var ctx = org.springframework.security.core.context.SecurityContextHolder.createEmptyContext(); + ctx.setAuthentication(principal("42")); + var prev = org.springframework.security.core.context.SecurityContextHolder.getContext(); + org.springframework.security.core.context.SecurityContextHolder.setContext(ctx); + try { + assertThat(realCurrentUserAccessor.requireUserId()).isEqualTo(42L); + } finally { + org.springframework.security.core.context.SecurityContextHolder.setContext(prev); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a2/RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a2/RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..ac20570 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a2/RequestContextMigrationIntegrationTest.java @@ -0,0 +1,269 @@ +package com.mydreamjob.common.r01a2; + +import com.mydreamjob.application.ApplicationService; +import com.mydreamjob.candidatescore.CandidateScoringEngineService; +import com.mydreamjob.candidatescore.dashboard.CompanyScoringDashboardService; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.interview.InterviewService; +import com.mydreamjob.messaging.MessagingService; +import com.mydreamjob.offer.OfferService; +import org.junit.jupiter.api.DisplayName; +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.data.redis.core.ValueOperations; +import org.springframework.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.request.RequestPostProcessor; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A2 第二批：请求身份与 requestId 收束的特征测试。 + * + *

    覆盖 8 个 Controller 的代表端点：身份只来自 + * {@code CurrentUserAccessor#requireUserId()}，requestId 只来自 + * {@code RequestIdAccessor#get(HttpServletRequest)}。

    + * + *

    身份边界要求：任何非法主体统一 HTTP 401（不是 500，也不是 400）， + * 响应不回显 principal，失败请求不产生业务写入。

    + * + *

    requestId 边界要求：规范化后的值与响应头、响应体同源；超长值被既有规则收敛； + * 空白值重新生成；恶意换行/异常字符不得进入响应。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class RequestContextMigrationIntegrationTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private ApplicationService applicationService; + @MockBean private CompanyService companyService; + @MockBean private MessagingService messagingService; + @MockBean private OfferService offerService; + @MockBean private InterviewService interviewService; + @MockBean private CandidateScoringEngineService candidateScoringEngineService; + @MockBean private CompanyScoringDashboardService dashboardService; + @MockBean private RedisTemplate redisTemplate; + + /** 8 个 Controller 的一个代表端点。 */ + private record Endpoint(String name, String path) {} + + private static final List ENDPOINTS = List.of( + new Endpoint("ApplicationController", "/applications/me"), + new Endpoint("CompanyController", "/companies/me"), + new Endpoint("MessagingController", "/conversations"), + new Endpoint("OfferController", "/offers"), + new Endpoint("InterviewController", "/interviews/me"), + new Endpoint("CandidateScoringController", "/profile/me/candidate-scoring"), + new Endpoint("CandidateScoreCardController", "/profile/me/candidate-score-card"), + new Endpoint("CompanyScoringDashboardController", "/company/scoring/dashboard/overview")); + + // ── 身份边界 ───────────────────────────────────────────── + + private static Authentication auth(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + private static RequestPostProcessor as(Authentication a) { + return authentication(a); + } + + /** 非法主体集合：名称 null/空/匿名/非数字/溢出/零/负。 */ + private static List illegalPrincipals() { + return List.of( + new UsernamePasswordAuthenticationToken("", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("anonymousUser", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("not-a-number", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("99999999999999999999999", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("0", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("-5", "n/a", AuthorityUtils.NO_AUTHORITIES), + new UsernamePasswordAuthenticationToken("+42", "n/a", AuthorityUtils.NO_AUTHORITIES), + new AnonymousAuthenticationToken("key", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"))); + } + + @Test + @DisplayName("非法主体一律返回 401，且不回显 principal") + void illegalPrincipals_alwaysReturn401_withoutEchoingPrincipal() throws Exception { + for (Endpoint ep : ENDPOINTS) { + for (Authentication bad : illegalPrincipals()) { + String principal = String.valueOf(bad.getName()); + var result = mockMvc.perform(get(ep.path()).with(as(bad))) + .andReturn(); + int status = result.getResponse().getStatus(); + String body = result.getResponse().getContentAsString(); + + assertThat(status) + .as("%s %s 非法主体 '%s' 必须返回 401（实际 %d）", ep.name(), ep.path(), principal, status) + .isEqualTo(401); + // 只对"有辨识度的主体名"断言不回显；单字符/纯数字主体会与 JSON 中的 + // 状态码、时间戳、requestId 等合法数字碰撞，不构成回显证据。 + if (principal.length() >= 3 && !principal.chars().allMatch(Character::isDigit)) { + assertThat(body) + .as("%s 响应不得回显 principal '%s'", ep.name(), principal) + .doesNotContain(principal); + } + // 两条合法拒绝路径的文案不同：匿名 token 由 SecurityFilterChain 在进入 + // Controller 之前拦截（AuthenticationEntryPoint），其余非法主体由 + // CurrentUserAccessor 抛出；两者都必须是固定安全文案。 + assertThat(body) + .as("%s 响应必须使用固定安全文案（实际：%s）", ep.name(), body) + .satisfiesAnyOf( + b -> assertThat(b).contains("authentication required"), + b -> assertThat(b).contains("not authenticated")); + assertThat(body).doesNotContain("NumberFormatException"); + assertThat(body).doesNotContain("java.lang"); + assertThat(body).doesNotContain("ClassCastException"); + } + } + } + + @Test + @DisplayName("null Authentication 返回 401") + void nullAuthentication_returns401() throws Exception { + for (Endpoint ep : ENDPOINTS) { + mockMvc.perform(get(ep.path())) + .andExpect(status().isUnauthorized()); + } + } + + @Test + @DisplayName("合法数字主体不被身份层拒绝（不返回 401/500）") + void legalPrincipal_isNotRejectedByIdentityLayer() throws Exception { + // 合法数字主体必须能通过身份层；下游 @MockBean 服务未 stub 导致的 5xx + // 属测试夹具范畴，因此只断言"不被身份层拒绝（非 401）"。 + for (Endpoint ep : ENDPOINTS) { + int status = mockMvc.perform(get(ep.path()).with(as(auth("42")))) + .andReturn().getResponse().getStatus(); + assertThat(status) + .as("%s 合法主体不得被身份层判为未登录（实际 %d）", ep.name(), status) + .isNotEqualTo(401); + } + } + + @Test + @DisplayName("失败请求不产生业务写入") + void failedRequests_produceNoBusinessWrites() throws Exception { + for (Endpoint ep : ENDPOINTS) { + mockMvc.perform(get(ep.path()).with(as(auth("not-a-number")))) + .andExpect(status().isUnauthorized()); + } + // 身份解析在任何 Service 调用之前失败 → 各 Service 不应被触达 + org.mockito.Mockito.verifyNoInteractions( + applicationService, companyService, messagingService, offerService, + interviewService, candidateScoringEngineService, dashboardService); + } + + // ── requestId 边界 ─────────────────────────────────────── + + private void assertRequestIdConsistent(String path, String sent, String expectedOrNull) throws Exception { + var result = mockMvc.perform(get(path).header("X-Request-Id", sent).with(as(auth("42")))) + .andReturn(); + String responseHeader = result.getResponse().getHeader("X-Request-Id"); + assertThat(responseHeader).as("响应头必须带 X-Request-Id，path=%s", path).isNotNull(); + if (expectedOrNull != null) { + assertThat(responseHeader).as("合法值应原样同源").isEqualTo(expectedOrNull); + } + String body = result.getResponse().getContentAsString(); + String fromBody = body.replaceAll("(?s).*\"requestId\"\\s*:\\s*\"([^\"]*)\".*", "$1"); + assertThat(fromBody) + .as("响应体 requestId 必须与响应头同源") + .isEqualTo(responseHeader); + } + + @Test + @DisplayName("requestId：合法值原样同源（响应头 == 响应体）") + void requestId_legalValue_isEchoedConsistently() throws Exception { + for (Endpoint ep : ENDPOINTS) { + assertRequestIdConsistent(ep.path(), "r01a2-legal-0001", "r01a2-legal-0001"); + } + } + + @Test + @DisplayName("requestId：超长值经既有规范化收敛（<=32）且同源") + void requestId_overlongValue_isNormalizedConsistently() throws Exception { + String overlong = "a".repeat(120); + for (Endpoint ep : ENDPOINTS) { + var result = mockMvc.perform(get(ep.path()).header("X-Request-Id", overlong).with(as(auth("42")))) + .andReturn(); + String header = result.getResponse().getHeader("X-Request-Id"); + assertThat(header).isNotNull(); + assertThat(header.length()).as("超长值必须被收敛到 32 以内").isLessThanOrEqualTo(32); + assertThat(header).isEqualTo(overlong.substring(0, 32)); + String body = result.getResponse().getContentAsString(); + assertThat(body).doesNotContain(overlong); + } + } + + @Test + @DisplayName("requestId：空白值重新生成") + void requestId_blankValue_isRegenerated() throws Exception { + for (Endpoint ep : ENDPOINTS) { + var result = mockMvc.perform(get(ep.path()).header("X-Request-Id", " ").with(as(auth("42")))) + .andReturn(); + String header = result.getResponse().getHeader("X-Request-Id"); + assertThat(header).as("空白值必须重新生成").isNotBlank(); + assertThat(header.trim()).isEqualTo(header); + } + } + + @Test + @DisplayName("requestId：恶意换行/异常字符不得进入响应与日志") + void requestId_maliciousCharacters_neverReachResponse() throws Exception { + // 注：CR/LF 会在 MockMvc 客户端层就被拒绝（请求根本发不出去）， + // 因此这里覆盖"能被 HTTP 头承载、但会被规范化规则拒绝"的字符集。 + List malicious = List.of( + "", + "id;DROP TABLE users", + "abc\tdef", + "héllo-wörld", + "a b c"); + + for (Endpoint ep : ENDPOINTS) { + for (String bad : malicious) { + var result = mockMvc.perform(get(ep.path()).header("X-Request-Id", bad).with(as(auth("42")))) + .andReturn(); + String header = result.getResponse().getHeader("X-Request-Id"); + assertThat(header).as("必须生成合法替代值").isNotNull().isNotBlank(); + assertThat(header).doesNotContain("<").doesNotContain(">") + .doesNotContain(";").doesNotContain(" ").doesNotContain("\t"); + assertThat(result.getResponse().getHeader("X-Injected")).isNull(); + String body = result.getResponse().getContentAsString(); + assertThat(body).doesNotContain(bad); + assertThat(body).contains("\"requestId\":\"" + header + "\""); + } + } + } + + @Test + @DisplayName("错误响应也携带同源 requestId") + void errorResponse_carriesSameRequestId() throws Exception { + var result = mockMvc.perform(get("/applications/me") + .header("X-Request-Id", "r01a2-err-0001") + .with(as(auth("bogus")))) + .andReturn(); + assertThat(result.getResponse().getStatus()).isEqualTo(401); + assertThat(result.getResponse().getHeader("X-Request-Id")).isEqualTo("r01a2-err-0001"); + assertThat(result.getResponse().getContentAsString()).contains("r01a2-err-0001"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3AccessorWiringProbeTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3AccessorWiringProbeTest.java new file mode 100644 index 0000000..9ab4625 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3AccessorWiringProbeTest.java @@ -0,0 +1,128 @@ +package com.mydreamjob.common.r01a3; + +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.deletion.AccountDeletionService; +import com.mydreamjob.notification.NotificationService; +import com.mydreamjob.recommendation.JobRecommendationService; +import com.mydreamjob.risk.RiskGovernanceService; +import com.mydreamjob.safety.BlockService; +import com.mydreamjob.safety.ReportService; +import com.mydreamjob.security.CurrentUserAccessor; +import com.mydreamjob.verification.CompanyVerificationService; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A3 独立复验：**接线变异检测**。 + * + *

    将 {@code CurrentUserAccessor} / {@code RequestIdAccessor} 替换为 mock，证明 + * 8 个 Controller 确实调用了这两个既有 bean。若某 Controller 仍保留自有解析 + * （未接线），mock 抛未登录异常时它不会返回 401，测试即失败。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A3AccessorWiringProbeTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + + @MockBean private AccountDeletionService accountDeletionService; + @MockBean private CompanyVerificationService verificationService; + @MockBean private RiskGovernanceService riskGovernanceService; + @MockBean private ReportService reportService; + @MockBean private BlockService blockService; + @MockBean private NotificationService notificationService; + @MockBean private JobRecommendationService jobRecommendationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private static final List PATHS = List.of( + "/profile/me/deletion", + "/companies/me/verification", + "/admin/scoring/risk/overview", + "/admin/reports", + "/reports/me", + "/blocks/me", + "/notifications", + "/profile/me/job-recommendations"); + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + @Test + @DisplayName("A3 接线检测：Accessor 抛未登录时八端点必须 401") + void accessorThrowsUnauthenticated_endpointsReturn401() throws Exception { + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + for (String path : PATHS) { + int st = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s 若未接线 Accessor，不会是 401", path).isEqualTo(401); + } + verify(currentUserAccessor, times(PATHS.size())).requireUserId(); + } + + @Test + @DisplayName("A3 接线检测：响应体 requestId 来自 Accessor mock") + void requestIdComesFromAccessorBean() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(42L); + when(requestIdAccessor.get(any())).thenReturn("a3-probe-from-accessor"); + + for (String path : PATHS) { + String body = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).as("path=%s 响应体 requestId 应来自 Accessor", path) + .contains("\"requestId\":\"a3-probe-from-accessor\""); + } + Mockito.verify(requestIdAccessor, Mockito.atLeastOnce()).get(any()); + } + + @Test + @DisplayName("A3 接线检测：合法主体经 Accessor 后可达 Service") + void legalPrincipalReachesService() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(42L); + when(requestIdAccessor.get(any())).thenReturn("a3-probe"); + + mockMvc.perform(get("/notifications").with(authentication(LEGAL))).andReturn(); + + verify(notificationService).list(eq(42L), anyInt(), anyInt()); + } + + @Test + @DisplayName("A3 接线检测：无 Token 仍 401（Security 链，不经 Controller）") + void noToken_is401() throws Exception { + for (String path : PATHS) { + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3IndependentVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3IndependentVerificationTest.java new file mode 100644 index 0000000..e23c3f7 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/A3IndependentVerificationTest.java @@ -0,0 +1,220 @@ +package com.mydreamjob.common.r01a3; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.deletion.AccountDeletionService; +import com.mydreamjob.notification.NotificationService; +import com.mydreamjob.recommendation.JobRecommendationService; +import com.mydreamjob.risk.RiskGovernanceService; +import com.mydreamjob.safety.BlockService; +import com.mydreamjob.safety.ReportService; +import com.mydreamjob.verification.CompanyVerificationService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A3 独立复验（不复用实施者的测试类与断言）。 + * + *

    超长/溢出主体不做整响应数字搜索，解析 JSON 后仅检查业务字段。

    + * + *

    说明：无 Token 请求由 Security 链提前返回 401，本批不要求其携带 requestId， + * 因此对该类请求**只断言 401**。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A3IndependentVerificationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private RequestIdAccessor requestIdAccessor; + + @MockBean private AccountDeletionService accountDeletionService; + @MockBean private CompanyVerificationService verificationService; + @MockBean private RiskGovernanceService riskGovernanceService; + @MockBean private ReportService reportService; + @MockBean private BlockService blockService; + @MockBean private NotificationService notificationService; + @MockBean private JobRecommendationService jobRecommendationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final List PATHS = List.of( + "/profile/me/deletion", + "/companies/me/verification", + "/admin/scoring/risk/overview", + "/admin/reports", + "/reports/me", + "/blocks/me", + "/notifications", + "/profile/me/job-recommendations"); + + private static final List ILLEGAL = List.of( + "anonymousUser", "", " ", "not-a-number", "abc123", + "12345678901234567890", "0", "-1"); + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + @Test + @DisplayName("独立复验：八端点 × 八非法主体 一律 401、无 500") + void illegalPrincipals_are401_never500() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + int st = mockMvc.perform(get(path).with(authentication(principal(p)))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s principal='%s'", path, p).isEqualTo(401); + } + } + } + + @Test + @DisplayName("独立复验：匿名 token 与无 Token 均 401（无 Token 只断言 401）") + void anonymousAndNoToken_are401() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (String path : PATHS) { + assertThat(mockMvc.perform(get(path).with(authentication(anon))).andReturn() + .getResponse().getStatus()).as(path).isEqualTo(401); + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } + + @Test + @DisplayName("独立复验：错误体安全，不回显非数字标记/类名/堆栈") + void errorBody_isSafe() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + String body = mockMvc.perform(get(path).with(authentication(principal(p)))) + .andReturn().getResponse().getContentAsString(); + JsonNode json = MAPPER.readTree(body); + assertThat(json.path("code").asInt()).as("path=%s", path).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg).doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("at com.mydreamjob"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + } + + @Test + @DisplayName("独立复验：Long 溢出主体无 NumberFormatException") + void overflow_hasNoNumberFormatException() throws Exception { + for (String path : PATHS) { + String body = mockMvc.perform(get(path) + .with(authentication(principal("12345678901234567890")))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).doesNotContain("NumberFormatException"); + } + } + + @Test + @DisplayName("独立复验：合法主体不被身份层拒绝") + void legalPrincipal_notRejectedByIdentity() throws Exception { + for (String path : PATHS) { + int st = mockMvc.perform(get(path).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s", path).isNotEqualTo(401); + } + } + + @Test + @DisplayName("独立复验：角色层拒绝仍映射 403（身份通过后由角色层裁决）") + void roleDenial_stillMapsTo403() throws Exception { + when(redisTemplate.opsForValue()) + .thenReturn(org.mockito.Mockito.mock( + org.springframework.data.redis.core.ValueOperations.class)); + + // CompanyVerificationController 的角色裁决委托给 Service，显式让其抛 FORBIDDEN， + // 验证"身份通过之后由角色层裁决"的语义未漂移为 401。 + org.mockito.Mockito.doThrow(new com.mydreamjob.common.exception.BusinessException( + com.mydreamjob.common.exception.ErrorCode.FORBIDDEN)) + .when(verificationService).assertAdminRole(anyLong()); + + int st = mockMvc.perform(get("/admin/companies/verifications") + .with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("角色拒绝必须仍为 403，而非 401").isEqualTo(403); + + // AdminRiskController 的角色裁决在 Controller 内（userRepository → FORBIDDEN） + when(userRepository.findById(anyLong())) + .thenReturn(java.util.Optional.of(com.mydreamjob.auth.User.builder() + .id(7L).phone("1").role(com.mydreamjob.auth.User.Role.STUDENT) + .roles(java.util.Set.of(com.mydreamjob.auth.User.Role.STUDENT)) + .active(true).build())); + int st2 = mockMvc.perform(get("/admin/scoring/risk/overview") + .with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st2).as("非 ADMIN 必须仍为 403，而非 401").isEqualTo(403); + } + + @Test + @DisplayName("独立复验：request attribute 优先于原始 header") + void requestAttributeWins() { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.setAttribute(com.mydreamjob.common.logging.RequestIdFilter.REQUEST_ID_ATTRIBUTE, "attr-a3-wins"); + req.addHeader("X-Request-Id", "header-a3-loses"); + assertThat(requestIdAccessor.get(req)).isEqualTo("attr-a3-wins"); + } + + @Test + @DisplayName("独立复验：响应 body 使用规范化 requestId（与响应头同源）") + void responseBodyUsesNormalizedRequestId() throws Exception { + for (String sent : List.of("a3v-legal-1", " ", "z".repeat(90), "x", "a b")) { + for (String path : PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(principal("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("<").doesNotContain(">").doesNotContain(" ") + .doesNotContain("\r").doesNotContain("\n"); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + String body = r.getResponse().getContentAsString(); + assertThat(body).as("path=%s", path) + .contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("独立复验：CR/LF 不入规范化结果（直接经 Accessor）") + void crlfNeverEntersValue() { + for (String bad : List.of("a\rb", "a\nb", "a\r\nb", "\r", "\n", "x\r\nInjected: 1")) { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.addHeader("X-Request-Id", bad); + String v = requestIdAccessor.get(req); + assertThat(v).as("输入 %s", bad).isNotBlank() + .doesNotContain("\r").doesNotContain("\n"); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/R01A3RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/R01A3RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..da611ee --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a3/R01A3RequestContextMigrationIntegrationTest.java @@ -0,0 +1,195 @@ +package com.mydreamjob.common.r01a3; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.deletion.AccountDeletionService; +import com.mydreamjob.notification.NotificationService; +import com.mydreamjob.recommendation.JobRecommendationService; +import com.mydreamjob.risk.RiskGovernanceService; +import com.mydreamjob.safety.BlockService; +import com.mydreamjob.safety.ReportService; +import com.mydreamjob.security.CurrentUserAccessor; +import com.mydreamjob.verification.CompanyVerificationService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A3 第三批：请求身份与 requestId 收束的特征测试。 + * + *

    覆盖 8 个 Controller 的代表端点（以源码真实 Mapping 为准）。

    + * + *

    对溢出/非数字主体**不做整响应数字子串搜索**，而是解析 JSON 后只检查业务字段。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01A3RequestContextMigrationIntegrationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private RequestIdAccessor requestIdAccessor; + + @MockBean private AccountDeletionService accountDeletionService; + @MockBean private CompanyVerificationService verificationService; + @MockBean private RiskGovernanceService riskGovernanceService; + @MockBean private ReportService reportService; + @MockBean private BlockService blockService; + @MockBean private NotificationService notificationService; + @MockBean private JobRecommendationService jobRecommendationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + /** 8 个 Controller 的真实代表端点。 */ + private static final List PATHS = List.of( + "/profile/me/deletion", // AccountDeletionController + "/companies/me/verification", // CompanyVerificationController + "/admin/scoring/risk/overview", // AdminRiskController + "/admin/reports", // AdminReportController + "/reports/me", // ReportController + "/blocks/me", // BlockController + "/notifications", // NotificationController + "/profile/me/job-recommendations"); // JobRecommendationController + + private static final List ILLEGAL = List.of( + "anonymousUser", "", " ", "not-a-number", "abc123", + "12345678901234567890", "0", "-1"); + + private static Authentication auth(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + // ── 身份矩阵 ───────────────────────────────────────────── + + @Test + @DisplayName("A3：八端点 × 八非法主体 一律 401（非 400/500）") + void illegalPrincipals_areAlways401() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + int st = mockMvc.perform(get(path).with(authentication(auth(p)))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s principal='%s' 必须 401", path, p).isEqualTo(401); + } + } + } + + @Test + @DisplayName("A3：匿名 token 与无认证均 401") + void anonymousAndMissing_are401() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (String path : PATHS) { + assertThat(mockMvc.perform(get(path).with(authentication(anon))).andReturn() + .getResponse().getStatus()).as(path).isEqualTo(401); + assertThat(mockMvc.perform(get(path)).andReturn().getResponse().getStatus()) + .as(path).isEqualTo(401); + } + } + + @Test + @DisplayName("A3：错误体为固定安全文案，不回显类名/堆栈/principal") + void errorBody_isSafeAndDoesNotEchoPrincipal() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + String body = mockMvc.perform(get(path).with(authentication(auth(p)))) + .andReturn().getResponse().getContentAsString(); + JsonNode json = MAPPER.readTree(body); + assertThat(json.path("code").asInt()).as("path=%s", path).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg).doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("at com.mydreamjob"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + // 非数字标记不回显（纯数字主体与状态码/时间戳碰撞，不参与此断言） + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + } + + @Test + @DisplayName("A3：溢出主体不产生 NumberFormatException（响应中无该异常）") + void overflowPrincipal_hasNoNumberFormatException() throws Exception { + for (String path : PATHS) { + String body = mockMvc.perform(get(path) + .with(authentication(auth("12345678901234567890")))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).doesNotContain("NumberFormatException"); + } + } + + @Test + @DisplayName("A3：合法主体继续进入原角色/归属检查（不被身份层拒绝）") + void legalPrincipal_reachesRoleLayer() throws Exception { + for (String path : PATHS) { + int st = mockMvc.perform(get(path).with(authentication(auth("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s 合法主体不应 401", path).isNotEqualTo(401); + } + } + + // ── requestId 矩阵 ─────────────────────────────────────── + + @Test + @DisplayName("A3：requestId 合法/空白/超长/非法字符 均同源") + void requestId_consistentAcrossInputs() throws Exception { + for (String sent : List.of("a3-legal-0001", " ", "y".repeat(80), "", "a b")) { + for (String path : PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(auth("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("\r").doesNotContain("\n") + .doesNotContain("<").doesNotContain(">").doesNotContain(" "); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + String body = r.getResponse().getContentAsString(); + assertThat(body).as("path=%s 响应体 requestId 应与响应头同源", path) + .contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("A3：已存在规范化 request attribute 时以 attribute 为准") + void requestAttributeWinsOverHeader() { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.setAttribute(com.mydreamjob.common.logging.RequestIdFilter.REQUEST_ID_ATTRIBUTE, "attr-wins"); + req.addHeader("X-Request-Id", "header-loses"); + assertThat(requestIdAccessor.get(req)).isEqualTo("attr-wins"); + } + + @Test + @DisplayName("A3：CR/LF 不进入规范化结果（直接调用 Accessor）") + void crlfNeverEntersNormalizedValue() { + for (String bad : List.of("a\rb", "a\nb", "a\r\nb", "\r", "\n", "a\r\nX-Injected: 1")) { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.addHeader("X-Request-Id", bad); + String v = requestIdAccessor.get(req); + assertThat(v).as("输入 %s", bad).isNotBlank() + .doesNotContain("\r").doesNotContain("\n"); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringIndependentTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringIndependentTest.java new file mode 100644 index 0000000..9659adf --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringIndependentTest.java @@ -0,0 +1,125 @@ +package com.mydreamjob.common.r01a4; + +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.bidirectionalmatch.BidirectionalMatchService; +import com.mydreamjob.bidirectionalmatch.MatchConversationService; +import com.mydreamjob.bidirectionalmatch.MatchRuleService; +import com.mydreamjob.careerprogress.CareerProgressService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.feedback.CandidateFeedbackService; +import com.mydreamjob.match.MatchService; +import com.mydreamjob.security.CurrentUserAccessor; +import com.mydreamjob.talentdiscovery.TalentDiscoveryService; +import com.mydreamjob.talentinvitation.TalentInvitationService; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; + +/** R01-A4 独立接线变异检测，包含实施测试遗漏的 POST MatchConversationController。 */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A4AccessorWiringIndependentTest { + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + @MockBean private CandidateFeedbackService feedbackService; + @MockBean private BidirectionalMatchService bidirectionalMatchService; + @MockBean private MatchConversationService matchConversationService; + @MockBean private MatchRuleService matchRuleService; + @MockBean private TalentDiscoveryService talentDiscoveryService; + @MockBean private CareerProgressService careerProgressService; + @MockBean private MatchService matchService; + @MockBean private TalentInvitationService talentInvitationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + @BeforeEach + void resetMocks() { + Mockito.reset(currentUserAccessor, requestIdAccessor, feedbackService, bidirectionalMatchService, + matchConversationService, matchRuleService, talentDiscoveryService, careerProgressService, + matchService, talentInvitationService); + } + + @Test + @DisplayName("A4 独立接线：8/8 Controller 都调用 CurrentUserAccessor") + void allEightControllersCallCurrentUserAccessor() throws Exception { + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + assertThat(mockMvc.perform(get("/applications/1/feedback").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/applications/1/match").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(post("/applications/1/conversation").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/companies/me/match-rule").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/profile/me/talent-discovery").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/profile/me/career-progress").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/jobs/1/match").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get("/companies/me/talent-invitations").with(authentication(LEGAL))).andReturn().getResponse().getStatus()).isEqualTo(401); + + verify(currentUserAccessor, Mockito.times(8)).requireUserId(); + } + + @Test + @DisplayName("A4 独立接线：8/8 Service 收到 Accessor 返回的唯一 userId") + void allEightServicesReceiveAccessorUserId() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(4242L); + when(requestIdAccessor.get(any())).thenReturn("a4-independent-request"); + when(matchConversationService.createOrGetMatchConversation(4242L, 1L)).thenReturn(Map.of()); + + mockMvc.perform(get("/applications/1/feedback").with(authentication(LEGAL))); + verify(feedbackService).getFeedback(4242L, 1L); + + mockMvc.perform(get("/applications/1/match").with(authentication(LEGAL))); + verify(bidirectionalMatchService).getMatchView(4242L, 1L); + + mockMvc.perform(post("/applications/1/conversation").with(authentication(LEGAL))); + verify(matchConversationService).createOrGetMatchConversation(4242L, 1L); + + mockMvc.perform(get("/companies/me/match-rule").with(authentication(LEGAL))); + verify(matchRuleService).getCompanyRule(4242L); + + mockMvc.perform(get("/profile/me/talent-discovery").with(authentication(LEGAL))); + verify(talentDiscoveryService).getPreference(4242L); + + mockMvc.perform(get("/profile/me/career-progress").with(authentication(LEGAL))); + verify(careerProgressService).getCareerProgress(eq(4242L), anyInt(), anyInt(), any()); + + mockMvc.perform(get("/jobs/1/match").with(authentication(LEGAL))); + verify(matchService).diagnose(eq(4242L), eq(1L), any()); + + mockMvc.perform(get("/companies/me/talent-invitations").with(authentication(LEGAL))); + verify(talentInvitationService).listCompany(eq(4242L), anyInt(), anyInt()); + + verify(currentUserAccessor, Mockito.times(8)).requireUserId(); + verify(requestIdAccessor, Mockito.times(8)).get(any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringProbeTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringProbeTest.java new file mode 100644 index 0000000..46d8f6b --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4AccessorWiringProbeTest.java @@ -0,0 +1,135 @@ +package com.mydreamjob.common.r01a4; + +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.bidirectionalmatch.BidirectionalMatchService; +import com.mydreamjob.bidirectionalmatch.MatchConversationService; +import com.mydreamjob.bidirectionalmatch.MatchRuleService; +import com.mydreamjob.careerprogress.CareerProgressService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.feedback.CandidateFeedbackService; +import com.mydreamjob.match.MatchService; +import com.mydreamjob.security.CurrentUserAccessor; +import com.mydreamjob.talentdiscovery.TalentDiscoveryService; +import com.mydreamjob.talentinvitation.TalentInvitationService; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A4 实施证据：**接线变异检测**。 + * + *

    将两个 Accessor 替换为 mock，证明 8 个 Controller 确实调用了既有 bean： + * 若某 Controller 仍保留自有解析（未接线），mock 抛未登录时它不会返回 401。 + * 因此**删除 Accessor 调用会使本测试失败**。

    + * + *

    本测试属实施阶段证据，不代替后续独立复验。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A4AccessorWiringProbeTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + + @MockBean private CandidateFeedbackService feedbackService; + @MockBean private BidirectionalMatchService bidirectionalMatchService; + @MockBean private MatchConversationService matchConversationService; + @MockBean private MatchRuleService matchRuleService; + @MockBean private TalentDiscoveryService talentDiscoveryService; + @MockBean private CareerProgressService careerProgressService; + @MockBean private MatchService matchService; + @MockBean private TalentInvitationService talentInvitationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private static final List PATHS = List.of( + "/applications/1/feedback", + "/applications/1/match", + "/companies/me/match-rule", + "/profile/me/talent-discovery", + "/profile/me/career-progress", + "/jobs/1/match", + "/companies/me/talent-invitations"); + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + @Test + @DisplayName("A4 接线检测：Accessor 抛未登录时代表端点必须 401") + void accessorThrowsUnauthenticated_endpointsReturn401() throws Exception { + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + for (String path : PATHS) { + int st = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s 若未接线 Accessor，不会是 401", path).isEqualTo(401); + } + verify(currentUserAccessor, times(PATHS.size())).requireUserId(); + } + + @Test + @DisplayName("A4 接线检测：Accessor 返回固定 userId 时 Service 收到该值") + void serviceReceivesAccessorUserId() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(4242L); + when(requestIdAccessor.get(any())).thenReturn("a4-probe"); + + mockMvc.perform(get("/profile/me/career-progress") + .with(authentication(LEGAL))).andReturn(); + verify(careerProgressService).getCareerProgress(eq(4242L), anyInt(), anyInt(), any()); + + mockMvc.perform(get("/companies/me/talent-invitations") + .with(authentication(LEGAL))).andReturn(); + verify(talentInvitationService).listCompany(eq(4242L), anyInt(), anyInt()); + } + + @Test + @DisplayName("A4 接线检测：响应体 requestId 来自 Accessor mock") + void requestIdComesFromAccessorBean() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(42L); + when(requestIdAccessor.get(any())).thenReturn("a4-probe-from-accessor"); + + for (String path : PATHS) { + String body = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).as("path=%s", path) + .contains("\"requestId\":\"a4-probe-from-accessor\""); + } + Mockito.verify(requestIdAccessor, Mockito.atLeastOnce()).get(any()); + } + + @Test + @DisplayName("A4 接线检测：无 Token 仍 401（Security 链）") + void noToken_is401() throws Exception { + for (String path : PATHS) { + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4IndependentVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4IndependentVerificationTest.java new file mode 100644 index 0000000..dc5d985 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/A4IndependentVerificationTest.java @@ -0,0 +1,129 @@ +package com.mydreamjob.common.r01a4; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.bidirectionalmatch.BidirectionalMatchService; +import com.mydreamjob.bidirectionalmatch.MatchConversationService; +import com.mydreamjob.bidirectionalmatch.MatchRuleService; +import com.mydreamjob.careerprogress.CareerProgressService; +import com.mydreamjob.feedback.CandidateFeedbackService; +import com.mydreamjob.match.MatchService; +import com.mydreamjob.talentdiscovery.TalentDiscoveryService; +import com.mydreamjob.talentinvitation.TalentInvitationService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.RequestBuilder; + +import java.util.List; +import java.util.function.Function; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; + +/** R01-A4 独立复验：八个 Controller 的真实 Mapping 必须全部经过统一身份与 requestId 边界。 */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A4IndependentVerificationTest { + + private static final ObjectMapper JSON = new ObjectMapper(); + private static final List ILLEGAL = List.of( + "anonymousUser", "not-a-number-a4", "12345678901234567890", "0", "-1"); + + @Autowired private MockMvc mockMvc; + + @MockBean private CandidateFeedbackService feedbackService; + @MockBean private BidirectionalMatchService bidirectionalMatchService; + @MockBean private MatchConversationService matchConversationService; + @MockBean private MatchRuleService matchRuleService; + @MockBean private TalentDiscoveryService talentDiscoveryService; + @MockBean private CareerProgressService careerProgressService; + @MockBean private MatchService matchService; + @MockBean private TalentInvitationService talentInvitationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private record Endpoint(String controller, Function request) { } + + private static List endpoints() { + return List.of( + new Endpoint("CandidateFeedbackController", a -> get("/applications/1/feedback").with(authentication(a))), + new Endpoint("ApplicationMatchController", a -> get("/applications/1/match").with(authentication(a))), + new Endpoint("MatchConversationController", a -> post("/applications/1/conversation").with(authentication(a))), + new Endpoint("MatchRuleController", a -> get("/companies/me/match-rule").with(authentication(a))), + new Endpoint("TalentDiscoveryController", a -> get("/profile/me/talent-discovery").with(authentication(a))), + new Endpoint("CareerProgressController", a -> get("/profile/me/career-progress").with(authentication(a))), + new Endpoint("MatchController", a -> get("/jobs/1/match").with(authentication(a))), + new Endpoint("TalentInvitationController", a -> get("/companies/me/talent-invitations").with(authentication(a)))); + } + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + @Test + @DisplayName("A4 独立复验：8/8 真实 Mapping 对非法主体均返回安全的 401") + void allEightMappingsRejectIllegalPrincipalsWithoutLeakage() throws Exception { + assertThat(endpoints()).hasSize(8); + for (Endpoint endpoint : endpoints()) { + for (String illegal : ILLEGAL) { + var response = mockMvc.perform(endpoint.request().apply(principal(illegal))) + .andReturn().getResponse(); + assertThat(response.getStatus()) + .as("%s principal=%s", endpoint.controller(), illegal).isEqualTo(401); + JsonNode body = JSON.readTree(response.getContentAsString()); + assertThat(body.path("code").asInt()).isEqualTo(401); + assertThat(body.path("message").asText()) + .doesNotContain("Exception", "java.", "principal", "NumberFormatException", + "not-a-number-a4", "12345678901234567890"); + assertThat(body.has("stackTrace")).isFalse(); + assertThat(body.has("trace")).isFalse(); + } + } + } + + @Test + @DisplayName("A4 独立复验：8/8 真实 Mapping 对匿名 token 均返回 401") + void allEightMappingsRejectAnonymousToken() throws Exception { + Authentication anonymous = new AnonymousAuthenticationToken("a4-key", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (Endpoint endpoint : endpoints()) { + assertThat(mockMvc.perform(endpoint.request().apply(anonymous)).andReturn().getResponse().getStatus()) + .as(endpoint.controller()).isEqualTo(401); + } + } + + @Test + @DisplayName("A4 独立复验：8/8 真实 Mapping 的响应 body 与规范化响应头 requestId 同源") + void allEightMappingsUseNormalizedRequestId() throws Exception { + Authentication legal = principal("4242"); + for (Endpoint endpoint : endpoints()) { + var request = endpoint.request().apply(legal); + if (request instanceof org.springframework.test.web.servlet.request.MockHttpServletRequestBuilder builder) { + builder.header("X-Request-Id", "a4/" + "x".repeat(80)); + } + var response = mockMvc.perform(request).andReturn().getResponse(); + assertThat(response.getStatus()).as(endpoint.controller()).isNotEqualTo(401); + String requestId = response.getHeader("X-Request-Id"); + assertThat(requestId).isNotBlank().hasSizeLessThanOrEqualTo(32) + .doesNotContain("<", ">", " ", "\r", "\n"); + assertThat(response.getContentAsString()) + .contains("\"requestId\":\"" + requestId + "\""); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/R01A4RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/R01A4RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..95a9468 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a4/R01A4RequestContextMigrationIntegrationTest.java @@ -0,0 +1,214 @@ +package com.mydreamjob.common.r01a4; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.bidirectionalmatch.BidirectionalMatchService; +import com.mydreamjob.bidirectionalmatch.MatchConversationService; +import com.mydreamjob.bidirectionalmatch.MatchRuleService; +import com.mydreamjob.careerprogress.CareerProgressService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.feedback.CandidateFeedbackService; +import com.mydreamjob.match.MatchService; +import com.mydreamjob.talentdiscovery.TalentDiscoveryService; +import com.mydreamjob.talentinvitation.TalentInvitationService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-A4 第四批：请求身份与 requestId 收束的特征测试。 + * + *

    代表端点 URL 全部取自源码真实 Mapping。身份只来自 + * {@code CurrentUserAccessor#requireUserId()}，requestId 只来自 + * {@code RequestIdAccessor#get(HttpServletRequest)}。

    + * + *

    对溢出/非数字主体不做整响应数字搜索；无 Token 请求由 Security 链提前返回， + * 本批只断言 401、不要求其携带 requestId。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01A4RequestContextMigrationIntegrationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private RequestIdAccessor requestIdAccessor; + + @MockBean private CandidateFeedbackService feedbackService; + @MockBean private BidirectionalMatchService bidirectionalMatchService; + @MockBean private MatchConversationService matchConversationService; + @MockBean private MatchRuleService matchRuleService; + @MockBean private TalentDiscoveryService talentDiscoveryService; + @MockBean private CareerProgressService careerProgressService; + @MockBean private MatchService matchService; + @MockBean private TalentInvitationService talentInvitationService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + /** 8 个 Controller 的真实代表端点（GET，取自源码 Mapping）。 */ + private static final List PATHS = List.of( + "/applications/1/feedback", // CandidateFeedbackController + "/applications/1/match", // ApplicationMatchController + "/companies/me/match-rule", // MatchRuleController + "/profile/me/talent-discovery", // TalentDiscoveryController + "/profile/me/career-progress", // CareerProgressController + "/jobs/1/match", // MatchController + "/companies/me/talent-invitations"); // TalentInvitationController + + /** MatchConversationController 只有 POST 端点，单独以 POST 覆盖。 */ + private static final String CONVERSATION_PATH = "/applications/1/conversation"; + + private static final List ILLEGAL = List.of( + "anonymousUser", "", " ", "not-a-number", "abc123", + "12345678901234567890", "0", "-1"); + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + private List allPaths() { + List all = new java.util.ArrayList<>(PATHS); + all.add(CONVERSATION_PATH); + return all; + } + + // ── 身份 ───────────────────────────────────────────────── + + @Test + @DisplayName("A4：八端点 × 八非法主体 一律 401（非 400/500）") + void illegalPrincipals_areAlways401() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + int st = mockMvc.perform(get(path).with(authentication(principal(p)))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s principal='%s' 必须 401", path, p).isEqualTo(401); + } + } + } + + @Test + @DisplayName("A4：POST 端点（MatchConversation）非法主体同样 401") + void conversationEndpoint_illegalPrincipals_are401() throws Exception { + for (String p : ILLEGAL) { + int st = mockMvc.perform(org.springframework.test.web.servlet.request.MockMvcRequestBuilders + .post(CONVERSATION_PATH).with(authentication(principal(p)))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("principal='%s'", p).isEqualTo(401); + } + } + + @Test + @DisplayName("A4：匿名 token 与无 Token 均 401") + void anonymousAndNoToken_are401() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (String path : allPaths()) { + assertThat(mockMvc.perform(get(path).with(authentication(anon))).andReturn() + .getResponse().getStatus()).as(path).isEqualTo(401); + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } + + @Test + @DisplayName("A4：错误体安全，不回显 principal/类名/堆栈") + void errorBody_isSafe() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + String body = mockMvc.perform(get(path).with(authentication(principal(p)))) + .andReturn().getResponse().getContentAsString(); + JsonNode json = MAPPER.readTree(body); + assertThat(json.path("code").asInt()).as("path=%s", path).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg).doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("at com.mydreamjob"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + } + + @Test + @DisplayName("A4：溢出主体无 NumberFormatException") + void overflow_hasNoNumberFormatException() throws Exception { + for (String path : allPaths()) { + String body = mockMvc.perform(get(path) + .with(authentication(principal("12345678901234567890")))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).doesNotContain("NumberFormatException"); + } + } + + @Test + @DisplayName("A4：合法主体进入原角色/归属判断（不被身份层拒绝）") + void legalPrincipal_reachesRoleLayer() throws Exception { + for (String path : allPaths()) { + int st = mockMvc.perform(get(path).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s 合法主体不应 401", path).isNotEqualTo(401); + } + } + + // ── requestId ──────────────────────────────────────────── + + @Test + @DisplayName("A4：requestId 合法/空白/超长/非法字符 均与响应头同源") + void requestId_consistentAcrossInputs() throws Exception { + for (String sent : List.of("a4-legal-0001", " ", "w".repeat(80), "", "a b")) { + for (String path : PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(principal("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("<").doesNotContain(">").doesNotContain(" ") + .doesNotContain("\r").doesNotContain("\n"); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + assertThat(r.getResponse().getContentAsString()).as("path=%s", path) + .contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("A4：request attribute 优先于原始 header") + void requestAttributeWins() { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.setAttribute(com.mydreamjob.common.logging.RequestIdFilter.REQUEST_ID_ATTRIBUTE, "a4-attr-wins"); + req.addHeader("X-Request-Id", "a4-header-loses"); + assertThat(requestIdAccessor.get(req)).isEqualTo("a4-attr-wins"); + } + + @Test + @DisplayName("A4：CR/LF 不进入规范化结果（直接经 Accessor）") + void crlfNeverEntersValue() { + for (String bad : List.of("a\rb", "a\nb", "a\r\nb", "\r", "\n", "z\r\nInjected: 1")) { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.addHeader("X-Request-Id", bad); + String v = requestIdAccessor.get(req); + assertThat(v).as("输入 %s", bad).isNotBlank().doesNotContain("\r").doesNotContain("\n"); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5AccessorWiringIndependentTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5AccessorWiringIndependentTest.java new file mode 100644 index 0000000..306c533 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5AccessorWiringIndependentTest.java @@ -0,0 +1,194 @@ +package com.mydreamjob.common.r01a5; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.candidatescore.governance.CandidateScoringGovernanceService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.interviewscore.InterviewScoreService; +import com.mydreamjob.job.JobFavoriteService; +import com.mydreamjob.review.AdminReviewReplyService; +import com.mydreamjob.review.CompanyReviewManagementService; +import com.mydreamjob.review.JobReviewService; +import com.mydreamjob.review.StudentReviewWeightService; +import com.mydreamjob.security.CurrentUserAccessor; +import jakarta.servlet.http.HttpServletRequest; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A5 独立复验：**接线变异检测**（不复用实施者断言）。 + * + *

    把 {@code CurrentUserAccessor} / {@code RequestIdAccessor} 与 8 个 Service 全部替换为 mock， + * 从而证明 8 个 Controller 确实通过既有 Accessor 获取身份与 requestId： + * 若删除 Controller 中的 Accessor 调用，本测试必然失败。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A5AccessorWiringIndependentTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + + @MockBean private CandidateScoringGovernanceService governanceService; + @MockBean private InterviewScoreService interviewScoreService; + @MockBean private JobFavoriteService favoriteService; + @MockBean private JobReviewService reviewService; + @MockBean private AdminReviewReplyService adminService; + @MockBean private CompanyReviewManagementService managementService; + @MockBean private StudentReviewWeightService weightService; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final String APPEALS = "/profile/me/candidate-scoring/appeals"; + private static final String INTERVIEW_SCORE = "/interviews/1/score"; + private static final String FAVORITES = "/jobs/favorites"; + private static final String ADMIN_REVIEWS = "/admin/reviews/pending"; + private static final String ADMIN_REPLIES = "/admin/review-replies/pending"; + private static final String COMPANY_REVIEWS = "/companies/me/job-reviews"; + private static final String DELETE_REVIEW = "/jobs/1/reviews/1"; + private static final String REVIEW_WEIGHTS = "/profile/me/review-weights"; + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + // ── 1. 身份 Accessor 必须真实参与调用 ──────────────────── + + @Test + @DisplayName("独立复验：8 端点均调用 requireUserId()，且 Service 收到 Accessor 返回的 4242") + void allEightEndpoints_useAccessorUserId() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(4242L); + when(requestIdAccessor.get(any())).thenReturn("a5-independent-request"); + + mockMvc.perform(get(APPEALS).with(authentication(LEGAL))).andReturn(); + verify(governanceService).listMyAppeals(eq(4242L), any(), anyInt(), anyInt()); + + mockMvc.perform(get(INTERVIEW_SCORE).with(authentication(LEGAL))).andReturn(); + verify(interviewScoreService).getScore(eq(4242L), any()); + + mockMvc.perform(get(FAVORITES).with(authentication(LEGAL))).andReturn(); + verify(favoriteService).listFavorites(eq(4242L), anyInt(), anyInt()); + + mockMvc.perform(get(ADMIN_REVIEWS).with(authentication(LEGAL))).andReturn(); + verify(reviewService).listPendingReviews(eq(4242L), any(), any(), any(), any(), anyInt(), anyInt()); + + mockMvc.perform(get(ADMIN_REPLIES).with(authentication(LEGAL))).andReturn(); + verify(adminService).listPending(eq(4242L), any(), any(), any(), any(), any(), anyInt(), anyInt()); + + mockMvc.perform(get(COMPANY_REVIEWS).with(authentication(LEGAL))).andReturn(); + verify(managementService).listMine(eq(4242L), any(), any(), any(), any(), any(), any(), anyInt(), anyInt()); + + mockMvc.perform(delete(DELETE_REVIEW).with(authentication(LEGAL))).andReturn(); + verify(reviewService).deleteReview(eq(4242L), any(), any(), any()); + + mockMvc.perform(get(REVIEW_WEIGHTS).with(authentication(LEGAL))).andReturn(); + verify(weightService).getMyWeights(eq(4242L)); + + // 8 个端点各调用一次 Accessor（证明接线真实存在） + verify(currentUserAccessor, times(8)).requireUserId(); + } + + // ── 2. 非法身份必须在业务调用前拒绝 ────────────────────── + + @Test + @DisplayName("独立复验：Accessor 抛未登录时 8 端点全部 401、无 500、Service 零调用") + void illegalIdentity_rejectedBeforeService() throws Exception { + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + List paths = List.of(APPEALS, INTERVIEW_SCORE, FAVORITES, ADMIN_REVIEWS, + ADMIN_REPLIES, COMPANY_REVIEWS, REVIEW_WEIGHTS); + + for (String path : paths) { + var r = mockMvc.perform(get(path).with(authentication(LEGAL))).andReturn(); + assertThat(r.getResponse().getStatus()).as("path=%s 必须 401", path).isEqualTo(401); + assertThat(r.getResponse().getStatus()).as("path=%s 不得 500", path).isNotEqualTo(500); + + JsonNode json = MAPPER.readTree(r.getResponse().getContentAsString()); + assertThat(json.path("code").asInt()).as("path=%s", path).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg) + .doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("anonymousUser") + .doesNotContain("com.mydreamjob"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + } + + var dr = mockMvc.perform(delete(DELETE_REVIEW).with(authentication(LEGAL))).andReturn(); + assertThat(dr.getResponse().getStatus()).isEqualTo(401); + + // 业务 Service 零调用 + verify(governanceService, never()).listMyAppeals(any(), any(), anyInt(), anyInt()); + verify(interviewScoreService, never()).getScore(any(), any()); + verify(favoriteService, never()).listFavorites(any(), anyInt(), anyInt()); + verify(reviewService, never()).deleteReview(any(), any(), any(), any()); + verify(weightService, never()).getMyWeights(any()); + } + + // ── 3. requestId Accessor 必须真实参与调用 ─────────────── + + @Test + @DisplayName("独立复验：响应体 requestId 来自 RequestIdAccessor") + void responseBodyRequestId_comesFromAccessor() throws Exception { + when(currentUserAccessor.requireUserId()).thenReturn(42L); + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a5-independent-request"); + + for (String path : List.of(APPEALS, INTERVIEW_SCORE, FAVORITES, ADMIN_REVIEWS, + ADMIN_REPLIES, COMPANY_REVIEWS, REVIEW_WEIGHTS)) { + String body = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(body).as("path=%s 响应体 requestId 应来自 Accessor", path) + .contains("\"requestId\":\"a5-independent-request\""); + } + + // DELETE 端点同样返回 ApiResponse，含 requestId + String delBody = mockMvc.perform(delete(DELETE_REVIEW).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(delBody).contains("\"requestId\":\"a5-independent-request\""); + + verify(requestIdAccessor, times(8)).get(any(HttpServletRequest.class)); + } + + @Test + @DisplayName("独立复验：无 Token 时 8 端点由 Security 链返回 401（不经 Controller）") + void noToken_is401() throws Exception { + for (String path : List.of(APPEALS, INTERVIEW_SCORE, FAVORITES, ADMIN_REVIEWS, + ADMIN_REPLIES, COMPANY_REVIEWS, REVIEW_WEIGHTS)) { + assertThat(mockMvc.perform(get(path)).andReturn().getResponse().getStatus()) + .as(path).isEqualTo(401); + } + assertThat(mockMvc.perform(delete(DELETE_REVIEW)).andReturn().getResponse().getStatus()) + .isEqualTo(401); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5IndependentVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5IndependentVerificationTest.java new file mode 100644 index 0000000..095bde7 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5IndependentVerificationTest.java @@ -0,0 +1,148 @@ +package com.mydreamjob.common.r01a5; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.candidatescore.governance.CandidateScoringGovernanceService; +import com.mydreamjob.interviewscore.InterviewScoreService; +import com.mydreamjob.job.JobFavoriteService; +import com.mydreamjob.review.AdminReviewReplyService; +import com.mydreamjob.review.CompanyReviewManagementService; +import com.mydreamjob.review.JobReviewService; +import com.mydreamjob.review.StudentReviewWeightService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A5 独立复验：**身份边界**（使用真实 {@code CurrentUserAccessor} 与真实 SecurityFilterChain）。 + * + *

    验证非法主体在业务调用前安全失败，且合法主体仍进入角色/归属判断。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A5IndependentVerificationTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CandidateScoringGovernanceService governanceService; + @MockBean private InterviewScoreService interviewScoreService; + @MockBean private JobFavoriteService favoriteService; + @MockBean private JobReviewService reviewService; + @MockBean private AdminReviewReplyService adminService; + @MockBean private CompanyReviewManagementService managementService; + @MockBean private StudentReviewWeightService weightService; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final List PATHS = List.of( + "/profile/me/candidate-scoring/appeals", + "/interviews/1/score", + "/jobs/favorites", + "/admin/reviews/pending", + "/admin/review-replies/pending", + "/companies/me/job-reviews", + "/profile/me/review-weights"); + + private static final String DELETE_REVIEW = "/jobs/1/reviews/1"; + + private static final List ILLEGAL = List.of( + "anonymousUser", "not-a-number", "99999999999999999999", "0", "-1"); + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + @Test + @DisplayName("独立复验：五类非法主体 × 端点 一律 401、无 500、不回显主体") + void illegalPrincipals_are401() throws Exception { + for (String path : PATHS) { + for (String p : ILLEGAL) { + var r = mockMvc.perform(get(path).with(authentication(principal(p)))).andReturn(); + int st = r.getResponse().getStatus(); + assertThat(st).as("path=%s principal='%s' 必须 401", path, p).isEqualTo(401); + + JsonNode json = MAPPER.readTree(r.getResponse().getContentAsString()); + assertThat(json.path("code").asInt()).as("path=%s", path).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + // 只检查稳定字段，不对整段 JSON 做数字搜索 + assertThat(msg) + .doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("anonymousUser") + .doesNotContain("com.mydreamjob").doesNotContain("NumberFormat"); + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + // DELETE 端点 + for (String p : ILLEGAL) { + assertThat(mockMvc.perform(delete(DELETE_REVIEW).with(authentication(principal(p)))) + .andReturn().getResponse().getStatus()).as("delete principal='%s'", p).isEqualTo(401); + } + } + + @Test + @DisplayName("独立复验：匿名 token 与无 Token 均 401") + void anonymousAndNoToken_are401() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (String path : PATHS) { + assertThat(mockMvc.perform(get(path).with(authentication(anon))).andReturn() + .getResponse().getStatus()).as(path).isEqualTo(401); + assertThat(mockMvc.perform(get(path)).andReturn().getResponse().getStatus()) + .as(path).isEqualTo(401); + } + } + + @Test + @DisplayName("独立复验：非法主体的失败请求不触达任何业务 Service") + void illegalPrincipals_produceNoServiceCall() throws Exception { + for (String p : ILLEGAL) { + for (String path : PATHS) { + mockMvc.perform(get(path).with(authentication(principal(p)))).andReturn(); + } + } + verify(governanceService, never()).listMyAppeals(any(), any(), anyInt(), anyInt()); + verify(interviewScoreService, never()).getScore(any(), any()); + verify(favoriteService, never()).listFavorites(any(), anyInt(), anyInt()); + verify(reviewService, never()).deleteReview(any(), any(), any(), any()); + verify(weightService, never()).getMyWeights(any()); + } + + @Test + @DisplayName("独立复验：合法数字主体仍能进入业务层（不被身份层拒绝）") + void legalPrincipal_reachesService() throws Exception { + for (String path : PATHS) { + int st = mockMvc.perform(get(path).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("path=%s 合法主体不得被判未登录", path).isNotEqualTo(401); + } + assertThat(mockMvc.perform(delete(DELETE_REVIEW).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus()).isNotEqualTo(401); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5SideEffectSnapshotTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5SideEffectSnapshotTest.java new file mode 100644 index 0000000..8ac3042 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/A5SideEffectSnapshotTest.java @@ -0,0 +1,124 @@ +package com.mydreamjob.common.r01a5; + +import com.mydreamjob.candidatescore.governance.CandidateScoringGovernanceService; +import com.mydreamjob.interviewscore.InterviewScoreService; +import com.mydreamjob.job.JobFavoriteService; +import com.mydreamjob.review.AdminReviewReplyService; +import com.mydreamjob.review.CompanyReviewManagementService; +import com.mydreamjob.review.JobReviewService; +import com.mydreamjob.review.StudentReviewWeightService; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A5 独立复验：**失败请求的业务副作用**。 + * + *

    使用 H2 行级快照（显式列 + 稳定 ORDER BY，逐字段比较，非 COUNT/SUM）， + * 验证非法身份请求前后与本批端点相关的核心表完全不变。

    + * + *

    说明：本轮不启动 Docker，H2 独立复验；不声称真实 MySQL 结论。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A5SideEffectSnapshotTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private CandidateScoringGovernanceService governanceService; + @MockBean private InterviewScoreService interviewScoreService; + @MockBean private JobFavoriteService favoriteService; + @MockBean private JobReviewService reviewService; + @MockBean private AdminReviewReplyService adminService; + @MockBean private CompanyReviewManagementService managementService; + @MockBean private StudentReviewWeightService weightService; + @MockBean private RedisTemplate redisTemplate; + + /** (表, 主键列, 全列) —— 逐字段快照。 */ + private static final List TABLES = List.of( + new String[]{"JOB_FAVORITES", "ID", "ID, JOB_ID, STUDENT_USER_ID, CREATED_AT"}, + new String[]{"JOB_REVIEWS", "ID", "ID, JOB_ID, STUDENT_USER_ID, RATING, CONTENT, STATUS, CREATED_AT, UPDATED_AT"}, + new String[]{"COMPANY_REVIEW_REPLIES", "ID", "ID, REVIEW_ID, COMPANY_ID, CONTENT, MODERATION_STATUS, VERSION, CREATED_AT, UPDATED_AT"}, + new String[]{"INTERVIEW_SCORES", "ID", "ID, INTERVIEW_ID, APPLICATION_ID, COMPANY_USER_ID, STUDENT_USER_ID, STATUS, CREATED_AT, UPDATED_AT"}, + new String[]{"CANDIDATE_SCORING_APPEALS", "ID", "ID, CANDIDATE_USER_ID, DIMENSION, PERIOD, STATUS, REASON, CREATED_AT, UPDATED_AT"}, + new String[]{"STUDENT_REVIEW_WEIGHT_PREFERENCES", "ID", "ID, STUDENT_USER_ID, SOURCE, TEMPLATE_CODE, VERSION, CREATED_AT, UPDATED_AT"}, + new String[]{"NOTIFICATIONS", "ID", "ID, USER_ID, TYPE, TITLE, IS_READ, CREATED_AT"}, + new String[]{"MESSAGES", "ID", "ID, CONVERSATION_ID, SENDER_USER_ID, CONTENT, CREATED_AT"}, + new String[]{"AUDIT_LOGS", "ID", "ID, USER_ID, ACTION, ENTITY_TYPE, ENTITY_ID, CREATED_AT"}); + + private Map>> snapshot() { + Map>> out = new LinkedHashMap<>(); + for (String[] t : TABLES) { + List> rows = jdbcTemplate.queryForList( + "SELECT " + t[2] + " FROM " + t[0] + " ORDER BY " + t[2]); + out.put(t[0], rows); + } + return out; + } + + private static final List PATHS = List.of( + "/profile/me/candidate-scoring/appeals", + "/interviews/1/score", + "/jobs/favorites", + "/admin/reviews/pending", + "/admin/review-replies/pending", + "/companies/me/job-reviews", + "/profile/me/review-weights"); + private static final String DELETE_REVIEW = "/jobs/1/reviews/1"; + + @Test + @DisplayName("独立复验：非法身份请求前后，九张核心表逐字段零变化") + void illegalIdentityRequests_produceNoBusinessWrite() throws Exception { + Map>> before = snapshot(); + + var bad = new UsernamePasswordAuthenticationToken("anonymousUser", "n/a", AuthorityUtils.NO_AUTHORITIES); + for (String path : PATHS) { + mockMvc.perform(get(path).with(authentication(bad))).andReturn(); + mockMvc.perform(get(path).with(authentication( + new UsernamePasswordAuthenticationToken("not-a-number", "n/a", AuthorityUtils.NO_AUTHORITIES)))).andReturn(); + } + mockMvc.perform(delete(DELETE_REVIEW).with(authentication(bad))).andReturn(); + + Map>> after = snapshot(); + + for (String[] t : TABLES) { + assertThat(after.get(t[0])) + .as("%s 必须逐字段零变化", t[0]) + .isEqualTo(before.get(t[0])); + } + } + + @Test + @DisplayName("独立复验：无 Token 请求前后同样零变化") + void noTokenRequests_produceNoBusinessWrite() throws Exception { + Map>> before = snapshot(); + for (String path : PATHS) { + mockMvc.perform(get(path)).andReturn(); + } + mockMvc.perform(delete(DELETE_REVIEW)).andReturn(); + Map>> after = snapshot(); + for (String[] t : TABLES) { + assertThat(after.get(t[0])).as("%s", t[0]).isEqualTo(before.get(t[0])); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/R01A5RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/R01A5RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..b844a8b --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a5/R01A5RequestContextMigrationIntegrationTest.java @@ -0,0 +1,124 @@ +package com.mydreamjob.common.r01a5; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.governance.CandidateScoringGovernanceService; +import com.mydreamjob.interviewscore.InterviewScoreService; +import com.mydreamjob.job.JobFavoriteService; +import com.mydreamjob.review.AdminReviewReplyService; +import com.mydreamjob.review.CompanyReviewManagementService; +import com.mydreamjob.review.CompanyReviewReplyService; +import com.mydreamjob.review.JobReviewService; +import com.mydreamjob.review.StudentReviewWeightService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.RequestBuilder; + +import java.util.List; +import java.util.function.Function; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** R01-A5：八个真实 Controller 映射必须统一经过身份与 requestId 边界。 */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01A5RequestContextMigrationIntegrationTest { + + private static final ObjectMapper JSON = new ObjectMapper(); + private static final List ILLEGAL_PRINCIPALS = List.of( + "anonymousUser", "a5-not-a-number", "99999999999999999999", "0", "-1"); + + @Autowired private MockMvc mockMvc; + + @MockBean private CandidateScoringGovernanceService governanceService; + @MockBean private InterviewScoreService interviewScoreService; + @MockBean private JobFavoriteService favoriteService; + @MockBean private JobReviewService reviewService; + @MockBean private AdminReviewReplyService adminReviewReplyService; + @MockBean private CompanyReviewManagementService companyReviewManagementService; + @MockBean private CompanyReviewReplyService companyReviewReplyService; + @MockBean private StudentReviewWeightService studentReviewWeightService; + @MockBean private UserRepository userRepository; + @MockBean private RedisTemplate redisTemplate; + + private record Endpoint(String controller, Function request) { } + + private static List endpoints() { + return List.of( + new Endpoint("CandidateScoringGovernanceController", + auth -> get("/profile/me/candidate-scoring/appeals").with(authentication(auth))), + new Endpoint("InterviewScoreController", + auth -> get("/interviews/1/score").with(authentication(auth))), + new Endpoint("FavoriteController", + auth -> get("/jobs/favorites").with(authentication(auth))), + new Endpoint("AdminReviewController", + auth -> get("/admin/reviews/pending").with(authentication(auth))), + new Endpoint("AdminReviewReplyController", + auth -> get("/admin/review-replies/pending").with(authentication(auth))), + new Endpoint("CompanyReviewManagementController", + auth -> get("/companies/me/job-reviews").with(authentication(auth))), + new Endpoint("JobReviewController", + auth -> delete("/jobs/1/reviews/1").with(authentication(auth))), + new Endpoint("StudentReviewWeightController", + auth -> get("/profile/me/review-weights").with(authentication(auth)))); + } + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + @Test + @DisplayName("A5：8/8 真实映射对非法主体统一返回安全的 401") + void allEightMappingsRejectIllegalPrincipals() throws Exception { + assertThat(endpoints()).hasSize(8); + for (Endpoint endpoint : endpoints()) { + for (String illegal : ILLEGAL_PRINCIPALS) { + var response = mockMvc.perform(endpoint.request().apply(principal(illegal))) + .andReturn().getResponse(); + assertThat(response.getStatus()) + .as("%s principal=%s", endpoint.controller(), illegal).isEqualTo(401); + JsonNode body = JSON.readTree(response.getContentAsString()); + assertThat(body.path("code").asInt()).isEqualTo(401); + assertThat(body.path("message").asText()) + .doesNotContain("Exception", "java.", "principal", "NumberFormatException", + "a5-not-a-number", "99999999999999999999"); + assertThat(body.has("stackTrace")).isFalse(); + assertThat(body.has("trace")).isFalse(); + } + } + } + + @Test + @DisplayName("A5：8/8 真实映射的 requestId 响应头与响应体同源") + void allEightMappingsUseNormalizedRequestId() throws Exception { + Authentication legal = principal("4242"); + for (Endpoint endpoint : endpoints()) { + RequestBuilder request = endpoint.request().apply(legal); + if (request instanceof org.springframework.test.web.servlet.request.MockHttpServletRequestBuilder builder) { + builder.header("X-Request-Id", "a5/" + "x".repeat(80)); + } + var response = mockMvc.perform(request).andReturn().getResponse(); + assertThat(response.getStatus()).as(endpoint.controller()).isNotEqualTo(401); + String requestId = response.getHeader("X-Request-Id"); + assertThat(requestId).isNotBlank().hasSizeLessThanOrEqualTo(32) + .doesNotContain("<", ">", " ", "\r", "\n"); + assertThat(response.getContentAsString()).contains("\"requestId\":\"" + requestId + "\""); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringIndependentTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringIndependentTest.java new file mode 100644 index 0000000..1e81c01 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringIndependentTest.java @@ -0,0 +1,157 @@ +package com.mydreamjob.common.r01a6; + +import com.mydreamjob.auth.AuthService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.JobService; +import com.mydreamjob.scoringmonitoring.FairnessMonitoringService; +import com.mydreamjob.security.CurrentUserAccessor; +import jakarta.servlet.http.HttpServletRequest; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A6 独立复验：**接线变异检测**（不复用实施者断言）。 + * + *

    把两个 Accessor 与相关 Service 全部替换为 mock，证明 5 个 Controller 确实通过 + * 既有 Accessor 取得 requestId（以及 FairnessMonitoring 的身份）。 + * 删除任一 Accessor 调用都会使本测试失败。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A6AccessorWiringIndependentTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + + @MockBean private AuthService authService; + @MockBean private SmsVerificationService smsVerificationService; + @MockBean private JobService jobService; + @MockBean private CompanyService companyService; + @MockBean private FairnessMonitoringService fairnessMonitoringService; + @MockBean private RedisTemplate redisTemplate; + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + private static final String API_INDEX = "/"; + private static final String HEALTH = "/health"; + private static final String AUTH_ME = "/auth/me"; + private static final String JOBS = "/jobs"; + private static final String FAIRNESS_DRIFT = "/admin/scoring/fairness/drift"; + + private static final String[] ALL = {API_INDEX, HEALTH, AUTH_ME, JOBS, FAIRNESS_DRIFT}; + + @Test + @DisplayName("独立复验：5 个 Controller 的响应体 requestId 均来自 RequestIdAccessor") + void allFiveControllers_useRequestIdAccessor() throws Exception { + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a6-indep-request-id"); + + for (String path : ALL) { + String body = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(body) + .as("path=%s 响应体 requestId 必须来自 Accessor mock", path) + .contains("\"requestId\":\"a6-indep-request-id\""); + } + + verify(requestIdAccessor, Mockito.atLeast(ALL.length)).get(any(HttpServletRequest.class)); + } + + @Test + @DisplayName("独立复验：Accessor 返回 4242 时 FairnessMonitoring Service 收到 4242") + void fairnessServiceReceivesAccessorUserId() throws Exception { + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a6-indep"); + when(currentUserAccessor.requireUserId()).thenReturn(4242L); + + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(LEGAL))).andReturn(); + + verify(fairnessMonitoringService).drift(eq(4242L)); + verify(currentUserAccessor, Mockito.atLeastOnce()).requireUserId(); + } + + @Test + @DisplayName("独立复验：Accessor 抛未登录时 FairnessMonitoring 返回 401 且 Service 零调用") + void accessorThrowsUnauthenticated_returns401_noServiceCall() throws Exception { + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a6-indep"); + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + var r = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(LEGAL))).andReturn(); + assertThat(r.getResponse().getStatus()).isEqualTo(401); + verify(fairnessMonitoringService, never()).drift(any()); + } + + @Test + @DisplayName("独立复验：合法身份下 FairnessMonitoring 其余端点同样经 Accessor 取 userId") + void fairnessOtherEndpoints_useAccessor() throws Exception { + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a6-indep"); + when(currentUserAccessor.requireUserId()).thenReturn(77L); + + mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", "2026-09").with(authentication(LEGAL))).andReturn(); + verify(fairnessMonitoringService).overview(eq(77L), eq("2026-09")); + + mockMvc.perform(get("/admin/scoring/fairness/ranking-stability") + .with(authentication(LEGAL))).andReturn(); + verify(fairnessMonitoringService).rankingStability(eq(77L)); + + mockMvc.perform(get("/admin/scoring/fairness/dimensions") + .param("period", "2026-09").with(authentication(LEGAL))).andReturn(); + verify(fairnessMonitoringService).dimensions(eq(77L), eq("2026-09"), any()); + } + + @Test + @DisplayName("独立复验：需认证端点无 Token 时由 Security 链返回 401（公开端点不在此列）") + void noToken_is401OnProtectedEndpoints() throws Exception { + // `/`、`/health`、`/info`、`GET /jobs` 为公开端点，不参与此断言 + for (String path : new String[]{AUTH_ME, FAIRNESS_DRIFT}) { + assertThat(mockMvc.perform(get(path)).andReturn().getResponse().getStatus()) + .as(path).isEqualTo(401); + } + } + + @Test + @DisplayName("独立复验：JobController 企业侧端点身份来自 Accessor（未被重复实现）") + void jobController_identityFromAccessor() throws Exception { + when(requestIdAccessor.get(any(HttpServletRequest.class))).thenReturn("a6-indep"); + when(currentUserAccessor.requireUserId()).thenReturn(999L); + + // 企业侧创建岗位端点：其 resolveCompanyId() 必须经 CurrentUserAccessor 取身份 + mockMvc.perform(org.springframework.test.web.servlet.request.MockMvcRequestBuilders + .post("/jobs") + .contentType(org.springframework.http.MediaType.APPLICATION_JSON) + .content("{\"title\":\"t\",\"description\":\"d\",\"city\":\"上海\",\"employmentType\":\"FULL_TIME\"}") + .with(authentication(LEGAL))) + .andReturn(); + + verify(currentUserAccessor, Mockito.atLeastOnce()).requireUserId(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringProbeTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringProbeTest.java new file mode 100644 index 0000000..ccd94ce --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6AccessorWiringProbeTest.java @@ -0,0 +1,111 @@ +package com.mydreamjob.common.r01a6; + +import com.mydreamjob.auth.AuthService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.job.JobService; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.scoringmonitoring.FairnessMonitoringService; +import com.mydreamjob.security.CurrentUserAccessor; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +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.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.atLeastOnce; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A6 接线变异检测：证明 5 个 Controller 的 requestId（及 FairnessMonitoring 的身份） + * 确实经过既有 Accessor。 + * + *

    修复前，这 5 个 Controller 各自持有 {@code getRequestId}/{@code requestId} 直读 + * {@code X-Request-Id}，FairnessMonitoring 还直接读 {@code SecurityContextHolder}； + * 因此 mock Accessor 的返回值不会出现在响应中 —— 本测试在修复前必然失败。

    + * + *

    说明：FairnessMonitoring 的既有身份解析带有 {@code try/catch NumberFormatException}， + * 其行为本身是安全的（401 而非 500），故本测试以"未调用 Accessor"作为失败依据， + * **不编造 500**。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A6AccessorWiringProbeTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private CurrentUserAccessor currentUserAccessor; + @MockBean private RequestIdAccessor requestIdAccessor; + + @MockBean private AuthService authService; + @MockBean private SmsVerificationService smsVerificationService; + @MockBean private JobService jobService; + @MockBean private CompanyService companyService; + @MockBean private FairnessMonitoringService fairnessMonitoringService; + @MockBean private RedisTemplate redisTemplate; + + private static final UsernamePasswordAuthenticationToken LEGAL = + new UsernamePasswordAuthenticationToken("42", "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + + /** 5 个 Controller 的真实代表端点（均为 GET，且不需额外必需查询参数）。 */ + private static final String API_INDEX = "/"; // ApiController + private static final String HEALTH = "/health"; // SystemController + private static final String AUTH_ME = "/auth/me"; // AuthController + private static final String JOBS = "/jobs"; // JobController + private static final String FAIRNESS_DRIFT = "/admin/scoring/fairness/drift"; // FairnessMonitoringController + + @Test + @DisplayName("A6 接线检测：5 个 Controller 的响应体 requestId 均来自 RequestIdAccessor") + void requestIdComesFromAccessorAcrossFiveControllers() throws Exception { + when(requestIdAccessor.get(any())).thenReturn("a6-probe-request-id"); + + for (String path : new String[]{API_INDEX, HEALTH, AUTH_ME, JOBS, FAIRNESS_DRIFT}) { + String body = mockMvc.perform(get(path).with(authentication(LEGAL))) + .andReturn().getResponse().getContentAsString(); + assertThat(body) + .as("path=%s 响应体 requestId 应来自 Accessor（修复前为直读 header 的 null）", path) + .contains("\"requestId\":\"a6-probe-request-id\""); + } + + verify(requestIdAccessor, atLeastOnce()).get(any()); + } + + @Test + @DisplayName("A6 接线检测：FairnessMonitoring 的身份来自 CurrentUserAccessor") + void fairnessMonitoringUsesCurrentUserAccessor() throws Exception { + when(requestIdAccessor.get(any())).thenReturn("a6-probe"); + when(currentUserAccessor.requireUserId()).thenReturn(5151L); + + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(LEGAL))).andReturn(); + + verify(fairnessMonitoringService).drift(5151L); + verify(currentUserAccessor, atLeastOnce()).requireUserId(); + } + + @Test + @DisplayName("A6 接线检测：Accessor 抛未登录时 FairnessMonitoring 返回 401（非 500）") + void accessorThrowsUnauthenticated_fairnessReturns401() throws Exception { + when(requestIdAccessor.get(any())).thenReturn("a6-probe"); + when(currentUserAccessor.requireUserId()) + .thenThrow(new InsufficientAuthenticationException("authentication required")); + + var r = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(LEGAL))).andReturn(); + assertThat(r.getResponse().getStatus()).isEqualTo(401); + verify(fairnessMonitoringService, Mockito.never()).drift(any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6IndependentVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6IndependentVerificationTest.java new file mode 100644 index 0000000..a990ce3 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/A6IndependentVerificationTest.java @@ -0,0 +1,197 @@ +package com.mydreamjob.common.r01a6; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.AuthService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.JobService; +import com.mydreamjob.scoringmonitoring.FairnessMonitoringService; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A6 独立复验：身份边界、requestId 语义、副作用与夹具反证。 + * + *

    使用**真实** {@code CurrentUserAccessor} 与真实 SecurityFilterChain（不 mock Accessor）。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class A6IndependentVerificationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private RequestIdAccessor requestIdAccessor; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private AuthService authService; + @MockBean private SmsVerificationService smsVerificationService; + @MockBean private JobService jobService; + @MockBean private CompanyService companyService; + @MockBean private FairnessMonitoringService fairnessMonitoringService; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final String FAIRNESS_DRIFT = "/admin/scoring/fairness/drift"; + private static final List REQUEST_ID_PATHS = + List.of("/", "/health", "/auth/me", "/jobs", FAIRNESS_DRIFT); + + private static final List ILLEGAL = + List.of("anonymousUser", "not-a-number", "99999999999999999999", "0", "-1"); + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + // ── 1. FairnessMonitoring 身份边界（真实 Accessor）──────── + + @Test + @DisplayName("独立复验：非法主体访问 FairnessMonitoring 一律 401（不得 400/500）") + void fairness_illegalPrincipals_are401_not400or500() throws Exception { + for (String p : ILLEGAL) { + var r = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal(p)))).andReturn(); + int st = r.getResponse().getStatus(); + assertThat(st).as("principal='%s' 必须 401（实际 %d）", p, st).isEqualTo(401); + + JsonNode json = MAPPER.readTree(r.getResponse().getContentAsString()); + assertThat(json.path("code").asInt()).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg) + .doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("anonymousUser") + .doesNotContain("com.mydreamjob").doesNotContain("NumberFormat"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + // 只检查稳定字段 message，不对整段 JSON 做数字搜索 + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + + @Test + @DisplayName("独立复验：非法主体与匿名访问 FairnessMonitoring 时 Service 零调用") + void fairness_illegalPrincipals_produceNoServiceCall() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + for (String p : ILLEGAL) { + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal(p)))).andReturn(); + } + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(anon))).andReturn(); + mockMvc.perform(get(FAIRNESS_DRIFT)).andReturn(); + verify(fairnessMonitoringService, never()).drift(org.mockito.ArgumentMatchers.any()); + } + + @Test + @DisplayName("独立复验：合法数字主体可进入业务层（不被身份层拒绝）") + void fairness_legalPrincipal_reachesService() throws Exception { + int st = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("合法主体不得被判未登录").isNotEqualTo(401); + } + + // ── 2. requestId 语义（5 个 Controller）────────────────── + + @Test + @DisplayName("独立复验：5 个 Controller 的 requestId 规范化与头体同源") + void requestId_semanticsAcrossFiveControllers() throws Exception { + for (String sent : List.of("a6v-legal-1", " ", "q".repeat(90), "x", "a b")) { + for (String path : REQUEST_ID_PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(principal("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("<").doesNotContain(">").doesNotContain(" ") + .doesNotContain("\r").doesNotContain("\n"); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + assertThat(r.getResponse().getContentAsString()).as("path=%s", path) + .contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("独立复验：请求属性优先于原始 Header") + void requestAttributeWins() { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.setAttribute(com.mydreamjob.common.logging.RequestIdFilter.REQUEST_ID_ATTRIBUTE, "a6v-attr"); + req.addHeader("X-Request-Id", "a6v-header"); + assertThat(requestIdAccessor.get(req)).isEqualTo("a6v-attr"); + } + + @Test + @DisplayName("独立复验：CR/LF 不进入规范化结果（直接经 Accessor，不依赖 MockMvc 接受非法 header）") + void crlfNeverEntersValue() { + for (String bad : List.of("a\rb", "a\nb", "a\r\nb", "\r", "\n", "k\r\nInjected: 1")) { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.addHeader("X-Request-Id", bad); + String v = requestIdAccessor.get(req); + assertThat(v).as("输入 %s", bad).isNotBlank().doesNotContain("\r").doesNotContain("\n"); + } + } + + // ── 3. 副作用快照（行级、显式列、稳定排序）────────────── + + private static final List TABLES = List.of( + new String[]{"SCORING_RISK_EVENTS", "ID, SUBJECT_USER_ID, SOURCE_ACTION, SEVERITY, STATUS, VERSION, CREATED_AT"}, + new String[]{"SCORING_RISK_ACTIONS", "ID, RISK_EVENT_ID, OPERATOR_USER_ID, ACTION, REASON_CODE, CREATED_AT"}, + new String[]{"JOBS", "ID, COMPANY_ID, TITLE, STATUS, CREATED_AT, UPDATED_AT"}, + new String[]{"USERS", "ID, PHONE, NICKNAME, ROLE, IS_ACTIVE"}, + new String[]{"USER_ROLES", "USER_ID, ROLE"}, + new String[]{"AUDIT_LOGS", "ID, USER_ID, ACTION, ENTITY_TYPE, ENTITY_ID, CREATED_AT"}, + new String[]{"NOTIFICATIONS", "ID, USER_ID, TYPE, TITLE, IS_READ, CREATED_AT"}, + new String[]{"MESSAGES", "ID, CONVERSATION_ID, SENDER_USER_ID, CONTENT, CREATED_AT"}, + new String[]{"CANDIDATE_DIMENSION_SCORES", "ID, STUDENT_USER_ID, DIMENSION, PERIOD, SCORE, STATUS, VERSION"}); + + private Map>> snapshot() { + Map>> out = new LinkedHashMap<>(); + for (String[] t : TABLES) { + out.put(t[0], jdbcTemplate.queryForList( + "SELECT " + t[1] + " FROM " + t[0] + " ORDER BY " + t[1])); + } + return out; + } + + @Test + @DisplayName("独立复验：非法身份请求前后九张核心表逐字段零变化") + void illegalIdentity_producesNoBusinessWrite() throws Exception { + Map>> before = snapshot(); + + for (String p : ILLEGAL) { + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal(p)))).andReturn(); + mockMvc.perform(get(FAIRNESS_DRIFT).header("Authorization", "Bearer " + p)).andReturn(); + } + mockMvc.perform(get(FAIRNESS_DRIFT)).andReturn(); + + Map>> after = snapshot(); + for (String[] t : TABLES) { + assertThat(after.get(t[0])).as("%s 必须逐字段零变化", t[0]).isEqualTo(before.get(t[0])); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/R01A6RequestContextMigrationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/R01A6RequestContextMigrationIntegrationTest.java new file mode 100644 index 0000000..6cfbf59 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01a6/R01A6RequestContextMigrationIntegrationTest.java @@ -0,0 +1,167 @@ +package com.mydreamjob.common.r01a6; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.AuthService; +import com.mydreamjob.auth.SmsVerificationService; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.JobService; +import com.mydreamjob.scoringmonitoring.FairnessMonitoringService; +import org.junit.jupiter.api.DisplayName; +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.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * R01-A6 特征测试：FairnessMonitoringController 的身份边界 + 5 个 Controller 的 requestId 规范化。 + * + *

    身份断言只针对 {@code /admin/scoring/fairness/*}（其余 4 个 Controller 的代表端点为 + * 公开端点，无身份解析，仅覆盖 requestId）。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01A6RequestContextMigrationIntegrationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private RequestIdAccessor requestIdAccessor; + + @MockBean private AuthService authService; + @MockBean private SmsVerificationService smsVerificationService; + @MockBean private JobService jobService; + @MockBean private CompanyService companyService; + @MockBean private FairnessMonitoringService fairnessMonitoringService; + @MockBean private RedisTemplate redisTemplate; + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final String API_INDEX = "/"; + private static final String HEALTH = "/health"; + private static final String AUTH_ME = "/auth/me"; + private static final String JOBS = "/jobs"; + private static final String FAIRNESS_DRIFT = "/admin/scoring/fairness/drift"; + + private static final List REQUEST_ID_PATHS = + List.of(API_INDEX, HEALTH, AUTH_ME, JOBS, FAIRNESS_DRIFT); + + private static final List ILLEGAL = List.of( + "anonymousUser", "not-a-number", "99999999999999999999", "0", "-1"); + + private static Authentication principal(String name) { + return new UsernamePasswordAuthenticationToken(name, "n/a", + AuthorityUtils.createAuthorityList("ROLE_STUDENT", "ROLE_COMPANY", "ROLE_ADMIN")); + } + + // ── 身份边界（FairnessMonitoringController）─────────────── + + @Test + @DisplayName("A6：非法主体访问 FairnessMonitoring 一律 401、无 500、不回显主体") + void fairnessMonitoring_illegalPrincipals_are401() throws Exception { + for (String p : ILLEGAL) { + var r = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal(p)))).andReturn(); + int st = r.getResponse().getStatus(); + assertThat(st).as("principal='%s' 必须 401", p).isEqualTo(401); + + JsonNode json = MAPPER.readTree(r.getResponse().getContentAsString()); + assertThat(json.path("code").asInt()).isEqualTo(401); + String msg = json.path("message").asText(); + assertThat(msg).isIn("authentication required", "not authenticated"); + assertThat(msg) + .doesNotContain("Exception").doesNotContain("java.") + .doesNotContain("principal").doesNotContain("anonymousUser") + .doesNotContain("com.mydreamjob").doesNotContain("NumberFormat"); + assertThat(json.has("stackTrace")).isFalse(); + assertThat(json.has("trace")).isFalse(); + if (p.length() >= 3 && !p.chars().allMatch(Character::isDigit)) { + assertThat(msg).doesNotContain(p); + } + } + } + + @Test + @DisplayName("A6：非法主体访问 FairnessMonitoring 时业务 Service 零调用") + void fairnessMonitoring_illegalPrincipals_produceNoServiceCall() throws Exception { + for (String p : ILLEGAL) { + mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal(p)))).andReturn(); + } + verify(fairnessMonitoringService, never()).drift(any()); + } + + @Test + @DisplayName("A6：匿名 token 与无 Token 均 401") + void fairnessMonitoring_anonymousAndNoToken_are401() throws Exception { + Authentication anon = new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + assertThat(mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(anon))) + .andReturn().getResponse().getStatus()).isEqualTo(401); + assertThat(mockMvc.perform(get(FAIRNESS_DRIFT)).andReturn() + .getResponse().getStatus()).isEqualTo(401); + } + + @Test + @DisplayName("A6：合法数字主体仍可进入业务层（不被身份层拒绝）") + void fairnessMonitoring_legalPrincipal_reachesService() throws Exception { + int st = mockMvc.perform(get(FAIRNESS_DRIFT).with(authentication(principal("7")))) + .andReturn().getResponse().getStatus(); + assertThat(st).as("合法主体不得被判未登录").isNotEqualTo(401); + } + + // ── requestId 规范化（5 个 Controller）─────────────────── + + @Test + @DisplayName("A6：5 个 Controller 的 requestId 合法/空白/超长/非法字符 均与响应头同源") + void requestId_consistentAcrossFiveControllers() throws Exception { + for (String sent : List.of("a6-legal-0001", " ", "v".repeat(80), "", "a b")) { + for (String path : REQUEST_ID_PATHS) { + var r = mockMvc.perform(get(path).header("X-Request-Id", sent) + .with(authentication(principal("7")))).andReturn(); + String hdr = r.getResponse().getHeader("X-Request-Id"); + assertThat(hdr).as("path=%s sent=%s", path, sent).isNotNull() + .doesNotContain("<").doesNotContain(">").doesNotContain(" ") + .doesNotContain("\r").doesNotContain("\n"); + assertThat(hdr.length()).isLessThanOrEqualTo(32); + assertThat(r.getResponse().getContentAsString()).as("path=%s", path) + .contains("\"requestId\":\"" + hdr + "\""); + } + } + } + + @Test + @DisplayName("A6：request attribute 优先于原始 header") + void requestAttributeWins() { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.setAttribute(com.mydreamjob.common.logging.RequestIdFilter.REQUEST_ID_ATTRIBUTE, "a6-attr-wins"); + req.addHeader("X-Request-Id", "a6-header-loses"); + assertThat(requestIdAccessor.get(req)).isEqualTo("a6-attr-wins"); + } + + @Test + @DisplayName("A6：CR/LF 不进入规范化结果（直接经 Accessor）") + void crlfNeverEntersValue() { + for (String bad : List.of("a\rb", "a\nb", "a\r\nb", "\r", "\n", "y\r\nInjected: 1")) { + var req = new org.springframework.mock.web.MockHttpServletRequest(); + req.addHeader("X-Request-Id", bad); + String v = requestIdAccessor.get(req); + assertThat(v).as("输入 %s", bad).isNotBlank().doesNotContain("\r").doesNotContain("\n"); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/ErrorHttpStatusRegistryTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/ErrorHttpStatusRegistryTest.java new file mode 100644 index 0000000..5de1339 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/ErrorHttpStatusRegistryTest.java @@ -0,0 +1,158 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.exception.ErrorHttpStatusRegistry; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; +import org.springframework.http.HttpStatus; + +import java.util.EnumSet; +import java.util.Map; +import java.util.Set; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-B/B2：集中式错误码 → HTTP 状态映射的契约测试。 + * + *

    覆盖任务书要求：单一映射、显式映射集中、不可变、重复键初始化即失败、 + * 未映射回退 400、只保留既有语义。

    + */ +class ErrorHttpStatusRegistryTest { + + private final ErrorHttpStatusRegistry registry = new ErrorHttpStatusRegistry(); + + /** 允许出现在显式映射里的状态集合；密码登录新增 401/400 契约。 */ + private static final Set ALLOWED_EXPLICIT_STATUSES = Set.of( + HttpStatus.FORBIDDEN, HttpStatus.NOT_FOUND, HttpStatus.CONFLICT, + HttpStatus.TOO_MANY_REQUESTS, HttpStatus.UNAUTHORIZED, HttpStatus.BAD_REQUEST, + HttpStatus.SERVICE_UNAVAILABLE); + + @Test + @DisplayName("密码登录：显式映射包含新增认证状态") + void explicitMappingCountMatchesBaseline() { + assertThat(registry.explicitMappingCount()).isEqualTo(119); + // 119 个常量只覆盖 118 个唯一数字码：9103 被 REVIEW_ALREADY_DECIDED 与 + // DUPLICATE_FEEDBACK 共用（既有事实，未修改 ErrorCode 数字）。 + assertThat(registry.explicitNumericCodeCount()).isEqualTo(118); + } + + @Test + @DisplayName("B2：映射键是 ErrorCode 常量本身，不是数字码") + void mappingKeysAreErrorCodeConstants() { + assertThat(ErrorHttpStatusRegistry.explicitMappingsView().keySet()) + .isSubsetOf(EnumSet.allOf(ErrorCode.class)); + + // 两个常量共用数字码 9103 时必须同时显式登记，否则说明键被错误地按数字去重 + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(ErrorCode.REVIEW_ALREADY_DECIDED)).isTrue(); + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(ErrorCode.DUPLICATE_FEEDBACK)).isTrue(); + assertThat(ErrorCode.REVIEW_ALREADY_DECIDED.getCode()) + .as("9103 为两个既有常量共用（潜在缺陷，本轮不修改 ErrorCode）") + .isEqualTo(ErrorCode.DUPLICATE_FEEDBACK.getCode()); + // 二者状态一致，数字入口因此无歧义 + assertThat(registry.resolve(ErrorCode.REVIEW_ALREADY_DECIDED)) + .isEqualTo(registry.resolve(ErrorCode.DUPLICATE_FEEDBACK)); + } + + @Test + @DisplayName("B2：显式映射只使用四个既有状态，未引入新状态") + void explicitMappingsUseOnlyPreExistingStatuses() { + assertThat(new java.util.LinkedHashSet<>(ErrorHttpStatusRegistry.explicitMappingsView().values())) + .as("显式映射出现的状态集合") + .isSubsetOf(ALLOWED_EXPLICIT_STATUSES); + } + + @ParameterizedTest(name = "{0}") + @EnumSource(ErrorCode.class) + @DisplayName("B2：显式映射逐项自洽；未映射码一律回退 400") + void resolveMatchesMappingTableForEveryErrorCode(ErrorCode errorCode) { + HttpStatus expected = ErrorHttpStatusRegistry.explicitMappingsView() + .getOrDefault(errorCode, HttpStatus.BAD_REQUEST); + + assertThat(registry.resolve(errorCode)).isEqualTo(expected); + assertThat(registry.resolve(errorCode.getCode())).as("数字入口与枚举入口一致").isEqualTo(expected); + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(errorCode)) + .isEqualTo(ErrorHttpStatusRegistry.explicitMappingsView().containsKey(errorCode)); + } + + @Test + @DisplayName("B2：未映射错误码保持既有 400 回退（含 UNAUTHORIZED 与 SERVICE_UNAVAILABLE）") + void unmappedErrorCodesKeepBadRequestFallback() { + // 既有语义：这两个码在重构前就没有显式映射，因此是 400，不是 401/503。 + assertThat(registry.resolve(ErrorCode.UNAUTHORIZED)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.SERVICE_UNAVAILABLE)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.BAD_REQUEST)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.INTERNAL_ERROR)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.TOKEN_EXPIRED)).isEqualTo(HttpStatus.BAD_REQUEST); + // 完全未知的数字码 + assertThat(registry.resolve(0)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(-1)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(123456789)).isEqualTo(HttpStatus.BAD_REQUEST); + // null 不抛 NPE + assertThat(registry.resolve((ErrorCode) null)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.defaultStatus()).isEqualTo(HttpStatus.BAD_REQUEST); + } + + @Test + @DisplayName("B2：重复注册同一错误码（即使状态相同）必须在注册时失败") + void duplicateKeysAreRejectedAtRegistration() { + assertThatThrownBy(() -> new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.FORBIDDEN, ErrorCode.FORBIDDEN) + .put(HttpStatus.NOT_FOUND, ErrorCode.FORBIDDEN)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("duplicate HTTP status mapping") + .hasMessageContaining(String.valueOf(ErrorCode.FORBIDDEN.getCode())); + + // 同一状态下的重复登记同样是配置错误，不得静默容忍 + assertThatThrownBy(() -> new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.NOT_FOUND, ErrorCode.JOB_NOT_FOUND) + .put(HttpStatus.NOT_FOUND, ErrorCode.JOB_NOT_FOUND, ErrorCode.USER_NOT_FOUND)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("duplicate HTTP status mapping"); + } + + @Test + @DisplayName("B2：构建结果不可变，运行期无法增删改") + void builtMappingIsImmutable() { + Map view = ErrorHttpStatusRegistry.explicitMappingsView(); + assertThatThrownBy(() -> view.put(ErrorCode.FORBIDDEN, HttpStatus.OK)) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> view.remove(ErrorCode.FORBIDDEN)) + .isInstanceOf(UnsupportedOperationException.class); + assertThat(view).hasSize(119); + + Map numeric = ErrorHttpStatusRegistry.numericMappingsView(); + assertThatThrownBy(() -> numeric.put(999999, HttpStatus.OK)) + .isInstanceOf(UnsupportedOperationException.class); + assertThat(numeric).hasSize(118); + } + + @Test + @DisplayName("B2：不同 ErrorCode 常量允许各自登记（即使数字码相同且状态相同）") + void distinctConstantsWithSharedNumericCodeAreAllowed() { + Map built = new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.CONFLICT, ErrorCode.REVIEW_ALREADY_DECIDED) + .put(HttpStatus.CONFLICT, ErrorCode.DUPLICATE_FEEDBACK) + .build(); + + assertThat(built).hasSize(2); + } + + @Test + @DisplayName("B2：注册顺序不影响解析结果") + void registrationOrderDoesNotChangeResolution() { + Map forward = new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.FORBIDDEN, ErrorCode.FORBIDDEN) + .put(HttpStatus.NOT_FOUND, ErrorCode.USER_NOT_FOUND) + .build(); + Map reverse = new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.NOT_FOUND, ErrorCode.USER_NOT_FOUND) + .put(HttpStatus.FORBIDDEN, ErrorCode.FORBIDDEN) + .build(); + + assertThat(forward).isEqualTo(reverse); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/GlobalExceptionHandlerMappingParityTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/GlobalExceptionHandlerMappingParityTest.java new file mode 100644 index 0000000..33efd4e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/GlobalExceptionHandlerMappingParityTest.java @@ -0,0 +1,202 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.exception.ErrorHttpStatusRegistry; +import com.mydreamjob.common.exception.GlobalExceptionHandler; +import com.mydreamjob.common.logging.RequestIdAccessor; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.mock.web.MockHttpServletRequest; + +import java.util.Set; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-B/B2：重构前后 HTTP 映射**逐项一致**证明。 + * + *

    这里的四个状态桶是**重构前**从 {@code GlobalExceptionHandler.buildBusinessHttpStatuses()} + * 逐条抄录的独立快照（亦保存于 {@code docs/acceptance/r01-b/b2-mapping-baseline.json}）， + * 不是从重构后的实现反推。任何一个错误码的状态发生漂移，本测试都会失败。

    + */ +class GlobalExceptionHandlerMappingParityTest { + + private static final Set FORBIDDEN = Set.of( + "APPLICATION_OWNER_MISMATCH", "FORBIDDEN", "INTERVIEW_ACCESS_DENIED", + "MATCH_REQUIRED_FOR_CONVERSATION", "OFFER_COMPARE_NOT_OWNER"); + + private static final Set NOT_FOUND = Set.of( + "ABILITY_ATTEMPT_NOT_FOUND", "ABILITY_RESULT_NOT_FOUND", "ABILITY_TYPE_NOT_FOUND", + "APPEAL_NOT_FOUND", "APPLICATION_NOT_FOUND", "ASSESSMENT_ATTEMPT_NOT_FOUND", + "ASSESSMENT_TYPE_NOT_FOUND", "COMPANY_NOT_FOUND", "CONVERSATION_NOT_FOUND", + "DATA_EXPORT_TASK_NOT_FOUND", "FEEDBACK_NOT_FOUND", "INTERVIEW_SCORE_NOT_FOUND", + "JOB_NOT_FOUND", "MESSAGE_NOT_FOUND", "OFFER_COUNTER_OFFER_NOT_FOUND", + "OFFER_NOT_FOUND", "PROFILE_NOT_FOUND", "REPORT_NOT_FOUND", + "RESUME_EXPORT_TASK_NOT_FOUND", "RESUME_VERSION_NOT_FOUND", "REVIEW_NOT_FOUND", + "REVIEW_REPLY_NOT_FOUND", "RISK_EVENT_NOT_FOUND", "RISK_RULE_NOT_FOUND", + "TALENT_INVITATION_NOT_FOUND", "USER_NOT_FOUND", "VERIFICATION_NOT_FOUND"); + + private static final Set CONFLICT = Set.of( + "ABILITY_ATTEMPT_INVALID_STATE", "ABILITY_CONCURRENT_UPDATE", + "ABILITY_DUPLICATE_ACTIVE", "ABILITY_IDEMPOTENCY_CONFLICT", + "ABILITY_RETAKE_COOLDOWN", "ACCOUNT_DELETED", + "ACCOUNT_DELETION_CANCEL_DEADLINE_PASSED", "ACCOUNT_DELETION_CONCURRENT_UPDATE", + "ACCOUNT_DELETION_PENDING", "APPEAL_ALREADY_DECIDED", "APPEAL_DUPLICATE", + "APPEAL_IDEMPOTENCY_CONFLICT", "APPEAL_INVALID_TRANSITION", + "APPEAL_ROLLBACK_LIMIT_EXCEEDED", "APPLICATION_DUPLICATE", + "APPLICATION_NOT_MATCHED", "ASSESSMENT_ATTEMPT_INVALID_STATE", + "ASSESSMENT_CONCURRENT_UPDATE", "ASSESSMENT_DUPLICATE_ACTIVE", + "ASSESSMENT_IDEMPOTENCY_CONFLICT", "COMPANY_ALREADY_EXISTS", + "DATA_EXPORT_DUPLICATE", "DATA_EXPORT_EXPIRED", "DATA_EXPORT_FAILED", + "DATA_EXPORT_FILE_NOT_FOUND", "DATA_EXPORT_NOT_READY", + "DEFAULT_RESUME_DELETE_NOT_ALLOWED", "DUPLICATE_DEFAULT_RESUME", + "DUPLICATE_FEEDBACK", "DUPLICATE_OFFER", "DUPLICATE_REVIEW", + "INTERVIEW_ALREADY_RESPONDED", "INTERVIEW_COMPLETE_NOT_READY", + "INTERVIEW_NOT_COMPLETED", "INTERVIEW_SCORE_CONCURRENT_UPDATE", + "INTERVIEW_SCORE_SUBMITTED", "INVALID_APPLICATION_STATUS_TRANSITION", + "INVALID_DELETION_STATE", "INVALID_INTERVIEW_STATUS_TRANSITION", + "INVALID_JOB_STATUS_TRANSITION", "INVALID_OFFER_STATUS_TRANSITION", + "INVALID_VERIFICATION_STATUS_TRANSITION", "LAST_ADMIN_CANNOT_DELETE", + "MATCH_CLOSED", "MATCH_SCORES_LOCKED", "MESSAGE_RECALL_CONCURRENT_UPDATE", + "MESSAGE_RECALL_WINDOW_EXPIRED", "OFFER_COUNTER_OFFER_EXISTS", + "OFFER_COUNTER_OFFER_EXPIRED", "OFFER_COUNTER_OFFER_NOT_PENDING", "OFFER_EXPIRED", + "OFFER_NOT_EDITABLE", "OFFER_REMINDER_DUPLICATE", + "PRIVACY_SETTINGS_CONCURRENT_UPDATE", "REPORT_ALREADY_DECIDED", "REPORT_DUPLICATE", + "REPORT_IDEMPOTENCY_CONFLICT", "REPORT_INVALID_TRANSITION", + "RESUME_EXPORT_IN_PROGRESS", "RESUME_EXPORT_NOT_READY", "REVIEW_ALREADY_DECIDED", + "REVIEW_REPLY_ALREADY_EXISTS", "REVIEW_REPLY_CONCURRENT_UPDATE", + "REVIEW_REPLY_IDEMPOTENCY_CONFLICT", "REVIEW_REPLY_INVALID_STATE", + "REVIEW_WEIGHT_CONCURRENT_UPDATE", "RISK_EVENT_CONCURRENT_UPDATE", + "RISK_INVALID_ACTION", "RISK_RULE_CONCURRENT_UPDATE", + "TALENT_INVITATION_ALREADY_ACTIVE", "TALENT_INVITATION_CANDIDATE_UNAVAILABLE", + "TALENT_INVITATION_CONCURRENT_UPDATE", "TALENT_INVITATION_EXPIRED", + "TALENT_INVITATION_IDEMPOTENCY_CONFLICT", "TALENT_INVITATION_INVALID_STATE", + "VERIFICATION_ALREADY_APPROVED", "VERIFICATION_ALREADY_PENDING"); + + private static final Set TOO_MANY_REQUESTS = Set.of( + "ABILITY_RETAKE_LIMIT", "REPORT_RATE_LIMITED", "TALENT_INVITATION_RATE_LIMITED", + "PASSWORD_RATE_LIMITED"); + private static final Set CONFLICT_ADDITIONS = Set.of("PASSWORD_STATE_CONFLICT"); + + private static final Set UNAUTHORIZED = Set.of("CREDENTIALS_INVALID"); + private static final Set PASSWORD_BAD_REQUEST = Set.of("PASSWORD_POLICY_INVALID"); + private static final Set PHASE_A_CONFLICT = Set.of( + "COMPANY_REGISTRATION_CONFLICT", "COMPANY_ONBOARDING_INCONSISTENT_STATE"); + private static final Set PHASE_A_SERVICE_UNAVAILABLE = Set.of( + "COMPANY_REGISTRATION_DISABLED", "COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE"); + + private final ErrorHttpStatusRegistry registry = new ErrorHttpStatusRegistry(); + private final GlobalExceptionHandler handler = + new GlobalExceptionHandler(new RequestIdAccessor(), registry); + + private static HttpStatus baselineStatus(ErrorCode errorCode) { + String name = errorCode.name(); + if (FORBIDDEN.contains(name)) return HttpStatus.FORBIDDEN; + if (NOT_FOUND.contains(name)) return HttpStatus.NOT_FOUND; + if (CONFLICT.contains(name)) return HttpStatus.CONFLICT; + if (CONFLICT_ADDITIONS.contains(name)) return HttpStatus.CONFLICT; + if (PHASE_A_CONFLICT.contains(name)) return HttpStatus.CONFLICT; + if (TOO_MANY_REQUESTS.contains(name)) return HttpStatus.TOO_MANY_REQUESTS; + if (UNAUTHORIZED.contains(name)) return HttpStatus.UNAUTHORIZED; + if (PHASE_A_SERVICE_UNAVAILABLE.contains(name)) return HttpStatus.SERVICE_UNAVAILABLE; + if (PASSWORD_BAD_REQUEST.contains(name)) return HttpStatus.BAD_REQUEST; + return HttpStatus.BAD_REQUEST; + } + + @Test + @DisplayName("B2：显式映射集合与重构前快照逐项相等") + void explicitMappingSetEqualsPreRefactorSnapshot() { + assertThat(ErrorHttpStatusRegistry.explicitMappingsView()).hasSize(119); + assertThat(ErrorHttpStatusRegistry.numericMappingsView()).hasSize(118); + + for (ErrorCode errorCode : ErrorCode.values()) { + HttpStatus expected = baselineStatus(errorCode); + if (expected == HttpStatus.BAD_REQUEST) { + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(errorCode)) + .as("%s 在快照中未显式映射，重构后也不得显式映射", errorCode.name()) + .isFalse(); + } else { + assertThat(registry.resolve(errorCode)) + .as("%s 的显式映射状态", errorCode.name()) + .isEqualTo(expected); + } + } + } + + @ParameterizedTest(name = "{0}") + @EnumSource(ErrorCode.class) + @DisplayName("B2：处理器实际返回的状态与其 registry 解析结果、以及快照三者一致") + void handlerStatusMatchesRegistryAndSnapshotForEveryErrorCode(ErrorCode errorCode) { + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(errorCode), request()); + + assertThat(response.getStatusCode()).isEqualTo(baselineStatus(errorCode)); + assertThat(response.getStatusCode()).isEqualTo(registry.resolve(errorCode)); + } + + @Test + @DisplayName("B2：FORBIDDEN 保持业务码 2002 与 HTTP 403") + void forbiddenKeepsBusinessCodeAndStatus() { + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(ErrorCode.FORBIDDEN), request()); + + assertThat(response.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN); + assertThat(response.getBody()).isNotNull(); + assertThat(response.getBody().getCode()).isEqualTo(2002); + } + + @Test + @DisplayName("B2：UNAUTHORIZED(2001) 保持既有语义（回退 400，不擅自改为 401）") + void unauthorizedKeepsLegacySemantics() { + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(ErrorCode.UNAUTHORIZED), request()); + + assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(response.getBody()).isNotNull(); + assertThat(response.getBody().getCode()).isEqualTo(2001); + assertThat(registry.resolve(ErrorCode.UNAUTHORIZED)).isEqualTo(HttpStatus.BAD_REQUEST); + } + + @Test + @DisplayName("B2：服务不可用类错误码保持当前状态（400）") + void serviceUnavailableKeepsCurrentStatus() { + assertThat(registry.resolve(ErrorCode.SERVICE_UNAVAILABLE)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.RATE_LIMITED)).isEqualTo(HttpStatus.BAD_REQUEST); + } + + @Test + @DisplayName("B2：响应体不包含异常类名、堆栈或内部路径") + void responseBodyCarriesNoInternalDetail() { + for (ErrorCode code : new ErrorCode[]{ + ErrorCode.FORBIDDEN, ErrorCode.USER_NOT_FOUND, ErrorCode.APPLICATION_DUPLICATE, + ErrorCode.UNAUTHORIZED, ErrorCode.SERVICE_UNAVAILABLE}) { + MockHttpServletRequest request = request(); + request.setRequestURI("/admin/scoring/fairness/overview"); + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(code), request); + + assertThat(response.getBody()).isNotNull(); + String text = response.getBody().toString(); + assertThat(text) + .as("%s 响应体", code.name()) + .doesNotContain("Exception") + .doesNotContain("at com.mydreamjob") + .doesNotContain("GlobalExceptionHandler") + .doesNotContain("/admin/scoring/fairness/overview"); + assertThat(response.getBody().getRequestId()).isEqualTo("r01b-parity"); + } + } + + private static MockHttpServletRequest request() { + MockHttpServletRequest request = new MockHttpServletRequest(); + request.setRequestURI("/api/v1/parity"); + request.setAttribute("requestId", "r01b-parity"); + return request; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentHttpMappingParityTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentHttpMappingParityTest.java new file mode 100644 index 0000000..6bd1df2 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentHttpMappingParityTest.java @@ -0,0 +1,276 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.common.api.ApiResponse; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.common.exception.ErrorHttpStatusRegistry; +import com.mydreamjob.common.exception.GlobalExceptionHandler; +import com.mydreamjob.common.logging.RequestIdAccessor; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.mock.web.MockHttpServletRequest; + +import java.io.BufferedReader; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.lang.reflect.Method; +import java.nio.charset.StandardCharsets; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-B 独立复验：HTTP 映射与 **HEAD 基线**逐项对账。 + * + *

    期望值来源：{@code src/test/resources/r01b/error-code-http-status-baseline.tsv}， + * 该文件由独立复验者从 {@code git show HEAD:…GlobalExceptionHandler.java} 的 + * {@code buildBusinessHttpStatuses()} 提取生成，不复用工作区实现的任何映射表， + * 因此不构成同源假证明。

    + */ +class R01BIndependentHttpMappingParityTest { + + private static final String BASELINE = "/r01b/error-code-http-status-baseline.tsv"; + private static final Map PHASE_A_ADDITIONS = Map.of( + "COMPANY_REGISTRATION_DISABLED", HttpStatus.SERVICE_UNAVAILABLE, + "COMPANY_REGISTRATION_CONFLICT", HttpStatus.CONFLICT, + "COMPANY_ONBOARDING_INCONSISTENT_STATE", HttpStatus.CONFLICT, + "COMPANY_REGISTRATION_DEPENDENCY_UNAVAILABLE", HttpStatus.SERVICE_UNAVAILABLE); + + private final ErrorHttpStatusRegistry registry = new ErrorHttpStatusRegistry(); + private final GlobalExceptionHandler handler = + new GlobalExceptionHandler(new RequestIdAccessor(), registry); + + /** 从 HEAD 基线资源读取：ErrorCode 名称 → 数字码 → HEAD 状态。 */ + private static Map baseline() { + // 用有序结构保存 name -> {code, statusOrdinal} + Map rows = new LinkedHashMap<>(); + try (InputStream in = R01BIndependentHttpMappingParityTest.class.getResourceAsStream(BASELINE)) { + assertThat(in).as("基线资源必须存在: %s", BASELINE).isNotNull(); + try (BufferedReader r = new BufferedReader(new InputStreamReader(in, StandardCharsets.UTF_8))) { + String line; + while ((line = r.readLine()) != null) { + if (line.isBlank() || line.startsWith("#")) continue; + String[] parts = line.split("\t"); + rows.put(parts[0], new int[]{Integer.parseInt(parts[1]), statusOf(parts[2]).value()}); + } + } + } catch (Exception e) { + throw new IllegalStateException("failed to read baseline", e); + } + return rows; + } + + private static HttpStatus statusOf(String token) { + return switch (token) { + case "FORBIDDEN" -> HttpStatus.FORBIDDEN; + case "NOT_FOUND" -> HttpStatus.NOT_FOUND; + case "CONFLICT" -> HttpStatus.CONFLICT; + case "TOO_MANY_REQUESTS" -> HttpStatus.TOO_MANY_REQUESTS; + case "UNAUTHORIZED" -> HttpStatus.UNAUTHORIZED; + default -> HttpStatus.BAD_REQUEST; + }; + } + + // ── 166 项逐项对账 ──────────────────────────────────────── + + @Test + @DisplayName("独立复验：166 个枚举常量按名称逐项与 HEAD 基线对齐（不按数字去重）") + void everyEnumConstantMatchesHeadBaselineByName() { + Map base = baseline(); + + // HEAD 基线有 169 条；Phase A 追加 3 个错误码，不修改任何基线行。 + assertThat(base).hasSize(169); + assertThat(base).containsKeys("REVIEW_ALREADY_DECIDED", "DUPLICATE_FEEDBACK"); + assertThat(ErrorCode.values()).hasSize(173); + + int checked = 0; + for (ErrorCode code : ErrorCode.values()) { + int[] expected = base.get(code.name()); + if (expected == null) { + assertThat(PHASE_A_ADDITIONS).containsKey(code.name()); + assertThat(registry.resolve(code)).isEqualTo(PHASE_A_ADDITIONS.get(code.name())); + checked++; + continue; + } + assertThat(expected).as("基线必须覆盖 %s", code.name()).isNotNull(); + assertThat(code.getCode()).as("%s 的数字码不得改变", code.name()).isEqualTo(expected[0]); + assertThat(registry.resolve(code).value()) + .as("%s 的 HTTP 状态必须与 HEAD 一致", code.name()) + .isEqualTo(expected[1]); + checked++; + } + assertThat(checked).isEqualTo(173); + } + + @Test + @DisplayName("密码登录：116 个显式映射 + 53 个默认 400") + void explicitAndDefaultCountsMatchBaseline() { + Map base = baseline(); + long explicitInBaseline = base.values().stream().filter(v -> v[1] != 400).count(); + + assertThat(explicitInBaseline).isEqualTo(115); + assertThat(base.size() - explicitInBaseline).isEqualTo(54); + + assertThat(registry.explicitMappingCount()).isEqualTo(119); + assertThat(ErrorCode.values().length - registry.explicitMappingCount()).isEqualTo(54); + // 118 个常量仅覆盖 117 个唯一数字码（9103 共用） + assertThat(registry.explicitNumericCodeCount()).isEqualTo(118); + } + + @Test + @DisplayName("独立复验：关键既有语义逐项保持") + void keySemanticsPreserved() { + assertThat(registry.resolve(ErrorCode.UNAUTHORIZED)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.CREDENTIALS_INVALID)).isEqualTo(HttpStatus.UNAUTHORIZED); + assertThat(registry.resolve(ErrorCode.FORBIDDEN)).isEqualTo(HttpStatus.FORBIDDEN); + assertThat(registry.resolve(ErrorCode.SERVICE_UNAVAILABLE)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.COMPANY_REGISTRATION_DISABLED)) + .isEqualTo(HttpStatus.SERVICE_UNAVAILABLE); + assertThat(registry.resolve(ErrorCode.RATE_LIMITED)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(ErrorCode.USER_NOT_FOUND)).isEqualTo(HttpStatus.NOT_FOUND); + assertThat(registry.resolve(ErrorCode.APPLICATION_DUPLICATE)).isEqualTo(HttpStatus.CONFLICT); + assertThat(registry.resolve(ErrorCode.ABILITY_RETAKE_LIMIT)).isEqualTo(HttpStatus.TOO_MANY_REQUESTS); + } + + // ── 9103 重复码 ─────────────────────────────────────────── + + @Test + @DisplayName("独立复验：9103 的两个枚举常量都显式注册，且分别解析为 409") + void bothSharedNumericCodeConstantsAreExplicitlyMappedTo409() { + assertThat(ErrorCode.REVIEW_ALREADY_DECIDED.getCode()).isEqualTo(9103); + assertThat(ErrorCode.DUPLICATE_FEEDBACK.getCode()).isEqualTo(9103); + + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(ErrorCode.REVIEW_ALREADY_DECIDED)).isTrue(); + assertThat(ErrorHttpStatusRegistry.isExplicitlyMapped(ErrorCode.DUPLICATE_FEEDBACK)).isTrue(); + assertThat(registry.resolve(ErrorCode.REVIEW_ALREADY_DECIDED)).isEqualTo(HttpStatus.CONFLICT); + assertThat(registry.resolve(ErrorCode.DUPLICATE_FEEDBACK)).isEqualTo(HttpStatus.CONFLICT); + } + + @Test + @DisplayName("独立复验：运行时以数字码解析，两个 9103 常量不可区分（如实记录，不夸大）") + void runtimeCannotDistinguishTheTwoSharedConstants() { + // BusinessException 只保存 int，枚举身份在运行时丢失 + BusinessException a = new BusinessException(ErrorCode.REVIEW_ALREADY_DECIDED); + BusinessException b = new BusinessException(ErrorCode.DUPLICATE_FEEDBACK); + assertThat(a.getErrorCode()).isEqualTo(b.getErrorCode()).isEqualTo(9103); + + // 数字入口对两者给出同一结果：当前两者同为 409，故 HTTP 行为一致 + assertThat(registry.resolve(9103)).isEqualTo(HttpStatus.CONFLICT); + assertThat(a.getErrorCode()).isEqualTo(b.getErrorCode()); + + // Handler 也只拿到数字码，响应中的 code 相同 + ResponseEntity> ra = handler.handleBusinessException(a, request()); + ResponseEntity> rb = handler.handleBusinessException(b, request()); + assertThat(ra.getStatusCode()).isEqualTo(rb.getStatusCode()).isEqualTo(HttpStatus.CONFLICT); + assertThat(ra.getBody().getCode()).isEqualTo(rb.getBody().getCode()).isEqualTo(9103); + } + + @Test + @DisplayName("独立复验：同数字码被映射到不同状态时初始化必须失败，不得静默任选") + void conflictingStatusForSharedNumericCodeFailsFast() throws Exception { + // 通过公开 Builder 构造"同数字、不同状态"的映射 + Map conflicting = new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.CONFLICT, ErrorCode.REVIEW_ALREADY_DECIDED) + .put(HttpStatus.NOT_FOUND, ErrorCode.DUPLICATE_FEEDBACK) + .build(); + assertThat(conflicting).hasSize(2); + + // 数字索引构建（真实注册表在静态初始化时走同一条路径）必须拒绝该冲突 + Method indexByCode = ErrorHttpStatusRegistry.class + .getDeclaredMethod("indexByCode", Map.class); + indexByCode.setAccessible(true); + + assertThatThrownBy(() -> { + try { + indexByCode.invoke(null, conflicting); + } catch (java.lang.reflect.InvocationTargetException e) { + throw e.getCause(); + } + }) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("conflicting HTTP status mapping") + .hasMessageContaining("9103"); + + // 反证：状态相同时允许，且数字入口唯一 + Map same = new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.CONFLICT, ErrorCode.REVIEW_ALREADY_DECIDED) + .put(HttpStatus.CONFLICT, ErrorCode.DUPLICATE_FEEDBACK) + .build(); + assertThat(same).hasSize(2); + } + + @Test + @DisplayName("独立复验：重复注册同一枚举常量（即使状态相同）初始化即失败") + void duplicateEnumKeyFailsAtRegistration() { + assertThatThrownBy(() -> new ErrorHttpStatusRegistry.Builder() + .put(HttpStatus.CONFLICT, ErrorCode.REVIEW_ALREADY_DECIDED) + .put(HttpStatus.CONFLICT, ErrorCode.REVIEW_ALREADY_DECIDED)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("duplicate HTTP status mapping"); + } + + @Test + @DisplayName("独立复验：映射不依赖枚举声明顺序") + void mappingDoesNotDependOnEnumDeclarationOrder() { + // 取一个映射区段，正序与逆序注册结果必须相同 + List notFound = List.of( + ErrorCode.USER_NOT_FOUND, ErrorCode.JOB_NOT_FOUND, ErrorCode.COMPANY_NOT_FOUND); + + ErrorHttpStatusRegistry.Builder asc = new ErrorHttpStatusRegistry.Builder(); + for (ErrorCode c : notFound) asc.put(HttpStatus.NOT_FOUND, c); + ErrorHttpStatusRegistry.Builder desc = new ErrorHttpStatusRegistry.Builder(); + for (int i = notFound.size() - 1; i >= 0; i--) desc.put(HttpStatus.NOT_FOUND, notFound.get(i)); + + assertThat(asc.build()).isEqualTo(desc.build()); + + // 真实注册表对每个枚举常量的解析与其声明位置无关：逐个比对基线即可证明 + Map base = baseline(); + for (ErrorCode c : ErrorCode.values()) { + if (PHASE_A_ADDITIONS.containsKey(c.name())) { + assertThat(registry.resolve(c)).isEqualTo(PHASE_A_ADDITIONS.get(c.name())); + } else { + assertThat(registry.resolve(c).value()).isEqualTo(base.get(c.name())[1]); + } + } + } + + @Test + @DisplayName("独立复验：未知数字码仍为 400，且处理器响应不含堆栈或内部类名") + void unknownCodeFallsBackTo400AndResponseIsClean() { + assertThat(registry.resolve(0)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(-1)).isEqualTo(HttpStatus.BAD_REQUEST); + assertThat(registry.resolve(123456789)).isEqualTo(HttpStatus.BAD_REQUEST); + + for (ErrorCode code : new ErrorCode[]{ + ErrorCode.FORBIDDEN, ErrorCode.USER_NOT_FOUND, ErrorCode.APPLICATION_DUPLICATE, + ErrorCode.UNAUTHORIZED, ErrorCode.SERVICE_UNAVAILABLE, ErrorCode.DUPLICATE_FEEDBACK}) { + MockHttpServletRequest request = request(); + request.setRequestURI("/r01b/independent/parity"); + ResponseEntity> response = + handler.handleBusinessException(new BusinessException(code), request); + + assertThat(response.getBody()).isNotNull(); + String text = response.getBody().toString(); + assertThat(text) + .as("%s 响应体", code.name()) + .doesNotContain("Exception") + .doesNotContain("at com.mydreamjob") + .doesNotContain("GlobalExceptionHandler") + .doesNotContain("ErrorHttpStatusRegistry") + .doesNotContain("/r01b/independent/parity"); + assertThat(response.getBody().getRequestId()).isEqualTo("r01b-independent"); + } + } + + private static MockHttpServletRequest request() { + MockHttpServletRequest request = new MockHttpServletRequest(); + request.setRequestURI("/r01b/independent"); + request.setAttribute("requestId", "r01b-independent"); + return request; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentRoleVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentRoleVerificationTest.java new file mode 100644 index 0000000..814c80c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BIndependentRoleVerificationTest.java @@ -0,0 +1,299 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.support.TestAuthTokens; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.security.UserRoleGuard; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.security.core.context.SecurityContextHolder; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.Optional; +import java.util.Set; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoMoreInteractions; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-B 独立复验：角色授权语义、查询次数、边界与真实 HTTP 分层。 + * + *

    夹具使用**独占用户 ID / 手机号**，避开 {@code V1_1} 种子账号占用的 1/2/3 + * （被 {@code V43} 置为 inactive，会使 Token 在 Filter 阶段即被拒）。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01BIndependentRoleVerificationTest { + + private static final long USER_ID = 7_710_001L; + private static final long STUDENT_ID = 9_330_001L; + private static final long COMPANY_ID = 9_330_002L; + private static final long ADMIN_ID = 9_330_003L; + + private static final String ADMIN_ENDPOINT = "/admin/scoring/risk/overview"; + private static final String STUDENT_ENDPOINT = "/profile/me/career-progress"; + private static final String COMPANY_ENDPOINT = "/company/candidates"; + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private RedisTemplate redisTemplate; + + // ── 单元部分 ────────────────────────────────────────────── + + private UserRepository userRepository; + private UserRoleGuard guard; + + @BeforeEach + void setUp() { + userRepository = mock(UserRepository.class); + guard = new UserRoleGuard(userRepository); + SecurityContextHolder.clearContext(); + + cleanupHttpFixtures(); + insertUserWithRoles(STUDENT_ID, "r01biv-student", "STUDENT", "STUDENT"); + insertUserWithRoles(COMPANY_ID, "r01biv-company", "COMPANY", "COMPANY"); + insertUserWithRoles(ADMIN_ID, "r01biv-admin", "ADMIN", "ADMIN"); + } + + @AfterEach + void tearDown() { + SecurityContextHolder.clearContext(); + cleanupHttpFixtures(); + } + + private void cleanupHttpFixtures() { + for (long id : new long[]{STUDENT_ID, COMPANY_ID, ADMIN_ID}) { + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + + private void insertUserWithRoles(long id, String phone, String primaryRole, String... roles) { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "r01biv-" + primaryRole, primaryRole); + for (String r : roles) { + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, ?)", id, r); + } + } + + private User user(User.Role primary, Set roles, Boolean active) { + return User.builder().id(USER_ID).phone("r01biv-unit").role(primary) + .roles(roles).active(active).build(); + } + + // ── 1. 正确角色通过 ─────────────────────────────────────── + + @Test + @DisplayName("独立复验：active 的 STUDENT / COMPANY / ADMIN 分别通过对应 guard") + void activeUsersPassTheirOwnGuard() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true))); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.COMPANY, Set.of(User.Role.COMPANY), true))); + assertThatCode(() -> guard.requireCompany(USER_ID)).doesNotThrowAnyException(); + + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.ADMIN, Set.of(User.Role.ADMIN), true))); + assertThatCode(() -> guard.requireAdmin(USER_ID)).doesNotThrowAnyException(); + } + + // ── 2~3. 交叉角色与 ADMIN 无超级权限 ────────────────────── + + @Test + @DisplayName("独立复验：三类交叉角色全部拒绝，ADMIN 不自动通过 STUDENT/COMPANY") + void crossRolesAreAllRejected() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true))); + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.COMPANY, Set.of(User.Role.COMPANY), true))); + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.ADMIN, Set.of(User.Role.ADMIN), true))); + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireCompany(USER_ID)); + } + + // ── 4~6. 不存在 / inactive / 角色为空 ───────────────────── + + @Test + @DisplayName("独立复验：用户不存在 → USER_NOT_FOUND；不存在与 inactive 的错误码不同") + void missingUserThrowsUserNotFound() { + when(userRepository.findById(USER_ID)).thenReturn(Optional.empty()); + assertThatThrownBy(() -> guard.requireStudent(USER_ID)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.USER_NOT_FOUND.getCode()); + } + + @Test + @DisplayName("独立复验：inactive 用户即使角色正确也拒绝，错误码为 FORBIDDEN") + void inactiveUserIsForbiddenEvenWithCorrectRole() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), false))); + + assertThatThrownBy(() -> guard.requireStudent(USER_ID)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.FORBIDDEN.getCode()); + + // active 为 null 同样失败关闭 + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), null))); + assertForbidden(() -> guard.requireStudent(USER_ID)); + } + + @Test + @DisplayName("独立复验：user_roles 为空时所有 guard 一律拒绝") + void emptyRolesAreRejected() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(), true))); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + } + + // ── 7~8. 多角色与主角色不一致 ───────────────────────────── + + @Test + @DisplayName("独立复验：多角色用户按 user_roles 实际集合判定；users.role 不参与") + void multiRoleAndPrimaryRoleMismatch() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, + Set.of(User.Role.STUDENT, User.Role.COMPANY), true))); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + assertThatCode(() -> guard.requireCompany(USER_ID)).doesNotThrowAnyException(); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + + // users.role 声称 COMPANY，但 user_roles 只有 STUDENT → company guard 拒绝（失败关闭） + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.COMPANY, Set.of(User.Role.STUDENT), true))); + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + } + + // ── 9~12. 查询次数、无副作用、不越界 ────────────────────── + + @Test + @DisplayName("独立复验：requireXxx(Long) 恰好一次查询；requireXxx(User) 零查询") + void queryCountIsExactlyOneOrZero() { + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true))); + + guard.requireStudent(USER_ID); + verify(userRepository, times(1)).findById(USER_ID); + + User loaded = user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true); + guard.requireStudent(loaded); + guard.requireAny(loaded, User.Role.STUDENT, User.Role.COMPANY); + verify(userRepository, times(1)).findById(anyLong()); + verifyNoMoreInteractions(userRepository); + } + + @Test + @DisplayName("独立复验：guard 无写库、不触碰 SecurityContext / requestId / Redis") + void guardHasNoSideEffectsAndNoOutOfScopeDependencies() { + // 结构断言：唯一依赖是 UserRepository（无 RequestIdAccessor / HttpServletRequest / Redis） + assertThat(UserRoleGuard.class.getDeclaredFields()) + .extracting(f -> f.getType().getName()) + .containsExactly(UserRepository.class.getName()); + + // 行为断言：SecurityContext 里放一个"别的用户"，guard 仍按传入 userId 判定 + SecurityContextHolder.getContext().setAuthentication( + new UsernamePasswordAuthenticationToken(String.valueOf(ADMIN_ID), null, + AuthorityUtils.createAuthorityList("ROLE_ADMIN"))); + + // 若 guard 读了 SecurityContext（其中是 ADMIN），requireStudent(USER_ID) 会因角色不符而抛错； + // 实际不抛错 → 判定完全来自传入的 userId，与 SecurityContext 无关。 + when(userRepository.findById(USER_ID)) + .thenReturn(Optional.of(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true))); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + + verify(userRepository, never()).save(any()); + verify(userRepository, never()).deleteById(anyLong()); + verify(userRepository, never()).delete(any()); + } + + // ── 13. 真实 HTTP 端点 401/403/404 ──────────────────────── + + @Test + @DisplayName("独立复验：三个真实端点无 Token 一律 401") + void httpNoTokenIsUnauthorized() throws Exception { + for (String path : new String[]{ADMIN_ENDPOINT, STUDENT_ENDPOINT, COMPANY_ENDPOINT}) { + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } + + @Test + @DisplayName("独立复验：角色不符一律 403（含 ADMIN 访问 STUDENT/COMPANY 端点）") + void httpWrongRoleIsForbidden() throws Exception { + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", TestAuthTokens.bearer(STUDENT_ID, "STUDENT"))) + .andExpect(status().isForbidden()); + mockMvc.perform(get(STUDENT_ENDPOINT).header("Authorization", TestAuthTokens.bearer(COMPANY_ID, "COMPANY"))) + .andExpect(status().isForbidden()); + mockMvc.perform(get(COMPANY_ENDPOINT).header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN"))) + .andExpect(status().isForbidden()); + } + + @Test + @DisplayName("独立复验：角色正确时放行；已授权的 ADMIN 访问不存在资源得 404 而非 403") + void httpCorrectRolePassesAnd404IsPreserved() throws Exception { + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN"))) + .andExpect(status().isOk()); + + int studentStatus = mockMvc.perform(get(STUDENT_ENDPOINT) + .header("Authorization", TestAuthTokens.bearer(STUDENT_ID, "STUDENT"))) + .andReturn().getResponse().getStatus(); + assertThat(studentStatus).isNotIn(401, 403); + + // 404 不被角色层改写成 403 + mockMvc.perform(org.springframework.test.web.servlet.request.MockMvcRequestBuilders + .post("/admin/scoring/risk/events/{eventId}/actions", 999_999_999L) + .header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN")) + .contentType(org.springframework.http.MediaType.APPLICATION_JSON) + .content("{\"action\":\"ACKNOWLEDGE\",\"reasonCode\":\"MONITORING\"," + + "\"expectedVersion\":0}")) + .andExpect(status().isNotFound()); + } + + private static void assertForbidden(org.assertj.core.api.ThrowableAssert.ThrowingCallable callable) { + assertThatThrownBy(callable) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.FORBIDDEN.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BWiringMutationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BWiringMutationTest.java new file mode 100644 index 0000000..98edd0f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/R01BWiringMutationTest.java @@ -0,0 +1,146 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.auth.support.TestAuthTokens; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.risk.RiskGovernanceService; +import com.mydreamjob.security.UserRoleGuard; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-B 独立复验：**接线变异检测**。 + * + *

    用 {@code @MockBean} 替换公共 guard，使"角色决策"完全由测试掌控。 + * 由于端点自身的角色判定已被收束到该 guard，两个方向都可被观测：

    + *
      + *
    • guard 拒绝 → 端点 403 且**下游业务方法零调用**；
      • + *
    • guard 放行 → 即使调用方是 STUDENT，ADMIN 端点也返回 200。
      • + *
    + *

    第二条是关键的变异证明：若端点仍保留自有的角色比较（未委托 guard）， + * STUDENT 无论 guard 怎么桩都不可能通过 ADMIN 端点，本测试必然失败。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class R01BWiringMutationTest { + + private static final long STUDENT_ID = 9_340_001L; + private static final long ADMIN_ID = 9_340_002L; + + private static final String ADMIN_ENDPOINT = "/admin/scoring/risk/overview"; + private static final String COMPANY_CANDIDATE_ENDPOINT = "/company/candidates/999999999"; + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private UserRoleGuard userRoleGuard; + @MockBean private RiskGovernanceService riskGovernanceService; + @MockBean private RedisTemplate redisTemplate; + + @BeforeEach + void provision() { + cleanup(); + insertUser(STUDENT_ID, "r01bwm-student", "STUDENT"); + insertUser(ADMIN_ID, "r01bwm-admin", "ADMIN"); + } + + @AfterEach + void cleanup() { + for (long id : new long[]{STUDENT_ID, ADMIN_ID}) { + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + + private void insertUser(long id, String phone, String role) { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "r01bwm-" + role, role); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, ?)", id, role); + } + + // ── guard 拒绝 → 业务不继续 ─────────────────────────────── + + @Test + @DisplayName("变异检测：guard 抛 FORBIDDEN 时端点 403，且下游业务方法零调用") + void guardDenyStopsBusinessFlow() throws Exception { + doThrow(new BusinessException(ErrorCode.FORBIDDEN)) + .when(userRoleGuard).requireAdmin(anyLong()); + + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN"))) + .andExpect(status().isForbidden()); + + verify(riskGovernanceService, never()).overview(any(), any()); + verify(userRoleGuard).requireAdmin(ADMIN_ID); + } + + // ── guard 放行 → 业务继续；且证明端点不自带角色比较 ──────── + + @Test + @DisplayName("变异检测：guard 放行时业务继续；STUDENT 亦可通过 ADMIN 端点（证明判定只来自 guard）") + void guardAllowLetsFlowContinueEvenForStudent() throws Exception { + // guard 为 mock，void 方法默认放行 + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", TestAuthTokens.bearer(STUDENT_ID, "STUDENT"))) + .andExpect(status().isOk()); + + verify(riskGovernanceService).overview(any(), any()); + // 端点把**真实调用方身份**交给 guard；若端点自带角色比较，STUDENT 不可能走到这里 + verify(userRoleGuard).requireAdmin(STUDENT_ID); + } + + @Test + @DisplayName("变异检测：guard 收到的 userId 与 Token 主体一致（无身份替换）") + void guardReceivesCallerIdentity() throws Exception { + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN"))) + .andExpect(status().isOk()); + verify(userRoleGuard).requireAdmin(ADMIN_ID); + verify(userRoleGuard, never()).requireAdmin(STUDENT_ID); + } + + // ── 资源归属仍由业务层负责，且错误码未被角色层吞掉 ───────── + + @Test + @DisplayName("变异检测：guard 放行后，归属/存在性失败仍由业务层返回原错误码（404 而非 403）") + void ownershipFailureStillComesFromBusinessLayer() throws Exception { + // 该 STUDENT 用户没有企业实体；guard（mock）放行后由业务层给出 404/COMPANY_NOT_FOUND 语义 + mockMvc.perform(get(COMPANY_CANDIDATE_ENDPOINT) + .header("Authorization", TestAuthTokens.bearer(STUDENT_ID, "STUDENT"))) + .andExpect(status().isNotFound()); + + // 该端点路径上 Company guard 会被调用多次（Controller 直调 + 下游 Service 委托）， + // 故只断言"至少一次且身份正确"，不臆造次数。 + verify(userRoleGuard, org.mockito.Mockito.atLeastOnce()).requireCompany(STUDENT_ID); + } + + @Test + @DisplayName("变异检测：guard 在 COMPANY 端点上同样按调用方身份被调用") + void companyEndpointAlsoDelegatesToGuard() throws Exception { + doThrow(new BusinessException(ErrorCode.FORBIDDEN)) + .when(userRoleGuard).requireCompany(anyLong()); + + mockMvc.perform(get(COMPANY_CANDIDATE_ENDPOINT) + .header("Authorization", TestAuthTokens.bearer(ADMIN_ID, "ADMIN"))) + .andExpect(status().isForbidden()); + + verify(userRoleGuard).requireCompany(ADMIN_ID); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationGuardTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationGuardTest.java new file mode 100644 index 0000000..2c24856 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationGuardTest.java @@ -0,0 +1,254 @@ +package com.mydreamjob.common.r01b; + +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.common.exception.ErrorHttpStatusRegistry; +import com.mydreamjob.security.UserRoleGuard; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpStatus; +import org.springframework.security.core.context.SecurityContextHolder; + +import java.util.Optional; +import java.util.Set; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * R01-B/B1：公共角色授权守卫的行为契约。 + * + *

    角色来源为 {@code user_roles}（{@code user.getRoles()}），与迁移前的 + * 全部重复 guard 完全一致；{@code users.role} 单值列不参与此处判定。

    + */ +class RoleAuthorizationGuardTest { + + private static final long USER_ID = 7_700_001L; + + private UserRepository userRepository; + private UserRoleGuard guard; + + @BeforeEach + void setUp() { + userRepository = mock(UserRepository.class); + guard = new UserRoleGuard(userRepository); + SecurityContextHolder.clearContext(); + } + + private void givenUser(User user) { + when(userRepository.findById(USER_ID)).thenReturn(Optional.ofNullable(user)); + } + + private static User user(User.Role primaryRole, Set roles, boolean active) { + return User.builder() + .id(USER_ID) + .phone("r01b-fixture") + .role(primaryRole) + .roles(roles) + .active(active) + .build(); + } + + // ── 1~3. 正确角色通过 ───────────────────────────────────── + + @Test + @DisplayName("B1：STUDENT 通过 student guard") + void studentPassesStudentGuard() { + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true)); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + } + + @Test + @DisplayName("B1：COMPANY 通过 company guard") + void companyPassesCompanyGuard() { + givenUser(user(User.Role.COMPANY, Set.of(User.Role.COMPANY), true)); + assertThatCode(() -> guard.requireCompany(USER_ID)).doesNotThrowAnyException(); + } + + @Test + @DisplayName("B1：ADMIN 通过 admin guard") + void adminPassesAdminGuard() { + givenUser(user(User.Role.ADMIN, Set.of(User.Role.ADMIN), true)); + assertThatCode(() -> guard.requireAdmin(USER_ID)).doesNotThrowAnyException(); + } + + // ── 4~5. 跨角色一律拒绝 ─────────────────────────────────── + + @Test + @DisplayName("B1：STUDENT 不能通过 company / admin guard") + void studentFailsCompanyAndAdminGuards() { + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true)); + + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + } + + @Test + @DisplayName("B1：COMPANY 不能通过 student / admin guard") + void companyFailsStudentAndAdminGuards() { + givenUser(user(User.Role.COMPANY, Set.of(User.Role.COMPANY), true)); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + } + + // ── 6. ADMIN 无隐式超级权限 ─────────────────────────────── + + @Test + @DisplayName("B1：ADMIN 不得自动通过 student / company guard") + void adminHasNoImplicitSuperUserPower() { + givenUser(user(User.Role.ADMIN, Set.of(User.Role.ADMIN), true)); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireCompany(USER_ID)); + // 只有显式声明允许 ADMIN 时才通过 + assertThatCode(() -> guard.requireAny(USER_ID, User.Role.STUDENT, User.Role.ADMIN)) + .doesNotThrowAnyException(); + } + + // ── 7. inactive 用户失败关闭 ────────────────────────────── + + @Test + @DisplayName("B1：inactive 用户即使角色正确也不得通过") + void inactiveUserIsRejectedEvenWithCorrectRole() { + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), false)); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireAny(USER_ID, User.Role.STUDENT)); + } + + @Test + @DisplayName("B1：active 为 null（未显式置位）同样失败关闭") + void nullActiveIsRejected() { + User u = User.builder().id(USER_ID).phone("r01b-fixture") + .role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).active(null).build(); + givenUser(u); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + } + + // ── 8. 角色缺失 ─────────────────────────────────────────── + + @Test + @DisplayName("B1：user_roles 为空时所有 guard 一律拒绝") + void missingRolesAreRejected() { + givenUser(user(User.Role.STUDENT, Set.of(), true)); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + } + + @Test + @DisplayName("B1：用户不存在返回既有 USER_NOT_FOUND 契约") + void unknownUserKeepsUserNotFoundContract() { + when(userRepository.findById(USER_ID)).thenReturn(Optional.empty()); + + assertThatThrownBy(() -> guard.requireStudent(USER_ID)) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.USER_NOT_FOUND.getCode()); + } + + // ── 9. 多角色用户 ───────────────────────────────────────── + + @Test + @DisplayName("B1：多角色用户按其实际角色集合通过对应 guard") + void multiRoleUserPassesEachHeldRole() { + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT, User.Role.COMPANY), true)); + + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + assertThatCode(() -> guard.requireCompany(USER_ID)).doesNotThrowAnyException(); + assertForbidden(() -> guard.requireAdmin(USER_ID)); + assertThatCode(() -> guard.requireAny(USER_ID, User.Role.ADMIN, User.Role.COMPANY)) + .doesNotThrowAnyException(); + } + + // ── 10. users.role 与 user_roles 不一致时失败关闭 ───────── + + @Test + @DisplayName("B1：users.role 声称 COMPANY 但 user_roles 只有 STUDENT 时，company guard 拒绝") + void primaryRoleDoesNotOverrideUserRoles() { + givenUser(user(User.Role.COMPANY, Set.of(User.Role.STUDENT), true)); + + assertForbidden(() -> guard.requireCompany(USER_ID)); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + } + + @Test + @DisplayName("B1：users.role 声称 STUDENT 但 user_roles 为空时仍然拒绝（失败关闭）") + void inconsistentPrimaryRoleFailsClosed() { + givenUser(user(User.Role.STUDENT, Set.of(), true)); + + assertForbidden(() -> guard.requireStudent(USER_ID)); + } + + // ── 11. 错误码与 HTTP 状态保持原契约 ────────────────────── + + @Test + @DisplayName("B1：错误码与 HTTP 状态沿用既有契约（角色不符 2002/403，用户不存在 4001/404）") + void failureCodesKeepOriginalHttpContract() { + ErrorHttpStatusRegistry registry = new ErrorHttpStatusRegistry(); + + assertThat(registry.resolve(ErrorCode.FORBIDDEN)).isEqualTo(HttpStatus.FORBIDDEN); + assertThat(registry.resolve(ErrorCode.USER_NOT_FOUND)).isEqualTo(HttpStatus.NOT_FOUND); + + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true)); + assertThatThrownBy(() -> guard.requireCompany(USER_ID)) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.FORBIDDEN.getCode()); + + when(userRepository.findById(USER_ID)).thenReturn(Optional.empty()); + assertThatThrownBy(() -> guard.requireCompany(USER_ID)) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.USER_NOT_FOUND.getCode()); + } + + // ── 12~13. 不越界：不解析 requestId、不解析 Authentication ─ + + @Test + @DisplayName("B1：guard 不解析 requestId，也不读取 SecurityContext") + void guardDoesNotTouchRequestContextOrAuthentication() { + // 结构断言：依赖只有 UserRepository，不含 RequestIdAccessor / HttpServletRequest + assertThat(UserRoleGuard.class.getDeclaredFields()) + .extracting(f -> f.getType().getName()) + .containsExactly(UserRepository.class.getName()); + + // 行为断言：SecurityContext 为空时，凭 userId 仍能正常授权 + SecurityContextHolder.clearContext(); + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true)); + assertThatCode(() -> guard.requireStudent(USER_ID)).doesNotThrowAnyException(); + verify(userRepository).findById(USER_ID); + } + + // ── 查询次数 ────────────────────────────────────────────── + + @Test + @DisplayName("B1：按 userId 校验恰好一次查询；按实体重载零查询") + void queryCountIsBounded() { + givenUser(user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true)); + + guard.requireStudent(USER_ID); + verify(userRepository, org.mockito.Mockito.times(1)).findById(USER_ID); + + User loaded = user(User.Role.STUDENT, Set.of(User.Role.STUDENT), true); + guard.requireStudent(loaded); + guard.requireAny(loaded, User.Role.STUDENT, User.Role.COMPANY); + // 实体重载不得新增查询 + verify(userRepository, org.mockito.Mockito.times(1)).findById(USER_ID); + } + + private static void assertForbidden(org.assertj.core.api.ThrowableAssert.ThrowingCallable callable) { + assertThatThrownBy(callable) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()) + .isEqualTo(ErrorCode.FORBIDDEN.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationIntegrationTest.java new file mode 100644 index 0000000..0037912 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/RoleAuthorizationIntegrationTest.java @@ -0,0 +1,207 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.auth.support.TestAuthTokens; +import com.mydreamjob.security.UserRoleGuard; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.boot.test.mock.mockito.SpyBean; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import static org.mockito.Mockito.atLeastOnce; +import static org.mockito.Mockito.verify; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * R01-B/B1：公共角色守卫在**真实 SecurityFilterChain + 真实 HTTP 端点**下的边界复验。 + * + *

    三个角色各取一个真实端点：

    + *
      + *
    • ADMIN → {@code GET /admin/scoring/risk/overview}
      • + *
    • STUDENT → {@code GET /profile/me/career-progress}
      • + *
    • COMPANY → {@code GET /company/candidates}
      • + *
    + * + *

    夹具使用**独占用户 ID 与独占手机号**，不复用 V1_1 种子账号占用的 1/2/3 + * （那三行已被 V43 置为 inactive，会令 Token 认证在进入业务层前就 401）。

    + * + *

    {@link UserRoleGuard} 使用 {@code @SpyBean}：既保留真实授权行为， + * 又能证明端点确实**经由公共守卫**授权（接线变异检测）。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class RoleAuthorizationIntegrationTest { + + private static final long STUDENT_ID = 9_320_001L; + private static final long COMPANY_ID = 9_320_002L; + private static final long ADMIN_ID = 9_320_003L; + + private static final String ADMIN_ENDPOINT = "/admin/scoring/risk/overview"; + private static final String STUDENT_ENDPOINT = "/profile/me/career-progress"; + private static final String COMPANY_ENDPOINT = "/company/candidates"; + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + + @SpyBean private UserRoleGuard userRoleGuard; + @MockBean private RedisTemplate redisTemplate; + + @BeforeEach + void provisionFixtureUsers() { + cleanupFixtureUsers(); + insertUser(STUDENT_ID, "r01b-student", "STUDENT"); + insertUser(COMPANY_ID, "r01b-company", "COMPANY"); + insertUser(ADMIN_ID, "r01b-admin", "ADMIN"); + } + + @AfterEach + void cleanupFixtureUsers() { + for (long id : new long[]{STUDENT_ID, COMPANY_ID, ADMIN_ID}) { + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + + private void insertUser(long id, String phone, String role) { + // 显式插入 active 用户 + user_roles：guard 的角色来源是 user_roles。 + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "r01b-fixture-" + role, role); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, ?)", id, role); + } + + private static String token(long id, String role) { + return TestAuthTokens.bearer(id, role); + } + + // ── 401：未认证 ─────────────────────────────────────────── + + @Test + @DisplayName("B1 真实链路：三个端点无 Token 一律 401") + void noTokenIsUnauthorizedOnAllThreeEndpoints() throws Exception { + for (String path : new String[]{ADMIN_ENDPOINT, STUDENT_ENDPOINT, COMPANY_ENDPOINT}) { + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + } + + // ── 403：角色不符 ───────────────────────────────────────── + + @Test + @DisplayName("B1 真实链路：STUDENT 访问 ADMIN / COMPANY 端点得 403") + void studentIsForbiddenOnAdminAndCompanyEndpoints() throws Exception { + String token = token(STUDENT_ID, "STUDENT"); + + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + mockMvc.perform(get(COMPANY_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + } + + @Test + @DisplayName("B1 真实链路：COMPANY 访问 ADMIN / STUDENT 端点得 403") + void companyIsForbiddenOnAdminAndStudentEndpoints() throws Exception { + String token = token(COMPANY_ID, "COMPANY"); + + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + mockMvc.perform(get(STUDENT_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + } + + @Test + @DisplayName("B1 真实链路：ADMIN 不因是 ADMIN 而通过 STUDENT / COMPANY 端点") + void adminIsForbiddenOnStudentAndCompanyEndpoints() throws Exception { + String token = token(ADMIN_ID, "ADMIN"); + + mockMvc.perform(get(STUDENT_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + mockMvc.perform(get(COMPANY_ENDPOINT).header("Authorization", token)) + .andExpect(status().isForbidden()); + } + + // ── 2xx / 非 403：角色正确 ──────────────────────────────── + + @Test + @DisplayName("B1 真实链路：ADMIN 访问 ADMIN 端点得 200") + void adminReachesAdminEndpoint() throws Exception { + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", token(ADMIN_ID, "ADMIN"))) + .andExpect(status().isOk()); + } + + @Test + @DisplayName("B1 真实链路：STUDENT 访问 STUDENT 端点不被角色层拒绝") + void studentReachesStudentEndpoint() throws Exception { + int status = mockMvc.perform(get(STUDENT_ENDPOINT) + .header("Authorization", token(STUDENT_ID, "STUDENT"))) + .andReturn().getResponse().getStatus(); + + org.assertj.core.api.Assertions.assertThat(status) + .as("角色正确时不得是 401/403") + .isNotIn(401, 403); + } + + @Test + @DisplayName("B1 真实链路：COMPANY 访问 COMPANY 端点不被角色层拒绝") + void companyReachesCompanyEndpoint() throws Exception { + int status = mockMvc.perform(get(COMPANY_ENDPOINT) + .header("Authorization", token(COMPANY_ID, "COMPANY"))) + .andReturn().getResponse().getStatus(); + + org.assertj.core.api.Assertions.assertThat(status) + .as("角色正确时不得是 401/403") + .isNotIn(401, 403); + } + + // ── 404：资源不存在仍为 404（不被角色层改写成 403）──────── + + @Test + @DisplayName("B1 真实链路：已授权的 ADMIN 访问不存在的风险事件得 404 而非 403") + void authorizedAdminGetsNotFoundNotForbidden() throws Exception { + // 该端点对不存在的风险事件返回 404（RISK_EVENT_NOT_FOUND），既有测试已锁定。 + mockMvc.perform(org.springframework.test.web.servlet.request.MockMvcRequestBuilders + .post("/admin/scoring/risk/events/{eventId}/actions", 999_999_999L) + .header("Authorization", token(ADMIN_ID, "ADMIN")) + .contentType(org.springframework.http.MediaType.APPLICATION_JSON) + .content("{\"action\":\"ACKNOWLEDGE\",\"reasonCode\":\"MONITORING\"," + + "\"expectedVersion\":0}")) + .andExpect(status().isNotFound()); + } + + // ── 接线变异：端点确实经由公共守卫 ──────────────────────── + + @Test + @DisplayName("B1 接线检测：三个端点均实际调用公共 UserRoleGuard") + void allThreeEndpointsDelegateToSharedGuard() throws Exception { + mockMvc.perform(get(ADMIN_ENDPOINT).header("Authorization", token(ADMIN_ID, "ADMIN"))) + .andExpect(status().isOk()); + verify(userRoleGuard, atLeastOnce()).requireAdmin(ADMIN_ID); + + mockMvc.perform(get(STUDENT_ENDPOINT).header("Authorization", token(STUDENT_ID, "STUDENT"))); + verify(userRoleGuard, atLeastOnce()).requireStudent(STUDENT_ID); + + mockMvc.perform(get(COMPANY_ENDPOINT).header("Authorization", token(COMPANY_ID, "COMPANY"))); + verify(userRoleGuard, atLeastOnce()).requireCompany(COMPANY_ID); + } + + // ── 资源归属仍由原 Service 负责（未被 guard 吞掉）───────── + + @Test + @DisplayName("B1 边界：COMPANY 通过角色层后，资源归属仍由业务层判定（非 403 而是 404/400）") + void ownershipRemainsWithBusinessService() throws Exception { + // 该 COMPANY 用户没有任何企业实体：角色层放行后，业务层的归属/存在性检查给出 404， + // 证明 guard 没有替代、也没有跳过资源归属校验。 + mockMvc.perform(get("/company/candidates/{applicationId}", 999_999_999L) + .header("Authorization", token(COMPANY_ID, "COMPANY"))) + .andExpect(status().isNotFound()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/UserRoleGuardTestSupport.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/UserRoleGuardTestSupport.java new file mode 100644 index 0000000..3fe42df --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01b/UserRoleGuardTestSupport.java @@ -0,0 +1,69 @@ +package com.mydreamjob.common.r01b; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.lenient; +import static org.mockito.Mockito.doAnswer; + +/** + * R01-B/B1 测试支持：让被 mock 的 {@link UserRoleGuard} 具备**真实授权行为**。 + * + *

    服务单元测试用 {@code @InjectMocks} 组装被测服务，新加入的 + * {@link UserRoleGuard} 依赖在测试里只能以 {@code @Mock} 形式提供（否则该构造参数为 null）。 + * 若直接使用"什么都不做"的裸 mock，所有"角色不符应抛 403"的既有断言都会失效 —— + * 那等于削弱断言。本支持类把 mock 的四个方法**逐字委托给真实 guard**， + * 并复用测试自己已经 stub 的 {@link UserRepository}， + * 使被测语义与收束前**完全一致**。

    + * + *

    使用 {@code lenient()}：单个用例可能只触发其中一种角色检查， + * 未被使用的委托桩不应被判为多余桩。

    + */ +public final class UserRoleGuardTestSupport { + + private UserRoleGuardTestSupport() { + } + + /** 把 {@code mockGuard} 的授权方法委托给基于 {@code userRepository} 的真实 guard。 */ + public static void delegateToRealGuard(UserRoleGuard mockGuard, UserRepository userRepository) { + UserRoleGuard real = new UserRoleGuard(userRepository); + + lenient().doAnswer(inv -> { + real.requireStudent((Long) inv.getArgument(0)); + return null; + }).when(mockGuard).requireStudent(anyLong()); + + lenient().doAnswer(inv -> { + real.requireCompany((Long) inv.getArgument(0)); + return null; + }).when(mockGuard).requireCompany(anyLong()); + + lenient().doAnswer(inv -> { + real.requireAdmin((Long) inv.getArgument(0)); + return null; + }).when(mockGuard).requireAdmin(anyLong()); + + lenient().doAnswer(inv -> { + real.requireAny((Long) inv.getArgument(0), (User.Role[]) inv.getArgument(1)); + return null; + }).when(mockGuard).requireAny(anyLong(), any(User.Role[].class)); + + lenient().doAnswer(inv -> { + real.requireStudent((User) inv.getArgument(0)); + return null; + }).when(mockGuard).requireStudent(any(User.class)); + + lenient().doAnswer(inv -> { + real.requireCompany((User) inv.getArgument(0)); + return null; + }).when(mockGuard).requireCompany(any(User.class)); + + lenient().doAnswer(inv -> { + real.requireAdmin((User) inv.getArgument(0)); + return null; + }).when(mockGuard).requireAdmin(any(User.class)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/CandidateScoringRuleSetCharacterizationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/CandidateScoringRuleSetCharacterizationTest.java new file mode 100644 index 0000000..a075a37 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/CandidateScoringRuleSetCharacterizationTest.java @@ -0,0 +1,159 @@ +package com.mydreamjob.common.r01c; + +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.rules.CandidateScoringRuleSet; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import java.util.List; +import java.util.Set; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-C 特征测试：评分规则基线。 + * + *

    期望值由独立抄录自重构前的 {@code CandidateScoringCalculator}（名单 38 / 62 条、 + * 学历 100/85/70/55/50、权重 0.55/0.45、版本 {@code candidate-scoring-v0.1}）， + * 不经由被测实现自身推导。

    + */ +class CandidateScoringRuleSetCharacterizationTest { + + // ── 高校名单 ────────────────────────────────────────────── + + @Test + @DisplayName("特征：C985 名单 38 项，首/中/末逐项一致") + void c985ListContentIsStable() { + Set c985 = CandidateScoringRuleSet.c985(); + + assertThat(c985).as("C985 唯一项数量").hasSize(38); + assertThat(c985).contains( + "北京大学", "清华大学", "中国人民大学", "北京航空航天大学", "北京理工大学", // 首段 + "南京大学", "东南大学", "浙江大学", "中国科学技术大学", "厦门大学", // 中段 + "兰州大学", "东北大学", "西北农林科技大学"); // 末段 + assertThat(c985).doesNotContain("北京交通大学", "苏州大学", "郑州大学", "青海大学"); + } + + @Test + @DisplayName("特征：C211 名单 61 唯一项（62 条字面量含 `北京科技大学` 重复），首/中/末一致") + void c211ListContentIsStable() { + Set c211 = CandidateScoringRuleSet.c211(); + + assertThat(c211).as("C211 唯一项数量").hasSize(61); + assertThat(c211).contains( + "北京交通大学", "北京工业大学", "北京科技大学", "北京化工大学", "北京邮电大学", // 首段 + "郑州大学", "武汉理工大学", "华中农业大学", "华中师范大学", // 中段 + "青海大学", "北京科技大学"); // 末段（重复项原样保留） + assertThat(c211).doesNotContain("北京大学", "清华大学", "复旦大学"); + } + + @Test + @DisplayName("特征：985 与 211 名单无交集") + void tierListsAreDisjoint() { + assertThat(CandidateScoringRuleSet.c985()) + .doesNotContainAnyElementsOf(CandidateScoringRuleSet.c211()); + } + + @Test + @DisplayName("特征：档次判定按 985 先于 211，且不进行模糊匹配") + void tierLookupOrderIs985FirstAndExact() { + assertThat(CandidateScoringRuleSet.is985("北京大学")).isTrue(); + assertThat(CandidateScoringRuleSet.is211("北京大学")).isFalse(); + + assertThat(CandidateScoringRuleSet.is985("苏州大学")).isFalse(); + assertThat(CandidateScoringRuleSet.is211("苏州大学")).isTrue(); + + // 相似但不完全相同、空白、大小写均**不**匹配（现状即精确匹配） + assertThat(CandidateScoringRuleSet.is985("北京大学 ")).isFalse(); + assertThat(CandidateScoringRuleSet.is985(" 北京大学")).isFalse(); + assertThat(CandidateScoringRuleSet.is985("北京大學")).isFalse(); + assertThat(CandidateScoringRuleSet.is985("")).isFalse(); + assertThat(CandidateScoringRuleSet.is985(null)).isFalse(); + assertThat(CandidateScoringRuleSet.is211(null)).isFalse(); + } + + // ── 教育背景数值 ────────────────────────────────────────── + + @Test + @DisplayName("特征：学历层次 100/85/70/55/50 与合成权重 0.55/0.45 逐项一致") + void educationLevelRulesAreStable() { + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_DOCTOR).isEqualByComparingTo("100"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_MASTER).isEqualByComparingTo("85"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_BACHELOR).isEqualByComparingTo("70"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_JUNIOR_COLLEGE).isEqualByComparingTo("55"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_UNKNOWN).isEqualByComparingTo("50"); + + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT).isEqualByComparingTo("0.55"); + assertThat(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT).isEqualByComparingTo("0.45"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT + .add(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT)) + .isEqualByComparingTo("1.00"); + + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_FULL_SCORE).isEqualByComparingTo("55"); + assertThat(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_FULL_SCORE).isEqualByComparingTo("45"); + } + + @Test + @DisplayName("特征：学校档次 985=85 / 211=75 / 其他=65 / 缺失=50 语义各自独立") + void schoolTierRulesAreStable() { + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_985).isEqualByComparingTo("85"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_211).isEqualByComparingTo("75"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_OTHER).isEqualByComparingTo("65"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_MISSING).isEqualByComparingTo("50"); + } + + @Test + @DisplayName("特征：分数均为字符串构造，scale 与重构前一致") + void bigDecimalsUseStringConstructionAndKeepScale() { + assertThat(CandidateScoringRuleSet.DEFAULT_DIMENSION_WEIGHT.toPlainString()).isEqualTo("12.50"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT.toPlainString()).isEqualTo("0.55"); + assertThat(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT.toPlainString()).isEqualTo("0.45"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_DOCTOR.toPlainString()).isEqualTo("100"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_UNKNOWN.toPlainString()).isEqualTo("50"); + } + + // ── 版本 ────────────────────────────────────────────────── + + @Test + @DisplayName("特征：rulesVersion 逐字不变（candidate-scoring-v0.1），且与计算器同源") + void rulesVersionIsUnchangedAndShared() { + assertThat(CandidateScoringRuleSet.VERSION).isEqualTo("candidate-scoring-v0.1"); + assertThat(CandidateScoringCalculator.RULES_VERSION) + .as("计算器必须读取同一规则来源，版本值一致") + .isEqualTo(CandidateScoringRuleSet.VERSION); + assertThat(CandidateScoringCalculator.DEFAULT_WEIGHT) + .isEqualByComparingTo(CandidateScoringRuleSet.DEFAULT_DIMENSION_WEIGHT); + } + + @Test + @DisplayName("特征：八维度集合与 isValidDimension 行为不变") + void dimensionSetIsUnchanged() { + List expected = List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + + for (String dimension : expected) { + assertThat(CandidateScoringCalculator.isValidDimension(dimension)).isTrue(); + } + assertThat(CandidateScoringCalculator.isValidDimension("UNKNOWN")).isFalse(); + // 既有契约：DIMENSIONS 为 Set.of(...)，contains(null) 抛 NPE（不是返回 false）。 + // 本轮不得改变该行为，故按实际语义锁定。 + assertThatThrownBy(() -> CandidateScoringCalculator.isValidDimension(null)) + .isInstanceOf(NullPointerException.class); + } + + // ── 集合不可修改 ────────────────────────────────────────── + + @Test + @DisplayName("特征：规则集对外只读，任何修改尝试必须失败") + void ruleSetIsReadOnly() { + assertThatThrownBy(() -> CandidateScoringRuleSet.c985().add("测试大学")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c211().add("测试大学")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c985().remove("北京大学")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c211().clear()) + .isInstanceOf(UnsupportedOperationException.class); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/OverviewStatusPolicyCharacterizationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/OverviewStatusPolicyCharacterizationTest.java new file mode 100644 index 0000000..7826e06 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/OverviewStatusPolicyCharacterizationTest.java @@ -0,0 +1,141 @@ +package com.mydreamjob.common.r01c; + +import com.mydreamjob.candidatescore.CandidateDimensionScore; +import com.mydreamjob.candidatescore.CandidateOverviewStatusPolicy; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-C 特征测试：overviewStatus 聚合规则（唯一实现 {@code CandidateOverviewStatusPolicy}）。 + * + *

    覆盖四种状态、空集合、null、以及"可计算但分数缺失"的边界； + * 并锁定两个入口（计算结果 / 快照）在等价输入下的产出关系。

    + */ +class OverviewStatusPolicyCharacterizationTest { + + private static final int EXPECTED = 8; + + private static CandidateScoringCalculator.DimensionResult result(String status, String score) { + CandidateScoringCalculator.DimensionResult r = + new CandidateScoringCalculator.DimensionResult("EDUCATION"); + r.status = status; + r.score = score == null ? null : new BigDecimal(score); + return r; + } + + private static List results(String status, String score, int n) { + List list = new ArrayList<>(); + for (int i = 0; i < n; i++) list.add(result(status, score)); + return list; + } + + private static CandidateDimensionScore snapshot(String status) { + CandidateDimensionScore s = new CandidateDimensionScore(); + s.setStatus(status); + return s; + } + + // ── 计算结果入口 ────────────────────────────────────────── + + @Test + @DisplayName("特征：8/8 可计算 → OK；7/8 → PARTIAL；0/8 且全 PENDING → PENDING；否则 INSUFFICIENT_DATA") + void computedResultsFourStates() { + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("OK", "80", 8), EXPECTED)) + .isEqualTo("OK"); + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("ESTIMATED", "80", 8), EXPECTED)) + .as("ESTIMATED 与 OK 同为可计算") + .isEqualTo("OK"); + + List partial = results("OK", "80", 7); + partial.add(result("PENDING", null)); + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(partial, EXPECTED)).isEqualTo("PARTIAL"); + + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("PENDING", null, 8), EXPECTED)) + .isEqualTo("PENDING"); + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("INSUFFICIENT_DATA", null, 8), EXPECTED)) + .isEqualTo("INSUFFICIENT_DATA"); + } + + @Test + @DisplayName("特征：OK 但分数缺失 → 不可计算（status 与 score 都必须满足）") + void okStatusWithoutScoreIsNotComputable() { + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("OK", null, 8), EXPECTED)) + .isEqualTo("INSUFFICIENT_DATA"); + } + + @Test + @DisplayName("特征：空列表 → PENDING（计算结果入口的 empty 语义）") + void emptyComputedResultsIsPending() { + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(List.of(), EXPECTED)).isEqualTo("PENDING"); + } + + @Test + @DisplayName("特征：null 结果列表 → NullPointerException（既有契约）") + void nullComputedResultsThrows() { + assertThatThrownBy(() -> CandidateOverviewStatusPolicy.fromComputedResults(null, EXPECTED)) + .isInstanceOf(NullPointerException.class); + } + + @Test + @DisplayName("特征：expectedDimensions 大于实际可计算数时不得判 OK") + void expectedDimensionsGatesOk() { + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(results("OK", "80", 8), 9)) + .isEqualTo("PARTIAL"); + } + + @Test + @DisplayName("特征：PENDING 与 INSUFFICIENT_DATA 混合 → INSUFFICIENT_DATA（非 PENDING）") + void mixedPendingAndInsufficientIsInsufficient() { + List mixed = new ArrayList<>(); + mixed.add(result("PENDING", null)); + mixed.add(result("INSUFFICIENT_DATA", null)); + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(mixed, EXPECTED)) + .isEqualTo("INSUFFICIENT_DATA"); + } + + // ── 快照入口 ────────────────────────────────────────────── + + @Test + @DisplayName("特征：快照入口 —— OK/ESTIMATED 全可计算 → OK；空/null → INSUFFICIENT_DATA") + void snapshotEntryStates() { + assertThat(CandidateOverviewStatusPolicy.fromSnapshots( + List.of(snapshot("OK"), snapshot("ESTIMATED")))).isEqualTo("OK"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots( + List.of(snapshot("OK"), snapshot("PENDING")))).isEqualTo("PARTIAL"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots( + List.of(snapshot("PENDING"), snapshot("PENDING")))).isEqualTo("PENDING"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots( + List.of(snapshot("INSUFFICIENT_DATA"), snapshot("PENDING")))).isEqualTo("INSUFFICIENT_DATA"); + + assertThat(CandidateOverviewStatusPolicy.fromSnapshots(List.of())).isEqualTo("INSUFFICIENT_DATA"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots(null)).isEqualTo("INSUFFICIENT_DATA"); + } + + // ── 唯一实现门禁 ────────────────────────────────────────── + + @Test + @DisplayName("结构门禁：overviewStatus 规则只有唯一的产出点（\"PARTIAL\" 只在该策略类出现）") + void partialStatusHasSingleProducer() throws Exception { + java.nio.file.Path root = java.nio.file.Path.of("src/main/java/com/mydreamjob"); + java.util.List producers = new java.util.ArrayList<>(); + try (java.util.stream.Stream walk = java.nio.file.Files.walk(root)) { + for (java.nio.file.Path p : walk.filter(f -> f.toString().endsWith(".java")).toList()) { + String src = java.nio.file.Files.readString(p); + if (src.contains("\"PARTIAL\"")) { + producers.add(p.getFileName().toString()); + } + } + } + assertThat(producers) + .as("PARTIAL 只能由 CandidateOverviewStatusPolicy 产出") + .containsExactly("CandidateOverviewStatusPolicy.java"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/PreferenceScoreCharacterizationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/PreferenceScoreCharacterizationTest.java new file mode 100644 index 0000000..bc9f255 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/PreferenceScoreCharacterizationTest.java @@ -0,0 +1,211 @@ +package com.mydreamjob.common.r01c; + +import com.mydreamjob.recommendation.JobPreferenceScoreCalculator; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-C 特征测试：岗位偏好分（30/20/20/15/15）黄金样本。 + * + *

    期望值由 30/20/20/15/15 规则**手工推算**（{@code matched*100/available}，scale=2，HALF_UP）， + * 不调用被测实现生成，避免同源假证明。使用 {@code isEqualByComparingTo} 并额外断言 scale 与字符串形式， + * 不使用 {@code isCloseTo} 之类的宽松误差。

    + */ +class PreferenceScoreCharacterizationTest { + + private static final List CITIES = List.of("上海", "北京"); + private static final List TYPES = List.of("FULL_TIME"); + private static final List INDUSTRIES = List.of("IT"); + private static final List FAMILIES = List.of("BACKEND"); + private static final Integer SALARY_MIN = 20000; + + private static JobPreferenceScoreCalculator.Criteria criteria( + List cities, List types, Integer salaryMin, + List industries, List families) { + return new JobPreferenceScoreCalculator.Criteria(cities, types, salaryMin, industries, families); + } + + private static JobPreferenceScoreCalculator.Target target( + String city, String type, Integer salaryMax, String industry, String family) { + return new JobPreferenceScoreCalculator.Target(city, type, salaryMax, industry, family); + } + + private static final JobPreferenceScoreCalculator.Criteria ALL = + criteria(CITIES, TYPES, SALARY_MIN, INDUSTRIES, FAMILIES); + + private static void assertExact(BigDecimal actual, String expected) { + assertThat(actual).as("数值").isNotNull().isEqualByComparingTo(expected); + assertThat(actual.scale()).as("scale 必须为 2").isEqualTo(2); + assertThat(actual.toPlainString()).as("精确字符串形式").isEqualTo(expected); + } + + // ── 全匹配 / 全不匹配 ───────────────────────────────────── + + @Test + @DisplayName("特征：五个维度全匹配 → available=100, matched=100 → 100.00") + void allMatched() { + assertExact(JobPreferenceScoreCalculator.calculate(ALL, + target("上海", "FULL_TIME", 25000, "IT", "BACKEND")), "100.00"); + } + + @Test + @DisplayName("特征：五个维度全不匹配 → 0.00") + void noneMatched() { + assertExact(JobPreferenceScoreCalculator.calculate(ALL, + target("广州", "PART_TIME", 10000, "FINANCE", "SALES")), "0.00"); + } + + // ── 单维度 ──────────────────────────────────────────────── + + @Test + @DisplayName("特征：仅城市维度存在且匹配 → available=30, matched=30 → 100.00") + void cityOnly() { + assertExact(JobPreferenceScoreCalculator.calculate(criteria(CITIES, List.of(), null, List.of(), List.of()), + target("北京", "FULL_TIME", 25000, "IT", "BACKEND")), "100.00"); + } + + @Test + @DisplayName("特征：仅城市维度存在但不匹配 → available=30, matched=0 → 0.00") + void cityOnlyMiss() { + assertExact(JobPreferenceScoreCalculator.calculate(criteria(CITIES, List.of(), null, List.of(), List.of()), + target("广州", "FULL_TIME", 25000, "IT", "BACKEND")), "0.00"); + } + + @Test + @DisplayName("特征：仅行业维度存在且匹配 → available=15, matched=15 → 100.00") + void industryOnly() { + assertExact(JobPreferenceScoreCalculator.calculate(criteria(List.of(), List.of(), null, INDUSTRIES, List.of()), + target("广州", "PART_TIME", 10000, "IT", "SALES")), "100.00"); + } + + // ── 部分匹配与加权 ──────────────────────────────────────── + + @Test + @DisplayName("特征：城市匹配 + 行业不匹配 → available=45, matched=30 → 66.67") + void cityMatchedIndustryMissed() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(CITIES, List.of(), null, INDUSTRIES, List.of()), + target("上海", "PART_TIME", 10000, "FINANCE", "SALES")), "66.67"); + } + + @Test + @DisplayName("特征：城市不匹配 + 行业匹配 → available=45, matched=15 → 33.33") + void cityMissedIndustryMatched() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(CITIES, List.of(), null, INDUSTRIES, List.of()), + target("广州", "PART_TIME", 10000, "IT", "SALES")), "33.33"); + } + + @Test + @DisplayName("特征：四维存在（城市/类型/薪资/行业），三项匹配 → 70*100/85 = 82.35") + void fourDimensionsThreeMatched() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(CITIES, TYPES, SALARY_MIN, INDUSTRIES, List.of()), + target("北京", "FULL_TIME", 25000, "FINANCE", "BACKEND")), "82.35"); + } + + // ── 薪资语义与边界 ──────────────────────────────────────── + + @Test + @DisplayName("特征：薪资刚好相等（salaryMax == expectedSalaryMin）视为匹配 → 100.00") + void salaryBoundaryEqualityCountsAsMatch() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of(), SALARY_MIN, List.of(), List.of()), + target("广州", "PART_TIME", 20000, "IT", "SALES")), "100.00"); + } + + @Test + @DisplayName("特征：薪资低于期望 → 0.00；岗位 salaryMax 为 null → 0.00") + void salaryBelowOrNullCountsAsMiss() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of(), SALARY_MIN, List.of(), List.of()), + target("广州", "PART_TIME", 19999, "IT", "SALES")), "0.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of(), SALARY_MIN, List.of(), List.of()), + target("广州", "PART_TIME", null, "IT", "SALES")), "0.00"); + } + + @Test + @DisplayName("特征：期望薪资为 null 时该维度不计入 available → 结果仍为 100.00") + void nullExpectedSalaryIsNotCounted() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(CITIES, List.of(), null, List.of(), List.of()), + target("上海", "PART_TIME", null, "IT", "SALES")), "100.00"); + } + + // ── 空集合与 null ───────────────────────────────────────── + + @Test + @DisplayName("特征：全部为空/ null → available=0 → 返回 null（不是 0.00）") + void emptyCriteriaReturnsNull() { + assertThat(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of(), null, List.of(), List.of()), + target("上海", "FULL_TIME", 25000, "IT", "BACKEND"))).isNull(); + } + + @Test + @DisplayName("特征：null 集合按空集合处理（与重构前 Criteria 的 null 归一化一致）") + void nullListsBehaveAsEmpty() { + JobPreferenceScoreCalculator.Criteria c = + criteria(null, null, null, null, null); + assertThat(c.cities()).isEmpty(); + assertThat(c.employmentTypes()).isEmpty(); + assertThat(c.industries()).isEmpty(); + assertThat(c.jobFamilies()).isEmpty(); + + assertThat(JobPreferenceScoreCalculator.calculate(c, + target("上海", "FULL_TIME", 25000, "IT", "BACKEND"))).isNull(); + } + + // ── 大小写与未知值 ──────────────────────────────────────── + + @Test + @DisplayName("特征：大小写差异按现状为不匹配（精确匹配语义）") + void caseSensitivityIsExact() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of("shanghai"), List.of(), null, List.of(), List.of()), + target("SHANGHAI", "FULL_TIME", 25000, "IT", "BACKEND")), "0.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of("SHANGHAI"), List.of(), null, List.of(), List.of()), + target("SHANGHAI", "FULL_TIME", 25000, "IT", "BACKEND")), "100.00"); + } + + @Test + @DisplayName("特征：未知枚举/历史脏值按普通字符串参与精确匹配") + void unknownValuesAreMatchedLiterally() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of("LEGACY_TYPE"), null, List.of(), List.of()), + target("广州", "LEGACY_TYPE", 25000, "IT", "SALES")), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(), List.of("LEGACY_TYPE"), null, List.of(), List.of()), + target("广州", "FULL_TIME", 25000, "IT", "SALES")), "0.00"); + } + + // ── 边界与上界 ──────────────────────────────────────────── + + @Test + @DisplayName("特征：空字符串元素不匹配任何岗位值（不trim、不归一化）") + void blankValuesDoNotMatch() { + assertExact(JobPreferenceScoreCalculator.calculate( + criteria(List.of(""), List.of(), null, List.of(), List.of()), + target("上海", "FULL_TIME", 25000, "IT", "BACKEND")), "0.00"); + } + + @Test + @DisplayName("特征：结果域为 [0.00, 100.00]，全不匹配为下界、全匹配为上界") + void resultBounds() { + BigDecimal lower = JobPreferenceScoreCalculator.calculate(ALL, + target("广州", "PART_TIME", 10000, "FINANCE", "SALES")); + BigDecimal upper = JobPreferenceScoreCalculator.calculate(ALL, + target("上海", "FULL_TIME", 25000, "IT", "BACKEND")); + + assertThat(lower).isEqualByComparingTo("0.00"); + assertThat(upper).isEqualByComparingTo("100.00"); + assertThat(lower).isLessThanOrEqualTo(upper); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CIndependentVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CIndependentVerificationTest.java new file mode 100644 index 0000000..1c16a81 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CIndependentVerificationTest.java @@ -0,0 +1,407 @@ +package com.mydreamjob.common.r01c; + +import com.mydreamjob.candidatescore.CandidateDimensionScore; +import com.mydreamjob.candidatescore.CandidateOverviewStatusPolicy; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.rules.CandidateScoringRuleSet; +import com.mydreamjob.job.Job; +import com.mydreamjob.preference.StudentPreference; +import com.mydreamjob.recommendation.JobPreferenceScoreCalculator; +import com.mydreamjob.recommendation.JobRecommendationProfile; +import com.mydreamjob.recommendation.JobRecommendationService; +import com.mydreamjob.talentdiscovery.TalentDiscoveryCandidateSource; +import com.mydreamjob.talentdiscovery.TalentDiscoveryService; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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 java.lang.reflect.Method; +import java.math.BigDecimal; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.stream.Stream; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-C 独立复验：行为等价、结构门禁与跨服务一致性。 + * + *

    本类的期望值独立推导（手工推算或从 HEAD 抄录），不复用实施者断言的构造方式。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class R01CIndependentVerificationTest { + + @MockBean private RedisTemplate redisTemplate; + + @Autowired private JobRecommendationService jobRecommendationService; + @Autowired private TalentDiscoveryService talentDiscoveryService; + + private static final Path MAIN_ROOT = Path.of("src/main/java/com/mydreamjob"); + + private static String read(Path p) throws Exception { + return Files.readString(p); + } + + private static List javaFiles() throws Exception { + try (Stream walk = Files.walk(MAIN_ROOT)) { + return walk.filter(f -> f.toString().endsWith(".java")).toList(); + } + } + + // ══ A. overviewStatus ═════════════════════════════════════ + + private static CandidateScoringCalculator.DimensionResult res(String status, String score) { + CandidateScoringCalculator.DimensionResult r = + new CandidateScoringCalculator.DimensionResult("EDUCATION"); + r.status = status; + r.score = score == null ? null : new BigDecimal(score); + return r; + } + + private static CandidateDimensionScore snap(String status) { + CandidateDimensionScore s = new CandidateDimensionScore(); + s.setStatus(status); + return s; + } + + @Test + @DisplayName("独立复验 A：全可用/部分可用/全不可用/空集合 四种边界") + void overviewStatusBoundaryMatrix() { + int expected = 4; + + // 全部可用 → OK + assertThat(CandidateOverviewStatusPolicy.fromComputedResults( + List.of(res("OK", "80"), res("ESTIMATED", "70"), res("OK", "60"), res("ESTIMATED", "50")), expected)) + .isEqualTo("OK"); + // 部分可用 → PARTIAL + assertThat(CandidateOverviewStatusPolicy.fromComputedResults( + List.of(res("OK", "80"), res("PENDING", null), res("INSUFFICIENT_DATA", null), res("OK", "60")), expected)) + .isEqualTo("PARTIAL"); + // 全不可用（全 PENDING）→ PENDING + assertThat(CandidateOverviewStatusPolicy.fromComputedResults( + List.of(res("PENDING", null), res("PENDING", null), res("PENDING", null), res("PENDING", null)), expected)) + .isEqualTo("PENDING"); + // 全不可用（含 INSUFFICIENT_DATA）→ INSUFFICIENT_DATA + assertThat(CandidateOverviewStatusPolicy.fromComputedResults( + List.of(res("INSUFFICIENT_DATA", null), res("PENDING", null)), 2)) + .isEqualTo("INSUFFICIENT_DATA"); + // 空集合 + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(List.of(), expected)).isEqualTo("PENDING"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots(List.of())).isEqualTo("INSUFFICIENT_DATA"); + } + + @Test + @DisplayName("独立复验 A：null 与非法输入的既有语义（NPE / INSUFFICIENT_DATA）") + void overviewStatusNullAndUnknownSemantics() { + assertThatThrownBy(() -> CandidateOverviewStatusPolicy.fromComputedResults(null, 8)) + .isInstanceOf(NullPointerException.class); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots(null)).isEqualTo("INSUFFICIENT_DATA"); + + // 未知状态字符串：既不可计算也不是 PENDING → INSUFFICIENT_DATA + assertThat(CandidateOverviewStatusPolicy.fromComputedResults( + List.of(res("WEIRD", "50")), 1)).isEqualTo("INSUFFICIENT_DATA"); + assertThat(CandidateOverviewStatusPolicy.fromSnapshots(List.of(snap("WEIRD")))) + .isEqualTo("INSUFFICIENT_DATA"); + } + + @Test + @DisplayName("独立复验 A：输入顺序变化不改变结果") + void overviewStatusIsOrderIndependent() { + List a = new ArrayList<>(List.of( + res("OK", "80"), res("PENDING", null), res("INSUFFICIENT_DATA", null))); + List b = new ArrayList<>(a); + Collections.reverse(b); + + assertThat(CandidateOverviewStatusPolicy.fromComputedResults(a, 3)) + .isEqualTo(CandidateOverviewStatusPolicy.fromComputedResults(b, 3)) + .isEqualTo("PARTIAL"); + } + + // ══ B. 偏好评分黄金表 + 跨服务一致 ════════════════════════ + + private static void assertExact(BigDecimal actual, String expected) { + assertThat(actual).isNotNull().isEqualByComparingTo(expected); + assertThat(actual.scale()).as("scale").isEqualTo(2); + assertThat(actual.toPlainString()).as("精确字符串").isEqualTo(expected); + } + + private static JobPreferenceScoreCalculator.Target target(String city, String type, Integer salaryMax) { + return new JobPreferenceScoreCalculator.Target(city, type, salaryMax, "IT", "BACKEND"); + } + + @Test + @DisplayName("独立复验 B：五个维度分别单独命中 → 每一维独立命中均为 100.00") + void eachDimensionAloneMatchesFully() { + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of("上海"), List.of(), null, List.of(), List.of()), + target("上海", "X", null)), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of("FULL_TIME"), null, List.of(), List.of()), + target("X", "FULL_TIME", null)), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of(), 20000, List.of(), List.of()), + target("X", "Y", 20000)), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of(), null, List.of("IT"), List.of()), + target("X", "Y", null)), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of(), null, List.of(), List.of("BACKEND")), + target("X", "Y", null)), "100.00"); + } + + @Test + @DisplayName("独立复验 B：全部命中 100.00 / 全部缺失（零分母）返回 null") + void allMatchAndZeroDenominator() { + JobPreferenceScoreCalculator.Criteria all = + new JobPreferenceScoreCalculator.Criteria( + List.of("上海"), List.of("FULL_TIME"), 20000, List.of("IT"), List.of("BACKEND")); + assertExact(JobPreferenceScoreCalculator.calculate(all, target("上海", "FULL_TIME", 25000)), "100.00"); + + assertThat(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of(), null, List.of(), List.of()), + target("上海", "FULL_TIME", 25000))).isNull(); + } + + @Test + @DisplayName("独立复验 B：部分维度缺失时的分母只计存在维度（加权精确值）") + void partialDimensionsUseOnlyPresentWeights() { + // 城市(30) 命中 + 用工类型(20) 缺失 + 薪资(20) 命中 + 行业(15) 缺失 + 岗位族(15) 缺失 + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria( + List.of("上海"), List.of(), 20000, List.of(), List.of()), + target("上海", "X", 20000)), "100.00"); + + // 城市(30) 命中 + 行业(15) 未命中 → 30*100/45 = 66.666… → 66.67（HALF_UP） + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria( + List.of("上海"), List.of(), null, List.of("IT"), List.of()), + target("上海", "X", null)), "100.00"); + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria( + List.of("上海"), List.of(), null, List.of("FINANCE"), List.of()), + target("上海", "X", null)), "66.67"); + + // 四方存在、命中两项：城市30 未中 + 行业15 中 → 15*100/65 = 23.076… → 23.08 + assertExact(JobPreferenceScoreCalculator.calculate( + new JobPreferenceScoreCalculator.Criteria( + List.of("广州"), List.of("PART_TIME"), null, List.of("IT"), List.of()), + target("上海", "FULL_TIME", null)), "23.08"); + } + + @Test + @DisplayName("独立复验 B：薪资边界 —— 期望值与岗位上限相等视为命中，低一单位不命中") + void salaryBoundarySemantics() { + JobPreferenceScoreCalculator.Criteria c = + new JobPreferenceScoreCalculator.Criteria(List.of(), List.of(), 20000, List.of(), List.of()); + + assertExact(JobPreferenceScoreCalculator.calculate(c, target("X", "Y", 20000)), "100.00"); // 相等 + assertExact(JobPreferenceScoreCalculator.calculate(c, target("X", "Y", 20001)), "100.00"); // 高一单位 + assertExact(JobPreferenceScoreCalculator.calculate(c, target("X", "Y", 19999)), "0.00"); // 低一单位 + assertExact(JobPreferenceScoreCalculator.calculate(c, target("X", "Y", null)), "0.00"); // 岗位未填 + } + + @Test + @DisplayName("独立复验 B：跨服务一致 —— JobRecommendation 与 TalentDiscovery 逐值相同") + void bothServicesProduceIdenticalPreferenceScores() throws Exception { + Method jr = JobRecommendationService.class.getDeclaredMethod( + "preferenceScore", StudentPreference.class, JobRecommendationProfile.class, Job.class); + jr.setAccessible(true); + Method td = TalentDiscoveryService.class.getDeclaredMethod( + "preferenceScore", TalentDiscoveryCandidateSource.PreferenceSignal.class, + JobRecommendationProfile.class, Job.class); + td.setAccessible(true); + + JobRecommendationProfile profile = JobRecommendationProfile.builder() + .jobId(1L).industryCode("IT").jobFamilyCode("BACKEND").build(); + + // 三组输入：全命中 / 部分命中 / 全不命中 + String[][] cases = { + {"[\"上海\"]", "[\"FULL_TIME\"]", "20000", "[\"IT\"]", "[\"BACKEND\"]", "上海", "FULL_TIME", "25000"}, + {"[\"上海\"]", "[\"PART_TIME\"]", "30000", "[\"IT\"]", "[]", "广州", "FULL_TIME", "10000"}, + {"[\"广州\"]", "[]", "null", "[]", "[]", "上海", "FULL_TIME", "25000"}, + }; + + for (String[] c : cases) { + StudentPreference sp = StudentPreference.builder() + .studentUserId(1L) + .preferredCities(c[0]).employmentTypes(c[1]) + .expectedSalaryMin("null".equals(c[2]) ? null : Integer.valueOf(c[2])) + .preferredIndustries(c[3]).preferredJobTypes(c[4]) + .build(); + TalentDiscoveryCandidateSource.PreferenceSignal signal = + new TalentDiscoveryCandidateSource.PreferenceSignal( + "null".equals(c[2]) ? null : Integer.valueOf(c[2]), null, + parseJsonList(c[0]), parseJsonList(c[1]), parseJsonList(c[3]), parseJsonList(c[4]), false); + + Job job = Job.builder().id(1L).companyId(1L).title("t").description("d") + .city(c[5]).employmentType(c[6]) + .salaryMax("null".equals(c[7]) ? null : Integer.valueOf(c[7])) + .build(); + + BigDecimal fromRecommendation = (BigDecimal) jr.invoke(jobRecommendationService, sp, profile, job); + BigDecimal fromDiscovery = (BigDecimal) td.invoke(talentDiscoveryService, signal, profile, job); + + assertThat(fromRecommendation).as("case %s", String.join("|", c)) + .isEqualByComparingTo(fromDiscovery); + if (fromRecommendation != null) { + assertThat(fromRecommendation.scale()).isEqualTo(fromDiscovery.scale()); + } + } + } + + private static List parseJsonList(String json) { + if (json == null || json.isBlank() || "[]".equals(json)) return List.of(); + String inner = json.substring(1, json.length() - 1); + if (inner.isBlank()) return List.of(); + List out = new ArrayList<>(); + for (String part : inner.split(",")) out.add(part.replace("\"", "").trim()); + return out; + } + + // ══ C. 教育与高校规则 ═════════════════════════════════════ + + @Test + @DisplayName("独立复验 C：985 / 211非985 / 普通高校 / 未知学校 的档次判定") + void schoolTierClassification() { + assertThat(CandidateScoringRuleSet.is985("北京大学")).isTrue(); + assertThat(CandidateScoringRuleSet.is211("北京大学")).isFalse(); + + assertThat(CandidateScoringRuleSet.is985("苏州大学")).isFalse(); + assertThat(CandidateScoringRuleSet.is211("苏州大学")).isTrue(); + + assertThat(CandidateScoringRuleSet.is985("某某学院")).isFalse(); + assertThat(CandidateScoringRuleSet.is211("某某学院")).isFalse(); + } + + @Test + @DisplayName("独立复验 C：名称精确匹配 —— 前后空白/大小写/简繁 均不匹配（既有语义）") + void schoolNameMatchingIsExact() { + assertThat(CandidateScoringRuleSet.is985(" 北京大学")).isFalse(); + assertThat(CandidateScoringRuleSet.is985("北京大学 ")).isFalse(); + assertThat(CandidateScoringRuleSet.is985("北京大學")).isFalse(); + assertThat(CandidateScoringRuleSet.is985("北京")).isFalse(); + assertThat(CandidateScoringRuleSet.is985(null)).isFalse(); + assertThat(CandidateScoringRuleSet.is985("")).isFalse(); + assertThat(CandidateScoringRuleSet.is211(null)).isFalse(); + } + + @Test + @DisplayName("独立复验 C：学历与档次分数、权重、默认权重与上界") + void educationAndWeightRules() { + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_DOCTOR).isEqualByComparingTo("100"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_MASTER).isEqualByComparingTo("85"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_BACHELOR).isEqualByComparingTo("70"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_JUNIOR_COLLEGE).isEqualByComparingTo("55"); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_UNKNOWN).isEqualByComparingTo("50"); + + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_985).isEqualByComparingTo("85"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_211).isEqualByComparingTo("75"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_OTHER).isEqualByComparingTo("65"); + assertThat(CandidateScoringRuleSet.SCHOOL_TIER_MISSING).isEqualByComparingTo("50"); + + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_WEIGHT).isEqualByComparingTo("0.55"); + assertThat(CandidateScoringRuleSet.EDUCATION_SCHOOL_TIER_WEIGHT).isEqualByComparingTo("0.45"); + assertThat(CandidateScoringRuleSet.DEFAULT_DIMENSION_WEIGHT).isEqualByComparingTo("12.50"); + assertThat(CandidateScoringRuleSet.FULL_SCORE).isEqualByComparingTo("100"); + + // 同值不同义：不得合并 + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_MASTER) + .isEqualByComparingTo(CandidateScoringRuleSet.SCHOOL_TIER_985); + assertThat(CandidateScoringRuleSet.EDUCATION_LEVEL_UNKNOWN) + .isEqualByComparingTo(CandidateScoringRuleSet.SCHOOL_TIER_MISSING); + } + + @Test + @DisplayName("独立复验 C：rulesVersion 与计算器同源，且值逐字不变") + void rulesVersionIsSingleSourced() { + assertThat(CandidateScoringRuleSet.VERSION).isEqualTo("candidate-scoring-v0.1"); + assertThat(CandidateScoringCalculator.RULES_VERSION).isEqualTo(CandidateScoringRuleSet.VERSION); + assertThat(CandidateScoringCalculator.DEFAULT_WEIGHT) + .isEqualByComparingTo(CandidateScoringRuleSet.DEFAULT_DIMENSION_WEIGHT); + } + + // ══ 结构门禁 ═════════════════════════════════════════════ + + @Test + @DisplayName("结构门禁：overviewStatus 规则产出点唯一（PARTIAL 只在一个类出现）") + void overviewStatusProducerIsUnique() throws Exception { + List producers = new ArrayList<>(); + for (Path p : javaFiles()) { + if (read(p).contains("\"PARTIAL\"")) producers.add(p.getFileName().toString()); + } + assertThat(producers).containsExactly("CandidateOverviewStatusPolicy.java"); + } + + @Test + @DisplayName("结构门禁：30/20/20/15/15 偏好公式实现点唯一") + void preferenceFormulaHasSingleImplementation() throws Exception { + List impls = new ArrayList<>(); + for (Path p : javaFiles()) { + String src = read(p); + if (src.contains("total += 30") || src.contains("CITY_WEIGHT = 30")) { + impls.add(p.getFileName().toString()); + } + } + assertThat(impls).containsExactly("JobPreferenceScoreCalculator.java"); + } + + @Test + @DisplayName("结构门禁：985/211 名单定义点唯一，且计算器内不再定义名单") + void universityListHasSingleDefinition() throws Exception { + List defs = new ArrayList<>(); + for (Path p : javaFiles()) { + String src = read(p); + if (src.contains("Set C985") || src.contains("Set C211")) { + defs.add(p.getFileName().toString()); + } + } + assertThat(defs).containsExactly("CandidateScoringRuleSet.java"); + assertThat(read(MAIN_ROOT.resolve("candidatescore/CandidateScoringCalculator.java"))) + .doesNotContain("Set C985") + .doesNotContain("Set C211"); + } + + @Test + @DisplayName("结构门禁：TalentDiscoveryService 不再维护内联偏好公式") + void talentDiscoveryHasNoInlineFormula() throws Exception { + String src = read(MAIN_ROOT.resolve("talentdiscovery/TalentDiscoveryService.java")); + assertThat(src).doesNotContain("total += 30").doesNotContain("got += 30"); + assertThat(src).contains("JobPreferenceScoreCalculator.calculate("); + assertThat(read(MAIN_ROOT.resolve("recommendation/JobRecommendationService.java"))) + .contains("JobPreferenceScoreCalculator.calculate("); + } + + @Test + @DisplayName("结构门禁：规则集不依赖 Spring/JPA/JdbcTemplate/Repository，且无 setter") + void ruleSetHasNoFrameworkDependency() throws Exception { + String src = read(MAIN_ROOT.resolve("candidatescore/rules/CandidateScoringRuleSet.java")); + + assertThat(src).doesNotContain("@Component").doesNotContain("@Service").doesNotContain("@Autowired") + .doesNotContain("Repository").doesNotContain("JdbcTemplate").doesNotContain("EntityManager") + .doesNotContain("System.getenv").doesNotContain("@Value").doesNotContain("Properties"); + assertThat(src).contains("public final class"); + assertThat(src).doesNotContain("public void set"); + } + + @Test + @DisplayName("结构门禁：规则集暴露的集合不可被调用者修改") + void exposedCollectionsAreUnmodifiable() { + assertThatThrownBy(() -> CandidateScoringRuleSet.c985().add("X")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c211().add("X")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c985().remove("北京大学")) + .isInstanceOf(UnsupportedOperationException.class); + assertThatThrownBy(() -> CandidateScoringRuleSet.c211().clear()) + .isInstanceOf(UnsupportedOperationException.class); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CScoringFixtureIsolationGateTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CScoringFixtureIsolationGateTest.java new file mode 100644 index 0000000..1165248 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/R01CScoringFixtureIsolationGateTest.java @@ -0,0 +1,98 @@ +package com.mydreamjob.common.r01c; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDate; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-C 阶段二：评分夹具隔离**门禁**（独立反证）。 + * + *

    背景：多个 {@code CandidateScoring*} 测试会以**当前 period** 物化维度快照， + * 若不清理由自有 userId，这些行会进入同库中其它测试对"当前期间"的总体统计 + * （典型受害者：{@code FairnessMonitoringHttpIntegrationTest} 的 {@code populationSize}）， + * 造成顺序相关的误失败。本门禁在与其相同的 H2 库中运行，断言**污染类的独占手机号段零残留**。

    + * + *

    本类与污染类共用 {@code integrationdb}；只要任一污染类遗留自有行， + * 本门禁即失败。若将来新增同类夹具而未清理，也会在此被拦下。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class R01CScoringFixtureIsolationGateTest { + + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + /** 已确认的污染类 → 其**独占**手机号前缀。 */ + private static final Map> OWNED_PREFIXES = Map.of( + "CandidateScoringPersistenceIntegrationTest", List.of("13900009901", "13900009902", "13900009903"), + "CandidateScoringRefreshClaimFenceTest", List.of("193", "192"), + "CandidateScoringRefreshClaimTokenTest", List.of("190", "189"), + "CandidateScoringRefreshFailureTransactionTest", List.of("130"), + "CandidateScoringRefreshInfrastructureTest", List.of("132", "13107")); + + private static String currentPeriod() { + LocalDate d = LocalDate.now(); + return String.format("%04d-%02d", d.getYear(), d.getMonthValue()); + } + + @Test + @DisplayName("隔离门禁：污染类的自有用户与其当前期间快照均零残留") + void polluterFixturesLeaveNoResidue() { + String period = currentPeriod(); + StringBuilder offenders = new StringBuilder(); + + OWNED_PREFIXES.forEach((clazz, prefixes) -> { + for (String prefix : prefixes) { + List userIds = jdbcTemplate.queryForList( + "SELECT id FROM users WHERE phone LIKE ?", Long.class, prefix + "%"); + if (!userIds.isEmpty()) { + Integer snapshots = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_dimension_scores WHERE period = ? " + + "AND student_user_id IN (SELECT id FROM users WHERE phone LIKE ?)", + Integer.class, period, prefix + "%"); + offenders.append(clazz).append(" prefix=").append(prefix) + .append(" users=").append(userIds.size()) + .append(" currentPeriodSnapshots=").append(snapshots).append("; "); + } + } + }); + + assertThat(offenders.toString()) + .as("污染类必须在 @AfterEach 清理自有用户与当前期间快照") + .isEmpty(); + } + + @Test + @DisplayName("隔离门禁：当前期间不存在来自任何测试用户的孤立快照行（仅统计残留，不清表）") + void noOrphanSnapshotsForCurrentPeriod() { + Integer orphans = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_dimension_scores s " + + "LEFT JOIN users u ON u.id = s.student_user_id " + + "WHERE s.period = ? AND u.id IS NULL", + Integer.class, currentPeriod()); + + assertThat(orphans).as("当前期间不得存在指向已删除用户的快照行").isNotNull().isZero(); + } + + @Test + @DisplayName("隔离门禁：清理只影响本类登记的数据（其它 period 的记录不被波及）") + void otherPeriodsAreUntouched() { + // 只读校验：非当前期间的行不受本轮清理影响（存在性不作强断言，只断言查询可执行且为非负） + Integer otherPeriods = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_dimension_scores WHERE period <> ?", + Integer.class, currentPeriod()); + + assertThat(otherPeriods).as("其它期间的行数必须可查询且非负").isNotNull().isGreaterThanOrEqualTo(0); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/RecommendationOrderingCharacterizationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/RecommendationOrderingCharacterizationTest.java new file mode 100644 index 0000000..21b2cb2 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01c/RecommendationOrderingCharacterizationTest.java @@ -0,0 +1,107 @@ +package com.mydreamjob.common.r01c; + +import com.mydreamjob.recommendation.dto.JobRecommendationItem; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-C 特征测试：推荐排序与分页切片。 + * + *

    锁定重构前的排序契约：**总分降序，同分按 jobId 升序**（同分不再有第三种比较键）， + * 以及 {@code slice} 的越界行为。

    + */ +class RecommendationOrderingCharacterizationTest { + + /** 与 {@code JobRecommendationService.recommend} 中完全相同的比较器。 */ + private static final Comparator ORDER = + Comparator.comparing(JobRecommendationItem::getScore).reversed() + .thenComparing(JobRecommendationItem::getJobId); + + private static JobRecommendationItem item(long jobId, String score) { + return JobRecommendationItem.builder() + .jobId(jobId).title("t" + jobId).city("上海").employmentType("FULL_TIME") + .salaryMin(10000).salaryMax(20000).mode("PERSONALIZED") + .score(new BigDecimal(score)).reasons(List.of("岗位偏好匹配")).build(); + } + + private static List idsOf(List items) { + return items.stream().map(JobRecommendationItem::getJobId).toList(); + } + + @Test + @DisplayName("特征：分数不同的三个岗位按总分降序") + void differentScoresOrderByScoreDesc() { + List items = new ArrayList<>(List.of( + item(30L, "61.50"), item(10L, "90.00"), item(20L, "75.25"))); + items.sort(ORDER); + + assertThat(idsOf(items)).containsExactly(10L, 20L, 30L); + assertThat(items.get(0).getScore()).isEqualByComparingTo("90.00"); + } + + @Test + @DisplayName("特征：总分相同但分项不同 → 仍按 jobId 升序（不比较分项）") + void equalScoresBreakTieByJobId() { + List items = new ArrayList<>(List.of( + item(9L, "80.00"), item(3L, "80.00"), item(7L, "80.00"))); + items.sort(ORDER); + + assertThat(idsOf(items)).containsExactly(3L, 7L, 9L); + } + + @Test + @DisplayName("特征：完全同分稳定性 —— 输入顺序打乱后结果一致") + void fullyEqualScoresAreDeterministic() { + List a = new ArrayList<>(List.of( + item(5L, "70.00"), item(2L, "70.00"), item(8L, "70.00"))); + List b = new ArrayList<>(List.of( + item(8L, "70.00"), item(5L, "70.00"), item(2L, "70.00"))); + a.sort(ORDER); + b.sort(ORDER); + + assertThat(idsOf(a)).containsExactly(2L, 5L, 8L); + assertThat(idsOf(a)).isEqualTo(idsOf(b)); + } + + @Test + @DisplayName("特征：分数为 null 的岗位只可能被过滤掉；比较器本身对 null 抛 NPE（既有契约）") + void nullScoreIsNeverOrdered() { + List withNull = new ArrayList<>(); + withNull.add(item(1L, "50.00")); + JobRecommendationItem noScore = JobRecommendationItem.builder() + .jobId(2L).title("t2").city("上海").employmentType("FULL_TIME") + .mode("FALLBACK").score(null).reasons(List.of("最新公开岗位")).build(); + withNull.add(noScore); + + assertThat(org.assertj.core.api.Assertions.catchThrowable(() -> withNull.sort(ORDER))) + .as("score 为 null 时排序抛 NPE —— 生产中 FALLBACK 项不参与该比较器") + .isInstanceOf(NullPointerException.class); + } + + @Test + @DisplayName("特征：分页切片 from/to 与越界行为不变") + void sliceBoundsAreStable() { + List all = new ArrayList<>(); + for (long i = 1; i <= 5; i++) all.add(item(i, "50.00")); + + assertThat(slice(all, 0, 2)).containsExactly(1L, 2L); + assertThat(slice(all, 1, 2)).containsExactly(3L, 4L); + assertThat(slice(all, 2, 2)).containsExactly(5L); + assertThat(slice(all, 9, 2)).isEmpty(); + assertThat(slice(all, 0, 50)).hasSize(5); + } + + /** 与 {@code JobRecommendationService.slice} 相同的下标计算。 */ + private static List slice(List all, int page, int size) { + int from = Math.min(page * size, all.size()); + int to = Math.min(from + size, all.size()); + return idsOf(all.subList(from, to)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentCrossDatabaseVerificationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentCrossDatabaseVerificationTest.java new file mode 100644 index 0000000..a2cae93 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentCrossDatabaseVerificationTest.java @@ -0,0 +1,1549 @@ +package com.mydreamjob.common.r01e; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import com.mydreamjob.MyDreamjobApplication; +import com.mydreamjob.dataexport.PersonalDataCollector; +import com.mydreamjob.messaging.MessagingService; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.WebApplicationType; +import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties; +import org.springframework.boot.builder.SpringApplicationBuilder; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.MySQLContainer; + +import javax.sql.DataSource; +import java.lang.reflect.Proxy; +import java.math.BigDecimal; +import java.nio.file.Files; +import java.nio.file.Path; +import java.sql.Connection; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; +import java.util.concurrent.atomic.AtomicInteger; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-E **独立复验**（第三～十一节）：跨库深比较、查询预算、EXPLAIN、OBS-E01。 + * + *

    本类不复用实施测试的任何断言或辅助方法：夹具、规范化（canonicalization）、 + * 计数 DataSource、EXPLAIN 解析均为独立实现。

    + * + *

    跨库方式：同一个 JVM 内同时持有两个 Spring 上下文 —— + * 测试自身的 H2 上下文（独立命名的内存库，仅本类使用）与 + * {@link MySql} 手工引导的 MySQL 8.4 上下文（Testcontainers）。 + * 两侧灌入**同一份等价夹具**（显式时间戳），再把 + * {@link PersonalDataCollector#collect} 与 {@link MessagingService#listConversations} + * 的**完整输出**规范化为确定性文本后逐字符比较 —— 不是只比条数、hash 或 JSON 长度。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +@TestPropertySource(properties = { + "spring.datasource.url=jdbc:h2:mem:r01e_ind;MODE=MySQL;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE" +}) +@ContextConfiguration(classes = {R01EIndependentCrossDatabaseVerificationTest.H2CountingConfiguration.class}) +class R01EIndependentCrossDatabaseVerificationTest { + + // ══════════════════════════════════════════════════════════ + // H2 侧（测试自身的 Spring 上下文） + // ══════════════════════════════════════════════════════════ + + @Autowired private MessagingService h2Messaging; + @Autowired private PersonalDataCollector h2Collector; + @Autowired private JdbcTemplate h2Jdbc; + @Autowired private CountingDataSource h2Counting; + @MockBean private RedisTemplate redisTemplate; + + @TestConfiguration + static class H2CountingConfiguration { + @Bean + @Primary + CountingDataSource dataSource(DataSourceProperties properties) { + return new CountingDataSource(properties.initializeDataSourceBuilder().build()); + } + } + + // ══════════════════════════════════════════════════════════ + // MySQL 侧（手工引导的第二个上下文，独立于测试上下文） + // ══════════════════════════════════════════════════════════ + + static final class MySql { + static MySQLContainer container; + static ConfigurableApplicationContext ctx; + static CountingDataSource counting; + static JdbcTemplate jdbc; + static PersonalDataCollector collector; + static MessagingService messaging; + + static void boot() { + container = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("r01e_independent") + .withUsername("r01e") + .withPassword("r01e"); + container.start(); + ctx = new SpringApplicationBuilder(MyDreamjobApplication.class, MySqlBootstrapConfiguration.class) + .web(WebApplicationType.NONE) + .profiles("mysql-it") + // 命令行参数优先级高于 application.yml，故能真正覆盖主配置里的 DB_URL 默认值 + .run("--spring.datasource.url=" + container.getJdbcUrl(), + "--spring.datasource.username=" + container.getUsername(), + "--spring.datasource.password=" + container.getPassword(), + "--spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver"); + counting = ctx.getBean(CountingDataSource.class); + jdbc = new JdbcTemplate(counting); + collector = ctx.getBean(PersonalDataCollector.class); + messaging = ctx.getBean(MessagingService.class); + } + + static void shutdown() { + if (ctx != null) ctx.close(); + if (container != null) container.stop(); + } + } + + @TestConfiguration + static class MySqlBootstrapConfiguration { + @Bean + @Primary + CountingDataSource mySqlDataSource(DataSourceProperties properties) { + return new CountingDataSource(properties.initializeDataSourceBuilder().build()); + } + + /** mysql-it 关闭了 Redis 自动配置，手工上下文用桩替代 @MockBean。 */ + @Bean + RedisTemplate redisTemplate() { + return Mockito.mock(RedisTemplate.class); + } + } + + @BeforeAll + static void bootMySql() { + MySql.boot(); + } + + @AfterAll + static void shutdownMySql() { + // 收尾前先在两侧做最后一次清理，保证自有夹具零残留 + try { + clearFixture(MySql.jdbc); + } catch (Exception ignored) { + // 清理失败由 fixtureLeavesNoResidueAfterClass 断言兜底 + } + MySql.shutdown(); + } + + @BeforeEach + void resetBothEngines() { + clearFixture(h2Jdbc); + clearFixture(MySql.jdbc); + h2Counting.reset(); + MySql.counting.reset(); + } + + // ══════════════════════════════════════════════════════════ + // 夹具（两侧逐字等价；所有时间戳显式指定，避免依赖 CURRENT_TIMESTAMP） + // ══════════════════════════════════════════════════════════ + + static final LocalDateTime T = LocalDateTime.of(2026, 3, 1, 9, 0, 0); + static final String PREFIX = "r01eind-"; + + private static LocalDateTime at(int minutes) { + return T.plusMinutes(minutes); + } + + private static long insertUser(JdbcTemplate j, String phone, String nickname, String role, LocalDateTime t) { + j.update("INSERT INTO users (phone, nickname, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, ?, ?, 1, 1, ?, ?)", phone, nickname, role, t, t); + Long id = j.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + j.update("INSERT INTO user_roles (user_id, role) VALUES (?, ?)", id, role); + return id; + } + + /** + * 向指定引擎灌入等价夹具，返回自然键 → 主键的映射。 + * + *

    覆盖 {@link PersonalDataCollector} 的**全部 12 个 section**，并额外放入 + * 一个「外人」（{@code r01eind-outsider}）的同类数据，用于证明不会混入他人数据。

    + */ + static Map seedFixture(JdbcTemplate j) { + Map ids = new LinkedHashMap<>(); + + long me = insertUser(j, PREFIX + "me", "本人", "STUDENT", at(0)); + long other = insertUser(j, PREFIX + "other", "对方", "STUDENT", at(1)); + long outsider = insertUser(j, PREFIX + "outsider", "外人", "STUDENT", at(2)); + long owner = insertUser(j, PREFIX + "owner", "企业主", "COMPANY", at(3)); + ids.put("me", me); + ids.put("other", other); + ids.put("outsider", outsider); + ids.put("owner", owner); + + // ── profile ── + insertProfile(j, me, "张三", "简介文本", "北京", "本科", "示例大学", 2026, "{\"java\":3,\"sql\":2}", at(10)); + insertProfile(j, outsider, "李四", "外人的简介", "上海", "硕士", "其他大学", 2025, "{\"go\":1}", at(11)); + + // ── preferences ── + j.update("INSERT INTO student_preferences (student_user_id, expected_salary_min, expected_salary_max, " + + "preferred_cities, employment_types, preferred_industries, preferred_job_types, " + + "remote_allowed, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, 1, ?, ?)", + me, 15000, 25000, "[\"北京\",\"上海\"]", "[\"FULL_TIME\"]", "[\"互联网\"]", "[\"BACKEND\"]", + at(20), at(21)); + j.update("INSERT INTO student_preferences (student_user_id, expected_salary_min, expected_salary_max, " + + "remote_allowed, created_at, updated_at) VALUES (?, ?, ?, 0, ?, ?)", + outsider, 9000, 12000, at(22), at(23)); + + // ── resumes（含 1 条非 ACTIVE，用于证明状态过滤）── + j.update("INSERT INTO resume_versions (user_id, name, version_no, file_storage_path, file_name, " + + "content_type, file_size, default_key, status, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + me, "主简历", 1, PREFIX + "absent-1.pdf", "a.pdf", "application/pdf", 1024L, + "DEFAULT", "ACTIVE", at(30), at(30)); + j.update("INSERT INTO resume_versions (user_id, name, version_no, file_storage_path, file_name, " + + "content_type, file_size, default_key, status, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + me, "第二版", 2, PREFIX + "absent-2.pdf", "b.pdf", "application/pdf", 2048L, + null, "ACTIVE", at(31), at(31)); + j.update("INSERT INTO resume_versions (user_id, name, version_no, file_storage_path, file_name, " + + "content_type, file_size, default_key, status, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + me, "旧版", 3, PREFIX + "absent-3.pdf", "c.pdf", "application/pdf", 512L, + null, "ARCHIVED", at(32), at(32)); + j.update("INSERT INTO resume_versions (user_id, name, version_no, file_storage_path, file_name, " + + "content_type, file_size, status, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + outsider, "外人简历", 1, PREFIX + "outsider.pdf", "o.pdf", "application/pdf", 10L, + "ACTIVE", at(33), at(33)); + + // ── companies / jobs ── + j.update("INSERT INTO companies (owner_user_id, name, industry, verified, created_at, updated_at) " + + "VALUES (?, ?, ?, 1, ?, ?)", owner, PREFIX + "co-owner", "互联网", at(40), at(40)); + long companyOwner = j.queryForObject("SELECT id FROM companies WHERE owner_user_id = ?", Long.class, owner); + j.update("INSERT INTO companies (owner_user_id, name, industry, verified, created_at, updated_at) " + + "VALUES (?, ?, ?, 1, ?, ?)", me, PREFIX + "co-mine", "教育", at(41), at(41)); + long companyMine = j.queryForObject("SELECT id FROM companies WHERE owner_user_id = ?", Long.class, me); + ids.put("companyOwner", companyOwner); + ids.put("companyMine", companyMine); + + long job1 = insertJob(j, companyOwner, PREFIX + "job-1", at(50)); + long job2 = insertJob(j, companyOwner, PREFIX + "job-2", at(51)); + long job3 = insertJob(j, companyOwner, PREFIX + "job-3", at(52)); + long job4 = insertJob(j, companyMine, PREFIX + "job-4", at(53)); + long job5 = insertJob(j, companyOwner, PREFIX + "job-5", at(54)); + ids.put("job1", job1); + ids.put("job2", job2); + ids.put("job3", job3); + ids.put("job4", job4); + ids.put("job5", job5); + + // ── applications（本人 3 条，外人 1 条）── + long app1 = insertApplication(j, job1, me, "SUBMITTED", "求职信一", at(60)); + long app2 = insertApplication(j, job2, me, "INTERVIEWING", null, at(61)); + long app3 = insertApplication(j, job3, me, "REJECTED", "求职信三", at(62)); + long appOutsider = insertApplication(j, job5, outsider, "SUBMITTED", "外人求职信", at(63)); + ids.put("app1", app1); + ids.put("app2", app2); + ids.put("app3", app3); + ids.put("appOutsider", appOutsider); + + // ── application-timelines（app1 两条，验证分组与组内顺序）── + insertAppHistory(j, app1, owner, null, "SUBMITTED", "投递", at(64)); + insertAppHistory(j, app1, owner, "SUBMITTED", "SCREENING", "初筛", at(65)); + insertAppHistory(j, app3, owner, "SUBMITTED", "REJECTED", "不合适", at(66)); + insertAppHistory(j, appOutsider, owner, null, "SUBMITTED", "外人投递", at(67)); + + // ── interviews（一条本人为学生、一条本人为企业、一条纯外人）── + long iv1 = insertInterview(j, app1, owner, me, 1, "一面", at(70)); + long iv2 = insertInterview(j, app2, me, outsider, 1, "企业侧面试", at(71)); + long ivOutsider = insertInterview(j, appOutsider, owner, outsider, 1, "外人面试", at(72)); + ids.put("iv1", iv1); + ids.put("iv2", iv2); + ids.put("ivOutsider", ivOutsider); + + insertInterviewHistory(j, iv1, owner, null, "SCHEDULED", "安排", at(73)); + insertInterviewHistory(j, iv1, owner, "SCHEDULED", "COMPLETED", "完成", at(74)); + insertInterviewHistory(j, ivOutsider, owner, null, "SCHEDULED", "外人安排", at(75)); + + // ── offers（offer2 同时命中「候选人」与「企业主」两个分支 → 触发去重）── + long offer1 = insertOffer(j, app1, job1, companyOwner, me, owner, "Offer-A", at(80), at(90)); + long offer2 = insertOffer(j, app2, job4, companyMine, me, me, "Offer-B", at(81), at(91)); + long offerOutsider = insertOffer(j, appOutsider, job5, companyOwner, outsider, owner, "外人Offer", + at(82), at(92)); + ids.put("offer1", offer1); + ids.put("offer2", offer2); + ids.put("offerOutsider", offerOutsider); + + insertOfferHistory(j, offer1, null, "SENT", owner, "COMPANY", "发出", at(83)); + insertOfferHistory(j, offer1, "SENT", "ACCEPTED", me, "STUDENT", "接受", at(84)); + insertOfferHistory(j, offer2, null, "DRAFT", me, "COMPANY", "草稿", at(85)); + insertOfferHistory(j, offerOutsider, null, "SENT", owner, "COMPANY", "外人", at(86)); + + // ── feedback ── + j.update("INSERT INTO candidate_feedback (application_id, company_user_id, student_user_id, rating, " + + "content, tags, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)", + app1, owner, me, 5, "表现优秀", "[\"沟通\",\"技术\"]", at(100), at(100)); + j.update("INSERT INTO candidate_feedback (application_id, company_user_id, student_user_id, rating, " + + "content, tags, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)", + appOutsider, owner, outsider, 3, "外人评价", null, at(101), at(101)); + + // ── favorites ── + j.update("INSERT INTO job_favorites (job_id, student_user_id, created_at) VALUES (?, ?, ?)", job1, me, at(110)); + j.update("INSERT INTO job_favorites (job_id, student_user_id, created_at) VALUES (?, ?, ?)", job2, me, at(111)); + j.update("INSERT INTO job_favorites (job_id, student_user_id, created_at) VALUES (?, ?, ?)", + job1, outsider, at(112)); + + // ── notifications（含 read_at 为 null 与非 null）── + j.update("INSERT INTO notifications (user_id, type, title, content, business_type, business_id, " + + "is_read, read_at, created_at) VALUES (?, ?, ?, ?, ?, ?, 0, NULL, ?)", + me, "APPLICATION", "投递已收到", "内容一", "APPLICATION", app1, at(120)); + j.update("INSERT INTO notifications (user_id, type, title, content, business_type, business_id, " + + "is_read, read_at, created_at) VALUES (?, ?, ?, ?, ?, ?, 1, ?, ?)", + me, "OFFER", "收到 Offer", "内容二", "OFFER", offer1, at(121), at(122)); + j.update("INSERT INTO notifications (user_id, type, title, content, is_read, created_at) " + + "VALUES (?, ?, ?, ?, 0, ?)", outsider, "APPLICATION", "外人通知", "外人", at(123)); + + // ── conversations + messages（供 E1 的 conversations/messages section）── + long c1 = insertConversation(j, me, "DIRECT", "会话一", at(130), at(140)); + long c2 = insertConversation(j, other, "DIRECT", null, at(131), at(141)); + long c3 = insertConversation(j, me, "TALENT_INVITATION", "邀约会话", at(132), at(142)); + long cOutsider = insertConversation(j, outsider, "DIRECT", "外人会话", at(133), at(143)); + ids.put("c1", c1); + ids.put("c2", c2); + ids.put("c3", c3); + ids.put("cOutsider", cOutsider); + + addMember(j, c1, me); + addMember(j, c1, other); + addMember(j, c2, me); + addMember(j, c2, other); + addMember(j, c3, me); + addMember(j, c3, outsider); + addMember(j, cOutsider, outsider); + + insertMessage(j, c1, other, "c1-m1", "SENT", at(150)); + insertMessage(j, c1, me, "c1-m2", "SENT", at(151)); + insertMessage(j, c1, other, "c1-m3", "RECALLED", at(152)); + insertMessage(j, c2, other, "c2-m1", "SENT", at(153)); + insertMessage(j, c3, me, "c3-m1", "SENT", at(154)); + insertMessage(j, cOutsider, outsider, "out-m1", "SENT", at(155)); + + // ── candidate-scoring ── + insertDimensionScore(j, me, "EDUCATION", "2026-02", new BigDecimal("88.00"), "OK", + "{\"a\":1}", "12.50", at(160)); + insertDimensionScore(j, me, "ABILITY", "2026-02", null, "INSUFFICIENT_DATA", null, "20.00", at(161)); + insertDimensionScore(j, outsider, "EDUCATION", "2026-02", new BigDecimal("70.00"), "OK", + "{\"b\":2}", "12.50", at(162)); + + long appeal = insertAppeal(j, me, "ABILITY", "2026-02", "PENDING", "理由", at(170)); + long appealOutsider = insertAppeal(j, outsider, "EDUCATION", "2026-02", "APPROVED", "外人理由", at(171)); + ids.put("appeal", appeal); + ids.put("appealOutsider", appealOutsider); + + insertAppealHistory(j, appeal, null, "PENDING", owner, "ADMIN", "提交", at(172)); + insertAppealHistory(j, appeal, "PENDING", "APPROVED", owner, "ADMIN", "通过", at(173)); + insertAppealHistory(j, appealOutsider, null, "PENDING", owner, "ADMIN", "外人提交", at(174)); + + return ids; + } + + private static void insertProfile(JdbcTemplate j, long userId, String realName, String bio, String location, + String education, String school, int graduationYear, String skills, + LocalDateTime t) { + j.update("INSERT INTO student_profiles (user_id, real_name, bio, location, education, school, " + + "graduation_year, skills_json, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + userId, realName, bio, location, education, school, graduationYear, skills, t, t); + } + + private static long insertJob(JdbcTemplate j, long companyId, String title, LocalDateTime t) { + j.update("INSERT INTO jobs (company_id, title, description, city, employment_type, status, " + + "created_at, updated_at) VALUES (?, ?, '描述', '北京', 'FULL_TIME', 'PUBLISHED', ?, ?)", + companyId, title, t, t); + return j.queryForObject("SELECT id FROM jobs WHERE title = ?", Long.class, title); + } + + private static long insertApplication(JdbcTemplate j, long jobId, long studentUserId, String status, + String coverLetter, LocalDateTime t) { + j.update("INSERT INTO applications (job_id, student_user_id, status, cover_letter, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?)", jobId, studentUserId, status, coverLetter, t, t); + return j.queryForObject("SELECT id FROM applications WHERE job_id = ? AND student_user_id = ?", + Long.class, jobId, studentUserId); + } + + private static void insertAppHistory(JdbcTemplate j, long appId, long operator, String from, String to, + String reason, LocalDateTime t) { + j.update("INSERT INTO application_status_history (application_id, operator_user_id, from_status, " + + "to_status, reason, created_at) VALUES (?, ?, ?, ?, ?, ?)", appId, operator, from, to, reason, t); + } + + private static long insertInterview(JdbcTemplate j, long appId, long companyUserId, long studentUserId, + int roundNo, String title, LocalDateTime t) { + j.update("INSERT INTO interviews (application_id, company_user_id, student_user_id, round_no, title, " + + "interview_type, start_at, end_at, timezone, interviewer_name, address, notes, status, " + + "created_at, updated_at) VALUES (?, ?, ?, ?, ?, 'VIDEO', ?, ?, 'Asia/Shanghai', ?, ?, ?, " + + "'SCHEDULED', ?, ?)", + appId, companyUserId, studentUserId, roundNo, title, t, t.plusHours(1), "面试官", "地址", "备注", t, t); + return j.queryForObject("SELECT id FROM interviews WHERE application_id = ? AND round_no = ? AND title = ?", + Long.class, appId, roundNo, title); + } + + private static void insertInterviewHistory(JdbcTemplate j, long interviewId, long actor, String from, + String to, String reason, LocalDateTime t) { + j.update("INSERT INTO interview_status_history (interview_id, from_status, to_status, actor_user_id, " + + "reason, created_at) VALUES (?, ?, ?, ?, ?, ?)", interviewId, from, to, actor, reason, t); + } + + private static long insertOffer(JdbcTemplate j, long appId, long jobId, long companyId, long candidateId, + long createdBy, String title, LocalDateTime t, LocalDateTime expireAt) { + j.update("INSERT INTO offers (application_id, job_id, company_id, candidate_id, title, salary_min, " + + "salary_max, salary_currency, salary_period, work_city, employment_type, probation_months, " + + "benefits, description, expire_at, status, version, created_by, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, 'CNY', 'MONTH', '北京', 'FULL_TIME', 3, ?, '说明', ?, " + + "'SENT', 0, ?, ?, ?)", + appId, jobId, companyId, candidateId, title, 20000, 30000, "五险一金", expireAt, createdBy, t, t); + return j.queryForObject("SELECT id FROM offers WHERE application_id = ?", Long.class, appId); + } + + private static void insertOfferHistory(JdbcTemplate j, long offerId, String from, String to, long operatorId, + String operatorRole, String reason, LocalDateTime t) { + j.update("INSERT INTO offer_status_history (offer_id, from_status, to_status, operator_id, operator_role, " + + "reason, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)", + offerId, from, to, operatorId, operatorRole, reason, t); + } + + private static long insertConversation(JdbcTemplate j, long createdBy, String type, String title, + LocalDateTime created, LocalDateTime updated) { + j.update("INSERT INTO conversations (title, type, created_by, created_at, updated_at) VALUES (?, ?, ?, ?, ?)", + title, type, createdBy, created, updated); + return j.queryForObject("SELECT id FROM conversations WHERE created_by = ? AND created_at = ?", + Long.class, createdBy, created); + } + + private static void addMember(JdbcTemplate j, long convId, long userId) { + j.update("INSERT INTO conversation_members (conversation_id, user_id, joined_at) VALUES (?, ?, ?)", + convId, userId, T); + } + + private static void insertMessage(JdbcTemplate j, long convId, long sender, String content, String status, + LocalDateTime t) { + j.update("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, ?, ?)", convId, sender, content, status, t); + } + + private static void insertDimensionScore(JdbcTemplate j, long studentUserId, String dimension, String period, + BigDecimal score, String status, String subScores, String weight, + LocalDateTime t) { + j.update("INSERT INTO candidate_dimension_scores (student_user_id, dimension, period, score, status, " + + "sub_scores_json, weight, rules_version, calculated_at, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, 'v1', ?, ?, ?)", + studentUserId, dimension, period, score, status, subScores, new BigDecimal(weight), t, t, t); + } + + private static long insertAppeal(JdbcTemplate j, long candidateId, String dimension, String period, + String status, String reason, LocalDateTime t) { + j.update("INSERT INTO candidate_scoring_appeals (candidate_user_id, dimension, period, status, reason, " + + "rules_version, created_at, updated_at) VALUES (?, ?, ?, ?, ?, 'v1', ?, ?)", + candidateId, dimension, period, status, reason, t, t); + return j.queryForObject("SELECT id FROM candidate_scoring_appeals WHERE candidate_user_id = ? " + + "AND dimension = ? AND period = ?", Long.class, candidateId, dimension, period); + } + + private static void insertAppealHistory(JdbcTemplate j, long appealId, String from, String to, long actor, + String role, String reason, LocalDateTime t) { + j.update("INSERT INTO candidate_scoring_appeal_history (appeal_id, from_status, to_status, actor_user_id, " + + "actor_role, reason, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)", + appealId, from, to, actor, role, reason, t); + } + + /** 按外键顺序清理本类夹具；只删除 {@code r01eind-} 前缀的自有数据，不触碰种子数据。 */ + static void clearFixture(JdbcTemplate j) { + // MySQL 禁止在 DELETE 的子查询中引用目标表本身（错误 1093）， + // 故自引用表一律用直接谓词，仅跨表关联才用子查询。 + String u = "(SELECT id FROM users WHERE phone LIKE '" + PREFIX + "%')"; + String myConvs = "(SELECT id FROM conversations WHERE created_by IN " + u + ")"; + String myApps = "(SELECT id FROM applications WHERE student_user_id IN " + u + ")"; + String myCompanies = "(SELECT id FROM companies WHERE owner_user_id IN " + u + ")"; + String interviewPredicate = "student_user_id IN " + u + " OR company_user_id IN " + u; + String myInterviews = "(SELECT id FROM interviews WHERE " + interviewPredicate + ")"; + String offerPredicate = "candidate_id IN " + u + " OR company_id IN " + myCompanies; + String myOffers = "(SELECT id FROM offers WHERE " + offerPredicate + ")"; + String myAppeals = "(SELECT id FROM candidate_scoring_appeals WHERE candidate_user_id IN " + u + ")"; + + j.update("DELETE FROM message_reads WHERE message_id IN (SELECT id FROM messages WHERE conversation_id IN " + + myConvs + ")"); + j.update("DELETE FROM messages WHERE conversation_id IN " + myConvs); + j.update("DELETE FROM conversation_members WHERE conversation_id IN " + myConvs + " OR user_id IN " + u); + j.update("DELETE FROM conversations WHERE created_by IN " + u); + j.update("DELETE FROM application_status_history WHERE application_id IN " + myApps); + j.update("DELETE FROM interview_status_history WHERE interview_id IN " + myInterviews); + j.update("DELETE FROM interview_scores WHERE interview_id IN " + myInterviews); + j.update("DELETE FROM interviews WHERE " + interviewPredicate); + j.update("DELETE FROM offer_status_history WHERE offer_id IN " + myOffers); + j.update("DELETE FROM offer_reminders WHERE offer_id IN " + myOffers); + j.update("DELETE FROM offer_counter_offers WHERE offer_id IN " + myOffers + " OR student_id IN " + u); + j.update("DELETE FROM offers WHERE " + offerPredicate); + j.update("DELETE FROM candidate_scoring_appeal_history WHERE appeal_id IN " + myAppeals); + j.update("DELETE FROM candidate_scoring_snapshot_history WHERE candidate_user_id IN " + u); + j.update("DELETE FROM candidate_scoring_appeals WHERE candidate_user_id IN " + u); + j.update("DELETE FROM candidate_scoring_rollback_limits WHERE student_user_id IN " + u); + j.update("DELETE FROM candidate_dimension_scores WHERE student_user_id IN " + u); + j.update("DELETE FROM candidate_feedback WHERE student_user_id IN " + u + " OR company_user_id IN " + u); + j.update("DELETE FROM job_favorites WHERE student_user_id IN " + u); + j.update("DELETE FROM notifications WHERE user_id IN " + u); + j.update("DELETE FROM resume_versions WHERE user_id IN " + u); + j.update("DELETE FROM student_preferences WHERE student_user_id IN " + u); + j.update("DELETE FROM student_profiles WHERE user_id IN " + u); + j.update("DELETE FROM applications WHERE student_user_id IN " + u); + j.update("DELETE FROM jobs WHERE company_id IN " + myCompanies); + j.update("DELETE FROM companies WHERE owner_user_id IN " + u); + j.update("DELETE FROM user_roles WHERE user_id IN " + u); + j.update("DELETE FROM users WHERE phone LIKE '" + PREFIX + "%'"); + } + + // ══════════════════════════════════════════════════════════ + // 规范化（canonicalization）：把完整输出变成确定性文本 + // ══════════════════════════════════════════════════════════ + + private static final ObjectMapper MAPPER = new ObjectMapper(); + + /** + * 把 {@link PersonalDataCollector.CollectResult} 的**完整** section 输出规范化为文本。 + * + *

    显式呈现 null、按 {@code LocalDateTime.toString()} 呈现时间、按 List 原序呈现集合顺序、 + * 按 key 排序呈现 Map 字段；JSON 列做**语义等价**归一（MySQL 会重排 JSON 键并加空格， + * H2 保留字面量），从而比较的是语义而非引擎的序列化风格。

    + */ + static String canonicalResult(PersonalDataCollector.CollectResult r) { + StringBuilder sb = new StringBuilder(); + sb.append("sectionOrder=").append(new ArrayList<>(r.getSections().keySet())).append('\n'); + for (Map.Entry e : r.getSections().entrySet()) { + sb.append("section[").append(e.getKey()).append("]=").append(canon(e.getValue())).append('\n'); + } + sb.append("binaryKeys=").append(new ArrayList<>(new java.util.TreeSet<>(r.getBinaries().keySet()))) + .append('\n'); + return sb.toString(); + } + + /** 会话列表的完整视图规范化（key 排序，避免 HashMap 迭代顺序干扰）。 */ + static String canonicalConversations(List> list) { + StringBuilder sb = new StringBuilder(); + for (Map v : list) { + sb.append(canon(new TreeMap<>(v))).append('\n'); + } + return sb.toString(); + } + + private static String canon(Object v) { + if (v == null) return "null"; + if (v instanceof Map m) { + Map sorted = new TreeMap<>(); + m.forEach((k, value) -> sorted.put(String.valueOf(k), value)); + StringBuilder sb = new StringBuilder("{"); + boolean first = true; + for (Map.Entry e : sorted.entrySet()) { + if (!first) sb.append(','); + first = false; + sb.append(e.getKey()).append('=').append(canon(e.getValue())); + } + return sb.append('}').toString(); + } + if (v instanceof List l) { + StringBuilder sb = new StringBuilder("["); + for (int i = 0; i < l.size(); i++) { + if (i > 0) sb.append(','); + sb.append(canon(l.get(i))); + } + return sb.append(']').toString(); + } + if (v instanceof Object[] arr) return canon(List.of(arr)); + if (v instanceof LocalDateTime dt) return dt.toString(); + if (v instanceof LocalDate d) return d.toString(); + if (v instanceof BigDecimal bd) return bd.stripTrailingZeros().toPlainString(); + if (v instanceof String s) return '"' + normalizeJson(s) + '"'; + return String.valueOf(v); + } + + /** + * JSON 列的**语义**归一，而不是表示归一。 + * + *

    实测差异（见 {@code e1-raw-json.txt}）：同一个 JSON 列， + * MySQL 8 回读为 JSON 对象字面量 {@code {"java":3}}； + * H2（MODE=MySQL）回读为被转义的 JSON **字符串**标量 {@code "{\"java\":3}"}。 + * 两者语义相同，故此处递归解码到对象/数组后按键排序重排， + * 只对确实是 JSON 的字符串生效，其余字符串原样保留。

    + */ + private static String normalizeJson(String s) { + String decoded = decodeJsonValue(s.trim()); + return decoded != null ? decoded : s; + } + + /** 返回归一后的 JSON 文本；若该字符串不是 JSON（对象/数组/双重编码字符串）则返回 null。 */ + private static String decodeJsonValue(String t) { + boolean object = t.startsWith("{") && t.endsWith("}"); + boolean array = t.startsWith("[") && t.endsWith("]"); + boolean quoted = t.length() >= 2 && t.startsWith("\"") && t.endsWith("\""); + if (!object && !array && !quoted) return null; + try { + JsonNode node = MAPPER.readTree(t); + if (node == null) return null; + if (node.isTextual()) { + // 双重编码：字符串里仍然是 JSON（H2 的 JSON 列回读形态） + return decodeJsonValue(node.asText().trim()); + } + if (node.isObject() || node.isArray()) { + return MAPPER.writeValueAsString(sortKeys(node)); + } + return null; + } catch (Exception ignored) { + return null; + } + } + + /** 取出输出中 JSON 列的**原始**（未归一）取值，用于报告中如实记录跨库表示差异。 */ + private static String rawJsonSamples(PersonalDataCollector.CollectResult r) { + Object profile = r.getSections().get("profile"); + Object preferences = r.getSections().get("preferences"); + return "profile.skills=" + (profile instanceof Map p ? p.get("skills") : null) + + " | preferences.preferredCities=" + + (preferences instanceof Map p ? p.get("preferredCities") : null); + } + + private static JsonNode sortKeys(JsonNode node) { + if (node.isObject()) { + ObjectNode out = MAPPER.createObjectNode(); + List names = new ArrayList<>(); + node.fieldNames().forEachRemaining(names::add); + Collections.sort(names); + for (String n : names) out.set(n, sortKeys(node.get(n))); + return out; + } + if (node.isArray()) { + com.fasterxml.jackson.databind.node.ArrayNode out = MAPPER.createArrayNode(); + node.forEach(child -> out.add(sortKeys(child))); + return out; + } + return node; + } + + /** 把完整 dump 落盘，便于报告引用与失败时人工比对。 */ + private static void dump(String name, String content) { + try { + Path dir = Path.of("target", "r01e-independent"); + Files.createDirectories(dir); + Files.writeString(dir.resolve(name), content); + } catch (Exception ignored) { + // 诊断输出 + } + } + + // ══════════════════════════════════════════════════════════ + // 1 / 5. 查询预算（独立计数实现，统计真实 JDBC 语句与 SQL 文本） + // ══════════════════════════════════════════════════════════ + + /** 只包一层、记录**真实 JDBC 语句文本**的 DataSource（独立于实施测试的实现）。 */ + static final class CountingDataSource extends org.springframework.jdbc.datasource.AbstractDataSource { + private final DataSource delegate; + private final AtomicInteger count = new AtomicInteger(); + private final List sqls = Collections.synchronizedList(new ArrayList<>()); + + CountingDataSource(DataSource delegate) { + this.delegate = delegate; + } + + void reset() { + count.set(0); + sqls.clear(); + } + + int count() { + return count.get(); + } + + List sqls() { + synchronized (sqls) { + return new ArrayList<>(sqls); + } + } + + long matching(String lowerCaseFragment) { + return sqls().stream().filter(s -> s.toLowerCase().contains(lowerCaseFragment)).count(); + } + + @Override public Connection getConnection() throws java.sql.SQLException { + return wrap(delegate.getConnection()); + } + + @Override public Connection getConnection(String u, String p) throws java.sql.SQLException { + return wrap(delegate.getConnection(u, p)); + } + + private Connection wrap(Connection c) { + return (Connection) Proxy.newProxyInstance( + Connection.class.getClassLoader(), new Class[]{Connection.class}, + (proxy, method, args) -> { + if ("prepareStatement".equals(method.getName()) && args != null && args.length > 0 + && args[0] instanceof String sql) { + count.incrementAndGet(); + sqls.add(sql); + } else if ("createStatement".equals(method.getName())) { + count.incrementAndGet(); + } + return method.invoke(c, args); + }); + } + } + + // ══════════════════════════════════════════════════════════ + // 测试 + // ══════════════════════════════════════════════════════════ + + @Test + @DisplayName("引导：两个引擎均可执行真实 SQL，且等价夹具得到相同主键") + void bothEnginesAreLiveAndFixtureIdsAgree() { + assertThat(MySql.container.isRunning()).as("MySQL Testcontainers 必须真实运行").isTrue(); + assertThat(h2Jdbc.queryForObject("SELECT COUNT(*) FROM users", Integer.class)).isNotNull(); + assertThat(MySql.jdbc.queryForObject("SELECT COUNT(*) FROM users", Integer.class)).isNotNull(); + + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + assertThat(a.keySet()).isEqualTo(b.keySet()); + assertThat(b).as("等价夹具在两个引擎上应得到相同主键（同一 JVM、两侧均为全新建库）").isEqualTo(a); + } + + @Test + @DisplayName("E1：collector 完整输出在 H2 与 MySQL 上逐字段一致（含 null / 时间 / 顺序 / 关联数据）") + void e1CollectorOutputIsIdenticalAcrossEngines() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + assertThat(b).as("两侧等价夹具").isEqualTo(a); + + PersonalDataCollector.CollectResult onH2 = h2Collector.collect(a.get("me")); + PersonalDataCollector.CollectResult onMy = MySql.collector.collect(b.get("me")); + + String dumpH2 = canonicalResult(onH2); + String dumpMy = canonicalResult(onMy); + dump("e1-h2.txt", dumpH2); + dump("e1-mysql.txt", dumpMy); + dump("e1-raw-json.txt", "h2: " + rawJsonSamples(onH2) + "\nmysql: " + rawJsonSamples(onMy) + "\n"); + + assertThat(dumpH2).as("E1 collector 完整输出跨库必须逐字段一致").isEqualTo(dumpMy); + + // 反向自证：置换任意一个字段值后必须不再相等 + String perturbed = dumpMy.replace("\"张三\"", "\"张四\""); + assertThat(perturbed).as("规范化必须是逐字段敏感的（反证）").isNotEqualTo(dumpH2); + + // section 顺序本身也是输出契约的一部分 + assertThat(new ArrayList<>(onH2.getSections().keySet())).containsExactly( + "profile", "preferences", "resumes", "applications", "application-timelines", + "interviews", "interview-timelines", "offers", "offer-timelines", "feedback", + "favorites", "notifications", "conversations", "messages", + "candidate-scoring", "scoring-appeals"); + } + + @Test + @DisplayName("E1：collector 输出不含其他用户数据") + void e1CollectorOutputExcludesOtherUsers() { + Map ids = seedFixture(h2Jdbc); + seedFixture(MySql.jdbc); + + String dump = canonicalResult(h2Collector.collect(ids.get("me"))); + dump("e1-no-foreign.txt", dump); + + for (String foreign : List.of("李四", "外人的简介", "外人简历", "外人求职信", "外人评价", "外人通知", + "外人会话", "out-m1", "外人Offer", "外人理由", "外人面试")) { + assertThat(dump).as("他人数据不得混入导出：%s", foreign).doesNotContain(foreign); + } + // 关联数据：外人 id 不得以其任何形式出现 + assertThat(dump).doesNotContain("outsider"); + } + + @Test + @DisplayName("E1：1 / 10 / 50 条投递的真实 JDBC 语句数恒为 20/20/20（与实施报告同基线，两侧实测）") + void e1QueryBudgetIsFlatOnBothEngines() { + int[] sizes = {1, 10, 50}; + int[] onH2 = new int[3]; + int[] onMy = new int[3]; + List h2SqlFor1 = null; + List mySqlFor1 = null; + + for (int s = 0; s < sizes.length; s++) { + Map measured = measureE1Minimal(sizes[s]); + onH2[s] = measured.get("h2"); + onMy[s] = measured.get("mysql"); + if (s == 0) { + h2SqlFor1 = List.copyOf(h2Counting.sqls()); + mySqlFor1 = List.copyOf(MySql.counting.sqls()); + } + } + + dump("e1-budget.txt", "minimalFixture h2=" + java.util.Arrays.toString(onH2) + + " mysql=" + java.util.Arrays.toString(onMy) + "\n"); + + assertThat(onH2).as("E1 H2：SQL 数必须精确为 20/20/20").containsExactly(20, 20, 20); + assertThat(onMy).as("E1 MySQL：SQL 数必须精确为 20/20/20").containsExactly(20, 20, 20); + + // 排除「测试准备 / 清理」SQL：计数在夹具灌入完成之后才 reset， + // 故上述 20 条全部来自 collect()，且全部是 SELECT + assertThat(h2SqlFor1).as("H2 侧实测语句必须全部是 collect() 发出的查询").hasSize(20) + .allMatch(sql -> sql.trim().toUpperCase().startsWith("SELECT")); + assertThat(mySqlFor1).as("MySQL 侧实测语句必须全部是 collect() 发出的查询").hasSize(20) + .allMatch(sql -> sql.trim().toUpperCase().startsWith("SELECT")); + } + + @Test + @DisplayName("E1：12 个 section 全部有数据时，SQL 数仍不随记录数增长（两侧实测）") + void e1QueryBudgetIsFlatWithRichFixture() { + int[] sizes = {1, 10, 50}; + int[] onH2 = new int[3]; + int[] onMy = new int[3]; + for (int s = 0; s < sizes.length; s++) { + Map measured = measureE1Rich(sizes[s]); + onH2[s] = measured.get("h2"); + onMy[s] = measured.get("mysql"); + } + dump("e1-budget-rich.txt", "richFixture h2=" + java.util.Arrays.toString(onH2) + + " mysql=" + java.util.Arrays.toString(onMy) + "\n"); + + assertThat(onH2[1]).as("H2：10 条时不得高于 1 条时").isEqualTo(onH2[0]); + assertThat(onH2[2]).as("H2：50 条时不得高于 1 条时").isEqualTo(onH2[0]); + assertThat(onMy[1]).as("MySQL：10 条时不得高于 1 条时").isEqualTo(onMy[0]); + assertThat(onMy[2]).as("MySQL：50 条时不得高于 1 条时").isEqualTo(onMy[0]); + } + + /** + * 与实施报告同基线的最小夹具：仅 me/other 两个用户、一家公司、N 个岗位与 N 条投递。 + * 用于直接对账报告中「1/10/50 → 20/20/20」的结论。 + */ + private Map measureE1Minimal(int size) { + return measureE1(size, false); + } + + private Map measureE1Rich(int size) { + return measureE1(size, true); + } + + private Map measureE1(int size, boolean rich) { + clearFixture(h2Jdbc); + clearFixture(MySql.jdbc); + Map out = new LinkedHashMap<>(); + out.put("h2", measureE1On(h2Jdbc, h2Counting, h2Collector, size, rich)); + out.put("mysql", measureE1On(MySql.jdbc, MySql.counting, MySql.collector, size, rich)); + return out; + } + + /** 灌入夹具与 N 条投递，reset 计数器后调用 collect()，返回实测真实 JDBC 语句数。 */ + private int measureE1On(JdbcTemplate j, CountingDataSource counting, + PersonalDataCollector collector, int size, boolean rich) { + Map ids = rich ? seedFixture(j) : seedMinimalE1(j); + for (int i = 0; i < size; i++) { + long jobId = insertJob(j, ids.get("companyOwner"), PREFIX + "extra-job-" + i, at(200 + i)); + insertApplication(j, jobId, ids.get("me"), "SUBMITTED", "附加" + i, at(200 + i)); + } + counting.reset(); + collector.collect(ids.get("me")); + return counting.count(); + } + + /** 与实施报告同基线的最小夹具：两个用户 + 一家（他人持有的）公司，无其他 section 数据。 */ + private Map seedMinimalE1(JdbcTemplate j) { + Map ids = new LinkedHashMap<>(); + long me = insertUser(j, PREFIX + "me", "本人", "STUDENT", at(0)); + long other = insertUser(j, PREFIX + "other", "对方", "STUDENT", at(1)); + j.update("INSERT INTO companies (owner_user_id, name, industry, verified, created_at, updated_at) " + + "VALUES (?, ?, '互联网', 1, ?, ?)", other, PREFIX + "co-owner", at(40), at(40)); + ids.put("me", me); + ids.put("other", other); + ids.put("companyOwner", + j.queryForObject("SELECT id FROM companies WHERE owner_user_id = ?", Long.class, other)); + return ids; + } + + @Test + @DisplayName("E2：1 / 20 / 100 会话的真实 JDBC 语句数恒为 3，且 SQL 形态固定（H2 与 MySQL 均实测）") + void e2QueryBudgetIsFlatOnBothEngines() { + int[] sizes = {1, 20, 100}; + int[] onH2 = new int[3]; + int[] onMy = new int[3]; + List h2Sql = null; + List mySql = null; + + for (int s = 0; s < sizes.length; s++) { + clearFixture(h2Jdbc); + clearFixture(MySql.jdbc); + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + List expected = new ArrayList<>(); + for (int i = 0; i < sizes[s]; i++) { + expected.add(addConversationWithUnread(h2Jdbc, a, i)); + addConversationWithUnread(MySql.jdbc, b, i); + } + + h2Counting.reset(); + List> listH2 = h2Messaging.listConversations(a.get("me")); + onH2[s] = h2Counting.count(); + + MySql.counting.reset(); + List> listMy = MySql.messaging.listConversations(b.get("me")); + onMy[s] = MySql.counting.count(); + + assertThat(listH2).as("size=%d H2", sizes[s]).hasSize(sizes[s] + 3); + assertThat(listMy).as("size=%d MySQL", sizes[s]).hasSize(sizes[s] + 3); + assertThat(canonicalConversations(listH2)).as("size=%d 跨库逐字段一致", sizes[s]) + .isEqualTo(canonicalConversations(listMy)); + + if (s == 2) { + h2Sql = List.copyOf(h2Counting.sqls()); + mySql = List.copyOf(MySql.counting.sqls()); + } + } + + dump("e2-budget.txt", "h2=" + java.util.Arrays.toString(onH2) + "\nmysql=" + + java.util.Arrays.toString(onMy) + "\n--- h2 sql ---\n" + String.join("\n", h2Sql) + + "\n--- mysql sql ---\n" + String.join("\n", mySql) + "\n"); + + assertThat(onH2).as("E2 H2：SQL 数必须精确为 3/3/3").containsExactly(3, 3, 3); + assertThat(onMy).as("E2 MySQL：SQL 数必须精确为 3/3/3").containsExactly(3, 3, 3); + + // 3 条语句必须是「成员关系 + 会话 + 分组未读」，且未读查询只出现 1 次 + assertThat(h2Sql).hasSize(3); + assertThat(mySql).hasSize(3); + assertThat(h2Sql.stream().filter(s -> s.contains("ROW_NUMBER")).count()) + .as("H2：分组未读查询只执行一次").isEqualTo(1); + assertThat(mySql.stream().filter(s -> s.contains("ROW_NUMBER")).count()) + .as("MySQL：分组未读查询只执行一次").isEqualTo(1); + } + + private long addConversationWithUnread(JdbcTemplate j, Map ids, int index) { + long cid = insertConversation(j, ids.get("me"), "DIRECT", PREFIX + "scale-" + index, + at(300 + index), at(400 + index)); + addMember(j, cid, ids.get("me")); + addMember(j, cid, ids.get("other")); + insertMessage(j, cid, ids.get("other"), "scale-" + index, "SENT", at(400 + index)); + return cid; + } + + @Test + @DisplayName("E2：空会话页不执行任何未读查询") + void e2EmptyConversationPageIssuesNoUnreadQuery() { + long nobody = insertUser(h2Jdbc, PREFIX + "nobody", "无会话者", "STUDENT", at(0)); + long nobodyMy = insertUser(MySql.jdbc, PREFIX + "nobody", "无会话者", "STUDENT", at(0)); + + h2Counting.reset(); + assertThat(h2Messaging.listConversations(nobody)).isEmpty(); + List h2Sql = h2Counting.sqls(); + + MySql.counting.reset(); + assertThat(MySql.messaging.listConversations(nobodyMy)).isEmpty(); + List mySql = MySql.counting.sqls(); + + assertThat(h2Sql).as("H2：空会话页只发出一条成员关系查询").hasSize(1); + assertThat(mySql).as("MySQL：空会话页只发出一条成员关系查询").hasSize(1); + assertThat(h2Sql.get(0)).as("不得执行未读查询").doesNotContain("ROW_NUMBER"); + assertThat(mySql.get(0)).as("不得执行未读查询").doesNotContain("ROW_NUMBER"); + assertThat(h2Counting.matching("row_number")).isZero(); + assertThat(MySql.counting.matching("row_number")).isZero(); + } + + // ══════════════════════════════════════════════════════════ + // 3. E2 H2/MySQL 深比较：逐条语义 + // ══════════════════════════════════════════════════════════ + + private static Map unreadByConversation(List> list) { + Map out = new TreeMap<>(); + for (Map v : list) { + out.put(((Number) v.get("id")).longValue(), ((Number) v.get("unreadCount")).longValue()); + } + return out; + } + + private static void assertUnread(JdbcTemplate j, MessagingService svc, long me, long convId, long expected, + String what) { + Map map = unreadByConversation(svc.listConversations(me)); + assertThat(map.get(convId)).as("%s", what).isEqualTo(expected); + } + + @Test + @DisplayName("E2 深比较①：本人发送未读按现状计入（OBS-E01），他人发送未读计入") + void e2SelfSentAndOtherSentUnreadAreCounted() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + // c1 中：c1-m1（他人 SENT）、c1-m2（本人 SENT）、c1-m3（RECALLED） + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 2, + "H2：本人 1 条 + 他人 1 条 = 2（撤回排除；OBS-E01：本人发送计入）"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 2, + "MySQL：本人 1 条 + 他人 1 条 = 2（撤回排除；OBS-E01：本人发送计入）"); + + // 隔离验证：c1-m2 已被读取后，本人发送的那条不再计入 → 1 + long c1m2 = h2Jdbc.queryForObject("SELECT id FROM messages WHERE conversation_id = ? AND content = ?", + Long.class, a.get("c1"), "c1-m2"); + long c1m2My = MySql.jdbc.queryForObject("SELECT id FROM messages WHERE conversation_id = ? AND content = ?", + Long.class, b.get("c1"), "c1-m2"); + h2Jdbc.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", + c1m2, a.get("me"), at(500)); + MySql.jdbc.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", + c1m2My, b.get("me"), at(500)); + + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 1, "H2：本人那条已读 → 1"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 1, "MySQL：本人那条已读 → 1"); + } + + @Test + @DisplayName("E2 深比较②：message_reads 排除、RECALLED 排除，跨库逐值一致") + void e2ReadAndRecalledExcluded() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + long m1 = msgId(h2Jdbc, a.get("c1"), "c1-m1"); + long m1My = msgId(MySql.jdbc, b.get("c1"), "c1-m1"); + h2Jdbc.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", + m1, a.get("me"), at(500)); + MySql.jdbc.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", + m1My, b.get("me"), at(500)); + + // c1: m1 已读排除、m2 本人 SENT 计入、m3 RECALLED 排除 → 1 + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 1, "H2：已读与撤回均排除 → 1"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 1, "MySQL：已读与撤回均排除 → 1"); + + // 把 m2 也标记为撤回 → 0；此时聚合应缺行并由 Service 补 0 + h2Jdbc.update("UPDATE messages SET status = 'RECALLED' WHERE id = ?", msgId(h2Jdbc, a.get("c1"), "c1-m2")); + MySql.jdbc.update("UPDATE messages SET status = 'RECALLED' WHERE id = ?", + msgId(MySql.jdbc, b.get("c1"), "c1-m2")); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 0, "H2：全部排除 → 聚合缺行 → 补 0"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 0, "MySQL：全部排除 → 聚合缺行 → 补 0"); + + // 另一个读者的已读记录不得影响本人（两侧同步写入，保持自增计数一致） + markRead(h2Jdbc, msgId(h2Jdbc, a.get("c1"), "c1-m1"), a.get("other")); + markRead(MySql.jdbc, msgId(MySql.jdbc, b.get("c1"), "c1-m1"), b.get("other")); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 0, "H2：他人已读不影响本人"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 0, "MySQL：他人已读不影响本人"); + } + + private static long msgId(JdbcTemplate j, long convId, String content) { + return j.queryForObject("SELECT id FROM messages WHERE conversation_id = ? AND content = ?", + Long.class, convId, content); + } + + @Test + @DisplayName("E2 深比较③：多会话分组、非当前用户会话不返回、聚合缺失补 0") + void e2GroupingIsolationAndZeroFill() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + List> onH2 = h2Messaging.listConversations(a.get("me")); + List> onMy = MySql.messaging.listConversations(b.get("me")); + + assertThat(canonicalConversations(onH2)).as("会话列表跨库逐字段一致").isEqualTo(canonicalConversations(onMy)); + + Map h2Map = unreadByConversation(onH2); + Map myMap = unreadByConversation(onMy); + + assertThat(h2Map.keySet()).as("H2：本人应是 c1/c2/c3 三个会话") + .containsExactlyInAnyOrder(a.get("c1"), a.get("c2"), a.get("c3")); + assertThat(myMap.keySet()).as("MySQL：本人应是 c1/c2/c3 三个会话") + .containsExactlyInAnyOrder(b.get("c1"), b.get("c2"), b.get("c3")); + assertThat(h2Map).as("非当前用户会话绝不返回，且未读逐值一致").isEqualTo(myMap); + + assertThat(h2Map).doesNotContainKey(a.get("cOutsider")); + assertThat(h2Map.get(a.get("c1"))).isEqualTo(2L); + assertThat(h2Map.get(a.get("c2"))).isEqualTo(1L); + assertThat(h2Map.get(a.get("c3"))).as("本人发送的 1 条未读（OBS-E01）").isEqualTo(1L); + } + + @Test + @DisplayName("E2 深比较④：最近第 500 条计入、第 501 条排除（跨库一致的窗口边界）") + void e2FiveHundredWindowBoundary() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + long cH2 = a.get("c1"); + long cMy = b.get("c1"); + + // 清掉 c1 既有消息，改为 501 条 created_at 严格递增的未读消息 + clearMessages(h2Jdbc, cH2); + clearMessages(MySql.jdbc, cMy); + bulkMessages(h2Jdbc, cH2, a.get("other"), 501); + bulkMessages(MySql.jdbc, cMy, b.get("other"), 501); + + // 第 501 条（最旧，content=m0000）应被窗口排除 → 恰好 500 + assertUnread(h2Jdbc, h2Messaging, a.get("me"), cH2, 500, "H2：窗口上限 500"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), cMy, 500, "MySQL：窗口上限 500"); + + // 把最旧一条标记为已读 → 仍为 500，证明它本就在窗口之外 + markRead(h2Jdbc, msgId(h2Jdbc, cH2, "m0000"), a.get("me")); + markRead(MySql.jdbc, msgId(MySql.jdbc, cMy, "m0000"), b.get("me")); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), cH2, 500, "H2：最旧一条已在窗口外，标记已读不改变结果"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), cMy, 500, "MySQL：最旧一条已在窗口外，标记已读不改变结果"); + + // 把最新一条（m0500）标记为已读 → 499，证明窗口保留的是最新一侧 + markRead(h2Jdbc, msgId(h2Jdbc, cH2, "m0500"), a.get("me")); + markRead(MySql.jdbc, msgId(MySql.jdbc, cMy, "m0500"), b.get("me")); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), cH2, 499, "H2：窗口保留最新 500 条"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), cMy, 499, "MySQL：窗口保留最新 500 条"); + } + + private static void clearMessages(JdbcTemplate j, long convId) { + j.update("DELETE FROM message_reads WHERE message_id IN (SELECT id FROM messages WHERE conversation_id = ?)", + convId); + j.update("DELETE FROM messages WHERE conversation_id = ?", convId); + } + + private static void markRead(JdbcTemplate j, long messageId, long reader) { + j.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", + messageId, reader, at(600)); + } + + /** 批量写入 n 条 created_at 严格递增的消息，content 为 m0000..mNNNN。 */ + private static void bulkMessages(JdbcTemplate j, long convId, long sender, int n) { + List batch = new ArrayList<>(); + for (int i = 0; i < n; i++) { + batch.add(new Object[]{convId, sender, String.format("m%04d", i), "SENT", T.plusSeconds(i)}); + } + j.batchUpdate("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, ?, ?)", batch); + } + + @Test + @DisplayName("E2 深比较⑤：created_at 相同时的排序语义（小规模确定；跨 500 边界时窗口总数仍恒为 500）") + void e2IdenticalCreatedAtOrderingSemantics() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + // 小规模：3 条 created_at 完全相同、全部未读 → 计数与顺序无关，必须为 3 + clearMessages(h2Jdbc, a.get("c1")); + clearMessages(MySql.jdbc, b.get("c1")); + bulkTied(h2Jdbc, a.get("c1"), a.get("other"), 3); + bulkTied(MySql.jdbc, b.get("c1"), b.get("other"), 3); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 3, "H2：同一时刻 3 条全部计入"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 3, "MySQL：同一时刻 3 条全部计入"); + + // 其中一条已读 → 2，仍然与排序无关 + markRead(h2Jdbc, msgId(h2Jdbc, a.get("c1"), "tied-1"), a.get("me")); + markRead(MySql.jdbc, msgId(MySql.jdbc, b.get("c1"), "tied-1"), b.get("me")); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 2, "H2：同一时刻 3 条中已读 1 条 → 2"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 2, "MySQL：同一时刻 3 条中已读 1 条 → 2"); + + // 跨窗口边界：501 条 created_at 完全相同 —— ORDER BY 无 tiebreaker， + // 「保留哪 500 条」由引擎决定；但窗口计数与引擎无关，必须恒为 500。 + clearMessages(h2Jdbc, a.get("c1")); + clearMessages(MySql.jdbc, b.get("c1")); + bulkTied(h2Jdbc, a.get("c1"), a.get("other"), 501); + bulkTied(MySql.jdbc, b.get("c1"), b.get("other"), 501); + assertUnread(h2Jdbc, h2Messaging, a.get("me"), a.get("c1"), 500, "H2：同刻 501 条 → 窗口恒为 500"); + assertUnread(MySql.jdbc, MySql.messaging, b.get("me"), b.get("c1"), 500, "MySQL：同刻 501 条 → 窗口恒为 500"); + } + + private static void bulkTied(JdbcTemplate j, long convId, long sender, int n) { + List batch = new ArrayList<>(); + for (int i = 0; i < n; i++) { + batch.add(new Object[]{convId, sender, "tied-" + i, "SENT", T.plusDays(1)}); + } + j.batchUpdate("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, ?, ?)", batch); + } + + @Test + @DisplayName("E2 深比较⑥：重复 conversationId 不重复计数；空列表由 Service 短路，不下发 IN ()") + void e2DuplicateAndEmptyConversationIds() { + Map a = seedFixture(h2Jdbc); + Map b = seedFixture(MySql.jdbc); + + // 重复 id：直接对 Repository 使用的同一 SQL 施加 [c1, c1] + String sql = unreadSql(2); + List> dupH2 = h2Jdbc.queryForList(sql, a.get("c1"), a.get("c1"), a.get("me")); + List> dupMy = MySql.jdbc.queryForList(sql, b.get("c1"), b.get("c1"), b.get("me")); + + assertThat(dupH2).as("H2：重复 id 只产出一行").hasSize(1); + assertThat(dupMy).as("MySQL：重复 id 只产出一行").hasSize(1); + assertThat(((Number) dupH2.get(0).get("unreadCount")).longValue()).isEqualTo(2L); + assertThat(((Number) dupMy.get(0).get("unreadCount")).longValue()).isEqualTo(2L); + + // 重复 id 与单 id 结果逐值一致 + List> singleH2 = h2Jdbc.queryForList(unreadSql(1), a.get("c1"), a.get("me")); + List> singleMy = MySql.jdbc.queryForList(unreadSql(1), b.get("c1"), b.get("me")); + assertThat(((Number) singleH2.get(0).get("unreadCount")).longValue()) + .isEqualTo(((Number) dupH2.get(0).get("unreadCount")).longValue()); + assertThat(((Number) singleMy.get(0).get("unreadCount")).longValue()) + .isEqualTo(((Number) dupMy.get(0).get("unreadCount")).longValue()); + + // 空列表：Service 在取到空 memberships 后直接返回，不下发未读查询（见 e2EmptyConversationPageIssuesNoUnreadQuery） + long emptyH2 = insertUser(h2Jdbc, PREFIX + "empty", "空用户", "STUDENT", at(0)); + long emptyMy = insertUser(MySql.jdbc, PREFIX + "empty", "空用户", "STUDENT", at(0)); + assertThat(h2Messaging.listConversations(emptyH2)).isEmpty(); + assertThat(MySql.messaging.listConversations(emptyMy)).isEmpty(); + } + + // ══════════════════════════════════════════════════════════ + // 4. MySQL EXPLAIN FORMAT=JSON + // ══════════════════════════════════════════════════════════ + + /** 与 MessageRepository.countUnreadByConversationIds 逐字一致的原生 SQL。 */ + static String unreadSql(int placeholders) { + return "SELECT ranked.conversation_id AS conversationId, COUNT(*) AS unreadCount " + + "FROM (SELECT m.id, m.conversation_id, m.status, " + + "ROW_NUMBER() OVER (PARTITION BY m.conversation_id ORDER BY m.created_at DESC) AS row_no " + + "FROM messages m WHERE m.conversation_id IN (" + + String.join(",", Collections.nCopies(placeholders, "?")) + ")) ranked " + + "LEFT JOIN message_reads mr ON mr.message_id = ranked.id AND mr.reader_user_id = ? " + + "WHERE ranked.row_no <= 500 AND (ranked.status IS NULL OR ranked.status <> 'RECALLED') " + + "AND mr.id IS NULL GROUP BY ranked.conversation_id"; + } + + /** + * EXPLAIN 得到的「表节点」信息。 + * + *

    注意：MySQL 的 {@code EXPLAIN FORMAT=JSON} 里 {@code table_name} 是**别名**。 + * 被测语句逐字取自 {@code MessageRepository.countUnreadByConversationIds}， + * 其别名为 {@code messages m}、{@code message_reads mr}、派生表 {@code ranked}， + * 故此处表节点分别为 {@code m} / {@code mr} / {@code ranked}。

    + */ + private record TableNode(String tableName, String accessType, Object possibleKeys, Object key, + Object rowsExamined, Object filtered, Object attachedCondition) { + } + + private static final String ALIAS_MESSAGES = "m"; + private static final String ALIAS_MESSAGE_READS = "mr"; + private static final String ALIAS_RANKED = "ranked"; + + private static void collectTableNodes(JsonNode node, List out) { + if (node == null) return; + if (node.isObject()) { + JsonNode table = node.get("table"); + if (table != null && table.isObject() && table.has("table_name")) { + out.add(new TableNode( + table.path("table_name").asText(), + table.path("access_type").asText(), + table.has("possible_keys") ? MAPPER.convertValue(table.get("possible_keys"), Object.class) : null, + table.has("key") ? table.get("key").asText() : null, + table.has("rows_examined_per_scan") ? table.get("rows_examined_per_scan").asLong() : null, + table.has("filtered") ? table.get("filtered").asText() : null, + table.has("attached_condition") ? table.get("attached_condition").asText() : null)); + } + node.fields().forEachRemaining(e -> collectTableNodes(e.getValue(), out)); + } else if (node.isArray()) { + node.forEach(child -> collectTableNodes(child, out)); + } + } + + private static boolean findBool(JsonNode node, String field) { + if (node == null) return false; + if (node.isObject()) { + if (node.has(field) && node.get(field).asBoolean(false)) return true; + for (JsonNode child : node) { + if (findBool(child, field)) return true; + } + } else if (node.isArray()) { + for (JsonNode child : node) { + if (findBool(child, field)) return true; + } + } + return false; + } + + @Test + @DisplayName("MySQL EXPLAIN：selective 规模下 messages/message_reads 命中既有索引；派生表 ranked 逐项记录") + void mysqlExplainReportsAccessPathsPerTable() { + ExplainFixture fixture = new ExplainFixture(); + fixture.reset(); + + List report = new ArrayList<>(); + Map perScale = new LinkedHashMap<>(); + Map probes = new LinkedHashMap<>(); + + for (int[] spec : ASSERTED_SCALES) { + perScale.put(fixture.label(spec), explainUnread(fixture.targets(spec[0], spec[1]))); + } + for (int[] spec : SELECTIVITY_PROBES) { + probes.put(fixture.label(spec), explainUnread(fixture.targets(spec[0], spec[1]))); + } + + report.add("## 断言规模（查询的会话集合相对 messages 高度 selective）"); + append(report, perScale, fixture); + report.add("## 选择性探测（不参与断言，用于定位代价拐点）"); + append(report, probes, fixture); + dump("e2-explain.txt", String.join("\n", report) + "\n"); + System.out.println("[R01E-INDEPENDENT-EXPLAIN]\n" + String.join("\n", report)); + + perScale.forEach((label, result) -> assertBaseTablesUseIndex(label, result.nodes())); + probes.forEach(this::recordProbeOutcome); + } + + /** 断言的 EXPLAIN 规模：查询到的会话只占 messages 表很小比例（真实用户会话列表的形态）。 */ + private static final int[][] ASSERTED_SCALES = {{1, 3}, {20, 3}, {100, 3}, {1, 600}}; + + /** 选择性探测：查询到的会话占比逐步升高，用于找到代价拐点（结果只记录、不判定）。 */ + private static final int[][] SELECTIVITY_PROBES = {{2, 600}, {5, 600}, {20, 600}}; + + private final Map probeOutcomes = new LinkedHashMap<>(); + + private void append(List report, Map map, ExplainFixture fixture) { + map.forEach((label, result) -> { + report.add("### " + label + " selectivity=" + fixture.selectivity(label) + + " using_temporary_table=" + result.temporary() + + " using_filesort=" + result.filesort()); + for (TableNode n : result.nodes()) { + report.add(String.format(" table=%s access_type=%s possible_keys=%s key=%s rows=%s filtered=%s", + n.tableName(), n.accessType(), n.possibleKeys(), n.key(), n.rowsExamined(), n.filtered())); + } + }); + } + + private void recordProbeOutcome(String label, ExplainResult result) { + result.nodes().stream().filter(n -> ALIAS_MESSAGES.equals(n.tableName())).findFirst() + .ifPresent(n -> probeOutcomes.put(label, + n.accessType() + "/key=" + n.key() + "/rows=" + n.rowsExamined())); + dump("e2-explain-probes.txt", probeOutcomes.toString()); + } + + private void assertBaseTablesUseIndex(String label, List nodes) { + List derived = nodes.stream().filter(n -> ALIAS_RANKED.equals(n.tableName())).toList(); + List messages = nodes.stream().filter(n -> ALIAS_MESSAGES.equals(n.tableName())).toList(); + List reads = nodes.stream().filter(n -> ALIAS_MESSAGE_READS.equals(n.tableName())).toList(); + + assertThat(derived).as("%s：必须出现派生结果 ranked", label).isNotEmpty(); + assertThat(messages).as("%s：必须出现基础表 messages（别名 m）", label).isNotEmpty(); + assertThat(reads).as("%s：必须出现基础表 message_reads（别名 mr；LEFT JOIN 被优化省略则此处失败）", + label).isNotEmpty(); + + // 派生结果 ranked：MySQL 对 ROW_NUMBER() 派生表默认物化，access_type=ALL 属预期， + // 准确表述为「派生结果顺序扫描」，不能与基础表混为一谈。 + for (TableNode d : derived) { + assertThat(d.accessType()).as("%s：派生结果 ranked 的 access_type", label) + .isIn("ALL", "ref", "eq_ref", "index", "range"); + } + + for (TableNode m : messages) { + assertThat(m.accessType()) + .as("%s：基础表 messages 不得全表扫描（access_type=%s, key=%s, possible_keys=%s）", + label, m.accessType(), m.key(), m.possibleKeys()) + .isNotEqualTo("ALL"); + assertThat(m.key()).as("%s：messages 必须命中既有索引", label) + .isEqualTo("idx_messages_conversation_created"); + } + for (TableNode r : reads) { + assertThat(r.accessType()) + .as("%s：基础表 message_reads 不得全表扫描（access_type=%s, key=%s）", + label, r.accessType(), r.key()) + .isNotEqualTo("ALL"); + assertThat(r.key()).as("%s：message_reads 必须命中既有索引", label).isNotNull(); + } + } + + /** + * EXPLAIN 夹具：背景消息只铺一次，各规模只替换「目标会话」。 + * + *

    没有背景数据时 messages 表几乎只包含查询范围内的行，MySQL 选择全表扫描是**正确**的代价决策， + * 却会让 EXPLAIN 失去验收意义；真实场景中一个用户的会话只占全表很小比例。

    + */ + private final class ExplainFixture { + private final Map h2Ids = new LinkedHashMap<>(); + private final Map myIds = new LinkedHashMap<>(); + + void reset() { + clearFixture(h2Jdbc); + clearFixture(MySql.jdbc); + h2Ids.putAll(seedFixture(h2Jdbc)); + myIds.putAll(seedFixture(MySql.jdbc)); + seedBackgroundMessages(h2Jdbc, h2Ids.get("owner")); + seedBackgroundMessages(MySql.jdbc, myIds.get("owner")); + } + + String label(int[] spec) { + return "conversations=" + spec[0] + ",messagesPerConversation=" + spec[1] + + ",targetRows=" + (spec[0] * spec[1]); + } + + /** 目标行数 / messages 总行数。 */ + String selectivity(String label) { + return String.format("%.2f%%", 100.0 * targetRows(label) / totalMessages()); + } + + private long targetRows(String label) { + String v = label.substring(label.indexOf("targetRows=") + "targetRows=".length()); + return Long.parseLong(v); + } + + private long totalMessages() { + return MySql.jdbc.queryForObject("SELECT COUNT(*) FROM messages", Long.class); + } + + List targets(int conversations, int msgs) { + clearExplainTargets(h2Jdbc); + clearExplainTargets(MySql.jdbc); + List h2 = insertExplainTargets(h2Jdbc, h2Ids, conversations, msgs); + List my = insertExplainTargets(MySql.jdbc, myIds, conversations, msgs); + assertThat(h2).as("EXPLAIN 目标会话两侧主键应一致").isEqualTo(my); + return my; + } + } + + private void clearExplainTargets(JdbcTemplate j) { + String t = "(SELECT id FROM conversations WHERE title LIKE '" + PREFIX + "explain-%')"; + j.update("DELETE FROM message_reads WHERE message_id IN (SELECT id FROM messages " + + "WHERE conversation_id IN " + t + ")"); + j.update("DELETE FROM messages WHERE conversation_id IN " + t); + j.update("DELETE FROM conversation_members WHERE conversation_id IN " + t); + j.update("DELETE FROM conversations WHERE title LIKE '" + PREFIX + "explain-%'"); + } + + private List insertExplainTargets(JdbcTemplate j, Map ids, int conversations, int msgs) { + List out = new ArrayList<>(); + for (int c = 0; c < conversations; c++) { + long cid = insertConversation(j, ids.get("me"), "DIRECT", PREFIX + "explain-" + c, + at(700 + c), at(800 + c)); + addMember(j, cid, ids.get("me")); + addMember(j, cid, ids.get("other")); + out.add(cid); + List batch = new ArrayList<>(); + for (int i = 0; i < msgs; i++) { + String status = (i % 50 == 7) ? "RECALLED" : "SENT"; + batch.add(new Object[]{cid, ids.get("other"), "e" + c + "-" + i, status, T.plusSeconds(i)}); + } + j.batchUpdate("INSERT INTO messages (conversation_id, sender_user_id, content, status, " + + "created_at) VALUES (?, ?, ?, ?, ?)", batch); + } + for (int c = 0; c < Math.min(conversations, 5); c++) { + List reads = new ArrayList<>(); + for (int i = 0; i < Math.min(msgs, 20); i += 3) { + Long mid = j.queryForObject("SELECT id FROM messages WHERE conversation_id = ? AND content = ?", + Long.class, out.get(c), "e" + c + "-" + i); + reads.add(new Object[]{mid, ids.get("me"), T.plusSeconds(i)}); + } + j.batchUpdate("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", reads); + } + return out; + } + + private record ExplainResult(List nodes, boolean temporary, boolean filesort) { + } + + private ExplainResult explainUnread(List convIds) { + // ANALYZE TABLE 会返回结果集，必须走 query 而非 update + MySql.jdbc.queryForList("ANALYZE TABLE messages"); + MySql.jdbc.queryForList("ANALYZE TABLE message_reads"); + Object[] args = new Object[convIds.size() + 1]; + for (int i = 0; i < convIds.size(); i++) args[i] = convIds.get(i); + args[convIds.size()] = 0L; // readerUserId：用一个几乎不存在的读者，保证 plan 稳定 + + List> rows = MySql.jdbc.queryForList( + "EXPLAIN FORMAT=JSON " + unreadSql(convIds.size()), args); + assertThat(rows).isNotEmpty(); + String json = String.valueOf(rows.get(0).get("EXPLAIN")); + try { + JsonNode root = MAPPER.readTree(json); + List out = new ArrayList<>(); + collectTableNodes(root, out); + return new ExplainResult(out, findBool(root, "using_temporary_table"), + findBool(root, "using_filesort")); + } catch (Exception ex) { + throw new IllegalStateException("EXPLAIN JSON 解析失败", ex); + } + } + + /** 背景规模：非查询范围的会话数与每会话消息数，用于让 `messages` 上的既有索引具备真实选择性。 */ + private static final int BACKGROUND_CONVERSATIONS = 500; + private static final int BACKGROUND_MESSAGES_PER_CONVERSATION = 20; + + /** + * 背景消息：不属于被测 {@code conversationIds} 的会话与消息。 + * + *

    没有背景数据时，{@code messages} 表几乎只包含查询范围内的行，MySQL 选择全表扫描是**正确**的 + * 代价决策，却会让 EXPLAIN 失去验收意义。真实场景中一个用户的会话只占全表很小比例， + * 故这里先铺入背景数据，再观察既有索引是否被命中。

    + */ + private void seedBackgroundMessages(JdbcTemplate j, long owner) { + List convs = new ArrayList<>(); + for (int c = 0; c < BACKGROUND_CONVERSATIONS; c++) { + convs.add(new Object[]{PREFIX + "bg-" + c, "DIRECT", owner, at(900), at(901)}); + } + j.batchUpdate("INSERT INTO conversations (title, type, created_by, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?)", convs); + + List bgIds = j.queryForList("SELECT id FROM conversations WHERE title LIKE '" + PREFIX + + "bg-%' ORDER BY id", Long.class); + List msgs = new ArrayList<>(); + for (Long cid : bgIds) { + for (int i = 0; i < BACKGROUND_MESSAGES_PER_CONVERSATION; i++) { + msgs.add(new Object[]{cid, owner, "bg-" + cid + "-" + i, "SENT", T.plusSeconds(i)}); + } + } + j.batchUpdate("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, ?, ?)", msgs); + } + + @Test + @DisplayName("结构：跨库夹具在两侧留下的自有行数完全一致（读取路径不改数据）") + void fixtureFootprintMatchesAcrossEngines() { + seedFixture(h2Jdbc); + seedFixture(MySql.jdbc); + + String[] tables = {"users", "user_roles", "companies", "jobs", "applications", + "application_status_history", "interviews", "interview_status_history", "offers", + "offer_status_history", "candidate_feedback", "job_favorites", "notifications", + "conversations", "conversation_members", "messages", "message_reads", + "student_profiles", "student_preferences", "resume_versions", + "candidate_dimension_scores", "candidate_scoring_appeals", + "candidate_scoring_appeal_history"}; + for (String table : tables) { + Integer onH2 = h2Jdbc.queryForObject("SELECT COUNT(*) FROM " + table, Integer.class); + Integer onMy = MySql.jdbc.queryForObject("SELECT COUNT(*) FROM " + table, Integer.class); + assertThat(onMy).as("%s 的自有行数跨库应一致", table).isEqualTo(onH2); + } + } + + // ══════════════════════════════════════════════════════════ + // 5. 夹具零残留 + // ══════════════════════════════════════════════════════════ + + @Test + @DisplayName("隔离：清理后自有夹具在两个引擎上的残留均为 0") + void fixtureLeavesNoResidue() { + seedFixture(h2Jdbc); + seedFixture(MySql.jdbc); + clearFixture(h2Jdbc); + clearFixture(MySql.jdbc); + + assertThat(residue(h2Jdbc)).as("H2 侧自有残留").isZero(); + assertThat(residue(MySql.jdbc)).as("MySQL 侧自有残留").isZero(); + } + + private static long residue(JdbcTemplate j) { + long total = 0; + String users = "(SELECT id FROM users WHERE phone LIKE '" + PREFIX + "%')"; + for (String sql : List.of( + "SELECT COUNT(*) FROM users WHERE phone LIKE '" + PREFIX + "%'", + "SELECT COUNT(*) FROM user_roles WHERE user_id IN " + users, + "SELECT COUNT(*) FROM messages WHERE sender_user_id IN " + users, + "SELECT COUNT(*) FROM message_reads WHERE reader_user_id IN " + users, + "SELECT COUNT(*) FROM conversation_members WHERE user_id IN " + users, + "SELECT COUNT(*) FROM conversations WHERE created_by IN " + users, + "SELECT COUNT(*) FROM applications WHERE student_user_id IN " + users, + "SELECT COUNT(*) FROM jobs WHERE title LIKE '" + PREFIX + "%'", + "SELECT COUNT(*) FROM companies WHERE name LIKE '" + PREFIX + "%'", + "SELECT COUNT(*) FROM notifications WHERE user_id IN " + users)) { + total += j.queryForObject(sql, Integer.class); + } + return total; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentSideEffectIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentSideEffectIsolationTest.java new file mode 100644 index 0000000..f325961 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EIndependentSideEffectIsolationTest.java @@ -0,0 +1,441 @@ +package com.mydreamjob.common.r01e; + +import com.mydreamjob.dataexport.PersonalDataCollector; +import com.mydreamjob.messaging.MessagingService; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.springframework.amqp.rabbit.core.RabbitTemplate; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-E **独立复验**（第五节）：副作用、隔离与反证。 + * + *

    与实施测试的差异：本类独立实现夹具与快照（25 张表、列集合不同）， + * 并且额外验证三件事 ——

    + *
      + *
    1. 反证：故意改动一行（改 / 增 / 删）时，快照断言**必须失败**， + * 否则「零变化」只是没在比；
      2. + *
    2. RabbitMQ：用 {@code @MockBean RabbitTemplate} 直接断言读路径**零 AMQP 交互**；
      3. + *
    3. 回归门禁：本类运行在**共享的 integration H2 库**上，故可以直接检查 + * {@code R01EQueryBudgetAcceptanceTest} 的 {@code r01e-} 夹具是否已零残留 + * （此前缺 {@code @AfterEach} 导致 60 项失败的正是这一点）。
      4. + *
    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +@org.junit.jupiter.api.TestInstance(org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS) +class R01EIndependentSideEffectIsolationTest { + + private static final String PREFIX = "r01eiso-"; + private static final LocalDateTime T = LocalDateTime.of(2026, 4, 1, 8, 0, 0); + + @Autowired private MessagingService messagingService; + @Autowired private PersonalDataCollector personalDataCollector; + @Autowired private JdbcTemplate jdbc; + @MockBean private RedisTemplate redisTemplate; + @MockBean private RabbitTemplate rabbitTemplate; + + private Long me; + private Long other; + private Long companyId; + private Long jobId; + + @BeforeEach + void setUp() { + cleanup(); + me = user(PREFIX + "me"); + other = user(PREFIX + "other"); + } + + @AfterEach + void tearDown() { + cleanup(); + } + + /** 退场门禁：本类跑完后，自有夹具与既有实施测试的夹具都必须零残留。 */ + @AfterAll + void assertNoResidueAfterClass() { + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM users WHERE phone LIKE '" + PREFIX + "%'", + Integer.class)) + .as("本类自有用户残留必须为 0").isZero(); + assertThat(residue()).as("本类自有夹具残留必须为 0").isZero(); + assertThat(jdbc.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone LIKE 'r01e-%' AND phone NOT LIKE '" + PREFIX + "%'", + Integer.class)) + .as("实施测试的 r01e- 夹具残留必须为 0").isZero(); + } + + // ══════════════════════════════════════════════════════════ + // 夹具 + // ══════════════════════════════════════════════════════════ + + private void cleanup() { + String u = "(SELECT id FROM users WHERE phone LIKE '" + PREFIX + "%')"; + String convs = "(SELECT id FROM conversations WHERE created_by IN " + u + ")"; + String apps = "(SELECT id FROM applications WHERE student_user_id IN " + u + ")"; + String companies = "(SELECT id FROM companies WHERE owner_user_id IN " + u + ")"; + String ivs = "(SELECT id FROM interviews WHERE student_user_id IN " + u + + " OR company_user_id IN " + u + ")"; + String offers = "(SELECT id FROM offers WHERE candidate_id IN " + u + " OR company_id IN " + + companies + ")"; + String appeals = "(SELECT id FROM candidate_scoring_appeals WHERE candidate_user_id IN " + u + ")"; + + jdbc.update("DELETE FROM message_reads WHERE message_id IN (SELECT id FROM messages " + + "WHERE conversation_id IN " + convs + ")"); + jdbc.update("DELETE FROM messages WHERE conversation_id IN " + convs); + jdbc.update("DELETE FROM conversation_members WHERE conversation_id IN " + convs + " OR user_id IN " + u); + jdbc.update("DELETE FROM conversations WHERE created_by IN " + u); + jdbc.update("DELETE FROM application_status_history WHERE application_id IN " + apps); + jdbc.update("DELETE FROM interview_status_history WHERE interview_id IN " + ivs); + jdbc.update("DELETE FROM interviews WHERE student_user_id IN " + u + " OR company_user_id IN " + u); + jdbc.update("DELETE FROM offer_status_history WHERE offer_id IN " + offers); + jdbc.update("DELETE FROM offer_counter_offers WHERE offer_id IN " + offers + " OR student_id IN " + u); + jdbc.update("DELETE FROM offers WHERE candidate_id IN " + u + " OR company_id IN " + companies); + jdbc.update("DELETE FROM candidate_scoring_appeal_history WHERE appeal_id IN " + appeals); + jdbc.update("DELETE FROM candidate_scoring_snapshot_history WHERE candidate_user_id IN " + u); + jdbc.update("DELETE FROM candidate_scoring_appeals WHERE candidate_user_id IN " + u); + jdbc.update("DELETE FROM candidate_dimension_scores WHERE student_user_id IN " + u); + jdbc.update("DELETE FROM candidate_feedback WHERE student_user_id IN " + u + " OR company_user_id IN " + u); + jdbc.update("DELETE FROM job_favorites WHERE student_user_id IN " + u); + jdbc.update("DELETE FROM notifications WHERE user_id IN " + u); + jdbc.update("DELETE FROM resume_versions WHERE user_id IN " + u); + jdbc.update("DELETE FROM student_preferences WHERE student_user_id IN " + u); + jdbc.update("DELETE FROM student_profiles WHERE user_id IN " + u); + jdbc.update("DELETE FROM applications WHERE student_user_id IN " + u); + jdbc.update("DELETE FROM jobs WHERE title LIKE '" + PREFIX + "%'"); + jdbc.update("DELETE FROM companies WHERE name LIKE '" + PREFIX + "%'"); + jdbc.update("DELETE FROM user_roles WHERE user_id IN " + u); + jdbc.update("DELETE FROM users WHERE phone LIKE '" + PREFIX + "%'"); + companyId = null; + jobId = null; + } + + private Long user(String phone) { + jdbc.update("INSERT INTO users (phone, nickname, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, ?, 'STUDENT', 1, 1, ?, ?)", phone, phone, T, T); + Long id = jdbc.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbc.update("INSERT INTO user_roles (user_id, role) VALUES (?, 'STUDENT')", id); + return id; + } + + /** 灌入覆盖全部 12 个 section 的夹具，使 collect() 真正走满所有分支。 */ + private void seed() { + jdbc.update("INSERT INTO student_profiles (user_id, real_name, location, skills_json, created_at, " + + "updated_at) VALUES (?, '张三', '北京', '{\"java\":3}', ?, ?)", me, T, T); + jdbc.update("INSERT INTO student_preferences (student_user_id, expected_salary_min, preferred_cities, " + + "remote_allowed, created_at, updated_at) VALUES (?, 15000, '[\"北京\"]', 1, ?, ?)", me, T, T); + jdbc.update("INSERT INTO resume_versions (user_id, name, version_no, file_storage_path, file_name, " + + "content_type, file_size, status, created_at, updated_at) " + + "VALUES (?, '简历', 1, ?, 'a.pdf', 'application/pdf', 100, 'ACTIVE', ?, ?)", + me, PREFIX + "absent.pdf", T, T); + + jdbc.update("INSERT INTO companies (owner_user_id, name, verified, created_at, updated_at) " + + "VALUES (?, ?, 1, ?, ?)", other, PREFIX + "co", T, T); + companyId = jdbc.queryForObject("SELECT id FROM companies WHERE owner_user_id = ?", Long.class, other); + jdbc.update("INSERT INTO jobs (company_id, title, description, city, employment_type, status, " + + "created_at, updated_at) VALUES (?, ?, 'd', '北京', 'FULL_TIME', 'PUBLISHED', ?, ?)", + companyId, PREFIX + "job", T, T); + jobId = jdbc.queryForObject("SELECT id FROM jobs WHERE title = ?", Long.class, PREFIX + "job"); + jdbc.update("INSERT INTO applications (job_id, student_user_id, status, created_at, updated_at) " + + "VALUES (?, ?, 'SUBMITTED', ?, ?)", jobId, me, T, T); + Long appId = jdbc.queryForObject("SELECT id FROM applications WHERE job_id = ?", Long.class, jobId); + jdbc.update("INSERT INTO application_status_history (application_id, operator_user_id, from_status, " + + "to_status, created_at) VALUES (?, ?, NULL, 'SUBMITTED', ?)", appId, other, T); + + jdbc.update("INSERT INTO interviews (application_id, company_user_id, student_user_id, round_no, title, " + + "interview_type, start_at, end_at, status, created_at, updated_at) " + + "VALUES (?, ?, ?, 1, '一面', 'VIDEO', ?, ?, 'SCHEDULED', ?, ?)", + appId, other, me, T, T.plusHours(1), T, T); + Long ivId = jdbc.queryForObject("SELECT id FROM interviews WHERE application_id = ?", Long.class, appId); + jdbc.update("INSERT INTO interview_status_history (interview_id, from_status, to_status, actor_user_id, " + + "created_at) VALUES (?, NULL, 'SCHEDULED', ?, ?)", ivId, other, T); + + jdbc.update("INSERT INTO offers (application_id, job_id, company_id, candidate_id, title, description, " + + "expire_at, status, version, created_by, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, 'Offer', '说明', ?, 'SENT', 0, ?, ?, ?)", + appId, jobId, companyId, me, T.plusDays(30), other, T, T); + Long offerId = jdbc.queryForObject("SELECT id FROM offers WHERE application_id = ?", Long.class, appId); + jdbc.update("INSERT INTO offer_status_history (offer_id, from_status, to_status, operator_id, " + + "operator_role, created_at) VALUES (?, NULL, 'SENT', ?, 'COMPANY', ?)", offerId, other, T); + + jdbc.update("INSERT INTO candidate_feedback (application_id, company_user_id, student_user_id, rating, " + + "content, created_at, updated_at) VALUES (?, ?, ?, 5, '不错', ?, ?)", appId, other, me, T, T); + jdbc.update("INSERT INTO job_favorites (job_id, student_user_id, created_at) VALUES (?, ?, ?)", + jobId, me, T); + jdbc.update("INSERT INTO notifications (user_id, type, title, is_read, created_at) " + + "VALUES (?, 'APPLICATION', '通知', 0, ?)", me, T); + + jdbc.update("INSERT INTO candidate_dimension_scores (student_user_id, dimension, period, score, status, " + + "weight, rules_version, calculated_at, created_at, updated_at) " + + "VALUES (?, 'EDUCATION', '2026-03', 88.00, 'OK', 12.50, 'v1', ?, ?, ?)", me, T, T, T); + jdbc.update("INSERT INTO candidate_scoring_appeals (candidate_user_id, dimension, period, status, " + + "reason, rules_version, created_at, updated_at) " + + "VALUES (?, 'EDUCATION', '2026-03', 'PENDING', '理由', 'v1', ?, ?)", me, T, T); + Long appealId = jdbc.queryForObject("SELECT id FROM candidate_scoring_appeals WHERE candidate_user_id = ?", + Long.class, me); + jdbc.update("INSERT INTO candidate_scoring_appeal_history (appeal_id, from_status, to_status, " + + "actor_user_id, actor_role, created_at) VALUES (?, NULL, 'PENDING', ?, 'ADMIN', ?)", + appealId, other, T); + + jdbc.update("INSERT INTO conversations (title, type, created_by, created_at, updated_at) " + + "VALUES ('会话', 'DIRECT', ?, ?, ?)", me, T, T); + Long convId = jdbc.queryForObject("SELECT id FROM conversations WHERE created_by = ?", Long.class, me); + jdbc.update("INSERT INTO conversation_members (conversation_id, user_id, joined_at) VALUES (?, ?, ?)", + convId, me, T); + jdbc.update("INSERT INTO conversation_members (conversation_id, user_id, joined_at) VALUES (?, ?, ?)", + convId, other, T); + jdbc.update("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, 'm1', 'SENT', ?)", convId, other, T); + jdbc.update("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, 'm2', 'SENT', ?)", convId, me, T.plusMinutes(1)); + Long m1 = jdbc.queryForObject("SELECT MIN(id) FROM messages WHERE conversation_id = ?", Long.class, convId); + jdbc.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) VALUES (?, ?, ?)", m1, me, T); + } + + // ══════════════════════════════════════════════════════════ + // 快照：25 张表的稳定字段，按主键排序逐字段比对 + // ══════════════════════════════════════════════════════════ + + private Map>> snapshot() { + Map>> s = new LinkedHashMap<>(); + s.put("users", q("SELECT id, phone, nickname, role, is_active, is_verified FROM users ORDER BY id")); + s.put("user_roles", q("SELECT user_id, role FROM user_roles ORDER BY user_id, role")); + s.put("companies", q("SELECT id, owner_user_id, name, verified FROM companies ORDER BY id")); + s.put("jobs", q("SELECT id, company_id, title, status FROM jobs ORDER BY id")); + s.put("applications", q("SELECT id, job_id, student_user_id, status FROM applications ORDER BY id")); + s.put("application_status_history", + q("SELECT id, application_id, to_status FROM application_status_history ORDER BY id")); + s.put("interviews", q("SELECT id, application_id, company_user_id, student_user_id, status " + + "FROM interviews ORDER BY id")); + s.put("interview_status_history", + q("SELECT id, interview_id, to_status FROM interview_status_history ORDER BY id")); + s.put("offers", q("SELECT id, application_id, candidate_id, status FROM offers ORDER BY id")); + s.put("offer_status_history", + q("SELECT id, offer_id, to_status FROM offer_status_history ORDER BY id")); + s.put("candidate_feedback", q("SELECT id, application_id, rating FROM candidate_feedback ORDER BY id")); + s.put("job_favorites", q("SELECT id, job_id, student_user_id FROM job_favorites ORDER BY id")); + s.put("notifications", q("SELECT id, user_id, type, is_read FROM notifications ORDER BY id")); + s.put("audit_logs", q("SELECT id, user_id, action, entity_type FROM audit_logs ORDER BY id")); + s.put("auth_tokens", q("SELECT id, user_id, token_type, revoked FROM auth_tokens ORDER BY id")); + s.put("conversations", q("SELECT id, type, created_by, updated_at FROM conversations ORDER BY id")); + s.put("conversation_members", + q("SELECT conversation_id, user_id FROM conversation_members ORDER BY conversation_id, user_id")); + s.put("messages", + q("SELECT id, conversation_id, sender_user_id, status, version FROM messages ORDER BY id")); + s.put("message_reads", q("SELECT id, message_id, reader_user_id FROM message_reads ORDER BY id")); + s.put("student_profiles", q("SELECT id, user_id, real_name FROM student_profiles ORDER BY id")); + s.put("student_preferences", + q("SELECT id, student_user_id, remote_allowed FROM student_preferences ORDER BY id")); + s.put("resume_versions", q("SELECT id, user_id, version_no, status FROM resume_versions ORDER BY id")); + s.put("candidate_dimension_scores", + q("SELECT id, student_user_id, dimension, status FROM candidate_dimension_scores ORDER BY id")); + s.put("candidate_scoring_appeals", + q("SELECT id, candidate_user_id, status FROM candidate_scoring_appeals ORDER BY id")); + s.put("candidate_scoring_appeal_history", + q("SELECT id, appeal_id, to_status FROM candidate_scoring_appeal_history ORDER BY id")); + return s; + } + + private List> q(String sql) { + return jdbc.queryForList(sql); + } + + private static void assertNoChange(Map>> before, + Map>> after, String what) { + assertThat(after.keySet()).isEqualTo(before.keySet()); + for (String table : before.keySet()) { + assertThat(after.get(table)) + .as("%s 期间 %s 必须逐字段零变化", what, table) + .isEqualTo(before.get(table)); + } + } + + // ══════════════════════════════════════════════════════════ + // 测试 + // ══════════════════════════════════════════════════════════ + + @Test + @DisplayName("只读：collector.collect() 前后 25 张表逐字段零变化，且零 AMQP 交互") + void collectIsReadOnly() { + seed(); + Map>> before = snapshot(); + + PersonalDataCollector.CollectResult result = personalDataCollector.collect(me); + + assertThat(result).isNotNull(); + assertThat(result.getSections()).isNotEmpty(); + assertNoChange(before, snapshot(), "collect"); + Mockito.verifyNoInteractions(rabbitTemplate); + } + + @Test + @DisplayName("只读：listConversations() 前后 25 张表逐字段零变化，且零 AMQP 交互") + void listConversationsIsReadOnly() { + seed(); + Map>> before = snapshot(); + + List> list = messagingService.listConversations(me); + + assertThat(list).hasSize(1); + // m1（他人）已被本人读取 → 排除；m2（本人发送、无 message_reads）→ 按 OBS-E01 计入，故为 1 + assertThat(list.get(0).get("unreadCount")).isEqualTo(1L); + assertNoChange(before, snapshot(), "listConversations"); + Mockito.verifyNoInteractions(rabbitTemplate); + } + + @Test + @DisplayName("只读：getConversation 与 collect 组合调用后仍零变化") + void combinedReadPathsAreReadOnly() { + seed(); + Long convId = jdbc.queryForObject("SELECT id FROM conversations WHERE created_by = ?", Long.class, me); + Map>> before = snapshot(); + + messagingService.listConversations(me); + messagingService.getConversation(convId, me); + personalDataCollector.collect(me); + + assertNoChange(before, snapshot(), "listConversations+getConversation+collect"); + Mockito.verifyNoInteractions(rabbitTemplate); + } + + @Test + @DisplayName("通知与审计：读取路径不新增任何行") + void noNotificationsAndAuditsAreCreated() { + seed(); + Integer notificationsBefore = jdbc.queryForObject("SELECT COUNT(*) FROM notifications", Integer.class); + Integer auditsBefore = jdbc.queryForObject("SELECT COUNT(*) FROM audit_logs", Integer.class); + + messagingService.listConversations(me); + personalDataCollector.collect(me); + + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM notifications", Integer.class)) + .as("不新增通知").isEqualTo(notificationsBefore); + assertThat(jdbc.queryForObject("SELECT COUNT(*) FROM audit_logs", Integer.class)) + .as("不新增审计").isEqualTo(auditsBefore); + Mockito.verifyNoInteractions(rabbitTemplate); + } + + // ── 反证：快照必须真的能发现变化 ───────────────────────── + + @Test + @DisplayName("反证：修改一行时，快照断言必须失败") + void snapshotDetectsUpdate() { + seed(); + Map>> before = snapshot(); + jdbc.update("UPDATE users SET nickname = '被篡改' WHERE id = ?", me); + Map>> after = snapshot(); + + assertThatThrownBy(() -> assertNoChange(before, after, "mutation")) + .as("若此处不抛错，说明快照断言形同虚设") + .isInstanceOf(AssertionError.class) + .hasMessageContaining("users"); + } + + @Test + @DisplayName("反证：新增一行时，快照断言必须失败") + void snapshotDetectsInsert() { + seed(); + Map>> before = snapshot(); + jdbc.update("INSERT INTO notifications (user_id, type, title, is_read, created_at) " + + "VALUES (?, 'APPLICATION', '新增', 0, ?)", me, T); + Map>> after = snapshot(); + + assertThatThrownBy(() -> assertNoChange(before, after, "insertion")) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("notifications"); + } + + @Test + @DisplayName("反证：删除一行时，快照断言必须失败") + void snapshotDetectsDelete() { + seed(); + Map>> before = snapshot(); + jdbc.update("DELETE FROM message_reads WHERE reader_user_id = ?", me); + Map>> after = snapshot(); + + assertThatThrownBy(() -> assertNoChange(before, after, "deletion")) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("message_reads"); + } + + @Test + @DisplayName("反证：仅一个字段变化（messages.status）也必须被捕获") + void snapshotDetectsSingleColumnChange() { + seed(); + Long convId = jdbc.queryForObject("SELECT id FROM conversations WHERE created_by = ?", Long.class, me); + Map>> before = snapshot(); + jdbc.update("UPDATE messages SET status = 'RECALLED' WHERE conversation_id = ? AND status = 'SENT'", convId); + Map>> after = snapshot(); + + assertThatThrownBy(() -> assertNoChange(before, after, "single column")) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("messages"); + } + + // ── 回归门禁：既有实施测试的夹具零残留 ──────────────────── + + @Test + @DisplayName("回归门禁：实施测试的 r01e- 夹具在本类可见范围内残留为 0（复验缺失 @AfterEach 的旧问题）") + void implementationFixturesLeaveNoResidue() { + assertThat(jdbc.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone LIKE 'r01e-%' AND phone NOT LIKE '" + PREFIX + "%'", + Integer.class)) + .as("R01EQueryBudgetAcceptanceTest 的 r01e- 用户必须已按 @AfterEach 清干净").isZero(); + assertThat(jdbc.queryForObject( + "SELECT COUNT(*) FROM messages WHERE content LIKE 'm%' AND sender_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE 'r01e-%' AND phone NOT LIKE '" + PREFIX + "%')", + Integer.class)) + .as("实施测试的消息不得残留").isZero(); + assertThat(jdbc.queryForObject( + "SELECT COUNT(*) FROM companies WHERE name = 'r01e-co'", Integer.class)) + .as("实施测试的公司不得残留").isZero(); + assertThat(jdbc.queryForObject( + "SELECT COUNT(*) FROM jobs WHERE title = 'r01e-job'", Integer.class)) + .as("实施测试的岗位不得残留").isZero(); + } + + @Test + @DisplayName("隔离：本类夹具在本用例退场后残留为 0") + void ownFixtureLeavesNoResidue() { + seed(); + cleanup(); + + assertThat(residue()).as("本类自有残留").isZero(); + } + + private long residue() { + long total = 0; + String u = "(SELECT id FROM users WHERE phone LIKE '" + PREFIX + "%')"; + List queries = new ArrayList<>(List.of( + "SELECT COUNT(*) FROM users WHERE phone LIKE '" + PREFIX + "%'", + "SELECT COUNT(*) FROM user_roles WHERE user_id IN " + u, + "SELECT COUNT(*) FROM messages WHERE sender_user_id IN " + u, + "SELECT COUNT(*) FROM message_reads WHERE reader_user_id IN " + u, + "SELECT COUNT(*) FROM conversation_members WHERE user_id IN " + u, + "SELECT COUNT(*) FROM conversations WHERE created_by IN " + u, + "SELECT COUNT(*) FROM applications WHERE student_user_id IN " + u, + "SELECT COUNT(*) FROM notifications WHERE user_id IN " + u)); + for (String sql : queries) { + total += jdbc.queryForObject(sql, Integer.class); + } + return total; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EMySqlQueryCountAndExplainTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EMySqlQueryCountAndExplainTest.java new file mode 100644 index 0000000..a2f78e4 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EMySqlQueryCountAndExplainTest.java @@ -0,0 +1,343 @@ +package com.mydreamjob.common.r01e; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.messaging.MessagingService; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.BatchPreparedStatementSetter; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.sql.PreparedStatement; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * R01-E：**真实 MySQL 8** 上的 E2 跨库一致性与执行计划证据（Testcontainers）。 + * + *

    不做生产改动（E1/E2 已由 R01-D2/D3 交付）。本类证明：

    + *
      + *
    1. 未读分组 SQL 在 MySQL 上与 H2 上的**逐值一致**；
      2. + *
    2. 1 / 20 / 100 会话下 {@code listConversations} 的 SQL 数恒定；
      3. + *
    3. {@code EXPLAIN FORMAT=JSON} 的索引使用、access type、temporary / filesort 情况。
      4. + *
    + * + *

    EXPLAIN 使用与 {@code MessageRepository.countUnreadByConversationIds} **逐字相同**的 SQL + * 与同一批绑定参数，避免解释一条并不存在的语句。

    + */ +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +class R01EMySqlQueryCountAndExplainTest { + + private static final ObjectMapper JSON = new ObjectMapper(); + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("mydreamjob_r01e") + .withUsername("r01e") + .withPassword("r01e"); + + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + } + + /** 与 MessageRepository 中原生查询**逐字一致**（仅换行为便于阅读）。 */ + private static final String UNREAD_SQL = """ + SELECT ranked.conversation_id AS conversationId, COUNT(*) AS unreadCount + FROM ( + SELECT m.id, m.conversation_id, m.status, + ROW_NUMBER() OVER ( + PARTITION BY m.conversation_id + ORDER BY m.created_at DESC + ) AS row_no + FROM messages m + WHERE m.conversation_id IN (%s) + ) ranked + LEFT JOIN message_reads mr + ON mr.message_id = ranked.id + AND mr.reader_user_id = ? + WHERE ranked.row_no <= 500 + AND (ranked.status IS NULL OR ranked.status <> 'RECALLED') + AND mr.id IS NULL + GROUP BY ranked.conversation_id + """; + + @Autowired private MessagingService messagingService; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private Long me; + private Long other; + + @BeforeEach + void setUp() { + jdbcTemplate.update("DELETE FROM message_reads"); + jdbcTemplate.update("DELETE FROM messages"); + jdbcTemplate.update("DELETE FROM conversation_members"); + jdbcTemplate.update("DELETE FROM conversations"); + jdbcTemplate.update("DELETE FROM user_roles"); + jdbcTemplate.update("DELETE FROM users"); + me = user("r01e-my-self"); + other = user("r01e-my-other"); + } + + private Long user(String phone) { + jdbcTemplate.update("INSERT INTO users (phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, 'STUDENT', 1, 1)", phone, phone); + Long id = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, 'STUDENT')", id); + return id; + } + + private Long conversation() { + jdbcTemplate.update("INSERT INTO conversations (type, created_by, created_at, updated_at) " + + "VALUES ('DIRECT', ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", me); + Long cid = jdbcTemplate.queryForObject("SELECT MAX(id) FROM conversations", Long.class); + jdbcTemplate.update("INSERT INTO conversation_members (conversation_id, user_id) VALUES (?, ?)", cid, me); + jdbcTemplate.update("INSERT INTO conversation_members (conversation_id, user_id) VALUES (?, ?)", cid, other); + return cid; + } + + private void message(Long cid, Long sender, int i, String status) { + jdbcTemplate.update("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)", cid, sender, "m" + i, status); + } + + private String inClause(int n) { + return String.join(",", java.util.Collections.nCopies(n, "?")); + } + + @Test + @DisplayName("MySQL：分组未读数与逐会话语义逐值一致（含撤回与已读排除）") + void groupedUnreadMatchesPerConversationSemantics() { + Long c1 = conversation(); + Long c2 = conversation(); + message(c1, other, 1, "SENT"); + message(c1, other, 2, "SENT"); + message(c1, other, 3, "RECALLED"); // 撤回 → 排除 + message(c2, other, 4, "SENT"); + Long readId = jdbcTemplate.queryForObject( + "SELECT MIN(id) FROM messages WHERE conversation_id = ? AND status = 'SENT'", Long.class, c1); + jdbcTemplate.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) " + + "VALUES (?, ?, CURRENT_TIMESTAMP)", readId, me); // 已读 1 条 → 排除 + + List> rows = jdbcTemplate.queryForList( + String.format(UNREAD_SQL, inClause(2)), c1, c2, me); + Map byConv = new LinkedHashMap<>(); + for (Map r : rows) { + byConv.put(((Number) r.get("conversationId")).longValue(), ((Number) r.get("unreadCount")).longValue()); + } + + assertThat(byConv.get(c1)).as("2 条 SENT − 1 条已读 = 1").isEqualTo(1L); + assertThat(byConv.get(c2)).as("1 条 SENT").isEqualTo(1L); + + // 与 Service 路径一致（Service 对未返回的会话补 0） + List> list = messagingService.listConversations(me); + Map svc = new LinkedHashMap<>(); + for (Map v : list) svc.put(((Number) v.get("id")).longValue(), v.get("unreadCount")); + assertThat(svc.get(c1)).isEqualTo(1L); + assertThat(svc.get(c2)).isEqualTo(1L); + } + + @Test + @DisplayName("MySQL：空列表与不属用户的 conversationId 均不返回") + void emptyAndForeignConversations() { + assertThat(jdbcTemplate.queryForList(String.format(UNREAD_SQL, inClause(1)), -1L, me)).isEmpty(); + + Long c1 = conversation(); + message(c1, other, 1, "SENT"); + // 不传该会话 id → 不返回 + assertThat(jdbcTemplate.queryForList(String.format(UNREAD_SQL, inClause(1)), -1L, me)).isEmpty(); + } + + @Test + @DisplayName("MySQL：1 / 20 / 100 会话下 Service SQL 数与结果均正确") + void conversationScaleIsFlatAndCorrect() { + int[] sizes = {1, 20, 100}; + for (int size : sizes) { + jdbcTemplate.update("DELETE FROM message_reads"); + jdbcTemplate.update("DELETE FROM messages"); + jdbcTemplate.update("DELETE FROM conversation_members"); + jdbcTemplate.update("DELETE FROM conversations"); + + for (int i = 0; i < size; i++) { + Long cid = conversation(); + for (int m = 0; m < 3; m++) message(cid, other, m, "SENT"); + } + + List> list = messagingService.listConversations(me); + assertThat(list).as("size=%d", size).hasSize(size); + for (Map v : list) { + assertThat(v.get("unreadCount")).as("size=%d 每会话 3 条未读", size).isEqualTo(3L); + } + } + } + + @Test + @DisplayName("MySQL EXPLAIN FORMAT=JSON：记录索引、access type、temporary 与 filesort") + void explainUnreadQuery() throws Exception { + // 铺入不属于查询范围的背景消息，使目标会话保持高选择性；否则最小表上全表扫描 + // 是优化器的合理代价选择，无法证明现有索引在真实列表形态下可用。 + Long background = conversation(); + jdbcTemplate.batchUpdate( + "INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, 'SENT', CURRENT_TIMESTAMP)", + new BatchPreparedStatementSetter() { + @Override + public void setValues(PreparedStatement ps, int i) throws SQLException { + ps.setLong(1, background); + ps.setLong(2, other); + ps.setString(3, "background-" + i); + } + + @Override + public int getBatchSize() { + return 10_000; + } + }); + + Long cid = conversation(); + for (int i = 0; i < 200; i++) message(cid, other, i, "SENT"); + jdbcTemplate.execute("ANALYZE TABLE messages"); + + List> explain = jdbcTemplate.queryForList( + "EXPLAIN FORMAT=JSON " + String.format(UNREAD_SQL, inClause(1)), cid, me); + assertThat(explain).isNotEmpty(); + String json = String.valueOf(explain.get(0).get("EXPLAIN")); + JsonNode root = JSON.readTree(json); + + StringBuilder summary = new StringBuilder(); + summary.append("EXPLAIN_JSON_LENGTH=").append(json.length()).append('\n'); + for (String key : List.of("using_temporary_table", "using_filesort", "access_type", + "key\"", "possible_keys", "table_name", "rows_examined_per_scan", "cost_info")) { + summary.append(key).append(" -> ").append(json.contains(key) ? "present" : "absent").append('\n'); + } + // 提取关键片段（截断，避免把整份 JSON 写入报告） + int idx = json.indexOf("\"access_type\""); + if (idx > 0) { + summary.append("SNIPPET=").append(json, Math.max(0, idx - 200), Math.min(json.length(), idx + 400)).append('\n'); + } + try { + java.nio.file.Files.writeString( + java.nio.file.Path.of("target", "r01e-mysql-explain.txt"), summary.toString()); + } catch (Exception ignored) { + // 诊断输出 + } + System.out.println("[R01E-MYSQL-EXPLAIN] " + summary); + + assertExplainPlan(root); + } + + @Test + @DisplayName("EXPLAIN 结构断言可识别错误索引、基础表全扫与缺失节点") + void explainAssertionsRejectMutatedPlans() throws Exception { + String valid = """ + {"query_block":{"using_temporary_table":true,"using_filesort":true,"nested_loop":[ + {"table":{"table_name":"ranked","access_type":"ALL"}}, + {"table":{"table_name":"m","access_type":"ref","key":"idx_messages_conversation_created"}}, + {"table":{"table_name":"mr","access_type":"eq_ref","key":"uk_message_reads"}} + ]}} + """; + assertExplainPlan(JSON.readTree(valid)); + assertThatThrownBy(() -> assertExplainPlan(JSON.readTree( + valid.replace("idx_messages_conversation_created", "wrong_index")))) + .isInstanceOf(AssertionError.class); + assertThatThrownBy(() -> assertExplainPlan(JSON.readTree( + valid.replace("\"access_type\":\"ref\"", "\"access_type\":\"ALL\"")))) + .isInstanceOf(AssertionError.class); + String missingReads = """ + {"query_block":{"using_temporary_table":true,"using_filesort":true,"nested_loop":[ + {"table":{"table_name":"ranked","access_type":"ALL"}}, + {"table":{"table_name":"m","access_type":"ref","key":"idx_messages_conversation_created"}} + ]}} + """; + assertThatThrownBy(() -> assertExplainPlan(JSON.readTree(missingReads))) + .isInstanceOf(AssertionError.class); + } + + private static void assertExplainPlan(JsonNode root) { + List nodes = new ArrayList<>(); + collectPlanNodes(root, nodes); + PlanNode messages = onlyNode(nodes, "m"); + PlanNode reads = onlyNode(nodes, "mr"); + PlanNode ranked = onlyNode(nodes, "ranked"); + + assertThat(messages.accessType()).isIn("ref", "range"); + assertThat(messages.key()).isEqualTo("idx_messages_conversation_created"); + assertThat(messages.accessType()).isNotEqualTo("ALL"); + assertThat(reads.accessType()).isEqualTo("eq_ref"); + assertThat(reads.key()).isEqualTo("uk_message_reads"); + assertThat(ranked.accessType()).isEqualTo("ALL"); + assertThat(findBooleanValue(root, "using_temporary_table")) + .as("必须显式读取 using_temporary_table") + .isPresent(); + assertThat(findBooleanValue(root, "using_filesort")) + .as("必须显式读取 using_filesort") + .isPresent(); + } + + private static PlanNode onlyNode(List nodes, String alias) { + List matches = nodes.stream().filter(node -> alias.equals(node.tableName())).toList(); + assertThat(matches).as("EXPLAIN 节点 %s 必须存在且唯一", alias).hasSize(1); + return matches.get(0); + } + + private static void collectPlanNodes(JsonNode node, List out) { + if (node == null) return; + if (node.isObject()) { + JsonNode table = node.get("table"); + if (table != null && table.isObject() && table.has("table_name")) { + out.add(new PlanNode( + table.path("table_name").asText(), + table.path("access_type").asText(), + table.has("key") ? table.path("key").asText() : null)); + } + node.fields().forEachRemaining(entry -> collectPlanNodes(entry.getValue(), out)); + } else if (node.isArray()) { + node.forEach(child -> collectPlanNodes(child, out)); + } + } + + private static Optional findBooleanValue(JsonNode node, String field) { + if (node == null) return Optional.empty(); + if (node.isObject()) { + if (node.has(field) && node.get(field).isBoolean()) { + return Optional.of(node.get(field).asBoolean()); + } + for (JsonNode child : node) { + Optional found = findBooleanValue(child, field); + if (found.isPresent()) return found; + } + } else if (node.isArray()) { + for (JsonNode child : node) { + Optional found = findBooleanValue(child, field); + if (found.isPresent()) return found; + } + } + return Optional.empty(); + } + + private record PlanNode(String tableName, String accessType, String key) {} +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EQueryBudgetAcceptanceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EQueryBudgetAcceptanceTest.java new file mode 100644 index 0000000..cf4e77d --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/common/r01e/R01EQueryBudgetAcceptanceTest.java @@ -0,0 +1,418 @@ +package com.mydreamjob.common.r01e; + +import com.mydreamjob.dataexport.PersonalDataCollector; +import com.mydreamjob.messaging.MessagingService; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.ContextConfiguration; + +import javax.sql.DataSource; +import java.sql.Connection; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.LinkedHashMap; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * R01-E 验收：E1 批量查询与 E2 会话未读数聚合的**查询预算**特征。 + * + *

    本轮不改生产代码（E1/E2 已由 R01-D2/D3 交付并处于目标终态）， + * 本类用于**锁定**其查询次数形态：SQL 数不得随记录数/会话数线性增长。

    + * + *

    复用项目既有做法（{@code MessageListQueryBudgetIntegrationTest} 的 CountingDataSource 模式）： + * 通过只包一层的 DataSource 统计**真实 JDBC 语句**，而非 Mockito verify Repository。 + * 该包装器仅存在于测试源，不新增生产依赖。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +@ContextConfiguration(classes = {R01EQueryBudgetAcceptanceTest.CountingDataSourceConfiguration.class}) +class R01EQueryBudgetAcceptanceTest { + + @Autowired private MessagingService messagingService; + @Autowired private PersonalDataCollector personalDataCollector; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private CountingDataSource countingDataSource; + @MockBean private RedisTemplate redisTemplate; + + private Long me; + private Long other; + private Long companyId; + + @BeforeEach + void setUp() { + cleanup(); + me = user("r01e-self"); + other = user("r01e-other"); + companyId = null; + countingDataSource.reset(); + } + + /** 退场清理：本类会创建用户/公司/岗位/会话/消息，必须按精确条件清干净， + * 否则会污染后续使用 userRepository.deleteAll() 的测试类与审计计数断言。 */ + @AfterEach + void tearDown() { + cleanup(); + companyId = null; + } + + private void cleanup() { + jdbcTemplate.update("DELETE FROM message_reads WHERE message_id IN " + + "(SELECT id FROM messages WHERE sender_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE 'r01e-%'))"); + jdbcTemplate.update("DELETE FROM messages WHERE sender_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE 'r01e-%')"); + jdbcTemplate.update("DELETE FROM conversation_members WHERE user_id IN " + + "(SELECT id FROM users WHERE phone LIKE 'r01e-%')"); + jdbcTemplate.update("DELETE FROM conversations WHERE id NOT IN (SELECT DISTINCT conversation_id FROM conversation_members)"); + jdbcTemplate.update("DELETE FROM applications WHERE student_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE 'r01e-%')"); + jdbcTemplate.update("DELETE FROM jobs WHERE title = 'r01e-job'"); + jdbcTemplate.update("DELETE FROM companies WHERE name = 'r01e-co'"); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (SELECT id FROM users WHERE phone LIKE 'r01e-%')"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE 'r01e-%'"); + } + + private Long user(String phone) { + jdbcTemplate.update("INSERT INTO users (phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, 'STUDENT', 1, 1)", phone, phone); + Long id = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, 'STUDENT')", id); + return id; + } + + private Long conversation(int index) { + jdbcTemplate.update("INSERT INTO conversations (type, created_by, created_at, updated_at) " + + "VALUES ('DIRECT', ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", me); + Long cid = jdbcTemplate.queryForObject("SELECT MAX(id) FROM conversations", Long.class); + jdbcTemplate.update("INSERT INTO conversation_members (conversation_id, user_id) VALUES (?, ?)", cid, me); + jdbcTemplate.update("INSERT INTO conversation_members (conversation_id, user_id) VALUES (?, ?)", cid, other); + return cid; + } + + /** + * 新建一个岗位供 applications 外键使用。 + * + *

    {@code companies.owner_user_id} 有唯一约束，故公司**只建一次**并复用，岗位可多次新建 + * （{@code applications(job_id, student_user_id)} 唯一，故每行投递需独立岗位）。

    + */ + private Long createJob() { + if (companyId == null) { + jdbcTemplate.update("INSERT INTO companies (name, owner_user_id, verified, created_at, updated_at) " + + "VALUES ('r01e-co', ?, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", other); + companyId = jdbcTemplate.queryForObject("SELECT MAX(id) FROM companies", Long.class); + } + jdbcTemplate.update("INSERT INTO jobs (company_id, title, description, city, employment_type, status, " + + "created_at, updated_at) VALUES (?, 'r01e-job', 'd', '北京', 'FULL_TIME', 'PUBLISHED', " + + "CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", companyId); + return jdbcTemplate.queryForObject("SELECT MAX(id) FROM jobs", Long.class); + } + + private void message(Long cid, Long sender, int i) { + jdbcTemplate.update("INSERT INTO messages (conversation_id, sender_user_id, content, status, created_at) " + + "VALUES (?, ?, ?, 'SENT', CURRENT_TIMESTAMP)", cid, sender, "m" + i); + } + + // ══ E2：会话列表未读数 ════════════════════════════════════ + + @Test + @DisplayName("E2：无会话时返回空列表且不执行 IN () 查询") + void noConversationsShortCircuits() { + countingDataSource.reset(); + assertThat(messagingService.listConversations(me)).isEmpty(); + assertThat(countingDataSource.statements()) + .as("空会话不得执行无意义的 IN () 查询") + .isLessThanOrEqualTo(1); + } + + @Test + @DisplayName("E2：单会话无消息 → unreadCount=0") + void singleConversationWithoutMessages() { + conversation(0); + List> list = messagingService.listConversations(me); + assertThat(list).hasSize(1); + assertThat(list.get(0).get("unreadCount")).isEqualTo(0L); + } + + @Test + @DisplayName("E2（既有语义）：未读 = 非 RECALLED 且该读者无 message_reads 记录，**不按发送者过滤**") + void unreadSemantics() { + Long cid = conversation(0); + message(cid, me, 1); // 本人发送：既有实现同样计入（未读查询不按 sender 过滤） + message(cid, other, 2); + message(cid, other, 3); + + List> list = messagingService.listConversations(me); + assertThat(list.get(0).get("unreadCount")) + .as("既有语义：三条消息均未被 me 读过，故全部计入；发送者不参与过滤") + .isEqualTo(3L); + } + + @Test + @DisplayName("E2（既有语义）：写入 message_reads 后该消息不再计入未读") + void readMessagesAreExcluded() { + Long cid = conversation(0); + message(cid, other, 1); + message(cid, other, 2); + Long firstId = jdbcTemplate.queryForObject( + "SELECT MIN(id) FROM messages WHERE conversation_id = ?", Long.class, cid); + jdbcTemplate.update("INSERT INTO message_reads (message_id, reader_user_id, read_at) " + + "VALUES (?, ?, CURRENT_TIMESTAMP)", firstId, me); + + List> list = messagingService.listConversations(me); + assertThat(list.get(0).get("unreadCount")).as("已读 1 条，剩 1 条").isEqualTo(1L); + } + + @Test + @DisplayName("E2（既有语义）：RECALLED 消息不计未读") + void recalledMessagesAreExcluded() { + Long cid = conversation(0); + message(cid, other, 1); + message(cid, other, 2); + jdbcTemplate.update("UPDATE messages SET status = 'RECALLED' WHERE conversation_id = ? " + + "AND id = (SELECT MIN(id) FROM messages WHERE conversation_id = ?)", cid, cid); + + List> list = messagingService.listConversations(me); + assertThat(list.get(0).get("unreadCount")).as("撤回 1 条，剩 1 条").isEqualTo(1L); + } + + @Test + @DisplayName("E2：多会话分别聚合，缺失会话补 0") + void multipleConversationsAggregateSeparately() { + Long c1 = conversation(0); + Long c2 = conversation(1); + Long c3 = conversation(2); + message(c1, other, 1); + message(c1, other, 2); + message(c2, other, 3); + + List> list = messagingService.listConversations(me); + java.util.Map byConv = new java.util.HashMap<>(); + for (java.util.Map v : list) byConv.put(((Number) v.get("id")).longValue(), v.get("unreadCount")); + + assertThat(byConv.get(c1)).isEqualTo(2L); + assertThat(byConv.get(c2)).isEqualTo(1L); + assertThat(byConv.get(c3)).as("无未读会话补 0").isEqualTo(0L); + } + + private static final Map MEASURED = new LinkedHashMap<>(); + + private static void record(String key, String value) { + MEASURED.put(key, value); + try { + StringBuilder sb = new StringBuilder(); + MEASURED.forEach((k, v) -> sb.append(k).append('=').append(v).append('\n')); + java.nio.file.Files.writeString(java.nio.file.Path.of("target", "r01e-sql-counts.txt"), sb.toString()); + } catch (Exception ignored) { + // 仅诊断输出 + } + } + + @Test + @DisplayName("E2：查询数不随会话数线性增长（1 / 20 / 100）") + void unreadQueryCountIsFlat() { + int[] baseline = new int[3]; + int[] sizes = {1, 20, 100}; + for (int s = 0; s < sizes.length; s++) { + cleanup(); + companyId = null; + me = user("r01e-self"); + other = user("r01e-other"); + List cids = new ArrayList<>(); + for (int i = 0; i < sizes[s]; i++) { + Long cid = conversation(i); + cids.add(cid); + message(cid, other, i); // 每个会话 1 条未读 + } + countingDataSource.reset(); + List> list = messagingService.listConversations(me); + baseline[s] = countingDataSource.statements(); + + assertThat(list).as("size=%d", sizes[s]).hasSize(sizes[s]); + for (java.util.Map v : list) { + assertThat(v.get("unreadCount")).as("size=%d 每会话 1 条未读", sizes[s]).isEqualTo(1L); + } + } + + record("E2.conversations_1", String.valueOf(baseline[0])); + record("E2.conversations_20", String.valueOf(baseline[1])); + record("E2.conversations_100", String.valueOf(baseline[2])); + + assertThat(baseline[1]).as("20 会话的 SQL 数(%d) 不得随会话数增长 (1 会话=%d)", baseline[1], baseline[0]) + .isEqualTo(baseline[0]); + assertThat(baseline[2]).as("100 会话的 SQL 数(%d) 不得随会话数增长 (1 会话=%d)", baseline[2], baseline[0]) + .isEqualTo(baseline[0]); + } + + // ══ E1：个人数据导出批量查询 ══════════════════════════════ + + @Test + @DisplayName("E1：collect() 的 SQL 数不随记录数线性增长（1 / 10 / 50 条投递）") + void personalDataCollectQueryCountIsFlat() { + int[] measured = new int[3]; + int[] sizes = {1, 10, 50}; + + for (int s = 0; s < sizes.length; s++) { + cleanup(); + companyId = null; // cleanup 已删除公司，缓存必须一并失效 + me = user("r01e-self"); + other = user("r01e-other"); + for (int i = 0; i < sizes[s]; i++) { + Long jobId = createJob(); // (job_id, student_user_id) 唯一：每行用独立岗位 + jdbcTemplate.update("INSERT INTO applications (job_id, student_user_id, status, created_at, updated_at) " + + "VALUES (?, ?, 'SUBMITTED', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", jobId, me); + } + countingDataSource.reset(); + PersonalDataCollector.CollectResult result = personalDataCollector.collect(me); + measured[s] = countingDataSource.statements(); + + assertThat(result).isNotNull(); + } + + record("E1.applications_1", String.valueOf(measured[0])); + record("E1.applications_10", String.valueOf(measured[1])); + record("E1.applications_50", String.valueOf(measured[2])); + + assertThat(measured[1]).as("10 条投递的 SQL 数(%d) 不得随 N 增长 (1 条=%d)", measured[1], measured[0]) + .isEqualTo(measured[0]); + assertThat(measured[2]).as("50 条投递的 SQL 数(%d) 不得随 N 增长 (1 条=%d)", measured[2], measured[0]) + .isEqualTo(measured[0]); + } + + + // ===== 副作用与安全 ===== + + /** 稳定字段行级快照（仅稳定列，按主键排序），用于证明读路径零写。 */ + private Map>> snapshot() { + Map>> out = new LinkedHashMap<>(); + out.put("users", jdbcTemplate.queryForList("SELECT id, phone, nickname, role, is_active FROM users ORDER BY id")); + out.put("user_roles", jdbcTemplate.queryForList("SELECT user_id, role FROM user_roles ORDER BY user_id, role")); + out.put("conversations", jdbcTemplate.queryForList("SELECT id, type, created_by, updated_at FROM conversations ORDER BY id")); + out.put("conversation_members", jdbcTemplate.queryForList("SELECT conversation_id, user_id FROM conversation_members ORDER BY conversation_id, user_id")); + out.put("messages", jdbcTemplate.queryForList("SELECT id, conversation_id, sender_user_id, status FROM messages ORDER BY id")); + out.put("message_reads", jdbcTemplate.queryForList("SELECT id, message_id, reader_user_id FROM message_reads ORDER BY id")); + out.put("notifications", jdbcTemplate.queryForList("SELECT id, user_id, type, title FROM notifications ORDER BY id")); + out.put("audit_logs", jdbcTemplate.queryForList("SELECT id, user_id, action, entity_type FROM audit_logs ORDER BY id")); + out.put("auth_tokens", jdbcTemplate.queryForList("SELECT id, user_id, token_type, revoked FROM auth_tokens ORDER BY id")); + out.put("applications", jdbcTemplate.queryForList("SELECT id, job_id, student_user_id, status FROM applications ORDER BY id")); + out.put("job_favorites", jdbcTemplate.queryForList("SELECT id, job_id, student_user_id FROM job_favorites ORDER BY id")); + return out; + } + + private void assertNoChange(Map>> before, + Map>> after, String what) { + for (String table : before.keySet()) { + assertThat(after.get(table)).as("%s 期间 %s 必须逐字段零变化", what, table).isEqualTo(before.get(table)); + } + } + + @Test + @DisplayName("副作用：会话列表 GET 为纯读，11 张相关表逐字段零变化") + void listConversationsIsReadOnly() { + Long cid = conversation(0); + message(cid, other, 1); + message(cid, me, 2); + + Map>> before = snapshot(); + List> list = messagingService.listConversations(me); + Map>> after = snapshot(); + + assertThat(list).hasSize(1); + assertNoChange(before, after, "listConversations"); + } + + @Test + @DisplayName("副作用：collector.collect() 不写业务表；不新增通知与审计") + void personalDataCollectIsReadOnly() { + Long jobId = createJob(); + jdbcTemplate.update("INSERT INTO applications (job_id, student_user_id, status, created_at, updated_at) " + + "VALUES (?, ?, 'SUBMITTED', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", jobId, me); + + Integer notificationsBefore = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM notifications", Integer.class); + Integer auditsBefore = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM audit_logs", Integer.class); + Map>> before = snapshot(); + + PersonalDataCollector.CollectResult result = personalDataCollector.collect(me); + + assertThat(result).isNotNull(); + assertNoChange(before, snapshot(), "collect"); + assertThat(jdbcTemplate.queryForObject("SELECT COUNT(*) FROM notifications", Integer.class)) + .as("不新增通知").isEqualTo(notificationsBefore); + assertThat(jdbcTemplate.queryForObject("SELECT COUNT(*) FROM audit_logs", Integer.class)) + .as("不新增审计").isEqualTo(auditsBefore); + } + + @Test + @DisplayName("安全：不泄漏其他用户数据；不属于任何会话的用户看不到该会话") + void noCrossUserLeakage() { + Long cid = conversation(0); + message(cid, other, 1); + + List> list = messagingService.listConversations(me); + assertThat(list).as("me 只看到自己的 1 个会话").hasSize(1); + assertThat(list.get(0).get("unreadCount")).isEqualTo(1L); + + Long outsider = user("r01e-outsider"); + assertThat(messagingService.listConversations(outsider)).as("非参与者看不到该会话").isEmpty(); + } + + @TestConfiguration + static class CountingDataSourceConfiguration { + @Bean + @Primary + CountingDataSource dataSource(DataSourceProperties properties) { + return new CountingDataSource(properties.initializeDataSourceBuilder().build()); + } + } + + /** 只包一层、统计真实 JDBC 语句数的 DataSource（仅测试源）。 */ + static final class CountingDataSource extends org.springframework.jdbc.datasource.AbstractDataSource { + private final DataSource delegate; + private final AtomicInteger statements = new AtomicInteger(); + + CountingDataSource(DataSource delegate) { + this.delegate = delegate; + } + + void reset() { + statements.set(0); + } + + int statements() { + return statements.get(); + } + + @Override public Connection getConnection() throws java.sql.SQLException { + return wrap(delegate.getConnection()); + } + + @Override public Connection getConnection(String u, String p) throws java.sql.SQLException { + return wrap(delegate.getConnection(u, p)); + } + + private Connection wrap(Connection c) { + return (Connection) java.lang.reflect.Proxy.newProxyInstance( + Connection.class.getClassLoader(), new Class[]{Connection.class}, + (proxy, method, args) -> { + if ("prepareStatement".equals(method.getName()) || "createStatement".equals(method.getName())) { + statements.incrementAndGet(); + } + return method.invoke(c, args); + }); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyControllerMvcTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyControllerMvcTest.java index 5668cc8..0806ae4 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyControllerMvcTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyControllerMvcTest.java @@ -1,6 +1,9 @@ package com.mydreamjob.company; +import com.mydreamjob.auth.AuthSessionService; import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; @@ -15,7 +18,9 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers. @WebMvcTest(CompanyController.class) @AutoConfigureMockMvc(addFilters = false) -@MockBean({JpaMetamodelMappingContext.class, JwtTokenProvider.class}) +@MockBean({JpaMetamodelMappingContext.class, JwtTokenProvider.class, + AuthSessionService.class, java.time.Clock.class, + RequestIdAccessor.class, CurrentUserAccessor.class}) class CompanyControllerMvcTest { @Autowired @@ -24,6 +29,9 @@ class CompanyControllerMvcTest { @MockBean private CompanyService companyService; + @MockBean + private CompanyOnboardingService companyOnboardingService; + @Test void getCompany_nonNumericId_shouldReturn400WithCode1001() throws Exception { mockMvc.perform(get("/companies/abc")) @@ -31,4 +39,4 @@ class CompanyControllerMvcTest { .andExpect(jsonPath("$.code").value(1001)) .andExpect(jsonPath("$.message").value("bad request")); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingControllerTest.java new file mode 100644 index 0000000..878f5d7 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingControllerTest.java @@ -0,0 +1,46 @@ +package com.mydreamjob.company; + +import com.mydreamjob.auth.AuthSessionService; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.common.logging.RequestIdAccessor; +import com.mydreamjob.security.CurrentUserAccessor; +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.autoconfigure.web.servlet.WebMvcTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.jpa.mapping.JpaMetamodelMappingContext; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.mockito.Mockito.*; +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; + +@WebMvcTest(CompanyController.class) +@AutoConfigureMockMvc(addFilters = false) +@MockBean({JpaMetamodelMappingContext.class, JwtTokenProvider.class, AuthSessionService.class, + java.time.Clock.class, RequestIdAccessor.class, CurrentUserAccessor.class}) +class CompanyOnboardingControllerTest { + @Autowired MockMvc mockMvc; + @MockBean CompanyService companyService; + @MockBean CompanyOnboardingService onboardingService; + @MockBean CurrentUserAccessor userAccessor; + + @Test + void onboardingEndpointReturnsSafeAggregateAndUsesAuthenticatedUser() throws Exception { + when(userAccessor.requireUserId()).thenReturn(77L); + when(onboardingService.get(77L)).thenReturn(new CompanyOnboardingResponse( + new CompanyOnboardingResponse.CompanySummary(12L, "企业", null, "简介", "互联网", null, "地址", false), + "UNVERIFIED", null, List.of("INDUSTRY"), List.of("UPDATE_PROFILE", "SUBMIT_VERIFICATION"))); + + mockMvc.perform(get("/companies/me/onboarding")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.onboardingStatus").value("UNVERIFIED")) + .andExpect(jsonPath("$.data.allowedActions[1]").value("SUBMIT_VERIFICATION")) + .andExpect(jsonPath("$.data.company.name").value("企业")); + verify(onboardingService).get(77L); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingServiceTest.java new file mode 100644 index 0000000..7a21f90 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyOnboardingServiceTest.java @@ -0,0 +1,84 @@ +package com.mydreamjob.company; + +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.company.CompanyOnboardingResponse.VerificationSummary; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.verification.CompanyVerification; +import com.mydreamjob.verification.CompanyVerificationRepository; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class CompanyOnboardingServiceTest { + @Mock UserRoleGuard guard; + @Mock CompanyRepository companies; + @Mock CompanyVerificationRepository verifications; + + @Test + void derivesUnverifiedAndDoesNotExposeReviewDetails() { + Company company = Company.builder().id(7L).ownerUserId(9L).name("企业") + .industry("互联网").verified(false).build(); + when(companies.findByOwnerUserId(9L)).thenReturn(Optional.of(company)); + when(verifications.findTopByCompanyIdOrderByIdDesc(7L)).thenReturn(Optional.empty()); + + CompanyOnboardingResponse result = new CompanyOnboardingService(guard, companies, verifications).get(9L); + + assertThat(result.onboardingStatus()).isEqualTo("UNVERIFIED"); + assertThat(result.latestVerification()).isNull(); + assertThat(result.allowedActions()).containsExactly("UPDATE_PROFILE", "SUBMIT_VERIFICATION"); + verify(guard).requireCompany(9L); + } + + @Test + void derivesPendingWithoutReturningSensitiveMaterial() { + Company company = Company.builder().id(7L).ownerUserId(9L).name("企业") + .industry("互联网").description("简介").address("地址").verified(false).build(); + CompanyVerification verification = CompanyVerification.builder().id(8L).companyId(7L) + .status("RESUBMITTED").materialsJson("secret-material").decisionReason("internal").build(); + when(companies.findByOwnerUserId(9L)).thenReturn(Optional.of(company)); + when(verifications.findTopByCompanyIdOrderByIdDesc(7L)).thenReturn(Optional.of(verification)); + + VerificationSummary result = new CompanyOnboardingService(guard, companies, verifications).get(9L) + .latestVerification(); + + assertThat(result.status()).isEqualTo("RESUBMITTED"); + assertThat(result).hasNoNullFieldsOrPropertiesExcept("submittedAt", "decidedAt"); + verifyNoMoreInteractions(companies, verifications); + } + + @Test + void verifiedCompanyWinsOverPendingReview() { + Company company = Company.builder().id(17L).ownerUserId(19L).name("已认证企业") + .verified(true).build(); + when(companies.findByOwnerUserId(19L)).thenReturn(Optional.of(company)); + when(verifications.findTopByCompanyIdOrderByIdDesc(17L)).thenReturn(Optional.of( + CompanyVerification.builder().id(18L).companyId(17L).status("PENDING").build())); + + CompanyOnboardingResponse result = new CompanyOnboardingService(guard, companies, verifications).get(19L); + assertThat(result.onboardingStatus()).isEqualTo("VERIFIED"); + assertThat(result.allowedActions()).containsExactly("ENTER_COMPANY_WORKSPACE"); + } + + @Test + void approvedReviewWithoutCompanyVerificationFailsClosed() { + Company company = Company.builder().id(27L).ownerUserId(29L).name("不一致企业") + .verified(false).build(); + when(companies.findByOwnerUserId(29L)).thenReturn(Optional.of(company)); + when(verifications.findTopByCompanyIdOrderByIdDesc(27L)).thenReturn(Optional.of( + CompanyVerification.builder().id(28L).companyId(27L).status("APPROVED").build())); + + assertThatThrownBy(() -> new CompanyOnboardingService(guard, companies, verifications).get(29L)) + .isInstanceOf(BusinessException.class) + .extracting("errorCodeInt") + .isEqualTo(com.mydreamjob.common.exception.ErrorCode.COMPANY_ONBOARDING_INCONSISTENT_STATE.getCode()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyServiceTest.java index e25854e..212dda0 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/company/CompanyServiceTest.java @@ -2,6 +2,8 @@ package com.mydreamjob.company; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.dto.CompanyCreateRequest; @@ -28,6 +30,9 @@ class CompanyServiceTest { @Mock private UserRepository userRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private CompanyService companyService; @@ -37,6 +42,9 @@ class CompanyServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + company = Company.builder() .id(1L).ownerUserId(COMPANY_USER_ID) .name("测试企业").description("一家科技公司") diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingCalculatorTest.java index e710892..de32825 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingCalculatorTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingCalculatorTest.java @@ -4,6 +4,7 @@ import com.mydreamjob.application.Application; import com.mydreamjob.candidatescore.CandidateDimensionScore; import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import com.mydreamjob.candidatescore.CandidateOverviewStatusPolicy; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; @@ -151,7 +152,7 @@ class CompetitionRankingCalculatorTest { @Test void overviewStatus_emptyIsInsufficientData() { - assertEquals("INSUFFICIENT_DATA", calculator.overviewStatus(List.of())); + assertEquals("INSUFFICIENT_DATA", CandidateOverviewStatusPolicy.fromSnapshots(List.of())); } private Application app(Long sid, String created) { @@ -165,4 +166,4 @@ class CompetitionRankingCalculatorTest { .score(new BigDecimal("80")).status("OK") .weight(new BigDecimal("12.50")).rulesVersion("candidate-scoring-v0.1").build(); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingControllerTest.java index 381047b..1936aaa 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingControllerTest.java @@ -180,8 +180,7 @@ class CompetitionRankingControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } // ── 权限矩阵 ────────────────────────────────────────────── @@ -321,7 +320,6 @@ class CompetitionRankingControllerTest { } private String tokenWithRole(Long userId, User.Role role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", role.name())); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); } } \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingServiceTest.java index ccfa0e9..1482df0 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/competition/CompetitionRankingServiceTest.java @@ -4,13 +4,17 @@ import com.mydreamjob.application.Application; import com.mydreamjob.application.ApplicationRepository; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.candidatescore.CandidateDimensionScore; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.competition.dto.CompetitionRankingResponse; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobService; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; import org.mockito.Mock; @@ -41,6 +45,11 @@ import static org.mockito.Mockito.*; @MockitoSettings(strictness = Strictness.LENIENT) class CompetitionRankingServiceTest { + @BeforeEach + void wireRoleGuard() { + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + } + private static final Long ME = 100L; private static final Long JOB = 9L; @@ -48,7 +57,11 @@ class CompetitionRankingServiceTest { @Mock private JobService jobService; @Mock private ApplicationRepository applicationRepository; @Mock private CompetitionRankingCalculator rankingCalculator; + @Mock private CandidateScoringCalculator candidateScoringCalculator; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private CompetitionRankingService service; // ── 权限与参数校验 ───────────────────────────────────────── diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/config/ActuatorIsolationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/config/ActuatorIsolationIntegrationTest.java new file mode 100644 index 0000000..1792938 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/config/ActuatorIsolationIntegrationTest.java @@ -0,0 +1,317 @@ +package com.mydreamjob.config; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.support.TestAuthTokens; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.boot.test.web.server.LocalManagementPort; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.test.context.ActiveProfiles; + +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpResponse; +import java.time.Duration; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * S03-C Actuator 隔离：业务端口不提供指标，管理端口只绑定配置地址，健康探针最小化。 + * + *

    真实启动两个端口（业务随机端口 + 管理随机端口），用真实 HTTP 验证。

    + */ +@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT, + properties = { + "management.server.port=0", + "management.server.address=127.0.0.1" + }) +@ActiveProfiles("integration-test") +class ActuatorIsolationIntegrationTest { + + private static final AtomicLong PHONE_SEQ = new AtomicLong(8700); + + @MockBean + private RedisTemplate redisTemplate; + + @LocalServerPort + private int businessPort; + + @LocalManagementPort + private int managementPort; + + @Value("${management.server.address}") + private String managementAddress; + + @Value("${management.endpoint.health.show-details}") + private String showDetails; + + @Value("${management.endpoint.health.show-components}") + private String showComponents; + + @Autowired + private UserRepository userRepository; + + private final HttpClient client = HttpClient.newBuilder() + .connectTimeout(Duration.ofSeconds(5)).build(); + private Long studentId; + private Long companyId; + private Long adminId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + + studentId = createUser(User.Role.STUDENT); + companyId = createUser(User.Role.COMPANY); + adminId = createUser(User.Role.ADMIN); + } + + @AfterEach + void tearDown() { + for (Long id : new Long[]{studentId, companyId, adminId}) { + if (id != null) { + userRepository.deleteById(id); + } + } + } + + private Long createUser(User.Role role) { + return userRepository.save(User.builder() + .phone("16" + String.format("%09d", PHONE_SEQ.incrementAndGet())) + .nickname("S03 actuator") + .role(role).roles(Set.of(role)) + .active(true).verified(true).build()).getId(); + } + + private int get(int port, String path, String token) { + try { + HttpRequest.Builder b = HttpRequest.newBuilder() + .uri(URI.create("http://127.0.0.1:" + port + path)) + .timeout(Duration.ofSeconds(10)).GET(); + if (token != null) { + b.header("Authorization", "Bearer " + token); + } + return client.send(b.build(), HttpResponse.BodyHandlers.ofString()).statusCode(); + } catch (Exception e) { + return -1; + } + } + + private String body(int port, String path) { + return rawGet(port, path, null).body(); + } + + /** 一次真实 HTTP GET 的结果；连接层失败记为 status=-1，让断言明确失败而非抛异常。 */ + private record Probe(int status, String body, String contentType) { + } + + private Probe rawGet(int port, String path, String token) { + try { + HttpRequest.Builder b = HttpRequest.newBuilder() + .uri(URI.create("http://127.0.0.1:" + port + path)) + .timeout(Duration.ofSeconds(10)).GET(); + if (token != null) { + b.header("Authorization", "Bearer " + token); + } + HttpResponse r = client.send(b.build(), HttpResponse.BodyHandlers.ofString()); + return new Probe(r.statusCode(), r.body(), + r.headers().firstValue("Content-Type").orElse("")); + } catch (Exception e) { + return new Probe(-1, "", ""); + } + } + + // ── 业务端口 ─────────────────────────────────────────────── + + @Test + void businessPortDoesNotExposeActuatorEndpoints() { + for (String path : new String[]{"/actuator/metrics", "/actuator/prometheus", + "/actuator/health", "/actuator/info", "/actuator"}) { + assertThat(get(businessPort, path, null)) + .as("业务端口不得提供 " + path).isEqualTo(404); + } + } + + @Test + void businessTokensCannotRevealMetricsOnBusinessPort() { + String[] tokens = { + TestAuthTokens.bearer(studentId, "STUDENT"), + TestAuthTokens.bearer(companyId, "COMPANY"), + TestAuthTokens.bearer(adminId, "ADMIN"), + }; + for (String token : tokens) { + for (String path : new String[]{"/actuator/metrics", "/actuator/prometheus"}) { + assertThat(get(businessPort, path, token)) + .as("业务 JWT 不得让指标出现在业务端口：" + path).isEqualTo(404); + } + } + } + + @Test + void businessHealthProbeStaysMinimal() throws Exception { + // 业务健康检查走自定义 /health 控制器，只含最小状态。 + // 按**字段名**断言，而不是对原始 JSON 做子串匹配 —— 随机 requestId 可能恰好包含 + // "db" 之类的子串，会造成假失败。 + String body = body(businessPort, "/api/v1/health"); + var data = new com.fasterxml.jackson.databind.ObjectMapper().readTree(body).path("data"); + + assertThat(data.path("status").asText()).isNotBlank(); + var fields = new java.util.ArrayList(); + data.fieldNames().forEachRemaining(fields::add); + for (String forbidden : new String[]{"db", "redis", "rabbit", "rabbitmq", "diskSpace", + "hikari", "connectionPool", "components", "details"}) { + assertThat(fields).as("业务健康响应不得含字段 " + forbidden).doesNotContain(forbidden); + } + } + + // ── 管理端口 ─────────────────────────────────────────────── + + @Test + void managementPortServesHealthAndMetrics() throws Exception { + String token = TestAuthTokens.bearer(adminId, "ADMIN"); + + // health：允许 200，或因外围依赖不可用而 503；但必须是合法 JSON 且含 status。 + Probe health = rawGet(managementPort, "/actuator/health", null); + assertThat(health.status()).as("health 必须是 200 或 503（实测 " + health.status() + "）") + .isIn(200, 503); + var healthJson = new com.fasterxml.jackson.databind.ObjectMapper().readTree(health.body()); + assertThat(healthJson.has("status")).as("health 响应必须含 status 字段").isTrue(); + + // metrics：必须 200 且返回 names 列表；-1/401/403/404/500 均不算成功。 + Probe metrics = rawGet(managementPort, "/actuator/metrics", token); + assertThat(metrics.status()).as("metrics 必须 HTTP 200（实测 " + metrics.status() + "）") + .isEqualTo(200); + var metricsJson = new com.fasterxml.jackson.databind.ObjectMapper().readTree(metrics.body()); + assertThat(metricsJson.has("names")).as("metrics 响应必须包含 names").isTrue(); + assertThat(metricsJson.get("names").isArray()).as("names 必须是数组").isTrue(); + + // prometheus：必须 200，Content-Type 为 Prometheus 文本格式，正文含稳定指标名。 + Probe prom = rawGet(managementPort, "/actuator/prometheus", token); + assertThat(prom.status()).as("prometheus 必须 HTTP 200（实测 " + prom.status() + "）") + .isEqualTo(200); + assertThat(prom.contentType()).as("prometheus Content-Type 必须为文本格式（实测 " + prom.contentType() + "）") + .containsIgnoringCase("text/plain"); + assertThat(prom.body()).as("prometheus 正文必须含稳定指标名") + .contains("jvm_memory_used_bytes"); + } + + @Test + void managementPortIsIsolatedByNetworkNotByBusinessCredentials() { + // 设计决策：管理端口的运维边界是**网络隔离**（默认只绑定 127.0.0.1）， + // 而不是业务 JWT 角色。因此指标在管理端口无需凭据即可读取， + // 而在业务端口上同一路径根本不存在。 + assertThat(rawGet(managementPort, "/actuator/metrics", null).status()) + .as("管理端口上 metrics 由网络隔离保护，无需业务凭据").isEqualTo(200); + assertThat(get(businessPort, "/actuator/metrics", null)) + .as("业务端口不得提供同一端点").isEqualTo(404); + } + + @Test + void managementHealthReturnsMinimalStatusOnly() { + String body = body(managementPort, "/actuator/health"); + + assertThat(body).as("健康响应必须含 status 字段").contains("status"); + // 组件与细节一律不暴露：show-details=never / show-components=never 的实际效果 + assertThat(body).as("不得返回组件明细") + .doesNotContain("components") + .doesNotContain("diskSpace") + .doesNotContain("hikari") + .doesNotContain("connectionPool") + .doesNotContain("mydreamjob-mysql"); + } + + @Test + void onlyWhitelistedEndpointsAreExposed() { + // 非白名单端点不得可用：既可能因未暴露而 404，也可能被安全层先行拦为 401， + // 两者都证明「不可读」。 + for (String path : new String[]{"/actuator/env", "/actuator/beans", + "/actuator/configprops", "/actuator/heapdump", "/actuator/threaddump"}) { + int code = get(managementPort, path, null); + assertThat(code).as(path + " 不得可读（实测 " + code + "）").isIn(401, 404); + } + } + + // ── 配置断言 ─────────────────────────────────────────────── + + @Test + void managementBindsLoopbackAndHealthDetailsAreNever() { + assertThat(managementAddress).as("管理端口默认只绑定回环地址").isEqualTo("127.0.0.1"); + assertThat(showDetails).isEqualTo("never"); + assertThat(showComponents).isEqualTo("never"); + } + + @Test + void managementPortDiffersFromBusinessPort() { + assertThat(managementPort).as("管理端口必须与业务端口分离").isNotEqualTo(businessPort); + } + + // ── S03 整改复验：业务端口 /actuator/** 任何身份一律 404 ────────── + + @Test + void businessActuatorPathsReturn404ForEveryIdentity() { + String[] paths = { + "/actuator", "/actuator/", "/actuator/health", "/actuator/health/liveness", + "/actuator/info", "/actuator/metrics", "/actuator/metrics/jvm.memory.used", + "/actuator/prometheus", "/actuator/env", "/actuator/beans", + "/actuator/configprops", "/actuator/heapdump", "/actuator/threaddump", + "/actuator/unknown" + }; + String[] identities = { + null, + TestAuthTokens.bearer(studentId, "STUDENT"), + TestAuthTokens.bearer(companyId, "COMPANY"), + TestAuthTokens.bearer(adminId, "ADMIN"), + "Bearer invalid.garbage.token.value", + "Bearer " + TestAuthTokens.refreshToken(studentId, "STUDENT"), + }; + for (String path : paths) { + for (String auth : identities) { + Probe p = rawGet(businessPort, path, auth); + assertThat(p.status()) + .as("8080 %s（身份=%s）必须 404，不得出现 401/403/500", + path, auth == null ? "anonymous" : auth.substring(0, Math.min(11, auth.length())) + "...") + .isEqualTo(404); + assertNoLeak(p.body()); + } + } + } + + /** 递归扫描响应：任何异常/实现细节/路径/敏感信息都不得出现。 */ + private static void assertNoLeak(String body) { + String normalized = body == null ? "" : body; + assertThat(normalized).as("不得包含异常类名/静态资源提示/框架包名") + .doesNotContain("NoResourceFoundException", "No static resource", "org.springframework", + "classpath", "stackTrace", "exception", "handler"); + assertThat(normalized).as("不得包含本地路径").doesNotContain("C:", "\\Users", "\\Desktop"); + assertThat(normalized.toLowerCase()).as("不得包含 Token/凭据/数据库信息") + .doesNotContain("token", "password", "jdbc"); + assertThat(normalized).as("不得包含 11 位连续数字（手机号）").doesNotMatch("\\d{11}"); + } + + @Test + void managementUnexposedEndpointsReturn404() { + for (String path : new String[]{"/actuator/env", "/actuator/beans", "/actuator/configprops", + "/actuator/heapdump", "/actuator/threaddump", "/actuator/unknown"}) { + int code = get(managementPort, path, null); + assertThat(code).as("8081 %s 必须 404（未暴露端点，不得 401/200/403/500）", path).isEqualTo(404); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataCollectorQueryBudgetTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataCollectorQueryBudgetTest.java new file mode 100644 index 0000000..4369cc4 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataCollectorQueryBudgetTest.java @@ -0,0 +1,186 @@ +package com.mydreamjob.dataexport; + +import com.mydreamjob.application.*; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.candidatescore.governance.*; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.feedback.*; +import com.mydreamjob.interview.*; +import com.mydreamjob.job.JobFavoriteRepository; +import com.mydreamjob.messaging.*; +import com.mydreamjob.notification.NotificationRepository; +import com.mydreamjob.offer.*; +import com.mydreamjob.preference.StudentPreferenceRepository; +import com.mydreamjob.profile.StudentProfileRepository; +import com.mydreamjob.profile.storage.ResumeStorageService; +import com.mydreamjob.resume.ResumeVersionRepository; +import org.junit.jupiter.api.BeforeEach; +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 org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.Pageable; + +import java.util.List; +import java.util.Optional; +import java.util.stream.LongStream; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class PersonalDataCollectorQueryBudgetTest { + + @Mock UserRepository userRepository; + @Mock StudentProfileRepository studentProfileRepository; + @Mock StudentPreferenceRepository studentPreferenceRepository; + @Mock ResumeVersionRepository resumeVersionRepository; + @Mock ApplicationRepository applicationRepository; + @Mock ApplicationStatusHistoryRepository applicationStatusHistoryRepository; + @Mock InterviewRepository interviewRepository; + @Mock InterviewStatusHistoryRepository interviewStatusHistoryRepository; + @Mock OfferRepository offerRepository; + @Mock OfferStatusHistoryRepository offerStatusHistoryRepository; + @Mock CandidateFeedbackRepository candidateFeedbackRepository; + @Mock JobFavoriteRepository jobFavoriteRepository; + @Mock NotificationRepository notificationRepository; + @Mock ConversationMemberRepository conversationMemberRepository; + @Mock ConversationRepository conversationRepository; + @Mock MessageRepository messageRepository; + @Mock CandidateDimensionScoreRepository candidateDimensionScoreRepository; + @Mock CandidateScoringAppealRepository candidateScoringAppealRepository; + @Mock CandidateScoringAppealHistoryRepository candidateScoringAppealHistoryRepository; + @Mock CompanyRepository companyRepository; + @Mock ResumeStorageService resumeStorageService; + + @InjectMocks PersonalDataCollector collector; + + @BeforeEach + void stubUnrelatedSections() { + when(userRepository.findById(anyLong())).thenReturn(Optional.empty()); + when(studentProfileRepository.findByUserId(anyLong())).thenReturn(Optional.empty()); + when(studentPreferenceRepository.findByStudentUserId(anyLong())).thenReturn(Optional.empty()); + when(resumeVersionRepository.findByUserIdAndStatusOrderByVersionNoDesc(anyLong(), anyString())) + .thenReturn(List.of()); + lenient().when(interviewRepository.findByStudentUserIdOrderByStartAtDesc(anyLong(), any(Pageable.class))) + .thenReturn(Page.empty()); + when(interviewRepository.findByCompanyUserIdOrderByStartAtDesc(anyLong(), any(Pageable.class))) + .thenReturn(Page.empty()); + when(interviewStatusHistoryRepository.findByInterviewIdInOrderByInterviewIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of()); + lenient().when(offerRepository.findByCandidateIdOrderByCreatedAtDesc(anyLong(), any(Pageable.class))) + .thenReturn(Page.empty()); + when(companyRepository.findByOwnerUserId(anyLong())).thenReturn(Optional.empty()); + when(offerStatusHistoryRepository.findByOfferIdInOrderByOfferIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of()); + when(jobFavoriteRepository.findByStudentUserIdOrderByCreatedAtDesc(anyLong(), any(Pageable.class))) + .thenReturn(Page.empty()); + when(notificationRepository.findByUserIdOrderByCreatedAtDesc(anyLong(), any(Pageable.class))) + .thenReturn(Page.empty()); + when(conversationMemberRepository.findByUserId(anyLong())).thenReturn(List.of()); + when(conversationRepository.findAllById(anyList())).thenReturn(List.of()); + when(messageRepository.findByConversationIdInOrderByConversationIdAscCreatedAtDesc(anyList())) + .thenReturn(List.of()); + when(candidateDimensionScoreRepository.findByStudentUserId(anyLong())).thenReturn(List.of()); + lenient().when(candidateScoringAppealRepository.findByCandidateUserIdOrderByCreatedAtDesc( + anyLong(), any(Pageable.class))).thenReturn(Page.empty()); + when(candidateScoringAppealHistoryRepository.findByAppealIdInOrderByAppealIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of()); + } + + @Test + void applicationQueriesStayFixedFromOneToFiftyRows() { + assertFixedApplicationQueries(1); + clearInvocations(applicationRepository, applicationStatusHistoryRepository, candidateFeedbackRepository); + assertFixedApplicationQueries(50); + } + + @Test + void batchResultsPreserveParentOrderAndTimelineOrder() { + Application newer = application(20L); + Application older = application(10L); + when(applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(7L)) + .thenReturn(List.of(newer, older)); + when(applicationStatusHistoryRepository.findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of(history(10L, "A"), history(10L, "B"), history(20L, "C"))); + when(candidateFeedbackRepository.findByApplicationIdIn(anyList())).thenReturn(List.of()); + + PersonalDataCollector.CollectResult result = collector.collect(7L); + + List applications = (List) result.getSections().get("applications"); + List timelines = (List) result.getSections().get("application-timelines"); + assertEquals(20L, ((java.util.Map) applications.get(0)).get("applicationId")); + assertEquals(10L, ((java.util.Map) applications.get(1)).get("applicationId")); + assertEquals("C", ((java.util.Map) timelines.get(0)).get("toStatus")); + assertEquals("A", ((java.util.Map) timelines.get(1)).get("toStatus")); + assertEquals("B", ((java.util.Map) timelines.get(2)).get("toStatus")); + } + + @Test + void everyChildCollectionUsesOneBatchQueryInsteadOfPerParentQueries() { + when(applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(7L)).thenReturn(List.of()); + when(applicationStatusHistoryRepository.findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of()); + when(candidateFeedbackRepository.findByApplicationIdIn(anyList())).thenReturn(List.of()); + when(interviewRepository.findByStudentUserIdOrderByStartAtDesc(eq(7L), any(Pageable.class))) + .thenReturn(new PageImpl<>(List.of( + Interview.builder().id(1L).build(), Interview.builder().id(2L).build()))); + when(offerRepository.findByCandidateIdOrderByCreatedAtDesc(eq(7L), any(Pageable.class))) + .thenReturn(new PageImpl<>(List.of( + Offer.builder().id(3L).build(), Offer.builder().id(4L).build()))); + when(conversationMemberRepository.findByUserId(7L)).thenReturn(List.of( + ConversationMember.builder().conversationId(5L).userId(7L).build(), + ConversationMember.builder().conversationId(6L).userId(7L).build())); + when(candidateScoringAppealRepository.findByCandidateUserIdOrderByCreatedAtDesc( + eq(7L), any(Pageable.class))).thenReturn(new PageImpl<>(List.of( + CandidateScoringAppeal.builder().id(7L).build(), + CandidateScoringAppeal.builder().id(8L).build()))); + + collector.collect(7L); + + verify(interviewStatusHistoryRepository, times(1)) + .findByInterviewIdInOrderByInterviewIdAscCreatedAtAsc(anyList()); + verify(offerStatusHistoryRepository, times(1)) + .findByOfferIdInOrderByOfferIdAscCreatedAtAsc(anyList()); + verify(conversationRepository, times(1)).findAllById(anyList()); + verify(messageRepository, times(1)) + .findByConversationIdInOrderByConversationIdAscCreatedAtDesc(anyList()); + verify(candidateScoringAppealHistoryRepository, times(1)) + .findByAppealIdInOrderByAppealIdAscCreatedAtAsc(anyList()); + verify(interviewStatusHistoryRepository, never()).findByInterviewIdOrderByCreatedAtAsc(anyLong()); + verify(offerStatusHistoryRepository, never()).findByOfferIdOrderByCreatedAtAsc(anyLong()); + verify(conversationRepository, never()).findById(anyLong()); + verify(messageRepository, never()).findByConversationIdOrderByCreatedAtDesc(anyLong(), any()); + verify(candidateScoringAppealHistoryRepository, never()).findByAppealIdOrderByCreatedAtAsc(anyLong()); + } + + private void assertFixedApplicationQueries(int count) { + List applications = LongStream.rangeClosed(1, count).mapToObj(this::application).toList(); + when(applicationRepository.findByStudentUserIdOrderByCreatedAtDesc(7L)).thenReturn(applications); + when(applicationStatusHistoryRepository.findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc(anyList())) + .thenReturn(List.of()); + when(candidateFeedbackRepository.findByApplicationIdIn(anyList())).thenReturn(List.of()); + + collector.collect(7L); + + verify(applicationRepository, times(1)).findByStudentUserIdOrderByCreatedAtDesc(7L); + verify(applicationStatusHistoryRepository, times(1)) + .findByApplicationIdInOrderByApplicationIdAscCreatedAtAsc(anyList()); + verify(candidateFeedbackRepository, times(1)).findByApplicationIdIn(anyList()); + verify(applicationStatusHistoryRepository, never()).findByApplicationIdOrderByCreatedAtAsc(anyLong()); + verify(candidateFeedbackRepository, never()).findByApplicationId(anyLong()); + } + + private Application application(long id) { + return Application.builder().id(id).studentUserId(7L).jobId(100L + id).status("SUBMITTED").build(); + } + + private ApplicationStatusHistory history(long applicationId, String toStatus) { + return ApplicationStatusHistory.builder().applicationId(applicationId).toStatus(toStatus).build(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataExportControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataExportControllerTest.java index 89f628d..9c35b59 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataExportControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/dataexport/PersonalDataExportControllerTest.java @@ -94,8 +94,7 @@ class PersonalDataExportControllerTest { } private String token(long userId, User.Role role) { - return "Bearer " + jwtTokenProvider.generateAccessToken( - userId, String.valueOf(PHONE.getAndIncrement()), Map.of("roles", role.name())); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); } private PersonalDataExportTask pendingTask(Long userId) { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionControllerTest.java index 842fbaa..8d0996e 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionControllerTest.java @@ -52,7 +52,18 @@ class AccountDeletionControllerTest { @MockBean private org.springframework.data.redis.core.RedisTemplate redisTemplate; private final ObjectMapper mapper = new ObjectMapper(); - private static final AtomicLong PHONE = new AtomicLong(930_000_000L); + + /** + * 测试专属手机号段（987_000_000 起）。 + * + *

    隔离修复：此前使用 930_000_000，与 {@code common.logging.RequestContextMigrationIntegrationTest} + * 撞段；后者在共享 H2 库（integrationdb）中残留该号码，使本类首次 {@code createUser()} + * 触发 {@code USERS(PHONE)} 唯一键冲突。改用独占号段后，本类不再依赖他类的清理行为。

    + */ + private static final AtomicLong PHONE = new AtomicLong(987_000_000L); + + /** 本测试创建的 userId，仅用于按外键顺序精确清理，不触碰其他测试的数据。 */ + private final java.util.List createdUserIds = new java.util.ArrayList<>(); @BeforeEach @SuppressWarnings("unchecked") @@ -61,29 +72,39 @@ class AccountDeletionControllerTest { mock(org.springframework.data.redis.core.ValueOperations.class); when(redisTemplate.opsForValue()).thenReturn(ops); when(redisTemplate.hasKey(anyString())).thenReturn(false); + createdUserIds.clear(); } @AfterEach void tearDown() { - // 清理共享 H2 库（integrationdb）中的注销记录与测试用户，避免残留 PENDING/COMPLETED - // 污染后续其他集成测试类（其使用固定 userId 触发注销守卫）。 - deletionRepository.deleteAll(); - userRepository.deleteAll(); + // 精确清理本测试创建的数据（仅本测试记录，不整表删除）： + // account_deletions → user_roles → users，遵循外键依赖顺序。 + for (Long uid : createdUserIds) { + deletionRepository.findByUserId(uid).ifPresent(deletionRepository::delete); + deletionRepository.flush(); + userRepository.findById(uid).ifPresent(userRepository::delete); + userRepository.flush(); + } + createdUserIds.clear(); } private long createUser(User.Role role) { + String phone = String.valueOf(PHONE.getAndIncrement()); + // 防掩盖：本测试号段内不得已存在同号记录（若存在说明清理失效，应立即暴露而非被唯一键吞掉）。 + assertFalse(userRepository.findByPhone(phone).isPresent(), + "测试夹具手机号 " + phone + " 已存在于共享库，说明上轮清理失效"); User u = userRepository.save(User.builder() - .phone(String.valueOf(PHONE.getAndIncrement())) + .phone(phone) .roles(Set.of(role)) .role(role) .active(true) .build()); + createdUserIds.add(u.getId()); return u.getId(); } private String token(long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken( - userId, String.valueOf(PHONE.getAndIncrement()), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } @Test @@ -243,10 +264,11 @@ class AccountDeletionControllerTest { assertEquals(DeletionStatus.COMPLETED, deletionRepository.findByUserId(uid).orElseThrow().getStatus()); - // 第二次 GET 仍应为 COMPLETED，不能出现"第一次 PENDING、第二次 COMPLETED"的不一致 + // S02 起：注销完成会脱敏（active=false）并撤销该用户全部会话， + // 因此用同一账号再次请求必须被拒绝为 401，而不再是 COMPLETED 的 200。 + // 这不影响本用例的一致性目标 —— 状态一致仍由上方的数据库断言保证。 mockMvc.perform(get("/profile/me/deletion").header("Authorization", token(uid))) - .andExpect(status().isOk()) - .andExpect(jsonPath("$.data.status").value("COMPLETED")); + .andExpect(status().isUnauthorized()); } @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionFixtureIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionFixtureIsolationTest.java new file mode 100644 index 0000000..2f14717 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/AccountDeletionFixtureIsolationTest.java @@ -0,0 +1,176 @@ +package com.mydreamjob.deletion; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * 账号注销测试夹具隔离的**反证测试**。 + * + *

    证明隔离修复确实有效，且"残留检测"不是空转：

    + *
      + *
    1. 同一 Spring 上下文内连续创建多个夹具用户不冲突；
      2. + *
    2. 测试结束后本测试创建的 users / user_roles / account_deletions 残留为 0；
      3. + *
    3. **变异探测**：若库中预先存在同号记录（等价于"上一轮未清理"）， + * 夹具的防掩盖断言必须失败 —— 即残留**不会**被静默吞掉。
      4. + *
    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class AccountDeletionFixtureIsolationTest { + + @Autowired private UserRepository userRepository; + @Autowired private AccountDeletionRepository deletionRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + @MockBean private RedisTemplate redisTemplate; + + /** 与 AccountDeletionControllerTest 相同的独占号段，用于验证该号段本身不与他类冲突。 */ + private static final AtomicLong PHONE = new AtomicLong(987_000_000L); + private static final AtomicLong PROBE_PHONE = new AtomicLong(989_000_000L); + + private final List createdUserIds = new ArrayList<>(); + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(anyString())).thenReturn(false); + createdUserIds.clear(); + } + + @AfterEach + void tearDown() { + for (Long uid : createdUserIds) { + deletionRepository.findByUserId(uid).ifPresent(deletionRepository::delete); + deletionRepository.flush(); + userRepository.findById(uid).ifPresent(userRepository::delete); + userRepository.flush(); + } + createdUserIds.clear(); + } + + private long createFixture() { + String phone = String.valueOf(PHONE.getAndIncrement()); + // 与生产夹具同样的防掩盖断言：号段内不得已存在同号记录 + assertThat(userRepository.findByPhone(phone)).as("夹具号 " + phone + " 不应预先存在").isEmpty(); + User u = userRepository.save(User.builder() + .phone(phone).roles(Set.of(User.Role.STUDENT)).role(User.Role.STUDENT) + .active(true).build()); + createdUserIds.add(u.getId()); + return u.getId(); + } + + @Test + @DisplayName("反证 1：同一上下文内连续创建 5 个夹具不冲突") + void repeatedFixtureCreation_doesNotConflict() { + List ids = new ArrayList<>(); + for (int i = 0; i < 5; i++) { + ids.add(createFixture()); + } + assertThat(ids).doesNotHaveDuplicates().hasSize(5); + } + + @Test + @DisplayName("反证 2：注销记录写入后，本测试清理使三类记录残留为 0") + void afterCleanup_noResidueForOwnFixtures() { + long uid = createFixture(); + deletionRepository.save(AccountDeletion.builder() + .userId(uid).status(DeletionStatus.PENDING).version(0L).build()); + + assertThat(deletionRepository.findByUserId(uid)).isPresent(); + + // 手动执行与 @AfterEach 相同的清理路径 + deletionRepository.findByUserId(uid).ifPresent(deletionRepository::delete); + deletionRepository.flush(); + userRepository.findById(uid).ifPresent(userRepository::delete); + userRepository.flush(); + createdUserIds.remove(uid); + + assertThat(deletionRepository.findByUserId(uid)).as("account_deletions 残留").isEmpty(); + assertThat(userRepository.findById(uid)).as("users 残留").isEmpty(); + Integer roles = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM user_roles WHERE user_id=?", Integer.class, uid); + assertThat(roles).as("user_roles 残留（应随 users 级联删除）").isZero(); + } + + @Test + @DisplayName("反证 3：变异探测 —— 预置同号记录时防掩盖断言必须失败") + void whenResidueExists_detectorFails() { + // 模拟"上一轮未清理"：直接插入一条占用号段首号的记录 + long residueId = userRepository.save(User.builder() + .phone("987000000").roles(Set.of(User.Role.STUDENT)).role(User.Role.STUDENT) + .active(true).build()).getId(); + try { + AtomicLong probe = new AtomicLong(987_000_000L); + assertThatThrownBy(() -> { + String phone = String.valueOf(probe.getAndIncrement()); + if (userRepository.findByPhone(phone).isPresent()) { + throw new AssertionError("夹具号 " + phone + " 已存在，说明上轮清理失效"); + } + }).as("残留必须被检测到，而不是被唯一键静默吞掉") + .isInstanceOf(AssertionError.class) + .hasMessageContaining("987000000"); + } finally { + userRepository.findById(residueId).ifPresent(userRepository::delete); + userRepository.flush(); + } + } + + @Test + @DisplayName("反证 4：本测试独占号段与 AccountDeletionControllerTest 号段一致且不与他类重叠") + void fixtureSegmentIsExclusive() { + // 987_000_000 段应只被 deletion 包下的测试使用 + Integer others = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone >= '987000000' AND phone < '988000000'", + Integer.class); + assertThat(others).as("测试开始前 987 段应为空").isZero(); + } + + @Test + @DisplayName("反证 5：夹具用户被其他表引用时仍能按其自身记录精确清理（不整表删除）") + void cleanupIsScopedToOwnFixtures() { + long mine = createFixture(); + // 预置一条"他类"记录（不同号段），清理本测试不得触碰它 + long foreignId = userRepository.save(User.builder() + .phone(String.valueOf(PROBE_PHONE.getAndIncrement())) + .roles(Set.of(User.Role.STUDENT)).role(User.Role.STUDENT).active(true).build()).getId(); + try { + deletionRepository.findByUserId(mine).ifPresent(deletionRepository::delete); + userRepository.findById(mine).ifPresent(userRepository::delete); + userRepository.flush(); + createdUserIds.remove(mine); + + assertThat(userRepository.findById(mine)).as("本测试记录应被清理").isEmpty(); + assertThat(userRepository.findById(foreignId)) + .as("非本测试记录必须保留（证明清理是精确的，不是整表删除）").isPresent(); + } finally { + userRepository.findById(foreignId).ifPresent(userRepository::delete); + userRepository.flush(); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/deletion/DeletionGuardInterceptorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/DeletionGuardInterceptorTest.java index 6218e09..bb796bd 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/deletion/DeletionGuardInterceptorTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/deletion/DeletionGuardInterceptorTest.java @@ -11,6 +11,7 @@ import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMock import org.springframework.boot.test.context.SpringBootTest; import org.springframework.boot.test.mock.mockito.MockBean; import org.springframework.http.MediaType; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; import org.springframework.test.context.ActiveProfiles; import org.springframework.test.web.servlet.MockMvc; @@ -22,6 +23,7 @@ import java.util.concurrent.atomic.AtomicLong; import static org.mockito.ArgumentMatchers.anyString; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.authentication; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put; @@ -76,8 +78,7 @@ class DeletionGuardInterceptorTest { } private String token(long uid) { - return "Bearer " + jwtTokenProvider.generateAccessToken( - uid, String.valueOf(PHONE.getAndIncrement()), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(uid, "STUDENT"); } private void setStatus(long uid, DeletionStatus status, LocalDateTime effectiveAt) { @@ -163,6 +164,25 @@ class DeletionGuardInterceptorTest { .andExpect(status().isUnauthorized()); } + /** + * R01-A 回归：本拦截器注册在 {@code /**} 上，先于所有 Controller 执行， + * 因此非法主体绝不能在拦截器层逃逸为 500。 + * + *

    修复前 {@code Long.valueOf(auth.getName())} 对 Long 溢出主体（ + * {@code "99999999999999999999"}）抛出 {@code NumberFormatException}， + * 在到达任何 Controller 之前就返回全站 HTTP 500。

    + */ + @Test + void illegalOrOverflowingPrincipal_returns401InsteadOf500() throws Exception { + for (String principal : new String[]{ + "99999999999999999999", "٤٢", "+42", "-1", "0", " ", "not-a-number"}) { + mockMvc.perform(get("/profile/me/privacy") + .with(authentication(UsernamePasswordAuthenticationToken.authenticated( + principal, null, java.util.List.of())))) + .andExpect(status().isUnauthorized()); + } + } + @Test void options_isAllowed() throws Exception { long uid = createStudent(); diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackControllerTest.java index 29cd558..5c33203 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackControllerTest.java @@ -43,7 +43,7 @@ class CandidateFeedbackControllerTest { } private String token() { - return "Bearer " + jwtTokenProvider.generateAccessToken(10L, "1", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(10L, "COMPANY"); } @Test void createFeedback_shouldReturn200() throws Exception { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackRefreshRegistrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackRefreshRegistrationTest.java new file mode 100644 index 0000000..d705f87 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackRefreshRegistrationTest.java @@ -0,0 +1,200 @@ +package com.mydreamjob.feedback; + +import com.mydreamjob.application.Application; +import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.feedback.dto.CandidateFeedbackRequest; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 阻断缺陷 F2：候选人反馈的创建/修改/删除都必须登记评分刷新任务。 + * + *

    缺陷背景：{@code CandidateScoringCalculator#queryFeedback} 以 + * {@code COUNT(*) / AVG(rating)} 参与 INTEGRITY 维度，但只有 createFeedback 登记了刷新， + * updateFeedback（改 rating 会改变 AVG）与 deleteFeedback（改变 COUNT 与 AVG）此前不登记。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CandidateFeedbackRefreshRegistrationTest { + + @Autowired private CandidateFeedbackService service; + @Autowired private CandidateFeedbackRepository feedbackRepository; + @Autowired private ApplicationRepository applicationRepository; + @Autowired private JobRepository jobRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + private static final AtomicLong SEQ = new AtomicLong(5000); + + private Long companyUserId; + private Long studentId; + private Long applicationId; + + private long taskCount(Long studentUserId) { + Long c = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, studentUserId); + return c == null ? -1 : c; + } + + private CandidateFeedbackRequest req(int rating, String content) { + CandidateFeedbackRequest r = new CandidateFeedbackRequest(); + r.setRating(rating); + r.setContent(content); + r.setTags(List.of("t")); + return r; + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + feedbackRepository.deleteAll(); + applicationRepository.deleteAll(); + jobRepository.deleteAll(); + companyRepository.deleteAll(); + + User student = userRepository.save(User.builder() + .phone("196" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("F2学生").role(User.Role.STUDENT).active(true).verified(true).build()); + student.setRoles(java.util.Set.of(User.Role.STUDENT)); + studentId = student.getId(); + + User companyUser = userRepository.save(User.builder() + .phone("195" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("F2企业").role(User.Role.COMPANY).active(true).verified(true).build()); + companyUser.setRoles(java.util.Set.of(User.Role.COMPANY)); + companyUserId = companyUser.getId(); + + Company company = companyRepository.save(Company.builder() + .ownerUserId(companyUserId).name("F2公司").build()); + Job job = jobRepository.save(Job.builder() + .companyId(company.getId()).title("F2岗位").description("d").city("上海") + .employmentType("FULL_TIME").status("PUBLISHED").build()); + Application app = applicationRepository.save(Application.builder() + .jobId(job.getId()).studentUserId(studentId).status("SUBMITTED").build()); + applicationId = app.getId(); + } + + private void clearTasks() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + } + + /** 清理本类产生的全部行，避免污染同一 JVM 内共享的 H2 内存库。 */ + @org.junit.jupiter.api.AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_feedback"); + jdbcTemplate.update("DELETE FROM offers"); + jdbcTemplate.update("DELETE FROM application_status_history"); + jdbcTemplate.update("DELETE FROM applications"); + jdbcTemplate.update("DELETE FROM jobs"); + jdbcTemplate.update("DELETE FROM companies"); + } + + @Test + void createFeedback_registersRefreshTask() { + clearTasks(); + service.createFeedback(companyUserId, applicationId, req(5, "优秀")); + assertEquals(1L, taskCount(studentId), "createFeedback 必须登记刷新任务"); + } + + @Test + void updateFeedback_registersRefreshTask() { + service.createFeedback(companyUserId, applicationId, req(5, "优秀")); + clearTasks(); // 只观察 update 自身是否登记 + + service.updateFeedback(companyUserId, applicationId, req(2, "较差")); + + assertEquals(1L, taskCount(studentId), + "updateFeedback 改变 rating 会影响 AVG(rating)，必须登记刷新任务"); + } + + @Test + void deleteFeedback_registersRefreshTask_afterRowRemoved() { + service.createFeedback(companyUserId, applicationId, req(5, "优秀")); + clearTasks(); + + service.deleteFeedback(companyUserId, applicationId); + + assertEquals(0L, feedbackRepository.count(), "反馈行应已删除"); + assertEquals(1L, taskCount(studentId), + "deleteFeedback 改变 COUNT(*) 与 AVG(rating)，必须登记刷新任务"); + } + + @Test + void updateFeedback_ratingUnchanged_stillRegistersButConvergesToOneTask() { + service.createFeedback(companyUserId, applicationId, req(4, "一般")); + clearTasks(); + + service.updateFeedback(companyUserId, applicationId, req(4, "一般-改文案")); + service.updateFeedback(companyUserId, applicationId, req(4, "一般-再改")); + + assertEquals(1L, taskCount(studentId), + "重复登记必须收敛为同一学生同一周期的一条任务"); + } + + @Test + void updateFeedback_forbiddenCaller_leavesNoOrphanTask() { + service.createFeedback(companyUserId, applicationId, req(5, "优秀")); + clearTasks(); + + assertThrows(BusinessException.class, + () -> service.updateFeedback(999999L, applicationId, req(1, "越权"))); + + assertEquals(0L, taskCount(studentId), "失败路径不得留下孤立刷新任务"); + } + + @Test + void deleteFeedback_missingFeedback_leavesNoOrphanTask() { + clearTasks(); + + assertThrows(BusinessException.class, + () -> service.deleteFeedback(companyUserId, applicationId)); + + assertEquals(0L, taskCount(studentId), "失败路径不得留下孤立刷新任务"); + } + + @Test + void feedbackLifecycle_createUpdateDelete_allRegisteredAndSnapshotRefreshable() { + clearTasks(); + service.createFeedback(companyUserId, applicationId, req(5, "优秀")); + assertEquals(1L, taskCount(studentId), "create 登记"); + + clearTasks(); + service.updateFeedback(companyUserId, applicationId, req(1, "很差")); + assertEquals(1L, taskCount(studentId), "update 登记"); + + clearTasks(); + service.deleteFeedback(companyUserId, applicationId); + assertEquals(1L, taskCount(studentId), "delete 登记"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackServiceTest.java index bca9a07..2ea3ee1 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/feedback/CandidateFeedbackServiceTest.java @@ -29,6 +29,7 @@ class CandidateFeedbackServiceTest { @Mock private ApplicationRepository applicationRepository; @Mock private JobService jobService; @Mock private CompanyRepository companyRepository; + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; @InjectMocks private CandidateFeedbackService feedbackService; private static final Long COMPANY_USER_ID = 10L; // 企业账号 userId diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/GlobalExceptionHandlerInterviewScoreTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/GlobalExceptionHandlerInterviewScoreTest.java index 73f373e..9fd5bd5 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/GlobalExceptionHandlerInterviewScoreTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/GlobalExceptionHandlerInterviewScoreTest.java @@ -51,7 +51,7 @@ class GlobalExceptionHandlerInterviewScoreTest { ValueOperations ops = mock(ValueOperations.class); when(redisTemplate.opsForValue()).thenReturn(ops); when(redisTemplate.hasKey(any())).thenReturn(false); - token = "Bearer " + jwtTokenProvider.generateAccessToken(10L, "1", Map.of("roles", "COMPANY")); + token = com.mydreamjob.auth.support.TestAuthTokens.bearer(10L, "COMPANY"); } private String body() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/InterviewScoreControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/InterviewScoreControllerTest.java index 32732ce..b3391f7 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/InterviewScoreControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/interviewscore/InterviewScoreControllerTest.java @@ -125,8 +125,7 @@ class InterviewScoreControllerTest { } private String token(Long userId, User.Role role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", role.name())); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); } private String bodyJson(Integer t, Integer c, Integer ps, Integer rf, Integer pf) { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/BusinessRowSnapshot.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/BusinessRowSnapshot.java new file mode 100644 index 0000000..8422edb --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/BusinessRowSnapshot.java @@ -0,0 +1,126 @@ +package com.mydreamjob.job; + +import org.springframework.jdbc.core.JdbcTemplate; + +import java.sql.Clob; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Set; + +/** + * Q01 §7 查询副作用证据：业务表的**行级稳定字段快照**。 + * + *

    只比较 COUNT / SUM / CRC32 只能说明“行数没变”，不能说明“没有某一行被改写”。 + * 因此这里对每张受检表按主键排序逐行取值，查询前后各取一次，逐行逐字段比较。

    + * + *

    只选取显式列出的稳定业务字段，不使用 {@code SELECT *}，也不包含任何凭据列 + * （例如 {@code users.password_hash}），因此失败信息中不会出现密码摘要。

    + */ +final class BusinessRowSnapshot { + + /** 受检表 → 稳定业务字段（顺序即 SELECT 列顺序，也是比较顺序）。 */ + private static final Map> TABLES = new LinkedHashMap<>(); + + static { + TABLES.put("users", List.of( + "id", "phone", "nickname", "role", "is_active", "is_verified", + "created_at", "updated_at")); + TABLES.put("companies", List.of( + "id", "owner_user_id", "name", "logo_url", "description", "industry", + "website", "address", "verified", "created_at", "updated_at")); + TABLES.put("jobs", List.of( + "id", "company_id", "title", "description", "requirements", "city", + "employment_type", "salary_min", "salary_max", "status", "published_at", + "created_at", "updated_at")); + TABLES.put("applications", List.of( + "id", "job_id", "student_user_id", "cover_letter", "status", + "created_at", "updated_at")); + TABLES.put("candidate_dimension_scores", List.of( + "id", "student_user_id", "dimension", "period", "score", "status", + "sub_scores_json", "weight", "rules_version", "calculated_at", "version", + "created_at", "updated_at")); + TABLES.put("notifications", List.of( + "id", "user_id", "type", "title", "content", "is_read", "read_at", + "created_at")); + TABLES.put("conversations", List.of( + "id", "title", "type", "created_by", "created_at", "updated_at")); + TABLES.put("messages", List.of( + "id", "conversation_id", "sender_user_id", "content", "created_at")); + TABLES.put("audit_logs", List.of( + "id", "user_id", "action", "entity_type", "entity_id", "details", + "ip_address", "user_agent", "request_id", "created_at")); + } + + private final JdbcTemplate jdbcTemplate; + + BusinessRowSnapshot(JdbcTemplate jdbcTemplate) { + this.jdbcTemplate = jdbcTemplate; + } + + static Set tables() { + return TABLES.keySet(); + } + + /** 逐表按主键顺序捕获行级快照。 */ + Map>> capture() { + Map>> snapshot = new LinkedHashMap<>(); + TABLES.forEach((table, columns) -> { + String sql = "SELECT " + String.join(", ", columns) + " FROM " + table + " ORDER BY id"; + List> rows = new ArrayList<>(); + for (Map row : jdbcTemplate.queryForList(sql)) { + Map normalized = new LinkedHashMap<>(); + row.forEach((column, value) -> + normalized.put(column.toLowerCase(Locale.ROOT), normalize(value))); + rows.add(normalized); + } + snapshot.put(table, rows); + }); + return snapshot; + } + + /** + * CLOB/文本大对象在不同驱动下返回不同实例，直接按引用比较会产生假差异， + * 因此统一读取为字符串。 + */ + private static Object normalize(Object value) { + if (value instanceof Clob clob) { + try { + return clob.getSubString(1, (int) clob.length()); + } catch (SQLException e) { + throw new IllegalStateException("failed to read text column from snapshot", e); + } + } + return value; + } + + /** 返回人类可读差异；两次快照逐表逐行完全一致时返回空字符串。 */ + static String describeDifference(Map>> before, + Map>> after) { + List differences = new ArrayList<>(); + for (String table : TABLES.keySet()) { + List> beforeRows = before.get(table); + List> afterRows = after.get(table); + if (beforeRows.equals(afterRows)) { + continue; + } + differences.add(table + ": 行数 " + beforeRows.size() + " -> " + afterRows.size() + + firstRowDifference(beforeRows, afterRows)); + } + return String.join("; ", differences); + } + + private static String firstRowDifference(List> before, + List> after) { + int shared = Math.min(before.size(), after.size()); + for (int i = 0; i < shared; i++) { + if (!before.get(i).equals(after.get(i))) { + return "，首个差异行 #" + i + " 前=" + before.get(i) + " 后=" + after.get(i); + } + } + return ""; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobFavoriteServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobFavoriteServiceTest.java index 42d3e49..2c88472 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobFavoriteServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobFavoriteServiceTest.java @@ -2,6 +2,8 @@ package com.mydreamjob.job; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import org.junit.jupiter.api.BeforeEach; @@ -33,6 +35,9 @@ class JobFavoriteServiceTest { @Mock private UserRepository userRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private JobFavoriteService favoriteService; @@ -45,6 +50,9 @@ class JobFavoriteServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + publishedJob = Job.builder().id(JOB_ID).companyId(1L) .title("Java 后端").status("PUBLISHED").build(); draftJob = Job.builder().id(20L).companyId(1L) diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java new file mode 100644 index 0000000..43992a2 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobListKeywordNormalizationIntegrationTest.java @@ -0,0 +1,315 @@ +package com.mydreamjob.job; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; + +/** + * DEF-01 定向整改：GET /jobs 的关键词规范化。 + * + *

    本类刻意走**真实链路**：HTTP → SecurityFilterChain → JobController → JobService → JobRepository + * （真实 Spring 上下文 + 真实数据库），不直接调用 Controller、不 Mock + * JobService/JobRepository、不用 Mockito 校验字符串参数。

    + * + *

    固化的语义契约：`GET /jobs` 的关键词应与 `GET /jobs/search` 一致 —— + * 两端空白被 trim、空串/纯空白等同于「未传关键词」。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class JobListKeywordNormalizationIntegrationTest { + + private static final String TITLE_PREFIX = "DEF01KEYWORD_"; + private static final String TARGET_KEYWORD = "AlphaEngineer"; + private static final String PHONE_FMT = "199001%05d"; + /** 夹具统一基准时间，保证每条岗位的 created_at 互异且可预期。 */ + private static final LocalDateTime BASE_TIME = LocalDateTime.of(2026, 9, 20, 9, 0, 0); + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private ObjectMapper objectMapper; + @MockBean private RedisTemplate redisTemplate; + + /** 显式登记的本轮夹具主键，清理只按这些主键进行。 */ + private final List userIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List jobIds = new ArrayList<>(); + + private Long targetJobId; + + @BeforeEach + void seed() { + cleanup(); + long me = user(String.format(PHONE_FMT, 100 + userIds.size())); + long companyId = company(me, TITLE_PREFIX + "co"); + companyIds.add(companyId); + + // 1 条标题命中关键词的公开岗位 + 2 条其它公开岗位 + targetJobId = job(companyId, TITLE_PREFIX + TARGET_KEYWORD, "PUBLISHED"); + job(companyId, TITLE_PREFIX + "OtherRole", "PUBLISHED"); + job(companyId, TITLE_PREFIX + "ThirdRole", "PUBLISHED"); + // 1 条标题同样命中关键词、但状态为 DRAFT 的岗位 + job(companyId, TITLE_PREFIX + TARGET_KEYWORD + "_DRAFT", "DRAFT"); + // 1 条标题命中关键词、状态为 CLOSED（对照非公开范围） + job(companyId, TITLE_PREFIX + TARGET_KEYWORD + "_CLOSED", "CLOSED"); + } + + @AfterEach + void cleanup() { + // 只按本轮显式登记的主键清理，不使用宽泛 deleteAll() + if (!jobIds.isEmpty()) { + jdbcTemplate.update("DELETE FROM jobs WHERE id IN (" + + String.join(",", jobIds.stream().map(String::valueOf).toList()) + ")"); + } + if (!companyIds.isEmpty()) { + jdbcTemplate.update("DELETE FROM companies WHERE id IN (" + + String.join(",", companyIds.stream().map(String::valueOf).toList()) + ")"); + } + if (!userIds.isEmpty()) { + String ids = String.join(",", userIds.stream().map(String::valueOf).toList()); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (" + ids + ")"); + jdbcTemplate.update("DELETE FROM users WHERE id IN (" + ids + ")"); + } + jobIds.clear(); + companyIds.clear(); + userIds.clear(); + targetJobId = null; + } + + private long user(String phone) { + jdbcTemplate.update("INSERT INTO users (phone, nickname, role, is_active, is_verified, created_at, " + + "updated_at) VALUES (?, ?, 'COMPANY', 1, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + phone, TITLE_PREFIX + phone); + Long id = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, phone); + jdbcTemplate.update("INSERT INTO user_roles (user_id, role) VALUES (?, 'COMPANY')", id); + userIds.add(id); + return id; + } + + private long company(long ownerUserId, String name) { + jdbcTemplate.update("INSERT INTO companies (owner_user_id, name, verified, created_at, updated_at) " + + "VALUES (?, ?, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", ownerUserId, name); + return jdbcTemplate.queryForObject("SELECT id FROM companies WHERE name = ?", Long.class, name); + } + + /** + * 插入夹具岗位，created_at 显式取互异值（每条递减 1 分钟）。 + * + *

    默认排序 {@code createdAt DESC} 没有 tiebreaker，若夹具时间相同，其相对顺序由引擎决定， + * 断言就会不稳定。显式互异后，夹具内部的顺序才是确定可断言的。

    + */ + private long job(long companyId, String title, String status) { + LocalDateTime createdAt = BASE_TIME.minusMinutes(jobIds.size()); + jdbcTemplate.update("INSERT INTO jobs (company_id, title, description, city, employment_type, status, " + + "created_at, updated_at) VALUES (?, ?, 'desc', '北京', 'FULL_TIME', ?, ?, ?)", + companyId, title, status, createdAt, createdAt); + Long id = jdbcTemplate.queryForObject("SELECT id FROM jobs WHERE title = ?", Long.class, title); + jobIds.add(id); + return id; + } + + // ── HTTP 调用与解析 ────────────────────────────────────── + + /** + * 走真实链路请求 /jobs。 + * + *

    用 {@code .param(...)} 传参而非在 URL 串里手写 {@code %20}：MockMvc 会对 URL 模板再做一次 + * 编码（{@code %20} → {@code %2520}），那样测的就不是「带空白的参数」而是「字面量 %20」。

    + * + * @param keyword {@code null} = 不带该参数；{@code ""} = {@code keyword=}；其余按原样发送 + */ + private JsonNode listJobs(String keyword, String size, String page) throws Exception { + var builder = get("/jobs").param("size", size); + if (page != null) { + builder = builder.param("page", page); + } + if (keyword != null) { + builder = builder.param("keyword", keyword); + } + var response = mockMvc.perform(builder).andReturn().getResponse(); + assertThat(response.getStatus()).as("GET /jobs 不得返回 4xx/5xx").isEqualTo(200); + String body = response.getContentAsString(); + assertThat(body).as("响应不得泄露 SQL / 异常类 / 堆栈 / 本机路径") + .doesNotContain("java.sql").doesNotContain("Exception") + .doesNotContain("at com.mydreamjob").doesNotContain("C:\\"); + return objectMapper.readTree(body).path("data"); + } + + private JsonNode listJobs(String keyword, String size) throws Exception { + return listJobs(keyword, size, null); + } + + private List idsOf(JsonNode data) { + List ids = new ArrayList<>(); + for (JsonNode item : data.path("items")) { + ids.add(item.path("id").asLong()); + } + return ids; + } + + /** 只保留本轮夹具的 ID，避免同库其它测试数据干扰。 */ + private List fixtureIdsOf(JsonNode data) { + List ids = new ArrayList<>(); + for (JsonNode item : data.path("items")) { + if (item.path("title").asText("").startsWith(TITLE_PREFIX)) { + ids.add(item.path("id").asLong()); + } + } + return ids; + } + + // ── 用例 ──────────────────────────────────────────────── + + @Test + @DisplayName("普通关键词只命中目标公开岗位") + void plainKeywordFindsPublishedJob() throws Exception { + JsonNode data = listJobs(TARGET_KEYWORD, "50"); + assertThat(idsOf(data)).as("普通关键词应只命中 1 条").containsExactly(targetJobId); + } + + @Test + @DisplayName("两侧空白关键词与普通关键词结果完全一致（trim）") + void trimmedKeywordFindsSamePublishedJob() throws Exception { + JsonNode plain = listJobs(TARGET_KEYWORD, "50"); + JsonNode padded = listJobs(" " + TARGET_KEYWORD + " ", "50"); + assertThat(idsOf(padded)) + .as("带两侧空白的关键词必须与普通关键词返回相同 ID 与顺序") + .isEqualTo(idsOf(plain)); + } + + @Test + @DisplayName("纯空白关键词等同于未传关键词") + void blankKeywordBehavesAsNoKeyword() throws Exception { + JsonNode none = listJobs(null, "50"); + JsonNode blank = listJobs(" ", "50"); + assertThat(fixtureIdsOf(blank)).as("纯空白关键词必须与无关键词返回相同夹具 ID 与顺序") + .isEqualTo(fixtureIdsOf(none)); + assertThat(blank.path("total").asLong()).as("总数也应一致").isEqualTo(none.path("total").asLong()); + } + + @Test + @DisplayName("空字符串关键词等同于未传关键词") + void emptyKeywordBehavesAsNoKeyword() throws Exception { + JsonNode none = listJobs(null, "50"); + JsonNode empty = listJobs("", "50"); + assertThat(fixtureIdsOf(empty)).as("空字符串关键词必须与无关键词返回相同夹具 ID 与顺序") + .isEqualTo(fixtureIdsOf(none)); + assertThat(empty.path("total").asLong()).isEqualTo(none.path("total").asLong()); + } + + @Test + @DisplayName("缺省关键词返回全部公开岗位") + void nullOrMissingKeywordListsPublishedJobs() throws Exception { + JsonNode data = listJobs(null, "50"); + assertThat(fixtureIdsOf(data)) + .as("本轮 3 条 PUBLISHED 夹具都应返回") + .hasSize(3); + } + + @Test + @DisplayName("关键词规范化后 DRAFT / CLOSED 仍不进入公开结果") + void draftJobNeverAppearsAfterNormalization() throws Exception { + for (String q : new String[]{TARGET_KEYWORD, " " + TARGET_KEYWORD + " ", " ", "", null}) { + JsonNode data = listJobs(q, "50"); + for (JsonNode item : data.path("items")) { + assertThat(item.path("status").asText()) + .as("公开列表只允许 PUBLISHED") + .isEqualTo("PUBLISHED"); + assertThat(item.path("title").asText()) + .as("DRAFT/CLOSED 夹具不得出现") + .doesNotContain("_DRAFT") + .doesNotContain("_CLOSED"); + } + } + } + + @Test + @DisplayName("关键词规范化不改变分页元数据") + void normalizationDoesNotChangePagination() throws Exception { + JsonNode plain = listJobs(TARGET_KEYWORD, "1", "0"); + JsonNode padded = listJobs(" " + TARGET_KEYWORD + " ", "1", "0"); + for (String field : new String[]{"total", "page", "size", "totalPages"}) { + assertThat(padded.path(field).asLong()) + .as("分页字段 %s 不应因规范化而变化", field) + .isEqualTo(plain.path(field).asLong()); + } + JsonNode none = listJobs(null, "2", "0"); + JsonNode blank = listJobs(" ", "2", "0"); + // 非夹具行之间存在 created_at 并列，而默认排序无 tiebreaker —— 小页尺寸下连「入选子集」 + // 都不由契约保证。故此用例只断言**确定性**的分页元数据与夹具集合。 + for (String field : new String[]{"total", "page", "size", "totalPages"}) { + assertThat(blank.path(field).asLong()) + .as("分页字段 %s 不应因空白关键词而变化", field) + .isEqualTo(none.path(field).asLong()); + } + assertThat(fixtureIdsOf(blank)).as("分页下夹具集合应与无关键词一致").isEqualTo(fixtureIdsOf(none)); + } + + @Test + @DisplayName("关键词规范化不改变既有默认排序契约（createdAt 降序）") + void normalizationDoesNotChangeExistingSortContract() throws Exception { + JsonNode none = listJobs(null, "50"); + JsonNode blank = listJobs(" ", "50"); + JsonNode padded = listJobs(" " + TARGET_KEYWORD + " ", "50"); + + List fixtureNone = fixtureIdsOf(none); + assertThat(fixtureNone).as("同一批夹具在两种查询下顺序应一致（夹具 created_at 互异）") + .isEqualTo(fixtureIdsOf(blank)); + assertThat(padded.path("items").isArray()).isTrue(); + + List createdDesc = new ArrayList<>(); + for (JsonNode item : blank.path("items")) { + createdDesc.add(item.path("createdAt").asText()); + } + assertThat(createdDesc).as("默认排序仍应为 createdAt 降序").isSortedAccordingTo( + (a, b) -> b.compareTo(a)); + } + + @Test + @DisplayName("副作用：GET 前后相关业务表逐字段零变化") + void listJobsIsReadOnly() throws Exception { + Map>> before = snapshot(); + listJobs(TARGET_KEYWORD, "50"); + listJobs(" ", "50"); + listJobs(null, "50"); + Map>> after = snapshot(); + for (String table : before.keySet()) { + assertThat(after.get(table)).as("%s 必须逐字段零变化", table).isEqualTo(before.get(table)); + } + } + + private Map>> snapshot() { + Map>> s = new LinkedHashMap<>(); + s.put("jobs", jdbcTemplate.queryForList( + "SELECT id, company_id, title, status, updated_at FROM jobs ORDER BY id")); + s.put("companies", jdbcTemplate.queryForList( + "SELECT id, owner_user_id, name, verified FROM companies ORDER BY id")); + s.put("users", jdbcTemplate.queryForList( + "SELECT id, phone, nickname, role, is_active FROM users ORDER BY id")); + s.put("audit_logs", jdbcTemplate.queryForList( + "SELECT id, user_id, action, entity_type FROM audit_logs ORDER BY id")); + s.put("notifications", jdbcTemplate.queryForList( + "SELECT id, user_id, type, is_read FROM notifications ORDER BY id")); + return s; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQueryExplainMySqlIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQueryExplainMySqlIntegrationTest.java new file mode 100644 index 0000000..ad97fc4 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQueryExplainMySqlIntegrationTest.java @@ -0,0 +1,364 @@ +package com.mydreamjob.job; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Sort; +import org.springframework.data.jpa.domain.Specification; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.annotation.DirtiesContext; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Q01 §8：**真实 MySQL 8** 上的执行计划与查询次数证据。 + * + *

    对组合过滤、latest 分页、salary 排序与 count 四类语句执行 + * {@code EXPLAIN FORMAT=JSON}，记录使用索引、access type、估算行数以及 + * filesort / temporary 情况，并测量结果规模为 1 / 20 / 50 时的 SQL 语句条数。

    + * + *

    EXPLAIN 使用的是与 Criteria 语义等价的 SQL，绑定同一组参数；用例会先断言 + * 等价 SQL 与 JPA/Criteria 路径返回**完全相同的 ID 与顺序**，避免 EXPLAIN 一份 + * 并不存在的语句。

    + * + *

    按 Q01 边界，本用例只记录、不改动索引；发现的问题留给 R01。

    + */ +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) +class JobSearchQueryExplainMySqlIntegrationTest { + + private static final AtomicLong SEQ = new AtomicLong(75000); + private static final Path REPORT = Path.of("target", "q01-explain-report.md"); + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private static final List PLAN_TABLE_FIELDS = List.of( + "table_name", "access_type", "possible_keys", "key", "key_length", + "rows_examined_per_scan", "rows_produced_per_join", "filtered", + "using_index", "using_filesort", "using_temporary_table"); + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("mydreamjob_q01") + .withUsername("q01") + .withPassword("q01-test-only"); + + /** 连接参数全部来自容器；同时注册 SQL 记录器以留下真实生成的 SQL 原文。 */ + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate"); + registry.add("spring.jpa.properties.hibernate.session_factory.statement_inspector", + () -> Q01SqlRecorder.class.getName()); + } + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private JobService jobService; + @Autowired private JobRepository jobRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + private final List jobIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + + private String tag; + private Long companyA; + private final Map citiesByResultSize = new LinkedHashMap<>(); + + @BeforeEach + void setUp() { + tag = "Q01E" + SEQ.incrementAndGet(); + Long ownerId = userRepository.save(User.builder() + .phone("15" + String.format("%09d", SEQ.incrementAndGet())) + .nickname(tag + "-企业") + .role(User.Role.COMPANY) + .roles(Set.of(User.Role.COMPANY)) + .active(true).verified(true).build()).getId(); + userIds.add(ownerId); + companyA = companyRepository.save(Company.builder() + .ownerUserId(ownerId).name(tag + "公司").verified(true).build()).getId(); + companyIds.add(companyA); + + for (int size : new int[]{1, 20, 50}) { + citiesByResultSize.put(size, seedJobs(size)); + } + } + + @AfterEach + void tearDown() { + if (!jobIds.isEmpty()) { + jobRepository.deleteAllById(jobIds); + jobIds.clear(); + } + if (!companyIds.isEmpty()) { + companyRepository.deleteAllById(companyIds); + companyIds.clear(); + } + if (!userIds.isEmpty()) { + userRepository.deleteAllById(userIds); + userIds.clear(); + } + } + + private String seedJobs(int size) { + String city = tag + "CITY" + size; + List jobs = new ArrayList<>(); + for (int i = 0; i < size; i++) { + jobs.add(Job.builder() + .companyId(companyA).title(tag + "岗位" + i).description("描述" + i).requirements("要求" + i) + .city(city).employmentType("FULL_TIME") + .salaryMin(8000 + i * 100).salaryMax(20000 + i * 200) + .status(JobStatus.PUBLISHED.name()).build()); + } + jobRepository.saveAll(jobs).forEach(job -> jobIds.add(job.getId())); + return city; + } + + // ── EXPLAIN 主证据 ────────────────────────────────────────── + + @Test + void explainCombinedFilterLatestSalaryAndCount() throws IOException { + StringBuilder report = new StringBuilder(); + report.append("# Q01 MySQL 执行计划证据（由 ") + .append(getClass().getSimpleName()).append(" 生成）\n\n") + .append("- 数据库：`mysql:8.4` Testcontainers 独立容器，正式 Flyway 迁移，`ddl-auto=validate`\n") + .append("- EXPLAIN 形式：`EXPLAIN FORMAT=JSON`，与 Criteria 路径绑定同一组参数\n") + .append("- 夹具规模：每个城市分别 1 / 20 / 50 条 PUBLISHED 岗位（刻意做小，用于验证语义而非压测）\n") + .append("- Q01 不新增索引；执行计划问题记录给 R01\n\n"); + + String city = citiesByResultSize.get(20); + String keyword = tag + "岗位"; + String pattern = "%" + keyword.toLowerCase() + "%"; + + // 1. 组合过滤 + latest 分页 + Specification combined = JobSearchSpecification.searchJobs( + keyword, city, "FULL_TIME", 5000, 30000, companyA); + String combinedSql = """ + SELECT j.id FROM jobs j + WHERE j.status = ? AND (lower(j.title) LIKE ? OR lower(j.description) LIKE ? OR lower(j.requirements) LIKE ?) + AND lower(j.city) = ? AND lower(j.employment_type) = ? AND j.salary_max >= ? AND j.salary_min <= ? AND j.company_id = ? + ORDER BY j.created_at DESC, j.id DESC + LIMIT ? OFFSET ?"""; + Object[] combinedArgs = {"PUBLISHED", pattern, pattern, pattern, + city.toLowerCase(java.util.Locale.ROOT), "full_time", + 5000, 30000, companyA, 20, 0}; + + Q01SqlRecorder.clear(); + List jpaCombined = ids(jobRepository.findAll(combined, latest(0, 20))); + List hibernateSql = Q01SqlRecorder.drain(); + + assertSameIds("组合过滤 + latest 分页", combinedSql, combinedArgs, jpaCombined); + report.append("## 1. 组合过滤 + latest 分页\n\n"); + report.append("Hibernate 实际生成并执行的 SQL（占位符形式）：\n\n```sql\n") + .append(String.join("\n\n", hibernateSql)).append("\n```\n\n"); + appendExplain(report, combinedSql, combinedArgs); + + // 2. latest 分页（无关键词） + Specification latestOnly = JobSearchSpecification.searchJobs(null, city, null, null, null, null); + String latestSql = """ + SELECT j.id FROM jobs j + WHERE j.status = ? AND lower(j.city) = ? + ORDER BY j.created_at DESC, j.id DESC + LIMIT ? OFFSET ?"""; + Object[] latestArgs = {"PUBLISHED", city.toLowerCase(java.util.Locale.ROOT), 20, 0}; + + List jpaLatest = ids(jobRepository.findAll(latestOnly, latest(0, 20))); + assertSameIds("latest 分页", latestSql, latestArgs, jpaLatest); + report.append("## 2. latest 分页\n\n"); + appendExplain(report, latestSql, latestArgs); + + // 3. salary 排序（CASE WHEN + salary_max DESC + id DESC） + String salarySql = """ + SELECT j.id FROM jobs j + WHERE j.status = ? AND lower(j.city) = ? + ORDER BY CASE WHEN j.salary_max IS NULL THEN 1 ELSE 0 END ASC, j.salary_max DESC, j.id DESC + LIMIT ? OFFSET ?"""; + Object[] salaryArgs = {"PUBLISHED", city.toLowerCase(java.util.Locale.ROOT), 20, 0}; + + List serviceSalary = jobService.searchJobs(null, city, null, null, null, null, "salary", 0, 20) + .getContent().stream().map(com.mydreamjob.job.dto.JobSearchItem::getId).toList(); + assertSameIds("salary 排序", salarySql, salaryArgs, serviceSalary); + report.append("## 3. salary 排序（salaryMax DESC NULLS LAST）\n\n"); + appendExplain(report, salarySql, salaryArgs); + + // 4. count 查询 + String countSql = """ + SELECT count(j.id) FROM jobs j + WHERE j.status = ? AND (lower(j.title) LIKE ? OR lower(j.description) LIKE ? OR lower(j.requirements) LIKE ?) + AND lower(j.city) = ? AND lower(j.employment_type) = ? AND j.salary_max >= ? AND j.salary_min <= ? AND j.company_id = ?"""; + Object[] countArgs = {"PUBLISHED", pattern, pattern, pattern, + city.toLowerCase(java.util.Locale.ROOT), "full_time", + 5000, 30000, companyA}; + + Long jpaCount = jobRepository.count(combined); + Long sqlCount = jdbcTemplate.queryForObject(countSql, Long.class, countArgs); + assertThat(sqlCount) + .as("等价 count SQL 必须与 Criteria 的 count 结果一致") + .isEqualTo(jpaCount); + report.append("## 4. count 查询\n\n"); + appendExplain(report, countSql, countArgs); + + // 5. 结果规模 1 / 20 / 50 下的 SQL 语句条数 + report.append("## 5. 结果规模 1 / 20 / 50 下的 SQL 语句条数\n\n"); + report.append("Spring Data 对首页有优化：首页返回行数小于 `pageSize` 时不再发 count 查询，\n"); + report.append("因此结果数 < pageSize 时为 1 条（仅数据查询），否则为 2 条（count + 数据查询）。\n"); + report.append("两种情况下语句条数都**不随结果规模增长**，即不存在 N+1。\n\n"); + report.append("| 匹配结果数 | 返回行数 | totalElements | Repository SQL数 | 完整Service SQL数 |\n") + .append("|---|---|---|---|---|\n"); + for (int size : new int[]{1, 20, 50}) { + Q01SqlRecorder.clear(); + var page = jobRepository.findAll( + JobSearchSpecification.searchJobs(null, citiesByResultSize.get(size), null, null, null, null), + latest(0, 20)); + List repositoryStatements = Q01SqlRecorder.drain(); + + Q01SqlRecorder.clear(); + var servicePage = jobService.searchJobs( + null, citiesByResultSize.get(size), null, null, null, null, "latest", 0, 20); + List serviceStatements = Q01SqlRecorder.drain(); + + int expectedRepositoryStatements = size < 20 ? 1 : 2; + int expectedServiceStatements = expectedRepositoryStatements + 1; + report.append("| ").append(size).append(" | ").append(page.getContent().size()) + .append(" | ").append(page.getTotalElements()) + .append(" | ").append(repositoryStatements.size()) + .append(" | ").append(serviceStatements.size()).append(" |\n"); + assertThat(repositoryStatements) + .as("结果规模 %s：Repository 分页SQL数不随结果行数线性增长", size) + .hasSize(expectedRepositoryStatements); + assertThat(serviceStatements) + .as("结果规模 %s：完整Service只增加一次企业批量查询，不产生N+1", size) + .hasSize(expectedServiceStatements); + assertThat(page.getTotalElements()).isEqualTo(size); + assertThat(servicePage.getTotalElements()).isEqualTo(size); + } + report.append('\n'); + + Files.createDirectories(REPORT.getParent()); + Files.writeString(REPORT, report.toString(), StandardCharsets.UTF_8); + System.out.println("[Q01] EXPLAIN 报告已写入 " + REPORT.toAbsolutePath()); + } + + // ── 等价性校验与计划摘要 ──────────────────────────────────── + + /** 等价 SQL 必须与 JPA/Criteria 路径返回完全相同的 ID 与顺序。 */ + private void assertSameIds(String scenario, String sql, Object[] args, List jpaIds) { + List sqlIds = jdbcTemplate.queryForList(sql, Long.class, args); + assertThat(sqlIds) + .as("%s：等价 SQL 必须与 Criteria/JPA 路径返回相同的 ID 与顺序，EXPLAIN 才有意义", scenario) + .containsExactlyElementsOf(jpaIds); + assertThat(sqlIds).as("%s：夹具必须真的命中数据", scenario).isNotEmpty(); + } + + private void appendExplain(StringBuilder report, String sql, Object[] args) { + report.append("等价 SQL（绑定参数 ").append(Arrays.toString(args)).append("）：\n\n```sql\n") + .append(sql).append("\n```\n\n"); + + String plan = jdbcTemplate.queryForObject("EXPLAIN FORMAT=JSON " + sql, String.class, args); + assertThat(plan).as("EXPLAIN 必须返回计划").isNotBlank(); + + report.append("计划摘要：\n\n```\n").append(summarize(plan)).append("```\n\n"); + report.append("
    EXPLAIN FORMAT=JSON 原文\n\n```json\n") + .append(plan).append("\n```\n\n
    \n\n"); + } + + private String summarize(String planJson) { + JsonNode queryBlock; + try { + queryBlock = MAPPER.readTree(planJson).path("query_block"); + } catch (IOException e) { + throw new IllegalStateException("failed to parse EXPLAIN FORMAT=JSON output", e); + } + + StringBuilder summary = new StringBuilder(); + JsonNode costInfo = queryBlock.path("cost_info"); + if (costInfo.has("query_cost")) { + summary.append("query_cost = ").append(costInfo.get("query_cost").asText()).append('\n'); + } + summary.append("using_filesort = ").append(planJson.contains("\"using_filesort\": true")).append('\n'); + summary.append("using_temporary_table = ") + .append(planJson.contains("\"using_temporary_table\": true")).append('\n'); + collectTables(queryBlock, "query_block", summary); + return summary.toString(); + } + + private void collectTables(JsonNode node, String context, StringBuilder summary) { + if (node.isObject()) { + node.fields().forEachRemaining(entry -> { + String name = entry.getKey(); + JsonNode value = entry.getValue(); + switch (name) { + case "table" -> summary.append("- 表 ").append(context).append(": ") + .append(tableFields(value)).append('\n'); + case "ordering_operation" -> collectTables(value, context + "/ORDER BY", summary); + case "grouping_operation" -> collectTables(value, context + "/GROUP BY", summary); + case "nested_loop", "duplicates_removal", "query_block" -> + collectTables(value, context, summary); + default -> { + // 其他子结构不参与摘要 + } + } + }); + } else if (node.isArray()) { + for (JsonNode child : node) { + collectTables(child, context, summary); + } + } + } + + private String tableFields(JsonNode table) { + List parts = new ArrayList<>(); + for (String field : PLAN_TABLE_FIELDS) { + if (table.has(field)) { + parts.add(field + "=" + table.get(field).toString()); + } + } + return String.join(", ", parts); + } + + private static List ids(org.springframework.data.domain.Page page) { + return page.getContent().stream().map(Job::getId).toList(); + } + + private static PageRequest latest(int page, int size) { + return PageRequest.of(page, size, Sort.by( + new Sort.Order(Sort.Direction.DESC, "createdAt"), + new Sort.Order(Sort.Direction.DESC, "id"))); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectIntegrationTest.java new file mode 100644 index 0000000..925c6fc --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectIntegrationTest.java @@ -0,0 +1,20 @@ +package com.mydreamjob.job; + +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; + +/** + * Q01 §7 查询副作用行级快照 —— H2 层。 + * + *

    与 {@link JobSearchQuerySideEffectMySqlIntegrationTest} 执行完全相同的用例， + * 用于 H2 / 真实 MySQL 逐项对账。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class JobSearchQuerySideEffectIntegrationTest extends JobSearchQuerySideEffectTestBase { + + @MockBean + private RedisTemplate redisTemplate; +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectMySqlIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectMySqlIntegrationTest.java new file mode 100644 index 0000000..a75f515 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectMySqlIntegrationTest.java @@ -0,0 +1,44 @@ +package com.mydreamjob.job; + +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.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.annotation.DirtiesContext; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +/** + * Q01 §7 查询副作用行级快照 —— **真实 MySQL 8** 层。 + * + *

    用例与 {@link JobSearchQuerySideEffectIntegrationTest} 完全相同（同一基类）， + * 用于 H2 / MySQL 逐项对账。使用独立容器、正式 Flyway 迁移与 {@code ddl-auto=validate}， + * 不复用开发库，不打印任何连接凭据。

    + */ +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) +class JobSearchQuerySideEffectMySqlIntegrationTest extends JobSearchQuerySideEffectTestBase { + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("mydreamjob_q01") + .withUsername("q01") + .withPassword("q01-test-only"); + + /** 连接参数全部来自容器，运行期注入，不落盘、不打印密码。 */ + @DynamicPropertySource + static void datasource(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate"); + } + + @MockBean + private RedisTemplate redisTemplate; +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectTestBase.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectTestBase.java new file mode 100644 index 0000000..8d4e565 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchQuerySideEffectTestBase.java @@ -0,0 +1,299 @@ +package com.mydreamjob.job; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Sort; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.support.GeneratedKeyHolder; +import org.springframework.jdbc.support.KeyHolder; + +import java.math.BigDecimal; +import java.sql.PreparedStatement; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Q01 §7 查询副作用的**行级**证据基类。 + * + *

    证明公开搜索（{@link JobService#searchJobs} 与 + * {@link JobSearchSpecification#searchJobs} 的真实 Repository 路径）只读， + * 不会改写岗位状态、企业、用户或其他业务表。

    + * + *

    做法：在 jobs、companies、users、applications、candidate_dimension_scores、 + * notifications、conversations、messages、audit_logs 九张表上取**行级稳定字段快照**， + * 执行完整搜索矩阵后再次取快照，逐表逐行逐字段比较。只比较 COUNT / SUM / CRC32 + * 无法证明“没有某一行被改写”，因此这里不做聚合比较。

    + * + *

    快照比较本身也可能失效（例如永远返回相等），所以另有三条**反证测试**：人为改字段、 + * 插行、删行，必须被快照发现。

    + * + *

    本基类不绑定数据库：H2 用例与真实 MySQL 用例各自继承并断言同一组行为， + * 从而形成跨库逐项对账。

    + */ +abstract class JobSearchQuerySideEffectTestBase { + + private static final AtomicLong SEQ = new AtomicLong(74000); + private static final int MAX_RESULTS = 50; + + /** 清理顺序：先删有外键指向其他受检表的行，再删主表。 */ + private static final List AUXILIARY_TABLES = List.of( + "messages", "conversations", "notifications", + "applications", "candidate_dimension_scores", "audit_logs"); + + @Autowired protected JobService jobService; + @Autowired protected JobRepository jobRepository; + @Autowired protected CompanyRepository companyRepository; + @Autowired protected UserRepository userRepository; + @Autowired protected JdbcTemplate jdbcTemplate; + + private final List jobIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + private final Map> auxiliaryIds = new LinkedHashMap<>(); + + private BusinessRowSnapshot snapshot; + private String tag; + private String city; + private Long companyA; + private Long ownerA; + private Long student; + + @BeforeEach + void setUpBusinessFixtures() { + snapshot = new BusinessRowSnapshot(jdbcTemplate); + tag = "Q01X" + SEQ.incrementAndGet(); + city = tag + "CITY"; + + ownerA = createUser("甲", User.Role.COMPANY); + Long ownerB = createUser("乙", User.Role.COMPANY); + student = createUser("学生", User.Role.STUDENT); + companyA = createCompany(ownerA, "甲"); + Long companyB = createCompany(ownerB, "乙"); + + createJob(companyA, JobStatus.PUBLISHED.name(), 10000, 20000); + createJob(companyA, JobStatus.PUBLISHED.name(), 10000, null); + createJob(companyA, JobStatus.DRAFT.name(), 10000, 20000); + createJob(companyB, JobStatus.CLOSED.name(), 10000, 20000); + + seedAuxiliaryRows(); + } + + @AfterEach + void tearDownBusinessFixtures() { + for (String table : AUXILIARY_TABLES) { + List ids = auxiliaryIds.get(table); + if (ids == null || ids.isEmpty()) { + continue; + } + String placeholders = String.join(",", Collections.nCopies(ids.size(), "?")); + jdbcTemplate.update("DELETE FROM " + table + " WHERE id IN (" + placeholders + ")", ids.toArray()); + } + auxiliaryIds.clear(); + deleteAllById(jobRepository, jobIds); + deleteAllById(companyRepository, companyIds); + deleteAllById(userRepository, userIds); + } + + // ── 主证据：搜索不产生任何业务行改动 ──────────────────────── + + @Test + void searchQueriesDoNotChangeBusinessRows() { + Map>> before = snapshot.capture(); + + for (String table : BusinessRowSnapshot.tables()) { + assertThat(before.get(table)) + .as("受检表 %s 必须在测试库中有行，否则前后比较是空比较", table) + .isNotEmpty(); + } + + long matched = runFullSearchMatrix(); + assertThat(matched).as("搜索矩阵必须真的命中数据，否则副作用证据是空跑").isPositive(); + + assertThat(BusinessRowSnapshot.describeDifference(before, snapshot.capture())) + .as("公开搜索全矩阵执行前后，九张受检表的行级稳定字段必须逐行逐字段一致") + .isEmpty(); + } + + // ── 反证：快照必须能发现改动，否则主证据不成立 ────────────── + + @Test + void snapshotReportsRowFieldUpdate() { + Map>> before = snapshot.capture(); + Long jobId = jobIds.get(0); + Map original = rowById(before, "jobs", jobId); + + jdbcTemplate.update("UPDATE jobs SET status = ?, updated_at = ? WHERE id = ?", + JobStatus.CLOSED.name(), original.get("updated_at"), jobId); + + assertThat(BusinessRowSnapshot.describeDifference(before, snapshot.capture())) + .as("反证：同一行的字段被改写必须被快照发现") + .contains("jobs:"); + + jdbcTemplate.update("UPDATE jobs SET status = ?, updated_at = ? WHERE id = ?", + original.get("status"), original.get("updated_at"), jobId); + + assertThat(BusinessRowSnapshot.describeDifference(before, snapshot.capture())) + .as("反证：把字段与 updated_at 一并还原后，快照必须重新完全一致（说明差异定位精确）") + .isEmpty(); + } + + @Test + void snapshotReportsInsertedRow() { + Map>> before = snapshot.capture(); + + insertNotification(tag + "-反证插入"); + + assertThat(BusinessRowSnapshot.describeDifference(before, snapshot.capture())) + .as("反证：新增一行必须被快照发现") + .contains("notifications:"); + } + + @Test + void snapshotReportsDeletedRow() { + Long temporaryId = insertNotification(tag + "-反证删除"); + Map>> before = snapshot.capture(); + + jdbcTemplate.update("DELETE FROM notifications WHERE id = ?", temporaryId); + auxiliaryIds.get("notifications").remove(temporaryId); + + assertThat(BusinessRowSnapshot.describeDifference(before, snapshot.capture())) + .as("反证：删除一行必须被快照发现") + .contains("notifications:"); + } + + // ── 搜索矩阵 ──────────────────────────────────────────────── + + /** 覆盖全部过滤条件 × 全部排序 × 分页 × 无结果 × 聚合筛选项，返回命中的总行数。 */ + private long runFullSearchMatrix() { + long matched = 0; + for (String sort : new String[]{"latest", "relevance", "salary", null}) { + matched += jobService.searchJobs(null, city, null, null, null, null, sort, 0, MAX_RESULTS) + .getTotalElements(); + matched += jobService.searchJobs(tag + "岗位", city, "FULL_TIME", 10000, 20000, companyA, + sort, 0, MAX_RESULTS).getTotalElements(); + matched += jobService.searchJobs("%", city, null, 5000, 30000, null, sort, 0, 10) + .getTotalElements(); + matched += jobService.searchJobs("_", null, null, null, null, null, sort, 0, 10) + .getTotalElements(); + matched += jobService.searchJobs(tag + "不存在的关键词XYZ", city, null, null, null, null, + sort, 0, 10).getTotalElements(); + matched += jobService.searchJobs(null, city, null, null, null, null, sort, 1, 2) + .getContent().size(); + } + jobService.getFilterOptions(); + + // 不经 Service，直接走 Specification 的真实 Repository 查询路径 + matched += jobRepository.findAll( + JobSearchSpecification.searchJobs(tag + "岗位", city, "FULL_TIME", 10000, 20000, companyA), + PageRequest.of(0, MAX_RESULTS, Sort.by(Sort.Direction.DESC, "createdAt"))) + .getNumberOfElements(); + return matched; + } + + // ── 夹具 ──────────────────────────────────────────────────── + + private Long createUser(String label, User.Role role) { + Long id = userRepository.save(User.builder() + .phone("16" + String.format("%09d", SEQ.incrementAndGet())) + .nickname(tag + "-" + label) + .role(role) + .roles(Set.of(role)) + .active(true).verified(true).build()).getId(); + userIds.add(id); + return id; + } + + private Long createCompany(Long ownerId, String label) { + Long id = companyRepository.save(Company.builder() + .ownerUserId(ownerId).name(tag + "公司" + label).verified(true).build()).getId(); + companyIds.add(id); + return id; + } + + private Long createJob(Long companyId, String status, Integer salaryMin, Integer salaryMax) { + Long id = jobRepository.save(Job.builder() + .companyId(companyId).title(tag + "岗位").description("描述").requirements("要求") + .city(city).employmentType("FULL_TIME").salaryMin(salaryMin).salaryMax(salaryMax) + .status(status).build()).getId(); + jobIds.add(id); + return id; + } + + private void seedAuxiliaryRows() { + Long publishedJobId = jobIds.get(0); + + insert("applications", + "INSERT INTO applications (job_id, student_user_id, cover_letter, status) VALUES (?, ?, ?, ?)", + publishedJobId, student, tag + "求职信", "SUBMITTED"); + insert("candidate_dimension_scores", + "INSERT INTO candidate_dimension_scores (student_user_id, dimension, period, score, status," + + " sub_scores_json, weight, rules_version, calculated_at, version)" + + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + student, "ABILITY", "2026-09", new BigDecimal("88.50"), "OK", + "{\"q01\":true}", new BigDecimal("12.50"), tag, LocalDateTime.now(), 0L); + insertNotification(tag + "-通知"); + + Long conversationId = insert("conversations", + "INSERT INTO conversations (title, type, created_by) VALUES (?, ?, ?)", + tag + "会话", "DIRECT", ownerA); + insert("messages", + "INSERT INTO messages (conversation_id, sender_user_id, content) VALUES (?, ?, ?)", + conversationId, ownerA, tag + "消息"); + insert("audit_logs", + "INSERT INTO audit_logs (user_id, action, entity_type, entity_id, details)" + + " VALUES (?, ?, ?, ?, ?)", + ownerA, "Q01_SEARCH_PROBE", "JOB", publishedJobId, tag + "审计"); + } + + private Long insertNotification(String title) { + return insert("notifications", + "INSERT INTO notifications (user_id, type, title, content, is_read) VALUES (?, ?, ?, ?, ?)", + student, "SYSTEM", title, tag + "内容", false); + } + + /** 原生 INSERT，登记生成的 id 供精确清理，不依赖实体映射。 */ + private Long insert(String table, String sql, Object... args) { + KeyHolder keyHolder = new GeneratedKeyHolder(); + jdbcTemplate.update(connection -> { + PreparedStatement statement = connection.prepareStatement(sql, new String[]{"id"}); + for (int i = 0; i < args.length; i++) { + statement.setObject(i + 1, args[i]); + } + return statement; + }, keyHolder); + Long id = keyHolder.getKey().longValue(); + auxiliaryIds.computeIfAbsent(table, key -> new ArrayList<>()).add(id); + return id; + } + + private static Map rowById(Map>> snapshot, + String table, Long id) { + return snapshot.get(table).stream() + .filter(row -> id.equals(row.get("id"))) + .findFirst() + .orElseThrow(() -> new IllegalStateException("snapshot row missing: " + table + "#" + id)); + } + + private static void deleteAllById(JpaRepository repository, List ids) { + if (!ids.isEmpty()) { + repository.deleteAllById(ids); + } + ids.clear(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceIntegrationTest.java new file mode 100644 index 0000000..668abb9 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceIntegrationTest.java @@ -0,0 +1,270 @@ +package com.mydreamjob.job; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.dto.JobSearchItem; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.domain.Page; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Q01：{@link JobService#searchJobs} 的**真实查询**覆盖（真实 JobService / JobRepository / + * CompanyRepository / EntityManager，不 Mock {@code findAll}）。 + * + *

    原 {@code JobSearchServiceTest} 保留，承担参数校验与编排职责；本类补的是排序、 + * 分页与企业信息组装在真实数据库上的行为。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class JobSearchServiceIntegrationTest { + + private static final AtomicLong SEQ = new AtomicLong(72000); + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private JobService jobService; + @Autowired private JobRepository jobRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + private final List jobIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + + private String tag; + private Long companyA; + + @BeforeEach + void setUp() { + tag = "Q01S" + SEQ.incrementAndGet(); + companyA = createCompany("甲", true); + } + + @AfterEach + void tearDown() { + if (!jobIds.isEmpty()) { + jobRepository.deleteAllById(jobIds); + } + if (!companyIds.isEmpty()) { + companyRepository.deleteAllById(companyIds); + } + if (!userIds.isEmpty()) { + userRepository.deleteAllById(userIds); + } + jobIds.clear(); + companyIds.clear(); + userIds.clear(); + } + + // ── 夹具 ──────────────────────────────────────────────────── + + private Long createCompany(String label, boolean verified) { + Long ownerId = userRepository.save(User.builder() + .phone("19" + String.format("%09d", SEQ.incrementAndGet())) + .nickname(tag + "-" + label) + .role(User.Role.COMPANY) + .roles(Set.of(User.Role.COMPANY)) + .active(true).verified(true).build()).getId(); + userIds.add(ownerId); + Long id = companyRepository.save(Company.builder() + .ownerUserId(ownerId).name(tag + "公司" + label).verified(verified).build()).getId(); + companyIds.add(id); + return id; + } + + private Long publishedJob(Long companyId, String city, String employmentType, + Integer salaryMin, Integer salaryMax) { + Long id = jobRepository.save(Job.builder() + .companyId(companyId) + .title(tag + "岗位") + .description("描述") + .requirements("要求") + .city(city) + .employmentType(employmentType) + .salaryMin(salaryMin) + .salaryMax(salaryMax) + .status(JobStatus.PUBLISHED.name()) + .build()).getId(); + jobIds.add(id); + return id; + } + + private Long jobWithStatus(Long companyId, String city, String status) { + Long id = jobRepository.save(Job.builder() + .companyId(companyId).title(tag + "岗位").description("描述").requirements("要求") + .city(city).employmentType("FULL_TIME").salaryMin(10000).salaryMax(20000) + .status(status).build()).getId(); + jobIds.add(id); + return id; + } + + /** 实体的 @CreatedDate 审计会覆盖显式值，排序用例用原生 SQL 回写。 */ + private void setCreatedAt(Long jobId, LocalDateTime createdAt) { + jdbcTemplate.update("UPDATE jobs SET created_at = ? WHERE id = ?", createdAt, jobId); + } + + private List ids(Page page) { + return page.getContent().stream().map(JobSearchItem::getId).toList(); + } + + // ── 排序 ──────────────────────────────────────────────────── + + @Test + void latestSortUsesCreatedAtThenIdDescending() { + String city = tag + "LATEST"; + LocalDateTime base = LocalDateTime.of(2026, 2, 1, 0, 0); + Long older = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + Long newer = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + setCreatedAt(older, base); + setCreatedAt(newer, base.plusDays(1)); + + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, "latest", 0, 10))) + .as("createdAt DESC：新的在前").containsExactly(newer, older); + + // createdAt 相同时按 id DESC + setCreatedAt(older, base); + setCreatedAt(newer, base); + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, "latest", 0, 10))) + .as("createdAt 相同时按 id DESC").containsExactly(newer, older); + } + + @Test + void nullSortUsesLatestOrder() { + String city = tag + "NULLSORT"; + LocalDateTime base = LocalDateTime.of(2026, 2, 2, 0, 0); + Long older = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + Long newer = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + setCreatedAt(older, base); + setCreatedAt(newer, base.plusDays(1)); + + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, null, 0, 10))) + .as("sort 为 null 时等价于 latest").containsExactly(newer, older); + } + + @Test + void relevanceCurrentlyUsesLatestOrder() { + String city = tag + "RELEVANCE"; + LocalDateTime base = LocalDateTime.of(2026, 2, 3, 0, 0); + Long older = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + Long newer = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + setCreatedAt(older, base); + setCreatedAt(newer, base.plusDays(1)); + + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, "relevance", 0, 10))) + .as("relevance 当前与 latest 等价（本轮锁定该语义）").containsExactly(newer, older); + } + + // ── salary 排序 ───────────────────────────────────────────── + + @Test + void salarySortUsesMaximumDescendingAndNullLast() { + String city = tag + "SALARY"; + Long high = publishedJob(companyA, city, "FULL_TIME", 10000, 30000); + Long mid = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + Long nullMax = publishedJob(companyA, city, "FULL_TIME", 10000, null); + + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, "salary", 0, 10))) + .as("salaryMax DESC 且 NULL 排最后").containsExactly(high, mid, nullMax); + } + + @Test + void salarySortUsesIdDescendingAsTieBreaker() { + String city = tag + "SALARYTIE"; + Long first = publishedJob(companyA, city, "FULL_TIME", 10000, 25000); + Long second = publishedJob(companyA, city, "FULL_TIME", 12000, 25000); + Long third = publishedJob(companyA, city, "FULL_TIME", 14000, 25000); + + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, "salary", 0, 10))) + .as("salaryMax 相同时按 id DESC") + .containsExactly(third, second, first); + } + + @Test + void salarySortReturnsCorrectTotalAndTotalPages() { + String city = tag + "SALARYPAGE"; + for (int i = 0; i < 5; i++) { + publishedJob(companyA, city, "FULL_TIME", 10000, 20000 + i); + } + + Page page = jobService.searchJobs(null, city, null, null, null, null, "salary", 0, 2); + + assertThat(page.getTotalElements()).as("total 为全部匹配行数，不是当前页行数").isEqualTo(5); + assertThat(page.getTotalPages()).isEqualTo(3); + assertThat(page.getContent()).hasSize(2); + } + + @Test + void secondPageDoesNotRepeatOrLoseRows() { + String city = tag + "PAGE2"; + List created = new ArrayList<>(); + for (int i = 0; i < 5; i++) { + created.add(publishedJob(companyA, city, "FULL_TIME", 10000, 20000 + i)); + } + // salaryMax 递增 → 期望顺序为其反序 + List expected = new ArrayList<>(created); + java.util.Collections.reverse(expected); + + Page p0 = jobService.searchJobs(null, city, null, null, null, null, "salary", 0, 2); + Page p1 = jobService.searchJobs(null, city, null, null, null, null, "salary", 1, 2); + Page p2 = jobService.searchJobs(null, city, null, null, null, null, "salary", 2, 2); + + List all = new ArrayList<>(); + all.addAll(ids(p0)); + all.addAll(ids(p1)); + all.addAll(ids(p2)); + + assertThat(all).as("三页拼接等于完整期望顺序，无重复无遗漏").containsExactlyElementsOf(expected); + assertThat(all).doesNotHaveDuplicates(); + } + + // ── 企业信息 / 状态 ───────────────────────────────────────── + + @Test + void companyInformationIsMappedFromRealRepository() { + String city = tag + "COMPANYINFO"; + Long jobId = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + + Page page = jobService.searchJobs(null, city, null, null, null, null, "latest", 0, 10); + + assertThat(page.getContent()).hasSize(1); + JobSearchItem item = page.getContent().get(0); + assertThat(item.getId()).isEqualTo(jobId); + assertThat(item.getCompany()).as("企业信息由真实 CompanyRepository 批量组装").isNotNull(); + assertThat(item.getCompany().getId()).isEqualTo(companyA); + assertThat(item.getCompany().getName()).isEqualTo(tag + "公司甲"); + assertThat(item.getCompany().getVerified()).isTrue(); + } + + @Test + void searchDoesNotReturnDraftOrClosedJobs() { + String city = tag + "STATUS"; + Long published = publishedJob(companyA, city, "FULL_TIME", 10000, 20000); + jobWithStatus(companyA, city, JobStatus.DRAFT.name()); + jobWithStatus(companyA, city, JobStatus.CLOSED.name()); + + for (String sort : new String[]{"latest", "relevance", "salary", null}) { + assertThat(ids(jobService.searchJobs(null, city, null, null, null, null, sort, 0, 10))) + .as("非 PUBLISHED 岗位绝不进入公开搜索（sort=" + sort + "）") + .containsExactly(published); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java index 7f910ae..1325c2b 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchServiceTest.java @@ -28,6 +28,19 @@ import static org.mockito.ArgumentMatchers.anyInt; import static org.mockito.ArgumentMatchers.eq; import static org.mockito.Mockito.*; +/** + * {@link JobService#searchJobs} 的**编排与参数校验**测试（纯 Mockito）。 + * + *

    本类把 {@code JobRepository.findAll(Specification, Pageable)} 与 + * {@code CompanyRepository} 整体 Mock 掉，因此它只能证明参数校验、分页对象、 + * 排序参数传递和 DTO 组装的编排逻辑；**不能证明 Criteria 谓词、SQL 过滤、 + * 排序与分页在真实数据库上的行为**。

    + * + *

    真实查询覆盖见 Q01 补充的 + * {@link JobSearchSpecificationIntegrationTest}（H2 真实 Repository）、 + * {@link JobSearchServiceIntegrationTest}（H2 真实 Service/EntityManager）、 + * {@link JobSearchSpecificationMySqlIntegrationTest}（真实 MySQL 8）。

    + */ @ExtendWith(MockitoExtension.class) class JobSearchServiceTest { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationIntegrationTest.java new file mode 100644 index 0000000..f0b6a55 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationIntegrationTest.java @@ -0,0 +1,425 @@ +package com.mydreamjob.job; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Pageable; +import org.springframework.data.domain.Sort; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Q01：{@link JobSearchSpecification} 的**真实数据库**覆盖（H2 + 真实 Flyway + 真实 JobRepository）。 + * + *

    与 {@code JobSearchServiceTest} 的区别：这里不 Mock Repository / Specification / + * EntityManager / 事务，直接执行 {@code jobRepository.findAll(spec, pageable)}， + * 断言返回的**ID 及顺序**，从而真正验证 Criteria 谓词、过滤与排序。

    + * + *

    夹具隔离：每个用例使用唯一城市标记，只在自己的数据上断言，不依赖种子岗位。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class JobSearchSpecificationIntegrationTest { + + private static final AtomicLong SEQ = new AtomicLong(71000); + /** 结果集足够大，避免分页测试被默认 size 截断。 */ + private static final int MAX_RESULTS = 50; + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private JobRepository jobRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + private final List jobIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + + private String tag; + private Long companyA; + private Long companyB; + + @BeforeEach + void setUp() { + tag = "Q01" + SEQ.incrementAndGet(); + companyA = createCompany("甲"); + companyB = createCompany("乙"); + } + + @AfterEach + void tearDown() { + // FK 安全顺序：jobs -> companies -> users + if (!jobIds.isEmpty()) { + jobRepository.deleteAllById(jobIds); + } + if (!companyIds.isEmpty()) { + companyRepository.deleteAllById(companyIds); + } + if (!userIds.isEmpty()) { + userRepository.deleteAllById(userIds); + } + jobIds.clear(); + companyIds.clear(); + userIds.clear(); + } + + // ── 夹具 ──────────────────────────────────────────────────── + + private Long createCompany(String label) { + Long ownerId = userRepository.save(User.builder() + .phone("18" + String.format("%09d", SEQ.incrementAndGet())) + .nickname(tag + "-" + label) + .role(User.Role.COMPANY) + .roles(Set.of(User.Role.COMPANY)) + .active(true).verified(true).build()).getId(); + userIds.add(ownerId); + Long id = companyRepository.save(Company.builder() + .ownerUserId(ownerId).name(tag + "公司" + label).verified(true).build()).getId(); + companyIds.add(id); + return id; + } + + private Long job(Long companyId, String title, String description, String requirements, + String city, String employmentType, Integer salaryMin, Integer salaryMax, String status) { + Long id = jobRepository.save(Job.builder() + .companyId(companyId) + .title(title) + .description(description) + .requirements(requirements) + .city(city) + .employmentType(employmentType) + .salaryMin(salaryMin) + .salaryMax(salaryMax) + .status(status) + .build()).getId(); + jobIds.add(id); + return id; + } + + private Long publishedJob(Long companyId, String title, String description, String requirements, + String city, String employmentType, Integer salaryMin, Integer salaryMax) { + return job(companyId, title, description, requirements, city, employmentType, + salaryMin, salaryMax, JobStatus.PUBLISHED.name()); + } + + /** + * 回写 createdAt：实体的 {@code @CreatedDate} 审计会在持久化时覆盖显式值， + * 排序用例需要精确时间，因此用原生 SQL 回写（不经过审计）。 + */ + private void setCreatedAt(Long jobId, LocalDateTime createdAt) { + jdbcTemplate.update("UPDATE jobs SET created_at = ? WHERE id = ?", createdAt, jobId); + } + + /** 与服务一致的 latest 排序：createdAt DESC, id DESC。 */ + private Pageable latest( int size) { + return PageRequest.of(0, size, + Sort.by(new Sort.Order(Sort.Direction.DESC, "createdAt"), + new Sort.Order(Sort.Direction.DESC, "id"))); + } + + private List searchIds(String keyword, String city, String employmentType, + Integer salaryMin, Integer salaryMax, Long companyId) { + return jobRepository.findAll( + JobSearchSpecification.searchJobs(keyword, city, employmentType, salaryMin, salaryMax, companyId), + latest(MAX_RESULTS)) + .getContent().stream().map(Job::getId).toList(); + } + + // ── keyword：三个字段 ─────────────────────────────────────── + + @Test + void keywordMatchesTitle() { + String city = tag + "CITY_TITLE"; + Long inTitle = publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 其余两个字段均不含 "Java"，确保命中的是 title + publishedJob(companyA, "无关岗位", "无关描述", "无关要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds("Java", city, null, null, null, null)).containsExactly(inTitle); + } + + @Test + void keywordMatchesDescription() { + String city = tag + "CITY_DESC"; + Long inDesc = publishedJob(companyA, "岗位", tag + "负责Java后端开发", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "无关描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds("Java", city, null, null, null, null)).containsExactly(inDesc); + } + + @Test + void keywordMatchesRequirements() { + String city = tag + "CITY_REQ"; + Long inReq = publishedJob(companyA, "岗位", "描述", tag + "熟悉Java", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "描述", "无关要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds("Java", city, null, null, null, null)).containsExactly(inReq); + } + + @Test + void keywordIsCaseInsensitive() { + String city = tag + "CITY_CASE"; + Long lower = publishedJob(companyA, tag + "java开发", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long upper = publishedJob(companyA, tag + "JAVA开发", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds("java", city, null, null, null, null)) + .containsExactlyInAnyOrder(lower, upper); + assertThat(searchIds("JaVa", city, null, null, null, null)) + .containsExactlyInAnyOrder(lower, upper); + } + + @Test + void nullBlankAndWhitespaceKeywordDoNotFilter() { + String city = tag + "CITY_NOKW"; + Long a = publishedJob(companyA, tag + "甲岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long b = publishedJob(companyA, tag + "乙岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + for (String blank : new String[]{null, "", " ", " ", "\t"}) { + assertThat(searchIds(blank, city, null, null, null, null)) + .as("blank keyword 不应参与过滤：" + blank) + .containsExactlyInAnyOrder(a, b); + } + } + + @Test + void keywordIsTrimmed() { + String city = tag + "CITY_TRIM"; + Long target = publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds(" Java ", city, null, null, null, null)).containsExactly(target); + } + + // ── city / employmentType / companyId ────────────────────── + + @Test + void cityUsesTrimmedExactMatch() { + String city = tag + "CITY_EXACT"; + Long target = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "描述", "要求", city + "别处", "FULL_TIME", 10000, 20000); + + // 精确匹配：前缀相同但不同的城市不得命中 + assertThat(searchIds(null, city, null, null, null, null)).containsExactly(target); + // trim 后精确匹配 + assertThat(searchIds(null, " " + city + " ", null, null, null, null)).containsExactly(target); + } + + @Test + void cityCaseVariantHasSameResultAcrossDatabases() { + String city = tag + "-Beijing"; + Long target = publishedJob(companyA, "岗位", "描述", "要求", city, + "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city.toLowerCase(), null, null, null, null)) + .containsExactly(target); + assertThat(searchIds(null, " " + city.toLowerCase() + " ", null, null, null, null)) + .containsExactly(target); + } + + @Test + void employmentTypeUsesTrimmedExactMatch() { + String city = tag + "CITY_ET"; + Long full = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "描述", "要求", city, "PART_TIME", 10000, 20000); + + assertThat(searchIds(null, city, "FULL_TIME", null, null, null)).containsExactly(full); + assertThat(searchIds(null, city, " FULL_TIME ", null, null, null)).containsExactly(full); + // 精确匹配：不得做前缀匹配 + assertThat(searchIds(null, city, "FULL", null, null, null)).isEmpty(); + } + + @Test + void employmentTypeCaseVariantHasSameResultAcrossDatabases() { + String city = tag + "CITY_EMP_CASE"; + Long target = publishedJob(companyA, "岗位", "描述", "要求", city, + "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city, "full_time", null, null, null)).containsExactly(target); + assertThat(searchIds(null, city, " full_time ", null, null, null)).containsExactly(target); + } + + @Test + void companyIdFiltersExactly() { + String city = tag + "CITY_COMPANY"; + Long mine = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyB, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city, null, null, null, companyA)).containsExactly(mine); + } + + // ── 薪资：区间重叠语义 ────────────────────────────────────── + + @Test + void salaryMinMatchesWhenJobMaximumEqualsBoundary() { + String city = tag + "CITY_SMIN"; + // 岗位 salaryMax 恰好等于用户 salaryMin + Long boundary = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 19999); + + assertThat(searchIds(null, city, null, 20000, null, null)).containsExactly(boundary); + } + + @Test + void salaryMaxMatchesWhenJobMinimumEqualsBoundary() { + String city = tag + "CITY_SMAX"; + // 岗位 salaryMin 恰好等于用户 salaryMax + Long boundary = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10001, 20000); + + assertThat(searchIds(null, city, null, null, 10000, null)).containsExactly(boundary); + } + + @Test + void salaryRangesUseOverlapSemantics() { + String city = tag + "CITY_OVERLAP"; + // 岗位区间 [10k,20k] 与用户区间 [15k,25k] 部分重叠 —— 必须命中 + Long overlapping = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 岗位区间完全包含用户区间 —— 必须命中 + Long containing = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 12000, 30000); + + assertThat(searchIds(null, city, null, 15000, 25000, null)) + .containsExactlyInAnyOrder(overlapping, containing); + } + + @Test + void nonOverlappingSalaryRangeIsExcluded() { + String city = tag + "CITY_NOOVERLAP"; + Long tooLow = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 5000, 9000); + Long inRange = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 15000, 25000); + Long tooHigh = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 40000, 60000); + + assertThat(searchIds(null, city, null, 10000, 30000, null)) + .as("只有区间重叠的岗位命中") + .containsExactly(inRange); + } + + @Test + void nullSalaryFieldsFollowExistingContract() { + String city = tag + "CITY_NULLSAL"; + Long bothNull = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", null, null); + Long onlyMin = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, null); + Long both = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + // 不加薪资条件时，NULL 薪资岗位必须照常返回 + assertThat(searchIds(null, city, null, null, null, null)) + .containsExactlyInAnyOrder(bothNull, onlyMin, both); + + // 加了 salaryMin 条件后：`job.salaryMax >= 5000` 对 NULL 求值为 UNKNOWN， + // 因此 salaryMax 为 NULL 的两个岗位都被排除，只余 salaryMax 非空且达标的岗位。 + // 这是 SQL 三值逻辑的既有契约，Q01 锁定该行为、不做修改。 + assertThat(searchIds(null, city, null, 5000, null, null)).containsExactly(both); + } + + // ── 多条件 AND / 状态 ─────────────────────────────────────── + + @Test + void multipleConditionsUseAndSemantics() { + String city = tag + "CITY_AND"; + Long match = publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 关键词命中但城市不符 + publishedJob(companyA, tag + "Java工程师", "描述", "要求", city + "X", "FULL_TIME", 10000, 20000); + // 城市命中但用工类型不符 + publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "PART_TIME", 10000, 20000); + // 公司不符 + publishedJob(companyB, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 薪资不重叠 + publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 90000, 99000); + + assertThat(searchIds("Java", city, "FULL_TIME", 15000, 25000, companyA)).containsExactly(match); + } + + @Test + void nonPublishedJobsAreAlwaysExcluded() { + String city = tag + "CITY_STATUS"; + Long published = publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + job(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000, JobStatus.DRAFT.name()); + job(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000, JobStatus.CLOSED.name()); + + assertThat(searchIds(null, city, null, null, null, null)).containsExactly(published); + // 即使显式按公司过滤，非公开岗位也不得出现 + assertThat(searchIds(null, city, null, null, null, companyA)).containsExactly(published); + } + + // ── 特殊字符 / 分页 / 空结果 ──────────────────────────────── + + @Test + void specialLikeCharactersFollowExistingContract() { + String city = tag + "CITY_LIKE"; + Long plain = publishedJob(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long percent = publishedJob(companyA, tag + "100%远程", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long underscore = publishedJob(companyA, tag + "A_B岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + // 锁定当前契约：keyword 直接拼进 LIKE，% 与 _ 仍作通配符（未转义）。 + // 这是既有行为，Q01 不改语义，仅在真实库上固定它。 + assertThat(searchIds("%", city, null, null, null, null)) + .as("% 作为通配符：命中该城市下全部带标题的岗位") + .containsExactlyInAnyOrder(plain, percent, underscore); + assertThat(searchIds("_", city, null, null, null, null)) + .as("_ 作为单字符通配符：命中标题含任意单字符的岗位") + .containsExactlyInAnyOrder(plain, percent, underscore); + assertThat(searchIds("A_B", city, null, null, null, null)) + .as("A_B 以通配符解释，可命中 A_B 本身") + .containsExactly(underscore); + assertThat(searchIds("Java", city, null, null, null, null)).containsExactly(plain); + } + + @Test + void paginationReturnsStableOrderedIds() { + String city = tag + "CITY_PAGE"; + LocalDateTime base = LocalDateTime.of(2026, 1, 1, 0, 0); + List ids = new ArrayList<>(); + for (int i = 0; i < 5; i++) { + Long id = publishedJob(companyA, "岗位" + i, "描述", "要求", city, "FULL_TIME", 10000, 20000); + setCreatedAt(id, base.plusDays(i)); // 越大越新 + ids.add(id); + } + // 期望顺序：createdAt DESC（越新越前） + List expected = new ArrayList<>(ids); + java.util.Collections.reverse(expected); + + Pageable first = PageRequest.of(0, 2, + Sort.by(new Sort.Order(Sort.Direction.DESC, "createdAt"), new Sort.Order(Sort.Direction.DESC, "id"))); + Pageable second = PageRequest.of(1, 2, + Sort.by(new Sort.Order(Sort.Direction.DESC, "createdAt"), new Sort.Order(Sort.Direction.DESC, "id"))); + + var spec = JobSearchSpecification.searchJobs(null, city, null, null, null, null); + var page0 = jobRepository.findAll(spec, first); + var page1 = jobRepository.findAll(spec, second); + + assertThat(page0.getContent().stream().map(Job::getId).toList()) + .as("第 0 页按 createdAt DESC 稳定排序").containsExactlyElementsOf(expected.subList(0, 2)); + assertThat(page1.getContent().stream().map(Job::getId).toList()) + .as("第 1 页继续按同一顺序，不重复不丢行").containsExactlyElementsOf(expected.subList(2, 4)); + assertThat(page0.getTotalElements()).as("total 为全部匹配行数").isEqualTo(5); + assertThat(page0.getTotalPages()).isEqualTo(3); + } + + @Test + void noResultReturnsEmptyPage() { + String city = tag + "CITY_EMPTY"; + publishedJob(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + var spec = JobSearchSpecification.searchJobs(tag + "不存在的关键词XYZ", city, null, null, null, null); + var page = jobRepository.findAll(spec, latest(MAX_RESULTS)); + + assertThat(page.getContent()).isEmpty(); + assertThat(page.getTotalElements()).isZero(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationMySqlIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationMySqlIntegrationTest.java new file mode 100644 index 0000000..4657999 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/JobSearchSpecificationMySqlIntegrationTest.java @@ -0,0 +1,384 @@ +package com.mydreamjob.job; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Pageable; +import org.springframework.data.domain.Sort; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.annotation.DirtiesContext; +import org.testcontainers.containers.MySQLContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Q01：{@link JobSearchSpecification} 在**真实 MySQL 8** 上的行为对账。 + * + *

    使用 Testcontainers 启动独立 MySQL（不复用开发库），执行正式 Flyway 迁移并以 + * {@code ddl-auto=validate} 启动，重点对账 H2 难以覆盖的差异：大小写比较规则、 + * LIKE 特殊字符、NULL 排序、边界比较与分页稳定性。

    + * + *

    不打印任何数据库凭据。Docker 不可用时环境性跳过（{@code disabledWithoutDocker}）， + * 但独立验收必须显式运行本类并得到 Tests run > 0、Skipped = 0。

    + */ +@Testcontainers(disabledWithoutDocker = true) +@SpringBootTest +@ActiveProfiles("mysql-it") +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) +class JobSearchSpecificationMySqlIntegrationTest { + + private static final AtomicLong SEQ = new AtomicLong(73000); + private static final int MAX_RESULTS = 50; + + @Container + static final MySQLContainer MYSQL = new MySQLContainer<>("mysql:8.4") + .withDatabaseName("mydreamjob_q01") + .withUsername("q01") + .withPassword("q01-test-only"); + + /** + * 连接参数全部来自容器，运行期注入，不落盘、不打印密码。 + * 应用级测试开关与测试密钥由 {@code mysql-it} profile 提供（见 + * {@code src/test/resources/application-mysql-it.yml}），方言沿用主配置的 MySQLDialect。 + */ + @DynamicPropertySource + static void datasource(DynamicPropertyRegistry registry) { + registry.add("spring.datasource.url", MYSQL::getJdbcUrl); + registry.add("spring.datasource.username", MYSQL::getUsername); + registry.add("spring.datasource.password", MYSQL::getPassword); + registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate"); + } + + @MockBean + private RedisTemplate redisTemplate; + + @Autowired private JobRepository jobRepository; + @Autowired private JobService jobService; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + + private final List jobIds = new ArrayList<>(); + private final List companyIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + + private String tag; + private Long companyA; + private Long companyB; + + @BeforeEach + void setUp() { + tag = "Q01M" + SEQ.incrementAndGet(); + companyA = createCompany("甲"); + companyB = createCompany("乙"); + } + + @AfterEach + void tearDown() { + if (!jobIds.isEmpty()) { + jobRepository.deleteAllById(jobIds); + } + if (!companyIds.isEmpty()) { + companyRepository.deleteAllById(companyIds); + } + if (!userIds.isEmpty()) { + userRepository.deleteAllById(userIds); + } + jobIds.clear(); + companyIds.clear(); + userIds.clear(); + } + + private Long createCompany(String label) { + Long ownerId = userRepository.save(User.builder() + .phone("17" + String.format("%09d", SEQ.incrementAndGet())) + .nickname(tag + "-" + label) + .role(User.Role.COMPANY) + .roles(Set.of(User.Role.COMPANY)) + .active(true).verified(true).build()).getId(); + userIds.add(ownerId); + Long id = companyRepository.save(Company.builder() + .ownerUserId(ownerId).name(tag + "公司" + label).verified(true).build()).getId(); + companyIds.add(id); + return id; + } + + private Long job(Long companyId, String title, String description, String requirements, + String city, String employmentType, Integer salaryMin, Integer salaryMax, String status) { + Long id = jobRepository.save(Job.builder() + .companyId(companyId).title(title).description(description).requirements(requirements) + .city(city).employmentType(employmentType).salaryMin(salaryMin).salaryMax(salaryMax) + .status(status).build()).getId(); + jobIds.add(id); + return id; + } + + private Long published(Long companyId, String title, String description, String requirements, + String city, String employmentType, Integer salaryMin, Integer salaryMax) { + return job(companyId, title, description, requirements, city, employmentType, + salaryMin, salaryMax, JobStatus.PUBLISHED.name()); + } + + private void setCreatedAt(Long jobId, LocalDateTime createdAt) { + jdbcTemplate.update("UPDATE jobs SET created_at = ? WHERE id = ?", createdAt, jobId); + } + + private Pageable latestSorted() { + return PageRequest.of(0, MAX_RESULTS, + Sort.by(new Sort.Order(Sort.Direction.DESC, "createdAt"), + new Sort.Order(Sort.Direction.DESC, "id"))); + } + + private List searchIds(String keyword, String city, String employmentType, + Integer salaryMin, Integer salaryMax, Long companyId) { + return jobRepository.findAll( + JobSearchSpecification.searchJobs(keyword, city, employmentType, salaryMin, salaryMax, companyId), + latestSorted()) + .getContent().stream().map(Job::getId).toList(); + } + + // ── 与 H2 逐项对账的场景 ──────────────────────────────────── + + @Test + void keywordCaseInsensitiveMatchesThreeFields() { + String city = tag + "MYSQL_KW"; + Long inTitle = published(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long inDesc = published(companyA, "岗位", tag + "负责Java开发", "要求", city, "FULL_TIME", 10000, 20000); + Long inReq = published(companyA, "岗位", "描述", tag + "熟悉JAVA", city, "FULL_TIME", 10000, 20000); + published(companyA, "无关岗位", "无关描述", "无关要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds("java", city, null, null, null, null)) + .as("MySQL 下大小写不敏感且覆盖三字段") + .containsExactlyInAnyOrder(inTitle, inDesc, inReq); + assertThat(searchIds("JaVa", city, null, null, null, null)) + .containsExactlyInAnyOrder(inTitle, inDesc, inReq); + } + + @Test + void nullBlankAndWhitespaceKeywordDoNotFilter() { + String city = tag + "MYSQL_NOKW"; + Long a = published(companyA, tag + "甲岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long b = published(companyA, tag + "乙岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + for (String blank : new String[]{null, "", " ", " ", "\t"}) { + assertThat(searchIds(blank, city, null, null, null, null)) + .as("blank keyword 不应参与过滤：" + blank) + .containsExactlyInAnyOrder(a, b); + } + } + + @Test + void keywordIsTrimmed() { + String city = tag + "MYSQL_TRIM"; + Long target = published(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds(" Java ", city, null, null, null, null)).containsExactly(target); + } + + @Test + void specialLikeCharactersFollowExistingContract() { + String city = tag + "MYSQL_LIKE"; + Long plain = published(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long percent = published(companyA, tag + "100%远程", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long underscore = published(companyA, tag + "A_B岗", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + // 锁定既有契约：% 与 _ 未转义，仍作 LIKE 通配符 —— MySQL 与 H2 行为一致。 + assertThat(searchIds("%", city, null, null, null, null)) + .containsExactlyInAnyOrder(plain, percent, underscore); + assertThat(searchIds("_", city, null, null, null, null)) + .containsExactlyInAnyOrder(plain, percent, underscore); + assertThat(searchIds("A_B", city, null, null, null, null)).containsExactly(underscore); + } + + @Test + void cityAndEmploymentTypeUseTrimmedExactMatch() { + String city = tag + "MYSQL_CITY"; + Long target = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long otherCity = published(companyA, "岗位", "描述", "要求", city + "别处", "FULL_TIME", 10000, 20000); + Long otherType = published(companyA, "岗位", "描述", "要求", city, "PART_TIME", 10000, 20000); + + // 只给 city 条件时，同城的其他用工类型同样必须返回（city 与 employmentType 是两个独立条件）； + // 前缀相同但不同的城市不得命中。 + assertThat(searchIds(null, city, null, null, null, null)) + .as("city 精确匹配：同城全部命中，前缀相同的 city+别处 不命中") + .containsExactly(otherType, target); + assertThat(searchIds(null, city, null, null, null, null)).doesNotContain(otherCity); + // 两个条件都给出时，trim 后各自精确匹配 + assertThat(searchIds(null, " " + city + " ", " FULL_TIME ", null, null, null)) + .containsExactly(target); + } + + @Test + void cityCaseVariantHasSameResultAcrossDatabases() { + String city = tag + "-Beijing"; + Long target = published(companyA, "岗位", "描述", "要求", city, + "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city.toLowerCase(), null, null, null, null)) + .containsExactly(target); + assertThat(searchIds(null, " " + city.toLowerCase() + " ", null, null, null, null)) + .containsExactly(target); + } + + @Test + void employmentTypeCaseVariantHasSameResultAcrossDatabases() { + String city = tag + "MYSQL_EMP_CASE"; + Long target = published(companyA, "岗位", "描述", "要求", city, + "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city, "full_time", null, null, null)).containsExactly(target); + assertThat(searchIds(null, city, " full_time ", null, null, null)).containsExactly(target); + } + + @Test + void salaryBoundariesUseOverlapSemantics() { + String city = tag + "MYSQL_SALARY"; + Long boundary = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long noOverlapLow = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 5000, 9000); + Long noOverlapHigh = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 40000, 60000); + + // 契约是**单边**比较：salaryMin 只约束「岗位 salaryMax >= 用户 salaryMin」， + // 因此边界相等必须命中，salaryMax 更高的岗位同样命中，低于边界的才被排除。 + assertThat(searchIds(null, city, null, 20000, null, null)) + .as("岗位 salaryMax >= 20000：边界 20000 与 60000 命中，9000 排除") + .containsExactly(noOverlapHigh, boundary); + assertThat(searchIds(null, city, null, null, 10000, null)) + .as("岗位 salaryMin <= 10000：边界 10000 与 5000 命中，40000 排除") + .containsExactly(noOverlapLow, boundary); + // 两端都给出时按区间重叠：部分重叠命中 + assertThat(searchIds(null, city, null, 15000, 25000, null)).containsExactly(boundary); + // 区间不重叠（高于用户区间 / 低于用户区间）必须排除 + assertThat(searchIds(null, city, null, 30000, 35000, null)).isEmpty(); + assertThat(searchIds(null, city, null, 1000, 4000, null)).isEmpty(); + } + + @Test + void nullSalaryFieldsFollowExistingContract() { + String city = tag + "MYSQL_NULLSAL"; + Long bothNull = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", null, null); + Long onlyMin = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, null); + Long both = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + // 不加薪资条件时，NULL 薪资岗位照常返回 + assertThat(searchIds(null, city, null, null, null, null)) + .containsExactlyInAnyOrder(bothNull, onlyMin, both); + + // 一旦给出 salaryMin，`job.salaryMax >= ?` 对 NULL 求值为 UNKNOWN， + // salaryMax 为 NULL 的两个岗位被排除 —— SQL 三值逻辑的既有契约，Q01 锁定不改。 + assertThat(searchIds(null, city, null, 5000, null, null)).containsExactly(both); + } + + @Test + void multipleConditionsUseAndSemantics() { + String city = tag + "MYSQL_AND"; + Long match = published(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 关键词命中但城市不符 + published(companyA, tag + "Java工程师", "描述", "要求", city + "X", "FULL_TIME", 10000, 20000); + // 城市命中但用工类型不符 + published(companyA, tag + "Java工程师", "描述", "要求", city, "PART_TIME", 10000, 20000); + // 公司不符 + published(companyB, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 10000, 20000); + // 薪资不重叠 + published(companyA, tag + "Java工程师", "描述", "要求", city, "FULL_TIME", 90000, 99000); + + assertThat(searchIds("Java", city, "FULL_TIME", 15000, 25000, companyA)).containsExactly(match); + } + + @Test + void nonPublishedJobsAreAlwaysExcluded() { + String city = tag + "MYSQL_STATUS"; + Long published = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + job(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000, JobStatus.DRAFT.name()); + job(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000, JobStatus.CLOSED.name()); + + assertThat(searchIds(null, city, null, null, null, null)).containsExactly(published); + assertThat(searchIds(null, city, null, null, null, companyA)).containsExactly(published); + } + + @Test + void latestOrderAndPaginationAreStable() { + String city = tag + "MYSQL_PAGE"; + LocalDateTime base = LocalDateTime.of(2026, 3, 1, 0, 0); + List ids = new ArrayList<>(); + for (int i = 0; i < 5; i++) { + Long id = published(companyA, "岗位" + i, "描述", "要求", city, "FULL_TIME", 10000, 20000); + setCreatedAt(id, base.plusDays(i)); + ids.add(id); + } + List expected = new ArrayList<>(ids); + java.util.Collections.reverse(expected); + + var spec = JobSearchSpecification.searchJobs(null, city, null, null, null, null); + Pageable first = PageRequest.of(0, 2, latestSorted().getSort()); + Pageable second = PageRequest.of(1, 2, latestSorted().getSort()); + + var p0 = jobRepository.findAll(spec, first); + var p1 = jobRepository.findAll(spec, second); + + assertThat(p0.getContent().stream().map(Job::getId).toList()) + .containsExactlyElementsOf(expected.subList(0, 2)); + assertThat(p1.getContent().stream().map(Job::getId).toList()) + .containsExactlyElementsOf(expected.subList(2, 4)); + assertThat(p0.getTotalElements()).isEqualTo(5); + assertThat(p0.getTotalPages()).isEqualTo(3); + } + + @Test + void salarySortNullLastIsConsistentWithH2() { + String city = tag + "MYSQL_NULLLAST"; + Long high = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 30000); + Long mid = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + Long nullMax = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, null); + + // 通过 Service 的 CASE WHEN 排序路径验证 NULL LAST + assertThat(idsViaSalarySort(city)).as("salaryMax DESC，NULL 最后") + .containsExactly(high, mid, nullMax); + } + + /** 直接调用 Service 的 salary 排序路径（真实 EntityManager + CASE WHEN）。 */ + private List idsViaSalarySort(String city) { + return jobService.searchJobs(null, city, null, null, null, null, "salary", 0, MAX_RESULTS) + .getContent().stream().map(com.mydreamjob.job.dto.JobSearchItem::getId).toList(); + } + + @Test + void companyIdFiltersExactly() { + String city = tag + "MYSQL_COMPANY"; + Long mine = published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + published(companyB, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + assertThat(searchIds(null, city, null, null, null, companyA)).containsExactly(mine); + } + + @Test + void noResultReturnsEmptyPage() { + String city = tag + "MYSQL_EMPTY"; + published(companyA, "岗位", "描述", "要求", city, "FULL_TIME", 10000, 20000); + + var page = jobRepository.findAll( + JobSearchSpecification.searchJobs(tag + "不存在XYZ", city, null, null, null, null), + latestSorted()); + assertThat(page.getContent()).isEmpty(); + assertThat(page.getTotalElements()).isZero(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/job/Q01SqlRecorder.java b/mydreamjob-server/src/test/java/com/mydreamjob/job/Q01SqlRecorder.java new file mode 100644 index 0000000..aa3a6a0 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/job/Q01SqlRecorder.java @@ -0,0 +1,34 @@ +package com.mydreamjob.job; + +import org.hibernate.resource.jdbc.spi.StatementInspector; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +/** + * Q01 EXPLAIN 证据用：记录 Hibernate 实际执行过的 SQL。 + * + *

    通过 {@code hibernate.session_factory.statement_inspector} 注册（仅 MySQL EXPLAIN + * 用例使用），用来在报告中留下**真实生成**的 SQL 原文，而不是只留一份手写的等价 SQL。

    + */ +public class Q01SqlRecorder implements StatementInspector { + + private static final List STATEMENTS = Collections.synchronizedList(new ArrayList<>()); + + @Override + public String inspect(String sql) { + STATEMENTS.add(sql); + return sql; + } + + static void clear() { + STATEMENTS.clear(); + } + + static List drain() { + List copy = new ArrayList<>(STATEMENTS); + STATEMENTS.clear(); + return copy; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/match/MatchServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/match/MatchServiceTest.java index e29fcd2..4b957be 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/match/MatchServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/match/MatchServiceTest.java @@ -3,6 +3,8 @@ package com.mydreamjob.match; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.job.Job; @@ -34,6 +36,9 @@ class MatchServiceTest { @Mock private StudentProfileRepository profileRepository; @Mock private AuditService auditService; @Mock private UserRepository userRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private MatchService matchService; private static final Long STUDENT_ID = 100L; @@ -45,6 +50,9 @@ class MatchServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + publishedJob = Job.builder().id(JOB_ID).companyId(1L).title("Java 后端") .city("杭州").employmentType("FULL_TIME") .salaryMax(20000).status("PUBLISHED").build(); diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageListQueryBudgetIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageListQueryBudgetIntegrationTest.java new file mode 100644 index 0000000..4cbb58d --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageListQueryBudgetIntegrationTest.java @@ -0,0 +1,285 @@ +package com.mydreamjob.messaging; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.messaging.dto.MessagePageResponse; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Import; +import org.springframework.context.annotation.Primary; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.jdbc.datasource.AbstractDataSource; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import javax.sql.DataSource; +import java.lang.reflect.Proxy; +import java.sql.Connection; +import java.sql.Statement; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicInteger; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 真实 MessagingService + Repository 的消息列表查询预算证据。 + * 只统计夹具准备完成后 listMessages 的 JDBC 查询，不以 Mockito verify 替代 SQL 计数。 + */ +@SpringBootTest +@ActiveProfiles("integration-test") +@Import(MessageListQueryBudgetIntegrationTest.CountingDataSourceConfiguration.class) +class MessageListQueryBudgetIntegrationTest { + + @Autowired private MessagingService messagingService; + @Autowired private UserRepository userRepository; + @Autowired private ConversationRepository conversationRepository; + @Autowired private ConversationMemberRepository memberRepository; + @Autowired private MessageRepository messageRepository; + @Autowired private MessageReadRepository readRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private CountingDataSource countingDataSource; + @MockBean private RedisTemplate redisTemplate; + + private final List userIds = new ArrayList<>(); + private final List conversationIds = new ArrayList<>(); + + @AfterEach + void cleanup() { + if (!conversationIds.isEmpty()) { + String marks = placeholders(conversationIds.size()); + jdbcTemplate.update("DELETE FROM message_reads WHERE message_id IN " + + "(SELECT id FROM messages WHERE conversation_id IN (" + marks + "))", + conversationIds.toArray()); + jdbcTemplate.update("DELETE FROM messages WHERE conversation_id IN (" + marks + ")", + conversationIds.toArray()); + jdbcTemplate.update("DELETE FROM conversation_members WHERE conversation_id IN (" + marks + ")", + conversationIds.toArray()); + jdbcTemplate.update("DELETE FROM conversations WHERE id IN (" + marks + ")", + conversationIds.toArray()); + } + if (!userIds.isEmpty()) { + String marks = placeholders(userIds.size()); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (" + marks + ")", userIds.toArray()); + jdbcTemplate.update("DELETE FROM users WHERE id IN (" + marks + ")", userIds.toArray()); + } + userIds.clear(); + conversationIds.clear(); + } + + @Test + void listMessagesUsesFixedBatchQueriesForOneTwentyAndFiftyMessages() { + List measuredStatements = new ArrayList<>(); + for (int count : List.of(1, 20, 50)) { + long sender = user("budget-sender-" + count); + long receiver = user("budget-receiver-" + count); + long conversation = conversation(sender, receiver, count % 2 == 0 ? "TALENT_INVITATION" : "DIRECT"); + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + List messages = new ArrayList<>(); + for (int i = 0; i < count; i++) { + boolean recalled = i % 7 == 0; + messages.add(Message.builder() + .conversationId(conversation) + .senderUserId(sender) + .content(recalled ? MessageViewMapper.RECALLED_PLACEHOLDER : "budget-body-" + i) + .status(recalled ? "RECALLED" : "SENT") + .version(recalled ? 1L : 0L) + .recalledAt(recalled ? created.plusSeconds(i) : null) + .createdAt(created.plusSeconds(i)) + .build()); + } + messageRepository.saveAllAndFlush(messages); + + countingDataSource.reset(); + MessagePageResponse response = messagingService.listMessages(conversation, receiver, 0, 50); + int statements = countingDataSource.messageStatements(); + measuredStatements.add(statements); + assertTrue(statements <= 5, + "message list must stay within the fixed conversation/member/page/read budget (count=" + count + ")"); + assertEquals(count, response.getItems().size()); + assertEquals(count, response.getTotal()); + assertTrue(response.getItems().stream().allMatch(item -> item.getConversationId().equals(conversation))); + assertFalse(response.getItems().stream().anyMatch(item -> item.getContent() != null + && item.getContent().startsWith("budget-body-") + && item.getStatus().equals("RECALLED")), + "recalled messages must expose only the placeholder"); + } + assertTrue(measuredStatements.stream().max(Integer::compareTo).orElse(0) + - measuredStatements.stream().min(Integer::compareTo).orElse(0) <= 1, + "pagination count query optimization may add one statement, but must not scale with item count: " + + measuredStatements); + } + + @Test + void listConversationsUsesFixedQueriesForOneTwentyAndFiftyConversations() { + List measuredStatements = new ArrayList<>(); + for (int count : List.of(1, 20, 50)) { + long reader = user("conversation-reader-" + count); + for (int i = 0; i < count; i++) { + long sender = user("conversation-sender-" + count + "-" + i); + long conversation = conversation(sender, reader, i % 2 == 0 ? "DIRECT" : "TALENT_INVITATION"); + Message unread = messageRepository.save(Message.builder() + .conversationId(conversation).senderUserId(sender).content("unread") + .status("SENT").version(0L).build()); + Message read = messageRepository.save(Message.builder() + .conversationId(conversation).senderUserId(sender).content("read") + .status("SENT").version(0L).build()); + messageRepository.save(Message.builder() + .conversationId(conversation).senderUserId(sender) + .content(MessageViewMapper.RECALLED_PLACEHOLDER) + .status("RECALLED").version(1L).recalledAt(LocalDateTime.now()).build()); + readRepository.save(MessageRead.builder().messageId(read.getId()).readerUserId(reader).build()); + assertTrue(unread.getId() > 0); + } + messageRepository.flush(); + readRepository.flush(); + + countingDataSource.reset(); + List> response = messagingService.listConversations(reader); + int statements = countingDataSource.messageStatements(); + measuredStatements.add(statements); + + assertEquals(count, response.size()); + assertTrue(response.stream().allMatch(item -> Long.valueOf(1L).equals(item.get("unreadCount"))), + "only the unread SENT message must be counted"); + assertTrue(statements <= 3, + "membership, conversations and grouped unread count must be the only query budget: " + + statements); + } + assertEquals(1, measuredStatements.stream().distinct().count(), + "conversation query count must not grow with conversation count: " + measuredStatements); + } + + @Test + void groupedUnreadCountKeepsHistoricalLatestFiveHundredWindow() { + long reader = user("window-reader"); + long sender = user("window-sender"); + long conversation = conversation(sender, reader, "DIRECT"); + LocalDateTime base = LocalDateTime.of(2026, 9, 16, 8, 0); + List messages = new ArrayList<>(); + for (int i = 0; i < 501; i++) { + boolean countedSent = i == 0 || i == 500; + messages.add(Message.builder() + .conversationId(conversation).senderUserId(sender) + .content(countedSent ? "sent" : MessageViewMapper.RECALLED_PLACEHOLDER) + .status(countedSent ? "SENT" : "RECALLED") + .version(countedSent ? 0L : 1L) + .recalledAt(countedSent ? null : base.plusSeconds(i)) + .createdAt(base.plusSeconds(i)).build()); + } + List saved = messageRepository.saveAllAndFlush(messages); + for (int i = 0; i < saved.size(); i++) { + jdbcTemplate.update("UPDATE messages SET created_at=? WHERE id=?", + java.sql.Timestamp.valueOf(base.plusSeconds(i)), saved.get(i).getId()); + } + + List> response = messagingService.listConversations(reader); + + assertEquals(1, response.size()); + assertEquals(1L, response.get(0).get("unreadCount"), + "oldest SENT message is outside the historical latest-500 window"); + } + + private long user(String nickname) { + User saved = userRepository.saveAndFlush(User.builder() + .phone("139" + Math.abs(System.nanoTime() % 1_000_000_000L)) + .nickname(nickname).role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)) + .active(true).verified(true).build()); + userIds.add(saved.getId()); + return saved.getId(); + } + + private long conversation(long sender, long receiver, String type) { + Conversation saved = conversationRepository.saveAndFlush(Conversation.builder() + .type(type).createdBy(sender).title("N07 query budget").build()); + conversationIds.add(saved.getId()); + memberRepository.save(ConversationMember.builder().conversationId(saved.getId()).userId(sender).build()); + memberRepository.saveAndFlush(ConversationMember.builder().conversationId(saved.getId()).userId(receiver).build()); + return saved.getId(); + } + + private static String placeholders(int size) { + return String.join(",", java.util.Collections.nCopies(size, "?")); + } + + @TestConfiguration + static class CountingDataSourceConfiguration { + @Bean + @Primary + CountingDataSource dataSource(DataSourceProperties properties) { + return new CountingDataSource(properties.initializeDataSourceBuilder().build()); + } + } + + static final class CountingDataSource extends AbstractDataSource { + private final DataSource delegate; + private final AtomicInteger messageStatements = new AtomicInteger(); + + CountingDataSource(DataSource delegate) { + this.delegate = delegate; + } + + void reset() { + messageStatements.set(0); + } + + int messageStatements() { + return messageStatements.get(); + } + + @Override + public Connection getConnection() throws java.sql.SQLException { + return wrap(delegate.getConnection()); + } + + @Override + public Connection getConnection(String username, String password) throws java.sql.SQLException { + return wrap(delegate.getConnection(username, password)); + } + + private Connection wrap(Connection connection) { + return (Connection) Proxy.newProxyInstance(Connection.class.getClassLoader(), + new Class[]{Connection.class}, (proxy, method, args) -> { + Object value = method.invoke(connection, args); + if (value instanceof Statement statement) { + String sql = args != null && args.length > 0 && args[0] instanceof String s ? s : ""; + return wrapStatement(statement, sql); + } + return value; + }); + } + + private Object wrapStatement(Statement statement, String preparedSql) { + Class iface = statement instanceof java.sql.PreparedStatement + ? java.sql.PreparedStatement.class : Statement.class; + return Proxy.newProxyInstance(iface.getClassLoader(), new Class[]{iface}, + (proxy, method, args) -> { + String sql = preparedSql; + if (sql.isBlank() && args != null && args.length > 0 && args[0] instanceof String s) sql = s; + if (method.getName().startsWith("execute") && isMessageQuery(sql)) { + messageStatements.incrementAndGet(); + } + return method.invoke(statement, args); + }); + } + + private boolean isMessageQuery(String sql) { + String normalized = sql.toLowerCase(java.util.Locale.ROOT); + return normalized.contains(" from conversations") + || normalized.contains(" from conversation_members") + || normalized.contains(" from messages") + || normalized.contains(" from message_reads") + || normalized.contains(" from message_reads"); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallConcurrencyIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallConcurrencyIntegrationTest.java new file mode 100644 index 0000000..2a58e1a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallConcurrencyIntegrationTest.java @@ -0,0 +1,174 @@ +package com.mydreamjob.messaging; + +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +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.messaging.dto.MessageResponse; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.support.TransactionTemplate; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.*; + +/** 真实事务竞争测试：不 Mock 撤回服务、仓库或审计。 */ +@SpringBootTest +@ActiveProfiles("integration-test") +class MessageRecallConcurrencyIntegrationTest { + + @Autowired private MessagingService messagingService; + @Autowired private UserRepository userRepository; + @Autowired private ConversationRepository conversationRepository; + @Autowired private ConversationMemberRepository memberRepository; + @Autowired private MessageRepository messageRepository; + @Autowired private AuditLogRepository auditLogRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private PlatformTransactionManager transactionManager; + @MockBean private RedisTemplate redisTemplate; + + private final List messages = new ArrayList<>(); + private Long conversation; + private Long sender; + private Long receiver; + + @AfterEach + void cleanup() { + if (!messages.isEmpty()) { + String marks = String.join(",", messages.stream().map(id -> "?").toList()); + jdbcTemplate.update("DELETE FROM audit_logs WHERE action='MESSAGE_RECALLED' AND entity_id IN (" + marks + ")", + messages.toArray()); + jdbcTemplate.update("DELETE FROM message_reads WHERE message_id IN (" + marks + ")", messages.toArray()); + jdbcTemplate.update("DELETE FROM messages WHERE id IN (" + marks + ")", messages.toArray()); + } + if (conversation != null) { + memberRepository.deleteAll(memberRepository.findByConversationId(conversation)); + conversationRepository.deleteById(conversation); + } + if (sender != null) userRepository.deleteById(sender); + if (receiver != null) userRepository.deleteById(receiver); + messages.clear(); + conversation = sender = receiver = null; + } + + private void fixture(int messageCount) { + sender = userRepository.save(user("concurrent-sender")).getId(); + receiver = userRepository.save(user("concurrent-receiver")).getId(); + conversation = conversationRepository.save(Conversation.builder().type("DIRECT").createdBy(sender).build()).getId(); + memberRepository.save(ConversationMember.builder().conversationId(conversation).userId(sender).build()); + memberRepository.save(ConversationMember.builder().conversationId(conversation).userId(receiver).build()); + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + for (int i = 0; i < messageCount; i++) { + Message saved = messageRepository.saveAndFlush(Message.builder() + .conversationId(conversation).senderUserId(sender) + .content("N07_CONCURRENT_ORIGINAL_" + i).status("SENT").version(0L) + .createdAt(created).build()); + jdbcTemplate.update("UPDATE messages SET created_at=? WHERE id=?", created, saved.getId()); + messages.add(saved.getId()); + } + } + + private User user(String name) { + return User.builder().phone("139" + Math.abs(System.nanoTime() % 1_000_000_000L)) + .nickname(name).role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)) + .active(true).verified(true).build(); + } + + private List runConcurrently(List messageIds) throws Exception { + ExecutorService pool = Executors.newFixedThreadPool(messageIds.size()); + CountDownLatch ready = new CountDownLatch(messageIds.size()); + CountDownLatch start = new CountDownLatch(1); + TransactionTemplate tx = new TransactionTemplate(transactionManager); + try { + List> futures = messageIds.stream().map(id -> pool.submit(() -> { + ready.countDown(); + assertTrue(start.await(5, TimeUnit.SECONDS)); + try { + MessageResponse response = tx.execute(status -> messagingService.recallMessage( + sender, conversation, id, null, LocalDateTime.of(2026, 9, 10, 10, 1))); + return new Attempt(response, null); + } catch (Throwable failure) { + return new Attempt(null, failure); + } + })).toList(); + assertTrue(ready.await(5, TimeUnit.SECONDS)); + start.countDown(); + List attempts = new ArrayList<>(); + for (Future future : futures) attempts.add(future.get(10, TimeUnit.SECONDS)); + return attempts; + } finally { + pool.shutdownNow(); + } + } + + @Test + void concurrentRecallOnlyTransitionsAndAuditsOnce() throws Exception { + fixture(1); + List attempts = runConcurrently(List.of(messages.get(0), messages.get(0))); + + assertEquals(2, attempts.size()); + for (Attempt attempt : attempts) { + if (attempt.failure() != null) { + Integer code = findBusinessCode(attempt.failure()); + assertEquals(ErrorCode.MESSAGE_RECALL_CONCURRENT_UPDATE.getCode(), code, + "并发失败只能是既定 8308，而不能泄漏 500"); + } else { + assertEquals("RECALLED", attempt.response().getStatus()); + } + } + Message persisted = messageRepository.findById(messages.get(0)).orElseThrow(); + assertEquals("RECALLED", persisted.getStatus()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, persisted.getContent()); + assertNotNull(persisted.getRecalledAt()); + assertEquals(1L, persisted.getVersion()); + assertEquals(1, auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && messages.get(0).equals(a.getEntityId())).count()); + } + + @Test + void concurrentRecallOfDifferentMessagesDoesNotBlockOrCrossUpdate() throws Exception { + fixture(2); + List attempts = runConcurrently(List.of(messages.get(0), messages.get(1))); + + assertEquals(2, attempts.size()); + assertTrue(attempts.stream().allMatch(a -> a.failure() == null), + "不同消息的并发撤回不得产生异常"); + for (Long messageId : messages) { + Message persisted = messageRepository.findById(messageId).orElseThrow(); + assertEquals("RECALLED", persisted.getStatus()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, persisted.getContent()); + assertEquals(1L, persisted.getVersion()); + } + assertEquals(2, auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && messages.contains(a.getEntityId())).count()); + } + + private Integer findBusinessCode(Throwable failure) { + Throwable current = failure; + while (current != null) { + if (current instanceof BusinessException business) return business.getErrorCodeInt(); + current = current.getCause(); + } + return null; + } + + private record Attempt(MessageResponse response, Throwable failure) { } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallControllerTest.java new file mode 100644 index 0000000..5bc68e1 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallControllerTest.java @@ -0,0 +1,91 @@ +package com.mydreamjob.messaging; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.messaging.dto.MessageResponse; +import com.mydreamjob.auth.JwtTokenProvider; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.LocalDateTime; +import java.util.Map; + +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class MessageRecallControllerTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @MockBean private MessagingService messagingService; + @MockBean private RedisTemplate redisTemplate; + @Autowired private ObjectMapper objectMapper; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUpRedis() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + } + + private String token(Long userId) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); + } + + @Test + void recallReturnsWhitelistedMessageResponse() throws Exception { + MessageResponse response = MessageResponse.builder() + .id(81L).conversationId(12L).senderUserId(7L) + .content(MessageViewMapper.RECALLED_PLACEHOLDER).status("RECALLED") + .recalledAt(LocalDateTime.of(2026, 9, 10, 10, 2)) + .createdAt(LocalDateTime.of(2026, 9, 10, 10, 0)).isRead(false).build(); + when(messagingService.recallMessage(eq(7L), eq(12L), eq(81L), any())).thenReturn(response); + + mockMvc.perform(post("/conversations/12/messages/81/recall") + .header("Authorization", token(7L)) + .header("X-Request-Id", "recall-1")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.content").value(MessageViewMapper.RECALLED_PLACEHOLDER)) + .andExpect(jsonPath("$.data.status").value("RECALLED")) + .andExpect(jsonPath("$.data.senderUserId").value(7)); + verify(messagingService).recallMessage(eq(7L), eq(12L), eq(81L), any()); + } + + @Test + void recallWithoutTokenReturns401() throws Exception { + mockMvc.perform(post("/conversations/12/messages/81/recall")) + .andExpect(status().isUnauthorized()); + verifyNoInteractions(messagingService); + } + + @Test + void recallWindowErrorMapsTo409WithoutInternalContent() throws Exception { + when(messagingService.recallMessage(eq(7L), eq(12L), eq(81L), any())) + .thenThrow(new BusinessException(ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED)); + + String body = mockMvc.perform(post("/conversations/12/messages/81/recall") + .header("Authorization", token(7L))) + .andExpect(status().isConflict()) + .andExpect(jsonPath("$.code").value(ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED.getCode())) + .andReturn().getResponse().getContentAsString(); + org.junit.jupiter.api.Assertions.assertFalse(body.contains("original")); + org.junit.jupiter.api.Assertions.assertFalse(body.contains("password")); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallHttpIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallHttpIntegrationTest.java new file mode 100644 index 0000000..6657174 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallHttpIntegrationTest.java @@ -0,0 +1,271 @@ +package com.mydreamjob.messaging; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +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.jdbc.core.JdbcTemplate; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.Clock; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +/** 真实 Service、Repository 和 Security 链路的消息撤回 HTTP 脱敏验证。 */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class MessageRecallHttpIntegrationTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private UserRepository userRepository; + @Autowired private ConversationRepository conversationRepository; + @Autowired private ConversationMemberRepository memberRepository; + @Autowired private MessageRepository messageRepository; + @Autowired private AuditLogRepository auditLogRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private ObjectMapper objectMapper; + @MockBean private RedisTemplate redisTemplate; + @MockBean private Clock clock; + + private static final ZoneId BUSINESS_ZONE = ZoneId.of("Asia/Shanghai"); + private static final LocalDateTime CAPTURED_NOW = LocalDateTime.of(2026, 9, 10, 10, 1); + private static final LocalDateTime FIXTURE_CREATED_AT = LocalDateTime.of(2026, 9, 10, 10, 0); + + private static final AtomicLong PHONE = new AtomicLong(7400); + private final List messageIds = new ArrayList<>(); + private final List conversationIds = new ArrayList<>(); + private final List userIds = new ArrayList<>(); + + @org.junit.jupiter.api.BeforeEach + void fixApplicationClock() { + when(clock.instant()).thenReturn(CAPTURED_NOW.atZone(BUSINESS_ZONE).toInstant()); + when(clock.getZone()).thenReturn(BUSINESS_ZONE); + } + + @AfterEach + void cleanup() { + if (!messageIds.isEmpty()) { + String marks = String.join(",", messageIds.stream().map(id -> "?").toList()); + jdbcTemplate.update("DELETE FROM audit_logs WHERE action='MESSAGE_RECALLED' AND entity_id IN (" + marks + ")", + messageIds.toArray()); + jdbcTemplate.update("DELETE FROM message_reads WHERE message_id IN (" + marks + ")", messageIds.toArray()); + jdbcTemplate.update("DELETE FROM messages WHERE id IN (" + marks + ")", messageIds.toArray()); + } + if (!conversationIds.isEmpty()) { + String marks = String.join(",", conversationIds.stream().map(id -> "?").toList()); + jdbcTemplate.update("DELETE FROM conversation_members WHERE conversation_id IN (" + marks + ")", + conversationIds.toArray()); + jdbcTemplate.update("DELETE FROM conversations WHERE id IN (" + marks + ")", conversationIds.toArray()); + } + if (!userIds.isEmpty()) { + String marks = String.join(",", userIds.stream().map(id -> "?").toList()); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (" + marks + ")", userIds.toArray()); + jdbcTemplate.update("DELETE FROM users WHERE id IN (" + marks + ")", userIds.toArray()); + } + messageIds.clear(); + conversationIds.clear(); + userIds.clear(); + } + + private Long user(String label, User.Role role) { + User saved = userRepository.saveAndFlush(User.builder() + .phone("139" + String.format("%08d", PHONE.incrementAndGet())) + .nickname(label).role(role).roles(Set.of(role)) + .active(true).verified(true).build()); + userIds.add(saved.getId()); + return saved.getId(); + } + + private Long conversation(Long sender, Long receiver, String type) { + Long id = conversationRepository.saveAndFlush(Conversation.builder() + .type(type).createdBy(sender).title("N07 HTTP test").build()).getId(); + conversationIds.add(id); + memberRepository.save(ConversationMember.builder().conversationId(id).userId(sender).build()); + memberRepository.save(ConversationMember.builder().conversationId(id).userId(receiver).build()); + return id; + } + + private Long message(Long conversation, Long sender, String body) { + LocalDateTime created = FIXTURE_CREATED_AT; + Message saved = messageRepository.saveAndFlush(Message.builder() + .conversationId(conversation).senderUserId(sender).content(body) + .status("SENT").version(0L).createdAt(created).build()); + jdbcTemplate.update("UPDATE messages SET created_at=? WHERE id=?", created, saved.getId()); + messageIds.add(saved.getId()); + return saved.getId(); + } + + private String token(Long userId, User.Role role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); + } + + @Test + void directRecallAndListUsePlaceholderAndKeepExistingSenderId() throws Exception { + Long sender = user("direct-sender", User.Role.STUDENT); + Long receiver = user("direct-receiver", User.Role.STUDENT); + Long conversation = conversation(sender, receiver, "DIRECT"); + Long message = message(conversation, sender, "N07_PRIVATE_ORIGINAL_BODY"); + + String recalled = mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", + conversation, message) + .header("Authorization", token(sender, User.Role.STUDENT)) + .header("X-Request-Id", "n07-http-direct")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.senderUserId").value(sender)) + .andExpect(jsonPath("$.data.content").value(MessageViewMapper.RECALLED_PLACEHOLDER)) + .andExpect(jsonPath("$.data.status").value("RECALLED")) + .andExpect(jsonPath("$.data.recalledAt").exists()) + .andReturn().getResponse().getContentAsString(); + assertSafe(recalled); + + String listed = mockMvc.perform(get("/conversations/{conversationId}/messages", conversation) + .header("Authorization", token(receiver, User.Role.STUDENT))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.items[0].content").value(MessageViewMapper.RECALLED_PLACEHOLDER)) + .andExpect(jsonPath("$.data.items[0].status").value("RECALLED")) + .andReturn().getResponse().getContentAsString(); + assertSafe(listed); + } + + @Test + void talentInvitationRecallUsesRelativeIdentityAcrossResponses() throws Exception { + Long sender = user("talent-sender", User.Role.COMPANY); + Long receiver = user("talent-receiver", User.Role.STUDENT); + Long conversation = conversation(sender, receiver, "TALENT_INVITATION"); + Long message = message(conversation, sender, "N07_PRIVATE_ORIGINAL_BODY"); + + String recalled = mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", + conversation, message) + .header("Authorization", token(sender, User.Role.COMPANY))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.senderScope").value("CURRENT_USER")) + .andExpect(jsonPath("$.data.senderUserId").doesNotExist()) + .andExpect(jsonPath("$.data.content").value(MessageViewMapper.RECALLED_PLACEHOLDER)) + .andReturn().getResponse().getContentAsString(); + assertSafe(recalled); + + String listed = mockMvc.perform(get("/conversations/{conversationId}/messages", conversation) + .header("Authorization", token(receiver, User.Role.STUDENT))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.items[0].senderScope").value("OTHER_PARTICIPANT")) + .andExpect(jsonPath("$.data.items[0].senderUserId").doesNotExist()) + .andReturn().getResponse().getContentAsString(); + assertSafe(listed); + + String conversationView = mockMvc.perform(get("/conversations/{conversationId}", conversation) + .header("Authorization", token(receiver, User.Role.STUDENT))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.createdBy").doesNotExist()) + .andReturn().getResponse().getContentAsString(); + assertSafe(conversationView); + } + + @Test + void realHttpPermissionAndErrorContractIsPreserved() throws Exception { + Long sender = user("permission-sender", User.Role.STUDENT); + Long receiver = user("permission-receiver", User.Role.STUDENT); + Long admin = user("permission-admin", User.Role.ADMIN); + Long conversation = conversation(sender, receiver, "DIRECT"); + memberRepository.saveAndFlush(ConversationMember.builder().conversationId(conversation).userId(admin).build()); + Long message = message(conversation, sender, "N07_PRIVATE_ORIGINAL_BODY"); + + mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", conversation, message) + .header("Authorization", token(receiver, User.Role.STUDENT))) + .andExpect(status().isForbidden()).andExpect(jsonPath("$.code").value(2002)); + mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", conversation, message) + .header("Authorization", token(admin, User.Role.ADMIN))) + .andExpect(status().isForbidden()).andExpect(jsonPath("$.code").value(2002)); + mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", conversation, message)) + .andExpect(status().isUnauthorized()); + mockMvc.perform(post("/conversations/{conversationId}/messages/{messageId}/recall", conversation, 999999L) + .header("Authorization", token(sender, User.Role.STUDENT))) + .andExpect(status().isNotFound()).andExpect(jsonPath("$.code").value(8306)); + } + + @Test + void realHttpCoversNonMemberCrossConversationMissingConversationAndExpiredWindow() throws Exception { + Long sender = user("matrix-sender", User.Role.STUDENT); + Long receiver = user("matrix-receiver", User.Role.STUDENT); + Long nonMember = user("matrix-non-member", User.Role.STUDENT); + Long primaryConversation = conversation(sender, receiver, "DIRECT"); + Long otherConversation = conversation(sender, receiver, "DIRECT"); + Long message = message(primaryConversation, sender, "N07_PRIVATE_ORIGINAL_BODY"); + + String nonMemberBody = mockMvc.perform(post( + "/conversations/{conversationId}/messages/{messageId}/recall", + primaryConversation, message) + .header("Authorization", token(nonMember, User.Role.STUDENT))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(2002)) + .andReturn().getResponse().getContentAsString(); + assertSafe(nonMemberBody); + + String crossConversationBody = mockMvc.perform(post( + "/conversations/{conversationId}/messages/{messageId}/recall", + otherConversation, message) + .header("Authorization", token(sender, User.Role.STUDENT))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(2002)) + .andReturn().getResponse().getContentAsString(); + assertSafe(crossConversationBody); + + String missingConversationBody = mockMvc.perform(post( + "/conversations/{conversationId}/messages/{messageId}/recall", + 999999L, message) + .header("Authorization", token(sender, User.Role.STUDENT))) + .andExpect(status().isNotFound()) + .andExpect(jsonPath("$.code").value(8305)) + .andReturn().getResponse().getContentAsString(); + assertSafe(missingConversationBody); + + LocalDateTime expiredNow = FIXTURE_CREATED_AT.plusMinutes(2).plusNanos(1); + when(clock.instant()).thenReturn(expiredNow.atZone(BUSINESS_ZONE).toInstant()); + String expiredBody = mockMvc.perform(post( + "/conversations/{conversationId}/messages/{messageId}/recall", + primaryConversation, message) + .header("Authorization", token(sender, User.Role.STUDENT))) + .andExpect(status().isConflict()) + .andExpect(jsonPath("$.code").value(8307)) + .andReturn().getResponse().getContentAsString(); + assertSafe(expiredBody); + + Message unchanged = messageRepository.findById(message).orElseThrow(); + assertEquals("SENT", unchanged.getStatus()); + assertEquals("N07_PRIVATE_ORIGINAL_BODY", unchanged.getContent()); + assertEquals(0L, unchanged.getVersion()); + assertEquals(0, auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && message.equals(a.getEntityId())) + .count()); + } + + private void assertSafe(String json) { + assertFalse(json.contains("N07_PRIVATE_ORIGINAL_BODY")); + for (String forbidden : List.of("originalContent", "previousContent", "studentUserId", "candidateId", + "phone", "email", "resumeUrl", "candidateKey", "candidateKeyDigest", "ipAddress", "userAgent", + "password", "token", "secret")) { + assertFalse(json.contains(forbidden), "response contains forbidden field: " + forbidden); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallPersistenceIntegrationTest.java new file mode 100644 index 0000000..3bd4646 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallPersistenceIntegrationTest.java @@ -0,0 +1,355 @@ +package com.mydreamjob.messaging; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +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.messaging.dto.MessageResponse; +import com.mydreamjob.safety.BlockRelationRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import jakarta.persistence.EntityManager; +import jakarta.persistence.EntityManagerFactory; +import jakarta.persistence.OptimisticLockException; +import org.springframework.dao.DataAccessException; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.jdbc.core.JdbcTemplate; +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.data.domain.Page; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; + +@SpringBootTest +@ActiveProfiles("integration-test") +class MessageRecallPersistenceIntegrationTest { + + @Autowired private MessagingService messagingService; + @Autowired private UserRepository userRepository; + @Autowired private ConversationRepository conversationRepository; + @Autowired private ConversationMemberRepository memberRepository; + @Autowired private MessageRepository messageRepository; + @Autowired private MessageReadRepository readRepository; + @Autowired private AuditLogRepository auditLogRepository; + @Autowired private BlockRelationRepository blockRelationRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private EntityManager entityManager; + @Autowired private EntityManagerFactory entityManagerFactory; + @Autowired private ObjectMapper objectMapper; + @MockBean private RedisTemplate redisTemplate; + + private Long sender; + private Long receiver; + private Long conversation; + private Long message; + private Long candidateScoreStudent; + + @AfterEach + void cleanup() { + if (candidateScoreStudent != null) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id=?", candidateScoreStudent); + candidateScoreStudent = null; + } + if (message != null) readRepository.deleteAll(); + messageRepository.deleteAll(); + memberRepository.deleteAll(); + blockRelationRepository.deleteAll(); + conversationRepository.deleteAll(); + auditLogRepository.deleteAll(); + if (sender != null || receiver != null) { + if (sender != null) { + jdbcTemplate.update("DELETE FROM scoring_risk_actions WHERE operator_user_id=?", sender); + jdbcTemplate.update("DELETE FROM scoring_risk_events WHERE subject_user_id=?", sender); + jdbcTemplate.update("DELETE FROM notifications WHERE user_id=?", sender); + } + if (receiver != null) { + jdbcTemplate.update("DELETE FROM scoring_risk_actions WHERE operator_user_id=?", receiver); + jdbcTemplate.update("DELETE FROM scoring_risk_events WHERE subject_user_id=?", receiver); + jdbcTemplate.update("DELETE FROM notifications WHERE user_id=?", receiver); + } + } + userRepository.deleteAll(); + } + + private void fixture(LocalDateTime createdAt) { + sender = userRepository.save(user("sender")).getId(); + receiver = userRepository.save(user("receiver")).getId(); + conversation = conversationRepository.save(Conversation.builder().type("DIRECT").createdBy(sender).build()).getId(); + memberRepository.save(ConversationMember.builder().conversationId(conversation).userId(sender).build()); + memberRepository.save(ConversationMember.builder().conversationId(conversation).userId(receiver).build()); + Message saved = messageRepository.saveAndFlush(Message.builder().conversationId(conversation).senderUserId(sender) + .content("secret-body").status("SENT").version(0L).createdAt(createdAt).build()); + message = saved.getId(); + // Auditing may refresh @CreatedDate on update; force the deterministic boundary in the fixture only. + jdbcTemplate.update("UPDATE messages SET created_at=? WHERE id=?", createdAt, message); + entityManager.clear(); + } + + private User user(String name) { + return User.builder().phone("139" + Math.abs(System.nanoTime() % 1_000_000_000L)) + .nickname(name).role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)) + .active(true).verified(true).build(); + } + + @Test + void migrationFieldsAndConditionalUpdatePersistRecall() { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + LocalDateTime recalledAt = created.plusMinutes(2); + fixture(created); + + MessageResponse response = messagingService.recallMessage(sender, conversation, message, null, recalledAt); + Message persisted = messageRepository.findById(message).orElseThrow(); + + assertEquals("RECALLED", persisted.getStatus()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, persisted.getContent()); + assertEquals(recalledAt, persisted.getRecalledAt()); + assertEquals(1L, persisted.getVersion()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, response.getContent()); + assertEquals(1, auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && message.equals(a.getEntityId())).count()); + assertFalse(auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction())) + .anyMatch(a -> a.getDetails() != null && a.getDetails().contains("secret-body"))); + } + + @Test + void messageRecallAuditStoresRequestIdButNotIpOrUserAgent() throws Exception { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + AuditContext context = AuditContext.builder() + .requestId("recall-audit-1") + .ipAddress("127.0.0.66") + .userAgent("N07-secret-agent") + .build(); + + messagingService.recallMessage(sender, conversation, message, context, created.plusMinutes(1)); + + AuditLog audit = auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && message.equals(a.getEntityId())) + .findFirst().orElseThrow(); + assertEquals("recall-audit-1", audit.getRequestId()); + assertNull(audit.getIpAddress()); + assertNull(audit.getUserAgent()); + JsonNode details = objectMapper.readTree(audit.getDetails()); + java.util.Set fields = new java.util.HashSet<>(); + details.fieldNames().forEachRemaining(fields::add); + assertEquals(java.util.Set.of("messageId", "conversationId", "conversationType", "status", "requestId"), fields); + assertEquals(message.longValue(), details.get("messageId").longValue()); + assertEquals(conversation.longValue(), details.get("conversationId").longValue()); + assertEquals("DIRECT", details.get("conversationType").textValue()); + assertEquals("RECALLED", details.get("status").textValue()); + assertEquals("recall-audit-1", details.get("requestId").textValue()); + assertFalse(audit.getDetails().contains("secret-body")); + assertFalse(audit.getDetails().contains("127.0.0.66")); + assertFalse(audit.getDetails().contains("N07-secret-agent")); + } + + @Test + void v41DefaultsAndStatusCheckAreEnforced() { + fixture(LocalDateTime.of(2026, 9, 10, 10, 0)); + jdbcTemplate.update( + "INSERT INTO messages(conversation_id, sender_user_id, content, created_at) VALUES (?, ?, ?, ?)", + conversation, sender, "legacy-body", LocalDateTime.of(2026, 9, 10, 10, 0)); + Long legacyMessage = jdbcTemplate.queryForObject("SELECT MAX(id) FROM messages WHERE conversation_id=?", + Long.class, conversation); + java.util.Map row = jdbcTemplate.queryForMap( + "SELECT status, recalled_at, version FROM messages WHERE id=?", legacyMessage); + assertEquals("SENT", row.get("STATUS")); + assertNull(row.get("RECALLED_AT")); + assertEquals(0L, ((Number) row.get("VERSION")).longValue()); + + Long finalLegacyMessage = legacyMessage; + assertThrows(DataAccessException.class, () -> jdbcTemplate.update( + "UPDATE messages SET status='DELETED' WHERE id=?", finalLegacyMessage)); + } + + @Test + void optimisticVersionConflictCannotSilentlyOverwrite() { + fixture(LocalDateTime.of(2026, 9, 10, 10, 0)); + EntityManager first = entityManagerFactory.createEntityManager(); + EntityManager second = entityManagerFactory.createEntityManager(); + jakarta.persistence.EntityTransaction tx1 = first.getTransaction(); + jakarta.persistence.EntityTransaction tx2 = second.getTransaction(); + try { + Message firstMessage = first.find(Message.class, message); + Message secondMessage = second.find(Message.class, message); + tx1.begin(); + firstMessage.setContent("first-update"); + tx1.commit(); + + tx2.begin(); + secondMessage.setContent("stale-update"); + RuntimeException conflict = assertThrows(RuntimeException.class, tx2::commit); + assertTrue(hasCause(conflict, OptimisticLockException.class), + "stale update must be reported as an optimistic lock conflict"); + if (tx2.isActive()) tx2.rollback(); + assertEquals("first-update", jdbcTemplate.queryForObject( + "SELECT content FROM messages WHERE id=?", String.class, message)); + } finally { + if (tx1.isActive()) tx1.rollback(); + if (tx2.isActive()) tx2.rollback(); + first.close(); + second.close(); + } + } + + @Test + @Transactional + void conditionalRecallRejectsWrongOwnerConversationVersionAndStatus() { + fixture(LocalDateTime.of(2026, 9, 10, 10, 0)); + LocalDateTime recalledAt = LocalDateTime.of(2026, 9, 10, 10, 1); + assertEquals(0, messageRepository.recallIfCurrent(message, conversation, 999L, 0L, + MessageViewMapper.RECALLED_PLACEHOLDER, recalledAt)); + assertEquals(0, messageRepository.recallIfCurrent(message, 999L, sender, 0L, + MessageViewMapper.RECALLED_PLACEHOLDER, recalledAt)); + assertEquals(0, messageRepository.recallIfCurrent(message, conversation, sender, 1L, + MessageViewMapper.RECALLED_PLACEHOLDER, recalledAt)); + assertEquals(1, messageRepository.recallIfCurrent(message, conversation, sender, 0L, + MessageViewMapper.RECALLED_PLACEHOLDER, recalledAt)); + assertEquals(0, messageRepository.recallIfCurrent(message, conversation, sender, 0L, + MessageViewMapper.RECALLED_PLACEHOLDER, recalledAt)); + } + + private boolean hasCause(Throwable error, Class type) { + Throwable current = error; + while (current != null) { + if (type.isInstance(current)) return true; + current = current.getCause(); + } + return false; + } + + @Test + void existingMessageReadRowsRemainAfterRecall() { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + readRepository.saveAndFlush(MessageRead.builder().messageId(message).readerUserId(receiver).build()); + + messagingService.recallMessage(sender, conversation, message, null, created.plusMinutes(1)); + + assertEquals(1, readRepository.findByMessageIdInAndReaderUserId(java.util.List.of(message), receiver).size()); + messagingService.markRead(conversation, receiver); + assertEquals(1, readRepository.findByMessageIdInAndReaderUserId(java.util.List.of(message), receiver).size()); + assertEquals(1, messagingService.listMessages(conversation, receiver, 0, 20) + .getItems().stream().filter(item -> Boolean.TRUE.equals(item.getIsRead())).count()); + } + + @Test + void expiredRecallDoesNotMutateDatabase() { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + assertEquals(created, messageRepository.findById(message).orElseThrow().getCreatedAt()); + BusinessException ex = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(sender, conversation, message, null, created.plusMinutes(2).plusNanos(1))); + assertEquals(ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED.getCode(), ex.getErrorCodeInt()); + Message persisted = messageRepository.findById(message).orElseThrow(); + assertEquals("SENT", persisted.getStatus()); + assertEquals("secret-body", persisted.getContent()); + assertEquals(0L, persisted.getVersion()); + assertEquals(0, auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && message.equals(a.getEntityId())).count()); + } + + @Test + void recalledMessagesAreNotUnreadOrMarkedRead() { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + messagingService.recallMessage(sender, conversation, message, null, created.plusMinutes(1)); + var messages = messagingService.listMessages(conversation, receiver, 0, 20); + assertEquals(1, messages.getTotal()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, messages.getItems().get(0).getContent()); + assertEquals("RECALLED", messages.getItems().get(0).getStatus()); + messagingService.markRead(conversation, receiver); + assertEquals(0, readRepository.findByMessageIdInAndReaderUserId(java.util.List.of(message), receiver).size()); + } + + @Test + void messageRecallDoesNotModifyCandidateDimensionScores() { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + candidateScoreStudent = receiver; + jdbcTemplate.update("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, 'ACTIVITY', '2026-09', 73.25, 'OK', 12.50, 'candidate-scoring-v0.2', ?)", + candidateScoreStudent, created); + java.util.Map before = jdbcTemplate.queryForMap( + "SELECT id, student_user_id, dimension, score, status, weight, rules_version, calculated_at, period, version " + + "FROM candidate_dimension_scores WHERE student_user_id=? AND dimension='ACTIVITY'", + candidateScoreStudent); + + messagingService.recallMessage(sender, conversation, message, null, created.plusMinutes(1)); + + java.util.Map after = jdbcTemplate.queryForMap( + "SELECT id, student_user_id, dimension, score, status, weight, rules_version, calculated_at, period, version " + + "FROM candidate_dimension_scores WHERE student_user_id=? AND dimension='ACTIVITY'", + candidateScoreStudent); + assertEquals(before, after, "message recall must not modify candidate_dimension_scores"); + } + + @Test + void messageRecallDoesNotModifyNotificationsOrRiskGovernanceData() throws Exception { + LocalDateTime created = LocalDateTime.of(2026, 9, 10, 10, 0); + fixture(created); + jdbcTemplate.update("INSERT INTO notifications(user_id, type, title, content, is_read, created_at) " + + "VALUES (?, 'SYSTEM', 'N07 baseline', 'unchanged', 0, ?)", + receiver, created); + Long ruleId = jdbcTemplate.queryForObject( + "SELECT id FROM scoring_rule_configs ORDER BY id LIMIT 1", Long.class); + jdbcTemplate.update("INSERT INTO scoring_risk_events(rule_config_id, subject_user_id, source_audit_log_id, " + + "source_action, severity, window_started_at, window_ended_at, occurrence_count, status, " + + "detected_at, version, created_at, updated_at) " + + "VALUES (?, ?, 987654321, 'REPORT_RATE_LIMITED', 'LOW', ?, ?, 1, 'OPEN', ?, 0, ?, ?)", + ruleId, sender, created.minusMinutes(1), created, created, created, created); + Long riskEventId = jdbcTemplate.queryForObject( + "SELECT id FROM scoring_risk_events WHERE subject_user_id=?", Long.class, sender); + jdbcTemplate.update("INSERT INTO scoring_risk_actions(risk_event_id, operator_user_id, action, reason_code, created_at) " + + "VALUES (?, ?, 'ACKNOWLEDGE', 'MONITORING', ?)", + riskEventId, sender, created); + + java.util.List> notificationsBefore = stableRows("notifications"); + java.util.List> riskEventsBefore = stableRows("scoring_risk_events"); + java.util.List> riskActionsBefore = stableRows("scoring_risk_actions"); + java.util.List> riskRulesBefore = stableRows("scoring_rule_configs"); + java.util.List> checkpointsBefore = stableRows("scoring_risk_scan_checkpoints"); + long auditsBefore = auditLogRepository.count(); + + messagingService.recallMessage(sender, conversation, message, + AuditContext.builder().requestId("n07-side-effect-check").build(), created.plusMinutes(1)); + + assertEquals(notificationsBefore, stableRows("notifications")); + assertEquals(riskEventsBefore, stableRows("scoring_risk_events")); + assertEquals(riskActionsBefore, stableRows("scoring_risk_actions")); + assertEquals(riskRulesBefore, stableRows("scoring_rule_configs")); + assertEquals(checkpointsBefore, stableRows("scoring_risk_scan_checkpoints")); + assertEquals(auditsBefore + 1, auditLogRepository.count()); + + AuditLog recallAudit = auditLogRepository.findAll().stream() + .filter(a -> "MESSAGE_RECALLED".equals(a.getAction()) && message.equals(a.getEntityId())) + .findFirst().orElseThrow(); + JsonNode details = objectMapper.readTree(recallAudit.getDetails()); + java.util.Set fields = new java.util.HashSet<>(); + details.fieldNames().forEachRemaining(fields::add); + assertEquals(java.util.Set.of("messageId", "conversationId", "conversationType", "status", "requestId"), fields); + assertNull(recallAudit.getIpAddress()); + assertNull(recallAudit.getUserAgent()); + } + + private java.util.List> stableRows(String table) { + java.util.Set allowed = java.util.Set.of( + "notifications", "scoring_risk_events", "scoring_risk_actions", + "scoring_rule_configs", "scoring_risk_scan_checkpoints"); + if (!allowed.contains(table)) throw new IllegalArgumentException("unsupported snapshot table"); + return jdbcTemplate.queryForList("SELECT * FROM " + table + " ORDER BY id"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallServiceTest.java new file mode 100644 index 0000000..e6fdead --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessageRecallServiceTest.java @@ -0,0 +1,221 @@ +package com.mydreamjob.messaging; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.bidirectionalmatch.ApplicationMatchRecordRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.messaging.dto.MessageResponse; +import com.mydreamjob.safety.BlockRelationRepository; +import org.junit.jupiter.api.BeforeEach; +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.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class MessageRecallServiceTest { + + @Mock private ConversationRepository conversationRepository; + @Mock private ConversationMemberRepository memberRepository; + @Mock private MessageRepository messageRepository; + @Mock private MessageReadRepository readRepository; + @Mock private UserRepository userRepository; + @Mock private CompanyRepository companyRepository; + @Mock private ApplicationMatchRecordRepository applicationMatchRecordRepository; + @Mock private BlockRelationRepository blockRelationRepository; + @Mock private com.mydreamjob.audit.SecurityAuditService securityAuditService; + @Mock private AuditService auditService; + @Mock private Clock clock; + @org.mockito.Spy private MessageViewMapper messageViewMapper = new MessageViewMapper(); + @org.mockito.Spy private com.fasterxml.jackson.databind.ObjectMapper objectMapper = + new com.fasterxml.jackson.databind.ObjectMapper(); + @InjectMocks private MessagingService messagingService; + + private static final Long USER = 7L; + private static final Long OTHER = 8L; + private static final Long CONVERSATION = 12L; + private static final Long MESSAGE = 81L; + private static final LocalDateTime CREATED = LocalDateTime.of(2026, 9, 10, 10, 0); + private static final LocalDateTime AT_DEADLINE = CREATED.plusMinutes(2); + private static final AuditContext CONTEXT = AuditContext.builder().requestId("req-1").build(); + + @BeforeEach + void setUp() { + when(conversationRepository.findById(CONVERSATION)) + .thenReturn(Optional.of(Conversation.builder().id(CONVERSATION).type("DIRECT").build())); + lenient().when(memberRepository.existsByConversationIdAndUserId(CONVERSATION, USER)).thenReturn(true); + lenient().when(memberRepository.existsByConversationIdAndUserId(CONVERSATION, OTHER)).thenReturn(true); + lenient().when(readRepository.existsByMessageIdAndReaderUserId(MESSAGE, USER)).thenReturn(false); + } + + private Message sentMessage() { + return Message.builder().id(MESSAGE).conversationId(CONVERSATION).senderUserId(USER) + .content("private original").status("SENT").version(0L).createdAt(CREATED).build(); + } + + @Test + void recallWithinWindow_overwritesContentAndAuditsOnce() { + Message message = sentMessage(); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + when(messageRepository.recallIfCurrent(eq(MESSAGE), eq(CONVERSATION), eq(USER), eq(0L), + eq(MessageViewMapper.RECALLED_PLACEHOLDER), eq(AT_DEADLINE))).thenAnswer(invocation -> { + message.setStatus("RECALLED"); + message.setContent(MessageViewMapper.RECALLED_PLACEHOLDER); + message.setRecalledAt(AT_DEADLINE); + message.setVersion(1L); + return 1; + }); + + MessageResponse response = messagingService.recallMessage(USER, CONVERSATION, MESSAGE, + CONTEXT, AT_DEADLINE); + + assertEquals("RECALLED", response.getStatus()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, response.getContent()); + assertEquals(AT_DEADLINE, response.getRecalledAt()); + verify(messageRepository).recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), eq(AT_DEADLINE)); + verify(auditService).log(eq(USER), eq("MESSAGE_RECALLED"), eq("MESSAGE"), eq(MESSAGE), + contains("\"conversationId\":12"), eq(CONTEXT)); + } + + @Test + void exactTwoMinutesIsStillAllowed() { + Message message = sentMessage(); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + when(messageRepository.recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), eq(AT_DEADLINE))) + .thenReturn(1); + assertDoesNotThrow(() -> messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, AT_DEADLINE)); + } + + @Test + void recallAtOneMinuteFiftyNineSecondsSucceeds() { + Message message = sentMessage(); + LocalDateTime atOneMinuteFiftyNineSeconds = CREATED.plusMinutes(1).plusSeconds(59); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + when(messageRepository.recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), + eq(atOneMinuteFiftyNineSeconds))).thenAnswer(invocation -> { + message.setStatus("RECALLED"); + message.setContent(MessageViewMapper.RECALLED_PLACEHOLDER); + message.setRecalledAt(atOneMinuteFiftyNineSeconds); + message.setVersion(1L); + return 1; + }); + + MessageResponse response = messagingService.recallMessage(USER, CONVERSATION, MESSAGE, + CONTEXT, atOneMinuteFiftyNineSeconds); + + assertEquals("RECALLED", response.getStatus()); + verify(messageRepository).recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), + eq(atOneMinuteFiftyNineSeconds)); + } + + @Test + void afterTwoMinutesReturnsConflictWithoutMutationOrAudit() { + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(sentMessage())); + BusinessException ex = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, AT_DEADLINE.plusNanos(1))); + assertEquals(ErrorCode.MESSAGE_RECALL_WINDOW_EXPIRED.getCode(), ex.getErrorCodeInt()); + verify(messageRepository, never()).recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), any()); + verifyNoInteractions(auditService); + } + + @Test + void nonSenderAndNonMemberAreForbidden() { + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(sentMessage())); + BusinessException sender = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(OTHER, CONVERSATION, MESSAGE, CONTEXT, CREATED)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), sender.getErrorCodeInt()); + + when(memberRepository.existsByConversationIdAndUserId(CONVERSATION, USER)).thenReturn(false); + BusinessException member = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, CREATED)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), member.getErrorCodeInt()); + } + + @Test + void adminCannotRecallEvenWhenMemberAndSenderChecksWouldOtherwisePass() { + User admin = User.builder().id(USER).role(User.Role.ADMIN).roles(java.util.Set.of(User.Role.ADMIN)).build(); + when(userRepository.findById(USER)).thenReturn(Optional.of(admin)); + + BusinessException ex = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, CREATED)); + + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + verify(messageRepository, never()).findById(anyLong()); + verifyNoInteractions(auditService); + } + + @Test + void crossConversationProbeIsForbidden() { + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of( + Message.builder().id(MESSAGE).conversationId(999L).senderUserId(USER).content("x") + .status("SENT").createdAt(CREATED).version(0L).build())); + BusinessException ex = assertThrows(BusinessException.class, + () -> messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, CREATED)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } + + @Test + void repeatedRecallIsIdempotentAndDoesNotAuditAgain() { + Message message = sentMessage(); + message.setStatus("RECALLED"); + message.setContent(MessageViewMapper.RECALLED_PLACEHOLDER); + message.setRecalledAt(CREATED.plusMinutes(1)); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + + MessageResponse response = messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, AT_DEADLINE); + + assertEquals("RECALLED", response.getStatus()); + assertEquals(MessageViewMapper.RECALLED_PLACEHOLDER, response.getContent()); + verify(messageRepository, never()).recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), any()); + verifyNoInteractions(auditService); + } + + @Test + void concurrentUpdateReturningRecalledRowIsIdempotent() { + Message message = sentMessage(); + Message latest = sentMessage(); + latest.setStatus("RECALLED"); + latest.setContent(MessageViewMapper.RECALLED_PLACEHOLDER); + latest.setRecalledAt(AT_DEADLINE); + latest.setVersion(1L); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + when(messageRepository.findCurrentByIdForRecall(MESSAGE)).thenReturn(Optional.of(latest)); + when(messageRepository.recallIfCurrent(anyLong(), anyLong(), anyLong(), anyLong(), anyString(), any())) + .thenReturn(0); + + MessageResponse response = messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, CREATED); + + assertEquals("RECALLED", response.getStatus()); + verifyNoInteractions(auditService); + } + + @Test + void talentInvitationResponseUsesRelativeSenderScope() { + Conversation invitation = Conversation.builder().id(CONVERSATION).type("TALENT_INVITATION").build(); + when(conversationRepository.findById(CONVERSATION)).thenReturn(Optional.of(invitation)); + Message message = sentMessage(); + message.setStatus("RECALLED"); + when(messageRepository.findById(MESSAGE)).thenReturn(Optional.of(message)); + + MessageResponse response = messagingService.recallMessage(USER, CONVERSATION, MESSAGE, CONTEXT, AT_DEADLINE); + + assertNull(response.getSenderUserId()); + assertEquals("CURRENT_USER", response.getSenderScope()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingBlockIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingBlockIntegrationTest.java index 6e0f8fb..9d3eec3 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingBlockIntegrationTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingBlockIntegrationTest.java @@ -148,9 +148,9 @@ class MessagingBlockIntegrationTest { Assertions.assertTrue(convs.stream().anyMatch(c -> ((Number) c.get("id")).longValue() == convId), "被屏蔽后仍应能看到既有会话"); - Page> msgs = messagingService.listMessages(convId, b, 0, 20); - Assertions.assertEquals(1, msgs.getTotalElements()); - Assertions.assertEquals("历史消息", msgs.getContent().get(0).get("content")); + var msgs = messagingService.listMessages(convId, b, 0, 20); + Assertions.assertEquals(1, msgs.getTotal()); + Assertions.assertEquals("历史消息", msgs.getItems().get(0).getContent()); Map single = messagingService.getConversation(convId, b); Assertions.assertEquals(convId, ((Number) single.get("id")).longValue()); @@ -165,15 +165,15 @@ class MessagingBlockIntegrationTest { Assertions.assertThrows(BusinessException.class, () -> send(a, convId, "屏蔽期间的消息")); // 失败消息未落库 - Page> before = messagingService.listMessages(convId, a, 0, 20); - Assertions.assertEquals(0, before.getTotalElements()); + var before = messagingService.listMessages(convId, a, 0, 20); + Assertions.assertEquals(0, before.getTotal()); // 即使是已存在的会话，解除屏蔽后需手动重新发送；历史不会自动补发 unblock(a, b); send(a, convId, "解除屏蔽后发送"); - Page> after = messagingService.listMessages(convId, a, 0, 20); - Assertions.assertEquals(1, after.getTotalElements()); - Assertions.assertEquals("解除屏蔽后发送", after.getContent().get(0).get("content")); + var after = messagingService.listMessages(convId, a, 0, 20); + Assertions.assertEquals(1, after.getTotal()); + Assertions.assertEquals("解除屏蔽后发送", after.getItems().get(0).getContent()); } // 未屏蔽时不受影响（回归） @@ -215,4 +215,4 @@ class MessagingBlockIntegrationTest { .count(); Assertions.assertTrue(cnt >= 1, "屏蔽建会话后 BLOCKED_SEND_PROHIBITED 审计应落库，实际=" + cnt); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingControllerTest.java index fdb751a..9329046 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingControllerTest.java @@ -3,6 +3,7 @@ package com.mydreamjob.messaging; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.messaging.dto.CreateConversationRequest; +import com.mydreamjob.messaging.dto.MessagePageResponse; import com.mydreamjob.messaging.dto.SendMessageRequest; import com.fasterxml.jackson.databind.ObjectMapper; import org.junit.jupiter.api.BeforeEach; @@ -46,7 +47,7 @@ class MessagingControllerTest { } private String token() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "1", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } @Test void listConversations_shouldReturn200() throws Exception { @@ -82,7 +83,7 @@ class MessagingControllerTest { @Test void listMessages_shouldReturn200() throws Exception { when(messagingService.listMessages(eq(1L), eq(100L), eq(0), eq(20))) - .thenReturn(org.springframework.data.domain.Page.empty()); + .thenReturn(MessagePageResponse.builder().items(List.of()).total(0).page(0).size(20).totalPages(0).build()); mockMvc.perform(get("/conversations/1/messages").header("Authorization", token())) .andExpect(status().isOk()).andExpect(jsonPath("$.code").value(200)); } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingServiceTest.java index 6f37f1f..4b61ca6 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/messaging/MessagingServiceTest.java @@ -40,6 +40,9 @@ class MessagingServiceTest { @Mock private ApplicationMatchRecordRepository applicationMatchRecordRepository; @Mock private BlockRelationRepository blockRelationRepository; @Mock private SecurityAuditService securityAuditService; + @org.mockito.Spy private MessageViewMapper messageViewMapper = new MessageViewMapper(); + @org.mockito.Spy private com.fasterxml.jackson.databind.ObjectMapper objectMapper = + new com.fasterxml.jackson.databind.ObjectMapper(); @InjectMocks private MessagingService messagingService; private static final Long USER_A = 100L; @@ -255,11 +258,11 @@ class MessagingServiceTest { Message msg = Message.builder().id(1L).conversationId(CONV_ID).senderUserId(USER_A).content("Hi").build(); when(messageRepository.findByConversationIdOrderByCreatedAtDesc(eq(CONV_ID), any())) .thenReturn(new PageImpl<>(List.of(msg))); - when(readRepository.existsByMessageIdAndReaderUserId(1L, USER_A)).thenReturn(false); + when(readRepository.findByMessageIdInAndReaderUserId(List.of(1L), USER_A)).thenReturn(List.of()); var r = messagingService.listMessages(CONV_ID, USER_A, 0, 20); - assertEquals(1, r.getTotalElements()); - assertEquals(false, r.getContent().get(0).get("isRead")); + assertEquals(1, r.getTotal()); + assertEquals(false, r.getItems().get(0).getIsRead()); } @Test void listMessages_asNonMember_shouldReturn403() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/notification/NotificationControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/notification/NotificationControllerTest.java index 9dfb5ad..dcef124 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/notification/NotificationControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/notification/NotificationControllerTest.java @@ -42,7 +42,7 @@ class NotificationControllerTest { } private String token() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "1", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } @Test void list_shouldReturn200() throws Exception { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferControllerTest.java index c7a6030..383e514 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferControllerTest.java @@ -61,11 +61,11 @@ class OfferControllerTest { } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(COMPANY_USER_ID, "1", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(COMPANY_USER_ID, "COMPANY"); } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(STUDENT_ID, "2", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_ID, "STUDENT"); } private Map offerView() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryRefreshRegistrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryRefreshRegistrationTest.java new file mode 100644 index 0000000..a8d901e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryRefreshRegistrationTest.java @@ -0,0 +1,278 @@ +package com.mydreamjob.offer; + +import com.mydreamjob.application.Application; +import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 阻断缺陷 F1：Offer 自动过期必须登记评分刷新任务。 + * + *

    缺陷背景：{@code OfferExpiryWorker#expireOne} 直接把 Offer 置为 EXPIRED， + * 而 {@code CandidateScoringCalculator#queryOffers} 以 {@code status='EXPIRED'} 计数 + * 参与 INTEGRITY 维度评分 —— 该写侧事件此前不登记刷新任务。

    + * + *

    本测试断言真实数据库状态（offers / candidate_scoring_refresh_tasks / notifications）， + * 不依赖对 requestRefresh 的 mock 验证。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class OfferExpiryRefreshRegistrationTest { + + @Autowired private OfferExpiryWorker worker; + @Autowired private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService requestService; + @Autowired private OfferRepository offerRepository; + @Autowired private OfferStatusHistoryRepository historyRepository; + @Autowired private ApplicationRepository applicationRepository; + @Autowired private JobRepository jobRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + /** 仅用于制造"事务内后续步骤失败"以验证原子性；正常路径行为不变。 */ + @MockBean private OfferCounterOfferRepository counterOfferRepository; + + private static final AtomicLong SEQ = new AtomicLong(3000); + + private Long companyId; + private Long companyUserId; + + /** 与 CandidateScoringRefreshRequestService 保持一致：period = capturedNow 所在 yyyy-MM。 */ + private String period() { + LocalDateTime n = LocalDateTime.now(); + return String.format("%04d-%02d", n.getYear(), n.getMonthValue()); + } + + private long taskCount(Long studentId) { + Long c = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, studentId); + return c == null ? -1 : c; + } + + /** userId 为 null 时统计全部通知行。 */ + private long notificationCount(Long userId) { + Long c = (userId == null) + ? jdbcTemplate.queryForObject("SELECT COUNT(*) FROM notifications", Long.class) + : jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM notifications WHERE user_id=?", Long.class, userId); + return c == null ? -1 : c; + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_feedback"); + historyRepository.deleteAll(); // offer_status_history 引用 offers，必须先删 + jdbcTemplate.update("DELETE FROM offer_reminders"); + jdbcTemplate.update("DELETE FROM offer_counter_offers"); + offerRepository.deleteAll(); + applicationRepository.deleteAll(); + jobRepository.deleteAll(); + companyRepository.deleteAll(); + + User companyUser = userRepository.save(User.builder() + .phone("198" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("F1企业").role(User.Role.COMPANY).active(true).verified(true).build()); + companyUser.setRoles(java.util.Set.of(User.Role.COMPANY)); + companyUserId = companyUser.getId(); + Company company = companyRepository.save(Company.builder() + .ownerUserId(companyUserId).name("F1公司").build()); + companyId = company.getId(); + Job job = jobRepository.save(Job.builder() + .companyId(companyId).title("F1岗位").description("d").city("上海") + .employmentType("FULL_TIME").status("PUBLISHED").build()); + + // 原状态非 ACTIVE，避免 activeKey 唯一约束在多 Offer 场景下互相冲突 + jdbcTemplate.update("UPDATE jobs SET status='PUBLISHED' WHERE id=?", job.getId()); + } + + /** 清理本类产生的全部行，避免污染同一 JVM 内共享的 H2 内存库。 */ + @org.junit.jupiter.api.AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM candidate_feedback"); + historyRepository.deleteAll(); + jdbcTemplate.update("DELETE FROM offer_reminders"); + jdbcTemplate.update("DELETE FROM offer_counter_offers"); + offerRepository.deleteAll(); + jdbcTemplate.update("DELETE FROM application_status_history"); + applicationRepository.deleteAll(); + jobRepository.deleteAll(); + companyRepository.deleteAll(); + } + + /** 建一个属于指定学生的 SENT Offer（activeKey 置空以便同库多 Offer 共存）。 */ + private Offer newSentOffer(Long studentId) { + Job job = jobRepository.findAll().get(0); + Application app = applicationRepository.save(Application.builder() + .jobId(job.getId()).studentUserId(studentId).status("SUBMITTED").build()); + return offerRepository.saveAndFlush(Offer.builder() + .applicationId(app.getId()).jobId(job.getId()).companyId(companyId) + .candidateId(studentId) + .title("F1 Offer").description("d").expireAt(LocalDateTime.now().minusDays(1)) + .status(OfferStatus.SENT.name()).activeKey(null) + .createdBy(companyUserId).updatedBy(companyUserId) + .build()); + } + + private Long newStudent(String tag) { + User u = userRepository.save(User.builder() + .phone("197" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("F1学生" + tag).role(User.Role.STUDENT).active(true).verified(true).build()); + u.setRoles(java.util.Set.of(User.Role.STUDENT)); + return u.getId(); + } + + @Test + void expireOne_marksOfferExpired_andRegistersRefreshTaskForCandidate() { + Long studentId = newStudent("A"); + Offer offer = newSentOffer(studentId); + + worker.expireOne(offer.getId()); + + // 1) Offer 状态确实被改为 EXPIRED（真实数据库） + assertEquals(OfferStatus.EXPIRED.name(), + offerRepository.findById(offer.getId()).orElseThrow().getStatus()); + // 2) 同一业务事务内登记了该学生的刷新任务（真实数据库） + assertEquals(1L, taskCount(studentId), + "Offer 自动过期必须为该候选人登记恰好一条评分刷新任务"); + String taskPeriod = jdbcTemplate.queryForObject( + "SELECT target_period FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + String.class, studentId); + assertEquals(period(), taskPeriod); + } + + @Test + void expireOne_repeatedExecution_keepsSingleTask() { + Long studentId = newStudent("B"); + Offer offer = newSentOffer(studentId); + + worker.expireOne(offer.getId()); + worker.expireOne(offer.getId()); // 第二次：状态已是 EXPIRED，幂等返回 + worker.expireOne(offer.getId()); + + assertEquals(1L, taskCount(studentId), "重复执行不得产生多条刷新任务"); + } + + @Test + void expireOne_multipleOffersOfDifferentStudents_registerSeparately() { + Long studentA = newStudent("C"); + Long studentB = newStudent("D"); + Offer a = newSentOffer(studentA); + Offer b = newSentOffer(studentB); + + worker.expireOne(a.getId()); + worker.expireOne(b.getId()); + + assertEquals(1L, taskCount(studentA), "学生 A 应各自登记一条"); + assertEquals(1L, taskCount(studentB), "学生 B 应各自登记一条"); + Long total = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks", Long.class); + assertEquals(2L, total, "两个不同学生应产生两条独立任务"); + } + + @Test + void expireOne_rollback_rollsBackOfferStatusAndRefreshTaskTogether() { + Long studentId = newStudent("E"); + Offer offer = newSentOffer(studentId); + + // 制造"同一事务内后续步骤失败" → 整个 expireOne 事务回滚 + doThrow(new org.springframework.dao.DataAccessException("boom") {}) + .when(counterOfferRepository).expirePendingByOfferId(anyLong()); + + assertThrows(RuntimeException.class, () -> worker.expireOne(offer.getId())); + + assertEquals(OfferStatus.SENT.name(), + offerRepository.findById(offer.getId()).orElseThrow().getStatus(), + "事务回滚后 Offer 状态必须保持原值"); + assertEquals(0L, taskCount(studentId), + "事务回滚后不得留下孤立的刷新任务"); + } + + @Test + void expireOne_refreshRegistrationAddsNoNotificationRows() { + Long studentId = newStudent("F"); + Offer offer = newSentOffer(studentId); + + long globalBefore = notificationCount(null); + + worker.expireOne(offer.getId()); + + long globalAfter = notificationCount(null); + // Offer 过期通知由既有 notifyExpired 走通知通道（测试 profile 下经 MQ 开关关闭的路径）， + // 本断言只要求：新增的刷新登记不得额外插入通知行。 + assertEquals(globalBefore, globalAfter, + "刷新登记不得引入任何 notifications 行"); + } + + @Test + void requestRefresh_alone_createsNoNotificationsAndNoMessages() { + Long studentId = newStudent("H"); + long nBefore = notificationCount(null); + long mBefore = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM messages", Long.class); + + requestService.requestRefresh(studentId, LocalDateTime.now()); + + assertEquals(nBefore, notificationCount(null), "纯登记不得写通知"); + assertEquals(mBefore, jdbcTemplate.queryForObject("SELECT COUNT(*) FROM messages", Long.class), + "纯登记不得写消息"); + assertEquals(1L, taskCount(studentId), "纯登记只登记任务"); + } + + @Test + void expireOne_refreshTaskCarriesNoSensitiveFields() { + Long studentId = newStudent("G"); + Offer offer = newSentOffer(studentId); + + worker.expireOne(offer.getId()); + + List cols = jdbcTemplate.queryForList( + "SELECT column_name FROM information_schema.columns " + + "WHERE table_name='CANDIDATE_SCORING_REFRESH_TASKS' AND table_schema='PUBLIC'", + String.class); + if (cols.isEmpty()) { // H2 大小写差异兜底 + cols = List.of("id", "student_user_id", "target_period", "status", "requested_at", + "processing_started_at", "processed_at", "next_attempt_at", "attempts", + "last_error_code", "version", "created_at", "updated_at"); + } + // claim_token 是 V45 引入的所有权令牌（随机 UUID），不是用户凭据，属允许列； + // 其余用户凭据/隐私列一律禁止。 + for (String banned : List.of("PHONE", "EMAIL", "REASON", "CONTENT", "SALARY", + "ACCESS_TOKEN", "REFRESH_TOKEN", "PASSWORD", "SECRET")) { + assertTrue(cols.stream().noneMatch(c -> c.toUpperCase().contains(banned)), + "刷新任务表不得含敏感列: " + banned); + } + assertTrue(cols.stream().anyMatch(c -> "CLAIM_TOKEN".equalsIgnoreCase(c)), + "V45 必须提供 claim_token 所有权令牌列"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryWorkerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryWorkerTest.java index 06ea97c..d6153bc 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryWorkerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferExpiryWorkerTest.java @@ -27,6 +27,9 @@ class OfferExpiryWorkerTest { @Mock private OfferCounterOfferRepository counterOfferRepository; @Mock private CompanyRepository companyRepository; @Mock private NotificationService notificationService; + /** R01-D4-2 F1：Offer 过期必须登记评分刷新任务。 */ + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService + scoringRefreshRequestService; @InjectMocks private OfferExpiryWorker worker; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferServiceTest.java index 14d5421..efebc5a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/offer/OfferServiceTest.java @@ -51,6 +51,7 @@ class OfferServiceTest { @Mock private UserRepository userRepository; @Mock private NotificationService notificationService; @Mock private AuditService auditService; + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; @InjectMocks private OfferService offerService; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/preference/PreferenceServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/preference/PreferenceServiceTest.java index d59ef99..226b7f2 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/preference/PreferenceServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/preference/PreferenceServiceTest.java @@ -2,6 +2,8 @@ package com.mydreamjob.preference; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.preference.dto.StudentPreferenceRequest; @@ -28,6 +30,12 @@ class PreferenceServiceTest { @Mock private UserRepository userRepository; + @Mock + private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; + + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private PreferenceService preferenceService; @@ -38,6 +46,9 @@ class PreferenceServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + pref = StudentPreference.builder() .id(1L).studentUserId(STUDENT_ID) .expectedSalaryMin(10000).expectedSalaryMax(20000) diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsControllerTest.java index 4cf54f1..e71de14 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsControllerTest.java @@ -75,8 +75,7 @@ class PrivacySettingsControllerTest { } private String studentToken(long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken( - userId, String.valueOf(PHONE.getAndIncrement()), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } // ── GET：STUDENT 成功 + 无记录默认值 ────────────────────── @@ -312,7 +311,9 @@ class PrivacySettingsControllerTest { assertThat(put.path("requestBody").toString().contains("PrivacySettingsUpdateRequest")).isTrue(); // 无敏感字段 - String schemas = root.path("components").path("schemas").toString().toLowerCase(); - assertFalse(schemas.contains("password")); + String responseSchema = get.path("responses").path("200").toString().toLowerCase(); + assertThat(responseSchema.contains("\"password\"")).isFalse(); + assertThat(responseSchema.contains("\"passwordhash\"")).isFalse(); + assertThat(responseSchema.contains("\"token\"")).isFalse(); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsServiceTest.java index cab1c3c..ba0c093 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/privacy/PrivacySettingsServiceTest.java @@ -1,14 +1,13 @@ package com.mydreamjob.privacy; -import com.mydreamjob.application.Application; -import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.application.CompanyResumeAccessPolicy; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; -import com.mydreamjob.company.Company; -import com.mydreamjob.company.CompanyRepository; import com.mydreamjob.privacy.dto.PrivacySettingsResponse; import com.mydreamjob.privacy.dto.PrivacySettingsUpdateRequest; import org.junit.jupiter.api.BeforeEach; @@ -32,10 +31,12 @@ class PrivacySettingsServiceTest { @Mock private StudentPrivacySettingsRepository privacyRepository; @Mock private UserRepository userRepository; - @Mock private ApplicationRepository applicationRepository; - @Mock private CompanyRepository companyRepository; + @Mock private CompanyResumeAccessPolicy companyResumeAccessPolicy; @Mock private AuditService auditService; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private PrivacySettingsService service; private static final Long STUDENT_ID = 10L; @@ -44,6 +45,9 @@ class PrivacySettingsServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + lenient().doNothing().when(auditService).log(any(), any(), any(), any(), any(), any()); } @@ -205,84 +209,14 @@ class PrivacySettingsServiceTest { // ── 隐私策略 ───────────────────────────────────────────── @Test - void canCompanyViewResume_private_alwaysFalseEvenWithVerifiedCompany() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.PRIVATE, false))); - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_defaultPrivate_whenNoRecord() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)).thenReturn(Optional.empty()); - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_appliedCompanies_validApplication_visible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.APPLIED_COMPANIES, false))); - Application app = Application.builder().id(APP_ID).studentUserId(STUDENT_ID).status("SUBMITTED").build(); - when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of(app)); - - assertTrue(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_appliedCompanies_withdrawn_notVisible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.APPLIED_COMPANIES, false))); - Application app = Application.builder().id(APP_ID).studentUserId(STUDENT_ID).status("WITHDRAWN").build(); - when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of(app)); - - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_appliedCompanies_rejected_notVisible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.APPLIED_COMPANIES, false))); - Application app = Application.builder().id(APP_ID).studentUserId(STUDENT_ID).status("REJECTED").build(); - when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of(app)); - - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_appliedCompanies_wrongStudent_notVisible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.APPLIED_COMPANIES, false))); - Application app = Application.builder().id(APP_ID).studentUserId(999L).status("SUBMITTED").build(); - when(applicationRepository.findById(APP_ID)).thenReturn(Optional.of(app)); - - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_verifiedCompanies_verifiedCompany_visible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.VERIFIED_COMPANIES, false))); - when(companyRepository.findById(COMPANY_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID).verified(true).build())); - + void canCompanyViewResume_delegatesToAccessPolicy() { + // S03-B：判定逻辑已收束到失败关闭的 CompanyResumeAccessPolicy，本服务只负责委托。 + // 完整决策矩阵（含公司归属）由 CompanyResumeAccessPolicyTest 覆盖； + // 原先在此断言"已验证企业无需拥有岗位即可查看简历"的用例编码的正是被修复的缺陷，故一并移除。 + when(companyResumeAccessPolicy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(true); assertTrue(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_verifiedCompanies_unverifiedCompany_notVisible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.VERIFIED_COMPANIES, false))); - when(companyRepository.findById(COMPANY_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID).verified(false).build())); - - assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); - } - - @Test - void canCompanyViewResume_verifiedCompanies_unknownCompany_notVisible() { - when(privacyRepository.findByStudentUserId(STUDENT_ID)) - .thenReturn(Optional.of(settings(ResumeVisibility.VERIFIED_COMPANIES, false))); - when(companyRepository.findById(COMPANY_ID)).thenReturn(Optional.empty()); + when(companyResumeAccessPolicy.isVisible(STUDENT_ID, COMPANY_ID, APP_ID)).thenReturn(false); assertFalse(service.canCompanyViewResume(STUDENT_ID, COMPANY_ID, APP_ID)); } } \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileControllerTest.java index 6bdd31d..e24604a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileControllerTest.java @@ -82,8 +82,7 @@ class ProfileControllerTest { } private String bearerToken(long userId, String phone) { - return "Bearer " + jwtTokenProvider.generateAccessToken( - userId, phone, Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } private String studentToken(long userId) { @@ -259,7 +258,9 @@ class ProfileControllerTest { assertThat(get.path("responses").has("403")).isTrue(); // 无敏感字段（DTO schema 不含 password 等） - String schemas = root.path("components").path("schemas").toString().toLowerCase(); - assertFalse(schemas.contains("password")); + String responseSchema = get.path("responses").path("200").toString().toLowerCase(); + assertThat(responseSchema.contains("\"password\"")).isFalse(); + assertThat(responseSchema.contains("\"passwordhash\"")).isFalse(); + assertThat(responseSchema.contains("\"token\"")).isFalse(); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileServiceTest.java index 8e7a9a4..453495b 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ProfileServiceTest.java @@ -21,6 +21,9 @@ class ProfileServiceTest { @Mock private StudentProfileRepository profileRepository; + @Mock + private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; + @InjectMocks private ProfileService profileService; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeControllerTest.java index 1f4706b..ceca14a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeControllerTest.java @@ -4,12 +4,15 @@ 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.common.logging.RequestIdAccessor; import com.mydreamjob.profile.storage.ResumeStorageService; +import com.mydreamjob.security.CurrentUserAccessor; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; import org.mockito.Mock; +import org.mockito.Spy; import org.mockito.junit.jupiter.MockitoExtension; import org.springframework.http.HttpHeaders; import org.springframework.http.HttpStatus; @@ -17,6 +20,7 @@ import org.springframework.http.MediaType; import org.springframework.mock.web.MockHttpServletRequest; import org.springframework.mock.web.MockMultipartFile; import org.springframework.http.ResponseEntity; +import org.springframework.security.authentication.InsufficientAuthenticationException; import org.springframework.security.core.Authentication; import org.springframework.security.core.context.SecurityContext; import org.springframework.security.core.context.SecurityContextHolder; @@ -37,6 +41,14 @@ class ResumeControllerTest { @Mock private Authentication authentication; + /** R01-A：Controller 身份解析已收束到唯一的 CurrentUserAccessor。 */ + @Spy + private CurrentUserAccessor currentUserAccessor = new CurrentUserAccessor(); + + /** R01-A：requestId 已收束到 RequestIdAccessor。 */ + @Spy + private RequestIdAccessor requestIdAccessor = new RequestIdAccessor(); + @InjectMocks private ProfileController controller; @@ -65,7 +77,10 @@ class ResumeControllerTest { MockMultipartFile file = new MockMultipartFile("file", "r.pdf", "application/pdf", "data".getBytes()); - assertThrows(BusinessException.class, + // R01-A：未登录语义由 CurrentUserAccessor 统一产出 + // （InsufficientAuthenticationException 由 GlobalExceptionHandler 映射为 401）， + // 不再由 Controller 自己抛 BusinessException(2001)。 + assertThrows(InsufficientAuthenticationException.class, () -> controller.uploadResume(file, request)); } @@ -221,4 +236,20 @@ class ResumeControllerTest { "application/vnd.openxmlformats-officedocument.wordprocessingml.document"), resp.getHeaders().getContentType()); } + + @Test + void downloadResume_legacyUnsafeFilenameCannotInjectResponseHeader() { + mockAuth(STUDENT_ID); + ProfileService.ResumeFile rf = new ProfileService.ResumeFile( + "..\\resume\r\nX-Injected: secret.pdf", "application/pdf", "data".getBytes()); + when(profileService.getResume(STUDENT_ID)).thenReturn(rf); + + var resp = controller.downloadResume(request); + + String contentDisposition = resp.getHeaders().getFirst(HttpHeaders.CONTENT_DISPOSITION); + assertNotNull(contentDisposition); + assertFalse(contentDisposition.contains("\r")); + assertFalse(contentDisposition.contains("\n")); + assertFalse(contentDisposition.contains("X-Injected:")); + } } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeServiceTest.java index e8bd16b..e5b5c36 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeServiceTest.java @@ -3,13 +3,17 @@ package com.mydreamjob.profile; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.profile.storage.ResumeStorageService; +import com.mydreamjob.profile.storage.ResumeFileValidator; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; import org.mockito.Mock; +import org.mockito.Spy; import org.mockito.junit.jupiter.MockitoExtension; import org.springframework.mock.web.MockMultipartFile; import org.springframework.web.multipart.MultipartFile; @@ -32,6 +36,12 @@ class ResumeServiceTest { @Mock private UserRepository userRepository; + @Spy + private ResumeFileValidator resumeFileValidator = new ResumeFileValidator(); + + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private ProfileService profileService; @@ -41,6 +51,9 @@ class ResumeServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + profile = StudentProfile.builder() .id(1L).userId(STUDENT_ID).realName("张三") .resumeUrl("old_resume.pdf") @@ -70,7 +83,7 @@ class ResumeServiceTest { void uploadResume_asStudent_shouldSucceed() { mockStudentRole(); MultipartFile file = new MockMultipartFile("file", "resume.pdf", - "application/pdf", "content".getBytes()); + "application/pdf", validPdf("content")); when(profileRepository.findByUserId(STUDENT_ID)).thenReturn(Optional.of(profile)); when(storageService.store(eq(STUDENT_ID), any())).thenReturn("new_resume.pdf"); @@ -88,7 +101,7 @@ class ResumeServiceTest { void uploadResume_noExistingProfile_shouldCreateProfile() { mockStudentRole(); MultipartFile file = new MockMultipartFile("file", "r.pdf", - "application/pdf", "content".getBytes()); + "application/pdf", validPdf("content")); when(profileRepository.findByUserId(STUDENT_ID)).thenReturn(Optional.empty()); when(storageService.store(eq(STUDENT_ID), any())).thenReturn("r.pdf"); @@ -159,6 +172,58 @@ class ResumeServiceTest { () -> profileService.uploadResume(STUDENT_ID, file)); } + @Test + void uploadResume_fakePdfContent_shouldReturn400AndNotStore() { + mockStudentRole(); + MultipartFile file = new MockMultipartFile("file", "resume.pdf", + "application/pdf", "".getBytes()); + + assertThrows(BusinessException.class, + () -> profileService.uploadResume(STUDENT_ID, file)); + + verify(storageService, never()).store(anyLong(), any()); + } + + @Test + void uploadResume_storageFailure_keepsOldFile() { + mockStudentRole(); + MultipartFile file = new MockMultipartFile("file", "resume.pdf", + "application/pdf", validPdf("content")); + when(profileRepository.findByUserId(STUDENT_ID)).thenReturn(Optional.of(profile)); + when(storageService.store(eq(STUDENT_ID), any())).thenThrow(new RuntimeException("disk full")); + + assertThrows(RuntimeException.class, () -> profileService.uploadResume(STUDENT_ID, file)); + + verify(storageService, never()).delete("old_resume.pdf"); + verify(profileRepository, never()).save(any()); + } + + @Test + void uploadResume_databaseFailure_cleansNewFileAndKeepsOldFile() { + mockStudentRole(); + MultipartFile file = new MockMultipartFile("file", "resume.pdf", + "application/pdf", validPdf("content")); + when(profileRepository.findByUserId(STUDENT_ID)).thenReturn(Optional.of(profile)); + when(storageService.store(eq(STUDENT_ID), any())).thenReturn("new_resume.pdf"); + when(profileRepository.save(any())).thenThrow(new RuntimeException("database unavailable")); + + assertThrows(RuntimeException.class, () -> profileService.uploadResume(STUDENT_ID, file)); + + verify(storageService).delete("new_resume.pdf"); + verify(storageService, never()).delete("old_resume.pdf"); + } + + @Test + void deleteResume_databaseFailure_keepsStoredFile() { + mockStudentRole(); + when(profileRepository.findByUserId(STUDENT_ID)).thenReturn(Optional.of(profile)); + when(profileRepository.save(any())).thenThrow(new RuntimeException("database unavailable")); + + assertThrows(RuntimeException.class, () -> profileService.deleteResume(STUDENT_ID)); + + verify(storageService, never()).delete("old_resume.pdf"); + } + // ── 获取 / 删除 ────────────────────────────────────────── @Test @@ -187,4 +252,9 @@ class ResumeServiceTest { assertNull(profile.getResumeContentType()); assertNull(profile.getResumeSize()); } + + private byte[] validPdf(String content) { + return ("%PDF-1.7\n" + content + "\n%%EOF\n") + .getBytes(java.nio.charset.StandardCharsets.US_ASCII); + } } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeUploadConsistencyIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeUploadConsistencyIntegrationTest.java new file mode 100644 index 0000000..027b7f7 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/ResumeUploadConsistencyIntegrationTest.java @@ -0,0 +1,153 @@ +package com.mydreamjob.profile; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.profile.storage.ResumeStorageService; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.mock.web.MockMultipartFile; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.support.TransactionTemplate; + +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@SpringBootTest +@ActiveProfiles("integration-test") +class ResumeUploadConsistencyIntegrationTest { + + private static final AtomicLong PHONE_SEQUENCE = new AtomicLong(800_000); + + @Autowired private ProfileService profileService; + @Autowired private StudentProfileRepository profileRepository; + @Autowired private UserRepository userRepository; + @Autowired private ResumeStorageService storageService; + @Autowired private PlatformTransactionManager transactionManager; + + @MockBean private RedisTemplate redisTemplate; + + private final List testStoragePaths = new ArrayList<>(); + private Long userId; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations operations = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(operations); + when(redisTemplate.hasKey(any())).thenReturn(false); + + User user = User.builder() + .phone("177" + String.format("%08d", PHONE_SEQUENCE.incrementAndGet())) + .nickname("上传一致性测试") + .role(User.Role.STUDENT) + .active(true) + .verified(true) + .build(); + user.setRoles(new HashSet<>(Set.of(User.Role.STUDENT))); + userId = userRepository.saveAndFlush(user).getId(); + } + + @AfterEach + void tearDown() { + for (String path : testStoragePaths) { + storageService.delete(path); + } + profileRepository.findByUserId(userId).ifPresent(profileRepository::delete); + userRepository.findById(userId).ifPresent(userRepository::delete); + } + + @Test + void successfulReplacementCommitsNewReferenceBeforeDeletingOldFile() { + String oldPath = store(pdf("old")); + saveProfile(oldPath, "old.pdf"); + + @SuppressWarnings("unchecked") + String newPath = (String) profileService.uploadResume(userId, multipart("new.pdf", pdf("new"))) + .get("resumeUrl"); + testStoragePaths.add(newPath); + + StudentProfile persisted = profileRepository.findByUserId(userId).orElseThrow(); + assertEquals(newPath, persisted.getResumeUrl()); + assertArrayEquals(pdf("new"), storageService.read(newPath)); + assertThrows(BusinessException.class, () -> storageService.read(oldPath)); + } + + @Test + void outerRollbackRestoresOldReferenceAndDeletesOnlyNewFile() { + String oldPath = store(pdf("old")); + saveProfile(oldPath, "old.pdf"); + TransactionTemplate transaction = new TransactionTemplate(transactionManager); + + String newPath = transaction.execute(status -> { + String stored = (String) profileService.uploadResume(userId, multipart("new.pdf", pdf("new"))) + .get("resumeUrl"); + testStoragePaths.add(stored); + status.setRollbackOnly(); + return stored; + }); + + StudentProfile persisted = profileRepository.findByUserId(userId).orElseThrow(); + assertEquals(oldPath, persisted.getResumeUrl()); + assertArrayEquals(pdf("old"), storageService.read(oldPath)); + assertThrows(BusinessException.class, () -> storageService.read(newPath)); + } + + @Test + void deleteRollbackKeepsDatabaseReferenceAndStoredFile() { + String oldPath = store(pdf("old")); + saveProfile(oldPath, "old.pdf"); + TransactionTemplate transaction = new TransactionTemplate(transactionManager); + + transaction.executeWithoutResult(status -> { + profileService.deleteResume(userId); + status.setRollbackOnly(); + }); + + StudentProfile persisted = profileRepository.findByUserId(userId).orElseThrow(); + assertEquals(oldPath, persisted.getResumeUrl()); + assertArrayEquals(pdf("old"), storageService.read(oldPath)); + } + + private String store(byte[] content) { + String path = storageService.store(userId, multipart("resume.pdf", content)); + testStoragePaths.add(path); + return path; + } + + private void saveProfile(String path, String filename) { + profileRepository.saveAndFlush(StudentProfile.builder() + .userId(userId) + .resumeUrl(path) + .resumeOriginalName(filename) + .resumeContentType("application/pdf") + .resumeSize((long) pdf("old").length) + .build()); + } + + private MockMultipartFile multipart(String filename, byte[] content) { + return new MockMultipartFile("file", filename, "application/pdf", content); + } + + private byte[] pdf(String body) { + return ("%PDF-1.7\n" + body + "\n%%EOF\n").getBytes(StandardCharsets.US_ASCII); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/LocalResumeStorageServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/LocalResumeStorageServiceTest.java index 64d4d6c..0520ec4 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/LocalResumeStorageServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/LocalResumeStorageServiceTest.java @@ -9,7 +9,8 @@ import org.springframework.web.multipart.MultipartFile; import java.nio.file.Files; import java.nio.file.Path; -import java.util.Arrays; +import java.io.IOException; +import java.io.InputStream; import static org.junit.jupiter.api.Assertions.*; @@ -105,6 +106,32 @@ class LocalResumeStorageServiceTest { assertNotNull(path); } + @Test + void store_interruptedCopy_removesTemporaryAndFinalFiles() throws Exception { + MultipartFile file = new MockMultipartFile("file", "resume.pdf", "application/pdf", "ignored".getBytes()) { + @Override + public InputStream getInputStream() { + return new InputStream() { + private final byte[] content = "partial-content".getBytes(); + private int position; + + @Override + public int read() throws IOException { + if (position >= 4) { + throw new IOException("simulated interrupted upload"); + } + return content[position++]; + } + }; + } + }; + + assertThrows(RuntimeException.class, () -> service.store(6L, file)); + try (var files = Files.list(tempDir)) { + assertEquals(0, files.count(), "failed upload must leave neither final nor .uploading files"); + } + } + // ── 文件不存在 ──────────────────────────────────────────── @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/ResumeFileValidatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/ResumeFileValidatorTest.java new file mode 100644 index 0000000..f3d3ddc --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/profile/storage/ResumeFileValidatorTest.java @@ -0,0 +1,142 @@ +package com.mydreamjob.profile.storage; + +import com.mydreamjob.common.exception.BusinessException; +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockMultipartFile; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.util.zip.ZipEntry; +import java.util.zip.ZipOutputStream; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; +import static org.junit.jupiter.api.Assertions.assertThrows; + +class ResumeFileValidatorTest { + + private final ResumeFileValidator validator = new ResumeFileValidator(); + + @Test + void validPdfDocAndDocxAreAccepted() throws Exception { + assertDoesNotThrow(() -> validator.validate(file("resume.pdf", "application/pdf", pdf("profile")))); + assertDoesNotThrow(() -> validator.validate(file("resume.doc", "application/msword", legacyDoc()))); + assertDoesNotThrow(() -> validator.validate(file("resume.docx", docxType(), docx("docProps/core.xml", "profile")))); + } + + @Test + void fakePdfAndFakeLegacyDocAreRejected() { + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.pdf", "application/pdf", "not a pdf".getBytes()))); + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.doc", "application/msword", "not a doc".getBytes()))); + } + + @Test + void extensionContentTypeMismatchIsRejectedEvenWhenSignatureLooksValid() { + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.pdf", "application/msword", pdf("profile")))); + } + + @Test + void arbitraryZipAndMissingDocumentPartAreRejected() throws Exception { + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.docx", docxType(), + zip(new Entry("payload.txt", "not office"))))); + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.docx", docxType(), + zip(new Entry("[Content_Types].xml", "types"))))); + } + + @Test + void docxPathTraversalEntryIsRejected() throws Exception { + byte[] malicious = zip( + new Entry("[Content_Types].xml", "types"), + new Entry("word/document.xml", "document"), + new Entry("../outside.txt", "secret")); + + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.docx", docxType(), malicious))); + } + + @Test + void highlyCompressedDocxPayloadIsRejected() throws Exception { + byte[] repeated = new byte[1024 * 1024]; + byte[] bomb = zip( + new Entry("[Content_Types].xml", "types"), + new Entry("word/document.xml", "document"), + new Entry("word/media/bomb.bin", repeated)); + + assertThrows(BusinessException.class, + () -> validator.validate(file("resume.docx", docxType(), bomb))); + } + + @Test + void unsafeOrOversizedFilenameIsRejected() { + assertThrows(BusinessException.class, + () -> validator.validate(file("..\\resume.pdf", "application/pdf", pdf("profile")))); + assertThrows(BusinessException.class, + () -> validator.validate(file("resume\r\nX-Test.pdf", "application/pdf", pdf("profile")))); + assertThrows(BusinessException.class, + () -> validator.validate(file("a".repeat(252) + ".pdf", "application/pdf", pdf("profile")))); + } + + @Test + void downloadFilenameSanitizerProtectsLegacyMetadata() { + String safe = ResumeFilenameSanitizer.forDownload("..\\old\r\nInjected: value.pdf", "resume.pdf"); + org.junit.jupiter.api.Assertions.assertFalse(safe.contains("\\")); + org.junit.jupiter.api.Assertions.assertFalse(safe.contains("\r")); + org.junit.jupiter.api.Assertions.assertFalse(safe.contains("\n")); + org.junit.jupiter.api.Assertions.assertFalse(safe.contains(":")); + } + + static byte[] pdf(String body) { + return ("%PDF-1.7\n" + body + "\n%%EOF\n").getBytes(java.nio.charset.StandardCharsets.US_ASCII); + } + + static byte[] legacyDoc() { + byte[] marker = "WordDocument".getBytes(java.nio.charset.StandardCharsets.UTF_16LE); + byte[] bytes = new byte[512 + marker.length]; + byte[] signature = { + (byte) 0xD0, (byte) 0xCF, 0x11, (byte) 0xE0, + (byte) 0xA1, (byte) 0xB1, 0x1A, (byte) 0xE1 + }; + System.arraycopy(signature, 0, bytes, 0, signature.length); + System.arraycopy(marker, 0, bytes, 512, marker.length); + return bytes; + } + + static byte[] docx(String extraName, String extraContent) throws IOException { + return zip( + new Entry("[Content_Types].xml", ""), + new Entry("word/document.xml", ""), + new Entry(extraName, extraContent)); + } + + private static byte[] zip(Entry... entries) throws IOException { + ByteArrayOutputStream output = new ByteArrayOutputStream(); + try (ZipOutputStream zip = new ZipOutputStream(output)) { + for (Entry entry : entries) { + zip.putNextEntry(new ZipEntry(entry.name())); + if (entry.bytes() != null) { + zip.write(entry.bytes()); + } + zip.closeEntry(); + } + } + return output.toByteArray(); + } + + private static MockMultipartFile file(String name, String contentType, byte[] content) { + return new MockMultipartFile("file", name, contentType, content); + } + + private static String docxType() { + return "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; + } + + private record Entry(String name, byte[] bytes) { + Entry(String name, String content) { + this(name, content.getBytes(java.nio.charset.StandardCharsets.UTF_8)); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculatorTest.java new file mode 100644 index 0000000..f5f858f --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobPreferenceScoreCalculatorTest.java @@ -0,0 +1,80 @@ +package com.mydreamjob.recommendation; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.Arrays; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +class JobPreferenceScoreCalculatorTest { + + @Test + void noAvailablePreferenceReturnsNull() { + assertNull(score(criteria(List.of(), List.of(), null, List.of(), List.of()), target())); + } + + @Test + void allFiveSignalsMatchReturnsOneHundred() { + assertEquals(new BigDecimal("100.00"), score(fullCriteria(), target())); + } + + @Test + void noSignalMatchesReturnsZeroWithTwoDecimals() { + JobPreferenceScoreCalculator.Target other = new JobPreferenceScoreCalculator.Target( + "Shenzhen", "PART_TIME", 9999, "FINANCE", "SALES"); + assertEquals(new BigDecimal("0.00"), score(fullCriteria(), other)); + } + + @Test + void weightsAndHalfUpRoundingRemainThirtyTwentyTwentyFifteenFifteen() { + JobPreferenceScoreCalculator.Criteria criteria = criteria( + List.of("Shanghai"), List.of(), null, List.of("FINANCE"), List.of()); + assertEquals(new BigDecimal("66.67"), score(criteria, target())); + } + + @Test + void salaryBoundaryIsInclusiveAndNullMaximumDoesNotMatch() { + JobPreferenceScoreCalculator.Criteria salaryOnly = + criteria(List.of(), List.of(), 20000, List.of(), List.of()); + assertEquals(new BigDecimal("100.00"), score(salaryOnly, + new JobPreferenceScoreCalculator.Target(null, null, 20000, null, null))); + assertEquals(new BigDecimal("0.00"), score(salaryOnly, + new JobPreferenceScoreCalculator.Target(null, null, null, null, null))); + } + + @Test + void nullCollectionsAreTreatedAsUnavailable() { + assertNull(score(new JobPreferenceScoreCalculator.Criteria(null, null, null, null, null), target())); + } + + @Test + void nullElementsInsideConfiguredListsRemainTolerated() { + JobPreferenceScoreCalculator.Criteria criteria = criteria( + Arrays.asList(null, "Shanghai"), List.of(), null, List.of(), List.of()); + assertEquals(new BigDecimal("100.00"), score(criteria, target())); + } + + private BigDecimal score(JobPreferenceScoreCalculator.Criteria criteria, + JobPreferenceScoreCalculator.Target target) { + return JobPreferenceScoreCalculator.calculate(criteria, target); + } + + private JobPreferenceScoreCalculator.Criteria fullCriteria() { + return criteria(List.of("Shanghai"), List.of("FULL_TIME"), 20000, + List.of("TECH"), List.of("ENGINEERING")); + } + + private JobPreferenceScoreCalculator.Criteria criteria( + List cities, List types, Integer salary, + List industries, List families) { + return new JobPreferenceScoreCalculator.Criteria(cities, types, salary, industries, families); + } + + private JobPreferenceScoreCalculator.Target target() { + return new JobPreferenceScoreCalculator.Target( + "Shanghai", "FULL_TIME", 20000, "TECH", "ENGINEERING"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobRecommendationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobRecommendationServiceTest.java new file mode 100644 index 0000000..2aeb9b5 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/recommendation/JobRecommendationServiceTest.java @@ -0,0 +1,64 @@ +package com.mydreamjob.recommendation; + +import com.mydreamjob.application.ApplicationRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.preference.StudentPreferenceRepository; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.*; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.util.ReflectionTestUtils; + +import java.util.*; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.*; + +@ExtendWith(org.mockito.junit.jupiter.MockitoExtension.class) +class JobRecommendationServiceTest { + + @BeforeEach + void wireRoleGuard() { + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + } + @Mock JobRecommendationTaxonomyRepository taxonomyRepository; + @Mock JobRecommendationProfileRepository profileRepository; + @Mock StudentJobRecommendationFeedbackRepository feedbackRepository; + @Mock JobRepository jobRepository; + @Mock com.mydreamjob.job.JobService jobService; + @Mock com.mydreamjob.company.CompanyService companyService; + @Mock UserRepository userRepository; + @Mock StudentPreferenceRepository preferenceRepository; + @Mock ApplicationRepository applicationRepository; + @Mock com.mydreamjob.audit.AuditService auditService; + @Mock JdbcTemplate jdbcTemplate; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; + @InjectMocks JobRecommendationService service; + + @Test + void featureFlagOff_returnsFallbackWithoutReadingProfilesOrAssessments() { + ReflectionTestUtils.setField(service, "assessmentEnabled", false); + User student = User.builder().roles(Set.of(User.Role.STUDENT)).build(); + when(userRepository.findById(7L)).thenReturn(Optional.of(student)); + when(applicationRepository.findDistinctJobIdsByStudentUserId(7L)).thenReturn(List.of()); + when(feedbackRepository.findByStudentUserIdAndStatusAndFeedbackType(7L, "ACTIVE", "NOT_INTERESTED")).thenReturn(List.of()); + when(preferenceRepository.findByStudentUserId(7L)).thenReturn(Optional.empty()); + when(jobRepository.findByStatusOrderByCreatedAtDesc("PUBLISHED")).thenReturn(List.of(Job.builder().id(9L).title("后端工程师").city("上海").employmentType("FULL_TIME").status("PUBLISHED").build())); + + var page = service.recommend(7L, 0, 20); + + assertThat(page.getContent()).singleElement().satisfies(item -> { + assertThat(item.getMode()).isEqualTo("FALLBACK"); + assertThat(item.getScore()).isNull(); + }); + verifyNoInteractions(profileRepository, jdbcTemplate); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionControllerTest.java index 789e18f..54dfa7c 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionControllerTest.java @@ -58,7 +58,7 @@ class ResumeVersionControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(STUDENT_ID, "2", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_ID, "STUDENT"); } private Map versionView() { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPermissionControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPermissionControllerTest.java index 6335daa..da9cc6c 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPermissionControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPermissionControllerTest.java @@ -57,7 +57,8 @@ class ResumeVersionPermissionControllerTest { ownerUserId = createStudent(); otherUserId = createStudent(); - MockMultipartFile file = new MockMultipartFile("file", "r.pdf", "application/pdf", "data".getBytes()); + MockMultipartFile file = new MockMultipartFile("file", "r.pdf", "application/pdf", + "%PDF-1.7\npermission-fixture\n%%EOF\n".getBytes(java.nio.charset.StandardCharsets.US_ASCII)); ResumeVersion version = resumeVersionService.createVersion(ownerUserId, "秋招版", file); versionId = version.getId(); } @@ -70,7 +71,7 @@ class ResumeVersionPermissionControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, "1", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } // ── 另一学生访问 → 403 ──────────────────────────────────── diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPersistenceIntegrationTest.java index 135f93a..c896bbc 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPersistenceIntegrationTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionPersistenceIntegrationTest.java @@ -162,7 +162,7 @@ class ResumeVersionPersistenceIntegrationTest { ExecutorService pool = Executors.newFixedThreadPool(2); CountDownLatch start = new CountDownLatch(1); AtomicReference failure = new AtomicReference<>(); - MockMultipartFile file = new MockMultipartFile("file", "r.pdf", "application/pdf", "data".getBytes()); + MockMultipartFile file = new MockMultipartFile("file", "r.pdf", "application/pdf", pdf("data")); pool.submit(() -> runWithLatch(start, () -> resumeVersionService.createVersion(userId, "a", file), failure)); pool.submit(() -> runWithLatch(start, () -> resumeVersionService.createVersion(userId, "b", file), failure)); start.countDown(); @@ -183,8 +183,10 @@ class ResumeVersionPersistenceIntegrationTest { */ @Test void export_afterVersionModified_shouldUseOriginalFile() throws Exception { - MockMultipartFile fileA = new MockMultipartFile("file", "r.pdf", "application/pdf", "AAA".getBytes()); - MockMultipartFile fileB = new MockMultipartFile("file", "r2.pdf", "application/pdf", "BBB".getBytes()); + byte[] contentA = pdf("AAA"); + byte[] contentB = pdf("BBB"); + MockMultipartFile fileA = new MockMultipartFile("file", "r.pdf", "application/pdf", contentA); + MockMultipartFile fileB = new MockMultipartFile("file", "r2.pdf", "application/pdf", contentB); ResumeVersion v1 = resumeVersionService.createVersion(userId, "v1", fileA); ResumeExportTask task = resumeExportService.createExportTask(userId, v1.getId()); // 快照 = A 的路径 @@ -194,7 +196,7 @@ class ResumeVersionPersistenceIntegrationTest { ResumeExportTask done = awaitTerminal(task.getId()); assertEquals(ResumeExportTask.STATUS_SUCCESS, done.getStatus(), "导出应成功: " + done.getErrorMessage()); - assertArrayEquals("AAA".getBytes(), resumeExportStorageService.read(done.getOutputPath())); + assertArrayEquals(contentA, resumeExportStorageService.read(done.getOutputPath())); assertEquals("r.pdf", done.getOutputName()); } @@ -216,8 +218,8 @@ class ResumeVersionPersistenceIntegrationTest { */ @Test void updateVersion_outerRollback_shouldCleanNewFileAndKeepOldFileAndDb() throws Exception { - MockMultipartFile fileA = new MockMultipartFile("file", "r.pdf", "application/pdf", "AAA".getBytes()); - MockMultipartFile fileB = new MockMultipartFile("file", "r2.pdf", "application/pdf", "BBB".getBytes()); + MockMultipartFile fileA = new MockMultipartFile("file", "r.pdf", "application/pdf", pdf("AAA")); + MockMultipartFile fileB = new MockMultipartFile("file", "r2.pdf", "application/pdf", pdf("BBB")); ResumeVersion v1 = resumeVersionService.createVersion(userId, "v1", fileA); String pathA = v1.getFileStoragePath(); List before = listMyResumeFiles(); @@ -260,4 +262,9 @@ class ResumeVersionPersistenceIntegrationTest { failure.compareAndSet(null, t); } } + + private byte[] pdf(String content) { + return ("%PDF-1.7\n" + content + "\n%%EOF\n") + .getBytes(java.nio.charset.StandardCharsets.US_ASCII); + } } diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionRefreshAtomicityTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionRefreshAtomicityTest.java new file mode 100644 index 0000000..426074e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionRefreshAtomicityTest.java @@ -0,0 +1,139 @@ +package com.mydreamjob.resume; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.profile.storage.ResumeStorageService; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.data.redis.core.ValueOperations; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.mock.web.MockMultipartFile; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.transaction.support.TransactionTemplate; + +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * R01-D4-2 阻断缺陷 F3：简历版本行与评分刷新任务必须同一提交边界。 + * + *

    缺陷背景：{@code ResumeVersionWriter#saveNewVersion} 以 REQUIRES_NEW 独立提交版本行 + * （这是既有的一致性问题防护设计，不能简单移除），而 {@code createVersion} 在外层事务中 + * 登记刷新任务 —— 外层事务在提交阶段失败时，版本行已落库而刷新任务丢失。

    + * + *

    本测试断言真实数据库状态：外层事务回滚后，版本行存在则刷新任务必须同样存在。

    + * + *

    文件系统操作被 mock：本测试只验证数据库原子性，不把文件存储纳入数据库事务承诺。

    + */ +@SpringBootTest +@ActiveProfiles("integration-test") +class ResumeVersionRefreshAtomicityTest { + + @Autowired private ResumeVersionService service; + @Autowired private ResumeVersionRepository resumeVersionRepository; + @Autowired private UserRepository userRepository; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private TransactionTemplate txTemplate; + @MockBean private ResumeStorageService resumeStorageService; + @MockBean private RedisTemplate redisTemplate; + + private static final AtomicLong SEQ = new AtomicLong(7000); + + private Long userId; + + private long taskCount(Long uid) { + Long c = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM candidate_scoring_refresh_tasks WHERE student_user_id=?", + Long.class, uid); + return c == null ? -1 : c; + } + + /** 必须是带真实 PDF 签名的内容，否则 ResumeFileValidator 会拒绝。 */ + private MockMultipartFile file() { + return new MockMultipartFile("file", "resume.pdf", "application/pdf", + "%PDF-1.4\n1 0 obj\n<<>>\nendobj\ntrailer\n<<>>\n%%EOF\n".getBytes()); + } + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + when(resumeStorageService.store(anyLong(), any())).thenReturn("test/resume.pdf"); + + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + resumeVersionRepository.deleteAll(); + + User student = userRepository.save(User.builder() + .phone("194" + String.format("%08d", SEQ.incrementAndGet())) + .nickname("F3学生").role(User.Role.STUDENT).active(true).verified(true).build()); + student.setRoles(java.util.Set.of(User.Role.STUDENT)); + userId = student.getId(); + } + + /** 清理本类产生的行，避免污染同一 JVM 内共享的 H2 内存库。 */ + @org.junit.jupiter.api.AfterEach + void tearDown() { + jdbcTemplate.update("DELETE FROM candidate_scoring_refresh_tasks"); + jdbcTemplate.update("DELETE FROM resume_export_tasks"); + resumeVersionRepository.deleteAll(); + } + + @Test + void createVersion_success_registersRefreshTask() { + service.createVersion(userId, "我的简历", file()); + + assertEquals(1L, resumeVersionRepository.count(), "版本行已创建"); + assertEquals(1L, taskCount(userId), "createVersion 必须登记刷新任务"); + } + + @Test + void createVersion_outerTransactionRollsBack_versionRowAndTaskCommitTogether() { + // 外层事务包裹 createVersion，并在返回后抛出 → 外层回滚 + assertThrows(RuntimeException.class, () -> txTemplate.execute(status -> { + service.createVersion(userId, "外层回滚简历", file()); + throw new RuntimeException("outer transaction failed after createVersion"); + })); + + long versions = resumeVersionRepository.count(); + long tasks = taskCount(userId); + + // 既有设计：版本行由 REQUIRES_NEW 独立提交 → 外层回滚后仍然存在 + assertEquals(1L, versions, "版本行经独立事务提交，外层回滚不应使其消失"); + + // F3 核心断言：版本行存在则刷新任务必须同样存在（同一提交边界） + assertEquals(versions > 0 ? 1L : 0L, tasks, + "版本行已提交时刷新任务不得丢失（必须与版本行同一提交边界）"); + } + + @Test + void createVersion_neverLeavesTaskWithoutVersionRow() { + // 反向：不允许出现"有任务但没有版本行" + service.createVersion(userId, "正常简历", file()); + long versions = resumeVersionRepository.count(); + long tasks = taskCount(userId); + assertTrue(versions >= tasks, + "不得出现任务多于版本行的不一致状态 (versions=" + versions + ", tasks=" + tasks + ")"); + } + + @Test + void createVersion_repeatedRegistrations_convergeToOneTaskPerPeriod() { + service.createVersion(userId, "简历一", file()); + service.createVersion(userId, "简历二", file()); + service.createVersion(userId, "简历三", file()); + + assertEquals(3L, resumeVersionRepository.count(), "三个版本行"); + assertEquals(1L, taskCount(userId), + "同学生同周期重复登记必须收敛为一条任务"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionServiceTest.java index 5af310b..abe84c2 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/resume/ResumeVersionServiceTest.java @@ -31,6 +31,7 @@ class ResumeVersionServiceTest { @Mock private ResumeStorageService resumeStorageService; @Mock private ResumeVersionWriter versionWriter; @Mock private ProfileService profileService; + @Mock private com.mydreamjob.candidatescore.refresh.CandidateScoringRefreshRequestService scoringRefreshRequestService; @InjectMocks private ResumeVersionService resumeVersionService; diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewControllerTest.java index 66dbab4..f93fa99 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewControllerTest.java @@ -5,6 +5,7 @@ import com.fasterxml.jackson.databind.ObjectMapper; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.AfterEach; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; @@ -16,6 +17,7 @@ import org.springframework.data.domain.PageRequest; import org.springframework.data.redis.core.RedisTemplate; import org.springframework.data.redis.core.ValueOperations; import org.springframework.http.MediaType; +import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.test.context.ActiveProfiles; import org.springframework.test.web.servlet.MockMvc; @@ -41,29 +43,42 @@ class AdminReviewControllerTest { @Autowired private MockMvc mockMvc; @Autowired private com.mydreamjob.auth.JwtTokenProvider jwtTokenProvider; + @Autowired private JdbcTemplate jdbcTemplate; @MockBean private JobReviewService reviewService; @MockBean private RedisTemplate redisTemplate; private final ObjectMapper mapper = new ObjectMapper(); - private static final Long ADMIN_ID = 1L; - private static final Long STUDENT_ID = 100L; + static final Long ADMIN_ID = 9_320_001L; + static final Long STUDENT_ID = 9_320_002L; private static final Long REVIEW_ID = 1L; @BeforeEach @SuppressWarnings("unchecked") void setUp() { + removeFixtureUsers(); + ReviewControllerFixtureUsers.provision(jdbcTemplate, ADMIN_ID, "r01b-ar-admin", "ADMIN"); + ReviewControllerFixtureUsers.provision(jdbcTemplate, STUDENT_ID, "r01b-ar-student", "STUDENT"); ValueOperations ops = mock(ValueOperations.class); when(redisTemplate.opsForValue()).thenReturn(ops); when(redisTemplate.hasKey(any())).thenReturn(false); } + @AfterEach + void tearDown() { + removeFixtureUsers(); + } + + private void removeFixtureUsers() { + ReviewControllerFixtureUsers.remove(jdbcTemplate, ADMIN_ID, STUDENT_ID); + } + private String adminToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(ADMIN_ID, "1", Map.of("roles", "ADMIN")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(ADMIN_ID, "ADMIN"); } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(STUDENT_ID, "2", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_ID, "STUDENT"); } @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewReplyServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewReplyServiceTest.java new file mode 100644 index 0000000..07599e6 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/AdminReviewReplyServiceTest.java @@ -0,0 +1,111 @@ +package com.mydreamjob.review; + +import com.mydreamjob.audit.AuditService; +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.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.review.dto.ReviewReplyDecisionRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.Spy; +import org.mockito.junit.jupiter.MockitoExtension; +import org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; + +import java.util.HashSet; +import java.util.List; +import java.util.Optional; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class AdminReviewReplyServiceTest { + + @Mock private UserRepository userRepository; + @Mock private CompanyReviewReplyRepository replyRepository; + @Mock private CompanyReviewReplyHistoryRepository historyRepository; + @Mock private JobReviewRepository reviewRepository; + @Mock private JobRepository jobRepository; + @Mock private CompanyRepository companyRepository; + @Mock private AuditService auditService; + @Spy private com.fasterxml.jackson.databind.ObjectMapper objectMapper = new com.fasterxml.jackson.databind.ObjectMapper(); + @InjectMocks private AdminReviewReplyService service; + + private static final long ADMIN_ID = 1L; + private static final long REPLY_ID = 10L; + private static final long REVIEW_ID = 20L; + private static final long JOB_ID = 30L; + private static final long COMPANY_ID = 40L; + private CompanyReviewReply pending; + + @BeforeEach + void setUp() { + User admin = User.builder().id(ADMIN_ID).role(User.Role.ADMIN).active(true).build(); + admin.setRoles(new HashSet<>(Set.of(User.Role.ADMIN))); + when(userRepository.findById(ADMIN_ID)).thenReturn(Optional.of(admin)); + pending = CompanyReviewReply.builder().id(REPLY_ID).reviewId(REVIEW_ID).companyId(COMPANY_ID) + .content("感谢反馈").moderationStatus(CompanyReviewReply.PENDING).version(0L) + .moderationReason("[]").build(); + when(replyRepository.findById(REPLY_ID)).thenReturn(Optional.of(pending)); + when(replyRepository.decidePending(eq(REPLY_ID), eq(0L), any(), eq(ADMIN_ID), any())).thenReturn(1); + when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of( + JobReview.builder().id(REVIEW_ID).jobId(JOB_ID).rating(4).content("评价") + .moderationStatus(JobReview.MODERATION_AUTO_APPROVED).build())); + when(jobRepository.findById(JOB_ID)).thenReturn(Optional.of(Job.builder().id(JOB_ID).companyId(COMPANY_ID) + .title("后端工程师").build())); + when(companyRepository.findById(COMPANY_ID)).thenReturn(Optional.of(Company.builder().id(COMPANY_ID) + .name("Acme").build())); + } + + private ReviewReplyDecisionRequest request(String decision, String reason) { + ReviewReplyDecisionRequest req = new ReviewReplyDecisionRequest(); + req.setDecision(decision); + req.setReason(reason); + return req; + } + + @Test + void adminCanApprovePendingReplyAndWritesOneHistoryAndAudit() { + when(replyRepository.findById(REPLY_ID)).thenReturn(Optional.of(pending), Optional.of( + CompanyReviewReply.builder().id(REPLY_ID).reviewId(REVIEW_ID).companyId(COMPANY_ID) + .content("感谢反馈").moderationStatus(CompanyReviewReply.APPROVED).version(1L) + .moderationReason("[]").build())); + + var response = service.decide(ADMIN_ID, REPLY_ID, request("APPROVE", null), null); + + assertEquals(CompanyReviewReply.APPROVED, response.getReplyStatus()); + verify(historyRepository, times(1)).save(any()); + verify(auditService, times(1)).log(any(), eq("REVIEW_REPLY_APPROVED"), any(), any(), any(), any()); + } + + @Test + void rejectRequiresHumanReason() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.decide(ADMIN_ID, REPLY_ID, request("REJECT", " "), null)); + assertEquals(ErrorCode.REVIEW_REPLY_DECISION_INVALID.getCode(), ex.getErrorCodeInt()); + verify(replyRepository, never()).decidePending(any(), any(), any(), any(), any()); + } + + @Test + void nonAdminCannotDecide() { + User company = User.builder().id(2L).role(User.Role.COMPANY).active(true).build(); + company.setRoles(new HashSet<>(Set.of(User.Role.COMPANY))); + when(userRepository.findById(2L)).thenReturn(Optional.of(company)); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.decide(2L, REPLY_ID, request("APPROVE", null), null)); + assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementControllerTest.java new file mode 100644 index 0000000..9f1aaad --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementControllerTest.java @@ -0,0 +1,84 @@ +package com.mydreamjob.review; + +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.review.dto.ReviewReplyPageResponse; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.AfterEach; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.Map; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class CompanyReviewManagementControllerTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private CompanyReviewManagementService managementService; + @MockBean private CompanyReviewReplyService replyService; + @MockBean private RedisTemplate redisTemplate; + + static final long COMPANY_USER_ID = 9_320_011L; + static final long STUDENT_USER_ID = 9_320_012L; + + @BeforeEach + void setUpFixtureUsers() { + removeFixtureUsers(); + ReviewControllerFixtureUsers.provision(jdbcTemplate, COMPANY_USER_ID, "r01b-cr-company", "COMPANY"); + ReviewControllerFixtureUsers.provision(jdbcTemplate, STUDENT_USER_ID, "r01b-cr-student", "STUDENT"); + } + + @AfterEach + void tearDownFixtureUsers() { + removeFixtureUsers(); + } + + private void removeFixtureUsers() { + ReviewControllerFixtureUsers.remove(jdbcTemplate, COMPANY_USER_ID, STUDENT_USER_ID); + } + + private String token(long id, String role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(id, role); + } + + @Test + void unauthenticatedCannotAccessCompanyReviews() throws Exception { + mockMvc.perform(get("/companies/me/job-reviews")) + .andExpect(status().isUnauthorized()); + } + + @Test + void studentCannotAccessCompanyReviews() throws Exception { + when(managementService.listMine(eq(STUDENT_USER_ID), any(), any(), any(), any(), any(), any(), eq(0), eq(20))) + .thenThrow(new BusinessException(ErrorCode.FORBIDDEN)); + mockMvc.perform(get("/companies/me/job-reviews").header("Authorization", token(STUDENT_USER_ID, "STUDENT"))) + .andExpect(status().isForbidden()); + } + + @Test + void companyCanListItsReviews() throws Exception { + when(managementService.listMine(eq(COMPANY_USER_ID), any(), any(), any(), any(), any(), any(), eq(0), eq(20))) + .thenReturn(ReviewReplyPageResponse.builder().items(java.util.List.of()).total(0) + .page(0).size(20).totalPages(0).build()); + mockMvc.perform(get("/companies/me/job-reviews").header("Authorization", token(COMPANY_USER_ID, "COMPANY"))) + .andExpect(status().isOk()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementServiceTest.java new file mode 100644 index 0000000..51f1784 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewManagementServiceTest.java @@ -0,0 +1,59 @@ +package com.mydreamjob.review; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyService; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +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 org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; + +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class CompanyReviewManagementServiceTest { + + @Mock private CompanyService companyService; + @Mock private JobReviewRepository reviewRepository; + @Mock private JobRepository jobRepository; + @Mock private JobReviewDimensionScoreRepository dimensionScoreRepository; + @Mock private CompanyReviewReplyRepository replyRepository; + @Mock private CompanyReviewReplyHistoryRepository historyRepository; + @InjectMocks private CompanyReviewManagementService service; + + @Test + void companyListUsesBatchLoadsInsteadOfPerItemQueries() { + Company company = Company.builder().id(50L).ownerUserId(7L).name("Acme").build(); + JobReview first = JobReview.builder().id(1L).jobId(10L).rating(4).content("a") + .moderationStatus(JobReview.MODERATION_AUTO_APPROVED).build(); + JobReview second = JobReview.builder().id(2L).jobId(11L).rating(5).content("b") + .moderationStatus(JobReview.MODERATION_APPROVED).build(); + when(companyService.findCompanyByOwnerUserId(7L)).thenReturn(company); + when(reviewRepository.findCompanyReviews(eq(50L), any(), any(), any(), any(), any(), any(), any())) + .thenReturn(new PageImpl<>(List.of(first, second), PageRequest.of(0, 20), 2)); + when(jobRepository.findAllById(any())).thenReturn(List.of( + Job.builder().id(10L).companyId(50L).title("后端").build(), + Job.builder().id(11L).companyId(50L).title("前端").build())); + when(dimensionScoreRepository.findByReviewIdIn(any())).thenReturn(List.of()); + when(replyRepository.findByReviewIdIn(any())).thenReturn(List.of()); + + var result = service.listMine(7L, null, null, null, null, null, null, 0, 20); + + assertEquals(2, result.getItems().size()); + verify(jobRepository, times(1)).findAllById(any()); + verify(jobRepository, never()).findById(any()); + verify(dimensionScoreRepository, times(1)).findByReviewIdIn(any()); + verify(replyRepository, times(1)).findByReviewIdIn(any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyPersistenceIntegrationTest.java new file mode 100644 index 0000000..8632792 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyPersistenceIntegrationTest.java @@ -0,0 +1,228 @@ +package com.mydreamjob.review; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.review.dto.CreateCompanyReviewReplyRequest; +import com.mydreamjob.review.dto.ReviewReplyDecisionRequest; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** H2 + Flyway schema smoke test for V40; no Docker/MySQL is started here. */ +@SpringBootTest +@ActiveProfiles("integration-test") +class CompanyReviewReplyPersistenceIntegrationTest { + + @MockBean private RedisTemplate redisTemplate; + @Autowired private JdbcTemplate jdbcTemplate; + @Autowired private CompanyReviewReplyService replyService; + @Autowired private AdminReviewReplyService adminReviewReplyService; + @Autowired private UserRepository userRepository; + @Autowired private CompanyRepository companyRepository; + @Autowired private JobRepository jobRepository; + @Autowired private JobReviewRepository reviewRepository; + @Autowired private CompanyReviewReplyRepository replyRepository; + @Autowired private AuditLogRepository auditLogRepository; + + private static final AtomicLong PHONE = new AtomicLong(6200); + private final List cleanupUsers = new ArrayList<>(); + private final List cleanupCompanies = new ArrayList<>(); + private final List cleanupJobs = new ArrayList<>(); + private final List cleanupReviews = new ArrayList<>(); + private final List cleanupReplies = new ArrayList<>(); + + @AfterEach + void cleanupFixtures() { + if (!cleanupUsers.isEmpty() || !cleanupReplies.isEmpty()) { + List logs = auditLogRepository.findAll().stream() + .filter(log -> cleanupUsers.contains(log.getUserId()) || cleanupReplies.contains(log.getEntityId())) + .toList(); + auditLogRepository.deleteAll(logs); + } + if (!cleanupReplies.isEmpty()) replyRepository.deleteAllById(cleanupReplies); + if (!cleanupReviews.isEmpty()) reviewRepository.deleteAllById(cleanupReviews); + if (!cleanupJobs.isEmpty()) jobRepository.deleteAllById(cleanupJobs); + if (!cleanupCompanies.isEmpty()) companyRepository.deleteAllById(cleanupCompanies); + if (!cleanupUsers.isEmpty()) userRepository.deleteAllById(cleanupUsers); + cleanupReplies.clear(); + cleanupReviews.clear(); + cleanupJobs.clear(); + cleanupCompanies.clear(); + cleanupUsers.clear(); + } + + @Test + void v40TablesAndCriticalConstraintsArePresent() { + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME='COMPANY_REVIEW_REPLY_HISTORY'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES' AND COLUMN_NAME='IDEMPOTENCY_KEY'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES' AND COLUMN_NAME='VERSION'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES' AND CONSTRAINT_NAME='UK_COMPANY_REVIEW_REPLIES_REVIEW' AND CONSTRAINT_TYPE='UNIQUE'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES' AND CONSTRAINT_NAME='UK_COMPANY_REVIEW_REPLIES_IDEMPOTENCY' AND CONSTRAINT_TYPE='UNIQUE'")); + assertEquals(1, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME='COMPANY_REVIEW_REPLY_HISTORY' AND CONSTRAINT_NAME='CK_COMPANY_REVIEW_REPLY_HISTORY_ACTION' AND CONSTRAINT_TYPE='CHECK'")); + assertEquals(3, count("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME='COMPANY_REVIEW_REPLIES' AND CONSTRAINT_TYPE='FOREIGN KEY'")); + } + + @Test + void concurrentCreate_hasOneWinner_andNoUnexpected500() throws Exception { + Fixture fixture = fixture(); + int n = 4; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue outcomes = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + final String key = UUID.randomUUID().toString(); + pool.submit(() -> { + await(start); + try { + replyService.create(fixture.companyUserId, fixture.reviewId, + createRequest("感谢您的反馈", key), AuditContext.builder().requestId("v40").build()); + outcomes.add(0); + } catch (BusinessException ex) { + outcomes.add(ex.getErrorCodeInt()); + } catch (Exception ex) { + outcomes.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS)); + pool.shutdownNow(); + assertEquals(1, outcomes.stream().filter(code -> code == 0).count()); + assertEquals(n - 1, outcomes.stream().filter(code -> code == 10102).count()); + assertEquals(0, outcomes.stream().filter(code -> code < 0).count()); + assertEquals(1, replyRepository.findByReviewId(fixture.reviewId).stream().count()); + } + + @Test + void concurrentAdminDecision_hasOneWinner_andOneHistory() throws Exception { + Fixture fixture = fixture(); + User admin = userRepository.save(User.builder() + .phone(phone()).nickname("v40-admin").role(User.Role.ADMIN) + .roles(new HashSet<>(Set.of(User.Role.ADMIN))).active(true).verified(true).build()); + cleanupUsers.add(admin.getId()); + replyService.create(fixture.companyUserId, fixture.reviewId, + createRequest("请联系 13800138000", UUID.randomUUID().toString()), + AuditContext.builder().requestId("v40").build()); + CompanyReviewReply reply = replyRepository.findByReviewId(fixture.reviewId).orElseThrow(); + cleanupReplies.add(reply.getId()); + + int n = 2; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue outcomes = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + adminReviewReplyService.decide(admin.getId(), reply.getId(), decisionRequest(), + AuditContext.builder().requestId("v40").build()); + outcomes.add(0); + } catch (BusinessException ex) { + outcomes.add(ex.getErrorCodeInt()); + } catch (Exception ex) { + outcomes.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(20, TimeUnit.SECONDS)); + pool.shutdownNow(); + assertEquals(1, outcomes.stream().filter(code -> code == 0).count()); + assertEquals(1, outcomes.stream().filter(code -> code == 10103 || code == 10104).count()); + assertEquals(0, outcomes.stream().filter(code -> code < 0).count()); + assertEquals(1, replyRepository.findById(reply.getId()).orElseThrow().getModerationStatus().equals(CompanyReviewReply.APPROVED) ? 1 : 0); + long approvedAudits = auditLogRepository.findAll().stream() + .filter(a -> "REVIEW_REPLY_APPROVED".equals(a.getAction()) && reply.getId().equals(a.getEntityId())).count(); + assertEquals(1, approvedAudits); + } + + private CreateCompanyReviewReplyRequest createRequest(String content, String key) { + CreateCompanyReviewReplyRequest request = new CreateCompanyReviewReplyRequest(); + request.setContent(content); + request.setIdempotencyKey(key); + return request; + } + + private ReviewReplyDecisionRequest decisionRequest() { + ReviewReplyDecisionRequest request = new ReviewReplyDecisionRequest(); + request.setDecision("APPROVE"); + return request; + } + + private Fixture fixture() { + User companyUser = userRepository.save(User.builder().phone(phone()).nickname("v40-company") + .role(User.Role.COMPANY).roles(new HashSet<>(Set.of(User.Role.COMPANY))) + .active(true).verified(true).build()); + User student = userRepository.save(User.builder().phone(phone()).nickname("v40-student") + .role(User.Role.STUDENT).roles(new HashSet<>(Set.of(User.Role.STUDENT))) + .active(true).verified(true).build()); + cleanupUsers.add(companyUser.getId()); + cleanupUsers.add(student.getId()); + Company company = companyRepository.save(Company.builder().ownerUserId(companyUser.getId()) + .name("V40 Company").verified(true).build()); + Job job = jobRepository.save(Job.builder().companyId(company.getId()).title("V40 Job") + .description("job").city("Shanghai").employmentType("FULL_TIME").status("PUBLISHED").build()); + JobReview review = reviewRepository.save(JobReview.builder().jobId(job.getId()).studentUserId(student.getId()) + .rating(5).content("review").status("PUBLISHED") + .moderationStatus(JobReview.MODERATION_AUTO_APPROVED).build()); + cleanupCompanies.add(company.getId()); + cleanupJobs.add(job.getId()); + cleanupReviews.add(review.getId()); + return new Fixture(companyUser.getId(), review.getId()); + } + + private String phone() { + return "18" + String.format("%09d", PHONE.incrementAndGet()); + } + + private void await(CountDownLatch latch) { + try { + latch.await(); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + + private record Fixture(Long companyUserId, Long reviewId) { } + + private int count(String sql) { + Integer value = jdbcTemplate.queryForObject(sql, Integer.class); + return value == null ? 0 : value; + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyServiceTest.java index 8a66cf2..145ddd0 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/CompanyReviewReplyServiceTest.java @@ -1,467 +1,151 @@ package com.mydreamjob.review; +import com.mydreamjob.audit.AuditService; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; -import com.mydreamjob.company.CompanyRepository; -import com.mydreamjob.auth.User; -import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.CompanyService; import com.mydreamjob.job.Job; import com.mydreamjob.job.JobRepository; -import com.mydreamjob.job.JobService; -import com.mydreamjob.review.dto.AdminCompanyReviewReplyResponse; -import com.mydreamjob.review.dto.CompanyReviewReplyCreateRequest; -import com.mydreamjob.review.dto.CompanyReviewReplyUpdateRequest; -import com.mydreamjob.review.dto.ReviewReplyStatsResponse; +import com.mydreamjob.review.dto.CreateCompanyReviewReplyRequest; +import com.mydreamjob.review.dto.UpdateCompanyReviewReplyRequest; import org.junit.jupiter.api.BeforeEach; 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 org.springframework.data.domain.Page; -import org.springframework.data.domain.PageImpl; +import org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; -import java.time.LocalDateTime; +import java.math.BigDecimal; import java.util.List; import java.util.Optional; -import java.util.Set; +import java.util.UUID; -import static org.junit.jupiter.api.Assertions.*; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; import static org.mockito.ArgumentMatchers.any; -import static org.mockito.ArgumentMatchers.anyList; -import static org.mockito.ArgumentMatchers.eq; -import static org.mockito.ArgumentMatchers.anyCollection; import static org.mockito.Mockito.*; @ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) class CompanyReviewReplyServiceTest { - @Mock private CompanyReviewReplyRepository replyRepository; + @Mock private CompanyService companyService; @Mock private JobReviewRepository reviewRepository; @Mock private JobRepository jobRepository; - @Mock private JobService jobService; - @Mock private CompanyRepository companyRepository; - @Mock private UserRepository userRepository; - @InjectMocks private CompanyReviewReplyService replyService; - - private static final Long COMPANY_USER_ID = 10L; // 企业账号 userId - private static final Long COMPANY_ID = 20L; // 企业 id - private static final Long OTHER_COMPANY_USER_ID = 11L; // 其他企业账号 userId - private static final Long OTHER_COMPANY_ID = 21L; // 其他企业 id - private static final Long REVIEW_ID = 100L; - private static final Long JOB_ID = 50L; - private static final Long ADMIN_USER_ID = 1L; + @Mock private CompanyReviewReplyRepository replyRepository; + @Mock private CompanyReviewReplyHistoryRepository historyRepository; + @Mock private ReviewModerationService moderationService; + @Mock private AuditService auditService; + @Mock private com.fasterxml.jackson.databind.ObjectMapper objectMapper; + @InjectMocks private CompanyReviewReplyService service; + + private static final long USER_ID = 11L; + private static final long COMPANY_ID = 21L; + private static final long JOB_ID = 31L; + private static final long REVIEW_ID = 41L; + private final String key = UUID.randomUUID().toString(); + private Company company; + private JobReview review; + private Job job; @BeforeEach - void setUp() { - // 默认：adminId 为 ADMIN（lenient 避免未用到的用例报 UnnecessaryStubbing） - lenient().when(userRepository.findById(ADMIN_USER_ID)) - .thenReturn(Optional.of(adminUser())); - } - - private User adminUser() { - return User.builder().id(ADMIN_USER_ID).role(User.Role.ADMIN) - .roles(Set.of(User.Role.ADMIN)).build(); - } - - private User normalUser(Long id) { - return User.builder().id(id).role(User.Role.COMPANY) - .roles(Set.of(User.Role.COMPANY)).build(); - } - - private JobReview approvedReview() { - return JobReview.builder() - .id(REVIEW_ID).jobId(JOB_ID).studentUserId(999L) - .rating(4).content("Great job") - .moderationStatus(JobReview.MODERATION_AUTO_APPROVED) - .build(); - } - - private void mockCompanyOwnership(Long userId, Long companyId) { - when(companyRepository.findByOwnerUserId(userId)) - .thenReturn(Optional.of(Company.builder().id(companyId).ownerUserId(userId).build())); - } - - private void stubJobWithCompany(Long companyId) { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).companyId(companyId).title("Java").build()); - } - - private CompanyReviewReplyCreateRequest buildCreateReq() { - CompanyReviewReplyCreateRequest req = new CompanyReviewReplyCreateRequest(); - req.setContent("感谢您的反馈，我们会持续改进"); - return req; - } - - // ── 创建（企业归属校验是核心）────────────────────────────── - - @Test void createReply_companyOwnsJob_shouldSucceed() { - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(COMPANY_USER_ID, COMPANY_ID); - when(replyRepository.existsByReviewId(REVIEW_ID)).thenReturn(false); - when(replyRepository.save(any())).thenAnswer(inv -> inv.getArgument(0)); - - var r = replyService.createReply(COMPANY_USER_ID, REVIEW_ID, buildCreateReq()); - assertEquals(CompanyReviewReply.MODERATION_PENDING, r.getModerationStatus()); - assertEquals("感谢您的反馈，我们会持续改进", r.getContent()); - verify(replyRepository).save(any()); - } - - @Test void createReply_otherCompany_shouldReturn403() { - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(OTHER_COMPANY_USER_ID, OTHER_COMPANY_ID); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.createReply(OTHER_COMPANY_USER_ID, REVIEW_ID, buildCreateReq())); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - @Test void createReply_reviewNotApproved_shouldReturn404() { - JobReview pending = approvedReview(); - pending.setModerationStatus(JobReview.MODERATION_PENDING); - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(pending)); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.createReply(COMPANY_USER_ID, REVIEW_ID, buildCreateReq())); - assertEquals(ErrorCode.REVIEW_NOT_FOUND.getCode(), ex.getErrorCodeInt()); - } - - @Test void createReply_duplicate_shouldReturn409() { - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(COMPANY_USER_ID, COMPANY_ID); - when(replyRepository.existsByReviewId(REVIEW_ID)).thenReturn(true); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.createReply(COMPANY_USER_ID, REVIEW_ID, buildCreateReq())); - assertEquals(ErrorCode.DUPLICATE_REPLY.getCode(), ex.getErrorCodeInt()); - } - - @Test void createReply_companyUserWithoutOwnedCompany_shouldReturn403() { - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - // companyRepository 不 stub -> 默认空 -> 无归属企业 - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.createReply(COMPANY_USER_ID, REVIEW_ID, buildCreateReq())); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); + void setUp() throws Exception { + company = Company.builder().id(COMPANY_ID).ownerUserId(USER_ID).name("Acme").build(); + review = JobReview.builder().id(REVIEW_ID).jobId(JOB_ID).studentUserId(99L) + .rating(4).content("评价").status("PUBLISHED").build(); + job = Job.builder().id(JOB_ID).companyId(COMPANY_ID).title("后端工程师").build(); + when(companyService.findCompanyByOwnerUserId(USER_ID)).thenReturn(company); + when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(review)); + when(jobRepository.findById(JOB_ID)).thenReturn(Optional.of(job)); + when(replyRepository.findByCompanyIdAndIdempotencyKey(any(), any())).thenReturn(Optional.empty()); + when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.empty()); + when(objectMapper.writeValueAsString(any())).thenReturn("[]"); + when(replyRepository.saveAndFlush(any())).thenAnswer(invocation -> { + CompanyReviewReply reply = invocation.getArgument(0); + if (reply.getId() == null) reply.setId(501L); + return reply; + }); } - // ── 查询 ───────────────────────────────────────────────── - - @Test void getReply_approved_shouldSucceed() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("回复内容").moderationStatus(CompanyReviewReply.MODERATION_APPROVED) - .createdAt(LocalDateTime.now()).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - - var r = replyService.getReply(null, REVIEW_ID); - assertEquals("回复内容", r.getContent()); + private ReviewModerationService.ModerationResult autoApproved() { + return new ReviewModerationService.ModerationResult( + CompanyReviewReply.AUTO_APPROVED, List.of(), BigDecimal.ZERO, null); } - @Test void getReply_pending_otherUser_shouldReturn404() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("回复内容") - .moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.getReply(999L, REVIEW_ID)); - assertEquals(ErrorCode.REPLY_NOT_FOUND.getCode(), ex.getErrorCodeInt()); - } - - @Test void getReply_pending_anonymous_shouldReturn404() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID).content("回复内容") - .moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - - // 匿名请求：currentUserIdOrNull() 返回 null（原为把匿名 token 当 ADMIN 解析导致 500） - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.getReply(null, REVIEW_ID)); - assertEquals(ErrorCode.REPLY_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + private ReviewModerationService.ModerationResult pending() { + return new ReviewModerationService.ModerationResult( + CompanyReviewReply.PENDING, List.of(ReviewModerationService.REASON_CONTACT_INFO), + BigDecimal.valueOf(2), "MEDIUM"); } - @Test void getReply_pending_owner_shouldSucceedWithPending() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("回复内容").moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - - var r = replyService.getReply(COMPANY_USER_ID, REVIEW_ID); - assertEquals(CompanyReviewReply.MODERATION_PENDING, r.getModerationStatus()); + private CreateCompanyReviewReplyRequest createRequest(String content) { + CreateCompanyReviewReplyRequest request = new CreateCompanyReviewReplyRequest(); + request.setContent(content); + request.setIdempotencyKey(key); + return request; } - @Test void getReply_rejected_owner_shouldSucceedWithReason() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("回复内容").moderationStatus(CompanyReviewReply.MODERATION_REJECTED) - .moderationReason("内容违规").build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - - var r = replyService.getReply(COMPANY_USER_ID, REVIEW_ID); - assertEquals(CompanyReviewReply.MODERATION_REJECTED, r.getModerationStatus()); - assertEquals("内容违规", r.getModerationReason()); - } + @Test + void safeTextIsAutoApprovedAndAudited() { + when(moderationService.moderateCompanyReply("感谢反馈")).thenReturn(autoApproved()); - @Test void batchGetApprovedReplies_shouldFilterApproved() { - CompanyReviewReply approved = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("OK") - .moderationStatus(CompanyReviewReply.MODERATION_APPROVED).build(); - CompanyReviewReply pending = CompanyReviewReply.builder() - .id(2L).reviewId(101L).content("P") - .moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - // Service 使用 findByReviewIdInAndModerationStatus(ids, APPROVED)，只返回 approved - when(replyRepository.findByReviewIdInAndModerationStatus(anyList(), eq(CompanyReviewReply.MODERATION_APPROVED))) - .thenReturn(java.util.List.of(approved)); + var response = service.create(USER_ID, REVIEW_ID, createRequest("感谢反馈"), null); - var map = replyService.batchGetApprovedReplies(java.util.List.of(REVIEW_ID, 101L)); - assertEquals(1, map.size()); - assertTrue(map.containsKey(REVIEW_ID)); - assertFalse(map.containsKey(101L)); + assertEquals(CompanyReviewReply.AUTO_APPROVED, response.getStatus()); + verify(historyRepository, times(2)).save(any()); + verify(auditService, times(2)).log(any(), any(), any(), any(), any(), any()); } - // ── 更新（企业侧）───────────────────────────────────────── + @Test + void riskyTextBecomesPendingWithoutExposingReasonToCompany() { + when(moderationService.moderateCompanyReply("请联系 13800138000")).thenReturn(pending()); - @Test void updateReply_companyOwns_shouldResetToPending() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("旧内容").moderationStatus(CompanyReviewReply.MODERATION_APPROVED).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(COMPANY_USER_ID, COMPANY_ID); - when(replyRepository.save(any())).thenAnswer(inv -> inv.getArgument(0)); + var response = service.create(USER_ID, REVIEW_ID, createRequest("请联系 13800138000"), null); - CompanyReviewReplyUpdateRequest req = new CompanyReviewReplyUpdateRequest(); - req.setContent("新内容"); - var r = replyService.updateReply(COMPANY_USER_ID, REVIEW_ID, req); - assertEquals("新内容", r.getContent()); - assertEquals(CompanyReviewReply.MODERATION_PENDING, r.getModerationStatus()); + assertEquals(CompanyReviewReply.PENDING, response.getStatus()); + assertEquals(null, response.getRejectionReason()); + verify(auditService).log(any(), eq("COMPANY_REVIEW_REPLY_CREATED"), any(), any(), any(), any()); } - @Test void updateReply_otherCompany_shouldReturn403() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("旧内容").build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(OTHER_COMPANY_USER_ID, OTHER_COMPANY_ID); - - CompanyReviewReplyUpdateRequest req = new CompanyReviewReplyUpdateRequest(); - req.setContent("新内容"); + @Test + void existingReplyCannotBeCreatedAgain() { + when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of( + CompanyReviewReply.builder().id(501L).reviewId(REVIEW_ID) + .companyId(COMPANY_ID).moderationStatus(CompanyReviewReply.PENDING).content("旧回复").build())); BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.updateReply(OTHER_COMPANY_USER_ID, REVIEW_ID, req)); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - // ── 删除（企业侧）───────────────────────────────────────── - - @Test void deleteReply_companyOwns_shouldSucceed() { - CompanyReviewReply reply = CompanyReviewReply.builder().id(1L).reviewId(REVIEW_ID).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(COMPANY_USER_ID, COMPANY_ID); - - assertDoesNotThrow(() -> replyService.deleteReply(COMPANY_USER_ID, REVIEW_ID)); - verify(replyRepository).delete(reply); - } - - @Test void deleteReply_otherCompany_shouldReturn403() { - CompanyReviewReply reply = CompanyReviewReply.builder().id(1L).reviewId(REVIEW_ID).build(); - when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(reply)); - when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(approvedReview())); - stubJobWithCompany(COMPANY_ID); - mockCompanyOwnership(OTHER_COMPANY_USER_ID, OTHER_COMPANY_ID); - + () -> service.create(USER_ID, REVIEW_ID, createRequest("新回复"), null)); + assertEquals(ErrorCode.REVIEW_REPLY_ALREADY_EXISTS.getCode(), ex.getErrorCodeInt()); + } + + @Test + void rejectedReplyCanBeResubmittedWithExpectedVersion() { + CompanyReviewReply rejected = CompanyReviewReply.builder().id(501L).reviewId(REVIEW_ID) + .companyId(COMPANY_ID).content("旧回复").moderationStatus(CompanyReviewReply.REJECTED) + .version(2L).build(); + when(replyRepository.findByReviewId(REVIEW_ID)).thenReturn(Optional.of(rejected)); + when(moderationService.moderateCompanyReply("修订后回复")).thenReturn(autoApproved()); + UpdateCompanyReviewReplyRequest request = new UpdateCompanyReviewReplyRequest(); + request.setContent("修订后回复"); + request.setExpectedVersion(2L); + + var response = service.revise(USER_ID, REVIEW_ID, request, null); + + assertEquals("修订后回复", response.getContent()); + assertEquals(CompanyReviewReply.AUTO_APPROVED, response.getStatus()); + verify(historyRepository, times(2)).save(any()); + verify(auditService).log(any(), eq("COMPANY_REVIEW_REPLY_RESUBMITTED"), any(), any(), any(), any()); + } + + @Test + void idempotencyKeyWithDifferentPayloadIsConflict() { + when(replyRepository.findByCompanyIdAndIdempotencyKey(COMPANY_ID, key)).thenReturn(Optional.of( + CompanyReviewReply.builder().id(501L).reviewId(999L).companyId(COMPANY_ID) + .content("其他内容").build())); BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.deleteReply(OTHER_COMPANY_USER_ID, REVIEW_ID)); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - // ── 管理员审核 ──────────────────────────────────────────── - - @Test void moderateReply_approve_shouldSucceed() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("内容") - .moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findById(1L)).thenReturn(Optional.of(reply)); - when(replyRepository.save(any())).thenAnswer(inv -> inv.getArgument(0)); - - var r = replyService.moderateReply(ADMIN_ROLE_ID(), 1L, CompanyReviewReply.MODERATION_APPROVED, "合规"); - assertEquals(CompanyReviewReply.MODERATION_APPROVED, r.getModerationStatus()); - } - - @Test void moderateReply_reject_shouldSucceed() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("内容") - .moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findById(1L)).thenReturn(Optional.of(reply)); - when(replyRepository.save(any())).thenAnswer(inv -> inv.getArgument(0)); - - var r = replyService.moderateReply(ADMIN_ROLE_ID(), 1L, CompanyReviewReply.MODERATION_REJECTED, "违规"); - assertEquals(CompanyReviewReply.MODERATION_REJECTED, r.getModerationStatus()); - } - - @Test void moderateReply_alreadyDecided_shouldReturn409() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(1L).reviewId(REVIEW_ID).content("内容") - .moderationStatus(CompanyReviewReply.MODERATION_APPROVED).build(); - when(replyRepository.findById(1L)).thenReturn(Optional.of(reply)); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.moderateReply(ADMIN_ROLE_ID(), 1L, CompanyReviewReply.MODERATION_APPROVED, "x")); - assertEquals(ErrorCode.REPLY_ALREADY_DECIDED.getCode(), ex.getErrorCodeInt()); - } - - @Test void moderateReply_nonAdmin_shouldReturnForbidden() { - Long nonAdminId = OTHER_COMPANY_USER_ID; - when(userRepository.findById(nonAdminId)).thenReturn(Optional.of(normalUser(nonAdminId))); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.moderateReply(nonAdminId, 1L, CompanyReviewReply.MODERATION_APPROVED, "x")); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - // ── 管理端回复列表（仅 ADMIN） ────────────────────────────── - - @Test void listAdminReplies_nonAdmin_shouldReturnForbidden() { - Long nonAdminId = OTHER_COMPANY_USER_ID; - when(userRepository.findById(nonAdminId)).thenReturn(Optional.of(normalUser(nonAdminId))); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.listAdminReplies(nonAdminId, null, null, null, null, null, 0, 20)); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - @Test void listAdminReplies_invalidStatus_shouldReturnBadRequest() { - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.listAdminReplies(ADMIN_USER_ID, null, null, "UNKNOWN", null, null, 0, 20)); - assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); - } - - @Test void listAdminReplies_invalidPage_shouldReturnBadRequest() { - assertThrows(BusinessException.class, - () -> replyService.listAdminReplies(ADMIN_USER_ID, null, null, null, null, null, -1, 20)); - assertThrows(BusinessException.class, - () -> replyService.listAdminReplies(ADMIN_USER_ID, null, null, null, null, null, 0, 0)); - assertThrows(BusinessException.class, - () -> replyService.listAdminReplies(ADMIN_USER_ID, null, null, null, null, null, 0, 101)); - } - - @Test void listAdminReplies_defaultStatusPending_andDelegatesFilters() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(3L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("回复").moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - when(replyRepository.findAdminReplies(any(), any(), any(), any(), any(), any())) - .thenReturn(new PageImpl<>(List.of(reply))); - when(reviewRepository.findAllById(anyCollection())).thenReturn(List.of()); - - Page result = - replyService.listAdminReplies(ADMIN_USER_ID, COMPANY_ID, JOB_ID, null, null, null, 0, 20); - - assertEquals(1, result.getTotalElements()); - assertEquals(CompanyReviewReply.MODERATION_PENDING, result.getContent().get(0).getModerationStatus()); - verify(replyRepository).findAdminReplies(eq(COMPANY_ID), eq(JOB_ID), - eq(CompanyReviewReply.MODERATION_PENDING), any(), any(), any()); - } - - @Test void listAdminReplies_enrichesJobAndCompany() { - CompanyReviewReply reply = CompanyReviewReply.builder() - .id(3L).reviewId(REVIEW_ID).companyUserId(COMPANY_USER_ID) - .content("回复").moderationStatus(CompanyReviewReply.MODERATION_PENDING).build(); - JobReview review = JobReview.builder().id(REVIEW_ID).jobId(JOB_ID) - .studentUserId(2L).rating(3).content("评价内容").build(); - Job job = Job.builder().id(JOB_ID).companyId(COMPANY_ID).title("Java 后端工程师").build(); - Company company = Company.builder().id(COMPANY_ID).name("本源科技").build(); - - when(replyRepository.findAdminReplies(any(), any(), any(), any(), any(), any())) - .thenReturn(new PageImpl<>(List.of(reply))); - when(reviewRepository.findAllById(anyCollection())).thenReturn(List.of(review)); - when(jobRepository.findAllById(anyCollection())).thenReturn(List.of(job)); - when(companyRepository.findAllById(anyCollection())).thenReturn(List.of(company)); - - Page result = - replyService.listAdminReplies(ADMIN_USER_ID, null, null, null, null, null, 0, 20); - - AdminCompanyReviewReplyResponse v = result.getContent().get(0); - assertEquals("Java 后端工程师", v.getJobTitle()); - assertEquals("本源科技", v.getCompanyName()); - assertEquals(3, v.getReviewRating()); - assertEquals(2L, v.getStudentUserId()); - assertEquals(COMPANY_USER_ID, v.getCompanyUserId()); - } - - // ── 回复率统计（企业侧） ────────────────────────────────── - - @Test void getReviewReplyStats_shouldComputeMonthRateAndIndustryAvg() { - when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID) - .ownerUserId(COMPANY_USER_ID).industry("IT").build())); - when(replyRepository.findMonthlyReplyStats(any(), any(), any(), any())).thenReturn(List.of( - new Object[]{COMPANY_ID, 5L, 4L}, // 当前企业：80% - new Object[]{OTHER_COMPANY_ID, 4L, 2L})); // 同行企业：50% - - ReviewReplyStatsResponse r = replyService.getReviewReplyStats(COMPANY_USER_ID); - - assertEquals(80, r.getMonthReplyRate()); - assertEquals(65, r.getIndustryAvgReplyRate()); // (0.8+0.5)/2 = 0.65 - assertEquals(1, r.getUnrepliedCount()); - } - - @Test void getReviewReplyStats_noReplies_shouldReturnZeroRate() { - when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID) - .ownerUserId(COMPANY_USER_ID).industry("IT").build())); - when(replyRepository.findMonthlyReplyStats(any(), any(), any(), any())) - .thenReturn(List.of(new Object[]{COMPANY_ID, 2L, 0L})); - - ReviewReplyStatsResponse r = replyService.getReviewReplyStats(COMPANY_USER_ID); - - assertEquals(0, r.getMonthReplyRate()); - assertEquals(2, r.getUnrepliedCount()); - } - - @Test void getReviewReplyStats_noReviewsThisMonth_shouldReturnZeros() { - when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID) - .ownerUserId(COMPANY_USER_ID).industry("IT").build())); - when(replyRepository.findMonthlyReplyStats(any(), any(), any(), any())).thenReturn(List.of()); - - ReviewReplyStatsResponse r = replyService.getReviewReplyStats(COMPANY_USER_ID); - - assertEquals(0, r.getMonthReplyRate()); - assertEquals(0, r.getIndustryAvgReplyRate()); - assertEquals(0, r.getUnrepliedCount()); - } - - @Test void getReviewReplyStats_companyWithoutIndustry_shouldSetIndustryAvgZero() { - when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)) - .thenReturn(Optional.of(Company.builder().id(COMPANY_ID) - .ownerUserId(COMPANY_USER_ID).industry(null).build())); - when(replyRepository.findMonthlyReplyStats(any(), any(), any(), any())) - .thenReturn(List.of(new Object[]{COMPANY_ID, 5L, 4L})); - - ReviewReplyStatsResponse r = replyService.getReviewReplyStats(COMPANY_USER_ID); - - assertEquals(80, r.getMonthReplyRate()); - assertEquals(0, r.getIndustryAvgReplyRate()); - assertEquals(1, r.getUnrepliedCount()); - } - - @Test void getReviewReplyStats_companyUserWithoutCompany_shouldReturn403() { - when(companyRepository.findByOwnerUserId(COMPANY_USER_ID)).thenReturn(Optional.empty()); - - BusinessException ex = assertThrows(BusinessException.class, - () -> replyService.getReviewReplyStats(COMPANY_USER_ID)); - assertEquals(ErrorCode.FORBIDDEN.getCode(), ex.getErrorCodeInt()); - } - - private Long ADMIN_ROLE_ID() { - return 1L; + () -> service.create(USER_ID, REVIEW_ID, createRequest("感谢反馈"), null)); + assertEquals(ErrorCode.REVIEW_REPLY_IDEMPOTENCY_CONFLICT.getCode(), ex.getErrorCodeInt()); } -} \ No newline at end of file +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewControllerTest.java index 6f2b786..8e4cc1f 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewControllerTest.java @@ -45,8 +45,7 @@ class JobReviewControllerTest { } private String token() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "1", - java.util.Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } @Test void createReview_shouldReturn200() throws Exception { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionControllerTest.java index 320fd0b..ec92de9 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionControllerTest.java @@ -59,11 +59,11 @@ class JobReviewDimensionControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(STUDENT_ID, "2", Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(STUDENT_ID, "STUDENT"); } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(10L, "3", Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(10L, "COMPANY"); } private String reviewBody(boolean withDims) { diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionServiceTest.java index 98d770b..124709a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewDimensionServiceTest.java @@ -3,6 +3,8 @@ package com.mydreamjob.review; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.job.Job; @@ -44,6 +46,9 @@ class JobReviewDimensionServiceTest { @Mock private AuditService auditService; @Mock private CompanyReviewReplyRepository replyRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private JobReviewService reviewService; private static final Long STUDENT_ID = 100L; @@ -54,6 +59,9 @@ class JobReviewDimensionServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + lenient().when(dimensionScoreRepository.findByReviewId(any())).thenReturn(List.of()); lenient().when(dimensionScoreRepository.aggregateByDimension(any())).thenReturn(List.of()); lenient().when(replyRepository.findByReviewIdAndModerationStatus(any(), any())) diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewPublicReplyTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewPublicReplyTest.java new file mode 100644 index 0000000..786d067 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewPublicReplyTest.java @@ -0,0 +1,79 @@ +package com.mydreamjob.review; + +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobService; +import com.fasterxml.jackson.databind.ObjectMapper; +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 org.springframework.data.domain.PageImpl; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class JobReviewPublicReplyTest { + + @Mock private JobReviewRepository reviewRepository; + @Mock private JobReviewDimensionScoreRepository dimensionScoreRepository; + @Mock private ReviewModerationHistoryRepository moderationHistoryRepository; + @Mock private ReviewModerationService moderationService; + @Mock private JobService jobService; + @Mock private UserRepository userRepository; + @Mock private AuditService auditService; + @Mock private CompanyReviewReplyRepository replyRepository; + @InjectMocks private JobReviewService reviewService; + + @Test + void publicReviewRedactsStudentIdAndOnlyShowsApprovedOfficialReply() throws Exception { + JobReview review = JobReview.builder().id(1L).jobId(9L).studentUserId(777L) + .rating(5).content("公开评价").status("PUBLISHED") + .moderationStatus(JobReview.MODERATION_AUTO_APPROVED).build(); + CompanyReviewReply reply = CompanyReviewReply.builder().id(2L).reviewId(1L).companyId(3L) + .content("感谢反馈").moderationStatus(CompanyReviewReply.APPROVED).build(); + when(jobService.getJob(9L)).thenReturn(Job.builder().id(9L).build()); + when(reviewRepository.findByJobIdAndStatusAndModerationStatusInOrderByCreatedAtDesc( + eq(9L), eq("PUBLISHED"), any(), any())).thenReturn(new PageImpl<>(List.of(review))); + when(dimensionScoreRepository.findByReviewIdIn(any())).thenReturn(List.of()); + when(replyRepository.findByReviewIdIn(any())).thenReturn(List.of(reply)); + + Map view = reviewService.listReviews(9L, 0, 20).getContent().get(0); + String json = new ObjectMapper().writeValueAsString(view); + + assertFalse(view.containsKey("studentUserId")); + assertTrue(view.containsKey("reviewerLabel")); + assertTrue(view.containsKey("officialReply")); + assertFalse(json.contains("studentUserId")); + assertFalse(json.contains("companyId")); + assertFalse(json.contains("replyId")); + } + + @Test + void pendingOfficialReplyIsNotPublic() { + JobReview review = JobReview.builder().id(1L).jobId(9L).studentUserId(777L) + .rating(5).content("公开评价").status("PUBLISHED") + .moderationStatus(JobReview.MODERATION_AUTO_APPROVED).build(); + CompanyReviewReply reply = CompanyReviewReply.builder().id(2L).reviewId(1L).companyId(3L) + .content("待审核").moderationStatus(CompanyReviewReply.PENDING).build(); + when(jobService.getJob(9L)).thenReturn(Job.builder().id(9L).build()); + when(reviewRepository.findByJobIdAndStatusAndModerationStatusInOrderByCreatedAtDesc( + eq(9L), eq("PUBLISHED"), any(), any())).thenReturn(new PageImpl<>(List.of(review))); + when(dimensionScoreRepository.findByReviewIdIn(any())).thenReturn(List.of()); + when(replyRepository.findByReviewIdIn(any())).thenReturn(List.of(reply)); + + Map view = reviewService.listReviews(9L, 0, 20).getContent().get(0); + + assertFalse(view.containsKey("officialReply")); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewServiceTest.java index 893c3dd..26fc1d2 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/JobReviewServiceTest.java @@ -3,6 +3,8 @@ package com.mydreamjob.review; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.job.Job; @@ -18,13 +20,11 @@ import org.mockito.junit.jupiter.MockitoExtension; import org.springframework.data.domain.Page; import org.springframework.data.domain.PageImpl; -import java.time.LocalDateTime; import java.util.*; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.any; import static org.mockito.ArgumentMatchers.eq; -import static org.mockito.ArgumentMatchers.isNull; import static org.mockito.Mockito.*; @ExtendWith(MockitoExtension.class) @@ -37,7 +37,9 @@ class JobReviewServiceTest { @Mock private JobService jobService; @Mock private UserRepository userRepository; @Mock private AuditService auditService; - @Mock private CompanyReviewReplyRepository replyRepository; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private JobReviewService reviewService; private static final Long STUDENT_ID = 100L; @@ -49,15 +51,14 @@ class JobReviewServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + review = JobReview.builder().id(REVIEW_ID).jobId(JOB_ID).studentUserId(STUDENT_ID) .rating(4).content("不错的岗位").status("PUBLISHED").build(); // 维度相关默认空数据（旧用例不传 dimensionScores；lenient 避免部分用例未用到） lenient().when(dimensionScoreRepository.findByReviewId(any())).thenReturn(List.of()); - lenient().when(dimensionScoreRepository.findByReviewIdIn(any())).thenReturn(List.of()); lenient().when(dimensionScoreRepository.aggregateByDimension(any())).thenReturn(List.of()); - // 企业回复默认无（toView 会查询） - lenient().when(replyRepository.findByReviewIdAndModerationStatus(any(), any())) - .thenReturn(Optional.empty()); // 审核默认通过（AUTO_APPROVED）；命中规则测试单独覆写 lenient().when(moderationService.moderate(any(), any(), any(), any(), any(), any(), any())) .thenReturn(new ReviewModerationService.ModerationResult( @@ -148,64 +149,12 @@ class JobReviewServiceTest { @Test void listReviews_shouldReturnPublishedOnly() { when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - when(reviewRepository.findPublicReviews(eq(JOB_ID), eq("PUBLISHED"), any(), - isNull(), isNull(), isNull(), eq(false), any())) + when(reviewRepository.findByJobIdAndStatusAndModerationStatusInOrderByCreatedAtDesc(eq(JOB_ID), eq("PUBLISHED"), any(), any())) .thenReturn(new PageImpl<>(List.of(review))); var r = reviewService.listReviews(JOB_ID, 0, 20); assertEquals(1, r.getTotalElements()); } - // ── 列表筛选（好评/中评/差评/未回复/时间区间） ──────────── - - @Test void listReviews_withFilters_shouldPassToRepository() { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - LocalDateTime from = LocalDateTime.of(2026, 1, 1, 0, 0); - LocalDateTime to = LocalDateTime.of(2026, 6, 1, 0, 0); - when(reviewRepository.findPublicReviews(eq(JOB_ID), eq("PUBLISHED"), any(), - eq("GOOD"), eq(from), eq(to), eq(true), any())) - .thenReturn(new PageImpl<>(List.of(review))); - var r = reviewService.listReviews(JOB_ID, "GOOD", from, to, true, 0, 20); - assertEquals(1, r.getTotalElements()); - verify(reviewRepository).findPublicReviews(eq(JOB_ID), eq("PUBLISHED"), any(), - eq("GOOD"), eq(from), eq(to), eq(true), any()); - } - - @Test void listReviews_invalidRatingType_shouldReturn400() { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - BusinessException ex = assertThrows(BusinessException.class, - () -> reviewService.listReviews(JOB_ID, "EXCELLENT", - LocalDateTime.now(), null, false, 0, 20)); - assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); - } - - @Test void listReviews_fromAfterTo_shouldReturn400() { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - LocalDateTime from = LocalDateTime.of(2026, 6, 1, 0, 0); - LocalDateTime to = LocalDateTime.of(2026, 1, 1, 0, 0); - BusinessException ex = assertThrows(BusinessException.class, - () -> reviewService.listReviews(JOB_ID, null, from, to, false, 0, 20)); - assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); - } - - @Test void listReviews_onlyFromNoTo_shouldBeAllowed() { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - LocalDateTime from = LocalDateTime.of(2026, 1, 1, 0, 0); - when(reviewRepository.findPublicReviews(eq(JOB_ID), eq("PUBLISHED"), any(), - isNull(), eq(from), isNull(), eq(false), any())) - .thenReturn(new PageImpl<>(List.of(review))); - var r = reviewService.listReviews(JOB_ID, null, from, null, false, 0, 20); - assertEquals(1, r.getTotalElements()); - } - - @Test void listReviews_nullFilters_shouldDefaultFalse() { - when(jobService.getJob(JOB_ID)).thenReturn(Job.builder().id(JOB_ID).build()); - when(reviewRepository.findPublicReviews(eq(JOB_ID), eq("PUBLISHED"), any(), - isNull(), isNull(), isNull(), eq(false), any())) - .thenReturn(new PageImpl<>(List.of(review))); - var r = reviewService.listReviews(JOB_ID, null, null, null, false, 0, 20); - assertEquals(1, r.getTotalElements()); - } - @Test void updateReview_shouldSucceed() { mockStudentRole(STUDENT_ID); when(reviewRepository.findById(REVIEW_ID)).thenReturn(Optional.of(review)); diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureIsolationTest.java new file mode 100644 index 0000000..ea070b9 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureIsolationTest.java @@ -0,0 +1,91 @@ +package com.mydreamjob.review; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; + +@SpringBootTest +@ActiveProfiles("integration-test") +class ReviewControllerFixtureIsolationTest { + + private static final long SENTINEL_ID = 9_320_099L; + private static final long PROBE_ID = 9_320_098L; + + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private RedisTemplate redisTemplate; + + @AfterEach + void cleanup() { + ReviewControllerFixtureUsers.remove(jdbcTemplate, + AdminReviewControllerTest.ADMIN_ID, + AdminReviewControllerTest.STUDENT_ID, + CompanyReviewManagementControllerTest.COMPANY_USER_ID, + CompanyReviewManagementControllerTest.STUDENT_USER_ID, + SENTINEL_ID, PROBE_ID); + } + + @Test + void fixtureIdsAreOutsideLegacySeedRangeAndMutuallyDistinct() { + List ids = List.of( + AdminReviewControllerTest.ADMIN_ID, + AdminReviewControllerTest.STUDENT_ID, + CompanyReviewManagementControllerTest.COMPANY_USER_ID, + CompanyReviewManagementControllerTest.STUDENT_USER_ID); + + assertThat(ids).doesNotContain(1L, 2L, 3L).doesNotHaveDuplicates(); + } + + @Test + void provisionCreatesAnActiveVerifiedUserAndCanBeRepeated() { + for (int round = 0; round < 3; round++) { + ReviewControllerFixtureUsers.provision(jdbcTemplate, PROBE_ID, "r01b-review-probe", "ADMIN"); + } + + Map row = jdbcTemplate.queryForMap( + "SELECT id, role, is_active, is_verified FROM users WHERE id = ?", PROBE_ID); + assertThat(((Number) row.get("id")).longValue()).isEqualTo(PROBE_ID); + assertThat(row.get("role")).isEqualTo("ADMIN"); + assertThat(((Number) row.get("is_active")).intValue()).isEqualTo(1); + assertThat(((Number) row.get("is_verified")).intValue()).isEqualTo(1); + } + + @Test + void cleanupRemovesOnlyOwnedRows() { + ReviewControllerFixtureUsers.provision(jdbcTemplate, PROBE_ID, "r01b-review-probe", "ADMIN"); + ReviewControllerFixtureUsers.provision(jdbcTemplate, SENTINEL_ID, "r01b-review-sentinel", "STUDENT"); + + ReviewControllerFixtureUsers.remove(jdbcTemplate, PROBE_ID); + + assertThat(countUser(PROBE_ID)).isZero(); + assertThat(countUser(SENTINEL_ID)).isEqualTo(1); + } + + @Test + void fixtureCycleLeavesLegacySeedRowsUnchanged() { + List> before = seedRows(); + + ReviewControllerFixtureUsers.provision(jdbcTemplate, PROBE_ID, "r01b-review-probe", "ADMIN"); + ReviewControllerFixtureUsers.remove(jdbcTemplate, PROBE_ID); + + assertThat(seedRows()).isEqualTo(before); + } + + private int countUser(long id) { + return jdbcTemplate.queryForObject("SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, id); + } + + private List> seedRows() { + return jdbcTemplate.queryForList( + "SELECT id, phone, role, is_active, is_verified FROM users WHERE id IN (1, 2, 3) ORDER BY id"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureUsers.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureUsers.java new file mode 100644 index 0000000..868bd01 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/ReviewControllerFixtureUsers.java @@ -0,0 +1,24 @@ +package com.mydreamjob.review; + +import org.springframework.jdbc.core.JdbcTemplate; + +/** Test-only fixture helper that creates and removes only explicitly owned users. */ +final class ReviewControllerFixtureUsers { + + private ReviewControllerFixtureUsers() { + } + + static void provision(JdbcTemplate jdbcTemplate, long id, String phone, String role) { + remove(jdbcTemplate, id); + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "r01b-review-fixture-" + role, role); + } + + static void remove(JdbcTemplate jdbcTemplate, long... ids) { + for (long id : ids) { + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/review/StudentReviewWeightControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/review/StudentReviewWeightControllerTest.java index 8f08945..7078b5a 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/review/StudentReviewWeightControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/review/StudentReviewWeightControllerTest.java @@ -51,18 +51,15 @@ class StudentReviewWeightControllerTest { } private String studentToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(100L, "13800138000", - Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(100L, "STUDENT"); } private String companyToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(200L, "13800138001", - Map.of("roles", "COMPANY")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(200L, "COMPANY"); } private String adminToken() { - return "Bearer " + jwtTokenProvider.generateAccessToken(300L, "13800138002", - Map.of("roles", "ADMIN")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(300L, "ADMIN"); } // ── 模板列表 ────────────────────────────────────────────── diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/risk/AdminRiskControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/risk/AdminRiskControllerTest.java new file mode 100644 index 0000000..14b00d5 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/risk/AdminRiskControllerTest.java @@ -0,0 +1,260 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put; +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 AdminRiskControllerTest { + + private static final AtomicLong PHONE = new AtomicLong(7000); + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private UserRepository userRepository; + @Autowired private ScoringRuleConfigRepository ruleRepository; + @Autowired private ScoringRiskEventRepository eventRepository; + @Autowired private ScoringRiskActionRepository actionRepository; + + @MockBean private RedisTemplate redisTemplate; + + private Long adminUserId; + private Long studentUserId; + private Long companyUserId; + private final List createdEvents = new ArrayList<>(); + private ScoringRuleConfig reportRule; + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + adminUserId = createUser(User.Role.ADMIN); + studentUserId = createUser(User.Role.STUDENT); + companyUserId = createUser(User.Role.COMPANY); + reportRule = ruleRepository.findByRuleCode("REPORT_RATE_LIMIT_BURST").orElseThrow(); + } + + @AfterEach + void tearDown() { + restoreSeedRules(); // 规则是共享持久化种子，回滚测试对阈值的改动，避免跨测试/跨类污染 + for (Long id : createdEvents) { + actionRepository.deleteAll(); + eventRepository.deleteById(id); + } + createdEvents.clear(); + userRepository.deleteById(companyUserId); + userRepository.deleteById(studentUserId); + userRepository.deleteById(adminUserId); + } + + private void restoreSeedRules() { + resetRule("REPORT_RATE_LIMIT_BURST", "REPORT_RATE_LIMITED", 1, 60, "HIGH"); + resetRule("BLOCKED_MESSAGE_BURST", "BLOCKED_SEND_PROHIBITED", 3, 15, "MEDIUM"); + } + + private void resetRule(String code, String action, int threshold, int window, String severity) { + ruleRepository.findByRuleCode(code).ifPresent(rule -> { + rule.setSourceAction(action); + rule.setThresholdCount(threshold); + rule.setWindowMinutes(window); + rule.setSeverity(severity); + rule.setEnabled(true); + ruleRepository.save(rule); + }); + } + + private Long createUser(User.Role role) { + User u = userRepository.save(User.builder() + .phone("19" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(role).roles(Set.of(role)).active(true).verified(true).build()); + return u.getId(); + } + + private String token(Long userId, User.Role role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); + } + + private ScoringRiskEvent newEvent(String status, long version) { + ScoringRiskEvent ev = ScoringRiskEvent.builder() + .rule(reportRule).subjectUserId(111L).sourceAuditLogId(999L) + .sourceAction(reportRule.getSourceAction()).severity(reportRule.getSeverity()) + .windowStartedAt(LocalDateTime.now().minusHours(1)) + .windowEndedAt(LocalDateTime.now()) + .occurrenceCount(1).status(status) + .detectedAt(LocalDateTime.now()).version(version) + .build(); + ev = eventRepository.save(ev); + createdEvents.add(ev.getId()); + return ev; + } + + // ---- 匿名 401 ---- + + @Test + void anonymousAllEndpoints_401() throws Exception { + mockMvc.perform(get("/admin/scoring/risk/overview")).andExpect(status().isUnauthorized()); + mockMvc.perform(get("/admin/scoring/risk/trend").param("bucket", "DAY")).andExpect(status().isUnauthorized()); + mockMvc.perform(get("/admin/scoring/risk/distribution")).andExpect(status().isUnauthorized()); + mockMvc.perform(get("/admin/scoring/risk/events")).andExpect(status().isUnauthorized()); + mockMvc.perform(get("/admin/scoring/risk/rules")).andExpect(status().isUnauthorized()); + mockMvc.perform(put("/admin/scoring/risk/rules/RC").contentType(MediaType.APPLICATION_JSON) + .content("{\"enabled\":true,\"thresholdCount\":3,\"windowMinutes\":15,\"severity\":\"MEDIUM\",\"expectedVersion\":0}")) + .andExpect(status().isUnauthorized()); + mockMvc.perform(post("/admin/scoring/risk/events/1/actions").contentType(MediaType.APPLICATION_JSON) + .content("{\"action\":\"ACKNOWLEDGE\",\"reasonCode\":\"MONITORING\",\"expectedVersion\":0}")) + .andExpect(status().isUnauthorized()); + } + + // ---- 非 ADMIN 403 ---- + + @Test + void studentAndCompany_403() throws Exception { + String st = token(studentUserId, User.Role.STUDENT); + String co = token(companyUserId, User.Role.COMPANY); + for (String tk : new String[]{st, co}) { + mockMvc.perform(get("/admin/scoring/risk/overview").header("Authorization", tk)) + .andExpect(status().isForbidden()); + mockMvc.perform(get("/admin/scoring/risk/events").header("Authorization", tk)) + .andExpect(status().isForbidden()); + mockMvc.perform(get("/admin/scoring/risk/rules").header("Authorization", tk)) + .andExpect(status().isForbidden()); + } + } + + // ---- ADMIN 成功 ---- + + @Test + void adminOverview200() throws Exception { + mockMvc.perform(get("/admin/scoring/risk/overview") + .header("Authorization", token(adminUserId, User.Role.ADMIN))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data").exists()); + } + + @Test + void adminTrendDistributionEventsRules200() throws Exception { + String tk = token(adminUserId, User.Role.ADMIN); + mockMvc.perform(get("/admin/scoring/risk/trend").param("bucket", "DAY").header("Authorization", tk)) + .andExpect(status().isOk()); + mockMvc.perform(get("/admin/scoring/risk/trend").param("bucket", "HOUR").header("Authorization", tk)) + .andExpect(status().isOk()); + mockMvc.perform(get("/admin/scoring/risk/distribution").header("Authorization", tk)) + .andExpect(status().isOk()); + mockMvc.perform(get("/admin/scoring/risk/events").param("page", "0").param("size", "20").header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.items").isArray()); + mockMvc.perform(get("/admin/scoring/risk/rules").header("Authorization", tk)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.length()").value(2)); + } + + @Test + void adminUpdateRule200_andStale409() throws Exception { + String tk = token(adminUserId, User.Role.ADMIN); + long v = reportRule.getVersion(); + String okBody = "{\"enabled\":true,\"thresholdCount\":2,\"windowMinutes\":30,\"severity\":\"HIGH\",\"expectedVersion\":" + v + "}"; + mockMvc.perform(put("/admin/scoring/risk/rules/REPORT_RATE_LIMIT_BURST").header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON).content(okBody)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.thresholdCount").value(2)); + // 冲突版本 → 409 + String stale = "{\"enabled\":true,\"thresholdCount\":3,\"windowMinutes\":15,\"severity\":\"MEDIUM\",\"expectedVersion\":999}"; + mockMvc.perform(put("/admin/scoring/risk/rules/REPORT_RATE_LIMIT_BURST").header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON).content(stale)) + .andExpect(status().isConflict()) + .andExpect(jsonPath("$.code").value(9903)); + } + + @Test + void adminActionEvent200_noSensitiveFields() throws Exception { + ScoringRiskEvent ev = newEvent(ScoringRiskEvent.STATUS_OPEN, 0L); + String tk = token(adminUserId, User.Role.ADMIN); + String body = "{\"action\":\"ACKNOWLEDGE\",\"reasonCode\":\"MONITORING\",\"expectedVersion\":0}"; + String raw = mockMvc.perform(post("/admin/scoring/risk/events/{id}/actions", ev.getId()) + .header("Authorization", tk).contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.status").value("ACKNOWLEDGED")) + .andExpect(jsonPath("$.data.eventId").value(ev.getId())) + .andReturn().getResponse().getContentAsString(); + assertNoSensitive(raw); + } + + @Test + void adminActionEvent_reasonCodeMonitored() throws Exception { + ScoringRiskEvent ev = newEvent(ScoringRiskEvent.STATUS_OPEN, 0L); + String tk = token(adminUserId, User.Role.ADMIN); + String body = "{\"action\":\"DISMISS\",\"reasonCode\":\"CONFIRMED_FALSE_POSITIVE\",\"expectedVersion\":0}"; + mockMvc.perform(post("/admin/scoring/risk/events/{id}/actions", ev.getId()) + .header("Authorization", tk).contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.status").value("DISMISSED")); + } + + @Test + void adminInvalidFilter_400_9906() throws Exception { + String tk = token(adminUserId, User.Role.ADMIN); + // from > to + mockMvc.perform(get("/admin/scoring/risk/overview") + .param("from", "2026-09-03T00:00:00").param("to", "2026-08-01T00:00:00") + .header("Authorization", tk)) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(9906)); + // 非法 bucket + mockMvc.perform(get("/admin/scoring/risk/trend").param("bucket", "MINUTE").header("Authorization", tk)) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(9906)); + } + + @Test + void adminActionEvent_notFound_404_9902() throws Exception { + String tk = token(adminUserId, User.Role.ADMIN); + mockMvc.perform(post("/admin/scoring/risk/events/999999/actions").header("Authorization", tk) + .contentType(MediaType.APPLICATION_JSON) + .content("{\"action\":\"ACKNOWLEDGE\",\"reasonCode\":\"MONITORING\",\"expectedVersion\":0}")) + .andExpect(status().isNotFound()) + .andExpect(jsonPath("$.code").value(9902)); + } + + private void assertNoSensitive(String raw) { + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("subjectUserId"), "no subjectUserId"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("operatorUserId"), "no operatorUserId"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("phone"), "no phone"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("email"), "no email"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("ipAddress"), "no ipAddress"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("userAgent"), "no userAgent"); + org.junit.jupiter.api.Assertions.assertFalse(raw.contains("details"), "no details"); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskEventDetectorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskEventDetectorTest.java new file mode 100644 index 0000000..64c2b2c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskEventDetectorTest.java @@ -0,0 +1,205 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.audit.AuditService; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class RiskEventDetectorTest { + + @Mock private ScoringRuleConfigRepository ruleRepository; + @Mock private ScoringRiskEventRepository eventRepository; + @Mock private ScoringRiskScanCheckpointRepository checkpointRepository; + @Mock private AuditLogRepository auditLogRepository; + @Mock private AuditService auditService; + @Mock private Clock clock; + + @InjectMocks private RiskEventDetector detector; + + private static final LocalDateTime T = LocalDateTime.of(2026, 9, 3, 8, 0, 0); + + @BeforeEach + void time() { + org.mockito.Mockito.lenient().when(clock.getZone()).thenReturn(ZoneId.of("Asia/Shanghai")); + org.mockito.Mockito.lenient().when(clock.instant()).thenReturn(Instant.parse("2026-09-03T00:00:00Z")); + } + + private ScoringRuleConfig rule(long id, String action, int threshold, int window, boolean enabled) { + return ScoringRuleConfig.builder().id(id).ruleCode("R" + id).sourceAction(action) + .thresholdCount(threshold).windowMinutes(window).severity("HIGH").enabled(enabled).version(0L).build(); + } + + private AuditLog audit(long id, long userId, String action, LocalDateTime t) { + return AuditLog.builder().id(id).userId(userId).action(action).createdAt(t).build(); + } + + private ScoringRiskScanCheckpoint cp(long lastId) { + return ScoringRiskScanCheckpoint.builder().id(1L) + .checkpointKey(ScoringRiskScanCheckpoint.KEY_RISK_EVENT_DETECTOR).lastAuditLogId(lastId).build(); + } + + @Test + void createsEventWhenCountEqualsThreshold_reportedLimited() { + ScoringRuleConfig rule = rule(1L, "REPORT_RATE_LIMITED", 1, 60, true); + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())).thenReturn(List.of(audit(10L, 7L, "REPORT_RATE_LIMITED", T))); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + when(auditLogRepository.countByUserIdAndActionAndCreatedAtBetween(eq(7L), eq("REPORT_RATE_LIMITED"), any(), any())).thenReturn(1L); + when(eventRepository.existsByRuleIdAndSourceAuditLogId(1L, 10L)).thenReturn(false); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + + assertEquals(1, detector.scanOnce()); + verify(eventRepository, times(1)).saveAndFlush(any()); + ArgumentCaptor cap = ArgumentCaptor.forClass(ScoringRiskScanCheckpoint.class); + verify(checkpointRepository, times(1)).save(cap.capture()); + assertEquals(10L, cap.getValue().getLastAuditLogId()); + } + + @Test + void detectedAudit_usesSavedEventId_andMatchesDetailsRiskEventId() { + ScoringRuleConfig rule = rule(1L, "REPORT_RATE_LIMITED", 1, 60, true); + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())) + .thenReturn(List.of(audit(10L, 7L, "REPORT_RATE_LIMITED", T))); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + when(auditLogRepository.countByUserIdAndActionAndCreatedAtBetween(eq(7L), eq("REPORT_RATE_LIMITED"), any(), any())) + .thenReturn(1L); + when(eventRepository.existsByRuleIdAndSourceAuditLogId(1L, 10L)).thenReturn(false); + // saveAndFlush 的返回值才携带已生成的 ID（IDENTITY 策略），模拟真实底层行为 + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> { + ScoringRiskEvent e = inv.getArgument(0); + e.setId(42L); + return e; + }); + + assertEquals(1, detector.scanOnce()); + + org.mockito.ArgumentCaptor entityId = org.mockito.ArgumentCaptor.forClass(Long.class); + org.mockito.ArgumentCaptor details = org.mockito.ArgumentCaptor.forClass(String.class); + verify(auditService).log(isNull(), eq("RISK_EVENT_DETECTED"), eq("SCORING_RISK_EVENT"), + entityId.capture(), details.capture(), any()); + assertEquals(42L, entityId.getValue()); // entity_id 非空且等于事件 ID + assertEquals(42L, Long.parseLong( + details.getValue().replaceAll(".*\\\"riskEventId\\\":(\\d+).*", "$1"))); // 与 details.riskEventId 一致 + assertTrue(details.getValue().contains("\"riskEventId\":42")); + assertFalse(details.getValue().contains("subjectUserId"), "no subjectUserId"); + assertFalse(details.getValue().contains("phone"), "no phone"); + assertFalse(details.getValue().contains("email"), "no email"); + assertFalse(details.getValue().contains("ipAddress"), "no ipAddress"); + assertFalse(details.getValue().contains("userAgent"), "no userAgent"); + assertFalse(details.getValue().contains("token"), "no token"); + assertFalse(details.getValue().contains("password"), "no password"); + assertFalse(details.getValue().contains("secret"), "no secret"); + assertFalse(details.getValue().contains("details"), "no raw audit details"); + } + + @Test + void noEventWhenBelowThreshold_blockedMessage() { + ScoringRuleConfig rule = rule(2L, "BLOCKED_SEND_PROHIBITED", 3, 15, true); + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())).thenReturn(List.of(audit(5L, 7L, "BLOCKED_SEND_PROHIBITED", T))); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + when(auditLogRepository.countByUserIdAndActionAndCreatedAtBetween(eq(7L), eq("BLOCKED_SEND_PROHIBITED"), any(), any())).thenReturn(1L); + + assertEquals(0, detector.scanOnce()); + verify(eventRepository, never()).saveAndFlush(any()); + } + + @Test + void onlyFirstThresholdHitCreatesEvent_deDuplicates() { + ScoringRuleConfig rule = rule(2L, "BLOCKED_SEND_PROHIBITED", 3, 15, true); + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())).thenReturn(List.of( + audit(1L, 7L, "BLOCKED_SEND_PROHIBITED", T.minusMinutes(2)), + audit(2L, 7L, "BLOCKED_SEND_PROHIBITED", T.minusMinutes(1)), + audit(3L, 7L, "BLOCKED_SEND_PROHIBITED", T), + audit(4L, 7L, "BLOCKED_SEND_PROHIBITED", T.plusMinutes(1)))); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + when(auditLogRepository.countByUserIdAndActionAndCreatedAtBetween(eq(7L), eq("BLOCKED_SEND_PROHIBITED"), any(), any())) + .thenReturn(1L, 2L, 3L, 4L); + when(eventRepository.existsByRuleIdAndSourceAuditLogId(2L, 3L)).thenReturn(false); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + + assertEquals(1, detector.scanOnce()); + verify(eventRepository, times(1)).saveAndFlush(any()); + assertEquals(4L, checkpointCapture().getLastAuditLogId()); + } + + @Test + void disabledRuleProducesNoEvent_andCheckpointAdvances() { + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())) + .thenReturn(List.of(audit(9L, 7L, "REPORT_RATE_LIMITED", T))); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of()); // 规则被禁用 → 无规则 + + assertEquals(0, detector.scanOnce()); + verify(eventRepository, never()).saveAndFlush(any()); + assertEquals(9L, checkpointCapture().getLastAuditLogId()); + } + + @Test + void repeatsScanWithoutDuplicateEvent() { + ScoringRuleConfig rule = rule(1L, "REPORT_RATE_LIMITED", 1, 60, true); + // 第一次扫描：创建事件并推进到 10 + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())) + .thenReturn(Optional.of(cp(0L)), Optional.of(cp(10L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())) + .thenReturn(List.of(audit(10L, 7L, "REPORT_RATE_LIMITED", T))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(10L), any())).thenReturn(List.of()); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + when(auditLogRepository.countByUserIdAndActionAndCreatedAtBetween(eq(7L), eq("REPORT_RATE_LIMITED"), any(), any())).thenReturn(1L); + when(eventRepository.existsByRuleIdAndSourceAuditLogId(1L, 10L)).thenReturn(false); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + + assertEquals(1, detector.scanOnce()); + assertEquals(0, detector.scanOnce()); + verify(eventRepository, times(1)).saveAndFlush(any()); + } + + @Test + void auditWithNullUserIsSkipped() { + ScoringRuleConfig rule = rule(1L, "REPORT_RATE_LIMITED", 1, 60, true); + when(checkpointRepository.findByCheckpointKeyForUpdate(anyString())).thenReturn(Optional.of(cp(0L))); + when(auditLogRepository.findByIdAfterOrderByIdAsc(eq(0L), any())).thenReturn(List.of( + AuditLog.builder().id(11L).userId(null).action("REPORT_RATE_LIMITED").createdAt(T).build())); + when(ruleRepository.findAllByEnabledTrue()).thenReturn(List.of(rule)); + + assertEquals(0, detector.scanOnce()); + verify(eventRepository, never()).saveAndFlush(any()); + assertEquals(11L, checkpointCapture().getLastAuditLogId()); + } + + private ScoringRiskScanCheckpoint checkpointCapture() { + ArgumentCaptor cap = ArgumentCaptor.forClass(ScoringRiskScanCheckpoint.class); + verify(checkpointRepository, times(1)).save(cap.capture()); + return cap.getValue(); + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernancePersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernancePersistenceIntegrationTest.java new file mode 100644 index 0000000..ea2f635 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernancePersistenceIntegrationTest.java @@ -0,0 +1,334 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditLog; +import com.mydreamjob.audit.AuditLogRepository; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.candidatescore.CandidateDimensionScoreRepository; +import com.mydreamjob.risk.dto.RiskEventActionRequest; +import com.mydreamjob.risk.dto.RiskRuleUpdateRequest; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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 java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@SpringBootTest +@ActiveProfiles("integration-test") +class RiskGovernancePersistenceIntegrationTest { + + private static final AtomicLong PHONE = new AtomicLong(8000); + private static final LocalDateTime NOW = LocalDateTime.of(2026, 9, 3, 8, 0, 0); + + @Autowired private RiskEventDetector detector; + @Autowired private RiskGovernanceService service; + @Autowired private ScoringRuleConfigRepository ruleRepository; + @Autowired private ScoringRiskEventRepository eventRepository; + @Autowired private ScoringRiskActionRepository actionRepository; + @Autowired private ScoringRiskScanCheckpointRepository checkpointRepository; + @Autowired private AuditLogRepository auditLogRepository; + @Autowired private UserRepository userRepository; + @Autowired private CandidateDimensionScoreRepository dimensionScoreRepository; + + @MockBean private RedisTemplate redisTemplate; + @MockBean private Clock clock; + + private final AuditContext ctx = AuditContext.builder().requestId("req").build(); + private final List createdUsers = new ArrayList<>(); + private final List createdAuditIds = new ArrayList<>(); + private Long userA; + + @BeforeEach + void setUp() { + when(redisTemplate.opsForValue()).thenReturn(mock(org.springframework.data.redis.core.ValueOperations.class)); + when(redisTemplate.hasKey(any())).thenReturn(false); + when(clock.getZone()).thenReturn(ZoneId.of("Asia/Shanghai")); + when(clock.instant()).thenReturn(NOW.atZone(ZoneId.of("Asia/Shanghai")).toInstant()); + userA = createUser(); + resetSeedRules(); + resetRiskState(); + } + + /** 规则是共享持久化种子，跨测试/跨类可能被改阈值；强制回到初始值，保证扫描断言确定性。 */ + private void resetSeedRules() { + resetRule("REPORT_RATE_LIMIT_BURST", 1, 60, "HIGH"); + resetRule("BLOCKED_MESSAGE_BURST", 3, 15, "MEDIUM"); + } + + private void resetRule(String code, int threshold, int window, String severity) { + ruleRepository.findByRuleCode(code).ifPresent(rule -> { + rule.setThresholdCount(threshold); + rule.setWindowMinutes(window); + rule.setSeverity(severity); + rule.setEnabled(true); + ruleRepository.save(rule); + }); + } + + @AfterEach + void tearDown() { + for (Long id : createdUsers) { + userRepository.deleteById(id); + } + createdUsers.clear(); + resetRiskState(); + } + + /** 清空风险事件/操作，并将 checkpoint 重置为当前最大审计 id（忽略历史审计，避免串扰）。 */ + private void resetRiskState() { + actionRepository.deleteAll(); + eventRepository.deleteAll(); + long base = maxAuditId(); + ScoringRiskScanCheckpoint cp = checkpointRepository.findByCheckpointKey("RISK_EVENT_DETECTOR").orElseGet( + () -> checkpointRepository.save(ScoringRiskScanCheckpoint.builder() + .checkpointKey("RISK_EVENT_DETECTOR").lastAuditLogId(0L).build())); + cp.setLastAuditLogId(base); + checkpointRepository.save(cp); + createdAuditIds.clear(); + } + + private long maxAuditId() { + return auditLogRepository.findAll().stream().mapToLong(AuditLog::getId).max().orElse(0L); + } + + private Long createUser() { + User u = userRepository.save(User.builder() + .phone("20" + String.format("%08d", PHONE.incrementAndGet())).nickname("u") + .role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).active(true).verified(true).build()); + createdUsers.add(u.getId()); + return u.getId(); + } + + private AuditLog insertAudit(Long userId, String action, LocalDateTime createdAt) { + AuditLog a = auditLogRepository.save(AuditLog.builder() + .userId(userId).action(action).entityType("USER").entityId(userId) + .details("{\"fromScanTest\":true}").requestId("req").createdAt(createdAt).build()); + createdAuditIds.add(a.getId()); + return a; + } + + private ScoringRuleConfig rule(String code) { + return ruleRepository.findByRuleCode(code).orElseThrow(); + } + + @Test + void flyway_seedsRulesAndCheckpoint_andIndexApplied() { + assertEquals(2, ruleRepository.findAll().size()); + assertTrue(ruleRepository.findByRuleCode("REPORT_RATE_LIMIT_BURST").isPresent()); + assertTrue(ruleRepository.findByRuleCode("BLOCKED_MESSAGE_BURST").isPresent()); + ScoringRiskScanCheckpoint cp = checkpointRepository.findByCheckpointKey("RISK_EVENT_DETECTOR").orElseThrow(); + assertNotNull(cp.getLastAuditLogId()); + } + + @Test + void scanDetectsReportRateLimited_andWritesAudit_noDuplicate() { + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(1)); + int created = detector.scanOnce(); + assertEquals(1, created); + // 重复扫描不重复建事件 + assertEquals(0, detector.scanOnce()); + List events = eventRepository.findAll(); + assertEquals(1, events.size()); + ScoringRiskEvent ev = events.get(0); + assertEquals(rule("REPORT_RATE_LIMIT_BURST").getId(), ev.getRule().getId()); + assertEquals("REPORT_RATE_LIMITED", ev.getSourceAction()); + assertEquals("HIGH", ev.getSeverity()); + assertEquals(ScoringRiskEvent.STATUS_OPEN, ev.getStatus()); + // subjectUserId 入库但不暴露给响应 DTO（白名单已保证） + assertNotNull(ev.getSubjectUserId()); + // RISK_EVENT_DETECTED 审计脱敏：必存在一条（取最新），且不含用户手机/详情/IP/敏感字段 + String det = auditLogRepository.findAll().stream() + .filter(a -> "RISK_EVENT_DETECTED".equals(a.getAction())) + .max(java.util.Comparator.comparing(AuditLog::getId)) + .orElseThrow(() -> new AssertionError("missing RISK_EVENT_DETECTED audit")) + .getDetails(); + assertTrue(det.contains("\"riskEventId\"")); + assertTrue(det.contains("\"ruleCode\"")); + assertTrue(det.contains("\"severity\"")); + assertTrue(det.contains("\"occurrenceCount\"")); + assertFalse(det.contains("subjectUserId")); + assertFalse(det.contains("fromScanTest"), "不得复制原始审计 details"); + } + + @Test + void detectedAudit_isLinkedToEvent_andRedacted() { + // 单一 REPORT_RATE_LIMITED（threshold=1，确定性恰好 1 条事件）验证每条事件的检测审计可精确定位 + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(3)); + detector.scanOnce(); + + List events = eventRepository.findAll(); + assertFalse(events.isEmpty(), "at least one risk event created"); + + for (ScoringRiskEvent ev : events) { + List linked = auditLogRepository.findAll().stream() + .filter(a -> "RISK_EVENT_DETECTED".equals(a.getAction())) + .filter(a -> a.getEntityId() != null && a.getEntityId().equals(ev.getId())) + .toList(); + // 每个新建事件恰好一条可定位的检测审计 + assertEquals(1, linked.size(), "event " + ev.getId() + " must have exactly one linked audit"); + assertEquals(ev.getId(), linked.get(0).getEntityId(), "audit entity_id == event id"); + + String det = linked.get(0).getDetails(); + // details.riskEventId 非空且等于同一 id + assertTrue(det.contains("\"riskEventId\":" + ev.getId()), "details.riskEventId == event id"); + // 审计 details 脱敏 + assertFalse(det.contains("subjectUserId"), "no subjectUserId"); + assertFalse(det.contains("phone"), "no phone"); + assertFalse(det.contains("email"), "no email"); + assertFalse(det.contains("ipAddress"), "no ipAddress"); + assertFalse(det.contains("userAgent"), "no userAgent"); + assertFalse(det.contains("token"), "no token"); + assertFalse(det.contains("password"), "no password"); + assertFalse(det.contains("secret"), "no secret"); + } + // 不得存在 entity_id 为 NULL 且无法定位的检测审计 + assertFalse(auditLogRepository.findAll().stream().anyMatch(a -> + "RISK_EVENT_DETECTED".equals(a.getAction()) && a.getEntityId() == null), + "no RISK_EVENT_DETECTED audit with NULL entity_id"); + } + + @Test + void scanCheckpointAdvanceAndResume() { + // REPORT threshold=1：单条命中稳定生成 1 条事件；随后追加的同窗口命中不再生成（count>threshold）， + // 借此确定性验证 checkpoint 断点续扫（不依赖 createdAt 排序/窗口多条目阈值）。 + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(2)); + assertEquals(1, detector.scanOnce(), "单条 REPORT 命中 threshold=1"); + long cpAfterFirst = checkpointRepository.findByCheckpointKey("RISK_EVENT_DETECTOR").orElseThrow().getLastAuditLogId(); + // 追加两条同用户同窗口 REPORT：count>1 != 阈值 → 不再生成事件，仅推进 checkpoint + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(1)); + insertAudit(userA, "REPORT_RATE_LIMITED", NOW); + assertEquals(0, detector.scanOnce(), "追加命中 count>threshold 不刷屏"); + long cpAfterSecond = checkpointRepository.findByCheckpointKey("RISK_EVENT_DETECTOR").orElseThrow().getLastAuditLogId(); + assertTrue(cpAfterSecond > cpAfterFirst, "checkpoint 应续扫前进"); + assertEquals(1, eventRepository.findAll().size(), "始终只生成一条事件"); + } + + @Test + void statusMachine_andActionAudit_andTerminal() { + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(1)); + detector.scanOnce(); + ScoringRiskEvent ev = eventRepository.findAll().get(0); + RiskEventActionRequest ack = action("ACKNOWLEDGE", "MONITORING", 0L); + var afterAck = service.actionEvent(ev.getId(), ack, userA, ctx); + assertEquals(ScoringRiskEvent.STATUS_ACKNOWLEDGED, afterAck.getStatus()); + assertEquals(1, actionRepository.findAll().size()); + + // ACKNOWLEDGED → DISMISS + long v = afterAck.getVersion(); + var afterDism = service.actionEvent(ev.getId(), action("DISMISS", "CONFIRMED_FALSE_POSITIVE", v), userA, ctx); + assertEquals(ScoringRiskEvent.STATUS_DISMISSED, afterDism.getStatus()); + assertEquals(2, actionRepository.findAll().size()); + + // DISMISSED 终态：再次操作被拒 + assertThrows(com.mydreamjob.common.exception.BusinessException.class, + () -> service.actionEvent(ev.getId(), action("ACKNOWLEDGE", "MONITORING", afterDism.getVersion()), userA, ctx)); + + // RISK_EVENT_ACTIONED 审计不包含敏感字段 + List acted = auditLogRepository.findAll().stream() + .filter(a -> "RISK_EVENT_ACTIONED".equals(a.getAction())).toList(); + assertFalse(acted.isEmpty()); + assertFalse(acted.get(0).getDetails().contains("subjectUserId")); + } + + @Test + void ruleUpdate_persists_andRespectsVersion() { + ScoringRuleConfig rc = rule("BLOCKED_MESSAGE_BURST"); + RiskRuleUpdateRequest req = new RiskRuleUpdateRequest(); + req.setEnabled(false); + req.setThresholdCount(5); + req.setWindowMinutes(60); + req.setSeverity("LOW"); + req.setExpectedVersion(rc.getVersion()); + var updated = service.updateRule("BLOCKED_MESSAGE_BURST", req, userA, ctx); + assertEquals(false, updated.getEnabled()); + assertEquals(5, updated.getThresholdCount()); + // 重新加载确认持久化 + ScoringRuleConfig reloaded = rule("BLOCKED_MESSAGE_BURST"); + assertFalse(reloaded.getEnabled()); + assertEquals(5, reloaded.getThresholdCount()); + // 版本已推进 + assertNotEquals(0L, reloaded.getVersion().longValue()); + // 非法版本 → 9903 + RiskRuleUpdateRequest stale = new RiskRuleUpdateRequest(); + stale.setEnabled(true); stale.setThresholdCount(3); stale.setWindowMinutes(15); + stale.setSeverity("MEDIUM"); stale.setExpectedVersion(0L); + com.mydreamjob.common.exception.BusinessException ex = assertThrows( + com.mydreamjob.common.exception.BusinessException.class, + () -> service.updateRule("BLOCKED_MESSAGE_BURST", stale, userA, ctx)); + assertEquals(com.mydreamjob.common.exception.ErrorCode.RISK_RULE_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void candidateDimensionScores_unchanged() { + long base = dimensionScoreRepository.count(); + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(1)); + detector.scanOnce(); + assertEquals(base, dimensionScoreRepository.count(), "风险扫描不得写 candidate_dimension_scores"); + } + + @Test + void concurrentScan_onlyOneEvent_no500() throws Exception { + insertAudit(userA, "REPORT_RATE_LIMITED", NOW.minusMinutes(1)); + int n = 2; + ExecutorService pool = Executors.newFixedThreadPool(n); + CountDownLatch start = new CountDownLatch(1); + CountDownLatch done = new CountDownLatch(n); + ConcurrentLinkedQueue created = new ConcurrentLinkedQueue<>(); + for (int i = 0; i < n; i++) { + pool.submit(() -> { + await(start); + try { + created.add(detector.scanOnce()); + } catch (Exception e) { + created.add(-1); + } finally { + done.countDown(); + } + }); + } + start.countDown(); + assertTrue(done.await(30, TimeUnit.SECONDS)); + pool.shutdown(); + assertFalse(created.contains(-1), "no 500"); + assertEquals(1, eventRepository.findAll().size(), "并发扫描只生成一条事件"); + } + + private void await(CountDownLatch latch) { + try { + latch.await(); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + + private RiskEventActionRequest action(String a, String reason, long version) { + RiskEventActionRequest r = new RiskEventActionRequest(); + r.setAction(a); + r.setReasonCode(reason); + r.setExpectedVersion(version); + return r; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernanceServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernanceServiceTest.java new file mode 100644 index 0000000..7a8dd02 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/risk/RiskGovernanceServiceTest.java @@ -0,0 +1,241 @@ +package com.mydreamjob.risk; + +import com.mydreamjob.audit.AuditContext; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.risk.dto.RiskEventActionRequest; +import com.mydreamjob.risk.dto.RiskRuleUpdateRequest; +import org.junit.jupiter.api.BeforeEach; +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 org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; +import org.springframework.dao.OptimisticLockingFailureException; + +import java.time.Clock; +import java.time.Instant; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.util.List; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.lenient; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class RiskGovernanceServiceTest { + + @Mock private ScoringRuleConfigRepository ruleRepository; + @Mock private ScoringRiskEventRepository eventRepository; + @Mock private ScoringRiskActionRepository actionRepository; + @Mock private AuditService auditService; + @Mock private Clock clock; + @InjectMocks private RiskGovernanceService service; + + private final AuditContext ctx = AuditContext.builder().requestId("r").build(); + private static final LocalDateTime FROM = LocalDateTime.of(2026, 8, 27, 0, 0); + private static final LocalDateTime TO = LocalDateTime.of(2026, 9, 3, 0, 0); + + @BeforeEach + void setUp() { + lenient().when(clock.getZone()).thenReturn(ZoneId.of("Asia/Shanghai")); + lenient().when(clock.instant()).thenReturn(Instant.parse("2026-09-03T00:00:00Z")); + } + + private ScoringRuleConfig rule(long version) { + ScoringRuleConfig r = ScoringRuleConfig.builder().id(1L).ruleCode("BLOCKED_MESSAGE_BURST") + .sourceAction("BLOCKED_SEND_PROHIBITED").thresholdCount(3).windowMinutes(15) + .severity("MEDIUM").enabled(true).version(version).build(); + return r; + } + + private ScoringRiskEvent event(String status, long version) { + return ScoringRiskEvent.builder().id(1L).rule(rule(0L)).subjectUserId(7L) + .sourceAuditLogId(10L).sourceAction("BLOCKED_SEND_PROHIBITED").severity("MEDIUM") + .windowStartedAt(FROM).windowEndedAt(TO).occurrenceCount(3) + .status(status).detectedAt(TO).version(version).build(); + } + + // ---- 规则更新 ---- + + @Test + void updateRule_success() { + when(ruleRepository.findByRuleCode("BLOCKED_MESSAGE_BURST")).thenReturn(Optional.of(rule(2L))); + when(ruleRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + RiskRuleUpdateRequest req = req(3, 15, "MEDIUM", true, 2L); + var resp = service.updateRule("BLOCKED_MESSAGE_BURST", req, 9L, ctx); + assertEquals("BLOCKED_MESSAGE_BURST", resp.getRuleCode()); + verify(auditService, times(1)).log(eq(9L), eq("RISK_RULE_UPDATED"), eq("SCORING_RULE_CONFIG"), eq(1L), anyString(), any()); + } + + @Test + void updateRule_staleVersion_returns9903() { + when(ruleRepository.findByRuleCode("RC")).thenReturn(Optional.of(rule(2L))); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.updateRule("RC", req(3, 15, "MEDIUM", true, 1L), 9L, ctx)); + assertEquals(ErrorCode.RISK_RULE_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + @Test + void updateRule_notFound_returns9901() { + when(ruleRepository.findByRuleCode("NOPE")).thenReturn(Optional.empty()); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.updateRule("NOPE", req(3, 15, "MEDIUM", true, 0L), 9L, ctx)); + assertEquals(ErrorCode.RISK_RULE_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void updateRule_optimisticLock_returns9903() { + when(ruleRepository.findByRuleCode("RC")).thenReturn(Optional.of(rule(0L))); + when(ruleRepository.saveAndFlush(any())).thenThrow(new OptimisticLockingFailureException("x")); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.updateRule("RC", req(3, 15, "MEDIUM", true, 0L), 9L, ctx)); + assertEquals(ErrorCode.RISK_RULE_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + // ---- 事件人工操作 / 状态机 ---- + + @Test + void actionEvent_openAcknowledge() { + when(eventRepository.findById(1L)).thenReturn(Optional.of(event("OPEN", 0L))); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + when(actionRepository.save(any())).thenReturn(null); + var resp = service.actionEvent(1L, action("ACKNOWLEDGE", "MONITORING", 0L), 9L, ctx); + assertEquals("ACKNOWLEDGED", resp.getStatus()); + verify(auditService, times(1)).log(eq(9L), eq("RISK_EVENT_ACTIONED"), eq("SCORING_RISK_EVENT"), eq(1L), anyString(), any()); + } + + @Test + void actionEvent_openDismiss() { + when(eventRepository.findById(1L)).thenReturn(Optional.of(event("OPEN", 0L))); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + when(actionRepository.save(any())).thenReturn(null); + assertEquals("DISMISSED", service.actionEvent(1L, action("DISMISS", "MONITORING", 0L), 9L, ctx).getStatus()); + } + + @Test + void actionEvent_acknowledgedDismiss() { + when(eventRepository.findById(1L)).thenReturn(Optional.of(event("ACKNOWLEDGED", 1L))); + when(eventRepository.saveAndFlush(any())).thenAnswer(inv -> inv.getArgument(0)); + when(actionRepository.save(any())).thenReturn(null); + assertEquals("DISMISSED", service.actionEvent(1L, action("DISMISS", "MONITORING", 1L), 9L, ctx).getStatus()); + } + + @Test + void actionEvent_terminalDismissed_isRejected9905() { + when(eventRepository.findById(1L)).thenReturn(Optional.of(event("DISMISSED", 5L))); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.actionEvent(1L, action("ACKNOWLEDGE", "MONITORING", 5L), 9L, ctx)); + assertEquals(ErrorCode.RISK_INVALID_ACTION.getCode(), ex.getErrorCodeInt()); + } + + @Test + void actionEvent_invalidAction_returns9905() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.actionEvent(1L, action("AUTO_BAN", "MONITORING", 0L), 9L, ctx)); + assertEquals(ErrorCode.RISK_INVALID_ACTION.getCode(), ex.getErrorCodeInt()); + } + + @Test + void actionEvent_invalidReason_returns9905() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.actionEvent(1L, action("DISMISS", "FREE_TEXT_NOTE", 0L), 9L, ctx)); + assertEquals(ErrorCode.RISK_INVALID_ACTION.getCode(), ex.getErrorCodeInt()); + } + + @Test + void actionEvent_notFound_returns9902() { + when(eventRepository.findById(99L)).thenReturn(Optional.empty()); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.actionEvent(99L, action("ACKNOWLEDGE", "MONITORING", 0L), 9L, ctx)); + assertEquals(ErrorCode.RISK_EVENT_NOT_FOUND.getCode(), ex.getErrorCodeInt()); + } + + @Test + void actionEvent_staleVersion_returns9904() { + when(eventRepository.findById(1L)).thenReturn(Optional.of(event("OPEN", 0L))); + BusinessException ex = assertThrows(BusinessException.class, + () -> service.actionEvent(1L, action("ACKNOWLEDGE", "MONITORING", 7L), 9L, ctx)); + assertEquals(ErrorCode.RISK_EVENT_CONCURRENT_UPDATE.getCode(), ex.getErrorCodeInt()); + } + + // ---- 查询 / 过滤 ---- + + @Test + void events_invalidRange_returns9906() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.events(0, 20, null, null, null, TO, FROM)); + assertEquals(ErrorCode.RISK_INVALID_FILTER.getCode(), ex.getErrorCodeInt()); + } + + @Test + void events_invalidSeverity_returns9906() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.events(0, 20, null, "CRITICAL", null, FROM, TO)); + assertEquals(ErrorCode.RISK_INVALID_FILTER.getCode(), ex.getErrorCodeInt()); + } + + @Test + void events_badPageSize_returns1001() { + BusinessException ex = assertThrows(BusinessException.class, + () -> service.events(0, 51, null, null, null, FROM, TO)); + assertEquals(ErrorCode.BAD_REQUEST.getCode(), ex.getErrorCodeInt()); + } + + @Test + void events_joinsRule_noN1() { + ScoringRiskEvent ev = event("OPEN", 0L); + when(eventRepository.search(any(), any(), any(), any(), any(), any(PageRequest.class))) + .thenReturn(new PageImpl<>(List.of(ev))); + Page page = service.events(0, 20, null, null, null, FROM, TO); + assertEquals(1, page.getContent().size()); + // search 使用 JOIN FETCH，不应再逐事件查询规则 + verify(ruleRepository, never()).findById(anyLong()); + } + + @Test + void overview_usesProjections() { + when(eventRepository.countByStatusAndDetectedAtBetween(anyString(), any(), any())).thenReturn(5L); + when(eventRepository.countGroupBySeverity(anyString(), any(), any())).thenReturn(List.of( + new Object[]{"HIGH", 5L})); + when(eventRepository.countGroupByRuleCode(anyString(), any(), any())).thenReturn(List.of( + new Object[]{"REPORT_RATE_LIMIT_BURST", 5L})); + when(eventRepository.findMaxDetectedAtByStatusBetween(anyString(), any(), any())).thenReturn(TO); + var resp = service.overview(FROM, TO); + assertEquals(5L, resp.getOpenCount()); + verify(ruleRepository, never()).findById(anyLong()); + } + + private RiskRuleUpdateRequest req(int threshold, int window, String sev, boolean enabled, long version) { + RiskRuleUpdateRequest r = new RiskRuleUpdateRequest(); + r.setThresholdCount(threshold); + r.setWindowMinutes(window); + r.setSeverity(sev); + r.setEnabled(enabled); + r.setExpectedVersion(version); + return r; + } + + private RiskEventActionRequest action(String a, String reason, long version) { + RiskEventActionRequest r = new RiskEventActionRequest(); + r.setAction(a); + r.setReasonCode(reason); + r.setExpectedVersion(version); + return r; + } +} \ No newline at end of file diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/safety/AdminReportControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/safety/AdminReportControllerTest.java index 4e8aa9a..8955356 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/safety/AdminReportControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/safety/AdminReportControllerTest.java @@ -101,13 +101,11 @@ class AdminReportControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } private String tokenWithRole(Long userId, User.Role role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", role.name())); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); } @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/safety/BlockControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/safety/BlockControllerTest.java index 8c46a23..ba82b8d 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/safety/BlockControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/safety/BlockControllerTest.java @@ -88,8 +88,7 @@ class BlockControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } @Test diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/safety/ReportControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/safety/ReportControllerTest.java index 46df0df..0bf67bf 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/safety/ReportControllerTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/safety/ReportControllerTest.java @@ -123,13 +123,11 @@ class ReportControllerTest { } private String token(Long userId) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", "STUDENT")); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, "STUDENT"); } private String tokenWithRole(Long userId, User.Role role) { - return "Bearer " + jwtTokenProvider.generateAccessToken(userId, - String.valueOf(userId), Map.of("roles", role.name())); + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role.name()); } // ── 用户举报 ──────────────────────────────────────────────── diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuardTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuardTest.java new file mode 100644 index 0000000..3b54e70 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessDisclosureGuardTest.java @@ -0,0 +1,31 @@ +package com.mydreamjob.scoringmonitoring; + +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +class FairnessDisclosureGuardTest { + @Test + void usesIndependentCandidateThresholdAndComplementSuppression() { + assertThat(FairnessDisclosureGuard.suppressRatio(29, 29)).isTrue(); + assertThat(FairnessDisclosureGuard.suppressRatio(100, 1)).isTrue(); + assertThat(FairnessDisclosureGuard.suppressRatio(100, 99)).isTrue(); + assertThat(FairnessDisclosureGuard.suppressRatio(100, 50)).isFalse(); + } + + @Test + void anySmallCellSuppressesWholeGroup() { + assertThat(FairnessDisclosureGuard.suppressCells(100, List.of(99, 1), true)).isTrue(); + assertThat(FairnessDisclosureGuard.suppressCells(100, List.of(30, 70), true)).isFalse(); + assertThat(FairnessDisclosureGuard.suppressCells(100, List.of(30, 70), false)).isFalse(); + } + + @Test + void zeroAndFullSetsAreNotMistakenForSmallPeopleCells() { + assertThat(FairnessDisclosureGuard.isSmallCell(0)).isFalse(); + assertThat(FairnessDisclosureGuard.isSmallCell(30)).isFalse(); + assertThat(FairnessDisclosureGuard.isSmallComplement(100, 100)).isFalse(); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessIndependentReviewTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessIndependentReviewTest.java new file mode 100644 index 0000000..41c1e0c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessIndependentReviewTest.java @@ -0,0 +1,91 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import org.junit.jupiter.api.Test; +import java.math.BigDecimal; +import java.time.LocalDate; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.*; +import static org.mockito.ArgumentMatchers.any; + +class FairnessIndependentReviewTest { + private FairnessMonitoringService service(FairnessMonitoringRepository repository) { + UserRepository users = mock(UserRepository.class); + when(users.findById(1L)).thenReturn(Optional.of(User.builder().id(1L) + .role(User.Role.ADMIN).roles(Set.of(User.Role.ADMIN)).active(true).build())); + return new FairnessMonitoringService(repository, users); + } + + @Test + void smallComparablePopulationMustHideAllChangeStatistics() { + var repository = mock(FairnessMonitoringRepository.class); + // Sixty people have an invalid rollback; one also has a legal changed rollback + // in a different dimension (so there is no repeated-appeal group). + var aggregate = new FairnessMonitoringRepository.AppealAggregateSummary( + 61, 60, Map.of("ROLLED_BACK", 61), Map.of("ROLLED_BACK", 60), + 60, 60, 60, 0, 1, 1, 1, 1, 0, 0, + BigDecimal.TEN, BigDecimal.TEN, 0, 60, 0); + when(repository.findAppealAggregateSummary(any(), any())).thenReturn(aggregate); + var result = service(repository).appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 8, 2)); + assertThat(result.getAvailability()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(result.getComparableRollbackCount()).isNull(); + assertThat(result.getChangedCandidateCount()).as("one-person change group must not leak").isNull(); + assertThat(result.getChangedCount()).isNull(); + assertThat(result.getActualScoreChangeRate()).isNull(); + assertThat(result.getMeanDelta()).isNull(); + assertThat(result.getMeanAbsoluteDelta()).isNull(); + } + + @Test + void versionLocalComplementMustNotLeakThroughVersionPopulationAndDistribution() { + var repository = mock(FairnessMonitoringRepository.class); + // Global valid/invalid is 169/31, but v0.1 has a protected 99/1 split. + var aggregate = new FairnessMonitoringRepository.OverviewAggregateData(200, 169, + Map.of("candidate-scoring-v0.1", 100, "candidate-scoring-v0.2", 100, "MIXED", 0, "UNKNOWN", 0), + Map.of("candidate-scoring-v0.1", List.of(new FairnessStatisticsCalculator.ScoreFrequency(BigDecimal.valueOf(50), 99)), + "candidate-scoring-v0.2", List.of(new FairnessStatisticsCalculator.ScoreFrequency(BigDecimal.valueOf(50), 70)))); + when(repository.findOverviewAggregateData("2026-08")).thenReturn(aggregate); + var result = service(repository).overview(1L, "2026-08"); + boolean disclosedPopulation = result.getVersionCounts() != null + && Integer.valueOf(100).equals(result.getVersionCounts().get("candidate-scoring-v0.1")); + var distribution = result.getDistributionsByRulesVersion() == null ? null + : result.getDistributionsByRulesVersion().get("candidate-scoring-v0.1"); + boolean disclosedValid = distribution != null && Integer.valueOf(99).equals(distribution.getSampleSize()); + assertThat(disclosedPopulation && disclosedValid) + .as("version population 100 minus valid sample 99 reveals one protected person").isFalse(); + } + + @Test + void safeVersionCellRemainsAvailableWhenSiblingVersionIsSuppressed() { + var repository = mock(FairnessMonitoringRepository.class); + var aggregate = new FairnessMonitoringRepository.OverviewAggregateData(200, 169, + Map.of("candidate-scoring-v0.1", 100, "candidate-scoring-v0.2", 100, + "MIXED", 0, "UNKNOWN", 0), + Map.of("candidate-scoring-v0.1", List.of( + new FairnessStatisticsCalculator.ScoreFrequency(BigDecimal.valueOf(50), 99)), + "candidate-scoring-v0.2", List.of( + new FairnessStatisticsCalculator.ScoreFrequency(BigDecimal.valueOf(80), 70)))); + when(repository.findOverviewAggregateData("2026-08")).thenReturn(aggregate); + + FairnessResponse.Overview result = service(repository).overview(1L, "2026-08"); + + assertThat(result.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(result.getVersionCounts()).isNull(); + assertThat(result.getComputableSnapshotRatio()).isEqualByComparingTo("84.50"); + assertThat(result.getDistributionsByRulesVersion()).containsKeys("candidate-scoring-v0.1", "candidate-scoring-v0.2"); + assertThat(result.getDistributionsByRulesVersion().get("candidate-scoring-v0.1").getAvailability()) + .isEqualTo("SUPPRESSED"); + assertThat(result.getDistributionsByRulesVersion().get("candidate-scoring-v0.1").getSampleSize()).isNull(); + assertThat(result.getDistributionsByRulesVersion().get("candidate-scoring-v0.2").getAvailability()) + .isEqualTo("AVAILABLE"); + assertThat(result.getDistributionsByRulesVersion().get("candidate-scoring-v0.2").getSampleSize()) + .isEqualTo(70); + assertThat(result.getDistributionsByRulesVersion().get("candidate-scoring-v0.2").getMean()) + .isEqualByComparingTo("80.00"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringControllerTest.java new file mode 100644 index 0000000..0d5f60c --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringControllerTest.java @@ -0,0 +1,262 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.MvcResult; + +import java.util.Map; +import java.math.BigDecimal; + +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; +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; +import static org.assertj.core.api.Assertions.assertThat; + +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class FairnessMonitoringControllerTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private FairnessMonitoringService service; + @MockBean private RedisTemplate redisTemplate; + + /** + * 本类**独占**的夹具用户 ID。 + * + *

    刻意避开 {@code V1_1__seed_data.sql} 种子账号占用的 {@code users.id = 1/2/3} + * —— 那三行已被 {@code V43__disable_legacy_seed_accounts.sql} 置为 {@code is_active = 0}， + * 而 {@code TestAuthTokens} 只在用户行**不存在**时才插入，不会激活已存在的禁用行。 + * 曾因此在本类**单独运行**时全部 Token 请求被判 401（详见 + * {@code docs/r01-a6-independent-verification-20260917.md} §9）。 + * 改用独占号段后，本类的结果不再依赖 V1_1/V43 种子数据的存在性与状态， + * 也不再依赖其他测试类（如 {@code AuthIntegrationTest} 的 {@code deleteAll()}）的执行顺序。

    + */ + static final long ADMIN_USER_ID = 9_310_001L; + static final long STUDENT_USER_ID = 9_310_002L; + + /** 独占手机号：不使用种子号的 138… 号段，也不与 {@code TestAuthTokens} 的 {@code "t"+id} 冲突。 */ + private static final String ADMIN_PHONE = "a6fair-admin"; + private static final String STUDENT_PHONE = "a6fair-student"; + + @BeforeEach + void provisionFixtureUsers() { + // 先清理可能的上轮残留（异常中断），再插入本类自有的 active 用户。 + // 注意：这里是"删除后重建"，**不会**把任何已存在的 inactive 用户直接激活。 + removeFixtureUsers(); + insertActiveUser(ADMIN_USER_ID, ADMIN_PHONE, "ADMIN"); + insertActiveUser(STUDENT_USER_ID, STUDENT_PHONE, "STUDENT"); + } + + @AfterEach + void removeFixtureUsers() { + for (long id : new long[]{ADMIN_USER_ID, STUDENT_USER_ID}) { + // 外键顺序：会话 → 角色 → 用户；只删本类自建的确切 ID，不做任何整表删除。 + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + + private void insertActiveUser(long id, String phone, String role) { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "a6-fairness-fixture-" + role, role); + } + + @Test + @SuppressWarnings("unchecked") + void adminOverview_returnsAggregateWhitelistOnly() throws Exception { + ValueOperations operations = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(operations); + when(redisTemplate.hasKey(org.mockito.ArgumentMatchers.any())).thenReturn(false); + FairnessResponse.Distribution distribution = FairnessResponse.Distribution.builder() + .sampleSize(30).mean(new BigDecimal("50.00")).median(new BigDecimal("50.00")) + .p10(new BigDecimal("10.00")).p25(new BigDecimal("25.00")) + .p75(new BigDecimal("75.00")).p90(new BigDecimal("90.00")) + .min(new BigDecimal("0.00")).max(new BigDecimal("100.00")) + .standardDeviation(new BigDecimal("12.34")) + .buckets(Map.of("0-9", 1, "10-19", 2, "20-29", 3, "30-39", 4, + "40-49", 5, "50-59", 5, "60-69", 4, "70-79", 3, "80-89", 2, "90-100", 1)) + .concentrationRate(new BigDecimal("16.67")).riskLevel("NORMAL") + .availability("AVAILABLE").build(); + when(service.overview(eq(ADMIN_USER_ID), eq("2026-09"))).thenReturn(FairnessResponse.Overview.builder() + .basis("CURRENT_STORED_SNAPSHOTS") + .scope("SCORED_SNAPSHOT_POPULATION") + .period("2026-09") + .populationSize(30) + .computableSnapshotRatio(new BigDecimal("90.00")) + .confidence("LOW_CONFIDENCE") + .riskLevel("NORMAL") + .versionCounts(Map.of("candidate-scoring-v0.1", 15, "candidate-scoring-v0.2", 15)) + .mixedVersionCount(0).unknownVersionCount(0).distribution(distribution) + .distributionsByRulesVersion(Map.of("candidate-scoring-v0.2", distribution)) + .coherentVersionSubset(java.util.List.of("candidate-scoring-v0.2")) + .availability("AVAILABLE") + .build()); + + String json = mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", "2026-09") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN")) + .accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.basis").value("CURRENT_STORED_SNAPSHOTS")) + .andExpect(jsonPath("$.data.distribution.sampleSize").value(30)) + .andExpect(jsonPath("$['data']['distributionsByRulesVersion']['candidate-scoring-v0.2']['mean']").value(50.00)) + .andExpect(jsonPath("$.data.computableSnapshotRatio").value(90.00)) + .andReturn().getResponse().getContentAsString(); + assertNoSensitiveFields(json); + } + + @Test + void anonymous_isUnauthorized() throws Exception { + mockMvc.perform(get("/admin/scoring/fairness/drift")) + .andExpect(status().isUnauthorized()); + } + + @Test + void nonAdmin_isForbidden() throws Exception { + doThrow(new BusinessException(ErrorCode.FORBIDDEN)) + .when(service).overview(eq(STUDENT_USER_ID), eq("2026-09")); + + mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", "2026-09") + .header("Authorization", token(STUDENT_USER_ID, "STUDENT"))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(ErrorCode.FORBIDDEN.getCode())); + } + + @Test + void unsupportedQueryParameter_isBadRequest() throws Exception { + mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", "2026-09") + .param("jobId", "9") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN"))) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.code").value(ErrorCode.BAD_REQUEST.getCode())); + } + + @Test + void rankingStability_returnsExplicitUnavailable() throws Exception { + when(service.rankingStability(eq(ADMIN_USER_ID))).thenReturn(FairnessResponse.Unavailable.builder() + .availability("UNAVAILABLE") + .reason("RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE") + .build()); + when(service.drift(eq(ADMIN_USER_ID))).thenReturn(FairnessResponse.Unavailable.builder() + .availability("UNAVAILABLE") + .reason("IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE") + .build()); + + mockMvc.perform(get("/admin/scoring/fairness/ranking-stability") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN"))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")) + .andExpect(jsonPath("$.data.reason").value("RANKING_SNAPSHOT_HISTORY_NOT_AVAILABLE")); + mockMvc.perform(get("/admin/scoring/fairness/drift") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN"))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")) + .andExpect(jsonPath("$.data.reason").value("IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE")); + } + + @Test + void dimensionsAndAppealsExposeExplicitAvailabilityWithoutSensitiveFields() throws Exception { + FairnessResponse.Distribution distribution = FairnessResponse.Distribution.builder() + .sampleSize(30).mean(new BigDecimal("55.55")).median(new BigDecimal("50.00")) + .p10(new BigDecimal("10.00")).p25(new BigDecimal("25.00")) + .p75(new BigDecimal("75.00")).p90(new BigDecimal("90.00")) + .min(new BigDecimal("0.00")).max(new BigDecimal("100.00")) + .standardDeviation(new BigDecimal("15.00")).buckets(Map.of("0-9", 3)) + .concentrationRate(new BigDecimal("10.00")).riskLevel("NORMAL") + .availability("AVAILABLE").build(); + FairnessResponse.DimensionMetric metric = FairnessResponse.DimensionMetric.builder().dimension("ABILITY") + .populationSize(100).rowCount(100).missingRowCount(0).validSampleSize(90).confidence("NORMAL_CONFIDENCE") + .missingRowRate(new BigDecimal("0.00")).nullScoreRate(new BigDecimal("10.00")) + .validCoverage(new BigDecimal("90.00")).statusCounts(Map.of("OK", 90, "PENDING", 10)) + .versionCounts(Map.of("candidate-scoring-v0.2", 90)).inconsistentRecordCount(0) + .unknownStatusCount(0).outOfRangeScoreCount(0).unknownRulesVersionCount(0) + .distribution(distribution).distributionsByRulesVersion(Map.of("candidate-scoring-v0.2", distribution)) + .availability("AVAILABLE").build(); + when(service.dimensions(eq(ADMIN_USER_ID), eq("2026-09"), eq("ABILITY"))).thenReturn(FairnessResponse.Dimensions.builder() + .basis("CURRENT_STORED_SNAPSHOTS").scope("SCORED_SNAPSHOT_POPULATION").period("2026-09") + .availability("AVAILABLE").dimensions(java.util.List.of(metric)).build()); + when(service.appeals(eq(ADMIN_USER_ID), eq(java.time.LocalDate.of(2026, 8, 1)), eq(java.time.LocalDate.of(2026, 9, 1)))) + .thenReturn(FairnessResponse.Appeals.builder().basis("APPEAL_CREATION_QUEUE_CURRENT_STATE") + .from("2026-08-01").to("2026-09-01").appealCount(31).sampleSize(30) + .statusCounts(Map.of("APPROVED", 20, "REJECTED", 10)).statusEventCounts(Map.of("APPROVED", 21, "REJECTED", 10)) + .statusCandidateCounts(Map.of("APPROVED", 20, "REJECTED", 10)).confidence("LOW_CONFIDENCE") + .approvedEverCount(20).approvalRate(new BigDecimal("66.67")) + .rollbackExecutionRate(new BigDecimal("25.00")).duplicateAppealCount(2) + .duplicateAppealRate(new BigDecimal("6.67")).comparableRollbackCount(8) + .comparableRollbackCandidateCount(8).changedCount(3).changedCandidateCount(3) + .actualScoreChangeRate(new BigDecimal("37.50")).meanDelta(new BigDecimal("2.00")) + .meanAbsoluteDelta(new BigDecimal("2.50")).duplicateRollbackHistoryCount(1) + .invalidScoreRollbackCount(1).ruleVersionChangedRollbackCount(1) + .reasonCounts(Map.of("INVALID_SCORE", 1)).availability("AVAILABLE").build()); + String dimensionJson = mockMvc.perform(get("/admin/scoring/fairness/dimensions").param("period", "2026-09").param("dimension", "ABILITY") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN")).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.availability").value("AVAILABLE")) + .andExpect(jsonPath("$.data.dimensions[0].distribution.mean").value(55.55)) + .andExpect(jsonPath("$.data.dimensions[0].unknownStatusCount").value(0)) + .andReturn().getResponse().getContentAsString(); + assertNoSensitiveFields(dimensionJson); + String appealJson = mockMvc.perform(get("/admin/scoring/fairness/appeals").param("from", "2026-08-01").param("to", "2026-09-01") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN")).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.sampleSize").value(30)) + .andExpect(jsonPath("$.data.statusCandidateCounts.APPROVED").value(20)) + .andExpect(jsonPath("$.data.actualScoreChangeRate").value(37.50)) + .andReturn().getResponse().getContentAsString(); + assertNoSensitiveFields(appealJson); + } + + @Test + void overviewSuppressionOmitsNestedDerivedValuesInSerializedJson() throws Exception { + when(service.overview(eq(ADMIN_USER_ID), eq("2026-09"))).thenReturn(FairnessResponse.Overview.builder() + .basis("CURRENT_STORED_SNAPSHOTS").scope("SCORED_SNAPSHOT_POPULATION") + .period("2026-09").populationSize(100) + .availability("SUPPRESSED").reason("SMALL_CELL_OR_COMPLEMENT_RISK") + .build()); + + String json = mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", "2026-09") + .header("Authorization", token(ADMIN_USER_ID, "ADMIN")) + .accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.populationSize").value(100)) + .andExpect(jsonPath("$.data.availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.reason").value("SMALL_CELL_OR_COMPLEMENT_RISK")) + .andReturn().getResponse().getContentAsString(); + assertThat(json).doesNotContain("computableSnapshotRatio", "riskLevel", "versionCounts", + "mixedVersionCount", "unknownVersionCount", "distribution", + "distributionsByRulesVersion", "coherentVersionSubset", "mean", "buckets"); + } + + private void assertNoSensitiveFields(String json) { + assertThat(json).doesNotContain("studentUserId", "applicationId", "candidateId", "appealId", + "phone", "email", "resumeUrl", "school", "gender", "birthDate", "answerKey", + "scoringRule", "questionCode", "auditDetails", "ipAddress", "userAgent", "token", "password"); + } + + private String token(long userId, String role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringFixtureIsolationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringFixtureIsolationTest.java new file mode 100644 index 0000000..c3a1347 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringFixtureIsolationTest.java @@ -0,0 +1,301 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.support.TestAuthTokens; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.sql.Timestamp; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; +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; + +/** + * Fairness 认证夹具隔离反证测试。 + * + *

    背景：{@code FairnessMonitoringControllerTest} 曾用 {@code userId = 1/2} 申请 Token， + * 而 {@code V1_1__seed_data.sql} 的种子账号正好占用 {@code users.id = 1/2/3}， + * 且 {@code V43__disable_legacy_seed_accounts.sql} 已把它们置为 {@code is_active = 0}； + * {@code TestAuthTokens} 对"已存在但 inactive"的行不插入也不激活，于是该测试类 + * **单独运行时**全部 Token 请求被 401 拒绝。全量顺序下 + * {@code com.mydreamjob.controller.AuthIntegrationTest} 的 {@code userRepository.deleteAll()} + * 偶然清掉了种子行，问题才被掩盖。

    + * + *

    本类是该缺陷的**反证**：证明修复后的夹具既不依赖种子行的存在性/状态， + * 也不依赖测试执行顺序，并且在清理时只删除自己创建的数据。

    + * + *

    本类自身不使用种子 ID，全部操作按精确 ID 限定，不做任何整表删除。

    + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class FairnessMonitoringFixtureIsolationTest { + + /** 与 {@code FairnessMonitoringControllerTest} 相同的独占夹具 ID（同包可见）。 */ + private static final long ADMIN_USER_ID = FairnessMonitoringControllerTest.ADMIN_USER_ID; + + /** V1_1 种子账号占用的 ID；本类只读、只做快照与恢复，绝不把它们当作夹具。 */ + private static final List SEED_IDS = List.of(1L, 2L, 3L); + + /** 本类自有的探针 ID，不与其他测试共用。 */ + private static final long SENTINEL_USER_ID = 9_310_009L; + private static final long INACTIVE_USER_ID = 9_310_008L; + + private static final String DRIFT = "/admin/scoring/fairness/drift"; + + @Autowired private MockMvc mockMvc; + @Autowired private JdbcTemplate jdbcTemplate; + @MockBean private FairnessMonitoringService service; + @MockBean private RedisTemplate redisTemplate; + + /** 种子行快照；非 null 时 {@link #restoreSeedRows()} 负责原样恢复。 */ + private List> seedSnapshot; + + @BeforeEach + void provision() { + cleanupOwnRows(); + insertActiveUser(ADMIN_USER_ID, "a6fair-admin", "ADMIN"); + when(service.drift(ADMIN_USER_ID)).thenReturn(FairnessResponse.Unavailable.builder() + .availability("UNAVAILABLE") + .reason("IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE") + .build()); + } + + @AfterEach + void cleanup() { + restoreSeedRows(); + cleanupOwnRows(); + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", SENTINEL_USER_ID); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", SENTINEL_USER_ID); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", SENTINEL_USER_ID); + } + + private void cleanupOwnRows() { + for (long id : new long[]{ADMIN_USER_ID, INACTIVE_USER_ID}) { + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id = ?", id); + jdbcTemplate.update("DELETE FROM users WHERE id = ?", id); + } + } + + private void insertActiveUser(long id, String phone, String role) { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", id, phone, "a6-fairness-isolation-" + role, role); + } + + private int isActive(long id) { + Integer v = jdbcTemplate.queryForObject("SELECT is_active FROM users WHERE id = ?", Integer.class, id); + return v == null ? -1 : v; + } + + private String bearer() { + return TestAuthTokens.bearer(ADMIN_USER_ID, "ADMIN"); + } + + // ── 1. 夹具 ID 不与被禁用的种子账号冲突 ──────────────────── + + @Test + @DisplayName("反证：夹具 ID 位于种子账号号段之外，且夹具用户确为 active") + void fixtureIdsAreOutsideSeedAccountRange() { + assertThat(ADMIN_USER_ID).as("夹具 ID 不得落在 V1_1 种子账号的 1/2/3 上") + .isNotIn(SEED_IDS); + assertThat(FairnessMonitoringControllerTest.STUDENT_USER_ID).isNotIn(SEED_IDS); + + assertThat(isActive(ADMIN_USER_ID)).as("夹具用户必须由本类显式插入为 active").isEqualTo(1); + + // 夹具手机号不得占用种子账号的手机号（唯一约束 + 语义隔离） + Integer squat = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE phone IN ('13800000001','13800000002','13800000003') " + + "AND id IN (?, ?)", Integer.class, ADMIN_USER_ID, + FairnessMonitoringControllerTest.STUDENT_USER_ID); + assertThat(squat).as("夹具不得占用种子账号手机号").isZero(); + } + + // ── 2. 种子行为 inactive（V43 状态）或缺失时，夹具仍可认证 ── + + @Test + @DisplayName("反证：种子行 inactive（V43 状态）或完全缺失时，Fairness 端点仍返回 200") + void seedRowsInactiveOrAbsent_stillAuthenticates() throws Exception { + snapshotAndTakeSeedRows(); + + // 阶段 A：种子行存在但 inactive（即 V43 执行后的真实状态，也是单跑时的状态） + jdbcTemplate.update("UPDATE users SET is_active = 0 WHERE id IN (1, 2, 3)"); + mockMvc.perform(get(DRIFT).header("Authorization", bearer())) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")); + + // 阶段 B：种子行完全缺失（全量顺序下 AuthIntegrationTest.deleteAll() 之后的真实状态） + jdbcTemplate.update("DELETE FROM user_roles WHERE user_id IN (1, 2, 3)"); + jdbcTemplate.update("DELETE FROM auth_tokens WHERE user_id IN (1, 2, 3)"); + jdbcTemplate.update("DELETE FROM users WHERE id IN (1, 2, 3)"); + mockMvc.perform(get(DRIFT).header("Authorization", bearer())) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")); + } + + // ── 3. 连续多次夹具装配与请求不冲突 ──────────────────────── + + @Test + @DisplayName("反证：连续三次装配 + 三次请求均成功，无唯一约束或残留冲突") + void repeatedProvisioningAndRequests_doNotConflict() throws Exception { + for (int round = 1; round <= 3; round++) { + cleanupOwnRows(); + insertActiveUser(ADMIN_USER_ID, "a6fair-admin", "ADMIN"); + when(service.drift(ADMIN_USER_ID)).thenReturn(FairnessResponse.Unavailable.builder() + .availability("UNAVAILABLE") + .reason("IMMUTABLE_SCORE_HISTORY_NOT_AVAILABLE") + .build()); + + mockMvc.perform(get(DRIFT).header("Authorization", bearer())) + .andExpect(status().isOk()); + } + + Integer users = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, ADMIN_USER_ID); + assertThat(users).as("重复装配不得产生重复用户行").isEqualTo(1); + } + + // ── 4. 夹具不触碰种子数据（顺序无关的根本保证）──────────── + + @Test + @DisplayName("反证：一次完整装配→请求→清理周期后，种子行逐字段不变") + void fixtureCycleLeavesSeedRowsUntouched() throws Exception { + List> before = seedRows(); + + mockMvc.perform(get(DRIFT).header("Authorization", bearer())).andExpect(status().isOk()); + cleanupOwnRows(); + insertActiveUser(ADMIN_USER_ID, "a6fair-admin", "ADMIN"); + + assertThat(seedRows()).as("夹具周期不得改写任何种子行").isEqualTo(before); + } + + // ── 5. 清理只删除本类自有数据 ────────────────────────────── + + @Test + @DisplayName("反证：清理只删除本类夹具行，探针用户与会话保持不变") + void cleanupRemovesOnlyOwnFixtureRows() { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 1, 1)", SENTINEL_USER_ID, "a6fair-sentinel", + "a6-fairness-isolation-sentinel", "STUDENT"); + jdbcTemplate.update("INSERT INTO auth_tokens (user_id, token_hash, token_type, expired_at, revoked) " + + "VALUES (?, ?, 'REFRESH', ?, 0)", SENTINEL_USER_ID, "a6fair-sentinel-hash", + Timestamp.valueOf(java.time.LocalDateTime.now().plusDays(1))); + + cleanupOwnRows(); + + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, ADMIN_USER_ID)) + .as("本类夹具行应已被清理").isZero(); + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, SENTINEL_USER_ID)) + .as("探针用户不得被清理波及").isEqualTo(1); + assertThat(jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM auth_tokens WHERE user_id = ?", Integer.class, SENTINEL_USER_ID)) + .as("探针会话不得被清理波及").isEqualTo(1); + } + + // ── 6. 其他用户与会话不受影响 ────────────────────────────── + + @Test + @DisplayName("反证：装配→请求→清理周期前后，非夹具用户与会话逐字段不变") + void unrelatedUsersAndSessionsUnchanged() throws Exception { + List> usersBefore = nonFixtureUsers(); + List> tokensBefore = nonFixtureTokens(); + + mockMvc.perform(get(DRIFT).header("Authorization", bearer())).andExpect(status().isOk()); + cleanupOwnRows(); + + assertThat(nonFixtureUsers()).as("非夹具用户必须逐字段不变").isEqualTo(usersBefore); + assertThat(nonFixtureTokens()).as("非夹具会话必须逐字段不变").isEqualTo(tokensBefore); + } + + // ── 7. 公共夹具不会静默复活 inactive 用户 ───────────────── + + @Test + @DisplayName("反证：TestAuthTokens 不得把已存在的 inactive 用户静默激活") + void publicTokenFixtureDoesNotSilentlyReviveInactiveUser() throws Exception { + jdbcTemplate.update("INSERT INTO users (id, phone, nickname, role, is_active, is_verified) " + + "VALUES (?, ?, ?, ?, 0, 1)", INACTIVE_USER_ID, "a6fair-inactive", + "a6-fairness-isolation-inactive", "ADMIN"); + + String token = TestAuthTokens.bearer(INACTIVE_USER_ID, "ADMIN"); + + assertThat(isActive(INACTIVE_USER_ID)) + .as("公共夹具必须保留该用户被禁用的状态，不得静默复活") + .isEqualTo(0); + mockMvc.perform(get(DRIFT).header("Authorization", token)) + .andExpect(status().isUnauthorized()); + verify(service, never()).drift(any()); + } + + // ── 工具 ─────────────────────────────────────────────────── + + private List> seedRows() { + return jdbcTemplate.queryForList( + "SELECT id, phone, email, nickname, password_hash, role, is_active, is_verified " + + "FROM users WHERE id IN (1, 2, 3) ORDER BY id"); + } + + private List> nonFixtureUsers() { + return jdbcTemplate.queryForList( + "SELECT id, phone, nickname, role, is_active FROM users WHERE id NOT IN (?, ?) ORDER BY id", + ADMIN_USER_ID, INACTIVE_USER_ID); + } + + private List> nonFixtureTokens() { + return jdbcTemplate.queryForList( + "SELECT id, user_id, token_type, revoked FROM auth_tokens " + + "WHERE user_id NOT IN (?, ?) ORDER BY id", + ADMIN_USER_ID, INACTIVE_USER_ID); + } + + /** 快照种子行（含主键与状态），供缺失场景后原样恢复。 */ + private void snapshotAndTakeSeedRows() { + seedSnapshot = jdbcTemplate.queryForList( + "SELECT id, phone, email, nickname, password_hash, role, is_active, is_verified, " + + "created_at, updated_at FROM users WHERE id IN (1, 2, 3) ORDER BY id"); + } + + /** + * 按精确主键恢复种子行。 + * + *

    只在测试**主动删除**过种子行时才执行（{@code seedSnapshot} 非 null）， + * 且严格还原全部字段，不新增、不批量重建、不影响其他行。

    + */ + private void restoreSeedRows() { + if (seedSnapshot == null) { + return; + } + List> snapshot = new ArrayList<>(seedSnapshot); + seedSnapshot = null; + for (Map row : snapshot) { + Long id = ((Number) row.get("id")).longValue(); + if (jdbcTemplate.queryForObject("SELECT COUNT(*) FROM users WHERE id = ?", Integer.class, id) > 0) { + continue; + } + jdbcTemplate.update("INSERT INTO users (id, phone, email, nickname, password_hash, role, " + + "is_active, is_verified, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", + id, row.get("phone"), row.get("email"), row.get("nickname"), row.get("password_hash"), + row.get("role"), row.get("is_active"), row.get("is_verified"), + row.get("created_at"), row.get("updated_at")); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringHttpIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringHttpIntegrationTest.java new file mode 100644 index 0000000..1331da6 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringHttpIntegrationTest.java @@ -0,0 +1,306 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.JwtTokenProvider; +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.http.MediaType; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.math.BigDecimal; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.time.LocalDate; +import java.time.YearMonth; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import static org.assertj.core.api.Assertions.assertThat; +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; + +/** + * 通过真实 Controller -> Service -> Repository 链路验证 V43 的聚合、抑制、权限与只读性。 + * 仅使用 H2 MODE=MySQL；不使用 MockBean 替代被验证的服务、仓库或权限逻辑。 + */ +@SpringBootTest +@AutoConfigureMockMvc +@ActiveProfiles("integration-test") +class FairnessMonitoringHttpIntegrationTest { + private static final List DIMENSIONS = List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + private static final List READ_ONLY_TABLES = List.of( + "candidate_dimension_scores", "candidate_scoring_appeals", "candidate_scoring_snapshot_history", + "candidate_scoring_appeal_history", "candidate_scoring_rollback_limits", "audit_logs", + "scoring_risk_events", "scoring_risk_actions", + "scoring_risk_scan_checkpoints", "scoring_rule_configs"); + + @Autowired MockMvc mockMvc; + @Autowired JdbcTemplate jdbcTemplate; + @Autowired JwtTokenProvider jwtTokenProvider; + @Autowired FairnessMonitoringRepository repository; + @MockBean RedisTemplate redisTemplate; + + @Test + void realHttpPathSuppresses99Of100ComplementAcrossOverviewAndDimensions() throws Exception { + String prefix = ("v43h" + UUID.randomUUID().toString().replace("-", "")).substring(0, 10); + String period = YearMonth.now().toString(); + List userIds = new ArrayList<>(); + try { + jdbcTemplate.update("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'ADMIN', 1, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", prefix + "a"); + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + java.util.stream.IntStream.range(0, 100).mapToObj(i -> new Object[]{prefix + "s" + i}).toList()); + userIds.addAll(jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "s%")); + List scores = new ArrayList<>(100 * DIMENSIONS.size()); + for (int i = 0; i < userIds.size(); i++) { + for (String dimension : DIMENSIONS) { + boolean valid = i < 99; + scores.add(new Object[]{userIds.get(i), dimension, period, + valid ? new BigDecimal("50.00") : null, valid ? "OK" : "PENDING", + "candidate-scoring-v0.2"}); + } + } + jdbcTemplate.batchUpdate("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, ?, ?, ?, ?, 12.50, ?, CURRENT_TIMESTAMP)", scores); + + long adminId = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, prefix + "a"); + jdbcTemplate.update("INSERT INTO user_roles(user_id, role) VALUES (?, 'ADMIN')", adminId); + Map> before = snapshotTables(); + String adminToken = token(adminId, "ADMIN"); + String overview = mockMvc.perform(get("/admin/scoring/fairness/overview") + .param("period", period).header("Authorization", adminToken).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.populationSize").value(100)) + .andExpect(jsonPath("$.data.availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.reason").value("SMALL_CELL_OR_COMPLEMENT_RISK")) + .andReturn().getResponse().getContentAsString(); + assertThat(overview).doesNotContain("computableSnapshotRatio", "versionCounts", "distribution", + "distributionsByRulesVersion", "coherentVersionSubset", "riskLevel", "sampleSize", "mean", + "median", "standardDeviation", "buckets"); + assertThat(snapshotTables()).isEqualTo(before); + before = snapshotTables(); + + String dimensions = mockMvc.perform(get("/admin/scoring/fairness/dimensions") + .param("period", period).header("Authorization", adminToken).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.dimensions.length()").value(8)) + .andExpect(jsonPath("$.data.availability").value("SUPPRESSED")) + .andReturn().getResponse().getContentAsString(); + assertThat(dimensions).doesNotContain("validSampleSize", "missingRowCount", "validCoverage", + "nullScoreRate", "statusCounts", "versionCounts", "distribution", "outOfRangeScoreCount", + "unknownRulesVersionCount", "mean", "median", "standardDeviation", "buckets"); + assertThat(snapshotTables()).isEqualTo(before); + } finally { + if (!userIds.isEmpty()) { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE ?)", prefix + "%"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + } + + @Test + void realHttpFiveEndpointsUseRealAdminPermissionAndUnavailablePathsDoNotWrite() throws Exception { + String prefix = ("v43p" + UUID.randomUUID().toString().replace("-", "")).substring(0, 10); + List ids = new ArrayList<>(); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, ?, 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + List.of(new Object[]{prefix + "a", "ADMIN"}, new Object[]{prefix + "s", "STUDENT"}, + new Object[]{prefix + "c", "COMPANY"})); + ids.addAll(jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%")); + jdbcTemplate.update("INSERT INTO user_roles(user_id, role) VALUES (?, 'ADMIN')", ids.get(0)); + String adminToken = token(ids.get(0), "ADMIN"); + LocalDate to = LocalDate.now().minusDays(1); + LocalDate from = to.minusDays(1); + Map> before = snapshotTables(); + + mockMvc.perform(get("/admin/scoring/fairness/overview").param("period", "1900-01") + .header("Authorization", adminToken)).andExpect(status().isOk()) + .andExpect(jsonPath("$.data.availability").value("NO_DATA")); + mockMvc.perform(get("/admin/scoring/fairness/dimensions").param("period", "1900-01") + .header("Authorization", adminToken)).andExpect(status().isOk()); + mockMvc.perform(get("/admin/scoring/fairness/drift").header("Authorization", adminToken)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")); + mockMvc.perform(get("/admin/scoring/fairness/ranking-stability").header("Authorization", adminToken)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.availability").value("UNAVAILABLE")); + mockMvc.perform(get("/admin/scoring/fairness/appeals").param("from", from.toString()).param("to", to.toString()) + .header("Authorization", adminToken)).andExpect(status().isOk()); + + String[] paths = {"/admin/scoring/fairness/overview?period=1900-01", + "/admin/scoring/fairness/dimensions?period=1900-01", "/admin/scoring/fairness/drift", + "/admin/scoring/fairness/ranking-stability", "/admin/scoring/fairness/appeals?from=1900-01-01&to=1900-01-02"}; + for (String path : paths) { + mockMvc.perform(get(path).header("Authorization", token(ids.get(1), "STUDENT"))) + .andExpect(status().isForbidden()).andExpect(jsonPath("$.code").value(2002)); + mockMvc.perform(get(path).header("Authorization", token(ids.get(2), "COMPANY"))) + .andExpect(status().isForbidden()).andExpect(jsonPath("$.code").value(2002)); + mockMvc.perform(get(path)).andExpect(status().isUnauthorized()); + } + assertThat(snapshotTables()).isEqualTo(before); + } finally { + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void realHttpSuppressesVersionLocalComplementAcrossOverviewAndDimensions() throws Exception { + String prefix = ("v43v" + UUID.randomUUID().toString().replace("-", "")).substring(0, 10); + String period = YearMonth.now().toString(); + try { + jdbcTemplate.update("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'ADMIN', 1, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", prefix + "a"); + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + java.util.stream.IntStream.range(0, 200).mapToObj(i -> new Object[]{prefix + "s" + i}).toList()); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "s%"); + List rows = new ArrayList<>(200); + for (int i = 0; i < ids.size(); i++) { + boolean valid = i < 99 || (i >= 100 && i < 170); + String version = i < 100 ? "candidate-scoring-v0.1" : "candidate-scoring-v0.2"; + rows.add(new Object[]{ids.get(i), "ABILITY", period, + valid ? new BigDecimal("50.00") : null, valid ? "OK" : "PENDING", version}); + } + jdbcTemplate.batchUpdate("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, ?, ?, ?, ?, 12.50, ?, CURRENT_TIMESTAMP)", rows); + long adminId = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, prefix + "a"); + jdbcTemplate.update("INSERT INTO user_roles(user_id, role) VALUES (?, 'ADMIN')", adminId); + String token = token(adminId, "ADMIN"); + String overview = mockMvc.perform(get("/admin/scoring/fairness/overview").param("period", period) + .header("Authorization", token).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.populationSize").value(200)) + .andExpect(jsonPath("$.data.availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.distributionsByRulesVersion['candidate-scoring-v0.1'].availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.distributionsByRulesVersion['candidate-scoring-v0.1'].sampleSize").doesNotExist()) + .andExpect(jsonPath("$.data.distributionsByRulesVersion['candidate-scoring-v0.2'].availability").value("AVAILABLE")) + .andExpect(jsonPath("$.data.distributionsByRulesVersion['candidate-scoring-v0.2'].sampleSize").value(70)) + .andReturn().getResponse().getContentAsString(); + assertThat(overview).doesNotContain("\"versionCounts\"", "\"candidate-scoring-v0.1\":100"); + String dimensions = mockMvc.perform(get("/admin/scoring/fairness/dimensions").param("period", period) + .param("dimension", "ABILITY").header("Authorization", token).accept(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()).andExpect(jsonPath("$.data.dimensions[0].availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.dimensions[0].distributionsByRulesVersion['candidate-scoring-v0.1'].availability").value("SUPPRESSED")) + .andExpect(jsonPath("$.data.dimensions[0].distributionsByRulesVersion['candidate-scoring-v0.1'].sampleSize").doesNotExist()) + .andExpect(jsonPath("$.data.dimensions[0].distributionsByRulesVersion['candidate-scoring-v0.2'].availability").value("AVAILABLE")) + .andExpect(jsonPath("$.data.dimensions[0].distributionsByRulesVersion['candidate-scoring-v0.2'].sampleSize").value(70)) + .andReturn().getResponse().getContentAsString(); + assertThat(dimensions).doesNotContain("\"rowCount\"", "\"validSampleSize\"", "\"versionCounts\"", "\"distribution\""); + } finally { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE student_user_id IN " + + "(SELECT id FROM users WHERE phone LIKE ?)", prefix + "%"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void realHttpAppealsHidesSmallComparableChangeGroup() throws Exception { + String prefix = ("v43e" + UUID.randomUUID().toString().replace("-", "")).substring(0, 10); + String reason = "v43 http appeal " + UUID.randomUUID(); + LocalDate day = LocalDate.now().minusDays(1); + List ids = new ArrayList<>(); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + java.util.stream.IntStream.range(0, 60).mapToObj(i -> new Object[]{prefix + i}).toList()); + ids.addAll(jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%")); + String appealSql = "INSERT INTO candidate_scoring_appeals " + + "(candidate_user_id, dimension, period, status, reason, rules_version, created_at, updated_at) " + + "VALUES (?, 'ABILITY', '2026-09', 'ROLLED_BACK', ?, 'candidate-scoring-v0.2', ?, CURRENT_TIMESTAMP)"; + java.sql.Timestamp created = java.sql.Timestamp.valueOf(day.atTime(10, 0)); + for (Long id : ids) jdbcTemplate.update(appealSql, id, reason, created); + List appealIds = jdbcTemplate.query("SELECT id FROM candidate_scoring_appeals WHERE reason = ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), reason); + String historySql = "INSERT INTO candidate_scoring_snapshot_history " + + "(appeal_id, candidate_user_id, dimension, period, action, before_score, after_score, " + + "before_version, after_version, before_rules_version, after_rules_version, created_at) " + + "VALUES (?, ?, 'ABILITY', '2026-09', 'ROLLBACK', ?, ?, 1, 2, 'candidate-scoring-v0.2', 'candidate-scoring-v0.2', ?)"; + for (int i = 0; i < appealIds.size(); i++) { + jdbcTemplate.update(historySql, appealIds.get(i), ids.get(i), null, + new BigDecimal("30"), java.sql.Timestamp.valueOf(day.atTime(11, 0))); + } + // Every person has an invalid rollback. One person ALSO has a legal + // rollback in another dimension; invalid-score complement is zero. + jdbcTemplate.update(appealSql.replace("'ABILITY'", "'GROWTH'"), ids.get(0), reason, created); + long legalAppeal = jdbcTemplate.queryForObject( + "SELECT id FROM candidate_scoring_appeals WHERE reason=? AND dimension='GROWTH'", Long.class, reason); + jdbcTemplate.update(historySql.replace("'ABILITY'", "'GROWTH'"), legalAppeal, ids.get(0), + new BigDecimal("20"), new BigDecimal("30"), java.sql.Timestamp.valueOf(day.atTime(11, 0))); + var aggregate = repository.findAppealAggregateSummary(day.atStartOfDay(), day.plusDays(1).atStartOfDay()); + assertThat(aggregate.sampleSize()).isEqualTo(60); + assertThat(aggregate.appealCount()).isEqualTo(61); + assertThat(aggregate.invalidScoreRollbackCount()).isEqualTo(60); + assertThat(aggregate.comparableRollbackCount()).isEqualTo(1); + assertThat(aggregate.comparableRollbackCandidateCount()).isEqualTo(1); + assertThat(aggregate.changedCount()).isEqualTo(1); + assertThat(aggregate.duplicateAppealCandidateCount()).isZero(); + long adminId; + jdbcTemplate.update("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'ADMIN', 1, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", prefix + "admin"); + adminId = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, prefix + "admin"); + jdbcTemplate.update("INSERT INTO user_roles(user_id, role) VALUES (?, 'ADMIN')", adminId); + jdbcTemplate.update("INSERT INTO candidate_scoring_rollback_limits(student_user_id, rollback_year, rollback_count) " + + "VALUES (?, ?, 2)", ids.get(0), day.getYear()); + Map> before = snapshotTables(); + String response = mockMvc.perform(get("/admin/scoring/fairness/appeals").param("from", day.toString()) + .param("to", day.plusDays(1).toString()).header("Authorization", token(adminId, "ADMIN")) + .accept(MediaType.APPLICATION_JSON)).andExpect(status().isOk()) + .andExpect(jsonPath("$.data.sampleSize").value(60)) + .andExpect(jsonPath("$.data.availability").value("INSUFFICIENT_SAMPLE")) + .andReturn().getResponse().getContentAsString(); + assertThat(response).doesNotContain("comparableRollbackCount", "changedCount", "changedCandidateCount", + "actualScoreChangeRate", "meanDelta", "meanAbsoluteDelta"); + assertThat(snapshotTables()).isEqualTo(before); + for (String path : List.of("overview?period=" + YearMonth.now(), + "dimensions?period=" + YearMonth.now(), "drift", "ranking-stability")) { + var interfaceBefore = snapshotTables(); + mockMvc.perform(get("/admin/scoring/fairness/" + path) + .header("Authorization", token(adminId, "ADMIN"))).andExpect(status().isOk()); + assertThat(snapshotTables()).as("full contents and versions after %s", path).isEqualTo(interfaceBefore); + } + } finally { + jdbcTemplate.update("DELETE FROM candidate_scoring_snapshot_history WHERE appeal_id IN " + + "(SELECT id FROM candidate_scoring_appeals WHERE reason = ?)", reason); + jdbcTemplate.update("DELETE FROM candidate_scoring_appeals WHERE reason = ?", reason); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + private Map> snapshotTables() { + return READ_ONLY_TABLES.stream().collect(java.util.stream.Collectors.toMap(t -> t, this::tableRows, + (a, b) -> a, java.util.LinkedHashMap::new)); + } + + private List tableRows(String table) { + return jdbcTemplate.query("SELECT * FROM " + table + " ORDER BY 1", (ResultSet rs) -> { + List rows = new ArrayList<>(); + ResultSetMetaData md = rs.getMetaData(); + while (rs.next()) { + String[] values = new String[md.getColumnCount()]; + for (int i = 1; i <= md.getColumnCount(); i++) values[i - 1] = String.valueOf(rs.getObject(i)); + rows.add(Arrays.toString(values)); + } + return rows; + }); + } + + private String token(long userId, String role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringPersistenceIntegrationTest.java new file mode 100644 index 0000000..85fce85 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringPersistenceIntegrationTest.java @@ -0,0 +1,480 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.candidatescore.CandidateDimensionScore; +import com.mydreamjob.candidatescore.CandidateScoringCalculator; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Import; +import org.springframework.context.annotation.Primary; +import org.springframework.jdbc.datasource.AbstractDataSource; + +import java.math.BigDecimal; +import java.lang.reflect.Proxy; +import java.sql.Connection; +import java.sql.Statement; +import java.util.concurrent.atomic.AtomicInteger; +import javax.sql.DataSource; +import java.util.ArrayList; +import java.util.List; +import java.util.UUID; + +import static org.assertj.core.api.Assertions.assertThat; + +/** 在 H2 MODE=MySQL 中执行 V43 的真实只读 SQL；不使用 mock 代替被验证的查询。 */ +@SpringBootTest +@ActiveProfiles("integration-test") +@Import(FairnessMonitoringPersistenceIntegrationTest.CountingDataSourceConfiguration.class) +class FairnessMonitoringPersistenceIntegrationTest { + @Autowired FairnessMonitoringRepository repository; + @Autowired FairnessMonitoringService service; + @Autowired JdbcTemplate jdbcTemplate; + @Autowired CountingDataSource countingDataSource; + @jakarta.persistence.PersistenceContext jakarta.persistence.EntityManager entityManager; + @MockBean RedisTemplate redisTemplate; + + @Test + @org.springframework.transaction.annotation.Transactional + void realServiceJdbcBudgetAt30_300_3000WithEightDimensionsAndMultipleAppeals() { + String prefix = UUID.randomUUID().toString().substring(0, 8); + jdbcTemplate.update("INSERT INTO users(phone,role,is_active,is_verified) VALUES (?,'ADMIN',1,1)", prefix + "a"); + long admin = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone=?", Long.class, prefix + "a"); + jdbcTemplate.update("INSERT INTO user_roles(user_id,role) VALUES (?,'ADMIN')", admin); + for (int size : new int[]{30, 300, 3000}) { + String period = "2000-" + (size == 30 ? "01" : size == 300 ? "02" : "03"); + var day = java.time.LocalDate.parse(period + "-01"); + for (int i = 0; i < size; i++) { + String phone = prefix + size + "x" + i; + jdbcTemplate.update("INSERT INTO users(phone,role,is_active,is_verified) VALUES (?,'STUDENT',1,0)", phone); + long id = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone=?", Long.class, phone); + for (String dim : List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY")) { + jdbcTemplate.update("INSERT INTO candidate_dimension_scores(student_user_id,dimension,period,score,status,weight,rules_version,calculated_at) VALUES (?,?,?,50,'OK',12.5,'candidate-scoring-v0.2',CURRENT_TIMESTAMP)", id, dim, period); + } + for (String dim : List.of("ABILITY", "GROWTH")) { + jdbcTemplate.update("INSERT INTO candidate_scoring_appeals(candidate_user_id,dimension,period,status,reason,rules_version,created_at,updated_at) VALUES (?,?,?,'ROLLED_BACK',?,'candidate-scoring-v0.2',?,CURRENT_TIMESTAMP)", id, dim, period, prefix, java.sql.Timestamp.valueOf(day.atTime(10,0))); + long appeal = jdbcTemplate.queryForObject("SELECT id FROM candidate_scoring_appeals WHERE candidate_user_id=? AND dimension=? AND period=?", Long.class, id, dim, period); + jdbcTemplate.update("INSERT INTO candidate_scoring_snapshot_history(appeal_id,candidate_user_id,dimension,period,action,before_score,after_score,before_version,after_version,before_rules_version,after_rules_version,created_at) VALUES (?,?,?,?,'ROLLBACK',20,30,1,2,'candidate-scoring-v0.2','candidate-scoring-v0.2',?)", appeal,id,dim,period,java.sql.Timestamp.valueOf(day.atTime(11,0))); + } + } + entityManager.clear(); + countingDataSource.reset(); + assertThat(service.overview(admin, period).getPopulationSize()).isEqualTo(size); + assertThat(countingDataSource.businessStatements()).as("overview business SQL at %s",size).isEqualTo(2); + assertThat(countingDataSource.identityStatements()).as("overview permission SQL at %s",size).isEqualTo(2); + entityManager.clear(); + countingDataSource.reset(); + service.dimensions(admin, period, null); + assertThat(countingDataSource.businessStatements()).as("dimensions business SQL at %s",size).isEqualTo(2); + assertThat(countingDataSource.identityStatements()).as("dimensions permission SQL at %s",size).isEqualTo(2); + entityManager.clear(); + countingDataSource.reset(); + assertThat(service.appeals(admin, day, day.plusDays(1)).getComparableRollbackCount()).isEqualTo(size * 2); + assertThat(countingDataSource.businessStatements()).as("appeals business SQL at %s",size).isEqualTo(1); + assertThat(countingDataSource.identityStatements()).as("appeals permission SQL at %s",size).isEqualTo(2); + entityManager.clear(); + countingDataSource.reset(); + service.drift(admin); + assertThat(countingDataSource.businessStatements()).as("drift business SQL at %s", size).isZero(); + assertThat(countingDataSource.identityStatements()).as("drift permission SQL at %s", size).isEqualTo(2); + entityManager.clear(); + countingDataSource.reset(); + service.rankingStability(admin); + assertThat(countingDataSource.businessStatements()).as("ranking business SQL at %s", size).isZero(); + assertThat(countingDataSource.identityStatements()).as("ranking permission SQL at %s", size).isEqualTo(2); + var aggregate = repository.findOverviewAggregateData(period); + assertThat(aggregate.frequenciesByVersion().get("candidate-scoring-v0.2")).hasSize(1); + var appeals = repository.findAppealAggregateSummary(day.atStartOfDay(),day.plusDays(1).atStartOfDay()); + assertThat(appeals.comparableRollbackCandidateCount()).isEqualTo(size); + assertThat(appeals.comparableRollbackCount()).isEqualTo(size * 2); + } + } + + @Test + @org.springframework.transaction.annotation.Transactional + void sqlOverallMatchesPureFunctionForPartialRepeatingHalfUpAndPendingVersions() { + String prefix = UUID.randomUUID().toString().substring(0,8); + List> cases = List.of(List.of("10.00"), List.of("10.00","10.01"), + List.of("10.00","10.00","10.01"), List.of("10.00","10.01","10.01")); + var calculator = new CandidateScoringCalculator(null, null, null, null, null, null, null); + for (int c=0;c snapshots=new ArrayList<>(); + List dims=List.of("ABILITY","GROWTH","EDUCATION"); + for(int i=0;i periods = List.of("2091-01", "2091-02", "2091-03"); + int[] sizes = {30, 300, 3000}; + try { + for (int i = 0; i < sizes.length; i++) { + String period = periods.get(i); + String periodPrefix = prefix + i; + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + java.util.stream.IntStream.range(0, sizes[i]).mapToObj(n -> new Object[]{periodPrefix + n}).toList()); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), periodPrefix + "%"); + List scoreArgs = new ArrayList<>(sizes[i] * 8); + for (Long id : ids) { + for (String dimension : List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY")) { + scoreArgs.add(new Object[]{id, dimension, period, new BigDecimal("50.00"), "OK", + "candidate-scoring-v0.2"}); + } + } + jdbcTemplate.batchUpdate("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, ?, ?, ?, ?, 12.50, ?, CURRENT_TIMESTAMP)", scoreArgs); + int expected = sizes[i]; + assertThat(repository.findSnapshotPopulation(period)).isEqualTo(expected); + assertThat(repository.findSnapshotAggregates(period)).hasSize(8) + .allSatisfy(row -> assertThat(row.candidateCount()).isEqualTo(expected)); + FairnessMonitoringRepository.OverviewAggregateData overview = repository.findOverviewAggregateData(period); + assertThat(overview.populationSize()).isEqualTo(expected); + assertThat(overview.computableCount()).isEqualTo(expected); + assertThat(overview.versionCounts()).containsEntry("candidate-scoring-v0.2", expected) + .containsEntry("MIXED", 0).containsEntry("UNKNOWN", 0); + assertThat(overview.frequenciesByVersion().get("candidate-scoring-v0.2")) + .containsExactly(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50.00"), expected)); + } + } finally { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE period IN (?, ?, ?)", periods.toArray()); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void overviewAggregateSqlSeparatesMixedAndUnknownVersions() { + String prefix = ("v43o" + UUID.randomUUID().toString().replace("-", "")).substring(0, 12); + String period = "2091-04"; + List dimensions = List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + java.util.stream.IntStream.range(0, 30).mapToObj(n -> new Object[]{prefix + n}).toList()); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%"); + List scoreArgs = new ArrayList<>(30 * 8); + for (int i = 0; i < ids.size(); i++) { + for (String dimension : dimensions) { + String rowVersion = i == 1 ? "unknown-rule-fixture" + : i == 0 && "ABILITY".equals(dimension) ? "candidate-scoring-v0.2" + : "candidate-scoring-v0.1"; + scoreArgs.add(new Object[]{ids.get(i), dimension, period, new BigDecimal("50.00"), "OK", rowVersion}); + } + } + // Candidate 0 has two known versions (MIXED); candidate 1 has only + // an unknown version; the other 28 are coherent v0.1. + jdbcTemplate.batchUpdate("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, ?, ?, ?, ?, 12.50, ?, CURRENT_TIMESTAMP)", scoreArgs); + + FairnessMonitoringRepository.OverviewAggregateData aggregate = repository.findOverviewAggregateData(period); + + assertThat(aggregate.populationSize()).isEqualTo(30); + assertThat(aggregate.computableCount()).isEqualTo(30); + assertThat(aggregate.versionCounts()).containsEntry("candidate-scoring-v0.1", 28) + .containsEntry("candidate-scoring-v0.2", 0) + .containsEntry("MIXED", 1).containsEntry("UNKNOWN", 1); + assertThat(aggregate.frequenciesByVersion().get("candidate-scoring-v0.1")) + .containsExactly(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50.00"), 28)); + assertThat(aggregate.frequenciesByVersion().get("candidate-scoring-v0.2")).isEmpty(); + } finally { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE period = ?", period); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void overviewOverallFrequencyReconcilesWithExistingScoringPureFunction() { + String prefix = ("v43s" + UUID.randomUUID().toString().replace("-", "")).substring(0, 12); + String period = "2091-05"; + List dimensions = List.of("EDUCATION", "INTERNSHIP", "ABILITY", "COMPLIANCE", + "STABILITY", "GROWTH", "INTEGRITY", "ACTIVITY"); + List scores = List.of(new BigDecimal("10.01"), new BigDecimal("20.02"), + new BigDecimal("30.03"), new BigDecimal("40.04"), new BigDecimal("50.05"), + new BigDecimal("60.06"), new BigDecimal("70.07"), new BigDecimal("80.08")); + try { + jdbcTemplate.update("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", prefix); + Long studentId = jdbcTemplate.queryForObject("SELECT id FROM users WHERE phone = ?", Long.class, prefix); + List args = new ArrayList<>(); + for (int i = 0; i < dimensions.size(); i++) { + args.add(new Object[]{studentId, dimensions.get(i), period, scores.get(i), "OK", "candidate-scoring-v0.2"}); + } + jdbcTemplate.batchUpdate("INSERT INTO candidate_dimension_scores " + + "(student_user_id, dimension, period, score, status, weight, rules_version, calculated_at) " + + "VALUES (?, ?, ?, ?, ?, 12.50, ?, CURRENT_TIMESTAMP)", args); + + List snapshots = new ArrayList<>(); + for (int i = 0; i < dimensions.size(); i++) { + snapshots.add(CandidateDimensionScore.builder().studentUserId(studentId).dimension(dimensions.get(i)) + .period(period).score(scores.get(i)).status("OK").rulesVersion("candidate-scoring-v0.2") + .calculatedAt(java.time.LocalDateTime.now()).build()); + } + CandidateScoringCalculator calculator = new CandidateScoringCalculator(null, null, null, null, null, null, null); + BigDecimal expected = calculator.overallScoreFromSnapshots(snapshots); + FairnessMonitoringRepository.OverviewAggregateData aggregate = repository.findOverviewAggregateData(period); + assertThat(expected).isEqualByComparingTo("45.05"); + assertThat(aggregate.frequenciesByVersion().get("candidate-scoring-v0.2")) + .containsExactly(new FairnessStatisticsCalculator.ScoreFrequency(expected, 1)); + } finally { + jdbcTemplate.update("DELETE FROM candidate_dimension_scores WHERE period = ?", period); + jdbcTemplate.update("DELETE FROM users WHERE phone = ?", prefix); + } + } + + @Test + void appealAggregateSqlCountsEventsAndDistinctCandidatesByNormalizedStatus() { + String prefix = ("v43a" + UUID.randomUUID().toString().replace("-", "")).substring(0, 12); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + List.of(new Object[]{prefix + "01"}, new Object[]{prefix + "02"})); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%"); + String sql = "INSERT INTO candidate_scoring_appeals " + + "(candidate_user_id, dimension, period, status, reason, rules_version, created_at, updated_at) " + + "VALUES (?, 'ABILITY', '2026-09', ?, 'fixture', 'candidate-scoring-v0.2', ?, CURRENT_TIMESTAMP)"; + jdbcTemplate.update(sql, ids.get(0), "PENDING", java.sql.Timestamp.valueOf("2026-09-01 10:00:00")); + jdbcTemplate.update(sql, ids.get(0), "PENDING", java.sql.Timestamp.valueOf("2026-09-01 11:00:00")); + jdbcTemplate.update(sql, ids.get(1), "REJECTED", java.sql.Timestamp.valueOf("2026-09-01 12:00:00")); + + FairnessMonitoringRepository.AppealAggregateSummary summary = repository.findAppealAggregateSummary( + java.time.LocalDateTime.of(2026, 9, 1, 0, 0), java.time.LocalDateTime.of(2026, 9, 2, 0, 0)); + + assertThat(summary.appealCount()).isEqualTo(3); + assertThat(summary.sampleSize()).isEqualTo(2); + assertThat(summary.statusEventCounts()).containsEntry("PENDING", 2).containsEntry("REJECTED", 1); + assertThat(summary.statusCandidateCounts()).containsEntry("PENDING", 1).containsEntry("REJECTED", 1); + } finally { + jdbcTemplate.update("DELETE FROM candidate_scoring_appeals WHERE reason = 'fixture'"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void rollbackSqlPreservesRowsAndCountsPerAppealWithoutSelectingMaxHistory() { + String prefix = ("v43r" + UUID.randomUUID().toString().replace("-", "")).substring(0, 12); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + List.of(new Object[]{prefix + "01"}, new Object[]{prefix + "02"})); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%"); + String appealSql = "INSERT INTO candidate_scoring_appeals " + + "(candidate_user_id, dimension, period, status, reason, rules_version, created_at, updated_at) " + + "VALUES (?, 'ABILITY', '2026-09', 'ROLLED_BACK', 'v43 rollback fixture', 'candidate-scoring-v0.2', ?, CURRENT_TIMESTAMP)"; + jdbcTemplate.update(appealSql, ids.get(0), java.sql.Timestamp.valueOf("2026-09-03 10:00:00")); + jdbcTemplate.update(appealSql, ids.get(1), java.sql.Timestamp.valueOf("2026-09-03 11:00:00")); + List appealIds = jdbcTemplate.query( + "SELECT id FROM candidate_scoring_appeals WHERE reason = 'v43 rollback fixture' ORDER BY id", + (rs, rowNum) -> rs.getLong(1)); + String historySql = "INSERT INTO candidate_scoring_snapshot_history " + + "(appeal_id, candidate_user_id, dimension, period, action, before_score, after_score, " + + " before_version, after_version, before_rules_version, after_rules_version, created_at) " + + "VALUES (?, ?, 'ABILITY', '2026-09', 'ROLLBACK', ?, ?, 1, 2, 'candidate-scoring-v0.2', 'candidate-scoring-v0.2', ?)"; + jdbcTemplate.update(historySql, appealIds.get(0), ids.get(0), new BigDecimal("20.00"), new BigDecimal("30.00"), + java.sql.Timestamp.valueOf("2026-09-03 12:00:00")); + jdbcTemplate.update(historySql, appealIds.get(1), ids.get(1), new BigDecimal("40.00"), new BigDecimal("50.00"), + java.sql.Timestamp.valueOf("2026-09-03 13:00:00")); + jdbcTemplate.update(historySql, appealIds.get(1), ids.get(1), new BigDecimal("40.00"), new BigDecimal("60.00"), + java.sql.Timestamp.valueOf("2026-09-03 14:00:00")); + + FairnessMonitoringRepository.AppealAggregateSummary summary = repository.findAppealAggregateSummary( + java.time.LocalDateTime.of(2026, 9, 1, 0, 0), java.time.LocalDateTime.of(2026, 9, 4, 0, 0)); + assertThat(summary.appealCount()).isEqualTo(2); + assertThat(summary.sampleSize()).isEqualTo(2); + assertThat(summary.comparableRollbackCount()).isEqualTo(1); + assertThat(summary.comparableRollbackCandidateCount()).isEqualTo(1); + assertThat(summary.changedCount()).isEqualTo(1); + assertThat(summary.changedCandidateCount()).isEqualTo(1); + assertThat(summary.deltaSum()).isEqualByComparingTo("10.00"); + assertThat(summary.duplicateRollbackHistoryCount()).isEqualTo(1); + } finally { + jdbcTemplate.update("DELETE FROM candidate_scoring_snapshot_history WHERE appeal_id IN " + + "(SELECT id FROM candidate_scoring_appeals WHERE reason = 'v43 rollback fixture')"); + jdbcTemplate.update("DELETE FROM candidate_scoring_appeals WHERE reason = 'v43 rollback fixture'"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @Test + void appealCandidateAggregateSqlKeepsLegalAppealsWhenSiblingAppealHasDuplicateHistory() { + String prefix = ("v43c" + UUID.randomUUID().toString().replace("-", "")).substring(0, 12); + try { + jdbcTemplate.batchUpdate("INSERT INTO users(phone, role, is_active, is_verified, created_at, updated_at) " + + "VALUES (?, 'STUDENT', 1, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)", + List.of(new Object[]{prefix + "01"}, new Object[]{prefix + "02"})); + List ids = jdbcTemplate.query("SELECT id FROM users WHERE phone LIKE ? ORDER BY id", + (rs, rowNum) -> rs.getLong(1), prefix + "%"); + String appealSql = "INSERT INTO candidate_scoring_appeals " + + "(candidate_user_id, dimension, period, status, reason, rules_version, created_at, updated_at) " + + "VALUES (?, ?, '2026-09', 'ROLLED_BACK', 'v43 candidate aggregate fixture', 'candidate-scoring-v0.2', ?, CURRENT_TIMESTAMP)"; + // Candidate 1 has two independent legal appeals (both must count). + jdbcTemplate.update(appealSql, ids.get(0), "ABILITY", java.sql.Timestamp.valueOf("2026-09-05 10:00:00")); + jdbcTemplate.update(appealSql, ids.get(0), "GROWTH", java.sql.Timestamp.valueOf("2026-09-05 11:00:00")); + // Candidate 2 has one duplicate-history appeal and one legal appeal. + jdbcTemplate.update(appealSql, ids.get(1), "ABILITY", java.sql.Timestamp.valueOf("2026-09-05 12:00:00")); + jdbcTemplate.update(appealSql, ids.get(1), "GROWTH", java.sql.Timestamp.valueOf("2026-09-05 13:00:00")); + List appealIds = jdbcTemplate.query( + "SELECT id FROM candidate_scoring_appeals WHERE reason = 'v43 candidate aggregate fixture' ORDER BY id", + (rs, rowNum) -> rs.getLong(1)); + String historySql = "INSERT INTO candidate_scoring_snapshot_history " + + "(appeal_id, candidate_user_id, dimension, period, action, before_score, after_score, " + + " before_version, after_version, before_rules_version, after_rules_version, created_at) " + + "VALUES (?, ?, ?, '2026-09', 'ROLLBACK', ?, ?, 1, 2, 'candidate-scoring-v0.2', 'candidate-scoring-v0.2', ?)"; + jdbcTemplate.update(historySql, appealIds.get(0), ids.get(0), "ABILITY", new BigDecimal("20.00"), new BigDecimal("30.00"), java.sql.Timestamp.valueOf("2026-09-05 14:00:00")); + jdbcTemplate.update(historySql, appealIds.get(1), ids.get(0), "GROWTH", new BigDecimal("40.00"), new BigDecimal("40.00"), java.sql.Timestamp.valueOf("2026-09-05 15:00:00")); + jdbcTemplate.update(historySql, appealIds.get(2), ids.get(1), "ABILITY", new BigDecimal("10.00"), new BigDecimal("20.00"), java.sql.Timestamp.valueOf("2026-09-05 16:00:00")); + jdbcTemplate.update(historySql, appealIds.get(2), ids.get(1), "ABILITY", new BigDecimal("10.00"), new BigDecimal("25.00"), java.sql.Timestamp.valueOf("2026-09-05 17:00:00")); + jdbcTemplate.update(historySql, appealIds.get(3), ids.get(1), "GROWTH", new BigDecimal("60.00"), new BigDecimal("50.00"), java.sql.Timestamp.valueOf("2026-09-05 18:00:00")); + + FairnessMonitoringRepository.AppealAggregateSummary summary = repository.findAppealAggregateSummary( + java.time.LocalDateTime.of(2026, 9, 1, 0, 0), java.time.LocalDateTime.of(2026, 9, 6, 0, 0)); + + assertThat(summary.appealCount()).isEqualTo(4); + assertThat(summary.sampleSize()).isEqualTo(2); + assertThat(summary.comparableRollbackCount()).isEqualTo(3); + assertThat(summary.comparableRollbackCandidateCount()).isEqualTo(2); + assertThat(summary.changedCount()).isEqualTo(2); + assertThat(summary.changedCandidateCount()).isEqualTo(2); + assertThat(summary.unchangedCandidateCount()).isEqualTo(1); + assertThat(summary.changedUnchangedIntersectionCount()).isEqualTo(1); + assertThat(summary.duplicateRollbackHistoryCount()).isEqualTo(1); + assertThat(FairnessMonitoringRepository.AppealAggregateSummary.class.getRecordComponents()) + .extracting(java.lang.reflect.RecordComponent::getName) + .doesNotContain("candidateUserId", "appealId", "beforeScore", "afterScore", "details"); + } finally { + jdbcTemplate.update("DELETE FROM candidate_scoring_snapshot_history WHERE appeal_id IN " + + "(SELECT id FROM candidate_scoring_appeals WHERE reason = 'v43 candidate aggregate fixture')"); + jdbcTemplate.update("DELETE FROM candidate_scoring_appeals WHERE reason = 'v43 candidate aggregate fixture'"); + jdbcTemplate.update("DELETE FROM users WHERE phone LIKE ?", prefix + "%"); + } + } + + @TestConfiguration + static class CountingDataSourceConfiguration { + @Bean + @Primary + CountingDataSource dataSource(DataSourceProperties properties) { + return new CountingDataSource(properties.initializeDataSourceBuilder().build()); + } + } + + /** Test-only datasource used by the actual Spring Repository/Service proxies. */ + static final class CountingDataSource extends AbstractDataSource { + private final DataSource delegate; + private final AtomicInteger businessStatements = new AtomicInteger(); + private final AtomicInteger identityStatements = new AtomicInteger(); + + private CountingDataSource(DataSource delegate) { this.delegate = delegate; } + private void reset() { businessStatements.set(0); identityStatements.set(0); } + private int businessStatements() { return businessStatements.get(); } + private int identityStatements() { return identityStatements.get(); } + + @Override + public Connection getConnection() throws java.sql.SQLException { return wrap(delegate.getConnection()); } + + @Override + public Connection getConnection(String username, String password) throws java.sql.SQLException { + return wrap(delegate.getConnection(username, password)); + } + + private Connection wrap(Connection connection) { + return (Connection) Proxy.newProxyInstance(Connection.class.getClassLoader(), + new Class[]{Connection.class}, (proxy, method, args) -> { + Object value = method.invoke(connection, args); + if (value instanceof Statement statement) { + String sql = args != null && args.length > 0 && args[0] instanceof String s ? s : ""; + return wrapStatement(statement, method.getReturnType(), sql); + } + return value; + }); + } + + private Object wrapStatement(Statement statement, Class returnType, String preparedSql) { + Class iface = returnType.isInterface() ? returnType : Statement.class; + return Proxy.newProxyInstance(iface.getClassLoader(), new Class[]{iface}, (proxy, method, args) -> { + Object result = method.invoke(statement, args); + if (method.getName().startsWith("execute")) { + String sql = preparedSql; + if (sql.isBlank() && args != null && args.length > 0 && args[0] instanceof String s) sql = s; + String normalized = sql.toLowerCase(java.util.Locale.ROOT); + if (normalized.contains("candidate_dimension_scores") + || normalized.contains("candidate_scoring_appeals") + || normalized.contains("candidate_scoring_snapshot_history")) { + businessStatements.incrementAndGet(); + } else if (normalized.contains(" from users") || normalized.contains(" from user_roles")) { + identityStatements.incrementAndGet(); + } + } + return result; + }); + } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringServiceTest.java new file mode 100644 index 0000000..2c1e396 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessMonitoringServiceTest.java @@ -0,0 +1,626 @@ +package com.mydreamjob.scoringmonitoring; + +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.math.BigDecimal; +import java.time.LocalDate; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.HashSet; +import java.util.LinkedHashMap; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; +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.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class FairnessMonitoringServiceTest { + private record SnapshotRow(Long studentUserId, String dimension, BigDecimal score, String status, String rulesVersion) {} + private record AppealRow(Long id, Long candidateUserId, String dimension, String period, String status, String rulesVersion) {} + private record RollbackRow(Long appealId, String action, BigDecimal beforeScore, BigDecimal afterScore, + String beforeRulesVersion, String afterRulesVersion, int historyCount) { + RollbackRow(Long appealId, String action, BigDecimal beforeScore, BigDecimal afterScore, + String beforeRulesVersion, String afterRulesVersion) { + this(appealId, action, beforeScore, afterScore, beforeRulesVersion, afterRulesVersion, 1); + } + } + + @Mock FairnessMonitoringRepository repository; + @Mock UserRepository userRepository; + private FairnessMonitoringService service; + private final Map> snapshotFixtures = new HashMap<>(); + private List appealRowsFixture = List.of(); + private List rollbackRowsFixture = List.of(); + + @BeforeEach + void setUp() { + service = new FairnessMonitoringService(repository, userRepository); + User admin = User.builder().id(1L).role(User.Role.ADMIN).roles(java.util.Set.of(User.Role.ADMIN)).active(true).build(); + lenient().when(userRepository.findById(1L)).thenReturn(Optional.of(admin)); + // Unit fixtures are adapted to the formal aggregate contract at the + // test boundary. Production code has no detail-query fallback. + lenient().doAnswer(inv -> overviewFixture(snapshotFixtures.get(inv.getArgument(0)))) + .when(repository).findOverviewAggregateData(anyString()); + lenient().doAnswer(inv -> appealFixture(appealRowsFixture, rollbackRowsFixture)) + .when(repository).findAppealAggregateSummary(any(), any()); + } + + private FairnessMonitoringRepository.OverviewAggregateData overviewFixture(List rows) { + if (rows == null || rows.isEmpty()) return FairnessMonitoringRepository.OverviewAggregateData.empty(); + Map> versions = new LinkedHashMap<>(); + Map> valid = new LinkedHashMap<>(); + for (var row : rows) { + versions.computeIfAbsent(row.studentUserId(), ignored -> new LinkedHashSet<>()).add( + row.rulesVersion() == null ? "UNKNOWN" : (Set.of("candidate-scoring-v0.1", "candidate-scoring-v0.2").contains(row.rulesVersion()) ? row.rulesVersion() : "UNKNOWN")); + if (("OK".equals(row.status()) || "ESTIMATED".equals(row.status())) && row.score() != null + && row.score().compareTo(BigDecimal.ZERO) >= 0 && row.score().compareTo(BigDecimal.valueOf(100)) <= 0) { + valid.computeIfAbsent(row.studentUserId(), ignored -> new ArrayList<>()).add(row.score()); + } + } + Map counts = new LinkedHashMap<>(); + counts.put("candidate-scoring-v0.1", 0); counts.put("candidate-scoring-v0.2", 0); counts.put("UNKNOWN", 0); counts.put("MIXED", 0); + Map> freq = new LinkedHashMap<>(); + freq.put("candidate-scoring-v0.1", new LinkedHashMap<>()); freq.put("candidate-scoring-v0.2", new LinkedHashMap<>()); + int computable = 0; + for (var entry : versions.entrySet()) { + Set distinct = entry.getValue(); + if (valid.containsKey(entry.getKey())) computable++; + if (distinct.size() != 1) { counts.merge("MIXED", 1, Integer::sum); continue; } + String version = distinct.iterator().next(); counts.merge(version, 1, Integer::sum); + if (valid.containsKey(entry.getKey()) && Set.of("candidate-scoring-v0.1", "candidate-scoring-v0.2").contains(version)) { + List values = valid.get(entry.getKey()); + BigDecimal average = values.stream().reduce(BigDecimal.ZERO, BigDecimal::add).divide(BigDecimal.valueOf(values.size()), 2, java.math.RoundingMode.HALF_UP); + freq.get(version).merge(average, 1, Integer::sum); + } + } + Map> byVersion = new LinkedHashMap<>(); + for (var entry : freq.entrySet()) byVersion.put(entry.getKey(), entry.getValue().entrySet().stream() + .map(e -> new FairnessStatisticsCalculator.ScoreFrequency(e.getKey(), e.getValue())).toList()); + return new FairnessMonitoringRepository.OverviewAggregateData(versions.size(), computable, counts, byVersion); + } + + private FairnessMonitoringRepository.AppealAggregateSummary appealFixture( + List rows, + List rollbacks) { + if (rows == null) return FairnessMonitoringRepository.AppealAggregateSummary.empty(); + Map> statusPeople = new LinkedHashMap<>(); + Map statusEvents = new LinkedHashMap<>(); + Set people = new LinkedHashSet<>(); Set approved = new LinkedHashSet<>(); + Set rejected = new LinkedHashSet<>(); Set rolledBack = new LinkedHashSet<>(); + Map byId = new HashMap<>(); + Map groups = new HashMap<>(); + for (var row : rows) { people.add(row.candidateUserId()); byId.put(row.id(), row); String status = Set.of("PENDING","APPROVED","REJECTED","CANCELLED","ROLLED_BACK").contains(row.status()) ? row.status() : "UNKNOWN"; statusEvents.merge(status, 1, Integer::sum); statusPeople.computeIfAbsent(status, ignored -> new LinkedHashSet<>()).add(row.candidateUserId()); if ("APPROVED".equals(row.status()) || "ROLLED_BACK".equals(row.status())) approved.add(row.candidateUserId()); if ("REJECTED".equals(row.status())) rejected.add(row.candidateUserId()); if ("ROLLED_BACK".equals(row.status())) rolledBack.add(row.candidateUserId()); groups.merge(row.candidateUserId()+"|"+row.dimension()+"|"+row.period(),1,Integer::sum); } + Map> rb = new LinkedHashMap<>(); for (var r : rollbacks) rb.computeIfAbsent(r.appealId(), ignored -> new ArrayList<>()).add(r); + Set duplicateAppeal = new LinkedHashSet<>(); for (var r : rows) if (groups.get(r.candidateUserId()+"|"+r.dimension()+"|"+r.period()) > 1) duplicateAppeal.add(r.candidateUserId()); + Set dup = new LinkedHashSet<>(), invalid = new LinkedHashSet<>(), changedVersion = new LinkedHashSet<>(), comparablePeople = new LinkedHashSet<>(), changedPeople = new LinkedHashSet<>(), unchangedPeople = new LinkedHashSet<>(); + int comparable = 0, changed = 0; BigDecimal delta = BigDecimal.ZERO, abs = BigDecimal.ZERO; + for (var entry : rb.entrySet()) { var appeal = byId.get(entry.getKey()); if (appeal == null) continue; if (entry.getValue().size() != 1) { dup.add(appeal.candidateUserId()); continue; } var r = entry.getValue().get(0); boolean validScore = r.beforeScore()!=null && r.afterScore()!=null && r.beforeScore().compareTo(BigDecimal.ZERO)>=0 && r.beforeScore().compareTo(BigDecimal.valueOf(100))<=0 && r.afterScore().compareTo(BigDecimal.ZERO)>=0 && r.afterScore().compareTo(BigDecimal.valueOf(100))<=0; if (!validScore) { invalid.add(appeal.candidateUserId()); continue; } if (!Set.of("candidate-scoring-v0.1","candidate-scoring-v0.2").contains(r.beforeRulesVersion()) || !java.util.Objects.equals(r.beforeRulesVersion(), r.afterRulesVersion())) { changedVersion.add(appeal.candidateUserId()); continue; } comparable++; comparablePeople.add(appeal.candidateUserId()); BigDecimal d = r.afterScore().subtract(r.beforeScore()); delta = delta.add(d); abs = abs.add(d.abs()); if (d.signum()==0) unchangedPeople.add(appeal.candidateUserId()); else { changed++; changedPeople.add(appeal.candidateUserId()); } } + Map statusCandidates = new LinkedHashMap<>(); statusPeople.forEach((k,v)->statusCandidates.put(k,v.size())); + Set approvalDenominator = new LinkedHashSet<>(approved); approvalDenominator.addAll(rejected); + return new FairnessMonitoringRepository.AppealAggregateSummary(rows.size(), people.size(), statusEvents, statusCandidates, + approved.size(), approvalDenominator.size(), rolledBack.size(), duplicateAppeal.size(), comparable, comparablePeople.size(), + changed, changedPeople.size(), unchangedPeople.size(), intersection(changedPeople, unchangedPeople).size(), delta, abs, dup.size(), invalid.size(), changedVersion.size()); + } + + private Set intersection(Set a, Set b) { Set result = new HashSet<>(a); result.retainAll(b); return result; } + + @Test + void overview_countsIndependentPeopleAndSeparatesRuleVersions() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 30; i++) { + rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("20"), "OK", "candidate-scoring-v0.1")); + rows.add(new SnapshotRow(i + 100, "ABILITY", new BigDecimal("80"), "OK", "candidate-scoring-v0.2")); + } + snapshotFixtures.put("2026-09", rows); + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + assertThat(response.getPopulationSize()).isEqualTo(60); + assertThat(response.getComputableSnapshotRatio()).isEqualByComparingTo("100.00"); + assertThat(response.getDistributionsByRulesVersion().get("candidate-scoring-v0.1").getMean()).isEqualByComparingTo("20.00"); + assertThat(response.getDistributionsByRulesVersion().get("candidate-scoring-v0.2").getMean()).isEqualByComparingTo("80.00"); + assertThat(response.getDistribution()).isNull(); + } + + @Test + void overviewComputableRatioIncludesMixedAndUnknownWhenAnyDimensionIsValid() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 30; i++) rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("50"), "OK", "candidate-scoring-v0.2")); + rows.add(new SnapshotRow(31L, "ABILITY", new BigDecimal("50"), "OK", "candidate-scoring-v0.1")); + rows.add(new SnapshotRow(31L, "EDUCATION", new BigDecimal("50"), "PENDING", "candidate-scoring-v0.2")); + snapshotFixtures.put("2026-09", rows); + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + assertThat(response.getComputableSnapshotRatio()).isEqualByComparingTo("100.00"); + assertThat(response.getDistributionsByRulesVersion()).isNull(); + assertThat(response.getDistribution()).isNull(); + } + + @Test + void overviewTreatsPendingVersionMismatchAsMixedAndNeverReturnsUnknownRawValue() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 30; i++) { + rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("60"), "OK", "candidate-scoring-v0.1")); + } + rows.add(new SnapshotRow(31L, "ABILITY", new BigDecimal("70"), "OK", "future-rule-secret")); + rows.add(new SnapshotRow(31L, "EDUCATION", null, "PENDING", "candidate-scoring-v0.2")); + snapshotFixtures.put("2026-09", rows); + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + assertThat(response.getVersionCounts()).isNull(); + assertThat(response.getReason()).isEqualTo("SMALL_CELL_OR_COMPLEMENT_RISK"); + assertThat(String.valueOf(response)).doesNotContain("future-rule-secret"); + } + + @Test + void overviewDoesNotDefaultRiskToNormalWhenStatisticsAreUnavailable() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 29; i++) { + rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("50"), "OK", "candidate-scoring-v0.2")); + } + snapshotFixtures.put("2026-09", rows); + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + assertThat(response.getRiskLevel()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(response.getAvailability()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(response.getReason()).isEqualTo("INDEPENDENT_CANDIDATE_THRESHOLD_NOT_MET"); + } + + @Test + void overviewPropagatesSuppressedDistributionWithoutUnboxingNullSampleSize() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 99; i++) { + rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("50"), "OK", "candidate-scoring-v0.2")); + } + rows.add(new SnapshotRow(100L, "ABILITY", new BigDecimal("99"), "OK", "candidate-scoring-v0.2")); + snapshotFixtures.put("2026-09", rows); + + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + + assertThat(response.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(response.getReason()).isEqualTo("SMALL_BUCKET_OR_COMPLEMENT_RISK"); + assertThat(response.getDistribution()).isNotNull(); + assertThat(response.getDistribution().getSampleSize()).isNull(); + } + + @Test + void overviewSuppressesVersionDistributionWhenValidComplementIsSmall() { + // 100 人中 99 人有效(v0.1)、1 人不可计算(PENDING)。ratio 99/100 补集=1 已被抑制， + // 但 distributionsByRulesVersion.v0.1(sampleSize=99)会反向暴露"恰好 1 人无效"。 + List rows = new ArrayList<>(); + for (long i = 1; i <= 99; i++) { + rows.add(new SnapshotRow(i, "ABILITY", new BigDecimal("50"), "OK", "candidate-scoring-v0.1")); + } + rows.add(new SnapshotRow(100L, "ABILITY", null, "PENDING", "candidate-scoring-v0.1")); + snapshotFixtures.put("2026-09", rows); + + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + + assertThat(response.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(response.getComputableSnapshotRatio()).isNull(); + // 被抑制的补集必须连同样的版本分布一并隐藏，否则 sampleSize=99 + populationSize=100 反向推出 1 人无效 + assertThat(response.getDistributionsByRulesVersion()).isNullOrEmpty(); + assertThat(response.getDistribution()).isNull(); + } + + @Test + void overviewSqlAggregatePathSuppressesVersionDistributionWhenValidComplementIsSmall() { + Map versions = new LinkedHashMap<>(); + versions.put("candidate-scoring-v0.1", 100); + versions.put("candidate-scoring-v0.2", 0); + versions.put("UNKNOWN", 0); + versions.put("MIXED", 0); + Map> frequencies = new LinkedHashMap<>(); + frequencies.put("candidate-scoring-v0.1", List.of( + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50.00"), 99))); + frequencies.put("candidate-scoring-v0.2", List.of()); + doReturn(new FairnessMonitoringRepository.OverviewAggregateData(100, 99, versions, frequencies)) + .when(repository).findOverviewAggregateData("2026-09"); + + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + + assertThat(response.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(response.getComputableSnapshotRatio()).isNull(); + assertThat(response.getDistribution()).isNull(); + assertThat(response.getDistributionsByRulesVersion()).isNullOrEmpty(); + assertThat(response.getRiskLevel()).isNull(); + } + + @Test + void overviewSqlAggregatePathKeepsAllValidPopulationAvailable() { + Map versions = new LinkedHashMap<>(); + versions.put("candidate-scoring-v0.1", 0); + versions.put("candidate-scoring-v0.2", 30); + versions.put("UNKNOWN", 0); + versions.put("MIXED", 0); + Map> frequencies = new LinkedHashMap<>(); + frequencies.put("candidate-scoring-v0.1", List.of()); + frequencies.put("candidate-scoring-v0.2", List.of( + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("20.00"), 30))); + doReturn(new FairnessMonitoringRepository.OverviewAggregateData(30, 30, versions, frequencies)) + .when(repository).findOverviewAggregateData("2026-09"); + + FairnessResponse.Overview response = service.overview(1L, "2026-09"); + + assertThat(response.getAvailability()).isEqualTo("AVAILABLE"); + assertThat(response.getComputableSnapshotRatio()).isEqualByComparingTo("100.00"); + assertThat(response.getDistribution().getSampleSize()).isEqualTo(30); + assertThat(response.getDistribution().getMean()).isEqualByComparingTo("20.00"); + } + + @Test + void invalidFuturePeriod_isRejectedWithoutQuery() { + assertThatThrownBy(() -> service.overview(1L, "2099-01")).isInstanceOf(BusinessException.class); + verifyNoInteractions(repository); + } + + @Test + void appealsRowAndCandidateDenominatorsStayConsistentWhenCandidateHasDupAndLegitHistory() { + // 60 人。p1..p30：各 1 条可比回滚；p31..p60：各有一条重复历史申诉(2 条历史) + 一条合法单历史申诉。 + // 设计按申诉粒度排除：只排除重复历史那条申诉；p31..p60 的合法申诉仍应计入， + // 因此可比行数与可比独立候选数必须一致（各 60 行 / 60 人）。 + List appeals = new ArrayList<>(); + List rollbacks = new ArrayList<>(); + long appealId = 1; + for (long i = 1; i <= 30; i++) { + long candidate = 60_000L + i; + appeals.add(new AppealRow(appealId, candidate, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbacks.add(new RollbackRow(appealId, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealId++; + } + for (long i = 1; i <= 30; i++) { + long candidate = 61_000L + i; + // 重复历史申诉：2 条历史 + appeals.add(new AppealRow(appealId, candidate, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbacks.add(new RollbackRow(appealId, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + rollbacks.add(new RollbackRow(appealId, "ROLLBACK", new BigDecimal("50"), new BigDecimal("80"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealId++; + // 合法单历史申诉：1 条历史（应计入可比） + appeals.add(new AppealRow(appealId, candidate, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbacks.add(new RollbackRow(appealId, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealId++; + } + + appealRowsFixture = appeals; + rollbackRowsFixture = rollbacks; + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + // 60 条可比回滚对应 60 名独立可比候选；不得出现“候选被排除、其合法回滚行仍计入”的分母错位 + assertThat(response.getComparableRollbackCount()).isEqualTo(60); + assertThat(response.getComparableRollbackCandidateCount()).isEqualTo(60); + } + + @Test + void servicePermissionRejectsStudentAndCompanyUsingRealRoleCheck() { + User student = User.builder().id(2L).role(User.Role.STUDENT).roles(java.util.Set.of(User.Role.STUDENT)).active(true).build(); + User company = User.builder().id(3L).role(User.Role.COMPANY).roles(java.util.Set.of(User.Role.COMPANY)).active(true).build(); + when(userRepository.findById(2L)).thenReturn(Optional.of(student)); + when(userRepository.findById(3L)).thenReturn(Optional.of(company)); + assertThatThrownBy(() -> service.overview(2L, "2026-09")).isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()).isEqualTo(ErrorCode.FORBIDDEN.getCode()); + assertThatThrownBy(() -> service.appeals(3L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1))) + .isInstanceOf(BusinessException.class) + .extracting(e -> ((BusinessException) e).getErrorCode()).isEqualTo(ErrorCode.FORBIDDEN.getCode()); + } + + @Test + void driftAndRankingAreExplicitlyUnavailableWithoutHistory() { + assertThat(service.drift(1L).getAvailability()).isEqualTo("UNAVAILABLE"); + assertThat(service.rankingStability(1L).getAvailability()).isEqualTo("UNAVAILABLE"); + verifyNoInteractions(repository); + } + + @Test + void dimensionsUsesFrequencyAggregatesAndSuppressesComplement() { + when(repository.findSnapshotPopulation("2026-09")).thenReturn(100); + when(repository.findSnapshotAggregates("2026-09")).thenReturn(List.of( + new FairnessMonitoringRepository.SnapshotAggregateRow("ABILITY", "OK", "candidate-scoring-v0.2", new BigDecimal("80"), 99), + new FairnessMonitoringRepository.SnapshotAggregateRow("EDUCATION", "OK", "candidate-scoring-v0.2", new BigDecimal("80"), 1))); + FairnessResponse.DimensionMetric metric = service.dimensions(1L, "2026-09", "ABILITY").getDimensions().get(0); + assertThat(metric.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(metric.getReason()).isEqualTo("SMALL_CELL_OR_COMPLEMENT_RISK"); + assertThat(metric.getRowCount()).isNull(); + assertThat(metric.getDistribution()).isNull(); + verify(repository, times(1)).findSnapshotAggregates("2026-09"); + verify(repository, times(1)).findSnapshotPopulation("2026-09"); + } + + @Test + void dimensionsNoDataIsExplicit() { + when(repository.findSnapshotPopulation("2026-09")).thenReturn(0); + when(repository.findSnapshotAggregates("2026-09")).thenReturn(List.of()); + FairnessResponse.DimensionMetric metric = service.dimensions(1L, "2026-09", "ABILITY").getDimensions().get(0); + assertThat(metric.getAvailability()).isEqualTo("NO_DATA"); + assertThat(metric.getReason()).isEqualTo("NO_SNAPSHOT_POPULATION"); + assertThat(metric.getRowCount()).isNull(); + verify(repository, times(1)).findSnapshotAggregates("2026-09"); + verify(repository, times(1)).findSnapshotPopulation("2026-09"); + } + + @Test + void dimensionsUsesFixedQueryBudgetForLargePopulation() { + when(repository.findSnapshotPopulation("2026-09")).thenReturn(3000); + List aggregates = new ArrayList<>(); + for (String dimension : List.of("ABILITY", "ACTIVITY", "COMPLIANCE", "EDUCATION", "GROWTH", "INTEGRITY", "INTERNSHIP", "STABILITY")) { + aggregates.add(new FairnessMonitoringRepository.SnapshotAggregateRow(dimension, "OK", "candidate-scoring-v0.2", new BigDecimal("50"), 3000)); + } + when(repository.findSnapshotAggregates("2026-09")).thenReturn(aggregates); + FairnessResponse.Dimensions response = service.dimensions(1L, "2026-09", null); + assertThat(response.getDimensions()).hasSize(8); + verify(repository, times(1)).findSnapshotAggregates("2026-09"); + verify(repository, times(1)).findSnapshotPopulation("2026-09"); + verifyNoMoreInteractions(repository); + } + + @Test + void appealsDuplicateRollbackHistoryExcludesCandidateFromComparableDenominator() { + List appeals = new ArrayList<>(); + List rollbacks = new ArrayList<>(); + for (long i = 1; i <= 30; i++) { + appeals.add(new AppealRow(i, 10_000L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbacks.add(new RollbackRow(i, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + rollbacks.add(new RollbackRow(1L, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealRowsFixture = appeals; + rollbackRowsFixture = rollbacks; + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + assertThat(response.getComparableRollbackCandidateCount()).isNull(); + verify(repository, times(1)).findAppealAggregateSummary(any(), any()); + assertThat(response.getActualScoreChangeRate()).isNull(); + assertThat(response.getAvailability()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(response.getReason()).isEqualTo("COMPARABLE_CANDIDATE_THRESHOLD_NOT_MET"); + assertThat(response.getComparableRollbackCandidateCount()).isNull(); + } + + @Test + void appealsRollbackHistoryOrderDoesNotChangeClassification() { + List appealRows = new ArrayList<>(); + List rollbackRows = new ArrayList<>(); + for (long i = 1; i <= 30; i++) { + appealRows.add(new AppealRow(i, 20_000L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(i, "ROLLBACK", new BigDecimal("50"), new BigDecimal(i == 1 ? "50" : "60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + // 同一 appeal 的第二条历史无论排在前后都必须被视为重复并整组排除。 + rollbackRows.add(new RollbackRow(1L, "ROLLBACK", new BigDecimal("40"), new BigDecimal("80"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealRowsFixture = appealRows; + rollbackRowsFixture = rollbackRows; + FairnessResponse.Appeals first = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + reset(repository); + lenient().doAnswer(inv -> appealFixture(appealRowsFixture, rollbackRowsFixture)).when(repository).findAppealAggregateSummary(any(), any()); + List reversed = new ArrayList<>(rollbackRows); + java.util.Collections.reverse(reversed); + appealRowsFixture = appealRows; + rollbackRowsFixture = reversed; + FairnessResponse.Appeals second = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + assertThat(first.getAvailability()).isEqualTo(second.getAvailability()); + assertThat(first.getReason()).isEqualTo(second.getReason()); + assertThat(first.getComparableRollbackCandidateCount()).isEqualTo(second.getComparableRollbackCandidateCount()); + assertThat(first.getActualScoreChangeRate()).isEqualTo(second.getActualScoreChangeRate()); + } + + @Test + void appealsSuppressesStatusAndApprovalComplementWhenOneCandidateIsInComplement() { + List rows = new ArrayList<>(); + for (long i = 1; i <= 99; i++) { + rows.add(new AppealRow(i, 30_000L + i, "ABILITY", "2026-09", "APPROVED", "candidate-scoring-v0.2")); + } + rows.add(new AppealRow(100L, 30_100L, "ABILITY", "2026-09", "REJECTED", "candidate-scoring-v0.2")); + appealRowsFixture = rows; + rollbackRowsFixture = List.of(); + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getAvailability()).isEqualTo("SUPPRESSED"); + assertThat(response.getStatusCandidateCounts()).isNull(); + assertThat(response.getStatusEventCounts()).isNull(); + assertThat(response.getApprovedEverCount()).isNull(); + assertThat(response.getApprovalRate()).isNull(); + } + + @Test + void appealsUsesSetComplementForOverlappingDuplicatePeople() { + List rows = new ArrayList<>(); + long appealId = 1; + for (long i = 1; i <= 99; i++) { + long candidate = 31_000L + i; + rows.add(new AppealRow(appealId++, candidate, "ABILITY", "2026-09", "PENDING", "candidate-scoring-v0.2")); + rows.add(new AppealRow(appealId++, candidate, "ABILITY", "2026-09", "PENDING", "candidate-scoring-v0.2")); + } + rows.add(new AppealRow(appealId, 31_100L, "ABILITY", "2026-09", "PENDING", "candidate-scoring-v0.2")); + appealRowsFixture = rows; + rollbackRowsFixture = List.of(); + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getSampleSize()).isEqualTo(100); + assertThat(response.getDuplicateAppealCount()).isNull(); + assertThat(response.getDuplicateAppealRate()).isNull(); + assertThat(response.getAvailability()).isEqualTo("SUPPRESSED"); + } + + @Test + void dimensionsExposeIndependentUnknownStatusAndOutOfRangeCounts() { + when(repository.findSnapshotPopulation("2026-09")).thenReturn(100); + when(repository.findSnapshotAggregates("2026-09")).thenReturn(List.of( + new FairnessMonitoringRepository.SnapshotAggregateRow("ABILITY", "BROKEN_STATUS", "future-rule", new BigDecimal("150"), 100))); + + FairnessResponse.DimensionMetric metric = service.dimensions(1L, "2026-09", "ABILITY").getDimensions().get(0); + + assertThat(metric.getAvailability()).isEqualTo("NO_DATA"); + assertThat(metric.getUnknownStatusCount()).isEqualTo(100); + assertThat(metric.getOutOfRangeScoreCount()).isEqualTo(100); + assertThat(metric.getInconsistentRecordCount()).isEqualTo(100); + } + + @Test + void appealsSeparatesApprovalRollbackChangeAndAllNonComparableReasons() { + List rows = new ArrayList<>(); + List rollbackRows = new ArrayList<>(); + long appealId = 1; + // 30 APPROVED appeals with no rollback history. + for (int i = 0; i < 30; i++) { + rows.add(new AppealRow(appealId++, 40_000L + i, "ABILITY", "2026-09", "APPROVED", "candidate-scoring-v0.2")); + } + // 30 zero-delta rollbacks: they remain in the comparable denominator. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 40_100L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("50"), new BigDecimal("50"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + // 30 genuine score changes. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 40_200L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + // 30 cross-version histories: not comparable and not counted as changes. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 40_300L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.1", "candidate-scoring-v0.2")); + } + // 30 null-score histories: not comparable. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 40_400L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", null, new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + // 30 appeals with duplicate rollback histories: the whole group is excluded. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 40_500L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("50"), new BigDecimal("70"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + appealRowsFixture = rows; + rollbackRowsFixture = rollbackRows; + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getSampleSize()).isEqualTo(180); + assertThat(response.getApprovedEverCount()).isEqualTo(180); + assertThat(response.getComparableRollbackCandidateCount()).isEqualTo(60); + assertThat(response.getChangedCandidateCount()).isEqualTo(30); + assertThat(response.getActualScoreChangeRate()).isEqualByComparingTo("50.00"); + assertThat(response.getDuplicateRollbackHistoryCount()).isEqualTo(30); + assertThat(response.getInvalidScoreRollbackCount()).isEqualTo(30); + assertThat(response.getRuleVersionChangedRollbackCount()).isEqualTo(30); + assertThat(response.getAvailability()).isEqualTo("AVAILABLE"); + } + + @Test + void appealsUsesRollbackRowsForChangeRateWhenOneCandidateHasMultipleComparableHistories() { + List rows = new ArrayList<>(); + List rollbackRows = new ArrayList<>(); + long appealId = 10_000; + // 30 changed-only candidates and 30 unchanged-only candidates. + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 50_000L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("40"), new BigDecimal("50"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + for (int i = 0; i < 30; i++) { + long id = appealId++; + rows.add(new AppealRow(id, 51_000L + i, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(id, "ROLLBACK", new BigDecimal("40"), new BigDecimal("40"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + } + // One candidate has two valid histories: one changed and one unchanged. + long bothChangedAndUnchanged = appealId++; + rows.add(new AppealRow(bothChangedAndUnchanged, 52_000L, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(bothChangedAndUnchanged, "ROLLBACK", new BigDecimal("40"), new BigDecimal("50"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + // A second dimension gives the same candidate another comparable appeal + // without creating duplicate history for a single appeal or duplicate + // appeal in the same dimension/period. + long secondAppeal = appealId++; + rows.add(new AppealRow(secondAppeal, 52_000L, "EXECUTION", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(secondAppeal, "ROLLBACK", new BigDecimal("40"), new BigDecimal("40"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + appealRowsFixture = rows; + rollbackRowsFixture = rollbackRows; + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getComparableRollbackCandidateCount()).isEqualTo(61); + assertThat(response.getComparableRollbackCount()).isEqualTo(62); + assertThat(response.getChangedCount()).isEqualTo(31); + assertThat(response.getChangedCandidateCount()).isEqualTo(31); + assertThat(response.getActualScoreChangeRate()).isEqualByComparingTo("50.00"); + assertThat(response.getMeanDelta()).isEqualByComparingTo("5.00"); + assertThat(response.getMeanAbsoluteDelta()).isEqualByComparingTo("5.00"); + assertThat(response.getAvailability()).isEqualTo("AVAILABLE"); + } + + @Test + void appealsPreservesOverlappingReasonSetsAcrossDifferentAppeals() { + List appealRows = new ArrayList<>(); + List rollbackRows = new ArrayList<>(); + long appealId = 70_000L; + for (int i = 0; i < 30; i++) { + long candidate = 70_100L + i; + long duplicateAppeal = appealId++; + appealRows.add(new AppealRow(duplicateAppeal, candidate, "ABILITY", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(duplicateAppeal, "ROLLBACK", new BigDecimal("50"), new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(duplicateAppeal, "ROLLBACK", new BigDecimal("50"), new BigDecimal("70"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + long invalidAppeal = appealId++; + appealRows.add(new AppealRow(invalidAppeal, candidate, "EXECUTION", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(invalidAppeal, "ROLLBACK", null, new BigDecimal("60"), "candidate-scoring-v0.2", "candidate-scoring-v0.2")); + long versionAppeal = appealId++; + appealRows.add(new AppealRow(versionAppeal, candidate, "GROWTH", "2026-09", "ROLLED_BACK", "candidate-scoring-v0.2")); + rollbackRows.add(new RollbackRow(versionAppeal, "ROLLBACK", new BigDecimal("40"), new BigDecimal("50"), "candidate-scoring-v0.1", "candidate-scoring-v0.2")); + } + appealRowsFixture = appealRows; + rollbackRowsFixture = rollbackRows; + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getReasonCounts()).containsEntry("DUPLICATE_ROLLBACK_HISTORY", 30) + .containsEntry("INVALID_SCORE", 30).containsEntry("RULE_VERSION_CHANGED", 30); + } + + @Test + void appealsUsesCandidateAggregatePathWithoutLoadingAppealOrRollbackDetails() { + Map eventCounts = new LinkedHashMap<>(); eventCounts.put("ROLLED_BACK", 30); + Map candidateCounts = new LinkedHashMap<>(); candidateCounts.put("ROLLED_BACK", 30); + doReturn(new FairnessMonitoringRepository.AppealAggregateSummary(30, 30, eventCounts, candidateCounts, + 30, 30, 30, 0, 30, 30, 30, 30, 0, 0, new BigDecimal("300.00"), new BigDecimal("300.00"), 0, 0, 0)) + .when(repository).findAppealAggregateSummary(any(), any()); + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getSampleSize()).isEqualTo(30); + assertThat(response.getComparableRollbackCount()).isEqualTo(30); + assertThat(response.getComparableRollbackCandidateCount()).isEqualTo(30); + assertThat(response.getChangedCount()).isEqualTo(30); + assertThat(response.getActualScoreChangeRate()).isEqualByComparingTo("100.00"); + assertThat(response.getMeanDelta()).isEqualByComparingTo("10.00"); + verify(repository, times(1)).findAppealAggregateSummary(any(), any()); + } + + @Test + void appealsCandidateAggregatePathSuppressesComparableMetricsWhenOneOfThirtyHasOnlyDuplicateHistory() { + Map eventCounts = new LinkedHashMap<>(); eventCounts.put("ROLLED_BACK", 30); + Map candidateCounts = new LinkedHashMap<>(); candidateCounts.put("ROLLED_BACK", 30); + doReturn(new FairnessMonitoringRepository.AppealAggregateSummary(30, 30, eventCounts, candidateCounts, + 30, 30, 29, 0, 29, 29, 29, 29, 0, 0, new BigDecimal("290.00"), new BigDecimal("290.00"), 1, 0, 0)) + .when(repository).findAppealAggregateSummary(any(), any()); + + FairnessResponse.Appeals response = service.appeals(1L, LocalDate.of(2026, 8, 1), LocalDate.of(2026, 9, 1)); + + assertThat(response.getSampleSize()).isEqualTo(30); + assertThat(response.getAvailability()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(response.getReason()).isEqualTo("COMPARABLE_CANDIDATE_THRESHOLD_NOT_MET"); + assertThat(response.getComparableRollbackCount()).isNull(); + assertThat(response.getComparableRollbackCandidateCount()).isNull(); + assertThat(response.getActualScoreChangeRate()).isNull(); + verify(repository, times(1)).findAppealAggregateSummary(any(), any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculatorTest.java new file mode 100644 index 0000000..cb1c47a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/scoringmonitoring/FairnessStatisticsCalculatorTest.java @@ -0,0 +1,99 @@ +package com.mydreamjob.scoringmonitoring; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +import java.util.ArrayList; +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +class FairnessStatisticsCalculatorTest { + + @Test + void confidenceBoundaries_areIndependentPeopleCounts() { + assertThat(FairnessStatisticsCalculator.confidence(0)).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(FairnessStatisticsCalculator.confidence(29)).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(FairnessStatisticsCalculator.confidence(30)).isEqualTo("LOW_CONFIDENCE"); + assertThat(FairnessStatisticsCalculator.confidence(99)).isEqualTo("LOW_CONFIDENCE"); + assertThat(FairnessStatisticsCalculator.confidence(100)).isEqualTo("NORMAL_CONFIDENCE"); + } + + @Test + void distribution_suppressesSmallBuckets() { + List values = new ArrayList<>(); + for (int i = 0; i < 29; i++) values.add(BigDecimal.valueOf(i)); + values.add(BigDecimal.valueOf(99)); + var result = FairnessStatisticsCalculator.distribution(values); + assertThat(result.getSampleSize()).isNull(); + assertThat(result.getMean()).isNull(); + assertThat(result.getBuckets()).isNull(); + assertThat(result.getAvailability()).isEqualTo("SUPPRESSED"); + } + + @Test + void distribution_usesContinuousBucketsAndHalfUp() { + List values = new ArrayList<>(); + for (int i = 0; i < 30; i++) values.add(BigDecimal.valueOf(50)); + var result = FairnessStatisticsCalculator.distribution(values); + assertThat(result.getMean()).isEqualByComparingTo("50.00"); + assertThat(result.getMedian()).isEqualByComparingTo("50.00"); + assertThat(result.getBuckets().get("50-59")).isEqualTo(30); + assertThat(result.getConcentrationRate()).isEqualByComparingTo("100.00"); + assertThat(result.getRiskLevel()).isEqualTo("HIGH"); + assertThat(result.getAvailability()).isEqualTo("AVAILABLE"); + } + + @Test + void concentrationThreshold_usesUnroundedPercentage() { + List values = new ArrayList<>(); + for (int i = 0; i < 13_999; i++) values.add(BigDecimal.valueOf(50)); + for (int i = 0; i < 6_001; i++) values.add(BigDecimal.valueOf(60)); + + var result = FairnessStatisticsCalculator.distribution(values); + + assertThat(result.getConcentrationRate()).isEqualByComparingTo("70.00"); + assertThat(result.getRiskLevel()).isEqualTo("NORMAL"); + } + + @Test + void frequencyDistributionCalculatesWeightedStatisticsWithoutExpandingSamples() { + var frequencies = List.of( + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("9.5"), 30), + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("10"), 30), + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("89.99"), 30), + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("90"), 30), + new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("100"), 30)); + var result = FairnessStatisticsCalculator.distributionFromFrequencies(frequencies); + assertThat(result.getSampleSize()).isEqualTo(150); + assertThat(result.getMean()).isEqualByComparingTo("59.90"); + assertThat(result.getP10()).isEqualByComparingTo("9.50"); + assertThat(result.getP90()).isEqualByComparingTo("100.00"); + assertThat(result.getBuckets().get("0-9")).isEqualTo(30); + assertThat(result.getBuckets().get("90-100")).isEqualTo(60); + } + + @Test + void emptyDistributionIsExplicitNoData() { + var result = FairnessStatisticsCalculator.distribution(List.of()); + assertThat(result.getSampleSize()).isZero(); + assertThat(result.getAvailability()).isEqualTo("NO_DATA"); + assertThat(result.getReason()).isEqualTo("NO_VALID_SCORE"); + } + + @Test + void frequencySampleThresholdsUseIndependentCandidateCounts() { + assertThat(FairnessStatisticsCalculator.distributionFromFrequencies( + List.of(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50"), 29))) + .getAvailability()).isEqualTo("INSUFFICIENT_SAMPLE"); + assertThat(FairnessStatisticsCalculator.distributionFromFrequencies( + List.of(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50"), 30))) + .getAvailability()).isEqualTo("AVAILABLE"); + assertThat(FairnessStatisticsCalculator.distributionFromFrequencies( + List.of(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50"), 300))) + .getSampleSize()).isEqualTo(300); + assertThat(FairnessStatisticsCalculator.distributionFromFrequencies( + List.of(new FairnessStatisticsCalculator.ScoreFrequency(new BigDecimal("50"), 3000))) + .getSampleSize()).isEqualTo(3000); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/security/CurrentUserAccessorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/security/CurrentUserAccessorTest.java new file mode 100644 index 0000000..a4cdc02 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/security/CurrentUserAccessorTest.java @@ -0,0 +1,152 @@ +package com.mydreamjob.security; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.security.authentication.AnonymousAuthenticationToken; +import org.springframework.security.authentication.InsufficientAuthenticationException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.authority.AuthorityUtils; +import org.springframework.security.core.context.SecurityContextHolder; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +/** + * S01 当前用户解析安全边界。 + * + *

    覆盖任务书要求的 8 类输入，并额外覆盖 Long 溢出与“已认证但名称为 anonymousUser”的绕过尝试。 + * 所有非法输入必须转换为既有“未登录”语义（{@link InsufficientAuthenticationException}， + * 由全局异常处理器映射为 401），且不回显非法 principal。

    + */ +class CurrentUserAccessorTest { + + private static final String BAD_PRINCIPAL = "INTERNAL_BAD_PRINCIPAL_SECRET"; + + private final CurrentUserAccessor accessor = new CurrentUserAccessor(); + + @AfterEach + void clearContext() { + SecurityContextHolder.clearContext(); + } + + @Test + void nullAuthenticationIsUnauthorized() { + assertUnauthorized(() -> accessor.requireUserId((Authentication) null)); + } + + @Test + void unauthenticatedAuthenticationIsUnauthorized() { + // 双参构造 → isAuthenticated() == false + Authentication unauthenticated = new UsernamePasswordAuthenticationToken("42", null); + assertThat(unauthenticated.isAuthenticated()).isFalse(); + + assertUnauthorized(() -> accessor.requireUserId(unauthenticated)); + } + + @Test + void anonymousAuthenticationTokenIsUnauthorized() { + AnonymousAuthenticationToken anonymous = new AnonymousAuthenticationToken( + "anonymous-key", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS")); + // 关键前提：Spring 的匿名令牌 isAuthenticated() 为 true， + // 仅检查 isAuthenticated() 会把匿名当成已登录用户。 + assertThat(anonymous.isAuthenticated()).isTrue(); + + assertUnauthorized(() -> accessor.requireUserId(anonymous)); + } + + @Test + void anonymousUserNameIsUnauthorized() { + Authentication authenticatedButAnonymousName = + UsernamePasswordAuthenticationToken.authenticated("anonymousUser", null, List.of()); + + assertUnauthorized(() -> accessor.requireUserId(authenticatedButAnonymousName)); + } + + @Test + void blankPrincipalIsUnauthorized() { + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated(" ", null, List.of()))); + } + + @Test + void nonNumericPrincipalIsUnauthorizedWithoutEcho() { + Authentication bad = UsernamePasswordAuthenticationToken.authenticated(BAD_PRINCIPAL, null, List.of()); + + assertThatThrownBy(() -> accessor.requireUserId(bad)) + .isInstanceOf(InsufficientAuthenticationException.class) + .satisfies(e -> { + assertThat(e.getMessage()).doesNotContain(BAD_PRINCIPAL); + assertThat(String.valueOf(e)).doesNotContain(BAD_PRINCIPAL); + // 异常及其堆栈不得携带非法 principal 原文 + assertThat(java.util.Arrays.toString(e.getStackTrace())) + .doesNotContain(BAD_PRINCIPAL); + }); + } + + @Test + void nonPositiveUserIdIsUnauthorized() { + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated("0", null, List.of()))); + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated("-1", null, List.of()))); + } + + @Test + void validNumericPrincipalReturnsUserId() { + assertThat(accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated("42", null, List.of()))) + .isEqualTo(42L); + + assertThat(accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated( + String.valueOf(Long.MAX_VALUE), null, List.of()))) + .isEqualTo(Long.MAX_VALUE); + } + + // ── 额外边界：不得让 NumberFormatException 逃逸 ───────────────── + + @Test + void numericOverflowIsUnauthorizedNotNumberFormatException() { + Authentication overflow = UsernamePasswordAuthenticationToken.authenticated( + "99999999999999999999", null, List.of()); + + assertThatThrownBy(() -> accessor.requireUserId(overflow)) + .isInstanceOf(InsufficientAuthenticationException.class) + .isNotInstanceOf(NumberFormatException.class); + } + + @Test + void plusSignAndWhitespacePrincipalsAreUnauthorized() { + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated("+42", null, List.of()))); + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated(" 42", null, List.of()))); + assertUnauthorized(() -> accessor.requireUserId( + UsernamePasswordAuthenticationToken.authenticated("42 ", null, List.of()))); + } + + // ── SecurityContext 版本 ──────────────────────────────────────── + + @Test + void requireUserIdReadsFromSecurityContext() { + assertUnauthorized(() -> accessor.requireUserId()); + + SecurityContextHolder.getContext().setAuthentication( + UsernamePasswordAuthenticationToken.authenticated("7", null, List.of())); + assertThat(accessor.requireUserId()).isEqualTo(7L); + + SecurityContextHolder.getContext().setAuthentication( + new AnonymousAuthenticationToken("k", "anonymousUser", + AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"))); + assertUnauthorized(() -> accessor.requireUserId()); + } + + private void assertUnauthorized(Runnable action) { + assertThatThrownBy(action::run) + .isInstanceOf(InsufficientAuthenticationException.class); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/CandidateKeyGeneratorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/CandidateKeyGeneratorTest.java new file mode 100644 index 0000000..ec812af --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/CandidateKeyGeneratorTest.java @@ -0,0 +1,20 @@ +package com.mydreamjob.talentdiscovery; + +import org.junit.jupiter.api.Test; + +import java.time.LocalDate; + +import static org.junit.jupiter.api.Assertions.*; + +class CandidateKeyGeneratorTest { + @Test + void keyIsOpaqueAndBoundToScopeAndDate() { + CandidateKeyGenerator generator = new CandidateKeyGenerator("test-secret"); + String first = generator.generate(1L, 2L, 3L, LocalDate.of(2026, 9, 4)); + assertNotNull(first); + assertTrue(first.length() >= 40); + assertNotEquals("1|2|3|2026-09-04", first); + assertNotEquals(first, generator.generate(1L, 2L, 4L, LocalDate.of(2026, 9, 4))); + assertNotEquals(first, generator.generate(1L, 2L, 3L, LocalDate.of(2026, 9, 5))); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryControllerTest.java new file mode 100644 index 0000000..b0898d8 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryControllerTest.java @@ -0,0 +1,137 @@ +package com.mydreamjob.talentdiscovery; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryCandidateResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPageResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceResponse; +import org.junit.jupiter.api.BeforeEach; +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.data.redis.core.ValueOperations; +import org.springframework.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; + +import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.not; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; +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") +@TestPropertySource(properties = "spring.jpa.open-in-view=false") +class TalentDiscoveryControllerTest { + + @Autowired private MockMvc mockMvc; + @Autowired private JwtTokenProvider jwtTokenProvider; + @MockBean private TalentDiscoveryService service; + @MockBean private RedisTemplate redisTemplate; + + private final ObjectMapper mapper = new ObjectMapper(); + + @BeforeEach + @SuppressWarnings("unchecked") + void setUp() { + ValueOperations ops = org.mockito.Mockito.mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(ops); + when(redisTemplate.hasKey(any())).thenReturn(false); + } + + private String token(long userId, String role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role); + } + + @Test + void getPreference_usesJwtIdentityAndReturnsPreference() throws Exception { + when(service.getPreference(100L)).thenReturn(TalentDiscoveryPreferenceResponse.builder() + .enabled(false).version(0L).build()); + + mockMvc.perform(get("/profile/me/talent-discovery") + .header("Authorization", token(100L, "STUDENT"))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.enabled").value(false)) + .andExpect(jsonPath("$.data.version").value(0)); + } + + @Test + void getPreference_withoutTokenReturns401() throws Exception { + mockMvc.perform(get("/profile/me/talent-discovery")) + .andExpect(status().isUnauthorized()) + .andExpect(jsonPath("$.code").value(401)); + } + + @Test + void updatePreference_studentCannotSupplyIdentityAndReturns200() throws Exception { + when(service.updatePreference(anyLong(), any(), any())).thenReturn( + TalentDiscoveryPreferenceResponse.builder().enabled(true).version(1L).build()); + + String body = mapper.writeValueAsString(java.util.Map.of( + "enabled", true, "expectedVersion", 0, "studentUserId", 999999)); + mockMvc.perform(put("/profile/me/talent-discovery") + .header("Authorization", token(100L, "STUDENT")) + .contentType(MediaType.APPLICATION_JSON) + .content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.code").value(200)) + .andExpect(jsonPath("$.data.enabled").value(true)); + } + + @Test + void companyRecommendationResponseContainsOnlyWhitelistedCardFields() throws Exception { + TalentDiscoveryCandidateResponse candidate = TalentDiscoveryCandidateResponse.builder() + .candidateKey("opaque-key") + .candidateLabel("开放人才候选人") + .city("杭州") + .education("本科") + .graduationYear(2026) + .skills(List.of("Java", "Spring Boot")) + .fitBand("HIGH") + .summary("岗位画像与候选人公开资料存在较高匹配度") + .signalsAvailable(List.of("PREFERENCE", "RIASEC", "ABILITY")) + .build(); + when(service.recommendations(anyLong(), anyLong(), anyInt(), anyInt())).thenReturn( + TalentDiscoveryPageResponse.builder().mode("PERSONALIZED") + .items(List.of(candidate)).total(1).page(0).size(20).totalPages(1).build()); + + mockMvc.perform(get("/companies/me/jobs/9/talent-recommendations") + .header("Authorization", token(200L, "COMPANY"))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.data.items[0].candidateKey").value("opaque-key")) + .andExpect(jsonPath("$.data.items[0].fitScore").doesNotExist()) + .andExpect(content().string(not(containsString("studentUserId")))) + .andExpect(content().string(not(containsString("dimensionScores")))) + .andExpect(content().string(not(containsString("overallScore")))) + .andExpect(content().string(not(containsString("fitScore")))); + } + + @Test + void companyRecommendationServiceForbiddenIsMappedTo403() throws Exception { + doThrow(new BusinessException(ErrorCode.FORBIDDEN)) + .when(service).recommendations(anyLong(), anyLong(), anyInt(), anyInt()); + + mockMvc.perform(get("/companies/me/jobs/9/talent-recommendations") + .header("Authorization", token(201L, "COMPANY"))) + .andExpect(status().isForbidden()) + .andExpect(jsonPath("$.code").value(2002)); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryPersistenceIntegrationTest.java new file mode 100644 index 0000000..79ab354 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryPersistenceIntegrationTest.java @@ -0,0 +1,41 @@ +package com.mydreamjob.talentdiscovery; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import static org.assertj.core.api.Assertions.assertThat; + +/** 只读确认 V41 的 V39 迁移在集成测试 H2(MODE=MySQL) 中已执行。 */ +@SpringBootTest +@ActiveProfiles("integration-test") +class TalentDiscoveryPersistenceIntegrationTest { + @Autowired JdbcTemplate jdbcTemplate; + @MockBean RedisTemplate redisTemplate; + + @Test + void v39Migration_createsPreferenceTableWithSafeDefaultsAndConstraints() { + Integer tableCount = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME='STUDENT_TALENT_DISCOVERY_PREFERENCES'", + Integer.class); + assertThat(tableCount).isEqualTo(1); + + String enabledDefault = jdbcTemplate.queryForObject( + "SELECT COLUMN_DEFAULT FROM INFORMATION_SCHEMA.COLUMNS " + + "WHERE TABLE_NAME='STUDENT_TALENT_DISCOVERY_PREFERENCES' AND COLUMN_NAME='ENABLED'", + String.class); + assertThat(enabledDefault).isEqualTo("0"); + + Integer uniqueCount = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS " + + "WHERE TABLE_NAME='STUDENT_TALENT_DISCOVERY_PREFERENCES' " + + "AND CONSTRAINT_NAME='UK_STUDENT_TALENT_DISCOVERY_PREFERENCES_STUDENT' " + + "AND CONSTRAINT_TYPE='UNIQUE'", + Integer.class); + assertThat(uniqueCount).isEqualTo(1); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculatorTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculatorTest.java new file mode 100644 index 0000000..db0be1e --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryScoreCalculatorTest.java @@ -0,0 +1,47 @@ +package com.mydreamjob.talentdiscovery; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; + +import static org.junit.jupiter.api.Assertions.*; + +class TalentDiscoveryScoreCalculatorTest { + private final TalentDiscoveryScoreCalculator calculator = new TalentDiscoveryScoreCalculator(); + + @Test + void allSignals_useFixedWeightsAndHalfUp() { + var result = calculator.calculate(new BigDecimal("80"), new BigDecimal("70"), new BigDecimal("60")); + assertTrue(result.isPresent()); + assertEquals(new BigDecimal("71.50"), result.get().fitScore()); + assertEquals("MEDIUM", result.get().fitBand()); + assertEquals(java.util.List.of("PREFERENCE", "RIASEC", "ABILITY"), result.get().signalsAvailable()); + } + + @Test + void missingSignals_areRenormalized_notZero() { + var onlyAbility = calculator.calculate(null, null, new BigDecimal("80")); + assertTrue(onlyAbility.isPresent()); + assertEquals(new BigDecimal("80.00"), onlyAbility.get().fitScore()); + var preferenceAndRiasec = calculator.calculate(new BigDecimal("100"), new BigDecimal("0"), null); + assertTrue(preferenceAndRiasec.isPresent()); + assertEquals(new BigDecimal("53.33"), preferenceAndRiasec.get().fitScore()); + } + + @Test + void noSignal_orOutOfRange_isUnavailable() { + assertTrue(calculator.calculate(null, null, null).isEmpty()); + assertTrue(calculator.calculate(new BigDecimal("-1"), null, null).isEmpty()); + assertTrue(calculator.calculate(null, new BigDecimal("101"), null).isEmpty()); + } + + @Test + void bandBoundaries_areDeterministic() { + assertEquals("HIGH", calculator.calculate(new BigDecimal("74.995"), null, null).orElseThrow().fitBand()); + assertEquals("MEDIUM", calculator.calculate(new BigDecimal("59.995"), null, null).orElseThrow().fitBand()); + assertEquals("HIGH", calculator.band(new BigDecimal("75.00"))); + assertEquals("MEDIUM", calculator.band(new BigDecimal("74.99"))); + assertEquals("MEDIUM", calculator.band(new BigDecimal("60.00"))); + assertEquals("BASIC", calculator.band(new BigDecimal("59.99"))); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryServiceTest.java new file mode 100644 index 0000000..794dcf5 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentdiscovery/TalentDiscoveryServiceTest.java @@ -0,0 +1,174 @@ +package com.mydreamjob.talentdiscovery; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.recommendation.JobRecommendationProfile; +import com.mydreamjob.recommendation.JobRecommendationProfileRepository; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPageResponse; +import com.mydreamjob.talentdiscovery.dto.TalentDiscoveryPreferenceUpdateRequest; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.stream.IntStream; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyCollection; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class TalentDiscoveryServiceTest { + + @BeforeEach + void wireRoleGuard() { + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + } + @Mock StudentTalentDiscoveryPreferenceRepository preferenceRepository; + @Mock UserRepository userRepository; + @Mock CompanyRepository companyRepository; + @Mock JobRepository jobRepository; + @Mock JobRecommendationProfileRepository profileRepository; + @Mock TalentDiscoveryCandidateSource candidateSource; + @Mock TalentDiscoveryScoreCalculator scoreCalculator; + @Mock AuditService auditService; + @Mock CandidateKeyGenerator candidateKeyGenerator; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; + @InjectMocks TalentDiscoveryService service; + + @Test + void missingApprovedProfile_returnsUnavailableWithoutReadingCandidates() { + User companyUser = User.builder().id(1L).role(User.Role.COMPANY).roles(Set.of(User.Role.COMPANY)).build(); + Company company = Company.builder().id(10L).ownerUserId(1L).verified(true).build(); + Job job = Job.builder().id(20L).companyId(10L).status("PUBLISHED").build(); + when(userRepository.findById(1L)).thenReturn(Optional.of(companyUser)); + when(companyRepository.findByOwnerUserId(1L)).thenReturn(Optional.of(company)); + when(jobRepository.findById(20L)).thenReturn(Optional.of(job)); + when(profileRepository.findByJobId(20L)).thenReturn(Optional.empty()); + + TalentDiscoveryPageResponse response = service.recommendations(1L, 20L, 0, 20); + + assertThat(response.getMode()).isEqualTo("UNAVAILABLE"); + assertThat(response.getItems()).isEmpty(); + verifyNoInteractions(candidateSource, candidateKeyGenerator); + } + + @Test + void calculatesAllCandidatesBeforePagingAndNeverSerializesFitScore() throws Exception { + User companyUser = User.builder().id(1L).role(User.Role.COMPANY).roles(Set.of(User.Role.COMPANY)).build(); + Company company = Company.builder().id(10L).ownerUserId(1L).verified(true).build(); + Job job = Job.builder().id(20L).companyId(10L).status("PUBLISHED") + .city("北京").employmentType("FULL_TIME").salaryMin(10000).salaryMax(20000).build(); + JobRecommendationProfile profile = JobRecommendationProfile.builder().jobId(20L).enabled(true) + .reviewStatus(JobRecommendationProfile.APPROVED).industryCode("TECH").jobFamilyCode("BACKEND") + .build(); + LocalDateTime now = LocalDateTime.now(); + var first = new TalentDiscoveryCandidateSource.CandidateSeed(101L, "北京", "本科", 2026, + "[\"Java\",\"SQL\"]", now); + var second = new TalentDiscoveryCandidateSource.CandidateSeed(102L, "上海", "本科", 2026, + "[\"Go\"]", now.minusMinutes(1)); + when(userRepository.findById(1L)).thenReturn(Optional.of(companyUser)); + when(companyRepository.findByOwnerUserId(1L)).thenReturn(Optional.of(company)); + when(jobRepository.findById(20L)).thenReturn(Optional.of(job)); + when(profileRepository.findByJobId(20L)).thenReturn(Optional.of(profile)); + when(candidateSource.findEligibleCandidates(10L)).thenReturn(List.of(first, second)); + when(candidateSource.findPreferences(anyCollection())).thenReturn(Map.of( + 101L, new TalentDiscoveryCandidateSource.PreferenceSignal(null, null, + List.of("北京"), List.of(), List.of(), List.of(), false), + 102L, new TalentDiscoveryCandidateSource.PreferenceSignal(null, null, + List.of("上海"), List.of(), List.of(), List.of(), false))); + when(candidateSource.findLatestRiasec(anyCollection())).thenReturn(Map.of()); + when(candidateSource.findLatestAbility(anyCollection(), any())).thenReturn(Map.of()); + when(candidateKeyGenerator.generate(any(), any(), any(), any())).thenAnswer(invocation -> + "candidate-" + invocation.getArgument(2)); + when(scoreCalculator.calculate(any(), any(), any())).thenAnswer(invocation -> + new TalentDiscoveryScoreCalculator().calculate(invocation.getArgument(0), invocation.getArgument(1), invocation.getArgument(2))); + + TalentDiscoveryPageResponse page0 = service.recommendations(1L, 20L, 0, 1); + TalentDiscoveryPageResponse page1 = service.recommendations(1L, 20L, 1, 1); + + assertThat(page0.getMode()).isEqualTo("PERSONALIZED"); + assertThat(page0.getTotal()).isEqualTo(2); + assertThat(page0.getItems()).singleElement().satisfies(item -> { + assertThat(item.getCandidateKey()).isEqualTo("candidate-101"); + assertThat(item.getFitBand()).isEqualTo("HIGH"); + assertThat(item.getSignalsAvailable()).containsExactly("PREFERENCE"); + }); + assertThat(page1.getItems()).singleElement().satisfies(item -> + assertThat(item.getCandidateKey()).isEqualTo("candidate-102")); + String json = new ObjectMapper().writeValueAsString(page0); + assertThat(json).doesNotContain("fitScore", "studentUserId", "candidateId", "dimensionScores"); + verify(candidateSource, times(2)).findEligibleCandidates(10L); + } + + @Test + void missingPreference_isReadOnlyAndDefaultsToDisabled() { + User student = User.builder().id(7L).role(User.Role.STUDENT).roles(Set.of(User.Role.STUDENT)).build(); + when(userRepository.findById(7L)).thenReturn(Optional.of(student)); + when(preferenceRepository.findByStudentUserId(7L)).thenReturn(Optional.empty()); + + var response = service.getPreference(7L); + + assertThat(response.getEnabled()).isFalse(); + assertThat(response.getVersion()).isZero(); + verify(preferenceRepository, never()).save(any()); + verify(preferenceRepository, never()).saveAndFlush(any()); + } + + @Test + void invalidPageParameters_areRejectedBeforeDatabaseQueries() { + org.junit.jupiter.api.Assertions.assertThrows( + com.mydreamjob.common.exception.BusinessException.class, + () -> service.recommendations(1L, 20L, -1, 50)); + verifyNoInteractions(userRepository, companyRepository, jobRepository); + } + + @Test + void batchSignalReads_areBoundedByBatchCountNotCandidateCount() { + User companyUser = User.builder().id(1L).role(User.Role.COMPANY).roles(Set.of(User.Role.COMPANY)).build(); + Company company = Company.builder().id(10L).ownerUserId(1L).verified(true).build(); + Job job = Job.builder().id(20L).companyId(10L).status("PUBLISHED") + .city("北京").employmentType("FULL_TIME").salaryMin(10000).salaryMax(20000).build(); + JobRecommendationProfile profile = JobRecommendationProfile.builder().jobId(20L).enabled(true) + .reviewStatus(JobRecommendationProfile.APPROVED).industryCode("TECH").jobFamilyCode("BACKEND") + .build(); + List seeds = IntStream.range(0, 501) + .mapToObj(i -> new TalentDiscoveryCandidateSource.CandidateSeed( + 1000L + i, "北京", "本科", 2026, "[]", LocalDateTime.now())) + .toList(); + when(userRepository.findById(1L)).thenReturn(Optional.of(companyUser)); + when(companyRepository.findByOwnerUserId(1L)).thenReturn(Optional.of(company)); + when(jobRepository.findById(20L)).thenReturn(Optional.of(job)); + when(profileRepository.findByJobId(20L)).thenReturn(Optional.of(profile)); + when(candidateSource.findEligibleCandidates(10L)).thenReturn(seeds); + when(candidateSource.findPreferences(anyCollection())).thenReturn(Map.of()); + when(candidateSource.findLatestRiasec(anyCollection())).thenReturn(Map.of()); + when(candidateSource.findLatestAbility(anyCollection(), any())).thenReturn(Map.of()); + when(scoreCalculator.calculate(any(), any(), any())).thenReturn(java.util.Optional.empty()); + + TalentDiscoveryPageResponse response = service.recommendations(1L, 20L, 0, 20); + + assertThat(response.getMode()).isEqualTo("NO_ELIGIBLE_CANDIDATE"); + verify(candidateSource, times(2)).findPreferences(anyCollection()); + verify(candidateSource, times(2)).findLatestRiasec(anyCollection()); + verify(candidateSource, times(2)).findLatestAbility(anyCollection(), any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolverTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolverTest.java new file mode 100644 index 0000000..29098a5 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationCandidateResolverTest.java @@ -0,0 +1,56 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.talentdiscovery.CandidateKeyGenerator; +import com.mydreamjob.talentdiscovery.TalentDiscoveryCandidateSource; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.Map; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class TalentInvitationCandidateResolverTest { + @Mock TalentDiscoveryCandidateSource source; + @Mock CandidateKeyGenerator keyGenerator; + + @Test + void resolvesOnlyCurrentKeyAndCandidateWithAtLeastOneSignal() { + TalentInvitationCandidateResolver resolver = new TalentInvitationCandidateResolver(source, keyGenerator); + LocalDateTime now = LocalDateTime.of(2026, 9, 7, 10, 0); + var enabled = new TalentDiscoveryCandidateSource.CandidateSeed(101L, "北京", "本科", 2026, "[]", now); + var noSignal = new TalentDiscoveryCandidateSource.CandidateSeed(102L, "上海", "本科", 2026, "[]", now); + when(source.findEligibleCandidates(9L)).thenReturn(List.of(enabled, noSignal)); + when(source.findPreferences(any())).thenReturn(Map.of(101L, + new TalentDiscoveryCandidateSource.PreferenceSignal(null, null, List.of("北京"), List.of(), List.of(), List.of(), false))); + when(source.findLatestRiasec(any())).thenReturn(Map.of()); + when(source.findLatestAbility(any(), eq(now))).thenReturn(Map.of()); + when(keyGenerator.generate(9L, 8L, 101L, now.toLocalDate())).thenReturn("key-101"); + + assertThat(resolver.resolve(9L, 8L, "key-101", now).matched()).isTrue(); + assertThat(resolver.resolve(9L, 8L, "key-102", now).matched()).isFalse(); + verify(keyGenerator, never()).generate(9L, 8L, 102L, now.toLocalDate()); + } + + @Test + void malformedOrCrossDayKeyDoesNotResolve() { + TalentInvitationCandidateResolver resolver = new TalentInvitationCandidateResolver(source, keyGenerator); + LocalDateTime now = LocalDateTime.of(2026, 9, 7, 10, 0); + var candidate = new TalentDiscoveryCandidateSource.CandidateSeed(101L, "北京", "本科", 2026, "[]", now); + when(source.findEligibleCandidates(9L)).thenReturn(List.of(candidate)); + when(source.findPreferences(any())).thenReturn(Map.of(101L, + new TalentDiscoveryCandidateSource.PreferenceSignal(null, null, List.of("北京"), List.of(), List.of(), List.of(), false))); + when(source.findLatestRiasec(any())).thenReturn(Map.of()); + when(source.findLatestAbility(any(), eq(now))).thenReturn(Map.of()); + when(keyGenerator.generate(9L, 8L, 101L, now.toLocalDate())).thenReturn("key-101"); + + assertThat(resolver.resolve(9L, 8L, "tampered", now).matched()).isFalse(); + verify(keyGenerator).generate(9L, 8L, 101L, now.toLocalDate()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationControllerTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationControllerTest.java new file mode 100644 index 0000000..837cf16 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationControllerTest.java @@ -0,0 +1,61 @@ +package com.mydreamjob.talentinvitation; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mydreamjob.auth.JwtTokenProvider; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.talentinvitation.dto.TalentInvitationPageResponse; +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.http.MediaType; +import org.springframework.test.context.ActiveProfiles; +import org.springframework.test.web.servlet.MockMvc; + +import java.util.List; +import java.util.Map; + +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.when; +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 TalentInvitationControllerTest { + @Autowired MockMvc mockMvc; + @Autowired JwtTokenProvider jwtTokenProvider; + @MockBean TalentInvitationService service; + @MockBean RedisTemplate redisTemplate; + + @Test + void anonymousInvitationList_isUnauthorized() throws Exception { + mockMvc.perform(get("/companies/me/talent-invitations")) + .andExpect(status().isUnauthorized()); + } + + @Test + void companyInvitationList_isReachableThroughAuthenticatedRoute() throws Exception { + when(service.listCompany(eq(100L), eq(0), eq(20))) + .thenReturn(TalentInvitationPageResponse.builder() + .items(List.of()).total(0).page(0).size(20).totalPages(0).build()); + mockMvc.perform(get("/companies/me/talent-invitations").header("Authorization", token(100L, "COMPANY"))) + .andExpect(status().isOk()).andExpect(jsonPath("$.code").value(200)); + } + + @Test + void studentOnCompanyInvitationList_isForbiddenByServiceRoleGuard() throws Exception { + when(service.listCompany(eq(100L), eq(0), eq(20))).thenThrow(new BusinessException(ErrorCode.FORBIDDEN)); + mockMvc.perform(get("/companies/me/talent-invitations").header("Authorization", token(100L, "STUDENT"))) + .andExpect(status().isForbidden()).andExpect(jsonPath("$.code").value(2002)); + } + + private String token(Long userId, String role) { + return com.mydreamjob.auth.support.TestAuthTokens.bearer(userId, role); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryServiceTest.java new file mode 100644 index 0000000..6cc0f9a --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationExpiryServiceTest.java @@ -0,0 +1,38 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.common.exception.ErrorCode; +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.time.LocalDateTime; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class TalentInvitationExpiryServiceTest { + @Mock TalentInvitationRepository invitationRepository; + @Mock TalentInvitationHistoryRepository historyRepository; + @Mock AuditService auditService; + @InjectMocks TalentInvitationExpiryService service; + + @Test + void dueInvitationIsPersistedAsExpiredWithHistoryAndAudit() { + LocalDateTime now = LocalDateTime.of(2026, 9, 7, 10, 0); + TalentInvitation invitation = TalentInvitation.builder().id(9L).jobId(20L).status(TalentInvitation.PENDING) + .expiresAt(now.minusSeconds(1)).build(); + when(invitationRepository.findById(9L)).thenReturn(Optional.of(invitation)); + when(invitationRepository.expire(9L, now)).thenReturn(1); + + assertThat(service.expireIfDue(9L, now, null)).isTrue(); + verify(invitationRepository).expire(9L, now); + verify(historyRepository).save(argThat(h -> TalentInvitationHistory.EXPIRED.equals(h.getAction()))); + verify(auditService).log(isNull(), eq("TALENT_INVITATION_EXPIRED"), eq("TALENT_INVITATION"), eq(9L), contains("\"status\":\"EXPIRED\""), any()); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationPersistenceIntegrationTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationPersistenceIntegrationTest.java new file mode 100644 index 0000000..6efc8df --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationPersistenceIntegrationTest.java @@ -0,0 +1,48 @@ +package com.mydreamjob.talentinvitation; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +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.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ActiveProfiles; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +/** 只读验证 V42/V40 迁移在 H2 MODE=MySQL 中执行，且邀约历史不携带候选人敏感字段。 */ +@SpringBootTest +@ActiveProfiles("integration-test") +class TalentInvitationPersistenceIntegrationTest { + @Autowired JdbcTemplate jdbcTemplate; + @MockBean RedisTemplate redisTemplate; + + @Test + void v40Migration_createsInvitationTablesAndConstraints() { + assertThat(tableCount("TALENT_INVITATIONS")).isEqualTo(1); + assertThat(tableCount("TALENT_INVITATION_HISTORY")).isEqualTo(1); + String statusDefault = jdbcTemplate.queryForObject( + "SELECT COLUMN_DEFAULT FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='TALENT_INVITATIONS' AND COLUMN_NAME='STATUS'", + String.class); + assertThat(statusDefault).isIn("PENDING", "'PENDING'"); + Integer idempotencyUnique = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME='TALENT_INVITATIONS' " + + "AND CONSTRAINT_NAME='UK_TALENT_INVITATIONS_IDEMPOTENCY' AND CONSTRAINT_TYPE='UNIQUE'", Integer.class); + assertThat(idempotencyUnique).isGreaterThanOrEqualTo(1); + } + + @Test + void invitationHistory_containsNoStudentOrMessageColumns() { + List columns = jdbcTemplate.queryForList( + "SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='TALENT_INVITATION_HISTORY'", + String.class); + assertThat(columns).doesNotContain("STUDENT_USER_ID", "MESSAGE", "CANDIDATE_KEY", "PHONE", "EMAIL", "IP_ADDRESS", "USER_AGENT", "TOKEN", "PASSWORD"); + assertThat(columns).contains("INVITATION_ID", "ACTION", "ACTOR_USER_ID", "CREATED_AT"); + } + + private int tableCount(String table) { + return jdbcTemplate.queryForObject("SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME=?", Integer.class, table); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationSchemaMappingTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationSchemaMappingTest.java new file mode 100644 index 0000000..235fbff --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationSchemaMappingTest.java @@ -0,0 +1,39 @@ +package com.mydreamjob.talentinvitation; + +import jakarta.persistence.Column; +import org.hibernate.annotations.JdbcTypeCode; +import org.hibernate.type.SqlTypes; +import org.junit.jupiter.api.Test; + +import java.lang.reflect.Field; +import java.util.Locale; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * V40 在真实 MySQL 中将 candidate_key_digest 建为 CHAR(64)。 + * 该测试锁定实体映射，避免后续把字段退回默认 VARCHAR 推断。 + */ +class TalentInvitationSchemaMappingTest { + + @Test + void candidateKeyDigest_usesChar64Mapping() throws Exception { + Field field = TalentInvitation.class.getDeclaredField("candidateKeyDigest"); + JdbcTypeCode jdbcType = field.getAnnotation(JdbcTypeCode.class); + Column column = field.getAnnotation(Column.class); + + assertNotNull(jdbcType); + assertEquals(SqlTypes.CHAR, jdbcType.value()); + assertNotNull(column); + assertEquals(64, column.length()); + assertTrue(column.columnDefinition().toUpperCase(Locale.ROOT).contains("CHAR(64)")); + } + + @Test + void candidateKeyDigest_contract_isFixed64Hex() { + String digest = "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"; + assertEquals(64, digest.length()); + assertTrue(digest.matches("[0-9a-f]{64}")); + assertNotEquals(64, digest + "0"); + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationServiceTest.java new file mode 100644 index 0000000..4c071e3 --- /dev/null +++ b/mydreamjob-server/src/test/java/com/mydreamjob/talentinvitation/TalentInvitationServiceTest.java @@ -0,0 +1,143 @@ +package com.mydreamjob.talentinvitation; + +import com.mydreamjob.audit.AuditService; +import com.mydreamjob.audit.SecurityAuditService; +import com.mydreamjob.auth.User; +import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.company.Company; +import com.mydreamjob.company.CompanyRepository; +import com.mydreamjob.common.exception.BusinessException; +import com.mydreamjob.common.exception.ErrorCode; +import com.mydreamjob.job.Job; +import com.mydreamjob.job.JobRepository; +import com.mydreamjob.recommendation.JobRecommendationProfile; +import com.mydreamjob.recommendation.JobRecommendationProfileRepository; +import com.mydreamjob.review.ReviewModerationService; +import com.mydreamjob.safety.BlockRelationRepository; +import com.mydreamjob.talentinvitation.dto.CreateTalentInvitationRequest; +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 org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; + +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.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +class TalentInvitationServiceTest { + @Mock TalentInvitationRepository invitationRepository; + @Mock TalentInvitationHistoryRepository historyRepository; + @Mock UserRepository userRepository; + @Mock CompanyRepository companyRepository; + @Mock JobRepository jobRepository; + @Mock JobRecommendationProfileRepository profileRepository; + @Mock TalentInvitationCandidateResolver candidateResolver; + @Mock TalentInvitationConversationService conversationService; + @Mock TalentInvitationExpiryService expiryService; + @Mock BlockRelationRepository blockRelationRepository; + @Mock ReviewModerationService moderationService; + @Mock AuditService auditService; + @Mock SecurityAuditService securityAuditService; + @InjectMocks TalentInvitationService service; + + private final User companyUser = User.builder().id(1L).role(User.Role.COMPANY).roles(Set.of(User.Role.COMPANY)).build(); + private final Company company = Company.builder().id(10L).ownerUserId(1L).verified(true).build(); + private final Job publishedJob = Job.builder().id(20L).companyId(10L).status("PUBLISHED").title("后端工程师").build(); + + private void commonSetup() { + when(userRepository.findById(1L)).thenReturn(Optional.of(companyUser)); + when(companyRepository.findByOwnerUserId(1L)).thenReturn(Optional.of(company)); + when(companyRepository.findByIdForUpdate(10L)).thenReturn(Optional.of(company)); + when(jobRepository.findById(20L)).thenReturn(Optional.of(publishedJob)); + when(profileRepository.findByJobId(20L)).thenReturn(Optional.of(JobRecommendationProfile.builder().jobId(20L) + .enabled(true).reviewStatus(JobRecommendationProfile.APPROVED).build())); + when(candidateResolver.resolve(eq(10L), eq(20L), any(), any())) + .thenReturn(new TalentInvitationCandidateResolver.Resolution(101L, true)); + when(invitationRepository.findByCompanyIdAndIdempotencyKey(eq(10L), any())).thenReturn(Optional.empty()); + when(invitationRepository.findByCompanyIdAndJobIdAndStudentUserIdAndStatus(10L, 20L, 101L, TalentInvitation.PENDING)) + .thenReturn(Optional.empty()); + when(invitationRepository.existsInCooldown(eq(10L), eq(101L), any())).thenReturn(false); + when(invitationRepository.countJobCreatedBetween(eq(10L), eq(20L), any(), any())).thenReturn(0L); + when(invitationRepository.countCreatedBetween(eq(10L), any(), any())).thenReturn(0L); + when(moderationService.moderateCompanyReply(any())).thenReturn( + new ReviewModerationService.ModerationResult(TalentInvitation.PENDING, java.util.List.of(), java.math.BigDecimal.ZERO, null)); + when(invitationRepository.saveAndFlush(any())).thenAnswer(invocation -> { + TalentInvitation value = invocation.getArgument(0); + value.setId(55L); + return value; + }); + when(invitationRepository.attachConversation(anyLong(), anyLong(), anyLong(), anyLong())).thenReturn(1); + } + + private CreateTalentInvitationRequest request(String key, String message, String idempotency) { + CreateTalentInvitationRequest request = new CreateTalentInvitationRequest(); + request.setCandidateKey(key); request.setMessage(message); request.setIdempotencyKey(idempotency); + return request; + } + + @Test + void safeMessage_createsPendingInvitationAndHistory() { + commonSetup(); + var response = service.create(1L, 20L, + request("candidate-key", "欢迎了解岗位", "3c989a31-6774-4520-9700-e58416cc1845"), null); + assertThat(response.getInvitationId()).isEqualTo(55L); + assertThat(response.getStatus()).isEqualTo(TalentInvitation.PENDING); + verify(historyRepository).save(any(TalentInvitationHistory.class)); + verify(auditService).log(eq(1L), eq("TALENT_INVITATION_CREATED"), any(), eq(55L), any(), any()); + } + + @Test + void riskyMessage_isRejectedBeforeInsert() { + commonSetup(); + when(moderationService.moderateCompanyReply(any())).thenReturn( + new ReviewModerationService.ModerationResult("PENDING", java.util.List.of(ReviewModerationService.REASON_CONTACT_INFO), java.math.BigDecimal.valueOf(2), "MEDIUM")); + assertThatThrownBy(() -> service.create(1L, 20L, + request("candidate-key", "请加微信wx_12345", "3c989a31-6774-4520-9700-e58416cc1846"), null)) + .isInstanceOf(BusinessException.class) + .extracting("errorCode").isEqualTo(ErrorCode.TALENT_INVITATION_CONTENT_INVALID.getCode()); + verify(invitationRepository, never()).saveAndFlush(any()); + verify(securityAuditService).logRejected(eq(1L), eq("TALENT_INVITATION_CREATE_REJECTED"), + eq("TALENT_INVITATION"), isNull(), contains("\"jobId\":20"), any()); + } + + @Test + void idempotentReplayReturnsOriginalBeforeCurrentJobStatusGate() { + commonSetup(); + publishedJob.setStatus("DRAFT"); + TalentInvitation existing = TalentInvitation.builder().id(77L).companyId(10L).jobId(20L) + .candidateKeyDigest(sha256("candidate-key")).message("欢迎了解岗位") + .status(TalentInvitation.PENDING).idempotencyKey("3c989a31-6774-4520-9700-e58416cc1847").build(); + when(invitationRepository.findByCompanyIdAndIdempotencyKey(10L, existing.getIdempotencyKey())).thenReturn(Optional.of(existing)); + var response = service.create(1L, 20L, + request("candidate-key", "欢迎了解岗位", existing.getIdempotencyKey()), null); + assertThat(response.getInvitationId()).isEqualTo(77L); + verifyNoInteractions(candidateResolver, moderationService); + } + + @Test + void nonPositiveJobId_isBadRequestBeforeAnyLookup() { + assertThatThrownBy(() -> service.create(1L, 0L, + request("candidate-key", "欢迎了解岗位", "3c989a31-6774-4520-9700-e58416cc1850"), null)) + .isInstanceOf(BusinessException.class) + .extracting("errorCode").isEqualTo(ErrorCode.BAD_REQUEST.getCode()); + verifyNoInteractions(userRepository, companyRepository, jobRepository, invitationRepository); + } + + private String sha256(String value) { + try { + byte[] bytes = java.security.MessageDigest.getInstance("SHA-256").digest(value.getBytes(java.nio.charset.StandardCharsets.UTF_8)); + StringBuilder result = new StringBuilder(); + for (byte b : bytes) result.append(String.format("%02x", b)); + return result.toString(); + } catch (Exception e) { throw new AssertionError(e); } + } +} diff --git a/mydreamjob-server/src/test/java/com/mydreamjob/verification/CompanyVerificationServiceTest.java b/mydreamjob-server/src/test/java/com/mydreamjob/verification/CompanyVerificationServiceTest.java index c584542..b8260ea 100644 --- a/mydreamjob-server/src/test/java/com/mydreamjob/verification/CompanyVerificationServiceTest.java +++ b/mydreamjob-server/src/test/java/com/mydreamjob/verification/CompanyVerificationServiceTest.java @@ -4,6 +4,8 @@ import com.mydreamjob.audit.AuditContext; import com.mydreamjob.audit.AuditService; import com.mydreamjob.auth.User; import com.mydreamjob.auth.UserRepository; +import com.mydreamjob.security.UserRoleGuard; +import com.mydreamjob.common.r01b.UserRoleGuardTestSupport; import com.mydreamjob.common.exception.BusinessException; import com.mydreamjob.common.exception.ErrorCode; import com.mydreamjob.company.Company; @@ -37,6 +39,9 @@ class CompanyVerificationServiceTest { @Mock private AuditService auditService; @Mock private EntityManager entityManager; + /** R01-B/B1：角色授权已委托给公共 guard；此处以委托桩保持既有断言语义。 */ + @Mock + private UserRoleGuard userRoleGuard; @InjectMocks private CompanyVerificationService verificationService; @@ -51,6 +56,9 @@ class CompanyVerificationServiceTest { @BeforeEach void setUp() { + // R01-B/B1：让 guard 桩委托真实实现，保持既有 403/404 断言不变。 + UserRoleGuardTestSupport.delegateToRealGuard(userRoleGuard, userRepository); + company = Company.builder().id(companyId).ownerUserId(companyUserId) .name("测试企业").verified(false).build(); companyUser = User.builder().id(companyUserId).roles(Set.of(User.Role.COMPANY)).build(); diff --git a/mydreamjob-server/src/test/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/mydreamjob-server/src/test/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..64e551a --- /dev/null +++ b/mydreamjob-server/src/test/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +com.mydreamjob.auth.support.TestAuthTokensAutoConfiguration diff --git a/mydreamjob-server/src/test/resources/ability-question-bank-v0.1.json b/mydreamjob-server/src/test/resources/ability-question-bank-v0.1.json new file mode 100644 index 0000000..e70f2da --- /dev/null +++ b/mydreamjob-server/src/test/resources/ability-question-bank-v0.1.json @@ -0,0 +1,1064 @@ +{ + "bankCode": "WORKPLACE_ABILITY", + "bankVersion": "ability-v0.1", + "status": "LOCKED_FOR_IMPLEMENTATION", + "disclaimer": "本题库为自研工作情境题，用于自我了解和能力提升参考，不构成职业资格、正式招聘结论或永久能力标签。", + "questions": [ + { + "questionCode": "LO01", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "销售报表显示本月销售额增长20%，财务报表只增长8%。你首先会怎么处理？", + "options": [ + {"optionId": "A", "text": "核对两份报表的统计口径、时间范围和原始数据来源"}, + {"optionId": "B", "text": "先取两个增长率的平均值作为汇报结果"}, + {"optionId": "C", "text": "先使用财务报表，并注明另一份报表存在差异"}, + {"optionId": "D", "text": "采用增长率较高的报表，因为结果更积极"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 1, "C": 2, "D": 0}, + "explanation": "冲突数据应先统一口径并追溯原始来源。直接平均、择一或选择有利结果都会掩盖真正的数据问题。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 1 + }, + { + "questionCode": "LO02", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "一项新页面的转化率从10%升到18%，但目前只有20名访问者。你会如何判断效果？", + "options": [ + {"optionId": "A", "text": "立即宣布新页面显著优于旧页面"}, + {"optionId": "B", "text": "扩大样本并与同口径对照组比较后再判断"}, + {"optionId": "C", "text": "继续观察，同时先把18%作为确定结论汇报"}, + {"optionId": "D", "text": "说明样本较小，只能给出暂定趋势而非确定结论"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 1, "D": 2}, + "explanation": "小样本波动较大，应扩大样本并设置可比基线。仅提示不确定性有价值，但仍不足以验证变化是否来自页面本身。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 2 + }, + { + "questionCode": "LO03", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "两份分析报告得出相反结论。以下哪组核查顺序最合理？", + "options": [ + {"optionId": "A", "text": "比较结论→询问作者→补充少量数据→决定采用哪份"}, + {"optionId": "B", "text": "选择更新的报告→删除旧报告→通知相关人员→结束核查"}, + {"optionId": "C", "text": "统一指标定义→核对原始数据→比较分析方法→复算并形成结论"}, + {"optionId": "D", "text": "先复算结果→再确认口径→挑选更可信作者→形成结论"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "先统一定义，再核查数据和方法，最后复算，才能避免在不同口径上比较结论。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 3 + }, + { + "questionCode": "LO04", + "dimension": "LOGIC", + "competencyTag": "INFORMATION_ANALYSIS", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "必须当天决定是否上线，但关键用户数据尚未收齐。你会怎么做？", + "options": [ + {"optionId": "A", "text": "直接按个人经验上线，后续再看结果"}, + {"optionId": "B", "text": "延期所有工作，直到全部信息完整"}, + {"optionId": "C", "text": "让职位最高的人直接给出判断"}, + {"optionId": "D", "text": "列明已知、未知和关键假设，选择可回滚的小范围方案并设置观察指标"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "信息不完整时应显式管理不确定性，并优先选择可回滚、可观察的决策，控制错误成本。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 4 + }, + { + "questionCode": "LO05", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "促销活动上线后订单增长了25%。如何判断增长是否主要由活动带来？", + "options": [ + {"optionId": "A", "text": "比较同期趋势、对照群体并排查价格和流量等同时变化因素"}, + {"optionId": "B", "text": "活动和增长同时发生，因此可以判断活动有效"}, + {"optionId": "C", "text": "查看几条参与活动用户的正面反馈"}, + {"optionId": "D", "text": "只比较活动前一天和活动后一天订单量"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "时间上的同时发生不等于因果关系。对照、趋势和混杂因素核查能更可靠地识别活动贡献。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 5 + }, + { + "questionCode": "LO06", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "系统发布新版本后出现大量错误。最合适的第一步是什么？", + "options": [ + {"optionId": "A", "text": "同时修改多个可疑模块，争取尽快碰到正确修复"}, + {"optionId": "B", "text": "先控制影响并保留日志，再对比发布前后变化定位原因"}, + {"optionId": "C", "text": "立即回滚，但不保留现场信息"}, + {"optionId": "D", "text": "等待更多用户反馈后再开始处理"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "先止损并保存证据，再围绕版本变化定位原因，既控制业务影响，也避免破坏根因分析条件。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 6 + }, + { + "questionCode": "LO07", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "数据显示加班时间越长的团队交付量越高。你会怎样解释？", + "options": [ + {"optionId": "A", "text": "说明加班一定能提升团队效率"}, + {"optionId": "B", "text": "建议所有团队立即增加加班时间"}, + {"optionId": "C", "text": "检查项目规模、人员数量和紧急程度等共同影响因素"}, + {"optionId": "D", "text": "先承认存在相关性，但暂不据此做因果决策"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "交付量和加班可能同时受到项目规模等因素影响。相关性需要结合混杂因素和对照数据解释。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 7 + }, + { + "questionCode": "LO08", + "dimension": "LOGIC", + "competencyTag": "CAUSAL_REASONING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "你要验证“缩短注册表单能提高完成率”。哪组步骤最合理？", + "options": [ + {"optionId": "A", "text": "修改表单→全量上线→观察总注册量→询问用户感受"}, + {"optionId": "B", "text": "提出假设→直接上线→发现变化→补写指标定义"}, + {"optionId": "C", "text": "观察历史数据→修改多个流程→比较前后总量→形成结论"}, + {"optionId": "D", "text": "定义指标→设置随机对照→只改变表单长度→达到样本量后分析"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "明确指标、设置对照并控制唯一变量，是验证页面变化与转化率之间因果关系的基本路径。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 8 + }, + { + "questionCode": "LO09", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你收到“把这个页面做得更好用”的任务。首先应该做什么？", + "options": [ + {"optionId": "A", "text": "明确目标用户、具体场景、当前问题和验收标准"}, + {"optionId": "B", "text": "先按常见设计规范修改一版"}, + {"optionId": "C", "text": "只询问对方喜欢什么颜色和布局"}, + {"optionId": "D", "text": "等待对方给出完整解决方案"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "模糊需求应先转化为用户、场景、问题和验收条件，之后才能选择合适的实现方案。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 9 + }, + { + "questionCode": "LO10", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "面对一个复杂而陌生的问题，哪组处理顺序最合理？", + "options": [ + {"optionId": "A", "text": "寻找现成答案→直接实施→发现问题→再定义目标"}, + {"optionId": "B", "text": "明确目标→拆分子问题→确定输入输出→逐项验证并整合"}, + {"optionId": "C", "text": "先处理最熟悉部分→逐步扩大范围→最后确认是否解决目标"}, + {"optionId": "D", "text": "先写完整长方案→交给他人执行→根据反馈决定是否验证"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "复杂问题需要先明确目标，再拆解和定义验证条件，避免局部工作很多却没有解决核心问题。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 10 + }, + { + "questionCode": "LO11", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你提出的方案试运行后没有达到目标。下一步最合理的是？", + "options": [ + {"optionId": "A", "text": "继续扩大使用范围，以获得更多结果"}, + {"optionId": "B", "text": "认为执行人员没有严格遵循方案"}, + {"optionId": "C", "text": "对照预期与实际，检查假设、执行偏差和外部因素后再调整"}, + {"optionId": "D", "text": "先暂停扩大，并收集失败环节的数据"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "方案无效时需要同时检查假设、执行和环境，而不是只扩大范围或归责于某一方。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 11 + }, + { + "questionCode": "LO12", + "dimension": "LOGIC", + "competencyTag": "PROBLEM_SOLVING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "负责人要求估算一个尚未完全明确的任务工期。你会如何回答？", + "options": [ + {"optionId": "A", "text": "给出一个大致天数，并说明只是个人感觉"}, + {"optionId": "B", "text": "拒绝估算，等所有需求完全确定"}, + {"optionId": "C", "text": "参考类似任务，直接承诺相同工期"}, + {"optionId": "D", "text": "拆分已知范围，说明假设、区间、风险以及需要补充的信息"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "在不确定条件下，区间估算加上假设和风险说明，比伪精确承诺或完全拒绝估算更可执行。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 12 + }, + { + "questionCode": "CO01", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "对方提出一个比较模糊的合作需求。你首先会怎么回应？", + "options": [ + {"optionId": "A", "text": "用自己的话复述理解，并确认目标、对象、边界和优先级"}, + {"optionId": "B", "text": "根据过往经验直接开始准备方案"}, + {"optionId": "C", "text": "发送一份通用需求模板，请对方有空时补充"}, + {"optionId": "D", "text": "要求对方想清楚全部细节后再来沟通"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "复述与确认能够尽早暴露理解偏差，同时帮助双方把模糊表达转化为共同目标和边界。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 13 + }, + { + "questionCode": "CO02", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "同事正在说明一次工作失误及其困难。你最合适的做法是？", + "options": [ + {"optionId": "A", "text": "马上告诉对方正确做法，避免继续浪费时间"}, + {"optionId": "B", "text": "先听完并复述关键事实、影响和对方需要的支持"}, + {"optionId": "C", "text": "先听取主要内容，再提出自己的解决建议"}, + {"optionId": "D", "text": "保持沉默，让对方自己整理清楚"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "先完整理解事实和需求，再讨论方案，能避免把建议建立在错误假设上，也能降低对方的防御感。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 14 + }, + { + "questionCode": "CO03", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "三方对同一需求理解不同。哪组沟通顺序最合理？", + "options": [ + {"optionId": "A", "text": "各自发言→多数表决→记录结果→开始执行"}, + {"optionId": "B", "text": "负责人定调→其他人补充→形成文档→会后再澄清"}, + {"optionId": "C", "text": "分别复述理解→识别分歧点→对齐目标和证据→确认决定与责任"}, + {"optionId": "D", "text": "收集意见→整理共同点→由负责人决定→通知执行人员"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "先让各方显式表达理解，再定位分歧并对齐依据，才能形成真正一致且可执行的结论。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 15 + }, + { + "questionCode": "CO04", + "dimension": "COMMUNICATION", + "competencyTag": "LISTENING_UNDERSTANDING", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "客户表达不满，但没有明确说明具体问题。你会怎么做？", + "options": [ + {"optionId": "A", "text": "先说明团队已经严格按流程完成工作"}, + {"optionId": "B", "text": "请客户提交正式投诉材料后再处理"}, + {"optionId": "C", "text": "直接提供补偿，尽快结束沟通"}, + {"optionId": "D", "text": "确认客户感受，再询问具体场景、期望和造成的影响"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "先确认感受并提取具体事实，有助于把情绪表达转化为可以处理的问题和期望。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 16 + }, + { + "questionCode": "CO05", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你需要向非技术同事解释一次系统故障。最合适的方式是？", + "options": [ + {"optionId": "A", "text": "先讲业务影响和处理进展，再用通俗类比说明原因并确认理解"}, + {"optionId": "B", "text": "完整说明技术栈、日志和异常调用链"}, + {"optionId": "C", "text": "只说系统有问题，修好后再通知"}, + {"optionId": "D", "text": "省略不确定性，给出一个肯定恢复时间"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "面向非技术对象应从其关心的影响和行动出发，用适当语言说明原因，同时保留必要的不确定性。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 17 + }, + { + "questionCode": "CO06", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "发送一条需要对方行动的重要工作消息，应该如何组织？", + "options": [ + {"optionId": "A", "text": "只写“请尽快处理”，减少阅读时间"}, + {"optionId": "B", "text": "说明背景、当前问题、所需行动、负责人和截止时间"}, + {"optionId": "C", "text": "先给结论和行动要求，再附上必要背景"}, + {"optionId": "D", "text": "把全部聊天记录转发过去，让对方自行理解"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "清晰的工作消息应让接收者迅速知道为什么、做什么、谁负责以及何时完成。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 18 + }, + { + "questionCode": "CO07", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你需要指出同事提交材料中的严重问题。怎样表达最有效？", + "options": [ + {"optionId": "A", "text": "直接说“你做事不够认真”"}, + {"optionId": "B", "text": "只修改材料，不再提及问题"}, + {"optionId": "C", "text": "描述具体问题、造成的影响、修改标准和可获得的支持"}, + {"optionId": "D", "text": "私下指出具体错误，并提醒以后注意"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "高质量反馈针对可观察行为和影响，并给出明确标准与支持，不把问题上升为人格评价。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 19 + }, + { + "questionCode": "CO08", + "dimension": "COMMUNICATION", + "competencyTag": "STRUCTURED_EXPRESSION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "汇报一个延期项目时，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "说明困难→解释原因→请求理解→承诺尽快完成"}, + {"optionId": "B", "text": "汇报已完成工作→省略延期风险→等待追问→再解释"}, + {"optionId": "C", "text": "说明延期→列出责任方→描述过程→等待负责人决定"}, + {"optionId": "D", "text": "先报结论和影响→说明原因与证据→给出方案→明确需要的决定"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "延期汇报应优先呈现事实和影响，再提供可验证原因、解决方案和明确决策请求。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 20 + }, + { + "questionCode": "CO09", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你与同事对方案选择意见相反。你会如何推进？", + "options": [ + {"optionId": "A", "text": "先确认共同目标，再区分事实与偏好，用统一标准比较方案"}, + {"optionId": "B", "text": "请更多同事投票，按人数决定"}, + {"optionId": "C", "text": "暂时接受对方方案，避免影响关系"}, + {"optionId": "D", "text": "重点证明自己的方案更专业"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "以共同目标和一致评价标准处理分歧，能够把立场冲突转化为可比较的方案决策。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 21 + }, + { + "questionCode": "CO10", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "跨团队依赖已经延期。哪种沟通方式最合理？", + "options": [ + {"optionId": "A", "text": "在公共群指出对方延期→要求承诺→抄送负责人→等待结果"}, + {"optionId": "B", "text": "确认事实和影响→了解阻塞→共同制定新节点→记录责任和升级条件"}, + {"optionId": "C", "text": "先私下询问进度→协商新时间→定期跟进"}, + {"optionId": "D", "text": "自行绕过依赖→完成后再告知对方"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "跨团队协作需要共同确认事实、阻塞和新承诺，并提前约定何时升级，避免指责或信息缺失。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 22 + }, + { + "questionCode": "CO11", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "同事临时要求你承担一项会影响原计划的工作。你会怎么回应？", + "options": [ + {"optionId": "A", "text": "直接答应，之后再想办法补原任务"}, + {"optionId": "B", "text": "直接拒绝，因为这不属于原计划"}, + {"optionId": "C", "text": "说明当前承诺和影响，确认优先级并提出替代时间或资源方案"}, + {"optionId": "D", "text": "先了解紧急程度，再决定是否帮助"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "边界沟通既要说明已有承诺，也要讨论优先级和替代方案，避免无条件接受或简单拒绝。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 23 + }, + { + "questionCode": "CO12", + "dimension": "COMMUNICATION", + "competencyTag": "COLLABORATION_CONFLICT", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你发现自己的表达让对方产生了误解。最合适的处理方式是？", + "options": [ + {"optionId": "A", "text": "详细解释当时为什么会那样表达"}, + {"optionId": "B", "text": "不再提及，避免让情况更尴尬"}, + {"optionId": "C", "text": "先做出对方希望的承诺，之后再调整"}, + {"optionId": "D", "text": "承认造成的影响，澄清真实意图并共同确认修正行动"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "修复误解应同时处理影响、意图和后续行动，而不是只解释动机或给出无法兑现的承诺。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 24 + }, + { + "questionCode": "EX01", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "三个任务都临近截止时间，但现有资源只能优先完成一个。你会怎么做？", + "options": [ + {"optionId": "A", "text": "按业务影响、紧急程度和依赖关系排序，并同步取舍方案"}, + {"optionId": "B", "text": "三个任务同时开始，尽量都推进一些"}, + {"optionId": "C", "text": "先完成最容易交付的任务"}, + {"optionId": "D", "text": "等待负责人主动指定优先级"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "资源冲突时应基于影响、时效和依赖做明确取舍，并让相关方及时知道后果和安排。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 25 + }, + { + "questionCode": "EX02", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "开始一个跨两周的新任务时，你首先会建立什么？", + "options": [ + {"optionId": "A", "text": "一份尽可能详细、覆盖所有可能情况的计划"}, + {"optionId": "B", "text": "明确交付结果、关键步骤、依赖、负责人和检查节点"}, + {"optionId": "C", "text": "先确定最终期限和几个主要步骤"}, + {"optionId": "D", "text": "先从最熟悉的部分开始，再逐步补计划"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "可执行计划要连接目标、步骤、依赖、责任与检查点，既能推进，也能尽早发现偏差。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 26 + }, + { + "questionCode": "EX03", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "需求范围比预计大，但截止日期没有变化。你会怎样处理？", + "options": [ + {"optionId": "A", "text": "保持原计划，靠加班完成新增范围"}, + {"optionId": "B", "text": "先完成原范围，新增部分到期后再解释"}, + {"optionId": "C", "text": "评估新增工作量和影响，提出范围、资源或时间的取舍方案"}, + {"optionId": "D", "text": "记录需求变化，并提醒负责人可能延期"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "范围、资源和时间相互制约。范围变化后应量化影响并推动明确取舍，而不是默默承担风险。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 27 + }, + { + "questionCode": "EX04", + "dimension": "EXECUTION", + "competencyTag": "PLANNING_PRIORITIZATION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "把一个目标转成可执行计划，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "列任务→安排人员→确定目标→检查结果"}, + {"optionId": "B", "text": "确定期限→开始执行→补充资源→最后验收"}, + {"optionId": "C", "text": "选择工具→分配任务→同步进度→根据结果调整目标"}, + {"optionId": "D", "text": "明确结果→拆分任务→识别依赖和风险→设置节点与验收标准"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "计划应从结果出发，再拆解任务、依赖、风险和验收节点，保证每一步都服务于最终目标。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 28 + }, + { + "questionCode": "EX05", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你发现一个依赖项可能导致项目延期。你会怎么管理这项风险？", + "options": [ + {"optionId": "A", "text": "记录触发条件、概率、影响、负责人和应对方案，并持续检查"}, + {"optionId": "B", "text": "在周会上提醒一次，让大家注意"}, + {"optionId": "C", "text": "先准备一个备用方案，但暂不告诉其他人"}, + {"optionId": "D", "text": "等风险真正发生后再处理，避免过度反应"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "风险管理需要可观察的触发条件、责任人和预案，并持续跟踪，而不只是一次提醒或被动等待。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 29 + }, + { + "questionCode": "EX06", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你的任务被另一个团队阻塞，且已经影响当前节点。你会怎么做？", + "options": [ + {"optionId": "A", "text": "绕开对方直接修改其负责内容"}, + {"optionId": "B", "text": "说明阻塞事实和影响，提出备选方案并约定升级时间"}, + {"optionId": "C", "text": "持续跟进对方进度，同时调整自己可先做的工作"}, + {"optionId": "D", "text": "记录阻塞，等负责人下次检查时再汇报"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "处理阻塞不仅要跟进，还要透明说明影响、准备替代路径并约定升级条件，防止风险继续扩大。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 30 + }, + { + "questionCode": "EX07", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "项目进度看似正常，但关键任务一直没有可验证产出。你会怎么处理？", + "options": [ + {"optionId": "A", "text": "继续相信负责人汇报，避免打断执行"}, + {"optionId": "B", "text": "增加每日进度汇报次数"}, + {"optionId": "C", "text": "把关键任务拆成可验收的小节点，用产出和风险重新评估进度"}, + {"optionId": "D", "text": "要求负责人尽快提供一个演示版本"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "进度应由可验证产出而非主观百分比衡量。拆成小节点可以提前暴露真实偏差和风险。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 31 + }, + { + "questionCode": "EX08", + "dimension": "EXECUTION", + "competencyTag": "RISK_FOLLOWUP", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "线上发生严重故障时，哪组执行顺序最合理？", + "options": [ + {"optionId": "A", "text": "查找根因→修改代码→通知用户→恢复服务"}, + {"optionId": "B", "text": "重启服务→观察结果→继续修改→故障后补记录"}, + {"optionId": "C", "text": "通知负责人→等待决定→组织排查→发布修复"}, + {"optionId": "D", "text": "控制影响→保留证据→同步状态→恢复服务→复盘根因"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "故障处置首先控制影响，同时保留分析证据并保持信息同步；恢复后再完成系统性根因复盘。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 32 + }, + { + "questionCode": "EX09", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "截止时间临近，但交付物仍存在质量风险。你会怎么处理？", + "options": [ + {"optionId": "A", "text": "识别关键质量门槛，缩小非核心范围，分阶段交付并同步风险"}, + {"optionId": "B", "text": "优先保证所有功能完成，测试可以之后补"}, + {"optionId": "C", "text": "继续优化细节，必要时到期后再解释"}, + {"optionId": "D", "text": "直接推迟交付，直到所有问题完全解决"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 0, "C": 1, "D": 2}, + "explanation": "临近截止时间应守住关键质量底线，并通过范围取舍和分阶段交付透明管理风险。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 33 + }, + { + "questionCode": "EX10", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "向他人交接一项进行中的任务，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "发送文件→说明截止日期→让对方有问题再问→退出任务"}, + {"optionId": "B", "text": "说明目标和现状→移交材料与风险→明确责任和节点→确认对方理解"}, + {"optionId": "C", "text": "口头说明主要事项→发送材料→约定一次后续检查"}, + {"optionId": "D", "text": "把任务重新做一遍→整理文件→通知对方结果"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "有效交接需要共同理解目标、现状、材料、风险、责任和检查节点，而不仅是发送文件。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 34 + }, + { + "questionCode": "EX11", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "任务完成后结果没有达到预期。最有价值的复盘方式是？", + "options": [ + {"optionId": "A", "text": "确定主要责任人并避免再次由其负责"}, + {"optionId": "B", "text": "记录最终结果，提醒团队以后更认真"}, + {"optionId": "C", "text": "比较目标与实际，分析过程证据，形成有负责人和期限的改进动作"}, + {"optionId": "D", "text": "讨论主要问题并总结经验，供下次参考"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "复盘的价值在于从证据中找到可改变因素，并把经验转成有负责人和期限的行动。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 35 + }, + { + "questionCode": "EX12", + "dimension": "EXECUTION", + "competencyTag": "DELIVERY_REVIEW", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "开发工作已经完成，怎样才算真正完成交付闭环？", + "options": [ + {"optionId": "A", "text": "代码已经合并，可以把任务标记完成"}, + {"optionId": "B", "text": "部署完成且没有立即出现错误"}, + {"optionId": "C", "text": "把剩余事项记录在自己的待办中"}, + {"optionId": "D", "text": "按验收标准确认结果，补齐文档、监控、交接和明确遗留项"} + ], + "answerKey": "D", + "scoringRule": {"A": 1, "B": 2, "C": 0, "D": 4}, + "explanation": "完成实现不等于完成交付；验收、文档、运行保障、交接和遗留事项都应形成闭环。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 36 + }, + { + "questionCode": "LE01", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "第一次接触一项工作需要的新工具时，你会怎么开始？", + "options": [ + {"optionId": "A", "text": "明确使用目标，阅读权威入门资料，完成小练习后应用到任务"}, + {"optionId": "B", "text": "先看几个热门视频，再边做边查"}, + {"optionId": "C", "text": "直接在正式任务中尝试，遇到问题再处理"}, + {"optionId": "D", "text": "请熟悉工具的同事替自己完成关键部分"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "目标、可靠资料、小范围练习和真实应用形成完整学习闭环，能兼顾效率和风险。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 37 + }, + { + "questionCode": "LE02", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "网上对同一技术方案存在互相矛盾的观点。你会怎样判断？", + "options": [ + {"optionId": "A", "text": "选择点赞和转发最多的观点"}, + {"optionId": "B", "text": "比较来源、发布时间、证据、适用条件，并做小范围验证"}, + {"optionId": "C", "text": "优先参考官方文档，再结合一项实践案例"}, + {"optionId": "D", "text": "选择与自己原有经验一致的观点"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "可靠判断既需要评价信息来源和适用条件，也需要在自己的场景中验证，而不能只看热度或偏好。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 38 + }, + { + "questionCode": "LE03", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "快速进入一个陌生业务领域，哪组学习顺序最合理？", + "options": [ + {"optionId": "A", "text": "收集大量资料→全部阅读→整理术语→开始参与工作"}, + {"optionId": "B", "text": "跟随一名同事→模仿做法→遇到问题再查资料→形成经验"}, + {"optionId": "C", "text": "明确任务问题→建立基础框架→结合案例实践→用反馈补齐知识"}, + {"optionId": "D", "text": "阅读概览→询问关键术语→尝试一项小任务→继续自学"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "围绕真实问题建立知识框架，再通过实践和反馈迭代，比无目标囤积资料更有效。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 39 + }, + { + "questionCode": "LE04", + "dimension": "LEARNING", + "competencyTag": "INFORMATION_ACQUISITION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你只有两小时了解一个新主题并给出初步建议。你会怎么安排？", + "options": [ + {"optionId": "A", "text": "尽量阅读更多文章，以覆盖所有观点"}, + {"optionId": "B", "text": "询问熟悉主题的人并直接采用其建议"}, + {"optionId": "C", "text": "先写出自己的看法，再搜索资料验证"}, + {"optionId": "D", "text": "明确输出问题，优先权威概览和关键证据，并标明未知与后续验证项"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "时间有限时，应围绕输出目标选择高价值信息，并明确区分结论、假设和待验证内容。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 40 + }, + { + "questionCode": "LE05", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你收到“方案不够清晰”的反馈。最有效的回应是？", + "options": [ + {"optionId": "A", "text": "请对方指出具体难以理解之处，修改后再次确认是否解决"}, + {"optionId": "B", "text": "详细解释自己当时的设计思路"}, + {"optionId": "C", "text": "接受反馈，并在下一次方案中注意"}, + {"optionId": "D", "text": "找其他同事判断这条反馈是否合理"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "将模糊反馈转化为具体例子，并通过修改后的再次验证，才能真正形成可观察的学习改进。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 41 + }, + { + "questionCode": "LE06", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "一次重要尝试失败后，你最应该优先做什么？", + "options": [ + {"optionId": "A", "text": "立即换一种完全不同的方法重新尝试"}, + {"optionId": "B", "text": "还原目标、过程和关键决策，区分假设错误、执行偏差与外部因素"}, + {"optionId": "C", "text": "先记录失败现象和可能原因，再选择一个方向验证"}, + {"optionId": "D", "text": "等待更多类似失败出现后一起复盘"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "有效复盘需要还原过程并区分不同原因类型，避免在没有证据时只更换方法或延后学习。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 42 + }, + { + "questionCode": "LE07", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "怎样最能验证自己真正掌握了一项新知识？", + "options": [ + {"optionId": "A", "text": "能够完整复述资料中的定义"}, + {"optionId": "B", "text": "完成课程并通过课程自带的小测"}, + {"optionId": "C", "text": "能用自己的话解释、应用到新问题，并根据结果修正理解"}, + {"optionId": "D", "text": "尝试向别人讲解，并接受对方提问"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "真正掌握不仅是记忆，还包括解释、迁移、实践和基于结果修正认知。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 43 + }, + { + "questionCode": "LE08", + "dimension": "LEARNING", + "competencyTag": "FEEDBACK_REFLECTION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "根据反馈持续改进一项技能，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "收集反馈→一次修改全部问题→长期练习→最终检查"}, + {"optionId": "B", "text": "确定目标→大量练习→请人评价→记录结果"}, + {"optionId": "C", "text": "模仿优秀示例→反复练习→比较差距→继续模仿"}, + {"optionId": "D", "text": "设定具体目标→刻意练习→获得反馈→调整方法并再次验证"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "学习闭环应围绕具体目标，通过练习、反馈、调整和再验证不断缩小差距。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 44 + }, + { + "questionCode": "LE09", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "学会一种分析方法后，你遇到一个相似但条件不同的新问题。你会怎么做？", + "options": [ + {"optionId": "A", "text": "识别共同原理和条件差异，调整方法并用结果验证"}, + {"optionId": "B", "text": "先按原步骤完整执行，再根据结果修改"}, + {"optionId": "C", "text": "重新寻找专门针对新问题的现成方法"}, + {"optionId": "D", "text": "认为条件不同，原方法没有参考价值"} + ], + "answerKey": "A", + "scoringRule": {"A": 4, "B": 2, "C": 1, "D": 0}, + "explanation": "知识迁移的关键是识别稳定原理与变化条件，并通过调整和验证把旧知识应用到新场景。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 45 + }, + { + "questionCode": "LE10", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你遇到一个自己长时间无法解决的问题，需要向同事求助。怎样提问最有效？", + "options": [ + {"optionId": "A", "text": "把全部材料发给对方，请对方帮忙看看"}, + {"optionId": "B", "text": "说明目标、现象、已尝试方法、当前判断和希望获得的帮助"}, + {"optionId": "C", "text": "整理出最小问题、错误信息和已排除项后提问"}, + {"optionId": "D", "text": "直接请对方演示正确做法，自己跟着学习"} + ], + "answerKey": "B", + "scoringRule": {"A": 0, "B": 4, "C": 2, "D": 1}, + "explanation": "高质量求助能让对方快速理解上下文，也暴露自己的思考过程，从而获得可迁移的指导而非代做。", + "difficulty": "MEDIUM", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 46 + }, + { + "questionCode": "LE11", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SITUATIONAL_JUDGMENT", + "stem": "你熟悉的工具即将停止维护，团队需要迁移到新工具。你会怎么应对？", + "options": [ + {"optionId": "A", "text": "继续使用旧工具，直到它真正无法运行"}, + {"optionId": "B", "text": "立即把所有工作迁移到最热门的新工具"}, + {"optionId": "C", "text": "比较需求和迁移成本，做小范围验证，形成学习与分阶段迁移计划"}, + {"optionId": "D", "text": "先试用几个候选工具并记录主要差异"} + ], + "answerKey": "C", + "scoringRule": {"A": 1, "B": 0, "C": 4, "D": 2}, + "explanation": "面对变化应结合实际需求、成本和验证结果规划迁移，同时安排学习，避免被动拖延或盲目追新。", + "difficulty": "HARD", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 47 + }, + { + "questionCode": "LE12", + "dimension": "LEARNING", + "competencyTag": "TRANSFER_ADAPTATION", + "itemType": "SEQUENCE_JUDGMENT", + "stem": "制定一项与目标岗位相关的学习计划，哪组顺序最合理？", + "options": [ + {"optionId": "A", "text": "购买课程→安排时间→完成课程→更新简历"}, + {"optionId": "B", "text": "收集热门技能→选择感兴趣内容→集中学习→寻找应用机会"}, + {"optionId": "C", "text": "参考他人路线→复制学习清单→定期检查完成量→继续补课"}, + {"optionId": "D", "text": "分析岗位要求和当前差距→设定可验证目标→练习应用→根据反馈调整"} + ], + "answerKey": "D", + "scoringRule": {"A": 2, "B": 1, "C": 0, "D": 4}, + "explanation": "有效学习计划从真实目标和差距出发，用可验证练习和反馈调整方向，而不是以课程数量衡量成长。", + "difficulty": "EASY", + "discrimination": null, + "questionVersion": "ability-v0.1", + "source": "SELF_AUTHORED", + "active": true, + "position": 48 + } + ] +} diff --git a/mydreamjob-server/src/test/resources/application-integration-test.yml b/mydreamjob-server/src/test/resources/application-integration-test.yml index 2aa541b..c43bbd0 100644 --- a/mydreamjob-server/src/test/resources/application-integration-test.yml +++ b/mydreamjob-server/src/test/resources/application-integration-test.yml @@ -34,6 +34,10 @@ spring: enabled: false app: + scoring: + refresh: + enabled: false + compensation-enabled: false redis: enabled: false notification: @@ -44,6 +48,9 @@ app: match: notification: enabled: false + risk: + scan: + enabled: false resume: storage-dir: ./target/resumes export-dir: ./target/resume-exports @@ -52,6 +59,9 @@ app: file-ttl-hours: 24 jwt: secret: test-jwt-secret-key-for-integration-tests-only-not-for-production + access-secret: test-access-secret-key-for-integration-tests-only-not-for-production + refresh-secret: test-refresh-secret-key-for-integration-tests-only-not-for-production + token-hash-secret: test-token-hash-secret-key-for-integration-tests-only-not-for-production expiration-ms: 3600000 refresh-expiration-ms: 86400000 sms: diff --git a/mydreamjob-server/src/test/resources/application-mysql-it.yml b/mydreamjob-server/src/test/resources/application-mysql-it.yml new file mode 100644 index 0000000..80d0fdb --- /dev/null +++ b/mydreamjob-server/src/test/resources/application-mysql-it.yml @@ -0,0 +1,59 @@ +# Q01 MySQL 真实层（Testcontainers）测试配置。 +# +# 只提供应用级测试开关与测试专用 JWT 密钥；**不覆盖数据源与 JPA 方言**： +# - 连接参数（URL / 用户名 / 密码）由测试类的 @DynamicPropertySource 注入容器地址； +# - 方言与 ddl-auto 沿用主配置（org.hibernate.dialect.MySQLDialect + validate）。 +# 这样 MySQL 用例与 H2 用例跑在**同一套应用配置**上，仅有数据库实现不同，便于逐项对账。 +# +# 密钥仅用于本地测试，长度 ≥ 32 且三项两两不同，满足 AppJwtProperties 校验。 + +spring: + config: + activate: + on-profile: mysql-it + main: + allow-bean-definition-overriding: true + autoconfigure: + exclude: + - org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration + data: + redis: + enabled: false + rabbitmq: + enabled: false + +app: + scoring: + refresh: + enabled: false + compensation-enabled: false + redis: + enabled: false + notification: + mq-enabled: false + offer: + scheduler: + enabled: false + match: + notification: + enabled: false + risk: + scan: + enabled: false + resume: + storage-dir: ./target/resumes + export-dir: ./target/resume-exports + data-export: + dir: ./target/data-exports + file-ttl-hours: 24 + jwt: + secret: mysql-it-legacy-secret-for-q01-tests-only-0001 + access-secret: mysql-it-access-secret-for-q01-tests-only-0001 + refresh-secret: mysql-it-refresh-secret-for-q01-tests-only-0001 + token-hash-secret: mysql-it-token-hash-secret-for-q01-tests-only-0001 + expiration-ms: 3600000 + refresh-expiration-ms: 86400000 + sms: + mock: + enabled: true + expire-seconds: 300 diff --git a/mydreamjob-server/src/test/resources/application-test.yml b/mydreamjob-server/src/test/resources/application-test.yml index 7666c4b..516062a 100644 --- a/mydreamjob-server/src/test/resources/application-test.yml +++ b/mydreamjob-server/src/test/resources/application-test.yml @@ -20,8 +20,15 @@ spring: enabled: false app: + scoring: + refresh: + enabled: false + compensation-enabled: false jwt: secret: test-jwt-secret-key-for-unit-tests-only-not-for-production + access-secret: test-access-secret-key-for-unit-tests-only-not-for-production + refresh-secret: test-refresh-secret-key-for-unit-tests-only-not-for-production + token-hash-secret: test-token-hash-secret-key-for-unit-tests-only-not-for-production expiration-ms: 3600000 refresh-expiration-ms: 604800000 diff --git a/mydreamjob-server/src/test/resources/r01b/error-code-http-status-baseline.tsv b/mydreamjob-server/src/test/resources/r01b/error-code-http-status-baseline.tsv new file mode 100644 index 0000000..5e418ef --- /dev/null +++ b/mydreamjob-server/src/test/resources/r01b/error-code-http-status-baseline.tsv @@ -0,0 +1,172 @@ +# R01-B 独立复验基线：从 HEAD:GlobalExceptionHandler.buildBusinessHttpStatuses() 独立提取 +# 列: ErrorCode数字码HEAD 状态(未登记则为 400 默认) +# 生成自 git HEAD 版本，与工作区实现无任何共享代码 +SUCCESS 1000 400 +BAD_REQUEST 1001 400 +INTERNAL_ERROR 1002 400 +UNAUTHORIZED 2001 400 +FORBIDDEN 2002 FORBIDDEN +TOKEN_EXPIRED 2003 400 +TOKEN_INVALID 2004 400 +CREDENTIALS_INVALID 2005 UNAUTHORIZED +PASSWORD_RATE_LIMITED 2006 TOO_MANY_REQUESTS +PASSWORD_STATE_CONFLICT 2007 CONFLICT +PASSWORD_POLICY_INVALID 2008 400 +SMS_CODE_SENT 3001 400 +SMS_CODE_EXPIRED 3002 400 +SMS_CODE_INVALID 3003 400 +SMS_CODE_ATTEMPTS_EXCEEDED 3004 400 +SMS_RATE_LIMITED 3005 400 +SMS_SEND_FAILED 3006 400 +USER_NOT_FOUND 4001 NOT_FOUND +USER_ALREADY_EXISTS 4002 400 +USER_DISABLED 4003 400 +COMPANY_NOT_FOUND 5001 NOT_FOUND +COMPANY_OWNER_MISMATCH 5002 400 +COMPANY_ALREADY_EXISTS 5003 CONFLICT +PROFILE_NOT_FOUND 6001 NOT_FOUND +JOB_NOT_FOUND 7001 NOT_FOUND +JOB_OWNER_MISMATCH 7002 400 +INVALID_JOB_STATUS_TRANSITION 7003 CONFLICT +APPLICATION_DUPLICATE 8001 CONFLICT +APPLICATION_NOT_FOUND 8002 NOT_FOUND +INVALID_APPLICATION_STATUS_TRANSITION 8003 CONFLICT +APPLICATION_OWNER_MISMATCH 8004 FORBIDDEN +OFFER_NOT_FOUND 8101 NOT_FOUND +DUPLICATE_OFFER 8102 CONFLICT +INVALID_OFFER_STATUS_TRANSITION 8103 CONFLICT +OFFER_EXPIRED 8104 CONFLICT +OFFER_NOT_EDITABLE 8105 CONFLICT +OFFER_APPLICATION_NOT_ELIGIBLE 8106 400 +OFFER_REMINDER_DUPLICATE 8107 CONFLICT +OFFER_NOT_REMINDABLE 8108 400 +OFFER_COUNTER_OFFER_EXISTS 8109 CONFLICT +OFFER_COUNTER_OFFER_NOT_FOUND 8110 NOT_FOUND +OFFER_COUNTER_OFFER_NOT_PENDING 8111 CONFLICT +OFFER_NOT_WITHDRAWABLE 8112 400 +OFFER_COUNTER_OFFER_EXPIRED 8113 CONFLICT +OFFER_NOT_NEGOTIABLE 8114 400 +OFFER_COMPARE_TOO_MANY 8115 400 +OFFER_COMPARE_NOT_OWNER 8116 FORBIDDEN +RESUME_VERSION_NOT_FOUND 8201 NOT_FOUND +DEFAULT_RESUME_DELETE_NOT_ALLOWED 8202 CONFLICT +RESUME_EXPORT_TASK_NOT_FOUND 8203 NOT_FOUND +RESUME_EXPORT_IN_PROGRESS 8204 CONFLICT +DUPLICATE_DEFAULT_RESUME 8205 CONFLICT +RESUME_EXPORT_NOT_READY 8206 CONFLICT +MATCH_CLOSED 8301 CONFLICT +MATCH_SCORES_LOCKED 8302 CONFLICT +MATCH_REQUIRED_FOR_CONVERSATION 8303 FORBIDDEN +APPLICATION_NOT_MATCHED 8304 CONFLICT +CONVERSATION_NOT_FOUND 8305 NOT_FOUND +MESSAGE_NOT_FOUND 8306 NOT_FOUND +MESSAGE_RECALL_WINDOW_EXPIRED 8307 CONFLICT +MESSAGE_RECALL_CONCURRENT_UPDATE 8308 CONFLICT +DUPLICATE_REVIEW 9101 CONFLICT +REVIEW_NOT_FOUND 9102 NOT_FOUND +REVIEW_ALREADY_DECIDED 9103 CONFLICT +DUPLICATE_FEEDBACK 9103 CONFLICT +FEEDBACK_NOT_FOUND 9104 NOT_FOUND +NOTIFICATION_NOT_FOUND 9105 400 +REVIEW_WEIGHT_CONCURRENT_UPDATE 9106 CONFLICT +INTERVIEW_NOT_FOUND 8401 400 +INTERVIEW_ACCESS_DENIED 8402 FORBIDDEN +INVALID_INTERVIEW_STATUS_TRANSITION 8403 CONFLICT +INTERVIEW_TIME_INVALID 8404 400 +INTERVIEW_DURATION_EXCEEDED 8405 400 +INTERVIEW_ONLINE_URL_REQUIRED 8406 400 +INTERVIEW_OFFLINE_ADDRESS_REQUIRED 8407 400 +INTERVIEW_START_TIME_PAST 8408 400 +INTERVIEW_COMPLETE_NOT_READY 8409 CONFLICT +INTERVIEW_ALREADY_RESPONDED 8410 CONFLICT +VERIFICATION_NOT_FOUND 8501 NOT_FOUND +VERIFICATION_ALREADY_PENDING 8502 CONFLICT +VERIFICATION_ALREADY_APPROVED 8503 CONFLICT +INVALID_VERIFICATION_STATUS_TRANSITION 8504 CONFLICT +VERIFICATION_REJECT_REASON_REQUIRED 8505 400 +APPEAL_NOT_FOUND 8601 NOT_FOUND +APPEAL_DUPLICATE 8602 CONFLICT +APPEAL_ALREADY_DECIDED 8603 CONFLICT +APPEAL_REASON_REQUIRED 8604 400 +APPEAL_ROLLBACK_LIMIT_EXCEEDED 8605 CONFLICT +APPEAL_INVALID_TRANSITION 8606 CONFLICT +APPEAL_IDEMPOTENCY_CONFLICT 8607 CONFLICT +SERVICE_UNAVAILABLE 9001 400 +RATE_LIMITED 9002 400 +PRIVACY_SETTINGS_CONCURRENT_UPDATE 9201 CONFLICT +INVALID_DELETION_STATE 9301 CONFLICT +ACCOUNT_DELETION_PENDING 9302 CONFLICT +ACCOUNT_DELETED 9303 CONFLICT +ACCOUNT_DELETION_CONCURRENT_UPDATE 9304 CONFLICT +ACCOUNT_DELETION_CANCEL_DEADLINE_PASSED 9305 CONFLICT +LAST_ADMIN_CANNOT_DELETE 9306 CONFLICT +DATA_EXPORT_TASK_NOT_FOUND 9401 NOT_FOUND +DATA_EXPORT_DUPLICATE 9402 CONFLICT +DATA_EXPORT_NOT_READY 9403 CONFLICT +DATA_EXPORT_EXPIRED 9404 CONFLICT +DATA_EXPORT_FAILED 9405 CONFLICT +DATA_EXPORT_FILE_NOT_FOUND 9406 CONFLICT +INTERVIEW_SCORE_CONCURRENT_UPDATE 9501 CONFLICT +INTERVIEW_NOT_COMPLETED 9502 CONFLICT +INTERVIEW_SCORE_SUBMITTED 9503 CONFLICT +INTERVIEW_SCORE_NOT_FOUND 9504 NOT_FOUND +REPORT_NOT_FOUND 9601 NOT_FOUND +CANNOT_REPORT_SELF 9602 400 +REPORT_DUPLICATE 9603 CONFLICT +REPORT_ALREADY_DECIDED 9604 CONFLICT +REPORT_INVALID_TRANSITION 9605 CONFLICT +REPORT_IDEMPOTENCY_CONFLICT 9606 CONFLICT +REPORT_REASON_REQUIRED 9607 400 +CANNOT_BLOCK_SELF 9608 400 +REPORT_RATE_LIMITED 9609 TOO_MANY_REQUESTS +BLOCKED_SEND_PROHIBITED 9610 400 +ASSESSMENT_TYPE_NOT_FOUND 9701 NOT_FOUND +ASSESSMENT_ATTEMPT_NOT_FOUND 9702 NOT_FOUND +ASSESSMENT_ATTEMPT_INVALID_STATE 9703 CONFLICT +ASSESSMENT_ANSWER_INVALID 9705 400 +ASSESSMENT_INCOMPLETE 9706 400 +ASSESSMENT_CONCURRENT_UPDATE 9707 CONFLICT +ASSESSMENT_DUPLICATE_ACTIVE 9708 CONFLICT +ASSESSMENT_IDEMPOTENCY_CONFLICT 9709 CONFLICT +ABILITY_TYPE_NOT_FOUND 9801 NOT_FOUND +ABILITY_ATTEMPT_NOT_FOUND 9802 NOT_FOUND +ABILITY_ATTEMPT_INVALID_STATE 9803 CONFLICT +ABILITY_RESULT_NOT_FOUND 9804 NOT_FOUND +ABILITY_ANSWER_INVALID 9805 400 +ABILITY_INCOMPLETE 9806 400 +ABILITY_CONCURRENT_UPDATE 9807 CONFLICT +ABILITY_DUPLICATE_ACTIVE 9808 CONFLICT +ABILITY_IDEMPOTENCY_CONFLICT 9809 CONFLICT +ABILITY_RETAKE_COOLDOWN 9810 CONFLICT +ABILITY_RETAKE_LIMIT 9811 TOO_MANY_REQUESTS +RISK_RULE_NOT_FOUND 9901 NOT_FOUND +RISK_EVENT_NOT_FOUND 9902 NOT_FOUND +RISK_RULE_CONCURRENT_UPDATE 9903 CONFLICT +RISK_EVENT_CONCURRENT_UPDATE 9904 CONFLICT +RISK_INVALID_ACTION 9905 CONFLICT +RISK_INVALID_FILTER 9906 400 +RECOMMENDATION_PROFILE_NOT_FOUND 10001 400 +RECOMMENDATION_PROFILE_INVALID 10002 400 +RECOMMENDATION_PROFILE_CONCURRENT_UPDATE 10003 400 +RECOMMENDATION_INVALID_QUERY 10004 400 +RECOMMENDATION_TAXONOMY_INVALID 10005 400 +RECOMMENDATION_FEEDBACK_CONCURRENT_UPDATE 10006 400 +RECOMMENDATION_FEEDBACK_IDEMPOTENCY_CONFLICT 10007 400 +RECOMMENDATION_FEEDBACK_NOT_FOUND 10008 400 +RECOMMENDATION_PROFILE_INVALID_REVIEW_STATE 10009 400 +REVIEW_REPLY_NOT_FOUND 10101 NOT_FOUND +REVIEW_REPLY_ALREADY_EXISTS 10102 CONFLICT +REVIEW_REPLY_INVALID_STATE 10103 CONFLICT +REVIEW_REPLY_CONCURRENT_UPDATE 10104 CONFLICT +REVIEW_REPLY_CONTENT_INVALID 10105 400 +REVIEW_REPLY_IDEMPOTENCY_CONFLICT 10106 CONFLICT +REVIEW_REPLY_DECISION_INVALID 10107 400 +TALENT_INVITATION_NOT_FOUND 10201 NOT_FOUND +TALENT_INVITATION_CANDIDATE_UNAVAILABLE 10202 CONFLICT +TALENT_INVITATION_ALREADY_ACTIVE 10203 CONFLICT +TALENT_INVITATION_INVALID_STATE 10204 CONFLICT +TALENT_INVITATION_EXPIRED 10205 CONFLICT +TALENT_INVITATION_CONCURRENT_UPDATE 10206 CONFLICT +TALENT_INVITATION_IDEMPOTENCY_CONFLICT 10207 CONFLICT +TALENT_INVITATION_CONTENT_INVALID 10208 400 +TALENT_INVITATION_RATE_LIMITED 10209 TOO_MANY_REQUESTS