![Baenang](https://github.com/user-attachments/assets/0e6a3178-e20a-4019-a74a-52c398433e1b)
# ๐ โ๏ธ ๋ฐฐ๋ญ ๐ผ๐
์ฌํ์๋ฅผ ์ํ ์ ์์ง๊ฐ ์ดํ๋ฆฌ์ผ์ด์
, `BAENANG`
## ๐ Tech Stack ๐
![React Native](https://img.shields.io/badge/React%20Native-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)
![Spring Framework](https://img.shields.io/badge/Spring-6DB33F?style=for-the-badge&logo=spring&logoColor=white)
![MySQL](https://img.shields.io/badge/MySQL-4479A1?style=for-the-badge&logo=mysql&logoColor=white)
![AWS](https://img.shields.io/badge/AWS-232F3E?style=for-the-badge&logo=amazon-aws&logoColor=white)
![Expo](https://img.shields.io/badge/Expo-000020?style=for-the-badge&logo=expo&logoColor=white)
![Gradle](https://img.shields.io/badge/Gradle-02303A?style=for-the-badge&logo=gradle&logoColor=white)
![Redux](https://img.shields.io/badge/Redux-764ABC?style=for-the-badge&logo=redux&logoColor=white)
![Spring JPA](https://img.shields.io/badge/Spring%20JPA-6DB33F?style=for-the-badge&logo=spring&logoColor=white)
![Spring Security](https://img.shields.io/badge/Spring%20Security-6DB33F?style=for-the-badge&logo=spring&logoColor=white)
## ๐ฅ ํ์ ์๊ฐ
|
|
|
|
|
|
|
| :---: | :---: | :---: | :---: | :---: | :---: |
| [์ด์ ์](https://github.com/Hello-LSY) | [๊น๋์ค](https://github.com/kimdj4e) | [๊น์ฐ๋น](https://github.com/MyYeonbi) | [๊น์ฐ์ ](https://github.com/pq5910) | [์ดํ์
](https://github.com/dlxodnd007) | [์ฅํ๊ถ](https://github.com/gwonnnns) |
| PM, DevOps, BE main, FE sub, Docs sub | FE main, UI main| Docs main, BE sub | FE main, UI main, BE sub | FE main, BE main | FE sub, BE sub |
๐ ํ๋ก์ ํธ ๊ฐ์
์ฌํ์๋ฅผ ์ํ ์ ์์ง๊ฐ ์ดํ๋ฆฌ์ผ์ด์
์ธ BAENANG ์
๋๋ค. ๋ณธ ํ๋ก์ ํธ์์๋ ํด์ธ์ฌํ์ ๊ฐ ๋ ์๊ฐ๋ณด๋ค ๋ค์ํ ์๋ฅ๋ค์ ์๊ตฌํ๋ค๋ ์ ๊ณผ ์ข
์ด์๋ฅ์ ๋ํ ๋ฌธ์ ๋ฅผ ์ ์๋ฌธ์์ง๊ฐ๊ธฐ๋ฅ์ผ๋ก ๊ฐ์ ํจ๊ณผ ๋์์ ์ฌํ๊ณผ ๊ด๋ จํ ๋ค์ํ ํธ์๊ธฐ๋ฅ๋ค(์์น๊ธฐ๋ฐ ์ปค๋ฎค๋ํฐ, ์ฌํ์ ๋ช
ํจ, ์ฌํ ์ธ์ฆ์, ์ค์๊ฐ ํ์จ)์ ๋ง๋ จํ์ฌ ์ฌํ์์ ๋ค์ํ ํธ์์ฑ์ ์ ๊ณตํ์์ต๋๋ค.
์ฃผ์ ํน์ง:
- ์ ์๋ฌธ์์ ์์ ํ ์ ์ฅ ๋ฐ ๊ด๋ฆฌ
- ์ฌ์ฉ์ ์นํ์ ์ธ UI
- ๋น ๋ฅด๊ณ ์์ ํ ์ธ์ฆ ๋ฐ ๋ณด์ ์ฒ๋ฆฌ
- ํ์ฅ ๊ฐ๋ฅํ ์ํคํ
์ฒ
๐ฏ ์ฃผ์ ๊ธฐ๋ฅ
1. ํ์๊ฐ์
/๋ก๊ทธ์ธ
- ํ์๊ฐ์
1) id, ์ด๋ฉ์ผ, ๋๋ค์ ์ค๋ณต์ฒดํฌ ๋ก์ง ํฌํจ
- ๋ก๊ทธ์ธ
1) spring security๋ก ๋ก๊ทธ์ธ ์ธ์ฆ์ธ๊ฐ ๊ตฌํ
2) jwt ํ ํฐ๊ธฐ๋ฐ ์ธ์ฆ
2. ์ฌํ ์ ์๋ฌธ์
- ์ธ์ฆ ๊ณผ์ ๊ณผ ์ ๋ณด ์์ฒญ
1) ํํ ์ ์๋ฌธ์๋ ๋๋ถ๋ถ ๋ธ๋ก์ฒด์ธ ๊ธฐ๋ฐ์ผ๋ก ์ ๋ขฐ์ ๋ณด์์ ๋ํด ๋ณด์ฅ์ ๋ฐ์ ์ํ. ์ด๋ฅผ ์ ์ฌํ๊ฒ ๊ตฌํํ๊ธฐ์ํด ๊ธฐ๊ด์ ๊ฐ์์ผ๋ก ์ค์ ํ๋ค๋ ์๋๋ฆฌ์ค๋ก, private servnet์ RDS(๊ฐ์๊ธฐ๊ด)๋ฅผ ๋๊ณ ec2์์ tcp ํต์ ์ผ๋ก ๋ณด์์ ๋์ฒดํจ.
2) ์ด๋ฆ, ์ด๋ฉ์ผ, ์ฃผ๋ฏผ๋ฑ๋ก๋ฒํธ๋ก ์ธ์ฆ ๊ณผ์ ์ ๊ฑฐ์น๋ฉฐ, ๋ฉ์ผ๋ก ๋ฐ์ ์ธ์ฆ ์ฝ๋๋ฅผ ์
๋ ฅํ์ฌ ์ ๋ถ24์ ๊ฐ์ ์ธ์ฆ๊ธฐ๊ด์ผ๋ก ์ ๋ณด๋ฅผ ์์ฒญํ์ฌ ๊ฐ์ธ ์ ๋ณด ๋ฐ์ดํฐ๋ฅผ ๋ฐ์์ด
3) ํ ๋ฒ์ ์ธ์ฆ์ผ๋ก ์ผ์ ์๊ฐ ์ธ์ฆ์ด ์ ์ง๋๊ณ ํด๋น ์๊ฐ ๋ด์๋ ๋ค๋ฅธ ๋ฌธ์์๋ ์ ๊ทผ์ด ๊ฐ๋ฅํจ
4) ์นด๋ฉ๋ผ ์ธ์ฆ ๊ถํ ํธ๋ค๋ฌ ๊ตฌํ
3. ์ฌํ์ ๋ช
ํจ
- ์ฌํ์ ๋ช
ํจ ์์ฑ ๋ฐ ์์
1) ์ด๋ฆ, ํ๋กํ ์ฌ์ง, ๊ตญ์ , SNS์์ด๋, ์๊ธฐ์๊ฐ ๋ฐ์ดํฐ๋ฅผ ๋ฐ์ ํ๋์ ๊ณ์ ๋น ํ๋์ ์ฌํ์ ๋ช
ํจ ์์ฑ.
2) ๋ช
ํจ ์์ฑ ์ ๊ณ ์ PIN๋ฒํธ์ QR ์์ฑ
- ์ฌํ์ ๋ช
ํจ ๊ตํ
1) PIN๋ฒํธ๋ฅผ ์ง์ ์
๋ ฅํ๊ฑฐ๋ QR์ฝ๋๋ฅผ ์ธ์ํ์ฌ ๋ด ๋ช
ํจ ๋ฆฌ์คํธ์ ์๋๋ฐฉ์ ๋ช
ํจ ๋ฑ๋ก
2) ์นด๋ฉ๋ผ ๊ถํ์ ๋ํ ํธ๋ค๋ฌ ๊ตฌํ
4. ์ฌํ์ ์ปค๋ฎค๋ํฐ
- ์ฌ์ฉ์ ์์น ๊ธฐ๋ฐ ๊ฒ์๊ธ ์กฐํ
1) ์ฌ์ฉ์์ ์์น๋ฅผ ์ค์ฌ์ผ๋ก ๋๋ค(5km ์ด๋ด), ๋์(50km ์ด๋ด), ๊ตญ๊ฐ(500km ์ด๋ด), ์ธ๊ณ(20,000km ์ด๋ด)๋ก ๋๋์ด ๊ฒ์๊ธ ์กฐํ ๊ฐ๋ฅ
2) ํ๋ฒ์ฌ์ธ ๊ณต์์ ํ์ฉํ๊ณ JQPL์ ํตํด ๊ฒ์๊ธ์กฐํ ์ฟผ๋ฆฌ์ต์ ํ ์งํ
- ์ข์์, ๋๊ธ ๊ธฐ๋ฅ
1) ์ฌ์ฉ์๋ 1๊ฐ์ ๊ฒ์๋ฌผ์ 1๊ฐ์ ์ข์์๋ง ๊ฐ๋ฅํ๋ฉฐ, ์ฌ๋ฌ ๊ฐ์ ๋๊ธ์ ์์ฑํ ์ ์์.
- ๊ฒ์๊ธ CRUD
1) ์ด๋ฏธ์ง ์
๋ก๋ ๊ธฐ๋ฅ
2) ์ฌ์ฉ์ GPS ๊ธฐ๋ฐ์ผ๋ก ์๋์ ๊ฒฝ๋ ์ ์ฅ
3) GPS ์ ๊ทผ ๊ถํ์ ๋ํ ํธ๋ค๋ฌ ๊ตฌํ
5. ์ฌํ ์ธ์ฆ์
- GPS๋ฅผ ์ด์ฉํด ์ฌ์ฉ์์ ์์น ์ธ์
1) GPS ๊ธฐ๋ฐ์ผ๋ก ํ์ฌ ์ฌ์ฉ์์ ์์น๋ฅผ ์ธ์ํ์ฌ ์๋์ผ๋ก ์ฌํ์ง๋ฅผ ์
๋ ฅ.
2) GPS๋ฅผ ํตํ ์ฌํ์ง 1์ฐจ ์ธ์ฆ
3) GPS ๊ถํ ํธ๋ค๋ฌ ๊ตฌํ
- ์นด๋ฉ๋ผ๋ฅผ ํตํ ์ฌํ ์ฌ์ง ์ธ์ฆ
1) ์ฌ์ง ์
๋ก๋๊ฐ ์๋ ์นด๋ฉ๋ผ๋ฅผ ์ด์ฉํ ์ค์๊ฐ ์ดฌ์์ ํตํด ๊ตฌํํ์ฌ ์ฌํ์ง์ ๋ํ 2์ฐจ ์ธ์ฆ์ ์งํ
6. ์ค์๊ฐ ํ์จ
- ํ์จ ์กฐํ
1) ํ ํ๋ฉด์ ํตํด์ ๊ฐ ๊ตญ๊ฐ์ ํ์จ์ ๋น ๋ฅด๊ฒ ์กฐํํ ์ ์์
2) ์ฃผ์ ๊ตญ๊ฐ ํ์จ์ ์๋จ์ ๋ฐฐ์นํ์ฌ ์์ฒญ์ด ๋ง์ ๊ตญ๊ฐ์ ํ์จ ์ ๋ณด๋ฅผ ๋น ๋ฅด๊ฒ ์กฐํ
3) ์ ์ฒด ๊ตญ๊ฐ ํ์จ ๋ฆฌ์คํธ๋ฅผ ํตํด ์ฌ๋ฌ ๊ตญ๊ฐ์ ํ์จ ์กฐํ
- ํ์จ ๊ณ์ฐ๊ธฐ
1) ํ์จ ๊ณ์ฐ๊ธฐ๋ฅผ ์ด์ฉํด ์ฌ์ฉ์๊ฐ ์ธํ๋ฅผ ํ๊ตญ ํํ๋ก ๋น ๋ฅด๊ฒ ๊ณ์ฐํ ์ ์๊ฒ ๋์. ์ค์๊ฐ ํ์จ๊ฐ์ ๊ธฐ์ค์ผ๋ก ํจ.
- ํ์จ ์์น/ํ๋ฝ ๊ทธ๋ํ
1) ์ผ๋ณ, ์ฃผ๋ณ, ์๋ณ ํ์จ ๊ทธ๋ํ๋ฅผ ๊ทธ๋ ค ํ์จ์ ์์น๊ณผ ํ๋ฝ์ ํ ๋์ ์ดํ ์ ์์
7. ์ฌํ ์ฑํฅ ํ
์คํธ
- ์ฌํ ์ฑํฅ ๋ถ์
1) ๊ฐ ๋ฌธํญ์ ๋ํ ์ฌ์ฉ์์ ๋ต๋ณ์ ๋ฏผ๊ฐ, ์ฆํฅ, ๋ฏธ๋์ด, ๋์ , ์๋น, ์ ์ ์ด 6๊ฐ์ ์์น๋ก ๋๋์ด ๊ณ์ฐํ์ฌ ์ฌ์ฉ์ ์ฌํ ์ฑํฅ ๋ถ์
2) ์ฑํฅ ๊ฒฐ๊ณผ ํ์ด์ง์์ ์ฑํฅ๋ณ ์บ๋ฆญํฐ์ ์ต์ข
์์น ํ์ธ
8. ์ฌํ ๊ด๋ จ ์ธ๋ถ ์ดํ ์ฐ๋
- ์๋ฐ, ๋ณดํ, ๊ตํต์๋จ ์ธ๋ถ ์๋น์ค ์ง์
1) KB์ฐจ์ฐจ์ฐจ, KB์ํด๋ณดํ, ์์ด๋น์๋น, ํฐ๋จธ๋๊ณ , ๋ถํน๋ท์ปด, ์๊ณ ๋ค์ ์น ์๋น์ค์ ์ฐ๋
9. ํ๋กํ ๊ด๋ฆฌ
- ๋น๋ฐ๋ฒํธ๋ฅผ ํตํ ์ธ์ฆ
1) ๋น๋ฐ๋ฒํธ ์ธ์ฆ์ ํตํ ๋ณด์ ๊ฐํ
- ํ๋กํ, ์ธ์ด, ํ
๋ง ์ค์
1) 10MB ์ดํ์ ์ด๋ฏธ์ง๋ก ํ๋กํ ๋ณ๊ฒฝ ๊ฐ๋ฅ
2) ์ธ์ด ๋ณ๊ฒฝ์ ํตํ ๋ค๊ตญ์ด ์ง์
3) ๋ผ์ดํธ/๋คํฌ ๋ชจ๋ ์ง์
10. ๊ธฐํ ์๋น์ค
- ๊ณ ๊ฐ์ผํฐ, ์์ฃผ ๋ฌป๋ ์ง๋ฌธ, ๊ณต์ง์ฌํญ, ์ฌ์ฉ ๊ฐ์ด๋
๐ ๊ธฐ์ ์คํ ์์ธ
- ํ๋ก ํธ์๋: React Native (๋ชจ๋ฐ์ผ ์ ํ๋ฆฌ์ผ์ด์
๊ฐ๋ฐ)
- ๋ฐฑ์๋: Spring Framework (Spring ๋ ๊ฑฐ์ ๊ธฐ๋ฐ RESTful API)
- ๋ฐ์ดํฐ๋ฒ ์ด์ค: MySQL(RDS)
- ๋น๋ ๋๊ตฌ: Gradle, Expo
- ์น ์๋ฒ: AWS EC2, RDS, S3
๐ ์ค์น ๋ฐ ์คํ ๋ฐฉ๋ฒ
-
Clone Repository
git clone https://github.com/Hello-LSY/Baenang.git
-
Install Dependencies
cd Baenang
# Front-end dependencies
cd react-native-app
npm install
-
Run the Application
Windows OS
# Front-end
cd ../react-native-app
npm start
Unix/Linux
# Front-end
cd ../react-native-app
npm start