[주특기 주차 2차 과제] ERD & API 명세서 2차 수정

📅ScheduleManager_extension 소개

📌ERD

TABLE Schedule

이름	타입	제약조건	설명
schedule_id	integer	PK, AUTO_INCREMENT	일정의 고유번호, PK
schedule_title	VARCHAR(20)	NOT NULL	스케쥴 제목
schedule_data	VARCHAR(100)	NOT NULL	스케쥴 내용
writer	VARCHAR(20)	NOT NULL	작성자 이름
create_datetime	VARCHAR(20)	NOT NULL	수정일자, DATETIME 형식
edit_datetime	VARCHAR(20)	NOT NULL	작성일자, DATETIME 형식

상세 설명

TABLE Schedule

schedule_id : 스케쥴을 추가하거나 삭제할 때, ID를 기준으로 참조.
  그만큼 핵심 Column이기도 하며 중복이 되어선 안되기에, PK로 지정.

schedule_title : 스케쥴의 제목으로 NULL이 되어선 안되기에, NOT NULL형태로 지정

schedule_data : 스케쥴의 내용으로 NULL이 되어선 안되기에 NOT NULL형태로 지정.

edittime : 수정 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

writer : 작성자 이름으로 스케쥴에 유저를 추가할 때 확인해야 하기에, NOT NULL 형태로 지정.

createtime: 작성 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

 

TABLE Comment

이름	타입	제약조건	설명
comment_id	integer	PK, AUTO_INCREMENT	댓글의 고유번호, PK
schedule_id	integer	FK, NOT NULL	스케쥴 ID
comment_data	VARCHAR(100)	NOT NULL	댓글 내용
user_id	integer	NOT NULL	작성자 고유 번호
create_datetime	VARCHAR(20)	NOT NULL	수정일자, DATETIME 형식
edit_datetime	VARCHAR(20)	NOT NULL	작성일자, DATETIME 형식

상세 설명

TABLE Comment

comment_id : 댓글을 추가하거나 삭제할 때, ID를 기준으로 참조.
  그만큼 핵심 Column이기도 하며 중복이 되어선 안되기에, PK로 지정.

schedule_id : 댓글이 달려있는 스케쥴 고유번호 외래키, NOT NULL형태로 지정

comment_data : 댓글의 내용으로 NULL이 되어선 안되기에 NOT NULL형태로 지정.

edit_datetime : 수정 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

user_id : 작성자 고유 번호로 NULL이 되어선 안되기에, NOT NULL 형태로 지정.

create_datetime: 작성 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

 

TABLE Manager

이름	타입	제약조건	설명
manager_id	integer	PK, AUTO_INCREMENT	댓글의 고유번호, PK
schedule_id	integer	FK, NOT NULL	스케쥴 고유번호
user_id	integer	FK, NOT NULL	유저 고유번호

상세 설명

TABLE Manager

manager_id : 스케쥴을 담당하는 유저 조합의 고유 번호이기에 PK로 지정

schedule_id : 스케쥴 고유번호 외래키, NOT NULL형태로 지정

user_id : 스케쥴에 참여한 유저 고유번호 외래키, NOT NULL형태로 지정.

 

TABLE User

이름	타입	제약조건	설명
user_id	integer	PK, AUTO_INCREMENT	유저의 고유번호, PK
user_name	VARCHAR(20)	NOT NULL	유저의 이름
user_email	VARCHAR(100)	NOT NULL	유저의 이메일 주소
create_datetime	VARCHAR(20)	NOT NULL	수정일자, DATETIME 형식
edit_datetime	VARCHAR(20)	NOT NULL	작성일자, DATETIME 형식

상세 설명

TABLE Comment

user_id : 유저를 추가하거나 삭제할 때, ID를 기준으로 참조.
  그만큼 핵심 Column이기도 하며 중복이 되어선 안되기에, PK로 지정.

user_name : 유저의 이름으로 빠져선 안되기에 NOT NULL형태로 지정.

user_email : 유저의 이메일 주소로 필수 내용이기에 NOT NULL형태로 지정.

edit_datetime : 수정 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

create_datetime: 작성 시각으로 연월일시분초 다 저장해야 하기에 DATETIME 형식으로 저장, NOT NULL 형태로 지정.

 

📌스케쥴 API명세서

기능	Method	URL	request	response	state code
일정 작성	POST	/api/schedules	요청body	등록 정보	200작성 성공 416제목 길이 오류
선택한 일정 조회	GET	/api/schedules/{scheduleId}	요청param	단건 일정 정보	200조회 성공 404조회 실패
페이징된 일정 조회	GET	/api/schedules?page=?&size=?	요청query	페이징된 일정 정보	200조회 성공
선택한 일정 수정	PUT	/api/schedules/{scheduleId}	요청body	수정 정보	200수정 성공 404조회 실패
선택한 일정 삭제	DELETE	/api/schedules/{scheduleId}	요청param	삭제 정보	200삭제 성공

📌 댓글 API명세서

기능	Method	URL	request	response	state code
댓글 작성	POST	/api/comments	요청body	등록 정보	200작성 성공
선택한 댓글 조회	GET	/api/comments/{commentId}	요청param	단건 댓글 정보	200조회 성공 404조회 실패
모든 댓글 조회	GET	/api/comments	X	모든 댓글 정보	200조회 성공
선택한 댓글 수정	PUT	/api/comments/{commentId}	요청body	수정 정보	200수정 성공 404조회 실패
선택한 댓글 삭제	DELETE	/api/comments/{commentId}	요청param	단일 삭제	200삭제 성공 404조회 실패

📌 유저 API명세서

기능	Method	URL	request	response	state code
댓글 작성	POST	/api/users	요청body	등록 정보	200작성 성공
선택한 유저 조회	GET	/api/users/{userId}	요청param	단건 유저 정보	200조회 성공 404조회 실패
모든 유저 조회	GET	/api/users	X	모든 유저 정보	200조회 성공
선택한 유저 삭제	DELETE	/api/users/{userId}	요청param	단일 삭제	200삭제 성공 404조회 실패

📌 매니저 API명세서

기능	Method	URL	request	response	state code
스케쥴에 유저 추가	PUT	/api/managers	요청body	등록 정보	200작성 성공

상세 설명 - 일정

🛠️일정 작성

Request

Syntax

{
    "userId" : 1,
    "scheduleTitle" : "todo",
    "scheduleData" : "data"
}

Request Elements

Parameter	Type	Required	Description
userId	Integer	필수	유저 Id
shcedule_title	String	필수	스케쥴 제목
schedule_data	String	필수	스케쥴 내용

Response

Syntax

{
   "scheduleID": 1,
   "scheduleTitle": "todo",
   "scheduleData": "data",
   "createDateTime": "2024-08-30 17:50:44",
   "editDateTime": "2024-08-30 17:50:44"
}

Element

Parameter	Type	Description
schedule_id	Integer	스케쥴 고유 번호
shcedule_title	String	스케쥴 제목
schedule_data	String	스케쥴 내용
editTime	String	스케쥴 수정 시간
createTime	String	스케쥴 생성 시간

State Code

Code	Description	Detail
200	작성 성공	해당 정보를 토대로 스케쥴 생성 성공
416	작성 실패	제목이나 내용의 길이가 범위를 벗어남

 

🛠️선택한 일정 조회

Request

Syntax

/api/schedules/{scheduleId}

Path Elements

Parameter	Type	Required	Description
scheduleId	Integer	필수	조회하고자 하는 스케쥴 고유 번호

Response

Syntax

{
   "scheduleID": 1,
   "scheduleTitle": "todo",
   "scheduleData": "data",
   "createDateTime": "2024-08-30 17:50:44",
   "editDateTime": "2024-08-30 17:50:44",
   "userBaseResponseDtos": [
       {
           "userId": 1,
           "userName": "nwoo",
           "email": "kkw2238@naver.com"
       }
   ]
}

Element

Parameter	Type	Description
schedule_id	Integer	스케쥴 고유 번호
shcedule_title	String	스케쥴 제목
schedule_data	String	스케쥴 내용
editTime	String	스케쥴 수정 시간
createTime	String	스케쥴 생성 시간
userBaseResponseDtos	User	유저 정보

State Code

Code	Description	Detail
200	조회 성공	스케쥴 조회 성공
404	조회 실패	해당 Id를 가진 스케쥴이 존재하지 않음

 

🛠️선택한 일정 수정

Request

Param Elements

Syntax

/api/schedules/{sceduleId}

Parameter	Type	Required	Description
scheduleId	Integer	필수	조회하고자 하는 스케쥴 고유 번호

{ 
   "shcedule_title" : "today Todo"
   "schedule_data": "programming",
}

Request Elements

Parameter	Type	Required	Description
shcedule_title	String	필수	스케쥴 제목
schedule_data	String	필수	스케쥴 내용

Response

Syntax

{
   "scheduleID": 1,
   "scheduleTitle": "todo",
   "scheduleData": "data",
   "createDateTime": "2024-08-30 17:50:44",
   "editDateTime": "2024-08-30 17:50:44"
}

Element

Parameter	Type	Description
schedule_id	Integer	스케쥴 고유 번호
shcedule_title	String	스케쥴 제목
schedule_data	String	스케쥴 내용
editTime	String	스케쥴 수정 시간
createTime	String	스케쥴 생성 시간

State Code

Code	Description	Detail
200	조회 성공	스케쥴 조회 성공
404	조회 실패	해당 번호의 스케쥴이 존재하지 않음

상세 설명 - 댓글

🛠️댓글 작성

Request

Syntax

{
   "schedule_id" : 1
   "comment_data" : "Ok"
   "userName" : "kim kun woo",
}

Request Elements

Parameter	Type	Required	Description
schedule_id	Integer	필수	스케쥴 제목
comment_data	String	필수	스케쥴 제목
userName	String	필수	작성자 내용

Response

Syntax

{
    "commentId": 5,
    "scheduleId": 2,
    "commentData": "OK",
    "userName": "kun woo",
    "createDateTime": "2024-08-29 02:08:17",
    "editDateTime": "2024-08-29 02:08:17"
}

Element

Parameter	Type	Description
commentId	Integer	댓글 고유 번호
scheduleId	Integer	관련된 스케쥴 Id
commentData	String	댓글 내용
userName	String	작성자
editTime	String	댓글 수정 시간
createTime	String	댓글 생성 시간

State Code

Code	Description	Detail
200	작성 성공	해당 정보를 토대로 댓글 생성 성공

🛠️선택한 댓글 조회

Request

Syntax

/api/comments/{commentId}

Path Elements

Parameter	Type	Required	Description
commentId	Integer	필수	조회하고자 하는 댓글 고유 번호

Response

Syntax

{
    "commentId": 5,
    "scheduleId": 2,
    "commentData": "OK",
    "userName": "kun woo",
    "createDateTime": "2024-08-29 02:08:17",
    "editDateTime": "2024-08-29 02:08:17"
}

Element

Parameter	Type	Description
commentId	Integer	댓글 고유 번호
scheduleId	Integer	관련된 스케쥴 Id
commentData	String	댓글 내용
userName	String	작성자
editTime	String	댓글 수정 시간
createTime	String	댓글 생성 시간

State Code

Code	Description	Detail
200	조회 성공	스케쥴 조회 성공
404	조회 실패	해당 Id를 가진 스케쥴이 존재하지 않음

🛠️선택한 댓글 수정

Request

Param Elements

Syntax

/api/comments/{commentId}

Parameter	Type	Required	Description
commentId	Integer	필수	조회하고자 하는 댓글 고유 번호

{ 
   "commentData" : "Hi"
}

Request Elements

Parameter	Type	Required	Description
commentData	String	필수	수정하고자 하는 댓글 내용

Response

Syntax

{
    "commentId": 5,
    "scheduleId": 2,
    "commentData": "Hi",
    "userName": "kun woo",
    "createDateTime": "2024-08-29 02:08:17",
    "editDateTime": "2024-08-29 02:08:17"
}

Element

Parameter	Type	Description
commentId	Integer	댓글 고유 번호
scheduleId	Integer	관련된 스케쥴 Id
commentData	String	댓글 내용
userName	String	작성자
editTime	String	댓글 수정 시간
createTime	String	댓글 생성 시간

State Code

Code	Description	Detail
200	조회 성공	스케쥴 조회 성공
404	조회 실패	해당 번호의 스케쥴이 존재하지 않음

🛠️선택한 댓글 삭제

Request

Param Elements

Syntax

/api/comments/{commentId}

Parameter	Type	Required	Description
commentId	Integer	필수	삭제하고자 하는 댓글 고유 번호

{ 
   2
}

Request Elements

Parameter	Type	Required	Description
	Integer	필수	삭제된 댓글 Id