package tech.easyflow.manuagent.mapper;

import com.mybatisflex.core.BaseMapper;
import org.apache.ibatis.annotations.Param;
import tech.easyflow.manuagent.entity.ArtifactEntity;

/**
 * 提供产物基础查询以及 PostgreSQL 原子 upsert 能力。
 */
public interface ArtifactMapper extends BaseMapper<ArtifactEntity> {

    /**
     * 按“项目 + 相对路径”插入或更新产物，并返回数据库中的完整记录。
     *
     * @param artifact 待发布产物
     * @return 插入或更新后的产物记录
     */
    ArtifactEntity upsert(@Param("artifact") ArtifactEntity artifact);
}