# 联调路径校正映射表（基于 job.youthome.com.cn OpenAPI 实测）

> 生成日期：2026-09-28  |  数据源：`scripts/openapi.json`（182 条真实路径 / 220 path-methods）
> 审计范围：api.ts 内全部 `request()` 调用（89 个函数）
> 结论：ALIGNED（已对齐）= 6，WRONG→REAL（路径错但有真实等价）= 14，PHANTOM（幽灵域，后端无契约）= 69

## 一、已对齐（无需改路径）

| 函数 | 真实路径 | 原标记 |
|---|---|---|
| `createJobReview` | `POST /jobs/{jobId}/reviews` | 已校正 |
| `fetchCompareData` | `/jobs/compare` | 已校正 |
| `fetchEmployeeReviews` | `GET /jobs/{jobId}/reviews` | 已校正 |
| `fetchJobDetail` | `GET /jobs/{jobId}` | 已校正 |
| `fetchOfferCompareData` | `GET /offers/compare` | 【待确认】 |
| `fetchUserProfile` | `GET /profile/me` | 已校正 |

## 二、路径错但有真实等价端点（需改路径）

| 函数 | 当前(错) | 应改为(真实) | 说明 |
|---|---|---|---|
| `fetchCandidateDetail` | `/enterprise/candidates/${candidateId}` | `/company/candidates/{applicationId}` | 前端猜 /enterprise/candidates，真路径在 /company 域 |
| `fetchConversation` | `/chat/conversations/${id}` | `GET /conversations/{id}` | 前端猜 /chat/conversations，真路径 /conversations/{id} |
| `fetchConversations` | `/messages/conversations` | `GET /conversations` | 前端猜 /messages/conversations，真 /conversations |
| `fetchInterviewScore` | `/enterprise/interviews/${interviewId}/score` | `GET /interviews/{interviewId}/score` | 前端猜 /enterprise/interviews，真路径在 /interviews 域 |
| `fetchInterviewScoreDraft` | `/enterprise/interviews/${interviewId}/score/draft` | `PUT /interviews/{interviewId}/score` | 真路径无 /draft 子路径，保存草稿用 PUT /interviews/{id}/score |
| `fetchInterviews` | `/messages/interviews` | `GET /interviews/me` | 前端猜 /messages/interviews，真 /interviews/me(我的面试列表) |
| `fetchJobPreference` | `/profile/me/job-preference` | `GET/PUT /profile/me/preferences` | 前端猜 /profile/me/job-preference，真路径 /profile/me/preferences |
| `fetchJobProgress` | `/tools/job-progress` | `GET /profile/me/career-progress` | 前端猜 /tools/job-progress，真 /profile/me/career-progress(统一求职进度聚合) |
| `fetchMatchResult` | `/messages/match-result` | `GET /applications/{id}/match 或 /jobs/{jobId}/match` | 前端猜 /messages/match-result，真为投递/岗位匹配诊断 |
| `fetchNotifications` | `/messages/notifications` | `GET /notifications` | 前端猜 /messages/notifications，真 /notifications |
| `fetchRankData` | `/jobs/rank` | `GET /jobs/{jobId}/competition-ranking` | 前端猜 /jobs/rank，真为按岗位竞争力排名，语义不同(需 jobId) |
| `fetchResume` | `/resume` | `GET /profile/me/resume` | 前端猜 /resume，真 /profile/me/resume(下载简历) |
| `saveJobPreference` | `/profile/me/job-preference` | `PUT /profile/me/preferences` | 同上 |
| `saveResumeBasicInfo` | `/resume/basic-info` | `POST /profile/me/resume (multipart)` | 前端猜 /resume/basic-info，真为上传简历文件(multipart)，结构化字段在 PUT /profile/me |

## 三、幽灵域（后端 OpenAPI 无契约，必须退回 mock-only）

| 函数 | 当前(幽灵)路径 | 说明 |
|---|---|---|
| `deleteSalaryRecord` | `/salary/records/${id}` | 无 /salary 域，后端未提供 |
| `fetchAIInterviewData` | `/interview/config` | 未命中 OpenAPI |
| `fetchAITools` | `/growth/ai-tools` | 未命中 OpenAPI |
| `fetchAbilityAssessment` | `/growth/ability` | 未命中 OpenAPI |
| `fetchAboutInfo` | `/settings/about` | 未命中 OpenAPI |
| `fetchAccountCancel` | `/settings/account-cancel` | 未命中 OpenAPI |
| `fetchAccountSecurity` | `/settings/account-security` | 未命中 OpenAPI |
| `fetchAppealForm` | `/evaluation/appeal` | 未命中 OpenAPI |
| `fetchArticles` | `/growth/articles` | 未命中 OpenAPI |
| `fetchAuditReport` | `/operation/audit-report` | 未命中 OpenAPI |
| `fetchBadges` | `/user/badges` | 未命中 OpenAPI |
| `fetchDimensionScores` | `/user/dimension-scores` | 未命中 OpenAPI |
| `fetchDndSetting` | `/settings/privacy/dnd` | 未命中 OpenAPI |
| `fetchEnterpriseCertification` | `/enterprise/certification` | 未命中 OpenAPI |
| `fetchEnterpriseCommunication` | `/enterprise/communication` | 未命中 OpenAPI |
| `fetchEnterpriseEntry` | `/user/enterprise-entry` | 未命中 OpenAPI |
| `fetchEnterpriseOverview` | `/enterprise/overview` | 未命中 OpenAPI |
| `fetchGameLevels` | `/game/levels` | 未命中 OpenAPI |
| `fetchGameProgress` | `/game/progress` | 未命中 OpenAPI |
| `fetchHREvaluation` | `/evaluation/hr` | 未命中 OpenAPI |
| `fetchHollandAssessment` | `/growth/holland` | 未命中 OpenAPI |
| `fetchHollandIntro` | `/growth/holland-intro` | 未命中 OpenAPI |
| `fetchIdentityOptions` | `/tools/identity-options` | 未命中 OpenAPI |
| `fetchJobEvaluationEmptyState` | `/enterprise/job-evaluation-empty` | 未命中 OpenAPI |
| `fetchJobEvaluationManagement` | `/enterprise/job-evaluations` | 未命中 OpenAPI |
| `fetchJobManagement` | `/enterprise/job-management` | 未命中 OpenAPI |
| `fetchJobOverallScore` | `/jobs/${id}/score` | 无 /jobs/{id}/score，综合分见 /jobs/{id}/competition-ranking 或 /profile/me/candidate-scoring |
| `fetchJobPublishForm` | `/enterprise/jobs/publish-form` | 未命中 OpenAPI |
| `fetchKeywordBlock` | `/settings/privacy/keywords` | 未命中 OpenAPI |
| `fetchLegalBrand` | `/legal/brand` | 未命中 OpenAPI |
| `fetchLegalConversation` | `/legal/conversations/default` | 未命中 OpenAPI |
| `fetchLegalDocument` | `/settings/legal-document/${id}` | 无 /legal 域，后端未提供 |
| `fetchLegalFAQs` | `/legal/faqs` | 未命中 OpenAPI |
| `fetchLegalMembership` | `/legal/membership` | 未命中 OpenAPI |
| `fetchLegalOrders` | `/legal/orders` | 未命中 OpenAPI |
| `fetchLegalPlans` | `/legal/plans` | 未命中 OpenAPI |
| `fetchLegalServiceRequests` | `/legal/service-requests` | 未命中 OpenAPI |
| `fetchLegalServices` | `/legal/services` | 未命中 OpenAPI |
| `fetchLegalTemplates` | `/legal/templates` | 未命中 OpenAPI |
| `fetchMenuItems` | `/user/menus` | 未命中 OpenAPI |
| `fetchNotificationSettings` | `/settings/notification` | 未命中 OpenAPI |
| `fetchOperationRules` | `/operation/rules` | 未命中 OpenAPI |
| `fetchOverallScore` | `/user/overall-score` | 未命中 OpenAPI |
| `fetchPendingOfferCount` | `/offers/pending/count` | 无 /offers/pending/count，可用 /offers/statistics 替代(需确认) |
| `fetchPersonalDataExport` | `/settings/personal-data-export` | 未命中 OpenAPI |
| `fetchPrivacyCenter` | `/settings/privacy-center` | 未命中 OpenAPI |
| `fetchPrivacyDetailSetting` | `/settings/privacy/${id}` | 无 /settings 域，后端未提供 |
| `fetchPrivacySettings` | `/settings/privacy` | 未命中 OpenAPI |
| `fetchQualifications` | `/settings/qualifications` | 未命中 OpenAPI |
| `fetchResumeExportSettings` | `/resume/export-settings` | 无 /resume/export-settings，导出设置本地维护 |
| `fetchResumeSavedAt` | `/resume/saved-at` | 无 /resume/saved-at，简历保存时间可由 /profile/me/resume-versions 派生 |
| `fetchSalaryBrackets` | `/tools/salary-brackets` | 未命中 OpenAPI |
| `fetchSalaryData` | `/jobs/${id}/salary` | 无 /jobs/{id}/salary，后端未提供薪资明细端点 |
| `fetchSalaryRecords` | `/salary/records` | 未命中 OpenAPI |
| `fetchSalaryToolLinks` | `/tools/salary-related` | 未命中 OpenAPI |
| `fetchSkillCloud` | `/tools/skill-cloud` | 未命中 OpenAPI |
| `fetchSkillLearningPath` | `/tools/skill-learning-path` | 未命中 OpenAPI |
| `fetchTalentRecommendation` | `/enterprise/talent-recommendation` | 未命中 OpenAPI |
| `fetchUserStats` | `/user/stats` | 未命中 OpenAPI |
| `fetchWeightSettings` | `/jobs/weight-settings` | 无 /jobs/weight-settings，权重见 /profile/me/review-weights、/review-weight-templates |
| `saveResumeEducation` | `/resume/education` | 无 /resume/education，简历整体由 /profile/me/resume + resume-versions 管理 |
| `saveResumeExperience` | `/resume/experience` | 同上 |
| `saveResumeExportSettings` | `/resume/export-settings` | 未命中 OpenAPI |
| `saveResumeProjects` | `/resume/projects` | 同上 |
| `saveResumeSelfEvaluation` | `/resume/self-evaluation` | 同上 |
| `saveResumeSkills` | `/resume/skills` | 同上 |
| `saveResumeSnapshot` | `/resume/save` | 同上 |
| `saveSalaryRecord` | `/salary/records` | 无 /salary/records |
| `saveWeightSettings` | `/weight-settings` | 无 /weight-settings |