SNAPSHOT W7 已部署稳定态 — 凯迪ERP+OA一体化平台 (MET 73.3%)

恢复点(restore point)。别人改崩后可 git reset --hard 回到此提交。

== 此快照内容 ==
- 后端 oa-backend: 734 控制器 / 711 实体 (Spring Boot 3.2.5 + SQLite, 端口8091)
- 前端 modern-ui/app: Vue3+Vite, 约700页 (构建产物已在 oa-backend/src/main/resources/static)
- 数据库 oa-backend/data/oa.db: 含全部演示数据 (强制入库, 6.6MB)
- 交接文档 go.md + go-code-reference/endpoints/entities/database.md
- 多代理建设脚本 .claude/wf-*.js

== 状态 ==
- 对 凯迪科技ERP_20260507.xlsx 合规 MET ~73.3% (PARTIAL 75: 34可建+6种子/bug+35外部硬天花板)
- 安全: 5轮红队+5轮复检, default-deny分级鉴权, 连续零可利用
- W3~W7 累计补完436缺口; W8末轮(40缺口)为半成品(源码树可编译但未集成)
- 运行: cd oa-backend; java -jar build/libs/oa-backend-0.1.0.jar --server.port=8091; admin/123456

== 排除(gitignore, 可再生) ==
node_modules / oa-backend/build / .jdks / *.log / Backup-ERP-* / 弃用的OFBiz核心(只保留modern-ui)
完整文件夹备份见同目录 Backup-ERP-20260615-191517/ (含上述全部, 仅缺 node_modules)

时间戳: 20260615-191517

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

oa-backend/src/main/java/com/kaidi/oa/web/ContractTemplateController.java

@@ -0,0 +1,113 @@
+package com.kaidi.oa.web;
+
+import com.kaidi.oa.common.ApiException;
+import com.kaidi.oa.common.ApiResp;
+import com.kaidi.oa.common.NotFoundException;
+import com.kaidi.oa.domain.ContractTemplate;
+import com.kaidi.oa.repository.ContractTemplateRepository;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.Instant;
+import java.util.List;
+
+/**
+ * Contract template library in the unified contract center (business chain 3).
+ * contractType is one of 经营合同 / 采购合同 / 成本合同 / 销售合同 / 法务合同;
+ * applicableSubject is one of 总公司 / 分公司 / 集团小公司 / 不限;
+ * status is one of 启用 / 停用.
+ */
+@RestController
+@RequestMapping("/api/oa/contract-templates")
+public class ContractTemplateController {
+
+    private final ContractTemplateRepository templateRepo;
+
+    public ContractTemplateController(ContractTemplateRepository templateRepo) {
+        this.templateRepo = templateRepo;
+    }
+
+    @GetMapping
+    public ApiResp<List<ContractTemplate>> list(@RequestParam(required = false) String contractType,
+                                                @RequestParam(required = false) String status) {
+        List<ContractTemplate> list;
+        if (contractType != null && !contractType.isBlank()) {
+            list = templateRepo.findByContractType(contractType);
+        } else if (status != null && !status.isBlank()) {
+            list = templateRepo.findByStatus(status);
+        } else {
+            list = templateRepo.findAll();
+        }
+        return ApiResp.ok(list);
+    }
+
+    @GetMapping("/{id}")
+    public ApiResp<ContractTemplate> get(@PathVariable Long id) {
+        return ApiResp.ok(templateRepo.findById(id)
+                .orElseThrow(() -> new NotFoundException("contract template not found: " + id)));
+    }
+
+    /**
+     * 取模板正文（供「模板起草」页消费 bodyTemplate，并附必备条款与占位符列表）。
+     * 之前 bodyTemplate 字段已存却无页面消费（LOGIC_GAP），此端点把模板正文显式端出，
+     * 让起草页能"选模板 → 拉正文 → 填占位符 → 生成草稿"。占位符抽取 {xxx} 形式。
+     */
+    @GetMapping("/{id}/body")
+    public ApiResp<TemplateBody> body(@PathVariable Long id) {
+        ContractTemplate t = templateRepo.findById(id)
+                .orElseThrow(() -> new NotFoundException("contract template not found: " + id));
+        List<String> placeholders = extractPlaceholders(t.getBodyTemplate());
+        return ApiResp.ok(new TemplateBody(t.getId(), t.getName(), t.getContractType(),
+                t.getApplicableSubject(), t.getVersion(), t.getBodyTemplate(),
+                t.getRequiredClauses(), placeholders));
+    }
+
+    public record TemplateBody(Long id, String name, String contractType, String applicableSubject,
+                               String version, String bodyTemplate, String requiredClauses,
+                               List<String> placeholders) {
+    }
+
+    /** 抽取 {占位符} 形式的占位符名（去重保序），供起草页生成填充表单。 */
+    private static List<String> extractPlaceholders(String body) {
+        List<String> out = new java.util.ArrayList<>();
+        if (body == null || body.isBlank()) {
+            return out;
+        }
+        java.util.regex.Matcher m = java.util.regex.Pattern.compile("\\{([^{}]{1,40})\\}").matcher(body);
+        while (m.find()) {
+            String name = m.group(1).trim();
+            if (!name.isEmpty() && !out.contains(name)) {
+                out.add(name);
+            }
+        }
+        return out;
+    }
+
+    public record CreateContractTemplateRequest(
+            String name, String contractType, String applicableSubject, String bodyTemplate,
+            String requiredClauses, String version, String status, String updatedBy) {
+    }
+
+    @PostMapping
+    public ApiResp<ContractTemplate> create(@RequestBody CreateContractTemplateRequest req) {
+        if (req.name() == null || req.name().isBlank()) {
+            throw new ApiException(400, "name is required");
+        }
+        ContractTemplate t = new ContractTemplate();
+        t.setName(req.name());
+        t.setContractType(req.contractType());
+        t.setApplicableSubject(req.applicableSubject());
+        t.setBodyTemplate(req.bodyTemplate());
+        t.setRequiredClauses(req.requiredClauses());
+        t.setVersion(req.version() == null || req.version().isBlank() ? "V1.0" : req.version());
+        t.setStatus(req.status() == null || req.status().isBlank() ? "启用" : req.status());
+        t.setUpdatedBy(req.updatedBy());
+        t.setCreatedAt(Instant.now());
+        return ApiResp.ok(templateRepo.save(t));
+    }
+}