📅 ScheduleProject (일정관리 앱 만들기)

---

ERD

erDiagram
    SCHEDULE ||--o{ COMMENT : has

    SCHEDULE {
        BIGINT id PK
        VARCHAR(30) title 
        VARCHAR(200) content
        VARCHAR writer
        VARCHAR password
        DATETIME createdAt
        DATETIME modifiedAt
    }

    COMMENT {
        BIGINT id PK
        BIGINT schedule_id "FK 역할 (연관관계 매핑 없이 Long 관리)"
        VARCHAR(100) content
        VARCHAR writer
        VARCHAR password
        DATETIME createdAt
        DATETIME modifiedAt
    }

Loading

---

📝 일정(Schedule) API 명세

Method	기능	Endpoint	상태 코드
POST	일정 생성	/schedules	201 CREATED
GET	선택 일정 조회	/schedules/{id}	200 OK
GET	전체 일정 조회	/schedules	200 OK
PATCH	일정 수정	/schedules/{id}	200 OK
DELETE	일정 삭제	/schedules/{id}	204 NO CONTENT

---

공통 예외 상태 코드

상태 코드	상황
400 BAD REQUEST	요청 값이 올바르지 않은 경우 - 필수 값 누락 - 빈 문자열 또는 잘못된 형식의 입력
401 UNAUTHORIZED	일정 수정 또는 삭제 시 비밀번호가 일치하지 않는 경우
404 NOT FOUND	요청한 일정(id)이 존재하지 않는 경우
405 METHOD NOT ALLOWED	PATCH인데 PUT Http메서드로 요청한 경우
500 INTERNAL SERVER ERROR	서버 내부 오류 발생

1️⃣ 일정 생성 ➕

POST /schedules

API응답 비밀번호 제외

▶ Request

{
  "title": "금요일",
  "content": "내일은 주말이야",
  "writer": "신현민",
  "password": "12345678"
}

▶ Response (201 CREATED)

{
  "id": 1,
  "title": "금요일",
  "content": "내일은 주말이야",
  "writer": "신현민",
  "createdAt": "2026-02-05T10:00:00",
  "modifiedAt": "2026-02-05T10:00:00"
}

2️⃣ 선택 일정 조회 🔍

GET /schedules/{id}

고유 식별자(ID)를 통해 조회

해당 일정에 등록된 댓글들을 포함하여 함께 응답

API응답 비밀번호 제외

▶ Response (200 OK)

[
{
  "id": 1,
  "title": "금요일",
  "content": "내일은 주말이야",
  "writer": "신현민",
  "createdAt": "2026-02-05T10:00:00",
  "modifiedAt": "2026-02-05T10:00:00"
}
{
  "id": 1,
  "scheduleId": 1,
  "content": "ㅋㅋ주말엔 알바가야지",
  "writer": "신현민",
  "createdAt": "2026-02-05T12:30:00",
  "modifiedAt": "2026-02-05T12:30:00"
}
]

3️⃣ 전체 일정 조회 🔍

GET /schedules

작성자명을 기준으로 등록된 일정목록 전체 조회

API응답 비밀번호 제외

예시 Endpoint

/schedules

/schedules?writer=신현민

▶ Response (200 OK)

[
  {
    "id": 2,
    "title": "월요일",
    "content": "다시 공부해야겠지?",
    "writer": "신현민",
    "createdAt": "2026-02-05T11:00:00",
    "modifiedAt": "2026-02-05T11:00:00"
  }
  {
    "id": 1,
    "title": "금요일",
    "content": "내일은 주말이야",
    "writer": "신현민",
    "createdAt": "2026-02-05T10:00:00",
    "modifiedAt": "2026-02-05T10:00:00"
  },
]

4️⃣ 일정 수정 ✏️

PATCH /schedules/{id}

선택한 일정 내용 중 일정 제목, 작성자명만 수정 가능

서버에 일정 수정을 요청할 때 비밀번호를 함께 전달

API응답 비밀번호 제외

▶ Request

{
  "title": "월요일",
  "writer": "스폰지밥",
  "password": "12345678"
}

▶ Response (200 OK)

{
  "id": 2,
  "title": "월요일",
  "content": "다시 공부해야겠지?",
  "writer": "스폰지밥",
  "createdAt": "2026-02-05T10:00:00",
  "modifiedAt": "2026-02-05T14:30:00"
}

5️⃣ 일정 삭제 🗑️

DELETE /schedules/{id}

서버에 일정 삭제을 요청할 때 비밀번호를 함께 전달

▶ Request

{
 "password":"1234678"
}

▶ Response

(204 NO CONTENT)

---

📝 댓글 생성 API

Method	기능	Endpoint	상태 코드
POST	댓글 생성	/comments	201 CREATED

---

댓글 생성 ➕

POST /comments

▶ Request

{
  "scheduleId": 1,
  "content": "ㅋㅋ주말엔 알바가야지",
  "writer": "신현민",
  "password": "12345678"
}

▶ Response(201CREATED)

{
  "id": 1,
  "scheduleId": 1,
  "content": "ㅋㅋ주말엔 알바가야지",
  "writer": "신현민",
  "createdAt": "2026-02-05T12:30:00",
  "modifiedAt": "2026-02-05T12:30:00"
}