spdm-backend/README.md

# 项目名称

SPDM基线化版本

## 环境要求

- JDK 1.8+
- Maven 3.5+
- Spring Boot 2.x
- (其他依赖环境)

## 快速开始

### 项目配置

本项目使用多环境配置，请根据您的运行环境选择相应的配置文件：

1. **本地开发环境** - 使用 `application-local.yml`
2. **测试环境** - 使用 `application-dev.yml`



# 项目技术规范（v1.0）

## 一、数据库设计规范
1. **字段命名规范**
- 采用小驼峰命名法（camelCase）
- 示例：`fileName varchar(255) DEFAULT NULL COMMENT '文件名称'`
- 数据库完善表注释,必须包含字段的业务含义
- id为主键，使用Long,适配CID
- 

## 二、Feign接口规范
1. **代码组织**
- 所有Feign接口必须置于`com.sdm.common.feign.inter`模块下
- 按业务模块分包（如：`feign.inter.data`、`feign.inter.system`）

2. **接口定义**
- 接口命名必须以`FeignClient`作为后缀（例：`DataQueryFeignClient`）
- 禁止使用`JSONObject`作为输入/输出参数

3. **参数规范**
- 请求参数：统一置于`common-entity-req`包，按模块分包
- 响应参数：统一置于`common-entity-resp`包，按模块分包

4. **接口实现**
- feign接口在com.sdm.common.feign.impl和各模块controller实现，用于规范接口定义

## 三、外部接口调用规范
1. **代码组织**
- 所有外部调用代码必须置于`com.sdm.common.feign.impl`模块

2. **封装要求**
```java
/**
* 外部接口调用示例
*/
@Slf4j
@Component
public class ExternalApiWrapper {


public Result<ExternalData> getExternalData(RequestParam param) {
try {
// 1. 参数校验
validateParams(param);

// 2. 接口调用
Response response = externalClient.call(param);

// 3. 响应标准化校验
if (!response.isSuccess()) {
throw new BusinessException("ERR_EXTERNAL_API", response.getErrorMsg());
}

// 4. 数据转换
return convertResponse(response);
} catch (Exception e) {
// 5. 异常处理（必须记录完整堆栈）
log.error("[外部接口调用异常] 接口: {}, 参数: {}", "getExternalData", JSON.toJSONString(param), e);
```

## 四、代码质量规范
1. **方法规范**
- 单个方法长度不超过200行
- 遵循单一职责原则进行方法拆分

2. **异常处理**
- 必须捕获并记录完整异常堆栈
- 日志格式：`[业务标记] 描述信息 关键参数={} 异常上下文={}`

3. **文档要求**
- 所有公开方法必须包含Swagger注解
- 复杂逻辑需添加实现注释
```java
/**
* 根据任务ID获取详情
* @param taskId 任务ID（必须大于0）
* @throws BusinessException 当任务不存在时抛出404异常
*/
@ApiOperation(value = "任务详情查询")
@GetMapping("/task/{taskId}")
public Result<TaskVO> getTask(@PathVariable @Min(1) Long taskId) {
// 实现代码...
}
```

4.**mybatis-plus混乱，不要直接操作mapper**
- 使用MyBatis-Plus的Service层进行数据操作，避免直接在Mapper中重复写简单SQL，复杂SQL再写到Mapper
- 禁止直接在sql操作跨微服务的表

5.**controller层返回值指定具体类型，禁止直接用JSONObject**


```angular2html
repomix --include "**/src/main/java/**/*.java,**/src/main/resources/**/*.yml,**/pom.xml" --style xml

sed -i 's/\r$//' /home/app/*/*.sh
```