Skip to content

Commit

Permalink
πŸ’„design: readme λ””μžμΈ μˆ˜μ •
Browse files Browse the repository at this point in the history
  • Loading branch information
heejung0413 committed Jun 1, 2024
1 parent 36fc376 commit 9e78e8e
Showing 1 changed file with 116 additions and 25 deletions.
141 changes: 116 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,126 @@
# Stock2U-Front
# πŸ“– 재고 판맀 μ›Ή μ„œλΉ„μŠ€, Stock2U

## Git branching model
![mainPage](/public/svg/brand/logo-text.svg) <br>

<aside>
πŸ“Œ **Base 브랜치(upstream)의 μ’…λ₯˜**
<div align='center'>

- `main` - 릴리즈
- `develop` - 개발
[πŸ’» μ‚¬μ΄νŠΈ λ°”λ‘œκ°€κΈ°](https://www.pastforward.link)
<br>

**Local 브랜치의 μ’…λ₯˜**
</div>
<br>

- `feature/{ticket|name}` - κ³„νšλœ 피쳐 개발(T1)
- `fix/{ticket|name}` - κ³„νšλœ 패치 적용(T2)
- `hotfix/{ticket|name}` - κ³„νšλ˜μ§€ μ•Šμ€ κΈ΄κΈ‰ μˆ˜μ •(T3)
</aside>
## ν”„λ‘œμ νŠΈ μ†Œκ°œ

## Commit guide
- Stock2UλŠ” 재고 μ†Œμ§„μ΄ μ–Όλ§ˆ 남지 μ•Šμ€ 판맀 μƒν’ˆμ„ ν• μΈν•œ κ°€κ²©μœΌλ‘œ κ΅¬λ§€μžμ—κ²Œ νŒλ§€ν•  수 μžˆλŠ” μ›Ήμ„œλΉ„μŠ€μž…λ‹ˆλ‹€.
- μ£Όμš” κΈ°λŠ₯은 μœ„μΉ˜ 기반 재고 μƒν’ˆ 확인 κΈ°λŠ₯, μ±„νŒ… κΈ°λŠ₯, μƒν’ˆ 등둝 및 μƒμ„ΈνŽ˜μ΄μ§€,ν”„λ‘œν•„ μ„€μ • 등이 μžˆμŠ΅λ‹ˆλ‹€.

- `feat:` - μƒˆλ‘œμš΄ κΈ°λŠ₯에 λŒ€ν•œ 컀밋
- `fix:` - 버그 μˆ˜μ •μ— λŒ€ν•œ 컀밋
- `build:` - λΉŒλ“œ κ΄€λ ¨ 파일 μˆ˜μ •μ— λŒ€ν•œ 컀밋
- `chore:` - κ·Έ μ™Έ μžμž˜ν•œ μˆ˜μ •μ— λŒ€ν•œ 컀밋
- `docs:` - λ¬Έμ„œ μˆ˜μ •μ— λŒ€ν•œ 컀밋
- `style:` - μ½”λ“œ μŠ€νƒ€μΌ ν˜Ήμ€ 포맷 등에 κ΄€ν•œ 컀밋
- `refactor:` - μ½”λ“œ λ¦¬νŒ©ν† λ§μ— λŒ€ν•œ 컀밋
- `test:` - ν…ŒμŠ€νŠΈ μ½”λ“œ μˆ˜μ •μ— λŒ€ν•œ 컀밋
<br>

## Code review guide
## νŒ€μ› ꡬ성

ν•„μš”ν•œ 경우 μ•„λž˜μ˜ 말머리λ₯Ό μ‚¬μš©ν•΄ μ£Όμ„Έμš”.
<div align="center">

- [질문] - λ‹¨μˆœ 질문. ν•΄κ²°λ˜μ§€ μ•Šμ•„λ„ 머지 κ°€λŠ₯
- [의견] - λ‹¨μˆœ 간단 의견. ν•΄κ²°λ˜μ§€ μ•Šμ•„λ„ 머지 κ°€λŠ₯
- [λ³€κ²½μš”μ²­] - λ™μž‘ν•˜μ§€ μ•ŠλŠ” λΆ€λΆ„μ΄λ‚˜ 잘λͺ»λœ 뢀뢄이 μžˆμ„ λ•Œ(λ°˜λ“œμ‹œ μˆ˜μ • ν•„μš”)
| Front-End | Front-End | Front-End |
| :----------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------: |
| <img src="https://github.com/bear-bear-bear.png?size=120" title="" alt="μ •λ―Ό2.png" width="100%"> | <img src="https://github.com/heejung0413.png?size=120" title="" alt="μž„ν¬μ •.png" width="100%"> | <img src="https://github.com/Ellsy23.png?size=120" title="" alt="μ΄μ€€ν˜„.png" width="100%"> |
| κΉ€μž¬μ€€ | μž„ν¬μ • | μ΄μ€€ν˜„ |
| [@bear-bear-bear](https://github.com/bear-bear-bear) | [@bheejung0413](https://github.com/heejung0413) | [@Ellsy23](https://github.com/Ellsy23) |

</div>

<br>

## 1. 개발 ν™˜κ²½

- Front : HTML, React, Chakra UI, Recoil, TypeScript, axios, vite, husky, prettier, ESLint, babel
- Back-end : 제곡된 API ν™œμš©
- 버전 및 μ΄μŠˆκ΄€λ¦¬ : Github, Confluence, Jira
- ν˜‘μ—… 툴 : GatherTown, Notion, Slack
- μ„œλΉ„μŠ€ 배포 ν™˜κ²½ : Vercel
- 🎨 λ””μžμΈ : [Figma](https://www.figma.com/design/0Qmoy4VGV5lesJ2GnHj8j7/%EB%A9%80%ED%8B%B0%EC%BA%A0%ED%8D%BC%EC%8A%A4-%ED%95%B4%EC%BB%A4%ED%86%A4-2023?node-id=0-1&t=r2f98qCZlpU9L7i1-1)
- πŸ‘©πŸ»β€πŸ’» 이슈 관리 : [Jira](https://geezers-io.atlassian.net/jira/software/projects/SU/boards/1/backlog?epics=visible)

<br>

## 2. μ±„νƒν•œ 개발 기술

### React, Typescript

- React
- μ»΄ν¬λ„ŒνŠΈν™”λ₯Ό 톡해 μΆ”ν›„ μœ μ§€λ³΄μˆ˜μ™€ μž¬μ‚¬μš©μ„±μ„ κ³ λ €ν–ˆμŠ΅λ‹ˆλ‹€.
- μœ μ € λ°°λ„ˆ, 상단과 ν•˜λ‹¨ λ°°λ„ˆ λ“± μ€‘λ³΅λ˜μ–΄ μ‚¬μš©λ˜λŠ” 뢀뢄이 λ§Žμ•„ μ»΄ν¬λ„ŒνŠΈν™”λ₯Ό 톡해 λ¦¬μ†ŒμŠ€ μ ˆμ•½μ΄ κ°€λŠ₯ν–ˆμŠ΅λ‹ˆλ‹€.
- Typescript
- μ•ˆμ •μ μΈ 개발과 높은 μ½”λ“œ μˆ˜μ€€μ˜ μ½”λ“œ ν’ˆμ§ˆμ„ μœ μ§€ν•˜λ €λ©΄ 정적 νƒ€μž… 문법을 μΆ”κ°€ν•΄ κ°œλ°œν•˜λŠ” 것이 νŽΈλ¦¬ν•˜λ‹€ μƒκ°ν–ˆμŠ΅λ‹ˆλ‹€.
- λ³€μˆ˜ νƒ€μž…μ„ μ§€μ •ν•˜κ³  javascript둜 μ»΄νŒŒμΌλ˜μ–΄ μ‹€ν–‰ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
- 컴파일 κ³Όμ •μ—μ„œ νƒ€μž…μ„ μ§€μ •ν•¨μœΌλ‘œμ¨, μ—λŸ¬ 예방과 μ†μ‰¬μš΄ 디버깅이 κ°€λŠ₯ν–ˆμŠ΅λ‹ˆλ‹€.

### Chakra UI

- Chakra UI
- React μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ„ λΉŒλ“œν•˜λŠ”λ° ν•„μš”ν•œ 블둝을 κ°„λ‹¨ν•˜κ³  λͺ¨λ“ˆμ μ΄λ©° μ ‘κ·Ό κ°€λŠ₯ν•˜κ²Œ λ§Œλ“€ 수 μžˆλŠ” UI μ»΄ν¬λ„ŒνŠΈ λΌμ΄λΈŒλŸ¬λ¦¬μž…λ‹ˆλ‹€.

### eslint, prettier

- 정해진 κ·œμΉ™μ— 따라 μžλ™μ μœΌλ‘œ μ½”λ“œ μŠ€νƒ€μΌμ„ 정리해 μ½”λ“œμ˜ 일관성을 μœ μ§€ν•˜κ³ μž ν–ˆμŠ΅λ‹ˆλ‹€.
- μ½”λ“œ ν’ˆμ§ˆ κ΄€λ¦¬λŠ” eslint에, μ½”λ“œ ν¬λ§·νŒ…μ€ prettier에 μΌμž„ν•΄ μ‚¬μš©ν–ˆμŠ΅λ‹ˆλ‹€.
- airbnb의 μ½”λ”© μ»¨λ²€μ…˜μ„ μ°Έκ³ ν•΄ μ‚¬μš©ν–ˆκ³ , μ˜ˆμ™Έ κ·œμΉ™μ€ νŒ€μ›λ“€κ³Ό ν˜‘μ˜ν–ˆμŠ΅λ‹ˆλ‹€.
- ν˜‘μ—… μ‹œ 맀번 μ»¨λ²€μ…˜μ„ μ‹ κ²½ μ“Έ ν•„μš” 없이 λΉ λ₯΄κ²Œ κ°œλ°œν•˜λŠ” 데에 λͺ©μ μ„ λ‘μ—ˆμŠ΅λ‹ˆλ‹€.

<br>

## 3. μ—­ν•  λΆ„λ‹΄

### 🀩 κΉ€μž¬μ€€

- **UI**
- νŽ˜μ΄μ§€ : 둜그인/νšŒμ›κ°€μž… νŽ˜μ΄μ§€, 재고 μƒν’ˆ 지도 νŽ˜μ΄μ§€, λ ˆμ΄μ•„μ›ƒ
- **κΈ°λŠ₯**
- 인증 처리
- 재고 μƒν’ˆ 지도 기반 μ„œλΉ„μŠ€ κ΅¬ν˜„
- κ°œλ°œν™˜κ²½ ꡬ좕 (vite μ‚¬μš©)

<br>

### πŸ‘»μž„ν¬μ •
- **UI**
- νŽ˜μ΄μ§€ : μƒν’ˆ 등둝 νŽ˜μ΄μ§€, μƒν’ˆ 상세 νŽ˜μ΄μ§€, ν”„λ‘œν•„ νŽ˜μ΄μ§€
- 곡톡 μ»΄ν¬λ„ŒνŠΈ : 이미지 μ—…λ‘œλ” μ»΄ν¬λ„ŒνŠΈ κ΅¬ν˜„

- **κΈ°λŠ₯**
- μƒν’ˆ 등둝 κΈ°λŠ₯ κ΅¬ν˜„ (이미지 파일 μ—…λ‘œλ“œ, 제λͺ©/상세섀λͺ…/κΈ°κ°„ 지정)
- 판맀자 ꡬ독 κΈ°λŠ₯
- ν”„λ‘œν•„ μ„€μ •

<br>

### πŸ‘©πŸ»β€πŸ’» μ΄μ€€ν˜„

- **UI**

- νŽ˜μ΄μ§€: λ©”μΈνŽ˜μ΄μ§€, ν”„λ‘œν•„ νŽ˜μ΄μ§€
- 곡톡 μ»΄ν¬λ„ŒνŠΈ, 이미지 μΊλŸ¬μ…€, νŽ˜μ΄μ§€λ„€μ΄μ…˜, μΈν”Όλ‹ˆν‹°μŠ€ν¬λ‘€ μ»΄ν¬λ„ŒνŠΈ κ΅¬ν˜„

- **κΈ°λŠ₯**
- λ©”μΈνŽ˜μ΄μ§€ 전체적인 κΈ°λŠ₯ κ΅¬ν˜„

<br>

<br>

## 4. 개발 κΈ°κ°„ 및 μž‘μ—… 관리

### 개발 κΈ°κ°„

- 전체 개발 κΈ°κ°„ : 2023.09.24 - 2023.01.09

<br>

### μž‘μ—… 관리

- GitHub Projects둜 λ°±μ—”λ“œμ™€μ˜ issue 상황을 νŒŒμ•…ν•˜λ©° ν”„λ‘œμ νŠΈλ₯Ό μ§„ν–‰ν•˜μ˜€μŠ΅λ‹ˆλ‹€.
- issue λ²ˆν˜Έμ— 따라 브랜치 λ„€μž„μ„ μ •ν•˜λ©° μ „λž΅μ— λ§žμΆ”μ–΄ 브랜치λ₯Ό μƒμ„±ν•˜μ˜€μŠ΅λ‹ˆλ‹€.

<br>

<br>

0 comments on commit 9e78e8e

Please sign in to comment.