Skip to content

Commit

Permalink
Merge pull request #273 from TheUpperPart/Docs/#272
Browse files Browse the repository at this point in the history
Config: Update README
  • Loading branch information
navyjeongs authored Jan 1, 2024
2 parents 417c5f3 + 888d90a commit 9ecf8b3
Showing 1 changed file with 151 additions and 19 deletions.
170 changes: 151 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,161 @@
# Next.js + Jest
# LeagueHub

This example shows how to configure Jest to work with Next.js.
> **๊ฐœ์ธ์ด E-์Šคํฌ์ธ  ๋Œ€ํšŒ๋ฅผ ๊ฐœ์ตœ, ์ฐธ๊ฐ€๋ฅผ ํŽธ๋ฆฌํ•˜๊ฒŒ ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜์˜€์–ด์š”.**
This includes Next.js' built-in support for Global CSS, CSS Modules and TypeScript.
<aside>
๐Ÿ˜“ ์ˆ˜๊ธฐ, ์—‘์…€์„ ์ด์šฉํ•œ ๋Œ€ํšŒ ๊ด€๋ฆฌ์—์„œ ์˜ค๋Š” ๋ถˆํŽธํ•จ

## How to Use
</aside>

Quickly get started using [Create Next App](https://github.com/vercel/next.js/tree/canary/packages/create-next-app#readme)!
- ์ž‘์€ ์ปค๋ฎค๋‹ˆํ‹ฐ ๋Œ€ํšŒ์—์„œ๋ถ€ํ„ฐ ํฐ ๊ธฐ๊ด€์ด ์ฃผ์ตœํ•˜๋Š” ๋Œ€๊ทœ๋ชจ ๋Œ€ํšŒ์— ์ด๋ฅด๊ธฐ๊นŒ์ง€, ๋งŽ์€ E-์Šคํฌ์ธ  ๋Œ€ํšŒ๊ฐ€ ์žˆ์–ด์š”.
- ๋Œ€ํšŒ์˜ ์กฐ ๋ฐฐ์ •, ๊ฒฝ๊ธฐ ์ˆœ์œ„ ๊ธฐ๋ก ๋“ฑ ๋Œ€ํšŒ ๊ด€๋ฆฌ๋Š” ์—‘์…€์„ ์ด์šฉํ•ด ์ˆ˜์ž‘์—…์œผ๋กœ ์ง„ํ–‰๋˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์•„, ๋Œ€ํšŒ ์ฃผ์ตœ์ž์™€ ์ฐธ๊ฐ€์ž ๋ชจ๋‘์—๊ฒŒ ๋ถˆํŽธํ•จ์„ ์ฃผ์—ˆ์–ด์š”.
- ๊ธฐ๋ก ์‹œ์— ์‹ค์ˆ˜์˜ ๊ฐ€๋Šฅ์„ฑ, ๋น„์ง๊ด€์ ์ธ ํ”„๋กœ์„ธ์Šค ๋ฐ UI ๋“ฑ์€ E-์Šคํฌ์ธ  ๋Œ€ํšŒ๋ฅผ ๊ฐœ์ตœํ•˜๊ฑฐ๋‚˜ ์ฐธ๊ฐ€ํ•˜๊ธฐ ๋ถ€๋‹ด์Šค๋Ÿฝ๊ฒŒ ๋งŒ๋“ค์—ˆ์–ด์š”.
- ์ด๋Ÿฌํ•œ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๊ธฐ ์œ„ํ•ด, ์šฐ๋ฆฌ๋Š” LeagueHub๋ฅผ ๊ฐœ๋ฐœํ•˜์˜€์–ด์š”.

In your terminal, run the following command:

```bash
npx create-next-app --example with-jest with-jest-app
```
## ๋ฐ”๋กœ๊ฐ€๊ธฐ ๋ฐ ์‹œ์—ฐ

```bash
yarn create next-app --example with-jest with-jest-app
```
### [LeagueHub ์‚ฌ์ดํŠธ ๋ฐ”๋กœ๊ฐ€๊ธฐ](https://leaguehub.co.kr/)

```bash
pnpm create next-app --example with-jest with-jest-app
```
### [LeagueHub ๋…ธ์…˜ ๋ฐ”๋กœ๊ฐ€๊ธฐ](https://hyeonjun0530.notion.site/League-Hub-850d21e06cb844eea424eae8f7b3bc24?pvs=4)

## Run Jest Tests
### [LeagueHub ์‹œ์—ฐ์˜์ƒ](https://youtu.be/yH1I6k4Sq4Y)

```bash
npm test
```
## Github

### ๐Ÿ”—[Github(Frontend)](https://github.com/TheUpperPart/leaguehub-Frontend)

### ๐Ÿ”—[Github(Backend)](https://github.com/TheUpperPart/leaguehub-backend)

### ๐Ÿ”—[Github(Organization)](https://github.com/TheUpperPart)


## ํ•ต์‹ฌ ๊ธฐ๋Šฅ

### `๋ฉ”์ธํŽ˜์ด์ง€(๊ด€๋ฆฌ์ž, ์‚ฌ์šฉ์ž)`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184715869683716126/Untitled.png?ex=658cfba2&is=657a86a2&hm=2fd513731ece8c68bd67d9f4890d3e90130a8a1e3918460e251892956f44e386&)

โถ ๋Œ€ํšŒ(์ฑ„๋„) ์ฐธ๊ฐ€

โท ์ด๋ฏธ ๋“ค์–ด๊ฐ„ ์ฑ„๋„์„ ์„ ํƒํ•˜์—ฌ ์ฑ„๋„ ๋‘˜๋Ÿฌ๋ณด๊ธฐ

โธ ํ•ด๋‹น ์›น ์„œ๋น„์Šค์˜ ๊ณต์ง€์‚ฌํ•ญ ํ™•์ธ

โน ๊ฒŒ์ž„์˜ ํŒจ์น˜๋…ธํŠธ ํ™•์ธ

### `๊ด€๋ฆฌ์ž - ๋Œ€ํšŒ ๊ด€๋ฆฌ ํŽ˜์ด์ง€`

| ![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184715919516246036/Untitled.png?ex=658cfbae&is=657a86ae&hm=79b30a872a331607d02d20d169c21b3e051895e821cce233a7fd3021040b32a6&) | ![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184717842508165161/Untitled.png?ex=658cfd78&is=657a8878&hm=a862efa705b689b3e8ba3609b58974c64389e2356d62161f2eefe1c7440c5b08&) |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

โถ ์ฑ„๋„์˜ ํ™ˆ ํ™”๋ฉด์—์„œ ๋Œ€ํšŒ์˜ ์ •๋ณด๋ฅผ ์ˆ˜์ •

โท ๋Œ€ํšŒ ๊ด€๋ฆฌ์—์„œ ๋Œ€ํšŒ ์„ค์ •(๋Œ€ํšŒ ์‹œ์ž‘, ๊ฒฝ๊ธฐ ๋ฐฐ์ •, ์ฑ„๋„ ์ •๋ณด ์ˆ˜์ •) ๋ฐ ๋Œ€ํšŒ ์•Œ๋ฆผ ํ™•์ธ

### `์ฑ„๋„ ์ถ”๊ฐ€ํ•˜๊ธฐ`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184717911043096626/Untitled.png?ex=658cfd88&is=657a8888&hm=9f2f190c0a20a78cf4dc7159432c78ca73feb26143eb974dbcedf67f44dcee64&)

โถ ๋Œ€ํšŒ ๊ฐœ์ตœ๋ฅผ ์ด์šฉํ•˜์—ฌ ์ž์‹ ์˜ ์ฑ„๋„ ์ƒ์„ฑ

โท ๋‹ค๋ฅธ ์ฑ„๋„์˜ ์ฐธ์—ฌ ์ฝ”๋“œ๋ฅผ ์ด์šฉํ•˜์—ฌ ์ฑ„๋„ ์ฐธ์—ฌ

### `์ฑ„๋„ ์ƒ์„ฑํ•˜๊ธฐ`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184717952868700170/Untitled.png?ex=658cfd92&is=657a8892&hm=288772e38098be3edfb4023f242870e07a3a54162171d16d753c20cf0e4c6d03&)

โถ ์˜ˆ์‹œ ํผ์„ ์ž‘์„ฑํ•˜์—ฌ ์ฑ„๋„์„ ์ƒ์„ฑ

โท ์ปค์Šคํ…€ ๋ฃฐ, ๋Œ€ํšŒ ์ด๋ฏธ์ง€๋ฅผ ์„ ํƒํ•˜์—ฌ ์„ค์ •

### `์ฑ„๋„ ์ฐธ๊ฐ€ํ•˜๊ธฐ`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184717980647571456/Untitled.png?ex=658cfd99&is=657a8899&hm=33bedd6f42f73d6adb50da94d994bdcf67bab754fd5013e14e633650238c2522&)

โถ ์ฐธ์—ฌ ์ฝ”๋“œ๋ฅผ ์ž…๋ ฅํ•˜์—ฌ ์ฑ„๋„ ์ฐธ์—ฌ

### ๊ฒฝ๊ธฐ ํŽ˜์ด์ง€(๊ด€๋ฆฌ์ž, ์‚ฌ์šฉ์ž)

### `๊ด€๋ฆฌ์ž - ๊ฒฝ๊ธฐ ํŽ˜์ด์ง€`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184718125632065576/image.png?ex=658cfdbc&is=657a88bc&hm=4430460ce1e3709b63ec55fc28c0978621edc80b848f65d0c53fb024a75a9731&)

โถ ์‹ค๊ฒฉ ์ฒ˜๋ฆฌ ๋ฒ„ํŠผ์„ ์ด์šฉํ•˜์—ฌ ํ•ด๋‹น ๋Œ€ํšŒ ์ฐธ๊ฐ€์ž ์‹ค๊ฒฉ

โท ์ฑ„ํŒ…์„ ํ†ตํ•˜์—ฌ ์ฐธ๊ฐ€๋“ค๊ณผ ์†Œํ†ต

โธ ์ฒดํฌ ๋ฐ•์Šค(์ฒดํฌ์ธ)์„ ํ†ตํ•œ ์ค€๋น„ ํ™•์ธ

### `์‚ฌ์šฉ์ž - ๊ฒฝ๊ธฐ ํŽ˜์ด์ง€`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184718186025848854/Untitled.png?ex=658cfdca&is=657a88ca&hm=8291fb976ce8545f81ab888eba7be11f5518c87cacc5109aceb83a63013c6185&)

โถ ์ค€๋น„ ๋ฒ„ํŠผ์„ ํ†ตํ•œ ์ค€๋น„(์ฒดํฌ ๋ฐ•์Šค) ์ฒดํฌ

โท ์ดˆ๋ก์ƒ‰ ๋ฐฐ๊ฒฝ์„ ํ†ตํ•œ ์ž์‹ ์˜ ์œ„์น˜ ํ™•์ธ

โธ ์ฒดํฌ ๋ฐ•์Šค(์ฒดํฌ์ธ)์„ ํ†ตํ•œ ์ค€๋น„ ํ™•์ธ

โน ์ฑ„ํŒ…์„ ํ†ตํ•œ ๊ด€๋ฆฌ์ž ๋ฐ ์ฐธ๊ฐ€์ž์™€์˜ ์†Œํ†ต, Call Admin์„ ํ†ตํ•œ ๊ด€๋ฆฌ์ž ํ˜ธ์ถœ

### `๋Œ€์ง„ํ‘œ`

![Untitled](https://cdn.discordapp.com/attachments/1184714823334899802/1184719012924489808/Untitled.png?ex=658cfe8f&is=657a898f&hm=5b8735b44cb249d59479e289536da8e7d44201a29bb98bd83f5b8552d811a4a5&)

โถ ๋Œ€์ง„ํ‘œ๋ฅผ ํ†ตํ•˜์—ฌ ์ฐธ์—ฌ์ž ํ™•์ธ

โท ๋Œ€์ง„ํ‘œ์˜ ํšŒ์ƒ‰ ๋ฐ”ํƒ•์„ ํ†ตํ•˜์—ฌ ์‹ค๊ฒฉ์ž ํ™•์ธ

โธ ์ž์„ธํžˆ ๋ฒ„ํŠผ ๋˜๋Š” ํ˜„์žฌ ๋ผ์šด๋“œ(๋ผ์šด๋“œ 2)๋ฅผ ํ†ตํ•˜์—ฌ ํ•ด๋‹น ๊ทธ๋ฃน์˜ ๋Œ€ํšŒ ํŽ˜์ด์ง€๋กœ ์ด๋™ ๊ฐ€๋Šฅ

โน ๋นจ๊ฐ„ ์ ์„ ํ†ตํ•˜์—ฌ ํ˜„์žฌ Round ํ™•์ธ

### ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜

![Architecure.png](https://cdn.discordapp.com/attachments/1184714823334899802/1184719086706499614/Architecure.png?ex=658cfea1&is=657a89a1&hm=1a3b0b0da38483820655247909b90a2e1e0fbc79770c121f3e5f9623bf710ab0&)

### Frontend

> 1๏ธโƒฃ Nextjs 13์„ ์‚ฌ์šฉํ•ด์„œ SSR ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ–ˆ์–ด์š”.
- `page router`๋ฅผ ์‚ฌ์šฉํ•ด์„œ SSR ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ–ˆ์–ด์š”.
- meta ํƒœ๊ทธ ์ž‘์„ฑ, title ๋ณ€๊ฒฝ๋“ฑ์œผ๋กœ SEO ์ตœ์ ํ™”๋ฅผ ํ–ˆ์–ด์š”.

> 2๏ธโƒฃ ํ…Œ์ŠคํŠธ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ–ˆ์–ด์š”.
- `Jest`์™€ `React Testing Library`๋กœ ํ…Œ์ŠคํŠธ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ–ˆ์–ด์š”.

> 3๏ธโƒฃ `Docker` ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•˜์—ฌ `CI/CD`๋ฅผ ์ž๋™ํ™”ํ•˜์˜€์–ด์š”.
- CI/CD๋ฅผ ์ž‘์„ฑํ•˜์—ฌ ๋ฐฐํฌ ์‹œ๊ฐ„์„ ๋‹จ์ถ•ํ•˜์˜€์–ด์š”.

> 4๏ธโƒฃ Stomp ์›น ์†Œ์ผ“์„ ์‚ฌ์šฉํ•˜์—ฌ ์‹ค์‹œ๊ฐ„ ์„œ๋น„์Šค๋ฅผ ๊ตฌํ˜„ํ–ˆ์–ด์š”.
### Backend

> 1๏ธโƒฃ Java ๊ธฐ๋ฐ˜์˜ Spring Boot๋ฅผ ์ด์šฉํ•˜์—ฌ ์„œ๋ฒ„๋ฅผ ๊ตฌ์„ฑํ–ˆ์–ด์š”.
- `Jacoco 0.8.7`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ…Œ์ŠคํŠธ ์ปค๋ฒ„๋ฆฌ์ง€ 70%๋ฅผ ์œ ์ง€ํ–ˆ์–ด์š”.

> 3๏ธโƒฃ Spring Security๋ฅผ ์ด์šฉํ•œ OAuth 2.0 ๊ธฐ๋ฐ˜์˜ ๋‹ค์–‘ํ•œ ์†Œ์…œ ๋กœ๊ทธ์ธ์„ ๊ตฌํ˜„ํ–ˆ์–ด์š”.
- Jwt๋ฅผ ํ™œ์šฉํ•ด ์นด์นด์˜ค ๋กœ๊ทธ์ธ์„ ๊ตฌํ˜„ํ–ˆ์–ด์š”.
- Jwt ๊ธฐ๋ฐ˜์˜ `stateless`ํ•œ ๋กœ๊ทธ์ธ์„ ๊ตฌํ˜„ํ–ˆ์–ด์š”.

> 4๏ธโƒฃ Stomp ์›น ์†Œ์ผ“์„ ์‚ฌ์šฉํ•˜์—ฌ ์‹ค์‹œ๊ฐ„ ์„œ๋น„์Šค๋ฅผ ๊ตฌํ˜„ํ–ˆ์–ด์š”.
- `Riot API`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊ฒฝ๊ธฐ ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธ ํ›„ ์‹ค์‹œ๊ฐ„ ์ ์ˆ˜ ์—…๋ฐ์ดํŠธ๋ฅผ ํ–ˆ์–ด์š”.
- ์‹ค์‹œ๊ฐ„ ์ฑ„ํŒ… ์„œ๋น„์Šค๋ฅผ ๊ตฌํ˜„ํ•˜๊ธฐ ์œ„ํ•ด `Redis`๋ฅผ ์ด์šฉํ–ˆ์–ด์š”.
- ์œ ์ €์˜ ์ฒดํฌ์ธ, ์•Œ๋ฆผ์„ ๊ตฌํ˜„ํ–ˆ์–ด์š”.

# **ํŒ€ ์†Œ๊ฐœ**

### CONTACT

| ๊น€ํ˜„์ค€ | ๋ฐ•์ •์„ | ์ด์ƒ์—ฝ | ์ด๊ฒฝํ›ˆ | ํ™์„ฑ์šฐ |
| :------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------: |
| [![image](https://avatars.githubusercontent.com/u/102659136?v=4)](https://github.com/HyeonJun0530) | [![image](https://avatars.githubusercontent.com/u/100738049?v=4)](https://github.com/navyjeongs) | [![image](https://avatars.githubusercontent.com/u/71641127?v=4)](https://github.com/pp449) | [![image](https://avatars.githubusercontent.com/u/87762815?v=4)](https://github.com/TinyFrogs) | [![image](https://avatars.githubusercontent.com/u/48763809?v=4)](https://github.com/hennible0612) |
| [๐Ÿ”—Github](https://github.com/HyeonJun0530) | [๐Ÿ”—github](https://github.com/navyjeongs) | [๐Ÿ”—github](https://github.com/pp449) | [๐Ÿ”—github](https://github.com/TinyFrogs) | [๐Ÿ”—github](https://github.com/hennible0612) |
| BE | FE | FE | BE | BE |
| [email protected] | [email protected] | [email protected] | [email protected] | [email protected] |

0 comments on commit 9ecf8b3

Please sign in to comment.