BusinessRule (Team)

개요

호스트와 동행의 차이

• 하나의 일정에는 반드시 한명의 호스트가 존재하며, 해당 일정의 호스트는 동행으로 권한이 변경될 수 없습니다.
• 즉, 한번 호스트는 해당 일정에서 영원히 호스트입니다.
• 호스트는 해당 일정에 대한 동행의 권한을 변경할 수 있지만, 동행은 변경의 권한이 없습니다.
• 일정에 대한 권한은 다음과 같습니다.
  • 일정에 대한 쓰기 권한
  • 일정에 대한 읽기 권한
  • 일정에서 삭제 처리(동행 제거)
• 동행은 부여받은 권한에 대한 행동만 가능합니다.
• 동행이 호스트가 될 수는 없습니다.
• 해당 일정에 초대받은 사람은 전송된 메일의 링크를 통해서만 동행으로 참여가 가능합니다.

동행으로 추가될 시 DB의 변화

• a의 회원이 100번의 스케줄의 호스트라고 가정한다면 저장되어 있는 DB 값은 아래와 같습니다.
  • SCHEDULE 테이블
    • SC_NO : 100
  • TEAM 테이블
    • TEAM_NO : 1, TEAM_MID : a(호스트아이디), TEAM_SNO : 100(스케줄번호), TEAM_LEVEL : 9(호스트), TEAM_BOOKMARK : 0
• 이때 동행으로 b의 회원을 초대하였고 이를 수락했다고 가정합니다. 추가되는 DB 값은 아래와 같습니다.
  • TEAM 테이블
    • TEAM_NO : 2, TEAM_MID : b(동행아이디), TEAM_SNO : 100(스케줄번호), TEAM_LEVEL : 0(읽기권한), TEAM_BOOKMARK : 0
  • ALARM 테이블
    • AL_NO : 1, AL_SCNO : 100(스케줄번호), AL_MID : b(알람 울릴 아이디), AL_STATUS : 1, AL_TIME : 23-05-23, AL_CATE : 2(알람 울릴 카테고리)
• 위의 테이블에서처럼 동행에 추가되면 해당하는 TEAM과 ALARM DB가 추가되는 것을 볼 수 있습니다.

API

[GET] 회원 검색(teams/share/members)

• 회원 검색은 동행 추가 시에 필요하므로 TEAM BusinessRule에 작성하였습니다.
• 입력값
  • 회원 아이디(memId)

[GET] 동행 조회(teams/share/{scNo})

• 입력값
  • 스케줄번호(scNo)

[POST] 동행 추가(teams/share/{scNo})

• API 실행 순서
  • 유효성 검사
    • 동행이 MEMBER DB에 존재하는 동행인지 검사
    • 동행이 호스트인지 아닌지 검사
    • 스케줄 번호가 존재하는 스케줄인지 검사
  • 입력받은 값에 대해 TEAM 테이블에 insert 처리 된다.
  • 입력받은 값에 대해 ALARM 테이블에 insert 처리 된다.
• 입력값
  • 스케줄번호(scNo)
  • 회원 아이디(memId)
• 삽입 테이블
  • TEAM(삽입)
    • 동행 번호(teamNo) : 자동증가값(AUTO_INCREMENT)
    • 동행의 아이디(teamMid) : 입력값(memId)
    • 스케줄 번호(teamSno) : 입력값(scNo)
    • 동행의 권한레벨(teamLevel) : 처음 insert 시는 권한레벨을 읽기로 줍니다. (후에 호스트가 수정 가능) - 읽기권한:0, 수정권한:1
    • 동행의 스케줄에 대한 북마크여부(teamBookmark) : 처음 insert 시는 북마크여부는 0 입니다.(0 = 북마크하지 않음)
  • ALARM(삽입)
    • 알람 번호(alNo) : 자동증가값(AUTO_INCREMENT)
    • 스케줄 번호(alScno) : 입력값(scNo)
    • 알람받을 아이디(alMid) : 입력값(memId)
    • 알람의 출력상태(alStatus) : 처음 insert 시는 출력상태를 1로 줍니다. (후에 스케줄이 삭제되면 상태가 0으로 변경되어 알람이 출력되지 않을 것임)
    • 알람 카테고리(alTime) :현재시각(NOW())
    • 알람 번호(alCate) : AlarmCate.SAVE_TEAM.ordinal() - ENUM을 이용했으며 DB에는 2가 저장됩니다.

[PATCH] 동행의 권한 상태 변경(teams/share/{scNo})

• 입력값
  • 스케줄번호(scNo)
  • 변경할 동행 아이디(teamMid)
  • 변경할 동행의 권한레벨(teamLevel)
• 변경 및 삽입 테이블
  • TEAM(변경)
    • 동행의 권한레벨(teamLevel) : 읽기권한:0 혹은 수정권한:1
  • ALARM(삽입)
    • 알람 번호(alNo) : 자동증가값(AUTO_INCREMENT)
    • 스케줄 번호(alScno) : 입력값(scNo)
    • 알람받을 아이디(alMid) : 입력값(teamMid)
    • 알람의 출력상태(alStatus) : 처음 insert 시는 출력상태를 1로 줍니다. (후에 해당 스케줄이 삭제되면 알람도 출력되지 않아야 하므로 상태가 0으로 변경됨)
    • 알람 카테고리(alTime) : 자동증가값(NOW())
    • 알람 번호(alCate) : AlarmCate.UPDATE_TEAMLEVEL_WRITE.ordinal() or AlarmCate.UPDATE_TEAMLEVEL_READ.ordinal() - ENUM을 이용했으며 DB에는 4 또는 5가 저장됩니다.

[DELETE] 동행 삭제(teams/share/{scNo})

• 입력값
  • 스케줄번호(scNo)
  • 삭제할 동행 아이디(teamMid)
• 삭제 및 삽입 테이블
  • (삭제) 스케줄(scNo)과 아이디(teamMid)에 해당하는 TEAM 테이블 삭제
  • (삭제) 스케줄(scNo)에 아이디(teamMid)에 해당하는 ALARM 테이블 일괄 삭제
  • ALARM(삽입)
    • 알람 번호(alNo) : 자동증가값(AUTO_INCREMENT)
    • 스케줄 번호(alScno) : 입력값(scNo)
    • 알람받을 아이디(alMid) : 입력값(teamMid)
    • 알람의 출력상태(alStatus) : 처음 insert 시는 출력상태를 1로 줍니다.
    • 알람 카테고리(alTime) : 현재시각(NOW())
    • 알람 번호(alCate) : AlarmCate.REMOVE_TEAM.ordinal() - ENUM을 이용했으며 DB에는 3이 저장됩니다.