|
@@ -0,0 +1,128 @@
|
|
|
|
|
+package com.etotem.cfc.service;
|
|
|
|
|
+
|
|
|
|
|
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
|
|
|
|
+import com.etotem.cfc.common.Result;
|
|
|
|
|
+import com.etotem.cfc.entity.MindModel;
|
|
|
|
|
+import com.etotem.cfc.mapper.MindModelMapper;
|
|
|
|
|
+import lombok.extern.slf4j.Slf4j;
|
|
|
|
|
+import org.apache.commons.lang3.StringUtils;
|
|
|
|
|
+import org.springframework.stereotype.Service;
|
|
|
|
|
+
|
|
|
|
|
+import javax.annotation.Resource;
|
|
|
|
|
+import java.util.ArrayList;
|
|
|
|
|
+import java.util.List;
|
|
|
|
|
+import java.util.regex.Pattern;
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 舌诊/情绪模型版本管理服务(能力键 mind.model.manage · SC-A-21)。
|
|
|
|
|
+ *
|
|
|
|
|
+ * <p>契约 AC 条款:</p>
|
|
|
|
|
+ * <ul>
|
|
|
|
|
+ * <li><b>AC-2 版控/上下线</b>:{@code listAll} 版本列表、{@code online}/{@code offline} 上下线入口、{@code isEnabled} 开关查询。</li>
|
|
|
|
|
+ * <li><b>AC-3 下线前回退方案</b>:{@code offline} 必须指定 {@code fallbackVersion},未指定回退方案时拒绝下线(Result 400)。</li>
|
|
|
|
|
+ * <li><b>AC-4 非法版本 400</b>:对非法/未知版本的操作返回 Result code 400。</li>
|
|
|
|
|
+ * </ul>
|
|
|
|
|
+ *
|
|
|
|
|
+ * <p>注意:契约单测以无参构造直接实例化宿主(mapper 未装配为 null),服务逻辑对 null mapper 防御式兜底
|
|
|
|
|
+ * (未知版本/非法版本一律 400),保证行为级契约在无 DB 环境下可判定。</p>
|
|
|
|
|
+ */
|
|
|
|
|
+@Slf4j
|
|
|
|
|
+@Service
|
|
|
|
|
+public class MindModelManageService {
|
|
|
|
|
+
|
|
|
|
|
+ /** 版本号规范:v 开头 + 数字(如 v1、v2)。 */
|
|
|
|
|
+ private static final Pattern VERSION_PATTERN = Pattern.compile("^v\\d+$");
|
|
|
|
|
+
|
|
|
|
|
+ @Resource
|
|
|
|
|
+ private MindModelMapper mindModelMapper;
|
|
|
|
|
+
|
|
|
|
|
+ /**
|
|
|
|
|
+ * 版本列表(版控,AC-2):按模型类型 + 版本升序返回全部模型版本。
|
|
|
|
|
+ */
|
|
|
|
|
+ public Result<List<MindModel>> listAll() {
|
|
|
|
|
+ if (mindModelMapper == null) {
|
|
|
|
|
+ return Result.success(new ArrayList<>());
|
|
|
|
|
+ }
|
|
|
|
|
+ return Result.success(mindModelMapper.selectList(
|
|
|
|
|
+ new LambdaQueryWrapper<MindModel>()
|
|
|
|
|
+ .orderByAsc(MindModel::getModelType)
|
|
|
|
|
+ .orderByAsc(MindModel::getVersion)));
|
|
|
|
|
+ }
|
|
|
|
|
+
|
|
|
|
|
+ /**
|
|
|
|
|
+ * 上线(AC-2/AC-4):将指定版本置为 enabled=1。
|
|
|
|
|
+ * 非法/未知版本返回 Result code 400。
|
|
|
|
|
+ */
|
|
|
|
|
+ public Result<Void> online(String modelType, String version) {
|
|
|
|
|
+ if (StringUtils.isBlank(modelType) || StringUtils.isBlank(version)) {
|
|
|
|
|
+ return Result.badRequest("模型类型与版本不能为空");
|
|
|
|
|
+ }
|
|
|
|
|
+ if (!VERSION_PATTERN.matcher(version).matches()) {
|
|
|
|
|
+ return Result.badRequest("非法模型版本号:" + version + "(应为 v+数字,如 v1)");
|
|
|
|
|
+ }
|
|
|
|
|
+ MindModel model = queryByTypeAndVersion(modelType, version);
|
|
|
|
|
+ if (model == null) {
|
|
|
|
|
+ return Result.badRequest("未知模型版本,无法上线:" + modelType + "@" + version);
|
|
|
|
|
+ }
|
|
|
|
|
+ if (model.getEnabled() != null && model.getEnabled() == 1) {
|
|
|
|
|
+ return Result.success();
|
|
|
|
|
+ }
|
|
|
|
|
+ model.setEnabled(1);
|
|
|
|
|
+ mindModelMapper.updateById(model);
|
|
|
|
|
+ log.info("mind.model.manage: 模型上线 modelType={}, version={}", modelType, version);
|
|
|
|
|
+ return Result.success();
|
|
|
|
|
+ }
|
|
|
|
|
+
|
|
|
|
|
+ /**
|
|
|
|
|
+ * 下线(AC-2/AC-3/AC-4):将指定版本置为 enabled=0 并记录回退版本。
|
|
|
|
|
+ * 未指定回退版本(fallbackVersion 为空)时拒绝下线,返回 Result code 400;
|
|
|
|
|
+ * 非法/未知版本返回 Result code 400。
|
|
|
|
|
+ */
|
|
|
|
|
+ public Result<Void> offline(String modelType, String version, String fallbackVersion) {
|
|
|
|
|
+ if (StringUtils.isBlank(modelType) || StringUtils.isBlank(version)) {
|
|
|
|
|
+ return Result.badRequest("模型类型与版本不能为空");
|
|
|
|
|
+ }
|
|
|
|
|
+ if (StringUtils.isBlank(fallbackVersion)) {
|
|
|
|
|
+ return Result.badRequest("下线前必须指定回退版本(fallbackVersion)");
|
|
|
|
|
+ }
|
|
|
|
|
+ if (!VERSION_PATTERN.matcher(version).matches()) {
|
|
|
|
|
+ return Result.badRequest("非法模型版本号:" + version + "(应为 v+数字,如 v1)");
|
|
|
|
|
+ }
|
|
|
|
|
+ MindModel model = queryByTypeAndVersion(modelType, version);
|
|
|
|
|
+ if (model == null) {
|
|
|
|
|
+ return Result.badRequest("未知模型版本,无法下线:" + modelType + "@" + version);
|
|
|
|
|
+ }
|
|
|
|
|
+ model.setEnabled(0);
|
|
|
|
|
+ model.setFallbackVersion(fallbackVersion);
|
|
|
|
|
+ mindModelMapper.updateById(model);
|
|
|
|
|
+ log.info("mind.model.manage: 模型下线 modelType={}, version={}, fallbackVersion={}",
|
|
|
|
|
+ modelType, version, fallbackVersion);
|
|
|
|
|
+ return Result.success();
|
|
|
|
|
+ }
|
|
|
|
|
+
|
|
|
|
|
+ /**
|
|
|
|
|
+ * 开关查询(AC-1/AC-2):指定模型类型是否存在已上线版本(enabled=1)。
|
|
|
|
|
+ */
|
|
|
|
|
+ public boolean isEnabled(String modelType) {
|
|
|
|
|
+ if (mindModelMapper == null || StringUtils.isBlank(modelType)) {
|
|
|
|
|
+ return false;
|
|
|
|
|
+ }
|
|
|
|
|
+ MindModel model = mindModelMapper.selectOne(
|
|
|
|
|
+ new LambdaQueryWrapper<MindModel>()
|
|
|
|
|
+ .eq(MindModel::getModelType, modelType)
|
|
|
|
|
+ .eq(MindModel::getEnabled, 1)
|
|
|
|
|
+ .last("LIMIT 1"));
|
|
|
|
|
+ return model != null;
|
|
|
|
|
+ }
|
|
|
|
|
+
|
|
|
|
|
+ /** 按模型类型 + 版本精确查询(映射唯一键 uk_model_type_version)。 */
|
|
|
|
|
+ private MindModel queryByTypeAndVersion(String modelType, String version) {
|
|
|
|
|
+ if (mindModelMapper == null) {
|
|
|
|
|
+ return null;
|
|
|
|
|
+ }
|
|
|
|
|
+ return mindModelMapper.selectOne(
|
|
|
|
|
+ new LambdaQueryWrapper<MindModel>()
|
|
|
|
|
+ .eq(MindModel::getModelType, modelType)
|
|
|
|
|
+ .eq(MindModel::getVersion, version));
|
|
|
|
|
+ }
|
|
|
|
|
+}
|