feat: 优化代码生成及文案模板渲染

2026-07-29 16:17:49 +08:00
parent c631d058c1
commit e9d627df9c
15 changed files with 560 additions and 199 deletions
--- a/ruoyi-office/src/main/java/com/ruoyi/office/controller/TtCodeController.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/controller/TtCodeController.java
@@ -103,26 +103,14 @@ public class TtCodeController extends BaseController
        return toAjax(ttCodeService.deleteTtCodeByCodeIds(codeIds));
    }

-    /**
-     * 转文章
-     */
-    @PreAuthorize("@ss.hasPermi('office:code:edit')")
-    @Log(title = "源码管理", businessType = BusinessType.UPDATE)
-    @GetMapping("/transToArticle/{codeId}")
-    public AjaxResult transToArticle(@PathVariable Long codeId)
-    {
-        String msg = ttCodeService.transToArticle(codeId);
-        return success(msg);
-    }
-
    /**
     * 转文章
     */
    @PreAuthorize("@ss.hasPermi('office:code:edit')")
    @Log(title = "转文章(南音)", businessType = BusinessType.UPDATE)
    @GetMapping("/transToArticle1/{codeId}")
-    public AjaxResult transToArticle1(@PathVariable Long codeId, @RequestParam String coverUrl) {
-        String msg = ttCodeService.transToArticle1(codeId, coverUrl);
+    public AjaxResult transToArticle1(@PathVariable Long codeId, @RequestParam Long templateId) {
+        String msg = ttCodeService.transToArticle1(codeId, templateId);
        return success(msg);
    }
 }
--- a/ruoyi-office/src/main/java/com/ruoyi/office/controller/TtCopyTemplateController.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/controller/TtCopyTemplateController.java
@@ -18,11 +18,9 @@ import com.ruoyi.common.annotation.Log;
 import com.ruoyi.common.core.controller.BaseController;
 import com.ruoyi.common.core.domain.AjaxResult;
 import com.ruoyi.common.enums.BusinessType;
-import com.ruoyi.common.utils.HtmlUtils;
-import com.ruoyi.common.utils.StringUtils;
 import com.ruoyi.office.domain.TtCode;
-import com.ruoyi.office.domain.TtFile;
 import com.ruoyi.office.domain.TtCopyTemplate;
+import com.ruoyi.office.service.CopyTemplateRenderer;
 import com.ruoyi.office.service.ITtCodeService;
 import com.ruoyi.office.service.ITtCopyTemplateService;
 import com.ruoyi.common.utils.poi.ExcelUtil;
@@ -44,6 +42,9 @@ public class TtCopyTemplateController extends BaseController {
    @Autowired
    private ITtCodeService ttCodeService;

+    @Autowired
+    private CopyTemplateRenderer copyTemplateRenderer;
+
    /**
     * 查询文案模板列表
     */
@@ -134,53 +135,6 @@ public class TtCopyTemplateController extends BaseController {
        if (code == null) {
            return error("未找到名称为【" + codeName + "】的源码项目");
        }
-        // 3. 提取变量
-        String fullCodeName = code.getCodeName() != null ? code.getCodeName() : "";
-        String projectCode = "";
-        String projectName = fullCodeName;
-        if (fullCodeName.length() > 0) {
-            java.util.regex.Matcher m = java.util.regex.Pattern.compile("【(.+?)】").matcher(fullCodeName);
-            if (m.find()) {
-                projectCode = m.group(1);
-            }
-            projectName = fullCodeName.replaceAll("【.+?】", "").trim();
-            if (projectName.startsWith("基于")) {
-                java.util.regex.Matcher nameMatcher = java.util.regex.Pattern.compile("实现的(.+?)$").matcher(projectName);
-                if (nameMatcher.find()) {
-                    projectName = nameMatcher.group(1);
-                }
-            }
-        }
-        // 4. 生成纯文本描述
-        String plainDesc = "";
-        if (StringUtils.isNotEmpty(code.getCodeDesc())) {
-            String codeDesc = code.getCodeDesc().replaceAll("</p>", "</p>\n");
-            plainDesc = HtmlUtils.htmlToText(codeDesc.trim());
-        }
-        // 5. 生成截图列表
-        String screenshots = "";
-        int idx = 0;
-        if (code.getFileList() != null && !code.getFileList().isEmpty()) {
-            for (TtFile item : code.getFileList()) {
-                screenshots += (++idx) + "." + item.getFileName() + "\n![](" + item.getFileUrl() + ")\n\n";
-            }
-        } else {
-            screenshots = "请前往微信小程序：南音源码库。查看项目详情！\n\n";
-        }
-        // 6. 替换占位符
-        String content = template.getTemplateBody();
-        content = content.replace("{codeName}", fullCodeName);
-        content = content.replace("{projectCode}", projectCode);
-        content = content.replace("{projectName}", projectName);
-        content = content.replace("{codeDesc}", plainDesc);
-        content = content.replace("{codeEnvironment}", code.getCodeEnvironment() != null ? code.getCodeEnvironment() : "");
-        content = content.replace("{frontendTechnology}", code.getFrontendTechnology() != null ? code.getFrontendTechnology() : "");
-        content = content.replace("{backendTechnology}", code.getBackendTechnology() != null ? code.getBackendTechnology() : "");
-        content = content.replace("{databaseTechnology}", code.getDatabaseTechnology() != null ? code.getDatabaseTechnology() : "");
-        content = content.replace("{codeTechnology}", code.getCodeTechnology() != null ? code.getCodeTechnology() : "");
-        content = content.replace("{diskLink}", code.getDiskLink() != null ? code.getDiskLink() : "");
-        content = content.replace("{screenshots}", screenshots);
-
-        return success(content);
+        return success(copyTemplateRenderer.render(template, code));
    }
 }
--- a/ruoyi-office/src/main/java/com/ruoyi/office/mapper/TtProjectInfoMapper.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/mapper/TtProjectInfoMapper.java
@@ -67,4 +67,6 @@ public interface TtProjectInfoMapper
    int updateProjectQuarkUrl(@Param("id") Integer id, @Param("projectUrl") String projectUrl);

    int updateProjectBaiduUrl(@Param("id") Integer id, @Param("projectBaiduUrl") String projectBaiduUrl);
+
+    int updateProjectNumIfBlank(@Param("id") Integer id, @Param("projectNum") String projectNum);
 }
--- a/ruoyi-office/src/main/java/com/ruoyi/office/service/CopyTemplateRenderer.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/service/CopyTemplateRenderer.java
@@ -0,0 +1,99 @@
+package com.ruoyi.office.service;
+
+import java.util.List;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+import org.springframework.stereotype.Component;
+
+import com.ruoyi.common.utils.HtmlUtils;
+import com.ruoyi.common.utils.StringUtils;
+import com.ruoyi.office.domain.TtCode;
+import com.ruoyi.office.domain.TtCopyTemplate;
+import com.ruoyi.office.domain.TtFile;
+
+/**
+ * 文案模板占位符渲染器。
+ */
+@Component
+public class CopyTemplateRenderer
+{
+    private static final Pattern PROJECT_CODE_PATTERN = Pattern.compile("【(.+?)】");
+    private static final Pattern PROJECT_NAME_PATTERN = Pattern.compile("实现的(.+?)$");
+
+    public String render(TtCopyTemplate template, TtCode code)
+    {
+        String codeName = value(code.getCodeName());
+        String projectCode = extractProjectCode(codeName);
+        String projectName = extractProjectName(codeName);
+        String content = value(template.getTemplateBody());
+
+        content = content.replace("{codeName}", codeName);
+        content = content.replace("{projectCode}", projectCode);
+        content = content.replace("{projectName}", projectName);
+        content = content.replace("{codeDesc}", toPlainDescription(code.getCodeDesc()));
+        content = content.replace("{codeEnvironment}", value(code.getCodeEnvironment()));
+        content = content.replace("{frontendTechnology}", value(code.getFrontendTechnology()));
+        content = content.replace("{backendTechnology}", value(code.getBackendTechnology()));
+        content = content.replace("{databaseTechnology}", value(code.getDatabaseTechnology()));
+        content = content.replace("{codeTechnology}", value(code.getCodeTechnology()));
+        content = content.replace("{diskLink}", value(code.getDiskLink()));
+        content = content.replace("{screenshots}", buildScreenshots(code.getFileList()));
+        return content;
+    }
+
+    private String extractProjectCode(String codeName)
+    {
+        Matcher matcher = PROJECT_CODE_PATTERN.matcher(codeName);
+        return matcher.find() ? matcher.group(1) : "";
+    }
+
+    private String extractProjectName(String codeName)
+    {
+        String projectName = PROJECT_CODE_PATTERN.matcher(codeName).replaceFirst("").trim();
+        if (projectName.startsWith("基于"))
+        {
+            Matcher matcher = PROJECT_NAME_PATTERN.matcher(projectName);
+            if (matcher.find())
+            {
+                return matcher.group(1);
+            }
+        }
+        return projectName;
+    }
+
+    private String toPlainDescription(String codeDesc)
+    {
+        if (StringUtils.isEmpty(codeDesc))
+        {
+            return "";
+        }
+        return HtmlUtils.htmlToText(codeDesc.replaceAll("(?i)</p>", "</p>\n").trim());
+    }
+
+    private String buildScreenshots(List<TtFile> fileList)
+    {
+        if (fileList == null || fileList.isEmpty())
+        {
+            return "请前往微信小程序：南音源码库。查看项目详情！\n\n";
+        }
+
+        StringBuilder screenshots = new StringBuilder();
+        int index = 0;
+        for (TtFile file : fileList)
+        {
+            screenshots.append(++index)
+                    .append(".")
+                    .append(value(file.getFileName()))
+                    .append("\n![](")
+                    .append(value(file.getFileUrl()))
+                    .append(")\n\n");
+        }
+        return screenshots.toString();
+    }
+
+    private String value(String value)
+    {
+        return value == null ? "" : value;
+    }
+}
--- a/ruoyi-office/src/main/java/com/ruoyi/office/service/ITtCodeService.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/service/ITtCodeService.java
@@ -67,16 +67,8 @@ public interface ITtCodeService {
     */
    public int deleteTtCodeByCodeId(Long codeId);

-    /**
-     * 转文章
-     *
-     * @param codeId 源码管理主键
-     * @return 结果
-     */
-    public String transToArticle(Long codeId);
-
    /**
     * 转文章(南音)
     */
-    public String transToArticle1(Long codeId, String coverUrl);
+    public String transToArticle1(Long codeId, Long templateId);
 }
--- a/ruoyi-office/src/main/java/com/ruoyi/office/service/impl/TtCodeServiceImpl.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/service/impl/TtCodeServiceImpl.java
@@ -9,15 +9,18 @@ import com.ruoyi.app.domain.AppResource;
 import com.ruoyi.app.domain.AppResourceList;
 import com.ruoyi.app.mapper.AppBlogArticleMapper;
 import com.ruoyi.app.mapper.AppResourceMapper;
+import com.ruoyi.common.exception.ServiceException;
 import com.ruoyi.common.utils.StringUtils;
-import com.ruoyi.office.domain.TtArticles;
+import com.ruoyi.office.domain.TtCopyTemplate;
 import com.ruoyi.office.domain.TtFile;
 import com.ruoyi.office.domain.TtProjectInfo;
-import com.ruoyi.office.mapper.TtArticlesMapper;
+import com.ruoyi.office.mapper.TtCopyTemplateMapper;
 import com.ruoyi.office.mapper.TtFileMapper;
 import com.ruoyi.office.mapper.TtProjectInfoMapper;
+import com.ruoyi.office.service.CopyTemplateRenderer;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
 import com.ruoyi.office.mapper.TtCodeMapper;
 import com.ruoyi.office.domain.TtCode;
 import com.ruoyi.office.service.ITtCodeService;
@@ -33,8 +36,6 @@ public class TtCodeServiceImpl implements ITtCodeService {
    @Autowired
    private TtCodeMapper ttCodeMapper;
    @Autowired
-    private TtArticlesMapper ttArticlesMapper;
-    @Autowired
    private TtFileMapper fileMapper;
    @Autowired
    private AppBlogArticleMapper appBlogArticleMapper;
@@ -42,6 +43,10 @@ public class TtCodeServiceImpl implements ITtCodeService {
    private AppResourceMapper appResourceMapper;
    @Autowired
    private TtProjectInfoMapper ttProjectInfoMapper;
+    @Autowired
+    private TtCopyTemplateMapper ttCopyTemplateMapper;
+    @Autowired
+    private CopyTemplateRenderer copyTemplateRenderer;

    /**
     * 查询源码管理
@@ -131,105 +136,154 @@ public class TtCodeServiceImpl implements ITtCodeService {
    }

    @Override
-    public String transToArticle(Long codeId) {
-        TtCode ttCode = ttCodeMapper.selectTtCodeByCodeId(codeId);
-        TtArticles ttArticles = new TtArticles();
-        ttArticles.setTitle(ttCode.getCodeName());
-        List<TtArticles> list = ttArticlesMapper.selectTtArticlesList(ttArticles);
-        if (!list.isEmpty()) {
-            return "不能重复转文章!";
+    @Transactional(rollbackFor = Exception.class)
+    public String transToArticle1(Long codeId, Long templateId) {
+        TtCopyTemplate template = ttCopyTemplateMapper.selectTtCopyTemplateByTemplateId(templateId);
+        if (template == null || !"0".equals(template.getStatus())) {
+            throw new ServiceException("所选文案模板不存在或已停用");
        }
-        ttArticles.setAuthor("Feast");
-        ttArticles.setCategory(ttCode.getPaymentType());
-        if (ttCode.getPaymentType().equals("2")) {
-            ttArticles.setAttachmentUrl(ttCode.getDiskLink());
-        }
-        StringBuffer content = new StringBuffer();
-        content.append("<p><strong>### 项目描述</strong></p>");
-        content.append(ttCode.getCodeDesc());
-        content.append("<p><strong>### 运行环境</strong></p>");
-        content.append(ttCode.getCodeEnvironment());
-        content.append("<p><strong>### 其他技术</strong></p>");
-        content.append(ttCode.getCodeTechnology());
-        ttArticles.setContent(content.toString());
-        ttArticlesMapper.insertTtArticles(ttArticles);
-        return "源码转文章成功！";
-    }
-
-    @Override
-    public String transToArticle1(Long codeId, String coverUrl) {
        TtCode ttCode = ttCodeMapper.selectTtCodeByCodeId(codeId);
+        if (ttCode == null) {
+            throw new ServiceException("源码项目不存在");
+        }
        TtProjectInfo ttProjectInfo = ttProjectInfoMapper.selectTtProjectInfoByName(ttCode.getCodeName());
+        if (ttProjectInfo == null) {
+            throw new ServiceException("未找到对应的项目清单信息");
+        }
        ttCode.setDiskLink(ttProjectInfo.getProjectBaiduUrl());
-        ttCode.setPublishFlag("Y");
-        ttCodeMapper.updateTtCode(ttCode);
-        StringBuffer content = new StringBuffer();
-        content.append("<p><strong>### 项目描述</strong></p>");
-        content.append(ttCode.getCodeDesc());
-        content.append("<p><strong>### 运行环境</strong></p>");
-        content.append(ttCode.getCodeEnvironment());
-        content.append("<p><strong>### 其他技术</strong></p>");
-        content.append(ttCode.getCodeTechnology());
-        content.append("<p><strong>### 演示视频</strong></p>");
-        content.append("请移步首页-<strong>视频资源</strong>，搜索<strong>项目编号</strong>查看");
        TtFile file = new TtFile();
        file.setCodeName(ttCode.getCodeName());
        List<TtFile> fileList = fileMapper.selectTtFileList(file);
-        AppBlogArticle article = new AppBlogArticle();
-        article.setTitle(ttCode.getCodeName());
-        List<AppBlogArticle> list = appBlogArticleMapper.selectAppBlogArticleList(article);
-        if (!list.isEmpty()) {
+        ttCode.setFileList(fileList);
+        String content = copyTemplateRenderer.render(template, ttCode);
+        String firstImageUrl = getFirstImageUrl(fileList);
+
+        AppBlogArticle existingArticle = appBlogArticleMapper.selectAppBlogArticleByTitle(ttCode.getCodeName());
+        if (existingArticle != null) {
+            if (repairIncompleteConversion(existingArticle, ttProjectInfo, content, firstImageUrl)) {
+                markCodePublished(ttCode);
+                return "源码转文章成功，已补全资源链接！";
+            }
            return "不能重复转文章!";
        }
+
        //新增资源
        AppResource resource = new AppResource();
-        resource.setExplain(content.toString());
+        resource.setExplain(content);
        resource.setResourceTitle(ttCode.getCodeName());
-        if (!fileList.isEmpty()) {
-            resource.setShowImg(fileList.get(0).getFileUrl());
+        if (!StringUtils.isEmpty(firstImageUrl)) {
+            resource.setShowImg(firstImageUrl);
        }
        resource.setResourceType(5L);
        resource.setIsShow(0L);
        resource.setIsAd(2L);
        resource.setAdNumber(100L);
+        resource.setPriceFen(0);
        resource.setCreateTime(new Date());
-        resource.setShowImg(coverUrl);
        appResourceMapper.insertAppResource(resource);
        //新增文章
+        AppBlogArticle article = new AppBlogArticle();
+        article.setTitle(ttCode.getCodeName());
        article.setArticleType(4L);
        article.setIsRecommendation(1L);
        article.setIsShow(1L);
        article.setIsAd(1L);
-        if (!fileList.isEmpty()) {
-            article.setShowImg(fileList.get(0).getFileUrl());
+        if (!StringUtils.isEmpty(firstImageUrl)) {
+            article.setShowImg(firstImageUrl);
        }
-        article.setContentInfo(content.toString());
+        article.setContentInfo(content);
        article.setAppResourceId(resource.getId());
        article.setCreateTime(new Date());
-        article.setShowImg(coverUrl);
        appBlogArticleMapper.insertAppBlogArticle(article);
        //新增资源网盘链接
-        List<AppResourceList> resourceList = new ArrayList<AppResourceList>();
-        //百度网盘
-        if(!StringUtils.isEmpty(ttProjectInfo.getProjectBaiduUrl())){
-            AppResourceList appResourceList = new AppResourceList();
-            appResourceList.setAppResourceId(resource.getId());
-            appResourceList.setListName("百度网盘");
-            appResourceList.setListUrl(ttProjectInfo.getProjectBaiduUrl());
-            resourceList.add(appResourceList);
-        }
-        //夸克网盘
-        if(!StringUtils.isEmpty(ttProjectInfo.getProjectUrl())){
-            AppResourceList appResourceList1 = new AppResourceList();
-            appResourceList1.setAppResourceId(resource.getId());
-            appResourceList1.setListName("夸克网盘");
-            appResourceList1.setListUrl(ttProjectInfo.getProjectUrl());
-            resourceList.add(appResourceList1);
-        }
+        List<AppResourceList> resourceList = buildResourceList(ttProjectInfo, resource.getId());
        if (resourceList.size() > 0)
        {
            appResourceMapper.batchAppResourceList(resourceList);
        }
+        markCodePublished(ttCode);
        return "源码转文章成功！";
    }
+
+    /**
+     * 修复旧转换流程异常后已经生成文章、但尚未写入下载链接的半成品数据。
+     */
+    private boolean repairIncompleteConversion(AppBlogArticle article, TtProjectInfo projectInfo,
+                                               String content, String firstImageUrl)
+    {
+        if (article.getAppResourceId() == null)
+        {
+            return false;
+        }
+        AppResource resource = appResourceMapper.selectAppResourceById(article.getAppResourceId());
+        if (resource == null || (resource.getAppResourceListList() != null
+                && !resource.getAppResourceListList().isEmpty()))
+        {
+            return false;
+        }
+
+        List<AppResourceList> resourceList = buildResourceList(projectInfo, resource.getId());
+        if (resourceList.isEmpty())
+        {
+            return false;
+        }
+
+        resource.setExplain(content);
+        if (!StringUtils.isEmpty(firstImageUrl))
+        {
+            resource.setShowImg(firstImageUrl);
+        }
+        resource.setPriceFen(0);
+        appResourceMapper.updateAppResource(resource);
+
+        article.setContentInfo(content);
+        if (!StringUtils.isEmpty(firstImageUrl))
+        {
+            article.setShowImg(firstImageUrl);
+        }
+        appBlogArticleMapper.updateAppBlogArticle(article);
+        appResourceMapper.batchAppResourceList(resourceList);
+        return true;
+    }
+
+    private String getFirstImageUrl(List<TtFile> fileList)
+    {
+        if (fileList == null || fileList.isEmpty())
+        {
+            return null;
+        }
+        return fileList.get(0).getFileUrl();
+    }
+
+    private List<AppResourceList> buildResourceList(TtProjectInfo projectInfo, Long resourceId)
+    {
+        List<AppResourceList> resourceList = new ArrayList<AppResourceList>();
+        addResourceList(resourceList, resourceId, "百度网盘", projectInfo.getProjectBaiduUrl());
+        addResourceList(resourceList, resourceId, "夸克网盘", projectInfo.getProjectUrl());
+        return resourceList;
+    }
+
+    private void addResourceList(List<AppResourceList> resourceList, Long resourceId,
+                                 String name, String url)
+    {
+        if (StringUtils.isEmpty(url))
+        {
+            return;
+        }
+        AppResourceList item = new AppResourceList();
+        item.setAppResourceId(resourceId);
+        item.setListName(name);
+        item.setListUrl(url);
+        item.setPassword("");
+        item.setPriceFen(0);
+        item.setStatus(1);
+        item.setSortOrder(resourceList.size());
+        resourceList.add(item);
+    }
+
+    private void markCodePublished(TtCode ttCode)
+    {
+        ttCode.setPublishFlag("Y");
+        ttCodeMapper.updateTtCode(ttCode);
+    }
 }
--- a/ruoyi-office/src/main/java/com/ruoyi/office/service/impl/TtProjectInfoServiceImpl.java
+++ b/ruoyi-office/src/main/java/com/ruoyi/office/service/impl/TtProjectInfoServiceImpl.java
@@ -39,7 +39,7 @@ import com.ruoyi.office.service.ITtProjectInfoService;
 public class TtProjectInfoServiceImpl implements ITtProjectInfoService 
 {
    private static final Pattern PROJECT_NUM_PATTERN =
-            Pattern.compile("^[【\\[]\\s*(S\\d+)\\s*[】\\]]", Pattern.CASE_INSENSITIVE);
+            Pattern.compile("【\\s*([^】]+?)\\s*】");

    private static final Pattern QUARK_URL_PATTERN =
            Pattern.compile("https://pan\\.quark\\.cn/s/[A-Za-z0-9_-]+(?:\\?[^\\s\"'<>，。；]*)?");
@@ -203,6 +203,7 @@ public class TtProjectInfoServiceImpl implements ITtProjectInfoService
            }

            TtProjectInfo project = matches.get(0);
+            backfillProjectNumIfBlank(project, row.projectName);
            String oldLink = NetDiskConstants.DISK_QUARK.equals(normalizedDiskType)
                    ? project.getProjectUrl() : project.getProjectBaiduUrl();
            if (StringUtils.equals(StringUtils.trimToEmpty(oldLink), row.linkUrl))
@@ -390,6 +391,20 @@ public class TtProjectInfoServiceImpl implements ITtProjectInfoService
        return project;
    }

+    private void backfillProjectNumIfBlank(TtProjectInfo project, String projectName)
+    {
+        if (StringUtils.isNotBlank(project.getProjectNum()))
+        {
+            return;
+        }
+        String projectNum = extractProjectNum(projectName);
+        if (StringUtils.isNotBlank(projectNum)
+                && ttProjectInfoMapper.updateProjectNumIfBlank(project.getId(), projectNum) == 1)
+        {
+            project.setProjectNum(projectNum);
+        }
+    }
+
    private String extractProjectNum(String projectName)
    {
        Matcher matcher = PROJECT_NUM_PATTERN.matcher(projectName);