🌟 『소행성』 – 소소한 행복이 모여 반짝이는 작은 별

나만의 작은 순간들을 기록하고,
서로의 일상 속 따뜻한 감정을 함께 나누는 커뮤니티 플랫폼

---

🌼 프로젝트 소개

『소행성』은 하늘 사진, 위시리스트, 음악 공유, 짧은 한줄 기록 등
일상 속 소소한 행복을 주제별로 나누고, 공감하고, 소통할 수 있는 감성 기반 커뮤니티 게시판입니다.
부담 없이 한두 줄로도 작성할 수 있어 누구나 쉽게 참여할 수 있으며,
카테고리별로 다양한 기록이 정돈되어 공유됩니다.

“모두의 작은 기록이 모여 반짝이는 별이 됩니다.”

---

⛳ 프로젝트 진행 배경

『소행성』은 백엔드 개발 실무 역량 강화를 목표로 진행된 6개월간의 스터디 과정에서 출발한 프로젝트입니다.
기초적인 CRUD 실습부터 시작해 보안, 배포, 자동화까지의 실무 중심 백엔드 로드맵을 따라
각자 자율적인 주제를 정해 프로젝트를 완성해가는 방식으로 설계되었습니다.

---

📅 향후 목표 (스터디 공통 로드맵)

단계	목표
✅ 1단계	REST API 개발 & 기본 CRUD 구현 완료
✅ 2단계	JPA, QueryDSL 기반 성능 최적화
🔄 3단계	AWS EC2, RDS, S3를 활용한 배포 환경 구성
🔜 4단계	Nginx 적용 및 정적 리소스 최적화
🔜 5단계	Docker를 통한 컨테이너 환경 구성
🔜 6단계	GitHub Actions 기반 CI/CD 자동화 구성

최종적으로는 실무 수준의 백엔드 프로젝트를 완성하는 것이 목표이며,
각 단계별로 코드 작성 → 테스트 → 문서화 → 배포까지 진행 예정입니다.

---

✨ 주요 기능

• 📌 카테고리 기반 게시글 작성
  ☁️ 오늘의 하늘 / 🍰 나만의 위시 / 🎵 오늘의 플레이리스트 / 📖 한줄 기록

• 🖼️ 이미지 업로드 (S3 연동)
  하늘 게시판에 사진 첨부 가능

• 🔗 유튜브 링크 공유
  음악 게시판에서 유튜브 링크로 감상 공유

• ✅ 위시리스트 달성 체크 기능
  목표를 설정하고, 달성 여부를 기록할 수 있음

• 💬 댓글 & 좋아요(공감)
  공감 기반 상호작용 지원

• 🏷️ 태그 등록 및 검색 기능
  맑음, 산책, 여유 등 감정 태그 기반 검색 지원

• 👤 마이페이지 기능
  내가 작성한 글, 좋아요한 글, 달성한 위시리스트 열람

---

🔧 기술 스택

📙 언어 & 프레임워크

• Java 17 – 안정적인 LTS 버전 (현재 사용 중)
• Spring Boot 3.4.x – 생산성과 구조화에 최적화
• Spring Data JPA – 객체 중심의 DB 연동
• QueryDSL – 타입 안전한 쿼리 작성

🛡️ 보안

• Spring Security – API 접근 제어
• JWT (JJWT 0.11.5) – 토큰 기반 인증 처리
• BCryptPasswordEncoder – 비밀번호 해싱

🗄️ 데이터베이스 & 스토리지

• MariaDB / MySQL – 관계형 데이터베이스
• AWS S3 – 게시글 이미지 업로드

✅ 유효성 검사 & 테스트

• Jakarta Validation – 입력값 유효성 검증
• JUnit, Mockito – 단위 및 목 테스트 구성
• H2 DB – 테스트용 인메모리 데이터베이스

⚙️ 개발 도구 & 기타

• IntelliJ IDEA – 통합 개발 환경
• Gradle – 빌드 자동화
• Lombok – 반복 코드 제거
• dotenv-java – 환경변수 설정 관리

🧭 도입 예정 기술

• AWS EC2 / RDS – 서비스 배포 및 데이터 저장소 구성
• Nginx – 정적 리소스 캐싱 및 리버스 프록시 설정
• Docker & Docker Compose – 컨테이너 기반 환경 구성
• GitHub Actions or Jenkins – CI/CD 자동 배포 구축

---

🗂️ 주요 도메인 구조 (설계 중)

Entity	설명
User	사용자 정보 (이메일, 나이, 성별, 주소 등)
Post	게시글 (제목, 내용, 카테고리, 이미지, 링크, 좋아요 등)
Category	게시글 주제 분류 (Enum 또는 테이블)
Comment	게시글에 대한 사용자 댓글
Tag	감정/상황 태그 (예: 맑음, 맛집, 설렘 등)
PostTag	Post ↔ Tag 관계 매핑 테이블

---

🧠 나의 역할

• 전체 기능 기획 및 시스템 설계
• RESTful API 설계 및 구현
• Spring Security 기반 로그인 & 회원 인증 처리
• 게시글 CRUD + 카테고리별 기능 구현
• AWS S3 연동 및 이미지 업로드 처리
• 좋아요, 댓글, 마이페이지 기능 구현
• Swagger 적용 및 예외 처리 구조 설계

---

🌈 향후 고도화 계획

• 🎯 인기글 랭킹 (좋아요 순 정렬)
• 🎨 감정 태그 기반 통계 시각화
• 🗓️ 달력 기반 기록 확인 기능 (MyDay)
• 📱 반응형 웹 UI (모바일 대응)
• 🌐 외부 음악 플랫폼 자동 임베딩 (유튜브, 스포티파이 등)

---

📝 프로젝트 회고 & 개발 일지

프로젝트를 마무리한 후, 직접 회고를 작성할 예정입니다.
지금은 기능 구현에 집중하고 있어요! 😌

📌 개발 일지 및 회고 Notion 보기

---