soloforge 1.0.0

package/templates/scaffolds/react/service.ts.hbs

@@ -0,0 +1,37 @@
+import { {{ModuleName}} } from './types';
+
+const API_BASE = '/api/{{module_name}}s';
+
+export const {{moduleName}}Service = {
+  async list(): Promise<{{ModuleName}}[]> {
+    const res = await fetch(API_BASE);
+    return res.json();
+  },
+
+  async getById(id: number): Promise<{{ModuleName}}> {
+    const res = await fetch(`${API_BASE}/${id}`);
+    return res.json();
+  },
+
+  async create(data: Partial<{{ModuleName}}>): Promise<{{ModuleName}}> {
+    const res = await fetch(API_BASE, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data),
+    });
+    return res.json();
+  },
+
+  async update(id: number, data: Partial<{{ModuleName}}>): Promise<{{ModuleName}}> {
+    const res = await fetch(`${API_BASE}/${id}`, {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data),
+    });
+    return res.json();
+  },
+
+  async delete(id: number): Promise<void> {
+    await fetch(`${API_BASE}/${id}`, { method: 'DELETE' });
+  },
+};

package/templates/scaffolds/react/types.ts.hbs

@@ -0,0 +1,6 @@
+export interface {{ModuleName}} {
+  id: number;
+  createdAt: string;
+  updatedAt: string;
+  // TODO: 添加业务字段
+}

package/templates/scaffolds/react/use{{ModuleName}}.ts.hbs

@@ -0,0 +1,88 @@
+import { useState, useEffect, useCallback } from 'react';
+import { {{moduleName}}Service } from './service';
+import type { {{ModuleName}} } from './types';
+
+interface Use{{ModuleName}}Result {
+  data: {{ModuleName}}[];
+  loading: boolean;
+  error: string | null;
+  total: number;
+  page: number;
+  pageSize: number;
+  setPage: (page: number) => void;
+  refresh: () => void;
+}
+
+export function use{{ModuleName}}List(
+  initialPage = 1,
+  initialPageSize = 20,
+): Use{{ModuleName}}Result {
+  const [data, setData] = useState<{{ModuleName}}[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [total, setTotal] = useState(0);
+  const [page, setPage] = useState(initialPage);
+  const [pageSize] = useState(initialPageSize);
+
+  const fetchData = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await {{moduleName}}Service.list({ page, size: pageSize });
+      setData(result.records);
+      setTotal(result.total);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : '请求失败');
+    } finally {
+      setLoading(false);
+    }
+  }, [page, pageSize]);
+
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+
+  return {
+    data,
+    loading,
+    error,
+    total,
+    page,
+    pageSize,
+    setPage,
+    refresh: fetchData,
+  };
+}
+
+interface Use{{ModuleName}}DetailResult {
+  data: {{ModuleName}} | null;
+  loading: boolean;
+  error: string | null;
+  refresh: () => void;
+}
+
+export function use{{ModuleName}}Detail(id: number | null): Use{{ModuleName}}DetailResult {
+  const [data, setData] = useState<{{ModuleName}} | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchData = useCallback(async () => {
+    if (id === null) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await {{moduleName}}Service.getById(id);
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : '请求失败');
+    } finally {
+      setLoading(false);
+    }
+  }, [id]);
+
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+
+  return { data, loading, error, refresh: fetchData };
+}

package/templates/scaffolds/spring-boot/ApiContract.md.hbs

@@ -0,0 +1,110 @@
+# {{ModuleName}} API 契约文档
+
+> 自动生成于 {{date}} | 风险等级: {{riskLevel}} | 复杂度: {{complexityLevel}}
+
+## 基础信息
+
+- 模块名: {{ModuleName}}
+- 基路径: `{{basePath}}`
+- 版本: {{apiVersion}}
+
+## 接口列表
+
+### 1. 查询 {{ModuleName}} 列表
+
+```
+GET {{basePath}}
+```
+
+**请求参数:**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| page | int | 否 | 页码，默认 1 |
+| size | int | 否 | 每页条数，默认 20，最大 100 |
+
+**响应示例:**
+
+```json
+{
+  "records": [],
+  "total": 0,
+  "page": 1,
+  "size": 20,
+  "totalPages": 0
+}
+```
+
+### 2. 查询 {{ModuleName}} 详情
+
+```
+GET {{basePath}}/{id}
+```
+
+**路径参数:**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| id | Long | 记录 ID |
+
+**响应示例:**
+
+```json
+{
+  "id": 1,
+  "createdAt": "2026-01-01T00:00:00",
+  "updatedAt": "2026-01-01T00:00:00"
+}
+```
+
+### 3. 创建 {{ModuleName}}
+
+```
+POST {{basePath}}
+```
+
+**请求体:**
+
+```json
+{
+}
+```
+
+**响应:** 创建成功的对象（含 id）
+
+### 4. 更新 {{ModuleName}}
+
+```
+PUT {{basePath}}/{id}
+```
+
+**请求体:** 同创建请求体
+
+**响应:** 更新后的对象
+
+### 5. 删除 {{ModuleName}}
+
+```
+DELETE {{basePath}}/{id}
+```
+
+**响应:** 204 No Content
+
+## 错误码
+
+| 错误码 | 说明 |
+|--------|------|
+| {{MODULE_NAME}}_001 | {{ModuleName}} 不存在 |
+| {{MODULE_NAME}}_002 | {{ModuleName}} 已存在 |
+| {{MODULE_NAME}}_003 | 参数校验失败 |
+| {{MODULE_NAME}}_004 | 操作失败 |
+
+## 通用错误响应格式
+
+```json
+{
+  "code": "ERROR_CODE",
+  "message": "错误描述",
+  "timestamp": "2026-01-01T00:00:00"
+}
+```

package/templates/scaffolds/spring-boot/Controller.java.hbs

@@ -0,0 +1,43 @@
+package {{basePackage}}.controller;
+
+import {{basePackage}}.dto.{{ModuleName}}DTO;
+import {{basePackage}}.service.{{ModuleName}}Service;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/{{module_name}}s")
+public class {{ModuleName}}Controller {
+
+    private final {{ModuleName}}Service {{moduleName}}Service;
+
+    public {{ModuleName}}Controller({{ModuleName}}Service {{moduleName}}Service) {
+        this.{{moduleName}}Service = {{moduleName}}Service;
+    }
+
+    @GetMapping
+    public List<{{ModuleName}}DTO> list() {
+        return {{moduleName}}Service.list();
+    }
+
+    @GetMapping("/{id}")
+    public {{ModuleName}}DTO getById(@PathVariable Long id) {
+        return {{moduleName}}Service.getById(id);
+    }
+
+    @PostMapping
+    public {{ModuleName}}DTO create(@RequestBody {{ModuleName}}DTO dto) {
+        return {{moduleName}}Service.create(dto);
+    }
+
+    @PutMapping("/{id}")
+    public {{ModuleName}}DTO update(@PathVariable Long id, @RequestBody {{ModuleName}}DTO dto) {
+        return {{moduleName}}Service.update(id, dto);
+    }
+
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        {{moduleName}}Service.delete(id);
+    }
+}

package/templates/scaffolds/spring-boot/DTO.java.hbs

@@ -0,0 +1,9 @@
+package {{basePackage}}.dto;
+
+import lombok.Data;
+
+@Data
+public class {{ModuleName}}DTO {
+    private Long id;
+    // TODO: 添加业务字段
+}

package/templates/scaffolds/spring-boot/Entity.java.hbs

@@ -0,0 +1,12 @@
+package {{basePackage}}.entity;
+
+import lombok.Data;
+import java.time.LocalDateTime;
+
+@Data
+public class {{ModuleName}} {
+    private Long id;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+    // TODO: 添加业务字段
+}

package/templates/scaffolds/spring-boot/ErrorCode.java.hbs

@@ -0,0 +1,28 @@
+package {{basePackage}}.enums;
+
+/**
+ * {{ModuleName}} 模块错误码定义
+ */
+public enum {{ModuleName}}ErrorCode {
+
+    {{MODULE_NAME}}_NOT_FOUND("{{MODULE_NAME}}_001", "{{ModuleName}}不存在"),
+    {{MODULE_NAME}}_ALREADY_EXISTS("{{MODULE_NAME}}_002", "{{ModuleName}}已存在"),
+    {{MODULE_NAME}}_PARAM_INVALID("{{MODULE_NAME}}_003", "参数校验失败"),
+    {{MODULE_NAME}}_OPERATION_FAILED("{{MODULE_NAME}}_004", "操作失败");
+
+    private final String code;
+    private final String message;
+
+    {{ModuleName}}ErrorCode(String code, String message) {
+        this.code = code;
+        this.message = message;
+    }
+
+    public String getCode() {
+        return code;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+}

package/templates/scaffolds/spring-boot/Mapper.java.hbs

@@ -0,0 +1,9 @@
+package {{basePackage}}.mapper;
+
+import {{basePackage}}.entity.{{ModuleName}};
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface {{ModuleName}}Mapper {
+    // TODO: 定义数据访问方法
+}

package/templates/scaffolds/spring-boot/PageResponse.java.hbs

@@ -0,0 +1,29 @@
+package {{basePackage}}.dto;
+
+import java.util.List;
+
+/**
+ * 分页响应封装
+ */
+public class {{ModuleName}}PageResponse<T> {
+
+    private List<T> records;
+    private long total;
+    private int page;
+    private int size;
+    private int totalPages;
+
+    public {{ModuleName}}PageResponse(List<T> records, long total, int page, int size) {
+        this.records = records;
+        this.total = total;
+        this.page = page;
+        this.size = size;
+        this.totalPages = (int) Math.ceil((double) total / size);
+    }
+
+    public List<T> getRecords() { return records; }
+    public long getTotal() { return total; }
+    public int getPage() { return page; }
+    public int getSize() { return size; }
+    public int getTotalPages() { return totalPages; }
+}

package/templates/scaffolds/spring-boot/Service.java.hbs

@@ -0,0 +1,12 @@
+package {{basePackage}}.service;
+
+import {{basePackage}}.dto.{{ModuleName}}DTO;
+import java.util.List;
+
+public interface {{ModuleName}}Service {
+    List<{{ModuleName}}DTO> list();
+    {{ModuleName}}DTO getById(Long id);
+    {{ModuleName}}DTO create({{ModuleName}}DTO dto);
+    {{ModuleName}}DTO update(Long id, {{ModuleName}}DTO dto);
+    void delete(Long id);
+}

package/templates/scaffolds/spring-boot/ServiceImpl.java.hbs

@@ -0,0 +1,48 @@
+package {{basePackage}}.service.impl;
+
+import {{basePackage}}.dto.{{ModuleName}}DTO;
+import {{basePackage}}.entity.{{ModuleName}};
+import {{basePackage}}.mapper.{{ModuleName}}Mapper;
+import {{basePackage}}.service.{{ModuleName}}Service;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Service
+public class {{ModuleName}}ServiceImpl implements {{ModuleName}}Service {
+
+    private final {{ModuleName}}Mapper {{moduleName}}Mapper;
+
+    public {{ModuleName}}ServiceImpl({{ModuleName}}Mapper {{moduleName}}Mapper) {
+        this.{{moduleName}}Mapper = {{moduleName}}Mapper;
+    }
+
+    @Override
+    public List<{{ModuleName}}DTO> list() {
+        // TODO: 实现列表查询
+        return List.of();
+    }
+
+    @Override
+    public {{ModuleName}}DTO getById(Long id) {
+        // TODO: 实现单条查询
+        return null;
+    }
+
+    @Override
+    public {{ModuleName}}DTO create({{ModuleName}}DTO dto) {
+        // TODO: 实现创建
+        return dto;
+    }
+
+    @Override
+    public {{ModuleName}}DTO update(Long id, {{ModuleName}}DTO dto) {
+        // TODO: 实现更新
+        return dto;
+    }
+
+    @Override
+    public void delete(Long id) {
+        // TODO: 实现删除
+    }
+}

package/templates/scaffolds/spring-boot/ServiceTest.java.hbs

@@ -0,0 +1,22 @@
+package {{basePackage}}.service;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@ExtendWith(MockitoExtension.class)
+class {{ModuleName}}ServiceTest {
+
+    @InjectMocks
+    private Object {{moduleName}}Service;
+
+    @Test
+    void contextLoads() {
+        // TODO: 编写单元测试
+        assertNotNull({{moduleName}}Service);
+    }
+}