서울과학기술대학교 멋쟁이사자처럼 장기 프로젝트 "외출준비 (Go Ready)"

2024.09.13 ~ 2024.11.28

📌 서비스 소개 - 당신의 외출준비, 탭 2번이면 끝나요!

👥 Developers

오세연	이소라	노경인	박신형
@oosedus	@leeesoraaa	@kyinn1307	@shinh09
💻 Backend Lead	💻 Backend	🕸️ Frontend Lead	🕸️ Frontend

📄 API 명세서

1. 기온/강수 조회 API

항목	설명
기능명	기온/강수 조회
기능 설명	현재 기온 및 강수 정보를 제공합니다.
Method	GET
Query Parameters	lat (위도), lon (경도)

End Point

GET /weather?lat={latitude}&lon={longitude}

Response Example

✅ Success (200 OK)

{
    "status": 200,
    "message": "날씨 조회 성공입니다.",
    "data": {
        "status": "hot",
        "isUmbrella": true,
        "hightemp": 25,
        "lowtemp": 13,
        "difftemp": 2,
        "currenttemp": 22,
        "rainper": 70
    }
}

2. 미세먼지 조회 API

항목	설명
기능명	미세먼지 조회
기능 설명	기능 설명 마스크 착용 유무와 경보 여부 확인에 사용합니다.
Method	GET
Query Parameters	lat (위도), lon (경도)

End Point

GET /mask?lan={latitude}&lon={longitude}

Response Example

✅ Success (200 OK)

{
    "status": 200,
    "message": "미세먼지 조회 성공입니다.",
    "data": {
        "alert": true,
        "isMask": true,
        "address": "공릉동"
    }
}

💻 Stack

🛠️ BackEnd

Language & Framework

Database

Build Tool

Cloud & Hosting

Containerization & CI/CD

Network & Security

🌐 FrontEnd

Language & Framework

Deployment

🌎 Co-Work

[]

🏛️ System Architecture

📏 Convention

commit convention
conventionType: 구현한 내용

convention Type

convention type	description
feat	새로운 기능 구현
add	파일 및 코드 추가
chore	부수적인 코드 수정 및 기타 변경사항
docs	문서 추가 및 수정, 삭제
fix	버그 수정
rename	파일 및 폴더 이름 변경
test	테스트 코드 추가 및 수정, 삭제
refactor	코드 리팩토링

Branch

• 컨벤션명/#이슈번호
• pull request를 통해 develop branch에 merge 후, branch delete
• 부득이하게 develop branch에 직접 commit 해야 할 경우, !hotfix: 사용