本台账基于 server/skillhub-app、server/skillhub-auth、server/skillhub-domain、server/skillhub-infra、server/skillhub-storage 的当前生产代码与 Flyway migration。
目标已经从“摸底问题分布”转为“记录当前真实进展与剩余尾项”。
当前生产代码里只剩 1 处兼容解析保留 LocalDateTime：
ApiTokenService- 用于兼容旧接口传入的裸时间字符串
- 当前明确按 UTC 解释后转成
Instant
此前集中使用 LocalDateTime 的主链区域已完成迁移或收口：
- 认证与账号：
api_tokenaccount_merge_requestuser_accountidentity_bindingroleuser_role_bindinglocal_credential
- 核心领域：
namespacenamespace_memberskillskill_versionskill_fileskill_tagskill_version_statsskill_reportskill_starskill_rating
- 服务层：
AccountMergeServiceLocalAuthServiceSkillPublishServiceSkillGovernanceServiceReviewServicePromotionServiceSkillReportService
- DTO 与接口输出：
NamespaceResponseMemberResponseSkillSummaryResponseSkillVersionResponseSkillVersionDetailResponseTagResponseAdminUserSummaryResponseAdminSkillReportSummaryResponse
结论：
- 主系统核心“事件发生时间”已经基本收口成 UTC 绝对时间
- 当前剩余工作主要是兼容策略、数据库尾项复核和防回归约束
当前已稳定使用 Instant 的代表区域：
- 审计：
AuditLogAuditLogItemResponse
- 通知：
UserNotification
- 审核流程：
ReviewTaskPromotionRequestReviewTaskResponsePromotionResponseDto
- 幂等：
IdempotencyRecordIdempotencyInterceptorIdempotencyCleanupTask
- 技能主链：
SkillSkillVersionSkillTagSkillFileSkillVersionStats
- 认证主链：
ApiTokenAccountMergeRequestUserAccountIdentityBindingRoleUserRoleBindingLocalCredential
V12__governance_notifications.sqluser_notification.created_at / read_at
V24__api_token_timestamptz.sqlapi_token.expires_at / last_used_at / revoked_at / created_at
V25__account_merge_request_timestamptz.sqlaccount_merge_request.token_expires_at / completed_at / created_at
V26__skill_version_timestamptz.sqlskill_version.published_at / created_at / yanked_at
V16__skill_hidden_at_timestamptz.sqlskill.hidden_at
V17__skill_created_updated_timestamptz.sqlskill.created_at / updated_at
V18__namespace_timestamptz.sqlnamespace.created_at / updated_atnamespace_member.created_at / updated_at
V19__skill_secondary_timestamptz.sqlskill_tag.created_at / updated_atskill_file.created_atskill_version_stats.updated_at
V20__social_and_skill_report_timestamptz.sqlskill_star.created_atskill_rating.created_at / updated_atskill_report.created_at / handled_at
V21__user_account_timestamptz.sqluser_account.created_at / updated_at
V22__auth_supporting_tables_timestamptz.sqlidentity_binding.created_at / updated_atrole.created_atuser_role_binding.created_atlocal_credential.locked_until / created_at / updated_at
V23__review_and_idempotency_timestamptz.sqlreview_task.submitted_at / reviewed_atpromotion_request.submitted_at / reviewed_atidempotency_record.created_at / expires_at
- 主链核心事件时间列已基本完成
TIMESTAMPTZ收口 - 初始建表 migration 中仍然能看到旧
TIMESTAMP定义，但已由后续 Flyway 升级覆盖 - 后续重点不是“大批量迁移”，而是查漏补缺和约束新增
此前：
ClawHubCompatController按ZoneOffset.UTC转 epochClawHubRegistryFacade按系统默认时区解释
当前：
- 已统一按 UTC 解释绝对时间
ClawHubRegistryFacade的LocalDateTimeepoch 转换重载已移除
此前热点包括：
ApiTokenServiceAccountMergeServiceLocalAuthServiceSkillPublishServiceSkillGovernanceServiceReviewServicePromotionServiceSkillReportService- 多个实体
@PrePersist/@PreUpdate
当前：
- 服务层当前时间已基本统一为注入
Clock - 实体回调已基本统一为显式 UTC
已完成：
- UTC
ClockBean - Hibernate UTC 配置
- Jackson UTC 配置
ApiResponseFactoryIdempotencyInterceptorIdempotencyCleanupTask- 审计、通知、审核、幂等链路
已完成：
ApiToken/ApiTokenServiceAccountMergeRequest/AccountMergeServiceLocalCredentialUserAccountIdentityBindingRoleUserRoleBindingLocalAuthService
已完成：
SkillSkillVersionSkillFileSkillTagSkillVersionStatsNamespaceNamespaceMemberSkillPublishServiceSkillGovernanceServiceReviewServicePromotionServiceSkillReportSkillStarSkillRating
已完成：
NamespaceResponseMemberResponseSkillSummaryResponseSkillVersionResponseSkillVersionDetailResponseTagResponseAdminUserSummaryResponseAdminSkillReportSummaryResponseTokenController的 UTC 输出收口
ApiTokenService仍保留对裸LocalDateTime字符串的兼容解析- 需要补静态扫描或 ArchUnit 约束，防止新增
LocalDateTime.now() - 需要做一轮跨时区回归，把
UTC/Asia/Shanghai纳入关键测试