From eba727b4467e650544549459b7449002b0ae11ab Mon Sep 17 00:00:00 2001
From: Jerry Yan <792602257@qq.com>
Date: Fri, 16 Jan 2026 13:33:09 +0800
Subject: [PATCH] =?UTF-8?q?feat(puzzle):=20=E6=B7=BB=E5=8A=A0=E6=8B=BC?=
 =?UTF-8?q?=E5=9B=BE=E6=B0=B4=E5=8D=B0=E5=8A=9F=E8=83=BD=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 创建 PuzzleWatermarkEntity 实体类用于存储拼图水印信息
- 定义水印类型、URL、关联记录ID等关键字段
- 实现 PuzzleWatermarkMapper 数据访问层接口
- 提供新增水印记录的 insert 方法
- 添加批量查询水印的 listByRecordIds 方法
- 实现按记录和类型查询单条水印的 getByRecordAndType 方法
- 支持按人脸ID和水印类型进行条件查询
- 为拼图不同场景下的水印版本管理提供数据支撑
---
 .../puzzle/entity/PuzzleWatermarkEntity.java  | 16 +++++++
 .../puzzle/mapper/PuzzleWatermarkMapper.java  | 44 ++++++++++++++++++
 .../mapper/PuzzleWatermarkMapper.xml          | 45 +++++++++++++++++++
 3 files changed, 105 insertions(+)
 create mode 100644 src/main/java/com/ycwl/basic/model/pc/puzzle/entity/PuzzleWatermarkEntity.java
 create mode 100644 src/main/java/com/ycwl/basic/puzzle/mapper/PuzzleWatermarkMapper.java
 create mode 100644 src/main/resources/mapper/PuzzleWatermarkMapper.xml

diff --git a/src/main/java/com/ycwl/basic/model/pc/puzzle/entity/PuzzleWatermarkEntity.java b/src/main/java/com/ycwl/basic/model/pc/puzzle/entity/PuzzleWatermarkEntity.java
new file mode 100644
index 00000000..2c0f547f
--- /dev/null
+++ b/src/main/java/com/ycwl/basic/model/pc/puzzle/entity/PuzzleWatermarkEntity.java
@@ -0,0 +1,16 @@
+package com.ycwl.basic.model.pc.puzzle.entity;
+
+import lombok.Data;
+
+/**
+ * 拼图水印实体
+ * 存储拼图在不同场景下的水印版本（如打印水印、免费下载水印等）
+ */
+@Data
+public class PuzzleWatermarkEntity {
+    private Integer id;
+    private Long recordId;
+    private Long faceId;
+    private String watermarkType;
+    private String watermarkUrl;
+}
diff --git a/src/main/java/com/ycwl/basic/puzzle/mapper/PuzzleWatermarkMapper.java b/src/main/java/com/ycwl/basic/puzzle/mapper/PuzzleWatermarkMapper.java
new file mode 100644
index 00000000..ce5dece4
--- /dev/null
+++ b/src/main/java/com/ycwl/basic/puzzle/mapper/PuzzleWatermarkMapper.java
@@ -0,0 +1,44 @@
+package com.ycwl.basic.puzzle.mapper;
+
+import com.ycwl.basic.model.pc.puzzle.entity.PuzzleWatermarkEntity;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+/**
+ * 拼图水印Mapper接口
+ * 用于存储和查询拼图在不同场景下的水印版本
+ */
+@Mapper
+public interface PuzzleWatermarkMapper {
+
+    /**
+     * 新增拼图水印记录
+     */
+    int insert(PuzzleWatermarkEntity entity);
+
+    /**
+     * 批量查询拼图水印
+     *
+     * @param recordIds     拼图生成记录ID列表
+     * @param faceId        人脸ID（可选）
+     * @param watermarkType 水印类型
+     * @return 水印列表
+     */
+    List<PuzzleWatermarkEntity> listByRecordIds(@Param("recordIds") List<Long> recordIds,
+                                                 @Param("faceId") Long faceId,
+                                                 @Param("watermarkType") String watermarkType);
+
+    /**
+     * 查询单条拼图水印
+     *
+     * @param recordId      拼图生成记录ID
+     * @param faceId        人脸ID（可选）
+     * @param watermarkType 水印类型
+     * @return 水印记录
+     */
+    PuzzleWatermarkEntity getByRecordAndType(@Param("recordId") Long recordId,
+                                              @Param("faceId") Long faceId,
+                                              @Param("watermarkType") String watermarkType);
+}
diff --git a/src/main/resources/mapper/PuzzleWatermarkMapper.xml b/src/main/resources/mapper/PuzzleWatermarkMapper.xml
new file mode 100644
index 00000000..f32b635d
--- /dev/null
+++ b/src/main/resources/mapper/PuzzleWatermarkMapper.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.ycwl.basic.puzzle.mapper.PuzzleWatermarkMapper">
+
+    <!-- 新增拼图水印记录 -->
+    <insert id="insert" parameterType="com.ycwl.basic.model.pc.puzzle.entity.PuzzleWatermarkEntity"
+            useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO puzzle_watermark (record_id, face_id, watermark_type, watermark_url)
+        VALUES (#{recordId}, #{faceId}, #{watermarkType}, #{watermarkUrl})
+    </insert>
+
+    <!-- 批量查询拼图水印 -->
+    <select id="listByRecordIds" resultType="com.ycwl.basic.model.pc.puzzle.entity.PuzzleWatermarkEntity">
+        SELECT id, record_id, face_id, watermark_type, watermark_url
+        FROM puzzle_watermark
+        WHERE record_id IN
+        <foreach collection="recordIds" item="item" open="(" separator="," close=")">
+            #{item}
+        </foreach>
+        <if test="faceId == null">
+            AND face_id IS NULL
+        </if>
+        <if test="faceId != null">
+            AND face_id = #{faceId}
+        </if>
+        AND watermark_type = #{watermarkType}
+    </select>
+
+    <!-- 查询单条拼图水印 -->
+    <select id="getByRecordAndType" resultType="com.ycwl.basic.model.pc.puzzle.entity.PuzzleWatermarkEntity">
+        SELECT id, record_id, face_id, watermark_type, watermark_url
+        FROM puzzle_watermark
+        WHERE record_id = #{recordId}
+        <if test="faceId == null">
+            AND face_id IS NULL
+        </if>
+        <if test="faceId != null">
+            AND face_id = #{faceId}
+        </if>
+        AND watermark_type = #{watermarkType}
+        LIMIT 1
+    </select>
+
+</mapper>