From d8c0382c5b79bb559df91fbe7a3f24dff5a39310 Mon Sep 17 00:00:00 2001 From: Sangho Han <113084292+bbbang105@users.noreply.github.com> Date: Wed, 20 Nov 2024 17:50:34 +0900 Subject: [PATCH] Update README.md --- README.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 69 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 18803d0..ed99e68 100644 --- a/README.md +++ b/README.md @@ -1 +1,69 @@ -# backend +# OneTime Backend πŸš€ + +## 🌐 System Architecture + +image + +## 🧱 ERD + +원ᄐᅑ암_ERD + + +## πŸ“„ API Documentation + +[πŸ“ REST Docs + Swagger](https://onetime-test.store/swagger-ui/index.html#/) + +## πŸ”’ Rules + +### Branch + +- μƒμ„±ν•œ μ΄μŠˆμ— λ”°λΌμ„œ 브랜치 생성 `Ex) feature/#4/login` +- `main branch` : 개발 μ΅œμ’… μ™„λ£Œ μ‹œ merge +- `develop branch` : 배포 μ„œλ²„μš© +- `test branch` : ν…ŒμŠ€νŠΈ μ„œλ²„μš© +- `feature branch` : 각 μƒˆλ‘œμš΄ κΈ°λŠ₯ 개발 +- `hotfix branch` : 배포 이후 κΈ΄κΈ‰ μˆ˜μ • + +### **Commit Message** + +- 이슈 번호 λΆ™μ—¬μ„œ 컀밋 `Ex) #4 [feat] : 둜그인 κΈ°λŠ₯을 μΆ”κ°€ν•œλ‹€` +- BodyλŠ” μΆ”κ°€ μ„€λͺ… ν•„μš”ν•˜λ©΄ μ‚¬μš© + +| ***μž‘μ—…νƒœκ·Έ*** | ***λ‚΄μš©*** | +| --- | --- | +| **feat** | μƒˆλ‘œμš΄ κΈ°λŠ₯ μΆ”κ°€ / 일뢀 μ½”λ“œ μΆ”κ°€ / 일뢀 μ½”λ“œ μˆ˜μ • (λ¦¬νŒ©ν† λ§κ³Ό ꡬ뢄) / λ””μžμΈ μš”μ†Œ μˆ˜μ • | +| **fix** | 버그 μˆ˜μ • | +| **refactor** | μ½”λ“œ λ¦¬νŒ©ν† λ§ | +| **style** | μ½”λ“œ μ˜λ―Έμ— 영ν–₯을 주지 μ•ŠλŠ” 변경사항 (μ½”λ“œ ν¬λ§·νŒ…, μ˜€νƒ€ μˆ˜μ •, λ³€μˆ˜λͺ… λ³€κ²½, 에셋 μΆ”κ°€) | +| **chore** | λΉŒλ“œ λΆ€λΆ„ ν˜Ήμ€ νŒ¨ν‚€μ§€ λ§€λ‹ˆμ € μˆ˜μ • 사항 / 파일 이름 λ³€κ²½ 및 μœ„μΉ˜ λ³€κ²½ / 파일 μ‚­μ œ | +| **docs** | λ¬Έμ„œ μΆ”κ°€ 및 μˆ˜μ • | +| **rename** | νŒ¨ν‚€μ§€ ν˜Ήμ€ 폴더λͺ…, 클래슀λͺ… μˆ˜μ • (λ‹¨λ…μœΌλ‘œ μ‹œν–‰ν•˜μ˜€μ„ μ‹œ) | +| **remove** | νŒ¨ν‚€μ§€ ν˜Ήμ€ 폴더, 클래슀λ₯Ό μ‚­μ œν•˜μ˜€μ„ λ•Œ (λ‹¨λ…μœΌλ‘œ μ‹œν–‰ν•˜μ˜€μ„ μ‹œ) | + +### Naming + +- **νŒ¨ν‚€μ§€λͺ…** : ν•œ 단어 μ†Œλ¬Έμž μ‚¬μš© `Ex) service` +- **클래슀λͺ…** : 파슀칼 μΌ€μ΄μŠ€ μ‚¬μš© `Ex) JwtUtil` +- **λ©”μ„œλ“œλͺ…** : 카멜 μΌ€μ΄μŠ€ μ‚¬μš©, λ™μ‚¬λ‘œ μ‹œμž‘ `Ex) getUserScraps` +- **λ³€μˆ˜λͺ…** : 카멜 μΌ€μ΄μŠ€ μ‚¬μš© `Ex) jwtToken` +- **μƒμˆ˜λͺ…** : λŒ€λ¬Έμž μ‚¬μš© `Ex) EXPIRATION_TIME` +- **컬럼λͺ…** : μŠ€λ„€μ΄ν¬ μΌ€μ΄μŠ€ μ‚¬μš© `Ex) user_id` + + +### API Response + +```json +{ + "code": "201", + "message": "이벀트 생성에 μ„±κ³΅ν–ˆμŠ΅λ‹ˆλ‹€.", + "payload": { + "event_id": "5e35b658-ee4b-4c52-98dc-94b79f0e64c9" + }, + "is_success": true +} +``` + +- `is_success` : 성곡 μ—¬λΆ€ +- `code` : 성곡 μ½”λ“œ, HTTP μƒνƒœ μ½”λ“œμ™€ 동일 +- `message` : 성곡 메세지 +- `payload` : 데이터가 λ“€μ–΄κ°€λŠ” κ³³