AI全栈开发（SDD)：慢病管理系统工程级设计

json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "慢病患者核心模型",
  "type": "object",
  "required": ["patientId", "basicInfo", "chronicDiseaseInfo", "createTime"],
  "properties": {
    "patientId": {
      "type": "string",
      "format": "uuid",
      "description": "患者唯一标识，全局唯一"
    },
    "basicInfo": {
      "type": "object",
      "required": ["name", "idCard", "phone", "gender", "age"],
      "properties": {
        "name": { "type": "string", "minLength": 2, "maxLength": 20 },
        "idCard": { "type": "string", "pattern": "^\\d{17}[\\dXx]$" },
        "phone": { "type": "string", "pattern": "^1[3-9]\\d{9}$" },
        "gender": { "type": "string", "enum": ["MALE", "FEMALE", "OTHER"] },
        "age": { "type": "integer", "minimum": 18, "maximum": 120 }
      }
    },
    "chronicDiseaseInfo": {
      "type": "array",
      "description": "患者绑定的慢病类型",
      "items": {
        "type": "object",
        "required": ["diseaseCode", "diseaseName", "diagnosisTime"],
        "properties": {
          "diseaseCode": { "type": "string", "enum": ["HYP", "DIA", "COR"] }, // 高血压/糖尿病/冠心病
          "diseaseName": { "type": "string" },
          "diagnosisTime": { "type": "string", "format": "date-time" }
        }
      }
    },
    "status": {
      "type": "string",
      "enum": ["NORMAL", "RISK", "CRITICAL", "FOLLOW_UP"],
      "default": "NORMAL",
      "description": "患者健康状态"
    },
    "createTime": { "type": "string", "format": "date-time" },
    "updateTime": { "type": "string", "format": "date-time" }
  }
}

规范 2：接口规范（OpenAPI 3.0）- 健康数据上报接口

工程价值：可直接生成后端控制器、前端 API 调用代码、测试用例

yaml
openapi: 3.0.3
info:
  title: 慢病管理系统 - 健康数据接口规范
  version: 1.0.0
  description: 严格遵循SDD，所有服务必须实现此接口
servers:
  - url: http://api.chronic-disease.com/v1
paths:
  /health-data/report:
    post:
      summary: 患者健康数据上报
      description: 血压/血糖/心率等核心健康数据上报，自动触发风险评估
      operationId: reportHealthData
      security:
        - BearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: ["patientId", "dataType", "measureValue", "measureTime"]
              properties:
                patientId: { type: "string", format: "uuid" }
                dataType:
                  type: "string"
                  enum: ["BLOOD_PRESSURE", "BLOOD_SUGAR", "HEART_RATE"]
                measureValue:
                  type: "object"
                  description: "根据dataType动态定义，严格匹配临床单位"
                measureTime: { type: "string", format: "date-time" }
      responses:
        '200':
          description: 上报成功，返回风险评估结果
          content:
            application/json:
              schema:
                type: object
                properties:
                  code: { type: "integer", example: 200 }
                  message: { type: "string", example: "上报成功" }
                  data:
                    type: object
                    properties:
                      riskLevel: { type: "string", enum: ["LOW", "MEDIUM", "HIGH", "CRITICAL"] }
                      advice: { type: "string" }
        '400': { description: "参数错误" }
        '401': { description: "未授权" }
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

规范 3：业务规则规范（可执行规则）

SDD 要求业务规则可编码、可校验，而非文字描述：

高血压风险评估规则

收缩压≥180 且舒张压≥110 → 极高危（CRITICAL）

收缩压 160-179 且舒张压 100-109 → 高危（HIGH）

连续 3 天数据异常 → 自动触发医生随访

用药提醒规则

患者设定用药时间后，提前 5 分钟 APP 推送提醒

2 小时内未确认用药 → 标记漏服，通知责任护士

数据权限规则

医生仅可查看自己绑定的患者数据

管理员可查看全量数据，无修改权限

患者仅可查看 / 修改自己的健康数据

四、基于 SDD 的系统架构设计（工程落地）

1. 技术栈规范（强制统一，避免技术债务）

后端：SpringBoot 3.x + SpringSecurity（权限）+ MyBatis-Plus（ORM）

接口规范：OpenAPI 3.0 + SpringDoc（自动生成文档）

数据校验：JSON Schema Validator（严格校验入参）

数据库：MySQL 8.0（业务数据）+ Redis（缓存 / 提醒）

消息队列：RabbitMQ（异步处理风险评估、提醒）

部署：Docker + Kubernetes（容器化，符合规范一致性）

2. 分层架构规范（严格遵循 SDD，代码必须按层实现）

Plain Text
├── 接口层（Controller）：严格实现OpenAPI规范，无业务逻辑
├── 业务层（Service）：实现业务规则规范，核心逻辑
├── 数据层（Repository）：遵循数据模型规范，操作数据库
├── 公共层（Common）：规范工具类（数据校验、异常、工具）
└── 启动层（Application）：项目入口，配置加载

3. 编码规范（SDD 强制约束）

所有入参 / 出参必须通过JSON Schema 校验，不允许手动校验

所有接口必须与 OpenAPI 规范完全一致，不允许私自新增 / 修改字段

业务逻辑必须严格匹配业务规则规范，不允许硬编码随意修改规则

异常处理统一规范：错误码、错误信息全局标准化

五、SDD 落地：自动生成工程代码

这是 SDD 核心优势：基于规范自动生成代码，减少 80% 重复工作

1. 工具链

OpenAPI Generator：自动生成 Controller、DTO、Feign 接口

JSON Schema2Pojo：自动生成 Java 数据模型类

自定义代码生成器：基于业务规则生成 Service 逻辑骨架

2. 自动生成代码示例（数据模型）

基于上述 JSON Schema 自动生成的ChronicPatient.java（可直接使用）：

java
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import javax.validation.constraints.*;
import java.time.LocalDateTime;
import java.util.List;

@Data
@Schema(description = "慢病患者核心模型 - 严格遵循SDD数据规范")
public class ChronicPatient {
    @NotBlank
    @Schema(description = "患者唯一标识", format = "uuid")
    private String patientId;

    @NotNull
    private BasicInfo basicInfo;

    @NotEmpty
    private List<ChronicDiseaseInfo> chronicDiseaseInfo;

    @Schema(description = "患者健康状态", defaultValue = "NORMAL")
    private PatientStatus status;

    @NotNull
    private LocalDateTime createTime;
    private LocalDateTime updateTime;

    // 内部类：基础信息（自动匹配Schema）
    @Data
    public static class BasicInfo {
        @Size(min = 2, max = 20)
        private String name;
        @Pattern(regexp = "^\\d{17}[\\dXx]$")
        private String idCard;
        @Pattern(regexp = "^1[3-9]\\d{9}$")
        private String phone;
        private Gender gender;
        @Min(18) @Max(120)
        private Integer age;
    }

    // 枚举：严格遵循规范定义
    public enum Gender { MALE, FEMALE, OTHER }
    public enum PatientStatus { NORMAL, RISK, CRITICAL, FOLLOW_UP }
}

3. 自动生成 Controller 代码

java
import io.swagger.v3.oas.annotations.tags.Tag;
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.RestController;
import javax.validation.Valid;

@RestController
@RequestMapping("/v1/health-data")
@Tag(name = "健康数据接口", description = "严格遵循OpenAPI 3.0规范")
public class HealthDataController {
    // 自动生成接口，仅需实现业务逻辑
    @PostMapping("/report")
    public HealthDataResponse reportHealthData(@Valid @RequestBody HealthDataRequest request) {
        // 业务实现：调用Service，遵循业务规则规范
        return healthDataService.report(request);
    }
}

六、核心业务模块工程实现（基于 SDD 规范）

模块 1：健康数据上报与风险评估（核心流程）

1. 流程规范（SDD 定义）

患者 APP 上报数据 → 接口层校验（Schema 规范）

数据落库 → 异步发送消息到 MQ

消费 MQ → 执行风险评估规则（业务规范）

返回评估结果 → 推送提醒给患者 / 医生

2. 核心业务代码（合规实现）

java
@Service
public class HealthDataServiceImpl implements HealthDataService {
    private final SchemaValidator schemaValidator;
    private final RabbitTemplate rabbitTemplate;
    private final HealthDataRepository repository;

    // 1. 数据上报：严格遵循规范校验
    @Override
    public HealthDataResponse reportHealthData(HealthDataRequest request) {
        // 步骤1：JSON Schema强校验（SDD强制要求）
        schemaValidator.validate(request);
        // 步骤2：转换为规范数据模型并保存
        HealthDataEntity entity = convertToEntity(request);
        repository.insert(entity);
        // 步骤3：异步触发风险评估（解耦，符合规范）
        rabbitTemplate.convertAndSend("health.data.queue", entity);
        // 步骤4：返回标准响应格式
        return buildSuccessResponse();
    }

    // 2. 风险评估：严格实现业务规则规范
    @RabbitListener(queues = "health.data.queue")
    public void riskAssessment(HealthDataEntity entity) {
        if ("BLOOD_PRESSURE".equals(entity.getDataType())) {
            BloodPressureValue value = (BloodPressureValue) entity.getMeasureValue();
            // 严格按照高血压临床指南规则判断
            if (value.getSystolic() >= 180 && value.getDiastolic() >= 110) {
                updatePatientRisk(entity.getPatientId(), "CRITICAL");
                // 触发随访提醒
                followUpService.createFollowUpTask(entity.getPatientId(), "血压极高危，立即干预");
            }
        }
    }
}

模块 2：随访管理模块

严格遵循 SDD 规范：接口标准化、数据标准化、业务规则标准化

支持医生创建随访计划

自动提醒患者 / 医生

随访记录可追溯、符合医疗合规

七、SDD 配套：测试规范（自动生成测试用例）

SDD 模式下，测试用例由规范自动生成，无需手动编写：

接口测试：基于 OpenAPI 生成 Postman 脚本、JUnit 接口测试

数据测试：基于 JSON Schema 生成参数合法性测试（空值、格式、枚举）

业务测试：基于业务规则生成场景化测试（高危数据、漏服提醒）

示例自动生成的单元测试：

java
@Test
void testReportHealthData_InvalidPhone() {
    // 测试不合法手机号（违反Schema规范）
    HealthDataRequest request = new HealthDataRequest();
    request.setPatientId("invalid-id");
    // 预期：抛出Schema校验异常，符合SDD规范
    assertThrows(SchemaValidationException.class, () -> service.reportHealthData(request));
}