# Candidate Scoring Engine 验收记录（版本冻结）

> 日期：2026-08-19 · 状态：✅ **冻结全绿**（旧评分卡 MySQL 缺陷已修复并复验，见 §7）

## 1. 构建与测试
| 项 | 结果 |
|---|---|
| `mvn clean verify` | **869 tests · Failures=0 · Errors=0 · Skipped=0 · BUILD SUCCESS** ✅ |

## 2. Candidate Scoring 黑盒（重跑）
**PASS=25 · FAIL=0 · SKIP=0** ✅
- STUDENT 综合评分卡（8 维、weight 12.50、rulesVersion=candidate-scoring-v0.1、PENDING/INSUFFICIENT score=null）
- 维度明细（EDUCATION 全字段）；非法维度 → 400
- trend months=6（按 period 独立归一化）；months=0/25 → 400
- 企业评分卡（app 31）→ 200，响应仅白名单字段
- 越权：跨企业 403/8004、不存在 404/8002、ADMIN 403/2002、学生接口企业/管理员 403、未登录 401

## 3. 写入隔离
- 评分仅写入 `candidate_dimension_scores`（同周期 upsert、version 递增 5→6）
- jobs/applications/student_profiles/offers/candidate_feedback 行数零改动 ✅

## 4. OpenAPI
- 静态 `docs/openapi-rc.json`：**87 paths**
- 运行时 `/api/v1/v3/api-docs`：**87 paths**，路径集合与静态完全一致 ✅

## 5. Flyway
- 最新成功迁移：**V24（candidate scoring）** ✅
- `candidate_dimension_scores` 表存在，CHECK/唯一约束在位 ✅

## 6. 基础设施
- MySQL / Redis / RabbitMQ healthy；queue.notification / dlq ready=0 unacked=0 ✅
- RabbitMQ 应用连接：修复为使用系统环境变量 `RABBITMQ_VHOST` 被错误覆盖的问题（以 `$env:RABBITMQ_VHOST="/"` 启动后连接正常，无 vhost 报错）✅

## 7. 冻结发现（已修复并复验）
- 旧接口回归曾发现：`/profile/me/candidate-score-card` 在 **MySQL 上返回 HTTP 500**。
- 根因：`CandidateScoreCardService.getScoreCard` 使用 `SELECT CAST(cf.tags AS VARCHAR) ...`，**MySQL 8 不支持 `CAST(... AS VARCHAR)`**（仅 `CHAR`）；H2 支持故单测/构建通过，MySQL 运行时报 `SQLSyntaxErrorException`。
- **已修复**（负责人批准，一行）：`CandidateScoreCardService.java` 第 60 行 `CAST(cf.tags AS VARCHAR)` → `CAST(cf.tags AS CHAR)`。
- **复验结果**：`candidate-score-card` / `-trend` / `-percentile` 三个接口在真实 MySQL 环境均返回 **HTTP 200**；`mvn clean verify` 869 全绿。
- **冻结结论**：✅ **版本冻结宣布为全绿**（详见 §1–§6 与 §8）。

## 8. 备注
- 未修改任何已验收接口语义；未新增 Flyway；未删除业务数据。
- 后端运行方式：`mvn spring-boot:run`（最新构建，环境变量由 backend-infra/.env 注入；Windows 需显式 `$env:RABBITMQ_VHOST="/"`）。

## 9. Release Candidate 检查清单（冻结全绿）
| 检查项 | 值 | 状态 |
|---|---|---|
| `mvn clean verify` | **869 tests · 0 failures · 0 errors · 0 skipped · BUILD SUCCESS** | ✅ |
| Candidate Scoring 黑盒 | **PASS=25 · FAIL=0 · SKIP=0** | ✅ |
| OpenAPI | **87 paths**（静态 `docs/openapi-rc.json` 与运行时 `/v3/api-docs` 集合一致） | ✅ |
| Flyway | 最新 **V24**（candidate scoring） | ✅ |
| Docker | MySQL / Redis / RabbitMQ 均 healthy | ✅ |
| RabbitMQ 队列 | queue.notification、queue.notification.dlq 均 ready=0 unacked=0 | ✅ |
| 旧评分卡回归 | score-card / score-trend / percentile 均 HTTP 200 | ✅ |
| 写入隔离 | 评分仅写 `candidate_dimension_scores`；业务表零改动 | ✅ |