유저
회원가입 / 로그인 / 로그아웃
회원가입
•
계정명과 패스워드를 입력하여 회원가입을 진행합니다.
로그인
•
로그인 시 AT 와 RT 을 생성합니다.
◦
AT 는 헤더에 넣고, RT 는 쿠키에 넣어 전송합니다.
◦
로그인 이후의 인증과정에는 JWT 를 사용합니다.
로그아웃
로그아웃 시 저장된 토큰을 전부 삭제합니다.
팀
팀 생성
•
팀을 생성합니다.
•
생성자 가 자동으로 팀장 이 됩니다.
팀원 초대
•
팀장 만 초대가 가능하며 계정명 을 입력하여 유저 를 팀원으로 초대합니다.
•
이미 초대가 발송된 경우 안내 메세지가 보여 집니다.
팀원 초대 승낙
•
유저 는 팀장 의 초대를 승낙할 수 있습니다.
•
초대받은 유저 만 사용 가능하며, 본 API 실행 시, 초대받은 팀 의 팀원이 됩니다.
칸반보드
모든 기능은 해당 보드 팀원 및 팀장 만 권한이 있습니다.
•
위와 같은 칸반보드 를 구성합니다.
•
Column 은 각 열 들을 의미합니다.
•
Task(=작업)는 각 열에 속하는 작업들을 의미합니다.
•
팀 이 생성 되면 위 칸반보드 에 접근가능합니다.
•
최초에는 column 이 존재하지 않습니다.
Column
Column 추가
•
column 이 추가 됩니다.
•
이름, 순서 를 보유하고 있습니다.
•
추가된 column 은 항시 맨 마지막에 위치합니다.
Column 수정/삭제
•
column 의 이름을 변경합니다.
•
column 을 삭제합니다.
•
하위에 아무런 taks 가 없는 경우에만 삭제 가능합니다.
Column 전체 조회
•
본인이 속한 팀 column 전체 리스트를 조회 합니다.
•
데이터는 column 순서 에 맞게 반환됩니다.
•
column 내부에는 속한 task 목록을 같이 반환합니다.
Column 순서 변경
•
column 의 순서를 변경합니다.
Task
Task 생성
•
특정 column 하위에 task 을 생성합니다.
•
필드
◦
순서
▪
해당 작업이 column 에서 몇 번째 위치인지.
▪
새로 추가되는 task 은 맨 밑에 생성됩니다.
◦
타이틀
◦
태그
▪
Frontend / Backend / Design / QA / PM / Document
◦
작업분량
▪
해당 작업에 필요한 시간을 지정합니다.
▪
시간단위(H) 이며, 4 은 4시간을 / 3.5 는 3시간 30분을 의미합니다.
▪
Optional 입니다.
◦
작업기한
▪
시간을 제외한 일자만 설정 합니다.
◦
담당자
▪
작업을 담당할 유저 를 지정 합니다.
▪
Optional 입니다.
Task 수정/삭제
•
모든 필드를 수정 할 수 있습니다.
•
task 를 삭제할 수 있습니다.
Task Column 및 순서 변경
•
유저 는 드래그 앤 드랍 으로 task 의 위치를 변경 시킵니다.
◦
task 의 순서를 변경합니다.
◦
task 가 속한 column 을 변경합니다.
작업 분석
팀장 이 팀원들의 작업을 분석하기 위한 툴로 여러 통계를 제공 합니다.
개인 작업 분석
•
팀원 을 지정합니다.
◦
지정한 팀원 한 명의 결과만 확인하는 기능 입니다.
•
colum 을 복수로 지정합니다.
◦
Optional 이며, 미지정 시 전체 column 입니다.
예 작업자가 작업을 완료하면 “Done” 뿐만 아니라 그 이후 단계(Review, QA 등) 로 넘어가게 됩니다.
예 columns=Done,Review,Qa
•
시작일 ~ 종료일 을 지정할 수 있습니다.
◦
작업기한 을 기준으로 합니다.
◦
Optional 이며, 미 지정 시 전체 기간
•
결과로 앞서 구분한 tag 별로 퍼센테이지 와 작업시간 합을 보여 줍니다.
◦
퍼센테이지는 task 개수로 판단하는것이 아니라, 해당 tag 들의 작업시간 합 기준으로 계산됩니다.
예 조회된 기간에 총 100시간의 작업시간이 있고, 이 중 Backend 50 시간, PM 30시간 , Document 20시간 이라면 서비스 상에 Backend 50.0%(50H), PM 30.0%(30H), Document 20.0%(20H) 이렇게 표출 됩니다.
팀원 작업 비교
•
모든 팀원 의 작업 분량을 비교하여 보여 줍니다.
•
colum 을 복수로 지정합니다.
◦
Optional 이며 미지정 시 전체 column 입니다.
•
시작일 ~ 종료일 을 지정할 수 있습니다.
◦
작업기한 을 기준으로 합니다.
◦
Optional 이며 미 지정 시 전체 기간
•
tag 를 지정합니다.
◦
하나의 tag 만 지정 가능합니다.
◦
Optional 이며 미지정 시 전체 tag
•
결과로, 위 조건에 해당하는 각 팀원 들의 작업시간 합 과 기여도 를 전부 반환합니다.
이름 | 작업시간(H) | 기여도 |
김AA | 52.2 | 1.4 |
이BB | 42.2 | 1.05 |
강CC | 38.1 | 0.95 |
박DD | 27.1 | 0.6 |
... | ... |
예 columns=1,3&start_date=2023-11-6&end_date=2023-11-12&tag=Backend
◦
id 가 1, 3인 column 들에 해당하는 task 필터링.
◦
작업 기한 이 2023-11-6 부터 2023-11-12 인 task 필터링.
◦
tag 가 Backend 인 ticket 필터링.
◦
작업시간 합 이 높은 순서로 정렬됩니다.
◦
기여도 프로젝트 기여도 를 의미합니다.
▪
해당 조회 조건에서 모든 팀원 들의 작업 시간 평균 대비 해당 유저가 작업한 시간 입니다.
▪
계산식 : 작업시간 합 / 팀 평균 작업시간
예 해당 팀 평균 작업 시간이 40 시간일 때, 50시간 작업한 유저는 1.25 의 값을 가집니다. (50 / 40 == 1.25)