API 레퍼런스

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "studentId": {
            "type": "string",
            "description": "학원 내 실제 학생 번호입니다.",
            "nullable": false
          },
          "studentName": {
            "type": "string",
            "description": "학생 번호에 해당하는 실제 학생 이름입니다.",
            "nullable": false
          },
          "enrollment": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
                "nullable": false
              },
              "studentId": {
                "type": "string",
                "description": "학원 내 학생 고유 번호입니다. 학생 조회에서 받은 문자열을 그대로 사용합니다.",
                "nullable": false
              },
              "teamId": {
                "type": "integer",
                "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
                "nullable": false
              },
              "scheduleId": {
                "type": "integer",
                "description": "수강반 시간표 고유 번호입니다. 해당 반의 시간표여야 합니다.",
                "nullable": false
              },
              "teamName": {
                "type": "string",
                "description": "수강반 이름입니다.",
                "nullable": false
              },
              "scheduleName": {
                "type": "string",
                "description": "시간표 표시 이름입니다.",
                "nullable": false
              },
              "beginDate": {
                "type": "integer",
                "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
                "nullable": false
              },
              "endDate": {
                "type": "integer",
                "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
                "nullable": false
              },
              "endType": {
                "type": "string",
                "description": "저장된 수강 종료 사유입니다. 빈 문자열, 퇴원, 전반, 종강, 전반취소를 사용합니다. 최대 20자이며 기존의 미확인 사유도 보존합니다. 이미 시작한 수강의 미래 종료는 active, 미래 시작은 upcoming이며 전반취소는 시작일과 관계없이 항상 cancelled입니다.",
                "nullable": false,
                "maxLength": 20
              },
              "changeDate": {
                "type": "integer",
                "description": "전반으로 종료되는 기존 수강 건의 전반일입니다. yyyyMMdd 정수이며 0은 미설정입니다.",
                "nullable": false
              },
              "scheduleDay": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 요일입니다. 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "scheduleFrom": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 시작 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "scheduleTo": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 종료 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "transferFromId": {
                "type": "integer",
                "description": "전반 전의 기존 수강 건 번호입니다. 연결 없는 과거 자료는 null입니다.",
                "nullable": true
              },
              "transferDate": {
                "type": "integer",
                "description": "새 반으로 전반한 지정일입니다. yyyyMMdd 정수, 0은 연결 없음입니다.",
                "nullable": false
              },
              "previousTeamName": {
                "type": "string",
                "description": "전반 이전 반·시간표 표시명입니다.",
                "nullable": false
              },
              "isTransfer": {
                "type": "boolean",
                "description": "명시적인 이전 수강 연결값이 있는 전반 등록인지 나타냅니다.",
                "nullable": false
              },
              "isTransferCancelled": {
                "type": "boolean",
                "description": "전반 취소 이력인지 나타냅니다. 취소해도 출결·수납 자료와 수강 건은 보존됩니다.",
                "nullable": false
              },
              "transferCancelledAt": {
                "type": "string",
                "format": "date-time",
                "description": "전반 취소 시각(UTC)입니다. 취소 전에는 null입니다.",
                "nullable": true
              },
              "classEndDate": {
                "type": "integer",
                "description": "반 자체의 종강일입니다. 학생별 endDate와 별개인 yyyyMMdd 정수이며 0은 미설정입니다.",
                "nullable": false
              },
              "effectiveEndDate": {
                "type": "integer",
                "description": "조회 시 적용할 종료일입니다. 학생별 종료일이 없으면 반 종강일을 사용하며 종료 사유는 추정하지 않습니다.",
                "nullable": false
              },
              "isEnded": {
                "type": "boolean",
                "description": "한국 날짜를 기준으로 종료 효력이 발생했는지 나타냅니다. 일반 미래 종료는 false지만 전반 취소 이력은 시작일과 관계없이 항상 true입니다.",
                "nullable": false
              },
              "status": {
                "type": "string",
                "description": "수강 시작 전, 수강중, 퇴원, 전반, 종강, 전반 취소, 종료(구분 미확인) 또는 종료 예정 상태입니다. 미래 시작은 현재 수강중이 아니며, 예정 종료 사유는 함께 표시합니다.",
                "nullable": false
              },
              "statusCode": {
                "type": "string",
                "description": "상태 표시 코드입니다. upcoming(미래 시작), active, retired, transferred, ended, cancelled, unknown 중 하나입니다. 전반 취소는 시작일과 관계없이 cancelled입니다.",
                "nullable": false
              }
            },
            "required": [
              "id",
              "studentId",
              "teamId",
              "scheduleId",
              "teamName",
              "scheduleName",
              "beginDate",
              "endDate",
              "endType",
              "changeDate",
              "scheduleDay",
              "scheduleFrom",
              "scheduleTo",
              "transferFromId",
              "transferDate",
              "previousTeamName",
              "isTransfer",
              "isTransferCancelled",
              "transferCancelledAt",
              "classEndDate",
              "effectiveEndDate",
              "isEnded",
              "status",
              "statusCode"
            ],
            "description": "정확한 수강 기록과 명시된 종료 사유·효력일·전반 출처입니다.",
            "nullable": false
          }
        },
        "required": [
          "studentId",
          "studentName",
          "enrollment"
        ]
      },
      "description": "현재 페이지의 조회 결과 배열입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "현재 페이지 번호입니다. 1부터 시작합니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "한 페이지에 반환하는 자료 수입니다. 1~100입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "검색 조건에 맞는 전체 자료 수입니다.",
      "nullable": false
    }
  },
  "required": [
    "items",
    "page",
    "pageSize",
    "total"
  ]
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "이름 또는 표시 명칭입니다.",
            "nullable": false
          },
          "grade": {
            "type": "string",
            "description": "학년 표시값입니다.",
            "nullable": false
          },
          "subject": {
            "type": "string",
            "description": "수강반의 과목 이름입니다.",
            "nullable": false
          },
          "level": {
            "type": "string",
            "description": "수강반의 수준 또는 단계 이름입니다.",
            "nullable": false
          },
          "beginDate": {
            "type": "integer",
            "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": false
          },
          "endDate": {
            "type": "integer",
            "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": false
          },
          "teacherIds": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "담당 선생님 번호 배열입니다. 선생님 선택 목록에서 받은 번호만 사용합니다.",
            "nullable": false
          },
          "teachers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
                  "nullable": false
                },
                "name": {
                  "type": "string",
                  "description": "이름 또는 표시 명칭입니다.",
                  "nullable": false
                }
              },
              "required": [
                "id",
                "name"
              ]
            },
            "description": "담당 번호에 대응하는 선생님 id·name 목록. 현재 권한으로 확인되지 않은 번호는 포함하지 않습니다.",
            "nullable": false
          },
          "schedules": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
                  "nullable": false
                },
                "teamId": {
                  "type": "integer",
                  "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
                  "nullable": false
                },
                "day": {
                  "type": "string",
                  "enum": [
                    "월",
                    "화",
                    "수",
                    "목",
                    "금",
                    "토",
                    "일"
                  ],
                  "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
                  "nullable": false
                },
                "from": {
                  "type": "string",
                  "description": "수업 시작 시각입니다. HHmm 형식입니다.",
                  "nullable": false
                },
                "to": {
                  "type": "string",
                  "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
                  "nullable": false
                },
                "beginDate": {
                  "type": "string",
                  "description": "시간표 적용 시작일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
                  "nullable": false
                },
                "endDate": {
                  "type": "string",
                  "description": "시간표 적용 종료일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
                  "nullable": false
                },
                "kind": {
                  "type": "integer",
                  "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
                  "nullable": false
                }
              },
              "required": [
                "id",
                "teamId",
                "day",
                "from",
                "to",
                "beginDate",
                "endDate",
                "kind"
              ]
            },
            "description": "이 반의 저장된 주간 시간표. 요일·시작/종료 시각·적용 기간·상담 여부를 함께 확인. 미래·종료 시간표를 현재 시간표로 단정하지 않음.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "name",
          "grade",
          "subject",
          "level",
          "beginDate",
          "endDate",
          "teacherIds",
          "teachers",
          "schedules"
        ]
      },
      "description": "현재 페이지의 수강반 배열입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "현재 페이지 번호입니다. 1부터 시작합니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "한 페이지의 자료 수입니다. 1~100입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "검색 조건에 맞는 전체 수강반 수입니다.",
      "nullable": false
    },
    "appliedSort": {
      "type": "string",
      "description": "실제로 적용한 정렬입니다. id_asc는 등록번호 오름차순, id_desc는 최신 등록번호순, begin_date_asc/desc는 개강일 순입니다. 같은 개강일은 등록번호로 정렬합니다.",
      "nullable": false
    },
    "appliedStatus": {
      "type": "string",
      "description": "적용된 종강 필터입니다. all은 전체, open은 미종강(미래 개강·종강 포함), closed는 종강입니다.",
      "nullable": false
    },
    "referenceDate": {
      "type": "integer",
      "description": "종강 상태를 판정한 한국 오늘 날짜입니다. yyyyMMdd 정수입니다. 종강일이 이 날짜 이하이면 종강입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    },
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다.",
      "nullable": false
    },
    "subject": {
      "type": "string",
      "description": "수강반의 과목 이름입니다.",
      "nullable": false
    },
    "level": {
      "type": "string",
      "description": "수강반의 수준 또는 단계 이름입니다.",
      "nullable": false
    },
    "beginDate": {
      "type": "integer",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false
    },
    "endDate": {
      "type": "integer",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false
    },
    "teacherIds": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "담당 선생님 번호 배열입니다. 선생님 선택 목록에서 받은 번호만 사용합니다.",
      "nullable": false
    },
    "teachers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "이름 또는 표시 명칭입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "description": "담당 번호에 대응하는 선생님 id·name 목록. 현재 권한으로 확인되지 않은 번호는 포함하지 않습니다.",
      "nullable": false
    },
    "schedules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "teamId": {
            "type": "integer",
            "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
            "nullable": false
          },
          "day": {
            "type": "string",
            "enum": [
              "월",
              "화",
              "수",
              "목",
              "금",
              "토",
              "일"
            ],
            "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
            "nullable": false
          },
          "from": {
            "type": "string",
            "description": "수업 시작 시각입니다. HHmm 형식입니다.",
            "nullable": false
          },
          "to": {
            "type": "string",
            "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
            "nullable": false
          },
          "beginDate": {
            "type": "string",
            "description": "시간표 적용 시작일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
            "nullable": false
          },
          "endDate": {
            "type": "string",
            "description": "시간표 적용 종료일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
            "nullable": false
          },
          "kind": {
            "type": "integer",
            "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "teamId",
          "day",
          "from",
          "to",
          "beginDate",
          "endDate",
          "kind"
        ]
      },
      "description": "이 반의 저장된 주간 시간표. 요일·시작/종료 시각·적용 기간·상담 여부를 함께 확인. 미래·종료 시간표를 현재 시간표로 단정하지 않음.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "name",
    "grade",
    "subject",
    "level",
    "beginDate",
    "endDate",
    "teacherIds",
    "teachers",
    "schedules"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false,
      "maxLength": 70,
      "minLength": 1,
      "example": "수학 A반"
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다. 한글 5자 또는 영문·숫자 10자 이내이며 혼합 문자는 저장 바이트 한도를 적용합니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "subject": {
      "type": "string",
      "description": "수강반의 과목 이름입니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "level": {
      "type": "string",
      "description": "수강반의 수준 또는 단계 이름입니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "teacherIds": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "GET /v1/teams/teachers 응답 data[].id에서 선택한 선생님 번호들을 배열로 전달합니다. 예: [12, 13]. 선생님 이름이나 문자열 로그인 아이디 대신 목록 id를 정수로 변환해 사용하세요. 빈 배열 []는 담당 미지정이며 0은 기본 선생님 번호가 아닙니다.",
      "nullable": false,
      "maxItems": 30
    }
  },
  "required": [
    "name",
    "teacherIds"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false,
      "maxLength": 70,
      "minLength": 1,
      "example": "수학 A반"
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다. 한글 5자 또는 영문·숫자 10자 이내이며 혼합 문자는 저장 바이트 한도를 적용합니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "subject": {
      "type": "string",
      "description": "수강반의 과목 이름입니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "level": {
      "type": "string",
      "description": "수강반의 수준 또는 단계 이름입니다.",
      "nullable": false,
      "maxLength": 70,
      "default": ""
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "teacherIds": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "GET /v1/teams/teachers 응답 data[].id에서 선택한 선생님 번호들을 배열로 전달합니다. 예: [12, 13]. 선생님 이름이나 문자열 로그인 아이디 대신 목록 id를 정수로 변환해 사용하세요. 빈 배열 []는 담당 미지정이며 0은 기본 선생님 번호가 아닙니다.",
      "nullable": false,
      "maxItems": 30
    }
  },
  "required": [
    "name",
    "teacherIds"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "조회한 한국 날짜입니다. yyyy-MM-dd 형식입니다.",
            "nullable": false
          },
          "teamId": {
            "type": "integer",
            "description": "인증 학원의 수강반 번호입니다.",
            "nullable": false
          },
          "teamName": {
            "type": "string",
            "description": "저장된 원본 수강반명입니다.",
            "nullable": false
          },
          "scheduleId": {
            "type": "integer",
            "description": "이 수업의 시간표 번호입니다.",
            "nullable": false
          },
          "day": {
            "type": "string",
            "enum": [
              "월",
              "화",
              "수",
              "목",
              "금",
              "토",
              "일"
            ],
            "description": "시간표의 요일입니다.",
            "nullable": false
          },
          "from": {
            "type": "string",
            "description": "수업 시작 시각입니다. HH:mm 형식입니다.",
            "nullable": false
          },
          "to": {
            "type": "string",
            "description": "수업 종료 시각입니다. HH:mm 형식입니다.",
            "nullable": false
          },
          "studentCount": {
            "type": "integer",
            "description": "해당 날짜에 이 반·시간표에 재원 중인 고유 학생 수입니다. 종료 효력일·전반 취소·삭제를 반영하며 저장 출석 인원과 구분합니다.",
            "nullable": false
          },
          "teachers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
                  "nullable": false
                },
                "name": {
                  "type": "string",
                  "description": "이름 또는 표시 명칭입니다.",
                  "nullable": false
                }
              },
              "required": [
                "id",
                "name"
              ]
            },
            "description": "이 수강반에 실제 연결된 권한 내 담당 선생님 번호·이름. 비어 있으면 목록의 유일한 선생님으로 추측하지 않음.",
            "nullable": false
          }
        },
        "required": [
          "date",
          "teamId",
          "teamName",
          "scheduleId",
          "day",
          "from",
          "to",
          "studentCount",
          "teachers"
        ]
      },
      "description": "현재 페이지의 조회 결과 배열입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "현재 페이지 번호입니다. 1부터 시작합니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "한 페이지에 반환하는 자료 수입니다. 1~100입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "검색 조건에 맞는 전체 자료 수입니다.",
      "nullable": false
    }
  },
  "required": [
    "items",
    "page",
    "pageSize",
    "total"
  ]
}

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
        "nullable": false
      },
      "teamId": {
        "type": "integer",
        "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
        "nullable": false
      },
      "day": {
        "type": "string",
        "enum": [
          "월",
          "화",
          "수",
          "목",
          "금",
          "토",
          "일"
        ],
        "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
        "nullable": false
      },
      "from": {
        "type": "string",
        "description": "수업 시작 시각입니다. HHmm 형식입니다.",
        "nullable": false
      },
      "to": {
        "type": "string",
        "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
        "nullable": false
      },
      "beginDate": {
        "type": "string",
        "description": "시간표 적용 시작일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
        "nullable": false
      },
      "endDate": {
        "type": "string",
        "description": "시간표 적용 종료일입니다. yyyyMMdd 문자열이며 0은 미설정입니다.",
        "nullable": false
      },
      "kind": {
        "type": "integer",
        "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
        "nullable": false
      }
    },
    "required": [
      "id",
      "teamId",
      "day",
      "from",
      "to",
      "beginDate",
      "endDate",
      "kind"
    ]
  }
}

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "enum": [
        "월",
        "화",
        "수",
        "목",
        "금",
        "토",
        "일"
      ],
      "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
      "nullable": false,
      "minLength": 1
    },
    "from": {
      "type": "string",
      "description": "수업 시작 시각입니다. HHmm 형식입니다.",
      "nullable": false,
      "minLength": 1,
      "example": "1600"
    },
    "to": {
      "type": "string",
      "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
      "nullable": false,
      "minLength": 1,
      "example": "1730"
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "kind": {
      "type": "integer",
      "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2,
      "default": 1
    }
  },
  "required": [
    "day",
    "from",
    "to"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "enum": [
        "월",
        "화",
        "수",
        "목",
        "금",
        "토",
        "일"
      ],
      "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
      "nullable": false,
      "minLength": 1
    },
    "from": {
      "type": "string",
      "description": "수업 시작 시각입니다. HHmm 형식입니다.",
      "nullable": false,
      "minLength": 1,
      "example": "1600"
    },
    "to": {
      "type": "string",
      "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
      "nullable": false,
      "minLength": 1,
      "example": "1730"
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": true
    },
    "kind": {
      "type": "integer",
      "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2,
      "default": 1
    }
  },
  "required": [
    "day",
    "from",
    "to"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
        "nullable": false
      },
      "name": {
        "type": "string",
        "description": "이름 또는 표시 명칭입니다.",
        "nullable": false
      }
    },
    "required": [
      "id",
      "name"
    ]
  }
}

{
  "type": "object",
  "properties": {
    "team": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "이름 또는 표시 명칭입니다.",
          "nullable": false,
          "maxLength": 70,
          "minLength": 1,
          "example": "수학 A반"
        },
        "grade": {
          "type": "string",
          "description": "학년 표시값입니다. 한글 5자 또는 영문·숫자 10자 이내이며 혼합 문자는 저장 바이트 한도를 적용합니다.",
          "nullable": false,
          "maxLength": 70,
          "default": ""
        },
        "subject": {
          "type": "string",
          "description": "수강반의 과목 이름입니다.",
          "nullable": false,
          "maxLength": 70,
          "default": ""
        },
        "level": {
          "type": "string",
          "description": "수강반의 수준 또는 단계 이름입니다.",
          "nullable": false,
          "maxLength": 70,
          "default": ""
        },
        "beginDate": {
          "type": "string",
          "format": "date",
          "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
          "nullable": true
        },
        "endDate": {
          "type": "string",
          "format": "date",
          "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
          "nullable": true
        },
        "teacherIds": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "GET /v1/teams/teachers 응답 data[].id에서 선택한 선생님 번호들을 배열로 전달합니다. 예: [12, 13]. 선생님 이름이나 문자열 로그인 아이디 대신 목록 id를 정수로 변환해 사용하세요. 빈 배열 []는 담당 미지정이며 0은 기본 선생님 번호가 아닙니다.",
          "nullable": false,
          "maxItems": 30
        }
      },
      "required": [
        "name",
        "teacherIds"
      ],
      "description": "새로 등록할 수강반 기본정보입니다. 담당 선생님은 GET /v1/teams/teachers의 실제 번호를 사용합니다. 기존 수강반 수정은 별도 API를 사용하세요.",
      "nullable": false
    },
    "schedules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string",
            "enum": [
              "월",
              "화",
              "수",
              "목",
              "금",
              "토",
              "일"
            ],
            "description": "요일입니다. 월·화·수·목·금·토·일 중 하나입니다.",
            "nullable": false,
            "minLength": 1
          },
          "from": {
            "type": "string",
            "description": "수업 시작 시각입니다. HHmm 형식입니다.",
            "nullable": false,
            "minLength": 1,
            "example": "1600"
          },
          "to": {
            "type": "string",
            "description": "수업 종료 시각입니다. HHmm 형식이며 시작 시각보다 늦어야 합니다.",
            "nullable": false,
            "minLength": 1,
            "example": "1730"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": true
          },
          "kind": {
            "type": "integer",
            "description": "시간표 종류입니다. 1은 수업, 2는 상담입니다.",
            "nullable": false,
            "minimum": 1,
            "maximum": 2,
            "default": 1
          }
        },
        "required": [
          "day",
          "from",
          "to"
        ]
      },
      "description": "함께 새로 등록할 시간표 1~100개입니다. 수강반과 모든 시간표가 하나의 트랜잭션으로 저장되며 하나라도 실패하면 전부 취소됩니다. 요일과 HHmm 시각, 시작일을 지정하세요.",
      "nullable": false,
      "minItems": 1,
      "maxItems": 100
    }
  },
  "required": [
    "team",
    "schedules"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "새로 등록한 수강반 번호입니다. 이후 수강 등록·수업 등록의 teamId에 사용합니다.",
      "nullable": false
    },
    "scheduleIds": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "입력한 시간표 순서대로 반환한 실제 시간표 번호입니다. 같은 반의 scheduleId로 사용하며 다시 시간표를 등록하지 마세요.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "scheduleIds"
  ]
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "GET /v1/students 응답 data.items[].id에서 선택한 학생 번호 문자열입니다. 예: 00000001. 이름·전화번호가 아니며 앞자리 0을 유지하세요.",
      "nullable": false,
      "minLength": 1
    },
    "teamId": {
      "type": "integer",
      "description": "GET /v1/teams 응답 data.items[].id에서 선택한 수강반 번호입니다. 반 이름이 아닌 정수 id를 전달합니다.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2147483647
    },
    "scheduleId": {
      "type": "integer",
      "description": "GET /v1/teams/{teamId}/schedules 응답 data[].id에서 선택합니다. 지정한 반에 속한 시간표 번호를 전달하세요.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2147483647
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false,
      "minLength": 1
    }
  },
  "required": [
    "studentId",
    "teamId",
    "scheduleId",
    "beginDate"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "수강 등록한 학생 번호 문자열입니다. 기존 id 응답과 호환되며, 수강 이력 변경에는 enrollmentId를 사용하세요.",
      "nullable": false
    },
    "enrollmentId": {
      "type": "integer",
      "description": "이번에 생성한 수강 이력의 정수 번호입니다. 수강 이력 조회 응답 data[].id와 같으며 등록일 수정·퇴원·전반 요청의 enrollmentId에 사용합니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "enrollmentId"
  ]
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "이름 또는 표시 명칭입니다.",
            "nullable": false
          },
          "school": {
            "type": "string",
            "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
            "nullable": false
          },
          "grade": {
            "type": "string",
            "description": "학년 표시값입니다.",
            "nullable": false
          },
          "major": {
            "type": "string",
            "description": "계열 또는 전공 구분값입니다.",
            "nullable": false
          },
          "studentPhone": {
            "type": "string",
            "description": "학생 휴대전화 번호입니다.",
            "nullable": false
          },
          "parentPhone": {
            "type": "string",
            "description": "보호자 연락처입니다.",
            "nullable": false
          },
          "paymentPhone": {
            "type": "string",
            "description": "결제 안내를 받을 연락처입니다.",
            "nullable": false
          },
          "email": {
            "type": "string",
            "description": "이메일 주소입니다.",
            "nullable": false
          },
          "memo": {
            "type": "string",
            "description": "학생 관리용 메모입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "name",
          "school",
          "grade",
          "major",
          "studentPhone",
          "parentPhone",
          "paymentPhone",
          "email",
          "memo"
        ]
      },
      "description": "현재 페이지의 조회 결과 배열입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "현재 페이지 번호입니다. 1부터 시작합니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "한 페이지에 반환하는 자료 수입니다. 1~100입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "검색 조건에 맞는 전체 자료 수입니다.",
      "nullable": false
    }
  },
  "required": [
    "items",
    "page",
    "pageSize",
    "total"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
      "nullable": false
    },
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다.",
      "nullable": false
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "name",
    "school",
    "grade",
    "major",
    "studentPhone",
    "parentPhone",
    "paymentPhone",
    "email",
    "memo"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false,
      "maxLength": 40,
      "minLength": 1,
      "example": "예시 학생"
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false,
      "maxLength": 20,
      "default": ""
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다. 한글 5자 또는 영문·숫자 10자 이내이며 혼합 문자는 저장 바이트 한도를 적용합니다.",
      "nullable": false,
      "maxLength": 10,
      "default": ""
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false,
      "maxLength": 10,
      "default": ""
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false,
      "maxLength": 15,
      "default": ""
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false,
      "maxLength": 40,
      "default": ""
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false,
      "maxLength": 15,
      "default": ""
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false,
      "maxLength": 30,
      "default": ""
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false,
      "maxLength": 2000,
      "default": ""
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "description": "학생 등록일입니다. yyyy-MM-dd 형식이며 생략하면 서비스의 기본 등록일을 사용합니다.",
      "nullable": true
    }
  },
  "required": [
    "name"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
      "nullable": false
    },
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다.",
      "nullable": false
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "name",
    "school",
    "grade",
    "major",
    "studentPhone",
    "parentPhone",
    "paymentPhone",
    "email",
    "memo"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false,
      "maxLength": 40,
      "minLength": 1,
      "example": "예시 학생"
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false,
      "maxLength": 20,
      "default": ""
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다. 한글 5자 또는 영문·숫자 10자 이내이며 혼합 문자는 저장 바이트 한도를 적용합니다.",
      "nullable": false,
      "maxLength": 10,
      "default": ""
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false,
      "maxLength": 10,
      "default": ""
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false,
      "maxLength": 15,
      "default": ""
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false,
      "maxLength": 40,
      "default": ""
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false,
      "maxLength": 15,
      "default": ""
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false,
      "maxLength": 30,
      "default": ""
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false,
      "maxLength": 2000,
      "default": ""
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "description": "학생 등록일입니다. yyyy-MM-dd 형식이며 생략하면 서비스의 기본 등록일을 사용합니다.",
      "nullable": true
    }
  },
  "required": [
    "name"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
      "nullable": false
    },
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다.",
      "nullable": false
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "name",
    "school",
    "grade",
    "major",
    "studentPhone",
    "parentPhone",
    "paymentPhone",
    "email",
    "memo"
  ]
}

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "description": "수정할 학생 필드입니다. name, school, grade, major, studentPhone, parentPhone, paymentPhone, email, memo 중 하나입니다.",
      "nullable": false,
      "minLength": 1,
      "enum": [
        "name",
        "school",
        "grade",
        "major",
        "studentPhone",
        "parentPhone",
        "paymentPhone",
        "email",
        "memo"
      ]
    },
    "value": {
      "type": "string",
      "description": "사용자가 명시한 변경값입니다. 새 값을 모르면 먼저 질문하고 임의로 생성하지 마세요. 빈 값은 사용자가 비우기를 요청한 경우에만 내용을 비웁니다. 최대 길이: name 40, school 20, grade·major 10, studentPhone·paymentPhone 15, parentPhone 40, email 30, memo 2000자입니다.",
      "nullable": false,
      "maxLength": 2000,
      "default": ""
    }
  },
  "required": [
    "field"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
        "nullable": false
      },
      "studentId": {
        "type": "string",
        "description": "학원 내 학생 고유 번호입니다. 학생 조회에서 받은 문자열을 그대로 사용합니다.",
        "nullable": false
      },
      "teamId": {
        "type": "integer",
        "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
        "nullable": false
      },
      "scheduleId": {
        "type": "integer",
        "description": "수강반 시간표 고유 번호입니다. 해당 반의 시간표여야 합니다.",
        "nullable": false
      },
      "teamName": {
        "type": "string",
        "description": "수강반 이름입니다.",
        "nullable": false
      },
      "scheduleName": {
        "type": "string",
        "description": "시간표 표시 이름입니다.",
        "nullable": false
      },
      "beginDate": {
        "type": "integer",
        "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
        "nullable": false
      },
      "endDate": {
        "type": "integer",
        "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
        "nullable": false
      },
      "endType": {
        "type": "string",
        "description": "저장된 수강 종료 사유입니다. 빈 문자열, 퇴원, 전반, 종강, 전반취소를 사용합니다. 최대 20자이며 기존의 미확인 사유도 보존합니다. 이미 시작한 수강의 미래 종료는 active, 미래 시작은 upcoming이며 전반취소는 시작일과 관계없이 항상 cancelled입니다.",
        "nullable": false,
        "maxLength": 20
      },
      "changeDate": {
        "type": "integer",
        "description": "전반으로 종료되는 기존 수강 건의 전반일입니다. yyyyMMdd 정수이며 0은 미설정입니다.",
        "nullable": false
      },
      "scheduleDay": {
        "type": "string",
        "description": "해당 수강 시간표의 실제 요일입니다. 없으면 빈 문자열입니다.",
        "nullable": false
      },
      "scheduleFrom": {
        "type": "string",
        "description": "해당 수강 시간표의 실제 시작 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
        "nullable": false
      },
      "scheduleTo": {
        "type": "string",
        "description": "해당 수강 시간표의 실제 종료 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
        "nullable": false
      },
      "transferFromId": {
        "type": "integer",
        "description": "전반 전의 기존 수강 건 번호입니다. 연결 없는 과거 자료는 null입니다.",
        "nullable": true
      },
      "transferDate": {
        "type": "integer",
        "description": "새 반으로 전반한 지정일입니다. yyyyMMdd 정수, 0은 연결 없음입니다.",
        "nullable": false
      },
      "previousTeamName": {
        "type": "string",
        "description": "전반 이전 반·시간표 표시명입니다.",
        "nullable": false
      },
      "isTransfer": {
        "type": "boolean",
        "description": "명시적인 이전 수강 연결값이 있는 전반 등록인지 나타냅니다.",
        "nullable": false
      },
      "isTransferCancelled": {
        "type": "boolean",
        "description": "전반 취소 이력인지 나타냅니다. 취소해도 출결·수납 자료와 수강 건은 보존됩니다.",
        "nullable": false
      },
      "transferCancelledAt": {
        "type": "string",
        "format": "date-time",
        "description": "전반 취소 시각(UTC)입니다. 취소 전에는 null입니다.",
        "nullable": true
      },
      "classEndDate": {
        "type": "integer",
        "description": "반 자체의 종강일입니다. 학생별 endDate와 별개인 yyyyMMdd 정수이며 0은 미설정입니다.",
        "nullable": false
      },
      "effectiveEndDate": {
        "type": "integer",
        "description": "조회 시 적용할 종료일입니다. 학생별 종료일이 없으면 반 종강일을 사용하며 종료 사유는 추정하지 않습니다.",
        "nullable": false
      },
      "isEnded": {
        "type": "boolean",
        "description": "한국 날짜를 기준으로 종료 효력이 발생했는지 나타냅니다. 일반 미래 종료는 false지만 전반 취소 이력은 시작일과 관계없이 항상 true입니다.",
        "nullable": false
      },
      "status": {
        "type": "string",
        "description": "수강 시작 전, 수강중, 퇴원, 전반, 종강, 전반 취소, 종료(구분 미확인) 또는 종료 예정 상태입니다. 미래 시작은 현재 수강중이 아니며, 예정 종료 사유는 함께 표시합니다.",
        "nullable": false
      },
      "statusCode": {
        "type": "string",
        "description": "상태 표시 코드입니다. upcoming(미래 시작), active, retired, transferred, ended, cancelled, unknown 중 하나입니다. 전반 취소는 시작일과 관계없이 cancelled입니다.",
        "nullable": false
      }
    },
    "required": [
      "id",
      "studentId",
      "teamId",
      "scheduleId",
      "teamName",
      "scheduleName",
      "beginDate",
      "endDate",
      "endType",
      "changeDate",
      "scheduleDay",
      "scheduleFrom",
      "scheduleTo",
      "transferFromId",
      "transferDate",
      "previousTeamName",
      "isTransfer",
      "isTransferCancelled",
      "transferCancelledAt",
      "classEndDate",
      "effectiveEndDate",
      "isEnded",
      "status",
      "statusCode"
    ]
  }
}

{
  "type": "object",
  "properties": {
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false,
      "minLength": 1
    }
  },
  "required": [
    "beginDate"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "endDate": {
      "type": "string",
      "format": "date",
      "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false,
      "minLength": 1
    },
    "memo": {
      "type": "string",
      "description": "퇴원·전반 처리 기록에 함께 저장할 선택 메모입니다. 최대 2000자이며 생략하면 메모를 추가하지 않습니다. 처리와 메모 저장은 함께 성공하거나 취소됩니다.",
      "nullable": false,
      "maxLength": 2000,
      "default": ""
    }
  },
  "required": [
    "endDate"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "integer",
      "description": "GET /v1/teams 응답 data.items[].id에서 선택한 수강반 번호입니다. 반 이름이 아닌 정수 id를 전달합니다.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2147483647
    },
    "scheduleId": {
      "type": "integer",
      "description": "GET /v1/teams/{teamId}/schedules 응답 data[].id에서 선택합니다. 지정한 반에 속한 시간표 번호를 전달하세요.",
      "nullable": false,
      "minimum": 1,
      "maximum": 2147483647
    },
    "beginDate": {
      "type": "string",
      "format": "date",
      "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
      "nullable": false,
      "minLength": 1
    },
    "memo": {
      "type": "string",
      "description": "퇴원·전반 처리 기록에 함께 저장할 선택 메모입니다. 최대 2000자이며 생략하면 메모를 추가하지 않습니다. 처리와 메모 저장은 함께 성공하거나 취소됩니다.",
      "nullable": false,
      "maxLength": 2000,
      "default": ""
    }
  },
  "required": [
    "teamId",
    "scheduleId",
    "beginDate"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "profile": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
          "nullable": false
        },
        "name": {
          "type": "string",
          "description": "이름 또는 표시 명칭입니다.",
          "nullable": false
        },
        "school": {
          "type": "string",
          "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
          "nullable": false
        },
        "grade": {
          "type": "string",
          "description": "학년 표시값입니다.",
          "nullable": false
        },
        "major": {
          "type": "string",
          "description": "계열 또는 전공 구분값입니다.",
          "nullable": false
        },
        "studentPhone": {
          "type": "string",
          "description": "학생 휴대전화 번호입니다.",
          "nullable": false
        },
        "parentPhone": {
          "type": "string",
          "description": "보호자 연락처입니다.",
          "nullable": false
        },
        "paymentPhone": {
          "type": "string",
          "description": "결제 안내를 받을 연락처입니다.",
          "nullable": false
        },
        "email": {
          "type": "string",
          "description": "이메일 주소입니다.",
          "nullable": false
        },
        "memo": {
          "type": "string",
          "description": "학생 관리용 메모입니다.",
          "nullable": false
        }
      },
      "required": [
        "id",
        "name",
        "school",
        "grade",
        "major",
        "studentPhone",
        "parentPhone",
        "paymentPhone",
        "email",
        "memo"
      ],
      "description": "비밀번호를 제외한 실제 학생 기본정보입니다.",
      "nullable": false
    },
    "enrollments": {
      "type": "object",
      "properties": {
        "studentId": {
          "type": "string",
          "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
          "nullable": false
        },
        "studentName": {
          "type": "string",
          "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
          "nullable": false
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
                "nullable": false
              },
              "studentId": {
                "type": "string",
                "description": "학원 내 학생 고유 번호입니다. 학생 조회에서 받은 문자열을 그대로 사용합니다.",
                "nullable": false
              },
              "teamId": {
                "type": "integer",
                "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
                "nullable": false
              },
              "scheduleId": {
                "type": "integer",
                "description": "수강반 시간표 고유 번호입니다. 해당 반의 시간표여야 합니다.",
                "nullable": false
              },
              "teamName": {
                "type": "string",
                "description": "수강반 이름입니다.",
                "nullable": false
              },
              "scheduleName": {
                "type": "string",
                "description": "시간표 표시 이름입니다.",
                "nullable": false
              },
              "beginDate": {
                "type": "integer",
                "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
                "nullable": false
              },
              "endDate": {
                "type": "integer",
                "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
                "nullable": false
              },
              "endType": {
                "type": "string",
                "description": "저장된 수강 종료 사유입니다. 빈 문자열, 퇴원, 전반, 종강, 전반취소를 사용합니다. 최대 20자이며 기존의 미확인 사유도 보존합니다. 이미 시작한 수강의 미래 종료는 active, 미래 시작은 upcoming이며 전반취소는 시작일과 관계없이 항상 cancelled입니다.",
                "nullable": false,
                "maxLength": 20
              },
              "changeDate": {
                "type": "integer",
                "description": "전반으로 종료되는 기존 수강 건의 전반일입니다. yyyyMMdd 정수이며 0은 미설정입니다.",
                "nullable": false
              },
              "scheduleDay": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 요일입니다. 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "scheduleFrom": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 시작 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "scheduleTo": {
                "type": "string",
                "description": "해당 수강 시간표의 실제 종료 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
                "nullable": false
              },
              "transferFromId": {
                "type": "integer",
                "description": "전반 전의 기존 수강 건 번호입니다. 연결 없는 과거 자료는 null입니다.",
                "nullable": true
              },
              "transferDate": {
                "type": "integer",
                "description": "새 반으로 전반한 지정일입니다. yyyyMMdd 정수, 0은 연결 없음입니다.",
                "nullable": false
              },
              "previousTeamName": {
                "type": "string",
                "description": "전반 이전 반·시간표 표시명입니다.",
                "nullable": false
              },
              "isTransfer": {
                "type": "boolean",
                "description": "명시적인 이전 수강 연결값이 있는 전반 등록인지 나타냅니다.",
                "nullable": false
              },
              "isTransferCancelled": {
                "type": "boolean",
                "description": "전반 취소 이력인지 나타냅니다. 취소해도 출결·수납 자료와 수강 건은 보존됩니다.",
                "nullable": false
              },
              "transferCancelledAt": {
                "type": "string",
                "format": "date-time",
                "description": "전반 취소 시각(UTC)입니다. 취소 전에는 null입니다.",
                "nullable": true
              },
              "classEndDate": {
                "type": "integer",
                "description": "반 자체의 종강일입니다. 학생별 endDate와 별개인 yyyyMMdd 정수이며 0은 미설정입니다.",
                "nullable": false
              },
              "effectiveEndDate": {
                "type": "integer",
                "description": "조회 시 적용할 종료일입니다. 학생별 종료일이 없으면 반 종강일을 사용하며 종료 사유는 추정하지 않습니다.",
                "nullable": false
              },
              "isEnded": {
                "type": "boolean",
                "description": "한국 날짜를 기준으로 종료 효력이 발생했는지 나타냅니다. 일반 미래 종료는 false지만 전반 취소 이력은 시작일과 관계없이 항상 true입니다.",
                "nullable": false
              },
              "status": {
                "type": "string",
                "description": "수강 시작 전, 수강중, 퇴원, 전반, 종강, 전반 취소, 종료(구분 미확인) 또는 종료 예정 상태입니다. 미래 시작은 현재 수강중이 아니며, 예정 종료 사유는 함께 표시합니다.",
                "nullable": false
              },
              "statusCode": {
                "type": "string",
                "description": "상태 표시 코드입니다. upcoming(미래 시작), active, retired, transferred, ended, cancelled, unknown 중 하나입니다. 전반 취소는 시작일과 관계없이 cancelled입니다.",
                "nullable": false
              }
            },
            "required": [
              "id",
              "studentId",
              "teamId",
              "scheduleId",
              "teamName",
              "scheduleName",
              "beginDate",
              "endDate",
              "endType",
              "changeDate",
              "scheduleDay",
              "scheduleFrom",
              "scheduleTo",
              "transferFromId",
              "transferDate",
              "previousTeamName",
              "isTransfer",
              "isTransferCancelled",
              "transferCancelledAt",
              "classEndDate",
              "effectiveEndDate",
              "isEnded",
              "status",
              "statusCode"
            ]
          },
          "description": "현재 페이지의 세부 이력입니다.",
          "nullable": false
        },
        "page": {
          "type": "integer",
          "description": "페이지 번호입니다.",
          "nullable": false
        },
        "pageSize": {
          "type": "integer",
          "description": "페이지당 자료 수입니다.",
          "nullable": false
        },
        "total": {
          "type": "integer",
          "description": "같은 조건의 전체 이력 수입니다.",
          "nullable": false
        }
      },
      "description": "수강·종료·전반 이력의 앞 100건과 전체 수입니다. 추가 이력은 수강 상세 API의 다음 페이지에서 조회합니다.",
      "nullable": false
    },
    "recentNotes": {
      "type": "object",
      "properties": {
        "studentId": {
          "type": "string",
          "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
          "nullable": false
        },
        "studentName": {
          "type": "string",
          "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
          "nullable": false
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "description": "현재 학생의 상담 기록 번호입니다.",
                "nullable": false
              },
              "studentId": {
                "type": "string",
                "description": "이 상담 기록이 속한 실제 학생 번호입니다.",
                "nullable": false
              },
              "studentName": {
                "type": "string",
                "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
                "nullable": false
              },
              "version": {
                "type": "string",
                "description": "다음 수정·삭제에 사용할 현재 기록의 SHA-256 버전입니다. 추측하지 마세요.",
                "nullable": false
              },
              "content": {
                "type": "string",
                "description": "저장된 원문 상담 내용입니다. 예약·수업 제목을 합성하지 않습니다.",
                "nullable": false
              },
              "staffId": {
                "type": "string",
                "description": "상담 담당 로그인 아이디입니다.",
                "nullable": false
              },
              "staffName": {
                "type": "string",
                "description": "상담 담당자 이름입니다.",
                "nullable": false
              },
              "type": {
                "type": "string",
                "description": "상담 유형입니다.",
                "nullable": false
              },
              "reservedAt": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
                "description": "예약 일시입니다. yyyy-MM-dd HH:mm 한국 시간, 빈 값은 예약 없음입니다.",
                "nullable": false
              },
              "status": {
                "type": "string",
                "description": "저장된 예약 진행 상태입니다.",
                "nullable": false
              },
              "recordedAt": {
                "type": "string",
                "format": "date-time",
                "description": "실제 기록 시각입니다.",
                "nullable": false
              },
              "homeworkStudentId": {
                "type": "integer",
                "description": "연결된 학생 과제장 기록 번호입니다. 0은 일반 상담입니다.",
                "nullable": false
              },
              "lessonId": {
                "type": "integer",
                "description": "명시적으로 연결된 수업 번호입니다. 확인된 연결이 없으면 0입니다.",
                "nullable": false
              },
              "lessonTitle": {
                "type": "string",
                "description": "해당 상담이 연결된 실제 수업 제목입니다. 임의로 합성하지 않습니다.",
                "nullable": false
              },
              "lessonDate": {
                "type": "string",
                "description": "연결된 수업의 실제 수업일입니다.",
                "nullable": false
              }
            },
            "required": [
              "id",
              "studentId",
              "studentName",
              "version",
              "content",
              "staffId",
              "staffName",
              "type",
              "reservedAt",
              "status",
              "recordedAt",
              "homeworkStudentId",
              "lessonId",
              "lessonTitle",
              "lessonDate"
            ]
          },
          "description": "현재 페이지의 세부 이력입니다.",
          "nullable": false
        },
        "page": {
          "type": "integer",
          "description": "페이지 번호입니다.",
          "nullable": false
        },
        "pageSize": {
          "type": "integer",
          "description": "페이지당 자료 수입니다.",
          "nullable": false
        },
        "total": {
          "type": "integer",
          "description": "같은 조건의 전체 이력 수입니다.",
          "nullable": false
        }
      },
      "description": "최근 상담 5건입니다. 전체 상담 수와 페이지 정보도 반환합니다.",
      "nullable": false
    },
    "recentScores": {
      "type": "object",
      "properties": {
        "studentId": {
          "type": "string",
          "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
          "nullable": false
        },
        "studentName": {
          "type": "string",
          "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
          "nullable": false
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "gradeId": {
                "type": "integer",
                "description": "해당 학생의 실제 채점 기록 번호입니다.",
                "nullable": false
              },
              "examId": {
                "type": "integer",
                "description": "시험 번호입니다.",
                "nullable": false
              },
              "name": {
                "type": "string",
                "description": "시험 구분 이름입니다.",
                "nullable": false
              },
              "title": {
                "type": "string",
                "description": "시험 제목입니다.",
                "nullable": false
              },
              "date": {
                "type": "string",
                "description": "저장된 채점일입니다.",
                "nullable": false
              },
              "score": {
                "type": "number",
                "description": "학생 점수입니다.",
                "nullable": false
              },
              "average": {
                "type": "number",
                "description": "시험 평균 점수입니다.",
                "nullable": false
              },
              "maximum": {
                "type": "number",
                "description": "정답지 배점 합계인 시험 만점입니다. 실제 응시자의 최고 득점이 아닙니다.",
                "nullable": false
              },
              "wrongAnswers": {
                "type": "string",
                "description": "이 조회에서 오답 문항을 제공하지 않으면 null입니다. null은 오답 0개가 아니며 등수나 응시 인원을 오답·응시 문항 수로 해석하지 마세요. 문항별 답안·배점·득점은 채점 성적 조회의 includeAnalysis=true로 확인합니다.",
                "nullable": true
              },
              "rank": {
                "type": "string",
                "description": "학원에 저장된 등수 / 응시 인원 표시입니다. 예: 2/2. 문항 수나 오답 개수가 아닙니다.",
                "nullable": false
              },
              "questionCount": {
                "type": "integer",
                "description": "정답지에 설정된 전체 문항 수입니다. 선택과목에 따라 학생의 실제 응시 문항 수와 다를 수 있으며 알 수 없으면 null입니다.",
                "nullable": true
              },
              "differenceFromAverage": {
                "type": "number",
                "description": "해당 시험 점수에서 평균을 뺀 값. 음수이면 평균 미만. 서로 다른 시험 점수의 평균이 아님.",
                "nullable": false
              },
              "belowAverage": {
                "type": "boolean",
                "description": "해당 시험에서 저장된 평균 미만인지 여부. true이면 평균 이상으로 표현하지 않음. 등수·분위와는 별개.",
                "nullable": false
              }
            },
            "required": [
              "gradeId",
              "examId",
              "name",
              "title",
              "date",
              "score",
              "average",
              "maximum",
              "wrongAnswers",
              "rank",
              "questionCount",
              "differenceFromAverage",
              "belowAverage"
            ]
          },
          "description": "현재 페이지의 세부 이력입니다.",
          "nullable": false
        },
        "page": {
          "type": "integer",
          "description": "페이지 번호입니다.",
          "nullable": false
        },
        "pageSize": {
          "type": "integer",
          "description": "페이지당 자료 수입니다.",
          "nullable": false
        },
        "total": {
          "type": "integer",
          "description": "같은 조건의 전체 이력 수입니다.",
          "nullable": false
        }
      },
      "description": "최근 시험성적 5건입니다. 조회만으로 공개 성적표 링크를 발급하지 않습니다.",
      "nullable": false
    },
    "recentClinics": {
      "type": "object",
      "properties": {
        "studentId": {
          "type": "string",
          "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
          "nullable": false
        },
        "studentName": {
          "type": "string",
          "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
          "nullable": false
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "appointmentId": {
                "type": "integer",
                "description": "클리닉 예약 번호입니다.",
                "nullable": false
              },
              "reviewId": {
                "type": "integer",
                "description": "클리닉 리뷰 번호입니다.",
                "nullable": false
              },
              "reservedAt": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
                "description": "저장된 예약 일시입니다.",
                "nullable": false
              },
              "status": {
                "type": "string",
                "description": "예약 진행 상태입니다.",
                "nullable": false
              },
              "memo": {
                "type": "string",
                "description": "예약 메모입니다.",
                "nullable": false
              },
              "review": {
                "type": "string",
                "description": "등록된 리뷰 원문입니다.",
                "nullable": false
              },
              "staff": {
                "type": "string",
                "description": "기록 담당자입니다.",
                "nullable": false
              }
            },
            "required": [
              "appointmentId",
              "reviewId",
              "reservedAt",
              "status",
              "memo",
              "review",
              "staff"
            ]
          },
          "description": "현재 페이지의 세부 이력입니다.",
          "nullable": false
        },
        "page": {
          "type": "integer",
          "description": "페이지 번호입니다.",
          "nullable": false
        },
        "pageSize": {
          "type": "integer",
          "description": "페이지당 자료 수입니다.",
          "nullable": false
        },
        "total": {
          "type": "integer",
          "description": "같은 조건의 전체 이력 수입니다.",
          "nullable": false
        }
      },
      "description": "최근 클리닉 이력 5건입니다.",
      "nullable": false
    }
  },
  "required": [
    "profile",
    "enrollments",
    "recentNotes",
    "recentScores",
    "recentClinics"
  ]
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lessonId": {
            "type": "integer",
            "description": "수업 번호입니다.",
            "nullable": false
          },
          "attendanceId": {
            "type": "integer",
            "description": "학생 출결 기록 번호입니다.",
            "nullable": false
          },
          "teamId": {
            "type": "integer",
            "description": "실제 수강반 번호입니다.",
            "nullable": false
          },
          "teamName": {
            "type": "string",
            "description": "수강반 이름입니다.",
            "nullable": false
          },
          "date": {
            "type": "string",
            "description": "저장된 수업일입니다.",
            "nullable": false
          },
          "session": {
            "type": "integer",
            "description": "수업 회차입니다.",
            "nullable": false
          },
          "attendanceCode": {
            "type": "integer",
            "x-read-display-field": "attendanceMeaning",
            "description": "출결 코드: 0=무결(무단결석), 4=유결(사유결석), 5=출석, 6=인강, 7=보강완료, 8=보강생. 결석은 0·4이며 인강·보강과 구별.",
            "nullable": false
          },
          "attendance": {
            "type": "string",
            "description": "출결 표시 이름입니다.",
            "nullable": false
          },
          "comment": {
            "type": "string",
            "description": "수업·과제의 학생 개별 학습 피드백 원문. 결석 사유 전용 필드가 아니며 시험 응원·풀이 조언을 결석 이유로 해석하지 않음. 원인이 명시되지 않으면 사유 미확인.",
            "nullable": false
          },
          "makeupTeamId": {
            "type": "integer",
            "description": "연결된 보강 수강반 번호입니다. 0은 없음입니다.",
            "nullable": false
          },
          "makeupTeamName": {
            "type": "string",
            "description": "연결된 보강 수강반 이름입니다.",
            "nullable": false
          },
          "valueItems": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "description": "저장 필드 키입니다. 예: Nes1, Exam1. 표시 순서나 다른 필드와 혼동하지 마세요.",
                  "nullable": false
                },
                "category": {
                  "type": "string",
                  "description": "과제, 도전, 시험 중 항목 종류입니다.",
                  "nullable": false
                },
                "position": {
                  "type": "integer",
                  "description": "같은 종류 안의 1부터 시작하는 슬롯 번호입니다. 시험 문항 번호가 아닙니다.",
                  "nullable": false
                },
                "title": {
                  "type": "string",
                  "description": "같은 수업 설정의 실제 항목 제목입니다. 빈 값은 제목 미설정이며 결과값으로 제목을 만들지 마세요.",
                  "nullable": false
                },
                "content": {
                  "type": "string",
                  "description": "같은 수업 설정의 과제·시험 내용 원문입니다.",
                  "nullable": false
                },
                "resultGuide": {
                  "type": "string",
                  "description": "같은 수업 설정의 결과 표시 안내 원문입니다. 단위·만점이 없으면 값만 보고 점수·백분율로 추정하지 마세요.",
                  "nullable": false
                },
                "value": {
                  "type": "string",
                  "description": "해당 학생의 저장 결과 원문입니다. 숫자처럼 보여도 점수·비율인지 추정하지 마세요. null은 값 없음, 빈 문자열은 저장 빈 값입니다.",
                  "nullable": true
                },
                "valueState": {
                  "type": "string",
                  "description": "present=값 있음, blank=빈 값, missing=값 없음입니다. 0은 빈 값이 아닙니다.",
                  "nullable": false
                },
                "examId": {
                  "type": "integer",
                  "description": "같은 슬롯에 명시적으로 연결된 정답지 번호입니다. 0은 연결 없음이며 다른 시험 번호를 재사용하지 않습니다.",
                  "nullable": false
                }
              },
              "required": [
                "field",
                "category",
                "position",
                "title",
                "content",
                "resultGuide",
                "value",
                "valueState",
                "examId"
              ]
            },
            "description": "같은 수업의 실제 과제·시험 항목 제목·내용·결과 안내와 학생 결과. 값 없음은 미완료 증거가 아님.",
            "nullable": false
          },
          "valueItemsAvailable": {
            "type": "boolean",
            "description": "과제 항목의 원본을 조회했는지 여부. false이면 과제 미완료 여부를 판단할 수 없음.",
            "nullable": false
          },
          "attendanceMeaning": {
            "type": "string",
            "description": "출결 코드의 명확한 뜻. 무결은 무단결석이며 정상 참여가 아님.",
            "nullable": false
          },
          "isAbsence": {
            "type": "boolean",
            "x-read-scope-key": "absence",
            "description": "명확한 결석 여부. 코드 0·4는 true, 5·6·7·8은 false, 그 밖에는 null.",
            "nullable": true
          }
        },
        "required": [
          "lessonId",
          "attendanceId",
          "teamId",
          "teamName",
          "date",
          "session",
          "attendanceCode",
          "attendance",
          "comment",
          "makeupTeamId",
          "makeupTeamName",
          "valueItems",
          "valueItemsAvailable",
          "attendanceMeaning",
          "isAbsence"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "appointmentId": {
            "type": "integer",
            "description": "클리닉 예약 번호입니다.",
            "nullable": false
          },
          "reviewId": {
            "type": "integer",
            "description": "클리닉 리뷰 번호입니다.",
            "nullable": false
          },
          "reservedAt": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
            "description": "저장된 예약 일시입니다.",
            "nullable": false
          },
          "status": {
            "type": "string",
            "description": "예약 진행 상태입니다.",
            "nullable": false
          },
          "memo": {
            "type": "string",
            "description": "예약 메모입니다.",
            "nullable": false
          },
          "review": {
            "type": "string",
            "description": "등록된 리뷰 원문입니다.",
            "nullable": false
          },
          "staff": {
            "type": "string",
            "description": "기록 담당자입니다.",
            "nullable": false
          }
        },
        "required": [
          "appointmentId",
          "reviewId",
          "reservedAt",
          "status",
          "memo",
          "review",
          "staff"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "할인 기록 번호입니다.",
            "nullable": false
          },
          "code": {
            "type": "string",
            "description": "할인 코드입니다.",
            "nullable": false
          },
          "rate": {
            "type": "integer",
            "description": "현재 할인율입니다.",
            "nullable": false
          },
          "relatedStudentId": {
            "type": "string",
            "description": "형제 할인에 연결된 학생 번호입니다.",
            "nullable": true
          },
          "relatedStudentName": {
            "type": "string",
            "description": "연결된 학생 이름입니다.",
            "nullable": true
          }
        },
        "required": [
          "id",
          "code",
          "rate",
          "relatedStudentId",
          "relatedStudentName"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "studentId": {
            "type": "string",
            "description": "학원 내 학생 고유 번호입니다. 학생 조회에서 받은 문자열을 그대로 사용합니다.",
            "nullable": false
          },
          "teamId": {
            "type": "integer",
            "description": "수강반 고유 번호입니다. 수강반 조회에서 확인합니다.",
            "nullable": false
          },
          "scheduleId": {
            "type": "integer",
            "description": "수강반 시간표 고유 번호입니다. 해당 반의 시간표여야 합니다.",
            "nullable": false
          },
          "teamName": {
            "type": "string",
            "description": "수강반 이름입니다.",
            "nullable": false
          },
          "scheduleName": {
            "type": "string",
            "description": "시간표 표시 이름입니다.",
            "nullable": false
          },
          "beginDate": {
            "type": "integer",
            "description": "시작일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": false
          },
          "endDate": {
            "type": "integer",
            "description": "종료일입니다. 입력은 yyyy-MM-dd, 정수 응답은 yyyyMMdd이며 0은 미설정입니다.",
            "nullable": false
          },
          "endType": {
            "type": "string",
            "description": "저장된 수강 종료 사유입니다. 빈 문자열, 퇴원, 전반, 종강, 전반취소를 사용합니다. 최대 20자이며 기존의 미확인 사유도 보존합니다. 이미 시작한 수강의 미래 종료는 active, 미래 시작은 upcoming이며 전반취소는 시작일과 관계없이 항상 cancelled입니다.",
            "nullable": false,
            "maxLength": 20
          },
          "changeDate": {
            "type": "integer",
            "description": "전반으로 종료되는 기존 수강 건의 전반일입니다. yyyyMMdd 정수이며 0은 미설정입니다.",
            "nullable": false
          },
          "scheduleDay": {
            "type": "string",
            "description": "해당 수강 시간표의 실제 요일입니다. 없으면 빈 문자열입니다.",
            "nullable": false
          },
          "scheduleFrom": {
            "type": "string",
            "description": "해당 수강 시간표의 실제 시작 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
            "nullable": false
          },
          "scheduleTo": {
            "type": "string",
            "description": "해당 수강 시간표의 실제 종료 시각입니다. HHmm 형식이며 없으면 빈 문자열입니다.",
            "nullable": false
          },
          "transferFromId": {
            "type": "integer",
            "description": "전반 전의 기존 수강 건 번호입니다. 연결 없는 과거 자료는 null입니다.",
            "nullable": true
          },
          "transferDate": {
            "type": "integer",
            "description": "새 반으로 전반한 지정일입니다. yyyyMMdd 정수, 0은 연결 없음입니다.",
            "nullable": false
          },
          "previousTeamName": {
            "type": "string",
            "description": "전반 이전 반·시간표 표시명입니다.",
            "nullable": false
          },
          "isTransfer": {
            "type": "boolean",
            "description": "명시적인 이전 수강 연결값이 있는 전반 등록인지 나타냅니다.",
            "nullable": false
          },
          "isTransferCancelled": {
            "type": "boolean",
            "description": "전반 취소 이력인지 나타냅니다. 취소해도 출결·수납 자료와 수강 건은 보존됩니다.",
            "nullable": false
          },
          "transferCancelledAt": {
            "type": "string",
            "format": "date-time",
            "description": "전반 취소 시각(UTC)입니다. 취소 전에는 null입니다.",
            "nullable": true
          },
          "classEndDate": {
            "type": "integer",
            "description": "반 자체의 종강일입니다. 학생별 endDate와 별개인 yyyyMMdd 정수이며 0은 미설정입니다.",
            "nullable": false
          },
          "effectiveEndDate": {
            "type": "integer",
            "description": "조회 시 적용할 종료일입니다. 학생별 종료일이 없으면 반 종강일을 사용하며 종료 사유는 추정하지 않습니다.",
            "nullable": false
          },
          "isEnded": {
            "type": "boolean",
            "description": "한국 날짜를 기준으로 종료 효력이 발생했는지 나타냅니다. 일반 미래 종료는 false지만 전반 취소 이력은 시작일과 관계없이 항상 true입니다.",
            "nullable": false
          },
          "status": {
            "type": "string",
            "description": "수강 시작 전, 수강중, 퇴원, 전반, 종강, 전반 취소, 종료(구분 미확인) 또는 종료 예정 상태입니다. 미래 시작은 현재 수강중이 아니며, 예정 종료 사유는 함께 표시합니다.",
            "nullable": false
          },
          "statusCode": {
            "type": "string",
            "description": "상태 표시 코드입니다. upcoming(미래 시작), active, retired, transferred, ended, cancelled, unknown 중 하나입니다. 전반 취소는 시작일과 관계없이 cancelled입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "studentId",
          "teamId",
          "scheduleId",
          "teamName",
          "scheduleName",
          "beginDate",
          "endDate",
          "endType",
          "changeDate",
          "scheduleDay",
          "scheduleFrom",
          "scheduleTo",
          "transferFromId",
          "transferDate",
          "previousTeamName",
          "isTransfer",
          "isTransferCancelled",
          "transferCancelledAt",
          "classEndDate",
          "effectiveEndDate",
          "isEnded",
          "status",
          "statusCode"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lessonId": {
            "type": "integer",
            "description": "수업 번호입니다.",
            "nullable": false
          },
          "attendanceId": {
            "type": "integer",
            "description": "학생 출결 기록 번호입니다.",
            "nullable": false
          },
          "teamId": {
            "type": "integer",
            "description": "실제 수강반 번호입니다.",
            "nullable": false
          },
          "teamName": {
            "type": "string",
            "description": "수강반 이름입니다.",
            "nullable": false
          },
          "date": {
            "type": "string",
            "description": "저장된 수업일입니다.",
            "nullable": false
          },
          "session": {
            "type": "integer",
            "description": "수업 회차입니다.",
            "nullable": false
          },
          "attendanceCode": {
            "type": "integer",
            "x-read-display-field": "attendanceMeaning",
            "description": "출결 코드: 0=무결(무단결석), 4=유결(사유결석), 5=출석, 6=인강, 7=보강완료, 8=보강생. 결석은 0·4이며 인강·보강과 구별.",
            "nullable": false
          },
          "attendance": {
            "type": "string",
            "description": "출결 표시 이름입니다.",
            "nullable": false
          },
          "comment": {
            "type": "string",
            "description": "수업·과제의 학생 개별 학습 피드백 원문. 결석 사유 전용 필드가 아니며 시험 응원·풀이 조언을 결석 이유로 해석하지 않음. 원인이 명시되지 않으면 사유 미확인.",
            "nullable": false
          },
          "makeupTeamId": {
            "type": "integer",
            "description": "연결된 보강 수강반 번호입니다. 0은 없음입니다.",
            "nullable": false
          },
          "makeupTeamName": {
            "type": "string",
            "description": "연결된 보강 수강반 이름입니다.",
            "nullable": false
          },
          "valueItems": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "description": "저장 필드 키입니다. 예: Nes1, Exam1. 표시 순서나 다른 필드와 혼동하지 마세요.",
                  "nullable": false
                },
                "category": {
                  "type": "string",
                  "description": "과제, 도전, 시험 중 항목 종류입니다.",
                  "nullable": false
                },
                "position": {
                  "type": "integer",
                  "description": "같은 종류 안의 1부터 시작하는 슬롯 번호입니다. 시험 문항 번호가 아닙니다.",
                  "nullable": false
                },
                "title": {
                  "type": "string",
                  "description": "같은 수업 설정의 실제 항목 제목입니다. 빈 값은 제목 미설정이며 결과값으로 제목을 만들지 마세요.",
                  "nullable": false
                },
                "content": {
                  "type": "string",
                  "description": "같은 수업 설정의 과제·시험 내용 원문입니다.",
                  "nullable": false
                },
                "resultGuide": {
                  "type": "string",
                  "description": "같은 수업 설정의 결과 표시 안내 원문입니다. 단위·만점이 없으면 값만 보고 점수·백분율로 추정하지 마세요.",
                  "nullable": false
                },
                "value": {
                  "type": "string",
                  "description": "해당 학생의 저장 결과 원문입니다. 숫자처럼 보여도 점수·비율인지 추정하지 마세요. null은 값 없음, 빈 문자열은 저장 빈 값입니다.",
                  "nullable": true
                },
                "valueState": {
                  "type": "string",
                  "description": "present=값 있음, blank=빈 값, missing=값 없음입니다. 0은 빈 값이 아닙니다.",
                  "nullable": false
                },
                "examId": {
                  "type": "integer",
                  "description": "같은 슬롯에 명시적으로 연결된 정답지 번호입니다. 0은 연결 없음이며 다른 시험 번호를 재사용하지 않습니다.",
                  "nullable": false
                }
              },
              "required": [
                "field",
                "category",
                "position",
                "title",
                "content",
                "resultGuide",
                "value",
                "valueState",
                "examId"
              ]
            },
            "description": "같은 수업의 실제 과제·시험 항목 제목·내용·결과 안내와 학생 결과. 값 없음은 미완료 증거가 아님.",
            "nullable": false
          },
          "valueItemsAvailable": {
            "type": "boolean",
            "description": "과제 항목의 원본을 조회했는지 여부. false이면 과제 미완료 여부를 판단할 수 없음.",
            "nullable": false
          },
          "attendanceMeaning": {
            "type": "string",
            "description": "출결 코드의 명확한 뜻. 무결은 무단결석이며 정상 참여가 아님.",
            "nullable": false
          },
          "isAbsence": {
            "type": "boolean",
            "x-read-scope-key": "absence",
            "description": "명확한 결석 여부. 코드 0·4는 true, 5·6·7·8은 false, 그 밖에는 null.",
            "nullable": true
          }
        },
        "required": [
          "lessonId",
          "attendanceId",
          "teamId",
          "teamName",
          "date",
          "session",
          "attendanceCode",
          "attendance",
          "comment",
          "makeupTeamId",
          "makeupTeamName",
          "valueItems",
          "valueItemsAvailable",
          "attendanceMeaning",
          "isAbsence"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "생활기록 번호입니다.",
            "nullable": false
          },
          "year": {
            "type": "integer",
            "description": "생활기록 연도입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "생활기록 분류명입니다.",
            "nullable": false
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "description": "실제 설정된 생활기록 필드입니다.",
                  "nullable": false
                },
                "title": {
                  "type": "string",
                  "description": "화면에 표시하는 항목명입니다.",
                  "nullable": false
                },
                "value": {
                  "type": "string",
                  "description": "해당 학생의 저장 값입니다.",
                  "nullable": false
                },
                "numeric": {
                  "type": "boolean",
                  "description": "숫자 입력 항목인지 여부입니다.",
                  "nullable": false
                },
                "chart": {
                  "type": "boolean",
                  "description": "도표에 사용하는 항목인지 여부입니다.",
                  "nullable": false
                }
              },
              "required": [
                "field",
                "title",
                "value",
                "numeric",
                "chart"
              ]
            },
            "description": "실제 사용 설정된 항목명과 값입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "year",
          "name",
          "fields"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "loggedAt": {
            "type": "string",
            "description": "저장된 로그인 시각입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "로그인 이름입니다.",
            "nullable": false
          },
          "ip": {
            "type": "string",
            "description": "로그인 접속 주소입니다.",
            "nullable": false
          },
          "type": {
            "type": "integer",
            "description": "로그인 구분입니다.",
            "nullable": false
          },
          "memo": {
            "type": "string",
            "description": "기록된 로그인 메모입니다.",
            "nullable": false
          }
        },
        "required": [
          "loggedAt",
          "name",
          "ip",
          "type",
          "memo"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sentAt": {
            "type": "string",
            "description": "실제 발송 기록 시각입니다.",
            "nullable": false
          },
          "type": {
            "type": "string",
            "description": "문자·알림톡 유형입니다.",
            "nullable": false
          },
          "receiver": {
            "type": "string",
            "description": "실제 수신번호입니다.",
            "nullable": false
          },
          "sender": {
            "type": "string",
            "description": "발송한 직원의 이름입니다. 발신 전화번호가 아닙니다.",
            "nullable": false
          },
          "calling": {
            "type": "string",
            "description": "저장된 발신번호와 발송 구분 표시입니다.",
            "nullable": false
          },
          "content": {
            "type": "string",
            "description": "저장된 발송 내용입니다.",
            "nullable": false
          },
          "providerRequestId": {
            "type": "string",
            "description": "문자 업체의 요청 번호입니다.",
            "nullable": false
          }
        },
        "required": [
          "sentAt",
          "type",
          "receiver",
          "sender",
          "calling",
          "content",
          "providerRequestId"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "staff": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "이름 또는 표시 명칭입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "description": "실제 선택 가능한 담당자 아이디와 이름입니다.",
      "nullable": false
    },
    "types": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
            "nullable": false
          },
          "name": {
            "type": "string",
            "description": "이름 또는 표시 명칭입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "description": "실제 선택 가능한 상담 유형입니다.",
      "nullable": false
    },
    "currentStaffId": {
      "type": "string",
      "description": "현재 인증된 담당자 아이디입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "studentId": {
      "type": "string",
      "description": "현재 학원의 실제 학생 번호입니다. 앞자리 0을 유지합니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "현재 학생의 상담 기록 번호입니다.",
            "nullable": false
          },
          "studentId": {
            "type": "string",
            "description": "이 상담 기록이 속한 실제 학생 번호입니다.",
            "nullable": false
          },
          "studentName": {
            "type": "string",
            "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
            "nullable": false
          },
          "version": {
            "type": "string",
            "description": "다음 수정·삭제에 사용할 현재 기록의 SHA-256 버전입니다. 추측하지 마세요.",
            "nullable": false
          },
          "content": {
            "type": "string",
            "description": "저장된 원문 상담 내용입니다. 예약·수업 제목을 합성하지 않습니다.",
            "nullable": false
          },
          "staffId": {
            "type": "string",
            "description": "상담 담당 로그인 아이디입니다.",
            "nullable": false
          },
          "staffName": {
            "type": "string",
            "description": "상담 담당자 이름입니다.",
            "nullable": false
          },
          "type": {
            "type": "string",
            "description": "상담 유형입니다.",
            "nullable": false
          },
          "reservedAt": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
            "description": "예약 일시입니다. yyyy-MM-dd HH:mm 한국 시간, 빈 값은 예약 없음입니다.",
            "nullable": false
          },
          "status": {
            "type": "string",
            "description": "저장된 예약 진행 상태입니다.",
            "nullable": false
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "description": "실제 기록 시각입니다.",
            "nullable": false
          },
          "homeworkStudentId": {
            "type": "integer",
            "description": "연결된 학생 과제장 기록 번호입니다. 0은 일반 상담입니다.",
            "nullable": false
          },
          "lessonId": {
            "type": "integer",
            "description": "명시적으로 연결된 수업 번호입니다. 확인된 연결이 없으면 0입니다.",
            "nullable": false
          },
          "lessonTitle": {
            "type": "string",
            "description": "해당 상담이 연결된 실제 수업 제목입니다. 임의로 합성하지 않습니다.",
            "nullable": false
          },
          "lessonDate": {
            "type": "string",
            "description": "연결된 수업의 실제 수업일입니다.",
            "nullable": false
          }
        },
        "required": [
          "id",
          "studentId",
          "studentName",
          "version",
          "content",
          "staffId",
          "staffName",
          "type",
          "reservedAt",
          "status",
          "recordedAt",
          "homeworkStudentId",
          "lessonId",
          "lessonTitle",
          "lessonDate"
        ]
      },
      "description": "현재 페이지의 세부 이력입니다.",
      "nullable": false
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호입니다.",
      "nullable": false
    },
    "pageSize": {
      "type": "integer",
      "description": "페이지당 자료 수입니다.",
      "nullable": false
    },
    "total": {
      "type": "integer",
      "description": "같은 조건의 전체 이력 수입니다.",
      "nullable": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "현재 학생의 상담 기록 번호입니다.",
      "nullable": false
    },
    "studentId": {
      "type": "string",
      "description": "이 상담 기록이 속한 실제 학생 번호입니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "version": {
      "type": "string",
      "description": "다음 수정·삭제에 사용할 현재 기록의 SHA-256 버전입니다. 추측하지 마세요.",
      "nullable": false
    },
    "content": {
      "type": "string",
      "description": "저장된 원문 상담 내용입니다. 예약·수업 제목을 합성하지 않습니다.",
      "nullable": false
    },
    "staffId": {
      "type": "string",
      "description": "상담 담당 로그인 아이디입니다.",
      "nullable": false
    },
    "staffName": {
      "type": "string",
      "description": "상담 담당자 이름입니다.",
      "nullable": false
    },
    "type": {
      "type": "string",
      "description": "상담 유형입니다.",
      "nullable": false
    },
    "reservedAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
      "description": "예약 일시입니다. yyyy-MM-dd HH:mm 한국 시간, 빈 값은 예약 없음입니다.",
      "nullable": false
    },
    "status": {
      "type": "string",
      "description": "저장된 예약 진행 상태입니다.",
      "nullable": false
    },
    "recordedAt": {
      "type": "string",
      "format": "date-time",
      "description": "실제 기록 시각입니다.",
      "nullable": false
    },
    "homeworkStudentId": {
      "type": "integer",
      "description": "연결된 학생 과제장 기록 번호입니다. 0은 일반 상담입니다.",
      "nullable": false
    },
    "lessonId": {
      "type": "integer",
      "description": "명시적으로 연결된 수업 번호입니다. 확인된 연결이 없으면 0입니다.",
      "nullable": false
    },
    "lessonTitle": {
      "type": "string",
      "description": "해당 상담이 연결된 실제 수업 제목입니다. 임의로 합성하지 않습니다.",
      "nullable": false
    },
    "lessonDate": {
      "type": "string",
      "description": "연결된 수업의 실제 수업일입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "studentId",
    "studentName",
    "version",
    "content",
    "staffId",
    "staffName",
    "type",
    "reservedAt",
    "status",
    "recordedAt",
    "homeworkStudentId",
    "lessonId",
    "lessonTitle",
    "lessonDate"
  ]
}

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "상담 원문입니다. 예약 문구나 화면 표시용 접두사를 임의로 덧붙이지 마세요.",
      "nullable": false,
      "maxLength": 10000,
      "minLength": 1
    },
    "version": {
      "type": "string",
      "description": "수정할 때 상세 조회에서 받은 현재 version입니다. 신규 등록에는 필요하지 않습니다.",
      "nullable": true,
      "maxLength": 64
    },
    "staffId": {
      "type": "string",
      "description": "담당자 목록의 실제 로그인 아이디입니다. 수정 시 생략하면 기존 담당자를 유지합니다.",
      "nullable": true,
      "maxLength": 100
    },
    "type": {
      "type": "string",
      "description": "상담 유형 목록의 실제 값입니다. 수정 시 생략하면 기존 유형을 유지합니다.",
      "nullable": true,
      "maxLength": 100
    },
    "reservedAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
      "description": "사용자가 지정한 yyyy-MM-dd HH:mm 한국 시간입니다. 생략하면 기존 일시를 유지하고 빈 문자열은 예약을 해제합니다. 임의로 날짜를 만들지 마세요.",
      "nullable": true,
      "maxLength": 16
    }
  },
  "required": [
    "content"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "현재 학생의 상담 기록 번호입니다.",
      "nullable": false
    },
    "studentId": {
      "type": "string",
      "description": "이 상담 기록이 속한 실제 학생 번호입니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "version": {
      "type": "string",
      "description": "다음 수정·삭제에 사용할 현재 기록의 SHA-256 버전입니다. 추측하지 마세요.",
      "nullable": false
    },
    "content": {
      "type": "string",
      "description": "저장된 원문 상담 내용입니다. 예약·수업 제목을 합성하지 않습니다.",
      "nullable": false
    },
    "staffId": {
      "type": "string",
      "description": "상담 담당 로그인 아이디입니다.",
      "nullable": false
    },
    "staffName": {
      "type": "string",
      "description": "상담 담당자 이름입니다.",
      "nullable": false
    },
    "type": {
      "type": "string",
      "description": "상담 유형입니다.",
      "nullable": false
    },
    "reservedAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
      "description": "예약 일시입니다. yyyy-MM-dd HH:mm 한국 시간, 빈 값은 예약 없음입니다.",
      "nullable": false
    },
    "status": {
      "type": "string",
      "description": "저장된 예약 진행 상태입니다.",
      "nullable": false
    },
    "recordedAt": {
      "type": "string",
      "format": "date-time",
      "description": "실제 기록 시각입니다.",
      "nullable": false
    },
    "homeworkStudentId": {
      "type": "integer",
      "description": "연결된 학생 과제장 기록 번호입니다. 0은 일반 상담입니다.",
      "nullable": false
    },
    "lessonId": {
      "type": "integer",
      "description": "명시적으로 연결된 수업 번호입니다. 확인된 연결이 없으면 0입니다.",
      "nullable": false
    },
    "lessonTitle": {
      "type": "string",
      "description": "해당 상담이 연결된 실제 수업 제목입니다. 임의로 합성하지 않습니다.",
      "nullable": false
    },
    "lessonDate": {
      "type": "string",
      "description": "연결된 수업의 실제 수업일입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "studentId",
    "studentName",
    "version",
    "content",
    "staffId",
    "staffName",
    "type",
    "reservedAt",
    "status",
    "recordedAt",
    "homeworkStudentId",
    "lessonId",
    "lessonTitle",
    "lessonDate"
  ]
}

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "상담 원문입니다. 예약 문구나 화면 표시용 접두사를 임의로 덧붙이지 마세요.",
      "nullable": false,
      "maxLength": 10000,
      "minLength": 1
    },
    "version": {
      "type": "string",
      "description": "수정할 때 상세 조회에서 받은 현재 version입니다. 신규 등록에는 필요하지 않습니다.",
      "nullable": true,
      "maxLength": 64
    },
    "staffId": {
      "type": "string",
      "description": "담당자 목록의 실제 로그인 아이디입니다. 수정 시 생략하면 기존 담당자를 유지합니다.",
      "nullable": true,
      "maxLength": 100
    },
    "type": {
      "type": "string",
      "description": "상담 유형 목록의 실제 값입니다. 수정 시 생략하면 기존 유형을 유지합니다.",
      "nullable": true,
      "maxLength": 100
    },
    "reservedAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
      "description": "사용자가 지정한 yyyy-MM-dd HH:mm 한국 시간입니다. 생략하면 기존 일시를 유지하고 빈 문자열은 예약을 해제합니다. 임의로 날짜를 만들지 마세요.",
      "nullable": true,
      "maxLength": 16
    }
  },
  "required": [
    "content"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "현재 학생의 상담 기록 번호입니다.",
      "nullable": false
    },
    "studentId": {
      "type": "string",
      "description": "이 상담 기록이 속한 실제 학생 번호입니다.",
      "nullable": false
    },
    "studentName": {
      "type": "string",
      "description": "학생 번호와 함께 표시할 실제 학생 이름입니다.",
      "nullable": false
    },
    "version": {
      "type": "string",
      "description": "다음 수정·삭제에 사용할 현재 기록의 SHA-256 버전입니다. 추측하지 마세요.",
      "nullable": false
    },
    "content": {
      "type": "string",
      "description": "저장된 원문 상담 내용입니다. 예약·수업 제목을 합성하지 않습니다.",
      "nullable": false
    },
    "staffId": {
      "type": "string",
      "description": "상담 담당 로그인 아이디입니다.",
      "nullable": false
    },
    "staffName": {
      "type": "string",
      "description": "상담 담당자 이름입니다.",
      "nullable": false
    },
    "type": {
      "type": "string",
      "description": "상담 유형입니다.",
      "nullable": false
    },
    "reservedAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$",
      "description": "예약 일시입니다. yyyy-MM-dd HH:mm 한국 시간, 빈 값은 예약 없음입니다.",
      "nullable": false
    },
    "status": {
      "type": "string",
      "description": "저장된 예약 진행 상태입니다.",
      "nullable": false
    },
    "recordedAt": {
      "type": "string",
      "format": "date-time",
      "description": "실제 기록 시각입니다.",
      "nullable": false
    },
    "homeworkStudentId": {
      "type": "integer",
      "description": "연결된 학생 과제장 기록 번호입니다. 0은 일반 상담입니다.",
      "nullable": false
    },
    "lessonId": {
      "type": "integer",
      "description": "명시적으로 연결된 수업 번호입니다. 확인된 연결이 없으면 0입니다.",
      "nullable": false
    },
    "lessonTitle": {
      "type": "string",
      "description": "해당 상담이 연결된 실제 수업 제목입니다. 임의로 합성하지 않습니다.",
      "nullable": false
    },
    "lessonDate": {
      "type": "string",
      "description": "연결된 수업의 실제 수업일입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "studentId",
    "studentName",
    "version",
    "content",
    "staffId",
    "staffName",
    "type",
    "reservedAt",
    "status",
    "recordedAt",
    "homeworkStudentId",
    "lessonId",
    "lessonTitle",
    "lessonDate"
  ]
}

{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "직전 상세 조회에서 받은 정확한 version입니다.",
      "nullable": false,
      "minLength": 1,
      "pattern": "^[A-F0-9]{64}$"
    }
  },
  "required": [
    "version"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "자원의 고유 식별값입니다. 학생 번호는 문자열, 일반 자료 번호는 정수, 파일·작업·링크 번호는 UUID 문자열입니다.",
      "nullable": false
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "조회·변경할 자원의 고유 번호입니다. 학생 번호는 문자열이며 그 외 번호는 정수입니다.",
      "nullable": false
    },
    "name": {
      "type": "string",
      "description": "이름 또는 표시 명칭입니다.",
      "nullable": false
    },
    "school": {
      "type": "string",
      "description": "학교 이름입니다. 빈 문자열이면 미입력입니다.",
      "nullable": false
    },
    "grade": {
      "type": "string",
      "description": "학년 표시값입니다.",
      "nullable": false
    },
    "major": {
      "type": "string",
      "description": "계열 또는 전공 구분값입니다.",
      "nullable": false
    },
    "studentPhone": {
      "type": "string",
      "description": "학생 휴대전화 번호입니다.",
      "nullable": false
    },
    "parentPhone": {
      "type": "string",
      "description": "보호자 연락처입니다.",
      "nullable": false
    },
    "paymentPhone": {
      "type": "string",
      "description": "결제 안내를 받을 연락처입니다.",
      "nullable": false
    },
    "email": {
      "type": "string",
      "description": "이메일 주소입니다.",
      "nullable": false
    },
    "memo": {
      "type": "string",
      "description": "학생 관리용 메모입니다.",
      "nullable": false
    }
  },
  "required": [
    "id",
    "name",
    "school",
    "grade",
    "major",
    "studentPhone",
    "parentPhone",
    "paymentPhone",
    "email",
    "memo"
  ]
}