Schedule API

스케줄 관련 API

📌 스케줄 상태 Enum

BEFORE_WORK 스케줄 시작 전
ON_DUTY 스케줄 진행 중 (정시 출근 후)
LATE 스케줄 진행 중 (지각 출근 후)
SUCCESS 스케줄 완료
FAIL 스케줄 미완료 (ex. 지각, 조기 퇴근, 결근 등)

📌 전체 스케줄 상태 Enum

COMPLETE 해당 날짜의 스케줄 모두 완료 (스케줄 상태가 모두 SUCCESS)
INCOMPLETE 해당 날짜의 스케줄 중 완료되지 않은 건 1건 이상 존재
BEFORE 해당 날짜의 스케줄 모두 시작 전 (현재 날짜 이후 날짜)
NONE 해당 날짜의 스케줄 존재X

GET /boss/schedules/home

홈 달력 정보 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Response-Body

Name

Type

Description

dateList

List

오늘 날짜 기준 ±3일별 날짜와 전체 스케줄 상태 리스트

date

Object

일별 날짜 정보

year

Integer

년도

month

Integer

월

day

Integer

일

dayOfWeek

String

요일 이름

totalScheduleStatus

String

해당 날짜 전체 스케줄 상태

selectedSubPage

Object

조회 날짜, 조회된 워크스페이스 리스트 정보 (날짜 선택 시마다 내용 업데이트)

selectedDate

Object

오늘 날짜 정보 (선택된 날짜 정보)

workspaceList

List

나의 워크스페이스 리스트

workspaceId

Long

워크스페이스 id

name

String

워크스페이스 이름

imageUrl

String

워크스페이스 이미지 url

selectedScheduleList

List

해당 워크스페이스의 해당 날짜 스케줄 리스트

scheduleId

Long

스케줄 id

scheduleStartTime

String

예정된 스케줄 시작 시간

scheduleEndTime

String

예정된 스케줄 종료 시간

logicalStartTime

String

논리적 스케줄 시작 시간

logicalEndTime

String

논리적 스케줄 종료 시간

status

String

현재 스케줄 상태

worker

Object

스케줄 근무자 정보

workerId

Long

근무자 id

name

String

근무자 이름

imageUrl

String

근무자 이미지 url

{
    "dateList": [
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 13,
                "dayOfWeek": "금"
            },
            "totalScheduleStatus": "INCOMPLETE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 14,
                "dayOfWeek": "토"
            },
            "totalScheduleStatus": "NONE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 15,
                "dayOfWeek": "일"
            },
            "totalScheduleStatus": "NONE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 16,
                "dayOfWeek": "월"
            },
            "totalScheduleStatus": "INCOMPLETE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 17,
                "dayOfWeek": "화"
            },
            "totalScheduleStatus": "NONE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 18,
                "dayOfWeek": "수"
            },
            "totalScheduleStatus": "NONE"
        },
        {
            "date": {
                "year": 2023,
                "month": 1,
                "day": 19,
                "dayOfWeek": "목"
            },
            "totalScheduleStatus": "NONE"
        }
    ],
    "selectedSubPage": {
        "selectedDate": {
            "year": 2023,
            "month": 1,
            "day": 16,
            "dayOfWeek": "월"
        },
        "workspaceList": [
            {
                "workspaceId": 4,
                "name": "송이떡볶이 숙대점",
                "imageUrl": "http://",
                "selectedScheduleList": []
            },
            {
                "workspaceId": 2,
                "name": "송이커피 숙대점",
                "imageUrl": "http://abcd",
                "selectedScheduleList": [
                    {
                        "scheduleId": 18,
                        "scheduleStartTime": "18:00",
                        "scheduleEndTime": "22:00",
                        "logicalStartTime": "18:00",
                        "logicalEndTime": "22:00",
                        "status": "SUCCESS",
                        "worker": {
                            "workerId": 2,
                            "name": "김나은",
                            "imageUrl": "http://abcd"
                        }
                    }
                ]
            },
            {
                "workspaceId": 3,
                "name": "송이토스트 숙대점",
                "imageUrl": "http://",
                "selectedScheduleList": []
            },
            {
                "workspaceId": 1,
                "name": "송이파스타 숙대점",
                "imageUrl": "http://",
                "selectedScheduleList": [
                    {
                        "scheduleId": 17,
                        "scheduleStartTime": "10:00",
                        "scheduleEndTime": "17:00",
                        "logicalStartTime": "11:00",
                        "logicalEndTime": "17:00",
                        "status": "FAIL",
                        "worker": {
                            "workerId": 2,
                            "name": "김나은",
                            "imageUrl": "http://abcd"
                        }
                    },
                    {
                        "scheduleId": 16,
                        "scheduleStartTime": "10:00",
                        "scheduleEndTime": "17:00",
                        "logicalStartTime": "11:00",
                        "logicalEndTime": "16:30",
                        "status": "FAIL",
                        "worker": {
                            "workerId": 1,
                            "name": "김다은",
                            "imageUrl": "http://"
                        }
                    }
                ]
            }
        ]
    }
}

GET /boss/schedules/home/selected

홈 해당 날짜 모든 가게의 스케줄 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*year

조회 년도

*month

조회 월

*day

조회 일

Response-Body

Name

Type

Description

selectedDate

Object

오늘 날짜 정보 (선택된 날짜 정보)

year

Integer

년도

month

Integer

월

day

Integer

일

dayOfWeek

String

요일 이름

workspaceList

List

나의 워크스페이스 리스트

workspaceId

Long

워크스페이스 id

name

String

워크스페이스 이름

imageUrl

String

워크스페이스 이미지 url

selectedScheduleList

List

해당 워크스페이스의 해당 날짜 스케줄 리스트

scheduleId

Long

스케줄 id

scheduleStartTime

String

예정된 스케줄 시작 시간

scheduleEndTime

String

예정된 스케줄 종료 시간

logicalStartTime

String

논리적 스케줄 시작 시간

logicalEndTime

String

논리적 스케줄 종료 시간

status

String

현재 스케줄 상태

worker

Object

스케줄 근무자 정보

workerId

Long

근무자 id

name

String

근무자 이름

imageUrl

String

근무자 이미지 url

✅ 논리적 스케줄 시작/종료 시간?

스케줄 출퇴근 시 현재 시간을 10분 단위로, 논리적으로 계산한 시간
ex. 10시가 출근 시간일 때, 10시 12분에 출근 시 10시 10분으로 출근 시간 저장
ex. 17시가 퇴근 시간일 때, 16시 37분에 퇴근 시 16시 30분으로 퇴근 시간 저장
ex. 17시가 퇴근 시간일 때, 20시에 퇴근 시 17시로 퇴근 시간 저장

✅ logicalStartTime이 null이면 scheduleStartTime, logicalEndTime이 null이면 scheduleEndTime을 표시

전체 스케줄 상태가 COMPLETE → 초록색
INCOMPLETE → 빨간색
BEFORE → 회색
NONE → 점 표시X

logicalStartTime이 없으면 scheduleStartTime 검은색
logicalStartTime이 있으면서 scheduleStartTime과 같으면 logicalStartTime 초록색
logicalStartTime이 있으면서 scheduleStartTime과 다르면 logicalStartTime 빨간색
logicalEndTime이 없으면 scheduleEndTime 검은색
logicalEndTime이 있으면서 scheduleEndTime과 같으면 logicalEndTime 초록색
logicalEndTime이 있으면서 scheduleEndTime과 다르면 logicalEndTime 빨간색

{
    "selectedDate": {
        "year": 2023,
        "month": 1,
        "day": 16,
        "dayOfWeek": "월"
    },
    "workspaceList": [
        {
            "workspaceId": 4,
            "name": "송이떡볶이 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": []
        },
        {
            "workspaceId": 2,
            "name": "송이커피 숙대점",
            "imageUrl": "http://abcd",
            "selectedScheduleList": [
                {
                    "scheduleId": 18,
                    "scheduleStartTime": "18:00",
                    "scheduleEndTime": "22:00",
                    "logicalStartTime": "18:00",
                    "logicalEndTime": "22:00",
                    "status": "SUCCESS",
                    "worker": {
                        "workerId": 2,
                        "name": "김나은",
                        "imageUrl": "http://abcd"
                    }
                }
            ]
        },
        {
            "workspaceId": 3,
            "name": "송이토스트 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": []
        },
        {
            "workspaceId": 1,
            "name": "송이파스타 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": [
                {
                    "scheduleId": 17,
                    "scheduleStartTime": "10:00",
                    "scheduleEndTime": "17:00",
                    "logicalStartTime": "11:00",
                    "logicalEndTime": "17:00",
                    "status": "FAIL",
                    "worker": {
                        "workerId": 2,
                        "name": "김나은",
                        "imageUrl": "http://abcd"
                    }
                },
                {
                    "scheduleId": 16,
                    "scheduleStartTime": "10:00",
                    "scheduleEndTime": "17:00",
                    "logicalStartTime": "11:00",
                    "logicalEndTime": "16:30",
                    "status": "FAIL",
                    "worker": {
                        "workerId": 1,
                        "name": "김다은",
                        "imageUrl": "http://"
                    }
                }
            ]
        }
    ]
}

//조회된 스케줄 없음
{
    "selectedDate": {
        "year": 2023,
        "month": 1,
        "day": 15,
        "dayOfWeek": "일"
    },
    "workspaceList": [
        {
            "workspaceId": 4,
            "name": "송이떡볶이 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": []
        },
        {
            "workspaceId": 2,
            "name": "송이커피 숙대점",
            "imageUrl": "http://abcd",
            "selectedScheduleList": []
        },
        {
            "workspaceId": 3,
            "name": "송이토스트 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": []
        },
        {
            "workspaceId": 1,
            "name": "송이파스타 숙대점",
            "imageUrl": "http://",
            "selectedScheduleList": []
        }
    ]
}

GET /boss/schedules

해당 워크스페이스 홈 달력 정보 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*workspaceId

조회 워크스페이스 id

Response-Body

Name

Type

Description

selectedWorkspace

Object

조회 워크스페이스 정보

workspaceId

Long

워크스페이스 id

name

String

워크스페이스 이름

imageUrl

String

워크스페이스 이미지 url

year

Integer

현재 년도

month

Integer

현재 월

dateList

List

현재 년월의 일 리스트

day

Integer

일

dayOfWeek

String

요일 이름

totalScheduleStatus

String

일별 전체 스케줄 상태

selectedSubPage

Object

조회 일, 조회된 스케줄 리스트 정보 (날짜 선택 시마다 내용 업데이트)

selectedDay

Integer

조회 일

selectedScheduleList

List

조회된 스케줄 리스트

scheduleId

Long

스케줄 id

scheduleStartTime

String

예정된 스케줄 시작 시간

scheduleEndTime

String

예정된 스케줄 종료 시간

status

String

현재 스케줄 상태

worker

Object

스케줄 근무자 정보

workerId

Long

근무자 id

name

String

근무자 이름

{
    "selectedWorkspace": {
        "workspaceId": 2,
        "name": "송이커피 숙대점",
        "imageUrl": "http://"
    },
	
    "year": 2022,
    "month": 9,
    "dateList": [
        {
            "day": 1,
            "dayOfWeek": "THURSDAY",
            "totalScheduleStatus": "NONE"
	}, //이날에는 스케줄 존재X 
	{
	    "day": 2,
            "dayOfWeek": "FRIDAY",
	    "totalScheduleStatus": "COMPLETE"
	}, //전체 스케줄 모두 완료 
        //......
	{
	    "day": 29,
            "dayOfWeek": "THURSDAY",
	    "totalScheduleStatus": "INCOMPLETE"
	}, //전체 스케줄 중 정상적으로 완료되지 못한 건 하나 이상 존재 
	{
	    "day": 30,
            "dayOfWeek": "FRIDAY",
	    "totalScheduleStatus": "BEFORE"
	} //전체 스케줄 시작 전 (현재 날짜 이후 날짜)
    ],

    "selectedSubPage": {
        "selectedDay": 30,
        "selectedScheduleList": [
            {
                "scheduleId": 10,
                "scheduleStartTime": "15:00",
                "scheduleEndTime": "19:00",
                "status": "SUCCESS",
                "worker": {
                    "workerId": 3, 
                    "name": "신지연"   
                }
            },
            {
                "scheduleId": 9,
                "scheduleStartTime": "17:00",
                "scheduleEndTime": "19:00",
                "status": "BEFORE_WORK",
                "worker": {
                    "workerId": 5, 
                    "name": "김다은"
                }
            },
            {
                "scheduleId": 8,
                "scheduleStartTime": "21:00",
                "scheduleEndTime": "03:00",
                "status": "BEFORE_WORK",
                "worker": {
                    "workerId": 4, 
                    "name": "조예진"
                }
            }
        ]
    }
}

GET /boss/schedules/selected

해당 워크스페이스 홈 해당 날짜 스케줄 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*workspaceId

조회 워크스페이스 id

*year

조회 년도

*month

조회 월

*day

조회 일

Response-Body

Name

Type

Description

selectedDay

Integer

조회 일

selectedScheduleList

List

조회된 스케줄 리스트

scheduleId

Long

스케줄 id

scheduleStartTime

String

예정된 스케줄 시작 시간

scheduleEndTime

String

예정된 스케줄 종료 시간

status

String

현재 스케줄 상태

worker

Object

스케줄 근무자 정보

workerId

Long

근무자 id

name

String

근무자 이름

{
    "selectedDay": 30,
    "selectedScheduleList": [
        {
            "scheduleId": 10,
            "scheduleStartTime": "15:00",
            "scheduleEndTime": "19:00",
            "status": "SUCCESS",
            "worker": {
                "workerId": 3, 
                "name": "신지연"   
            }
        },
        {
            "scheduleId": 9,
            "scheduleStartTime": "17:00",
            "scheduleEndTime": "19:00",
            "status": "BEFORE_WORK",
            "worker": {
                "workerId": 5, 
                "name": "김다은"
            }
        },
        {
            "scheduleId": 8,
            "scheduleStartTime": "21:00",
            "scheduleEndTime": "03:00",
            "status": "BEFORE_WORK",
            "worker": {
                "workerId": 4, 
                "name": "조예진"
            }
        }
    ]
}

GET /boss/schedules/possible/staffs

해당 날짜에 근무 가능한 해당 워크스페이스 내 알바 리스트 조회 (for 스케줄 추가)

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*workspaceId

해당 워크스페이스 id

*start

스케줄 시작 시간

*end

스케줄 종료 시간

Response-Body

Name

Type

Description

staffList

List

근무 가능한 알바 리스트

staffId

Long

알바 id

name

String

알바 이름

imageUrl

String

알바 이미지 url

{
    "staffList": [
        {
	    "staffId": 5,
	    "name": "김다은",
            "imageUrl": "http://"
	},
	{
	    "staffId": 4,
	    "name": "신지연",
            "imageUrl": "http://"
	},
	{
	    "staffId": 3,
	    "name": "조예진",
            "imageUrl": "http://"
	}
    ]
}

POST /boss/schedules

스케줄 생성

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Request-Body

Name

Type

Description

*workspaceId

Long

스케줄 진행할 워크스페이스 id

*staffId

Long

스케줄 근무할 알바 id

*scheduleDateTime

Object

스케줄 날짜 시간 정보

*start

String

스케줄 시작 날짜 시간

*end

String

스케줄 종료 날짜 시간

*hourlyWage

Integer

스케줄 시급

DELETE /boss/schedules/{scheduleId}

해당 스케줄 삭제

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

GET /boss/schedules/reports/dates

근무내역 및 알바비 관리 년월 리스트 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*workspaceId

조회 워크스페이스 id

Response-Body

Name

Type

Description

dateList

List

근무내역 및 알바비 관리 조회 가능한 날짜 리스트

year

Integer

조회 가능 년도

month

Integer

조회 가능 월

{
    "dateList": [
        {
            "year": 2022,
            "month": 11
        },
        {
            "year": 2022,
            "month": 12
        },
        {
            "year": 2023,
            "month": 1
        }
    ]
}

GET /boss/schedules/reports

해당 가게, 해당 년월 근무내역 및 알바비 관리 리스트 조회

Request-Header

Name

Type

Description

*x-auth-token

String

user jwt token

Params

Name

Description

*workspaceId

조회 워크스페이스 id

*year

조회 년도

*month

조회 월

Response-Body

Name

Type

Description

selectedWorkspaceId

Long

조회 워크스페이스 id

selectedYear

Integer

조회 년도

selectedMonth

Integer

조회 월

workReportList

List

근무내역 및 알바비 관리 리스트

worker

Object

근무자 정보

workerId

Long

근무자 id

name

String

근무자 이름

imageUrl

String

근무자 이미지 url

totalWorkTimeHour

Integer

해당 월 전체 근무 시간

totalWorkTimeMin

Integer

해당 월 전체 근무 분

totalWorkPay

String

해당 월 전체 알바비

{
    "selectedWorkspaceId": 2,
    "selectedYear": 2022,
    "selectedMonth": 9,
    "workReportList": [
        {
            "worker": {
                "workerId": 4,
                "name": "조예진",
                "imageUrl": "http://"
            },
            "totalWorkTimeHour": 40,
	    "totalWorkTimeMin": 0,
	    "totalWorkPay": "320,600"
	},
	{
	    "worker": {
                "workerId": 3,
                "name": "신지연",
                "imageUrl": "http://"
            },
	    "totalWorkTimeHour": 35,
	    "totalWorkTimeMin": 30,
	    "totalWorkPay": "320,600"
	},
	{
	    "worker": {
                "workerId": 5,
                "name": "김다은",
                "imageUrl": "http://"
            },
	    "totalWorkTimeHour": 35,
	    "totalWorkTimeMin": 30,
	    "totalWorkPay": "320,600"
	},
	{
	    "worker": {
                "workerId": 1,
                "name": "차은우",
                "imageUrl": "http://"
            },
	    "totalWorkTimeHour": 35,
	    "totalWorkTimeMin": 30,
	    "totalWorkPay": "320,600"
	},
	{
	    "worker": {
                "workerId": 2,
                "name": "김민지",
                "imageUrl": "http://"
            },
	    "totalWorkTimeHour": 35,
	    "totalWorkTimeMin": 30,
	    "totalWorkPay": "320,600"
	}
    ]
}

PreviousWorkspace API NextMessage API

Last updated 2 years ago

hashtag📌 스케줄 상태 Enum

hashtag📌 전체 스케줄 상태 Enum

hashtagGET /boss/schedules/home

hashtagRequest-Header

hashtagResponse-Body

hashtagGET /boss/schedules/home/selected

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

hashtag✅ 논리적 스케줄 시작/종료 시간?

hashtagGET /boss/schedules

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

hashtagGET /boss/schedules/selected

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

hashtagGET /boss/schedules/possible/staffs

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

hashtagPOST /boss/schedules

hashtagRequest-Header

hashtagRequest-Body

hashtagDELETE /boss/schedules/{scheduleId}

hashtagRequest-Header

hashtagGET /boss/schedules/reports/dates

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

hashtagGET /boss/schedules/reports

hashtagRequest-Header

hashtagParams

hashtagResponse-Body

📌 스케줄 상태 Enum

📌 전체 스케줄 상태 Enum

GET /boss/schedules/home

Request-Header

Response-Body

GET /boss/schedules/home/selected

Request-Header

Params

Response-Body

✅ 논리적 스케줄 시작/종료 시간?

GET /boss/schedules

Request-Header

Params

Response-Body

GET /boss/schedules/selected

Request-Header

Params

Response-Body

GET /boss/schedules/possible/staffs

Request-Header

Params

Response-Body

POST /boss/schedules

Request-Header

Request-Body

DELETE /boss/schedules/{scheduleId}

Request-Header

GET /boss/schedules/reports/dates

Request-Header

Params

Response-Body

GET /boss/schedules/reports

Request-Header

Params

Response-Body