🌱 Green Map

내 주변 친환경 시설을 한눈에 🌍

위치 기반으로 친환경 시설을 찾고,
활동 인증을 통해 포인트를 적립하며 환경을 지켜요

🔗 서비스 바로가기
👉 Green Map

---

📌 프로젝트 개요 (Project Overview)

항목	내용
프로젝트명	Green Map
프로젝트 기간	2025.10.23 ~ 2025.11.12
배포 기간	2025.11.01 ~
목적	친환경 시설 정보 제공 및 환경 보호 활동 장려

---

👥 팀원 소개 (Team Members)

김승한	류예나	정재민	이정호
BE	BE	BE	FE
GitHub	GitHub	GitHub	GitHub

---

✨ 주요 기능 (Key Features)

👤 회원 & 마이페이지

• 소셜 로그인 (Kakao OAuth)
• 회원 정보 조회 / 수정 / 탈퇴
• 활동 기록 조회
• 북마크 등록 / 삭제

📰 뉴스

• 환경 관련 뉴스 제공
• 뉴스 목록 조회

🗺️ 친환경 시설 지도

• 현재 위치 기반 시설 조회
• 장소 검색 및 필터링
• 전기차 / 수소차 충전소
• 따릉이 스테이션
• 재활용 센터
• 제로웨이스트 매장
• 친환경 시설 데이터베이스 구축

✅ 인증 & 챌린지

• 친환경 활동 인증
  • 따릉이 이용
  • 전기차 / 수소차 이용
  • 제로웨이스트 사용
• 환경 챌린지 참여
• 이벤트 인증 내역 조회

🏆 포인트 & 뱃지

• 활동 기반 포인트 적립 / 사용
• 포인트 내역 조회
• 랭킹 시스템
• 성취 기반 뱃지 보상
• 뱃지 조회 및 대표 뱃지 설정

---

🗂 ERD

---

🏗 아키텍처 (Architecture)

---

📑 API 명세서

API 명세서는 Notion에서 관리 중입니다.

---

🧑‍💻 역할 분담 (Tasks & Responsibilities)

이름	프로필	담당 역할
김승한		조장 활동 인증 뉴스 조회
류예나		소셜 로그인 마이페이지 챌린지
정재민		포인트 장소 관리
이정호		배포

---

🛠 기술 스택 (Technology Stack)

Language

기술	아이콘	버전
Java		17.0.11

Backend

기술	아이콘	버전	기술	아이콘
Spring		3.3.5	JWT
MySQL		8.4.3	Oauth2
Google Cloud			Docker

Collaboration

도구	사용 목적
	소스 코드 관리, PR 기반 협업
	API 명세, 일정 관리, 회의 기록, 피드백

---

📁 프로젝트 구조 (Project Structure)

greenmap/
├── src/main/java/com/ucamp/greenmap/
│   ├── badge/          # 뱃지 시스템
│   ├── challenge/      # 챌린지 기능
│   ├── member/         # 회원 관리
│   ├── news/           # 뉴스 피드
│   ├── place/          # 장소 정보
│   ├── point/          # 포인트 시스템
│   ├── Kakao/          # 카카오 OAuth
│   └── ...
└── src/main/resources/
    ├── application.properties
    └── application-prod.properties

🔄 개발 워크플로우 (Development Workflow)

GitHub Ruleset

• PR 시 1명 이상 승인 필수
• develop 브랜치 직접 커밋 금지

브랜치 전략

• 소문자 + 하이픈(-) 사용
• 필요 시 이슈 번호 포함

Branch Type

• feat/ : 기능 개발
• fix/ : 버그 수정
• refactor/ : 리팩토링

Example

• feat/add-social-login

🚀 실행 방법

로컬 실행

cd greenmap
./gradlew bootRun

🐳 Docker 실행

cd greenmap
docker build -t greenmap-app .
docker run -p 8080:8080 greenmap-app

📝 환경 변수

필수 환경 변수:

• DB_URL: 데이터베이스 연결 URL
• DB_USERNAME: 데이터베이스 사용자명
• DB_PASSWORD: 데이터베이스 비밀번호
• JWT_SECRET_KEY: JWT 서명 키
• KAKAO_CLIENT_ID: 카카오 REST API 키
• 기타 API 키들

📄 License

Copyright (c) 2025 UCamp Greenmap Team