Skip to content

Commit

Permalink
Merge pull request #82 from MEGUMMY1/master
Browse files Browse the repository at this point in the history
Docs: Readme update
  • Loading branch information
MEGUMMY1 authored Aug 9, 2024
2 parents d2bd80f + 0ee7037 commit 955c445
Showing 1 changed file with 174 additions and 24 deletions.
198 changes: 174 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,190 @@
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
# 🌐 GLOBAL_NOMAD
<div align="center">
https://globalnomad-5-8.netlify.app/
</div>

## Getting Started
## πŸ’‘ μ„œλΉ„μŠ€ μ†Œκ°œ
<div align="center">
<img src="https://github.com/user-attachments/assets/55a9c18b-0f8a-4012-bfca-914a4c2f86db" alt="image" width="600"/>
<br> <br>

First, run the development server:
> μ‚¬λžŒλ“€μ΄ μ—¬ν–‰μ„Β κ°ˆ λ•Œ,Β κ°€μ„œ 뭘 할지, λΉ„μš©μ€Β μ–Όλ§ˆμΈμ§€ λ“±Β μ—¬λŸ¬ 고민을 ν•˜κ²Œ λœλ‹€. <br>
λ°”μœ ν˜„λŒ€μΈμ˜ 이런 고민을 쀄여주기 μœ„ν•΄Β ν”Œλž«νΌ μ•ˆμ—Β μž˜Β μ§œμΈΒ <br>μ²΄ν—˜ μƒν’ˆμ„ 보고 κ°„λ‹¨ν•˜κ²Œ μ˜ˆμ•½ν•  수 μžˆλŠ” μ„œλΉ„μŠ€μž…λ‹ˆλ‹€.
<br>
</div>
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
## πŸ«‚ νŒ€μ›
<div align="center">

| 이름 | μ—­ν•  |
|------------|--------------------------------------------------------------------------------------------------------------------------------------------------|
| πŸ’» [황은지](https://github.com/eunji-0623)<br>γ€€[πŸ‘‘PM]| - λ‚΄ μ²΄ν—˜ λͺ©λ‘ νŽ˜μ΄μ§€<br>- μ²΄ν—˜ 등둝 및 μˆ˜μ • Form κ΅¬ν˜„<br>- 문의 μ±„νŒ… κ΅¬ν˜„ |
| 🫠 [김보민](https://github.com/bomin0830) | - 둜그인/νšŒμ›κ°€μž… νŽ˜μ΄μ§€<br>- access/refresh token 및 μœ μ € 관리<br>- λ§ˆμ΄νŽ˜μ΄μ§€ - μ˜ˆμ•½ λ‚΄μ—­ νŽ˜μ΄μ§€ κ΅¬ν˜„<br>- νŽ˜μ΄μ§€ 별 메타데이터 관리<br>- μ²΄ν—˜ κ³΅μœ ν•˜κΈ° |
| πŸ‘ [λ°•μˆ˜λ―Ό](https://github.com/ssumai-kr) | - 메인화면 κ΅¬ν˜„<br>- 졜근 λ°©λ¬Έ μ²΄ν—˜ λͺ©λ‘ κ΅¬ν˜„<br>- μΉ΄ν…Œκ³ λ¦¬ 선택, 닀크λͺ¨λ“œ ν† κΈ€ λ²„νŠΌ, 검색 λ²„νŠΌ μ»΄ν¬λ„ŒνŠΈ |
| πŸš€ [정지성](https://github.com/Byukchong) | - μœ μ € ν”„λ‘œν•„<br>- SideNavigation<br>- Navigation Bar<br>- 마이 νŽ˜μ΄μ§€ - λ‚΄ 정보<br>- ν”„λ‘œμ νŠΈ λ°œν‘œ |
| 🍟 [μ‘°ν˜œμ§„](https://github.com/MEGUMMY1) | - Modal, Popup, Pagination, Footer μ»΄ν¬λ„ŒνŠΈ<br>- μ²΄ν—˜ 상세 νŽ˜μ΄μ§€<br>- μ˜ˆμ•½ ν˜„ν™© νŽ˜μ΄μ§€<br>- 닀크λͺ¨λ“œ ν…Œλ§ˆ κ΅¬ν˜„ |

</div>

## πŸ§‘β€πŸ’» 개발 ν™˜κ²½
<div align="center">
<img src="https://github.com/user-attachments/assets/9eecd07b-f981-4231-a37d-0e1e87ed554d" alt="image" width="600"/>
</div>

## πŸ“Œ μ»¨λ²€μ…˜
<details>
<summary>μ»¨λ²€μ…˜</summary>

* ν•¨μˆ˜λͺ…, λ³€μˆ˜λͺ…은 **Camel Case**둜 μž‘μ„±ν•©λ‹ˆλ‹€.
* μ»΄ν¬λ„ŒνŠΈλͺ…은 **Pascal Case**둜 μž‘μ„±ν•©λ‹ˆλ‹€.
* μ»΄ν¬λ„ŒνŠΈλͺ…은 **일반 ν•¨μˆ˜**둜, 이외 ν•¨μˆ˜λŠ” **ν™”μ‚΄ν‘œ ν•¨μˆ˜**λ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€.
* TYPE은 **INTERFACE**둜 μ •μ˜ν•©λ‹ˆλ‹€.
* 곡톡 νƒ€μž…μ€ λ”°λ‘œ κ΄€λ¦¬ν•˜λ˜, ν•œ μ»΄ν¬λ„ŒνŠΈμ—μ„œλ§Œ μ‚¬μš©λ˜λŠ” νƒ€μž…μ€ ν•΄λ‹Ή ν΄λ”μ—μ„œ κ΄€λ¦¬ν•©λ‹ˆλ‹€.
* TYPE 파일λͺ…은 `COMPONENT.types.ts` 둜 μ •ν•©λ‹ˆλ‹€.
* TYPE 이름은 `COMPONENT+’props’` 둜 μ •ν•©λ‹ˆλ‹€.
* PRλͺ…은 `νƒœκ·Έ: 컀밋섀λͺ…`으둜 μ •ν•©λ‹ˆλ‹€.

</details>

## πŸ› οΈ CI/CD
* github actionsλ₯Ό ν™œμš©ν•΄μ„œ 지속적 톡합 및 배포
* 개인 λΈŒλžœμΉ˜μ—μ„œ λ³€κ²½ 사항을 Pushν•˜λ©΄, CIκ°€ λ™μž‘λœλ‹€.
* 개인 λΈŒλžœμΉ˜μ—μ„œ master둜 Pull Requestλ₯Ό 보내면, CIκ°€ λ™μž‘λ˜κ³  build errorκ°€ μ—†μ–΄μ•Ό Mergeκ°€ λœλ‹€.
* Mergeκ°€ 되면, 운영 λ¦¬μ†ŒμŠ€μ— λ°°ν¬λœλ‹€.

## πŸ—οΈ ν”„λ‘œμ νŠΈ ꡬ쑰

<details>
<summary>ν”„λ‘œμ νŠΈ ꡬ쑰</summary>

```
πŸ“¦GlobalNomad
┣ πŸ“‚components
┃ ┣ πŸ“‚ActivityDetails
┃ ┃ ┣ πŸ“‚ImageContainer
┃ ┃ ┣ πŸ“‚Map
┃ ┃ ┣ πŸ“‚Reservation
┃ ┣ πŸ“‚AuthInputBox
┃ ┣ πŸ“‚Button
┃ ┣ πŸ“‚Calendar
┃ ┣ πŸ“‚CatergoryBtn
┃ ┣ πŸ“‚Chat
┃ ┣ πŸ“‚Chips
┃ ┣ πŸ“‚CustomCalendar
┃ ┣ πŸ“‚InputBox
┃ ┣ πŸ“‚KategorieDropdown
┃ ┣ πŸ“‚Lander
┃ ┣ πŸ“‚Layout
┃ ┣ πŸ“‚MetaData
┃ ┣ πŸ“‚Modal
┃ ┣ πŸ“‚MyActivity
┃ ┃ ┣ πŸ“‚Card
┃ ┃ β”— πŸ“‚Register
┃ ┣ πŸ“‚MyPageInput
┃ ┣ πŸ“‚NavigationDropdown
┃ ┣ πŸ“‚Pagination
┃ ┣ πŸ“‚Popup
┃ ┣ πŸ“‚PriceFilterBtn
┃ ┣ πŸ“‚ReservationFilter
┃ ┣ πŸ“‚ReservationListCard
┃ ┣ πŸ“‚Review
┃ ┣ πŸ“‚SearchBar
┃ ┣ πŸ“‚ShareButton
┃ ┣ πŸ“‚SideNavigation
┃ ┣ πŸ“‚Spinner
┃ ┣ πŸ“‚StatusIndicator
┃ ┣ πŸ“‚Theme
┃ β”— πŸ“‚ViewedActivities
┣ πŸ“‚docs
┃ β”— πŸ“œpull_request_template.md
┣ πŸ“‚hooks
┣ πŸ“‚pages
┃ ┣ πŸ“‚activity-details
┃ ┃ β”— πŸ“œ[id].tsx
┃ ┣ πŸ“‚api
┃ ┃ ┣ πŸ“‚activities
┃ ┃ ┣ πŸ“‚auth
┃ ┃ ┣ πŸ“‚myActivities
┃ ┃ ┣ πŸ“‚myNotifications
┃ ┃ ┣ πŸ“‚myReservations
┃ ┃ ┣ πŸ“‚users
┃ ┣ πŸ“‚myactivity
┃ ┣ πŸ“œ404.tsx
┃ ┣ πŸ“œcalendar.tsx
┃ ┣ πŸ“œindex.tsx
┃ ┣ πŸ“œlogin.tsx
┃ ┣ πŸ“œmypage.tsx
┃ ┣ πŸ“œreservation.tsx
┃ ┣ πŸ“œsignup.tsx
┃ ┣ πŸ“œ_app.tsx
┃ β”— πŸ“œ_document.tsx
┣ πŸ“‚public
┃ ┣ πŸ“‚icon
┃ ┣ πŸ“‚image
┃ β”— πŸ“œfavicon.ico
┣ πŸ“‚server
┣ πŸ“‚states
┣ πŸ“‚styles
β”— πŸ“‚utils
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
</details>

You can start editing the page by modifying `pages/index.tsx`. The page auto-updates as you edit the file.
## 🎞️ μ‹œμ—°
<div align="center">

[API routes](https://nextjs.org/docs/api-routes/introduction) can be accessed on [http://localhost:3000/api/hello](http://localhost:3000/api/hello). This endpoint can be edited in `pages/api/hello.ts`.
### [둜그인]
![login](https://github.com/user-attachments/assets/803476ca-40ec-465f-901f-1334222fe6d4)
### [메인화면1]
![landing](https://github.com/user-attachments/assets/78827ceb-355c-436b-9b95-c3fc52e26754)
### [메인화면2]
![landing2](https://github.com/user-attachments/assets/ef194c13-2aca-46f9-ae60-2d95c2712315)
### [μ˜ˆμ•½ λ‚΄μ—­]
![reservationlist](https://github.com/user-attachments/assets/dc1ef0c8-ed93-4110-8eeb-c7baf834a01e)
### [μ²΄ν—˜ 등둝]
![register](https://github.com/user-attachments/assets/e1d3855b-ec05-406b-80f2-49205dae2ff5)
### [문의 μ±„νŒ…, μ²΄ν—˜ μˆ˜μ •]
![chatnedit](https://github.com/user-attachments/assets/7e152993-4d72-420c-89db-cc02f1632c0f)
### [μ˜ˆμ•½ ν˜„ν™©, μ•Œλ¦Ό]
![calendarnnoti](https://github.com/user-attachments/assets/40298133-dcbb-49de-be1c-0cebfd467ec4)
### [μ²΄ν—˜ 상세]
![activity](https://github.com/user-attachments/assets/1839fbdf-3d09-4bd4-9e5c-e8fe9d44f540)
### [λͺ¨λ°”일 λ°˜μ‘ν˜•]
![mobile](https://github.com/user-attachments/assets/3bf9d537-1bc2-498a-9958-5dd05649b22e)

</div>

The `pages/api` directory is mapped to `/api/*`. Files in this directory are treated as [API routes](https://nextjs.org/docs/api-routes/introduction) instead of React pages.
## πŸ€” 회고
<details>
<summary>⭐ KEEP</summary>

This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
- μ—­ν•  뢄담이 잘 λ˜μ—ˆκ³ , 맑은 μž‘μ—…μ— μΆ©μ‹€νžˆ μž„ν•˜μ—¬μ„œ ν”„λ‘œμ νŠΈ 진행이 λ§€λ„λŸ¬μ› λ‹€.
- μ†Œν†΅μ΄ μ›ν• ν•˜μ—¬ λ°œμƒν•œ μ΄μŠˆλ‚˜ 곡유 사항듀을 전달함에 μžˆμ–΄ 어렀움이 μ—†μ—ˆλ‹€.
- μΆ”κ°€ κΈ°λŠ₯듀을 κ³ λ €ν•˜κ³  좔가함에 μžˆμ–΄μ„œ 열정적이닀.
- 개인 파트 뿐만 μ•„λ‹ˆλΌ 전체적인 ν”„λ‘œμ νŠΈ 완성도λ₯Ό μœ„ν•΄μ„œ λ…Έλ ₯ν–ˆλ‹€.
- μ˜κ²¬μ„ λ‹€μ–‘ν•˜κ²Œ 잘 λ‚΄μ£Όμ‹ λ‹€. 문제 상황 λ°œμƒ μ‹œ 본인이 μž‘μ—…ν•œ 뢀뢄이 μ•„λ‹ˆλ”λΌλ„ ν•¨κ»˜ ν•΄κ²°ν•˜λ €κ³  λ…Έλ ₯ν•œλ‹€. μ΄μŠˆλ‚˜ μž‘μ—… 상황 곡유λ₯Ό μž˜ν•΄μ£Όμ‹ λ‹€.
- μ½”μ–΄ νƒ€μž„μ„ μ •ν•΄ ν•¨κ»˜ μž‘μ—…ν•˜λ©΄μ„œ μ›ν™œν•˜κ²Œ μ†Œν†΅ν•  수 μžˆμ—ˆλ‹€. νŒ€ λ―ΈνŒ…κ³Ό λ…Έμ…˜μ„ 톡해 각자 μž‘μ—… μ˜ˆμƒ 기간을 κ³΅μœ ν•˜κ³ , κ·Έ κΈ°κ°„ 내에 μž‘μ—…μ„ μ™„λ£Œν•¨μœΌλ‘œμ¨ μ»΄ν¬λ„ŒνŠΈ, hook ν™œμš©μ΄ λ§€λ„λŸ¬μ› κ³ , ν”„λ‘œμ νŠΈλ₯Ό λΉ λ₯΄κ²Œ μ™„μ„±ν•  수 μžˆμ—ˆλ‹€.
- νŒ€μ› λͺ¨λ‘κ°€ λ¦¬νŒ©ν† λ§κ³Ό κΈ°λŠ₯ μΆ”κ°€ λΆ€λΆ„μ—μ„œλ„ 적극적으둜 μ°Έμ—¬ν•˜μ˜€λ‹€. λ‹€μ–‘ν•œ μ˜κ²¬μ„ μ œμ‹œν•˜κ³  ν”Όλ“œλ°±μ„ 잘 μˆ˜μš©ν–ˆλ‹€.
- λͺ¨λ‘κ°€ μ½”μ–΄νƒ€μž„μ— μ§‘μ€‘ν•˜κ³  μ±…μž„κ° 있게 μ°Έμ—¬ν•˜μ—¬ 개발 속도와 완성도가 ꡉμž₯히 높을 수 μžˆμ—ˆλ‹€.

## Learn More
</details>

To learn more about Next.js, take a look at the following resources:
<details>
<summary>⭐ TRY</summary>

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
- λ‹€λ₯Έ νŒ€μ›λΆ„λ“€μ΄ μž‘μ—…ν•œ 뢀뢄은 μ–΄λ–»κ²Œ κ΅¬ν˜„ν–ˆλŠ”μ§€ 곡유 μ‹œκ°„μ„ κ°–λŠ” 것도 쒋을 것 κ°™λ‹€.
- 주석 μ—΄μ‹¬νžˆ 달기 (특히 곡용으둜 자주 μ‚¬μš©λ˜λŠ” hook 같은 것듀!)
- μ΄μŠˆμ™€ ν•΄κ²° 방법에 λŒ€ν•œ λ‚΄μš©μ„ μ •λ¦¬ν•΄λ‘μ—ˆμœΌλ©΄ μ’‹μ•˜μ„ κ±° κ°™λ‹€.
- μš”κ΅¬μ‚¬ν•­μ— λ”°λ₯Έ ν…ŒμŠ€νŠΈμ™€ μ‚¬μš©μž μ€‘μ‹¬μ˜ 흐름 기반 ν…ŒμŠ€νŠΈλ₯Ό μ‹œλ„ν•΄λ³΄λŠ” 게 μ’‹μ•˜μ„ 것 κ°™μŠ΅λ‹ˆλ‹€.

You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
</details>

## Deploy on Vercel
<details>
<summary>⭐ PROBLEM</summary>

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
- 각자 μž‘μ—…ν–ˆλ˜ μ½”λ“œλ“€μ΄ μŒ“μ΄λ‹€ λ³΄λ‹ˆ, λ‹€λ₯Έ μ‚¬λžŒμ˜ μž‘μ—…μ„ μœ μ‹¬νžˆ μ²΄ν¬ν•˜μ§€ λͺ»ν–ˆλ‹€.
- μ΄ˆλ°˜μ—λŠ” 주석을 μ—΄μ‹¬νžˆ 달렀고 λ…Έλ ₯ν–ˆμ—ˆλŠ”λ°, ν›„λ°˜μœΌλ‘œ κ°€λ©΄μ„œ μž‘μ—…μ„ 빨리 μ§„ν–‰ν•˜λ €λ‹€ λ³΄λ‹ˆ 주석을 많이 λͺ» λ‹¬μ•˜λ˜ 것 κ°™λ‹€.
- μ΄ˆλ°˜μ— λΉ λ₯΄κ²Œ μž‘μ—…ν•˜λ‹€ λ³΄λ‹ˆ 폴더 ꡬ쑰와 주석 μ²˜λ¦¬κ°€ κΉ”λ”ν•˜μ§€ λͺ»ν•œ 면이 μžˆμ—ˆλ‹€.
- ν…ŒμŠ€νŠΈ 과정이 λ―Έν‘ν•˜μ§€ μ•Šμ•˜λ‚˜ ν•˜λŠ” 생각이 λ“ λ‹€.

Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
</details>

0 comments on commit 955c445

Please sign in to comment.