lxq/changes/n04-onboard/.superpowers/sdd/task-briefs/T2.md

T2 任务简报：Onboarding 实体、Repository 与评价聚合查询

Where This Fits

• Wave: W1
• Depends on: T1
• Contract: changes/n04-onboard/execution-contract.md
• Design: changes/n04-onboard/design.md 的 Architecture、Data Model、Decisions

Objective

在 V38/V39 表结构之上新增实体、Repository 和公司评价聚合查询，先写持久化失败测试，再实现最小映射。

Files In Scope

• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/OnboardingChecklistItem.java
• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/StudentOnboardingProgress.java
• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/CompanyKnowledge.java
• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/OnboardingChecklistItemRepository.java
• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/StudentOnboardingProgressRepository.java
• mydreamjob-server/src/main/java/com/mydreamjob/onboarding/CompanyKnowledgeRepository.java
• 必要时只读扩展 mydreamjob-server/src/main/java/com/mydreamjob/review/JobReviewRepository.java 和 JobReviewDimensionScoreRepository.java 的公司级聚合查询。
• mydreamjob-server/src/test/java/com/mydreamjob/onboarding/OnboardingRepositoryIntegrationTest.java

Required Behavior

• OnboardingChecklistItem 映射 onboarding_checklist_items，含 scopeType、scopeId、companyId、itemKey、title、description、category、sortOrder、required、active、idempotencyKey、requestHash、version、审计时间。
• StudentOnboardingProgress 映射 student_onboarding_progress，含 studentUserId、itemId、completed、completedAt、version、审计时间。
• CompanyKnowledge 映射 company_knowledge，含 companyId、culture、workPolicies、onboardingGuide、version、审计时间。
• 清单 Repository 支持按 companyId 查询活动通用项+活动企业项，并按 sortOrder ASC, id ASC 稳定排序。
• 进度 Repository 支持按学生和多个 itemId 批量读取，并按学生+条目唯一查询。
• 知识 Repository 支持按 companyId 查询。
• 评价聚合查询支持公司下全部 PUBLISHED 且 AUTO_APPROVED/APPROVED 的评价评分分布、tags 原始列和八维汇总；不得逐岗位或逐评价产生 N+1。

TDD Requirement

1. 先写 OnboardingRepositoryIntegrationTest，确认新实体/Repository 不存在或查询失败。
2. 再实现最小实体和 Repository 使测试通过。
3. 不创建 Service、Controller、DTO 或业务状态机。

Evidence Commands

cd D:\1\zhi\zhilai\mydreamjob-server
mvn -Dtest=OnboardingRepositoryIntegrationTest test

Done Definition

• 新实体与三张表映射通过 Hibernate ddl-auto=validate。
• 合并查询只返回活动通用项和当前企业活动项。
• 多学生、多企业、软删除项和排序测试通过。
• 公司评分/tags/八维聚合仅统计公开评价。