HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
🐣
프론트엔드 데브코스 4기 교육생
/
황준일팀
황준일팀
/
🏠
혼콕 HONKOK
🏠

혼콕 HONKOK

목차
🏠혼콕 (HONKOK) 이란?1. 서비스 소개1-1. 주제1-2. 선정 이유2. 서비스 주요 타겟층3. 브레인 스토밍4. User Story5. 와이어 프레임 & UI6. 기술 스택7. 👨🏻‍💻 개발 문화팀 그라운드 규칙팀 목표팀 협업 방식8. 프로젝트 상세 일정9. 바로가기🗂️Github WikiFigmaChromatic✏️회고

🏠혼콕 (HONKOK) 이란?

"혼콕"은 "혼자 콕 찌르기"를 줄여서 부르는 소통 공간입니다. 여기서 "혼자"는 혼자 사는 사람들을 나타내고, "콕 찌르기"는 콕 찔러서 사용자들 끼리 소중한 인연을 만들어가고 정보를 공유하는 활동을 나타냅니다. "혼콕" 서비스는 요리, 청소, 도와주세요, 이거 사세요 등 다양한 채널들을 제공 합니다. 각 채널 내에서 채널 주제에 관련된 정보를 공유하며 서로 도움을 주고 받을 수 있습니다.
저희 서비스의 목표는 혼자 사는 사람들에게 유용한 정보와 아늑한 커뮤니티를 제공하여 일상을 더 풍요롭고 함께하는 기분을 느끼게 하는 것 입니다.
 

1. 서비스 소개

1-1. 주제

👤
전국의 자취러들을 위한 1인 가구 특화 SNS 서비스
 

1-2. 선정 이유

2023년 통계에 따르면 대한민국 약 5000만 명 인구 중 1인 가구의 수는 1/5인 1000만 명이다.
 
해가 갈수록 1인 가구의 비중이 늘고 있다.
 
🤔 1인 가구일 때 발생하는 문제점
  • 요리, 청소 등 집안일을 해야하는데 방법을 모르는 경우가 많다.
  • 1인 가구를 위한 물품들에 대한 정보가 부족하다.
  • 혼자 생활하다보니 외로움을 느낄 수 있다.
👌🏻
혼콕 서비스는 1인 가구를 위한 소셜 네트워크 서비스를 제공하여, 이러한 문제들을 해결할 수 있는 편리하고 따뜻한 소통 공간과 정보를 제공합니다.
 

2. 서비스 주요 타겟층

대한민국의 자취러들과 예비 자취러들
대한민국의 자취러들과 예비 자취러들
  • 초보 대학생 자취생
  • 1인 요리 레시피에 관심 있는 자취생
  • 청소 꿀팁을 찾고 싶은 자취생
  • 어려운 집 수리를 도움 받고 싶은 자취생
  • 자취 관련 서비스 및 제품 공급업체
 

3. 브레인 스토밍

4. User Story

User Story
페이지
유저스토리
특이사항
우선순위
작업 여부
회원가입
혼콕에 접속한 유저는 이메일, 닉네임, 비밀번호를 입력하여 회원가입을 할 수 있다.
- 입력된 값 검증(이메일 형식, 비밀번호 형식, 닉네임형식)
1
작업 완료!
로그인
회원가입을 완료한 유저는 이메일, 비밀번호를 입력하여 로그인을 할 수 있다.
- 입력된 값 검증(이메일 형식, 비밀번호 형식)이 잘못 되었을 경우 통합된 결과로 알려준다. ex) 이메일과 비밀번호를 확인해주세요
1
작업 완료!
검색 결과
유저는 모든 채널의 포스트와 가입자를 검색할 수 있다.
- 검색 결과는 포스트와 가입자가 모두 검색되며 클릭 시 포스트 상세 페이지나 프로필 페이지로 이동할 수 있다.
2
작업 완료!
포스트 리스트
유저는 채널에 올라온 포스트를 볼 수 있다.
1
작업 완료!
포스트 리스트
포스트 상세
유저는 포스트 작성자의 프로필 사진을 클릭하여 작성자의 프로필 페이지로 이동할 수 있다.
2
작업 완료!
프로필
유저는 가입한 다른 유저의 프로필 정보와 작성한 글을 볼 수 있다.
1
작업 완료!
프로필
로그인한 유저는 자신이 팔로우한 사용자 리스트를 볼 수 있다.
2
작업 완료!
프로필
로그인한 유저는 자신을 팔로잉한 사용자 리스트를 볼 수 있다.
작업 완료!
프로필
로그인한 유저는 자신의 프로필에서 팔로워, 팔로우한 사용자 중 접속 중인 사용자를 볼 수 있다.
- 프로필 사진에 링 형식으로 접속 중인 사용자 표현
2
작업 완료!
프로필
로그인한 유저는 자신의 프로필에서 자신의 정보를 변경할 수 있다.
1
작업 완료!
프로필
로그인한 유저는 자신의 프로필에서 좋아요 누른 포스트를 볼 수 있다.
1
작업 완료!
프로필
로그인한 유저는 자신이 작성한 포스트를 볼 수 있다.
1
작업 완료!
포스트 작성
로그인한 유저는 채널에 제목과 내용을 입력하여 포스트를 남길 수 있다.
- 포스트에 이미지를 첨부 할 수 있다.
1
작업 완료!
포스트 상세
로그인한 유저는 좋아요 버튼을 클릭하여 포스트를 좋아요 할 수 있다.
- 이미 좋아요 한 상태라면 좋아요가 취소된다.
1
작업 완료!
포스트 상세
로그인한 유저는 포스트 하단에 댓글을 남길 수 있다.
1
작업 완료!
포스트 상세
로그인한 유저는 자신이 작성한 댓글을 삭제할 수 있다.
1
작업 완료!
포스트 상세
유저는 댓글 작성자의 프로필 사진을 클릭하여 작성자의 프로필 페이지로 이동할 수 있다.
1
작업 완료!
포스트 상세
로그인한 유저는 본인이 작성한 포스트를 포스트 상세 페이지에서 삭제, 수정 할 수 있다.
- 경로1 내 프로필 페이지 - 경로2 게시글 목록 페이지
1
작업 완료!
알림
로그인한 유저는 자신의 알림 목록을 확인할 수 있다.
- 하나의 알림 항목을 클릭해 해당 항목을 읽음 처리할 수 있다. - 전체 읽음 버튼을 클릭해 모두 읽음 처리를 할 수 있다.
3
작업 완료!
DM
로그인한 유저는 다른 가입자에게 메시지를 보낼 수 있다.
3
작업 완료!
DM
로그인한 유저는 자신에게 온 메시지 목록을 확인할 수 있다.
3
작업 완료!
DM
로그인한 유저는 특정 유저와의 메시지 대화 내역을 확인할 수 있다.
3
작업 완료!
404
유저는 잘못된 접근을 했을 때 404 페이지로 접속할 수 있다.
2
작업 완료!
메인
유저는 다크 모드를 설정 할 수 있다.
3
작업 중...
메인
로그인한 유저는 상단 오른쪽의 알림 배지를 통해 알림 수를 확인할 수 있다.
- 알림 배지를 클릭 시 알림 페이지로 이동한다.
2
작업 완료!
 
 

5. 와이어 프레임 & UI

6. 기술 스택

  • Vite
  • Typescript + React
  • Eslint / Prettier
  • Tailwindcss
  • Storybook
  • React Query + Axios
  • React Router
  • dayjs
    • notion image
 

7. 👨🏻‍💻 개발 문화

Home
Contribute to prgrms-fe-devcourse/FEDC4_HONKOK_JunilHwang development by creating an account on GitHub.
Home
https://github.com/prgrms-fe-devcourse/FEDC4_HONKOK_JunilHwang/wiki
Home

팀 그라운드 규칙

주체성을 가지고 움직이기

  • 회의는 모두가 돌아가면서 진행해요. 🧐

느긋하고 느슨한 것을 지양하기

  • 2일 이내 작업과 스프린트 기반으로 일정과 목표를 선정해요. 🏃

다른 사람의 의견에는 최소한의 반응하기

  • 침묵보다는 작은 리액션 및 간단한 이모지라도 남겨요. 🙂
  • 이야기가 끝날 때 박수로 마무리해요. 👏

특이 사항은 즉각적으로 공유하기

  • 일정이 늦어질 것 같으면 바로 이야기해요. 😆

팀 목표

팀 목표

🔥
한 명이 작업한 것처럼 프로젝트를 완성하자!

개인 목표

김효리

  • React Query는 왜 사용하는지, 사용 방법은 무엇인지를 잘 이해하자.
  • React에 대한 전반적인 동작원리를 이해하자.

우지호

  • tailwind에 익숙해지기
  • Storybook에 익숙해지기
  • React Query 사용 익숙해지기
  • 취약한 부분 알아내기

이종길

  • Storybook을 활용한 컴포넌트 개발에 익숙해지자.
  • React Query을 깊게 학습하고 능숙하게 사용하자.

정진경

  • 비동기 작업과 axios에 대한 이해를 바탕으로 React Query를 이용해서 데이터를 CRUD 하는 코드를 깔끔하게 짜고 싶습니다.
  • 컴포넌트를 깔끔하게 만들어 보고 싶습니다.
  • 유효성 검사?를 철저하게 하고 싶습니다.
  • 꼼꼼하게 코드짜는 습관을 기르고 싶습니다.

홍건우

  • react에서 사용하는 typescript type 마스터하기!!
  • 보너스 구현까지 모두 완성해보기!!

팀 협업 방식

작업 진행 순서

  1. issue에서 작업을 등록한다.  ex. 회원가입 로직 작업
  1. issue에서 태그를 등록한다. (작업자, project 등...)
  1. issue 작업자가 branch를 생성한다. ex. feat/회원가입-로직-작업

브랜칭 전략

notion image
  • github flow 전략을 응용하여 develop branch를 추가해 사용한다.
    • main - develop - 작업 브랜치

merge 방식

  • main ← develop : create a merge commit
  • develop ← other branch : rebase and merge
 
✔️ 브랜치 생성, merge, 브랜치 삭제는 본인이 직접한다!
 
ex. - 회원가입 로직 관련 기능 개발 - 브랜치: `feat/회원가입-로직-기능` - 커밋: `feat` `fix` `refactor` 등 다양하게 커밋 - `feat: 회원가입 컴포넌트 구현` - squash and merge - 브랜치 삭제 - 프로필 에러 관련 수정 - 브랜치: `fix/사용자-프로필-에러-수정` - 커밋: `fix` - squash and merge - 브랜치 삭제
 
✔️ 1차, 2차 스프린트 마지막날에 develop에서 main 으로 머지한다.
 

merge 컨벤션

  • merge 제목에는 컨벤션 태그를 사용한다.
예시
  • ✅ feat: 유저 정보 관련 작업
  • ❎ 유저 정보 관련 작업
 

커밋 컨벤션

  • 모든 커밋 내용은 한글로 작성한다. (영어 파일명을 포함시키는 것은 괜찮음)
  • 모든 커밋은 한 줄, 명령조로 작성한다.
ex. feat: 로그인 기능 추가
태그 이름
설명
feat
새로운 기능을 추가할 경우
fix
버그를 고친 경우
refactor
리팩토링한 경우(리팩토링 과정에서 파일 삭제, 이동 포함)
style
CSS 등 사용자 UI 디자인 변경
docs
문서를 수정한 경우
chore
이 외의 작업들

네이밍 규칙

props 네이밍

  • props 타입 별칭: 컴포넌트명 + Props로 통일한다.
  • 함수 작성 방식: 함수 표현식을 사용한다.
  • export default는 코드 마지막 줄에 추가한다.
예시
interface TempProps { ... } const Temp = ({ name }: TempProps) => { ... } export default Temp

배열 데이터 네이밍

  • 배열은 List를 붙인다.
  • 아이템은 Item을 붙인다.
  • api일 경우에는 List가 아닌 s를 붙인다.
예시
  • 파일명: PostList, PostItem
  • api: posts/{postId}

타입 네이밍

타입 관련 이름은 파스칼케이스로 통일한다.
예시
type Temp = number

import, export 규칙

  • 같은 폴더에 있는 파일은 상대 경로(./*)를 사용한다.
  • 다른 폴더에 있는 파일은 절대 경로(~/*)를 사용한다.

스타일 관련 규칙

  • css 크기 단위는 rem으로 통일한다.

폴더 관련 규칙

  • index파일은 import/export 용도로 사용한다.

타입 규칙

children은 React.ReactNode로 통일한다.

기타

함수는 화살표 함수로 통일한다.
이벤트 관련 이름은 handle+동사(+명사)로 통일한다.
예시
  • ✅ handleClick
  • ❎ handleOnClick

PR 규칙

  • 최소 1명의 승인을 받아야 한다.
  • PR 제목에는 컨벤션 태그 붙이지 않는다. (레이블과 리뷰에 지정한다.)

이슈 컨벤션

  • 이슈 제목에는 컨벤션 태그를 붙이지 않는다.
예시
  • ✅ 유저 정보 관련 작업
  • ❎ feat: 유저 정보 관련 작업
 

Github 템플릿

  • Issue 템플릿
    • ## 내용 설명 ## 작업 내용 - 작업 1 - 작업 2
  • PR 템플릿
    • ## 간단한 내용 설명 ## 구현 내용 <!-- ## 스크린샷 --> <!--## 장애물 --> ## PR 포인트<!--리뷰어가 집중했으면 하는 부분 --> ## 참고 사항<!--특이 사항이나 리뷰어가 알고 있으면 좋을 것 같은 내용 --> ## 궁금한 점 <!-- ## 이슈 번호 close --> <!--## 테스트 계획 또는 완료 사항-->
 

8. 프로젝트 상세 일정

혼콕 프로젝트 타임라인
 

9. 바로가기🗂️

Github Wiki

Home
Contribute to prgrms-fe-devcourse/FEDC4_HONKOK_JunilHwang development by creating an account on GitHub.
Home
https://github.com/prgrms-fe-devcourse/FEDC4_HONKOK_JunilHwang/wiki
Home

Figma

Chromatic

✏️회고

🔥
중간 회고
최종 회고
최종 회고