投诉服务数据库设计：Complaint、Reporter、Reported关系咨询

核心关系定义 #

根据你的需求，三个实体的关系应明确为：

• Reporter（投诉人）与Complaint（投诉）：一对多。一个投诉人可提交多条投诉，每条投诉仅归属一个投诉人。
• Reported（被投诉方）与Complaint（投诉）：一对多。一个被投诉方可关联多条投诉，每条投诉仅指向一个被投诉方。
• Complaint作为中间关联实体，同时持有Reporter和Reported的外键，完美支撑“投诉人针对多个被投诉方提交多条投诉”的业务逻辑。

现有代码问题分析 #

你的实现方向正确，但存在几个细节疏漏：

1. 字段命名不规范：属性名应遵循Java驼峰命名法（如complaint_Id改为complaintId），关联对象属性名应体现实体而非ID（如reporterId改为reporter）。
2. 主键配置错误：Reporter和Reported中给主键字段添加insertable=false, updatable=false会导致无法生成自增ID，JPA无法插入主键值。
3. 冗余字段风险：Reporter.numberOfComplaints和Complaint.complaint_Counter属于冗余统计字段，应通过关联查询（如COUNT()）实时计算，避免数据不一致。
4. 枚举类型错误：Complaint.Type未指定具体枚举类，且@NotBlank注解不适用于枚举类型（枚举用@NotNull即可）。
5. 业务字段缺失：Reporter未包含需求中要求的“姓名”字段。
6. Operator关系不合理：OneToOne意味着一个操作员仅处理一条投诉，不符合实际业务，应改为ManyToOne（一个操作员可处理多条投诉）。

修正后实体代码示例 #

1. Complaint 实体 #

@Entity
@Table(name = "complaints_tbl")
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Complaint extends BaseEntity {
    // 若BaseEntity已包含ID字段，可删除以下主键定义
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "complaint_id", nullable = false)
    private Long complaintId;

    @NotNull
    @CreatedDate
    @Column(name = "issuing_date", updatable = false)
    private LocalDate issuingDate;
    
    private String message;

    // 关联投诉人：多对一，懒加载提升性能
    @NotNull
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "reporter_id")
    private Reporter reporter;

    // 关联被投诉方：多对一，懒加载提升性能
    @NotNull
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "reported_id")
    private Reported reported;

    // 关联处理操作员：多对一（修正原OneToOne不合理性）
    @NotNull
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "operator_id")
    private Operator operator;

    // 投诉类型：指定具体枚举类
    @NotNull
    @Column(name = "complaint_type")
    private ComplaintType type;
}

// 配套投诉类型枚举类示例
public enum ComplaintType {
    SPAM, HARASSMENT, FRAUD, OTHER
}

2. Reporter 实体 #

@Entity
@Table(name = "reporters_tbl")
@Getter
@Setter
public class Reporter extends BaseEntity {
    // 若BaseEntity已包含ID字段，可删除以下主键定义
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "reporter_id", nullable = false)
    private Long reporterId;

    @NotBlank
    @Column(unique = true) // 手机号唯一约束，避免重复创建同一投诉人
    private String reporterPhoneNumber;

    // 添加需求中的姓名字段
    @NotBlank
    private String reporterName;

    // 可选：添加一对多关联，方便从投诉人直接查询所有投诉
    @OneToMany(mappedBy = "reporter", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Complaint> complaints = new ArrayList<>();
}

3. Reported 实体 #

@Entity
@Table(name = "reporteds_tbl")
@Getter
@Setter
public class Reported extends BaseEntity {
    // 若BaseEntity已包含ID字段，可删除以下主键定义
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "reported_id", nullable = false)
    private Long reportedId;

    @NotBlank
    @Column(unique = true) // 被投诉号码唯一约束，避免重复创建同一被投诉方
    private String reportedPhoneNumber;

    // 状态用枚举替代字符串，避免非法值
    @NotNull
    private ReportedStatus status;

    // 可选：添加一对多关联，方便从被投诉方直接查询所有投诉
    @OneToMany(mappedBy = "reported", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Complaint> complaints = new ArrayList<>();
}

// 配套被投诉方状态枚举类示例
public enum ReportedStatus {
    ACTIVE, RESOLVED, BLOCKED
}

补充说明 #

• 懒加载配置：fetch = FetchType.LAZY可避免关联实体被不必要加载，提升查询性能。
• 唯一约束：手机号添加unique = true可保证数据唯一性，避免重复创建同一主体。
• 枚举类型：用枚举替代字符串字段，既保证数据合法性，又提升代码可读性。
• 冗余字段替代方案：如需统计投诉人提交的投诉数量，可通过SELECT COUNT(c) FROM Complaint c WHERE c.reporter = :reporter实现，无需存储冗余字段。

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