能力等级薪资数据的年度季度维度存储与管理方案咨询

现有方案的核心问题 #

你当前的Competency实体设计存在几个明显的局限性：

1. 数据冗余：单个Competency实例绑定一个能力项+一个等级，意味着同一能力项（如"开发"）下的多个等级需要重复存储能力项名称，浪费存储空间且增加维护成本。
2. 查询与校验能力弱：用JSON格式的HashMap存储季度薪资，数据库无法直接对薪资数据进行过滤、统计（比如查询2024年Q3所有等级的薪资上限），也难以校验季度格式的合法性。
3. 时间维度混乱：如果单独给Competency加year字段，会和salaryCap中的季度信息脱节——你无法区分"Q1"对应的是哪一年的薪资，未来年度调整时会出现数据冲突。

更优的数据库设计方案（推荐） #

采用实体拆分的方式，符合关系型数据库的设计原则，同时满足扩展性和可维护性需求：

1. 拆分后的实体结构

① 能力项实体（Competency）

仅存储能力项的核心信息，避免冗余：

@Entity
@Builder(toBuilder = true)
@Audited
@AllArgsConstructor
@NoArgsConstructor
@ToString
@Setter
@Getter
@EntityListeners(AuditingEntityListener.class)
public class Competency implements Serializable {
    @Id
    @GeneratedValue(generator = "UUID")
    @GenericGenerator(name = "UUID", strategy = "org.hibernate.id.UUIDGenerator")
    private UUID id;

    @NotNull
    private String name; // 如"开发"、"测试"、"管理"
    // 可添加能力项描述、状态等通用字段
}

② 薪资关联实体（CompetencySalary）

单独存储能力项、等级、时间维度（年份+季度）与薪资的关联关系，这是核心的业务数据载体：

@Entity
@Builder
@AllArgsConstructor
@NoArgsConstructor
@Setter
@Getter
@Audited
@EntityListeners(AuditingEntityListener.class)
@Table(uniqueConstraints = {
        @UniqueConstraint(columnNames = {"competency_id", "level", "year", "quarter"})
})
public class CompetencySalary implements Serializable {
    @Id
    @GeneratedValue(generator = "UUID")
    @GenericGenerator(name = "UUID", strategy = "org.hibernate.id.UUIDGenerator")
    private UUID id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "competency_id", nullable = false)
    private Competency competency;

    @Enumerated(EnumType.STRING)
    private Level level; // 复用你现有的Level枚举

    @NotNull
    private Integer year; // 如2024、2025
    @NotNull
    private Integer quarter; // 限制1-4，可通过@Check或自定义校验约束

    @NotNull
    private Integer salaryCap; // 薪资上限
}

2. 方案优势

• 无冗余数据：能力项信息仅存储一次，等级信息通过枚举复用，避免重复存储。
• 数据库可查询：支持直接通过SQL筛选任意时间范围、任意能力项/等级的薪资数据，方便后续统计分析。
• 天然支持年度调整：通过year+quarter字段明确区分不同周期的薪资，新增年度薪资时只需添加新记录，无需修改原有数据，符合审计需求。
• 扩展性强：未来如需添加薪资下限、地区维度等，只需在CompetencySalary中新增字段即可，无需重构核心结构。

前端TSX适配示例 #

可以定义以下TypeScript接口，与后端实体对应：

// 能力项接口
interface Competency {
  id: string;
  name: string;
}

// 等级枚举
enum Level {
  TRAINEE = "Trainee",
  JUNIOR = "Junior",
  INTERMEDIATE = "Intermediate",
  SENIOR = "Senior",
  EXPERT = "Expert",
  TL = "Tech lead"
}

// 薪资条目接口
interface CompetencySalary {
  id: string;
  competency: Competency;
  level: Level;
  year: number;
  quarter: number;
  salaryCap: number;
}

// 前端展示用的分组结构（按能力项+等级聚合）
interface CompetencySalaryGrouped {
  competency: Competency;
  levelSalaries: Array<{
    level: Level;
    quarterlySalaries: Array<{ year: number; quarter: number; cap: number }>;
  }>;
}

关于年份字段的结论 #

必须添加时间维度（年份+季度），但不要放在Competency实体中，而是绑定到薪资记录上。这样每个薪资条目都有明确的时间归属，不会出现同一季度对应不同年份的混乱情况，完美支持未来年度薪资调整需求。

内容的提问来源于stack exchange，提问作者Feel free