Skip to content

LO-CO-CO/LOCOCO-CLIENT

Repository files navigation

Lococo

home-banner

K-뷰티에 관심 있는 일본 사용자들을 위한 서비스 Lococo는 사용자 중심의 신뢰할 수 있는 리뷰 커뮤니티를 구축하고, 일본인 소비자에게 필요한 한국 인플루언서 콘텐츠를 자동 번역·요약하여 큐레이션해요. 검색/언어 장벽 없이 리뷰 확인부터 제품 정보 탐색, 구매 결정까지 한 번에 이어질 수 있는 원스톱 구조로 구성했어요.

K-뷰티 플레이어와 일본인 소비자를 연결하는 bridge 역할을 하며, 일본 K-뷰티 소비자들의 디지털 거점이 되는 것을 목표로 갖고 있어요.

Team

home 리뷰모달 상세 search 리뷰작성


Tech Stack

역할 종류
Core Next.js React
Programming Language TypeScript
Styling Tailwind CSS shadcn/ui
Data Fetching TanStack Query
Development Tools Storybook swagger-typescript-api Turborepo
Code Quality ESLint Prettier
Package Manager pnpm
Version Control Git GitHub

그라운드 룰

업무 관리

Slack

업무 내용 전달 시 Slack을 활용해서 전달해요. 다른 파트 원들과도 진행 상황을 쉽게 공유하고 의사소통할 수 있어요. 주제에 대한 디스커션이 생기는 경우 댓글을 활용해서 의견을 나누기 때문에 내용이 분산되지 않고 이후 빠르게 관련 내용을 찾을 수 있어요. 아티클 공유 채널, Github PR 알림 채널, 업무용 채널을 분리하여 필요한 내용에 대한 빠른 확인이 가능해요.

Notion

업무 내용을 문서화해서 저장해놨어요. 회의록이나 팀 규칙, 일정 등 노션에 정리해서 일괄적으로 확인할 수 있어요.

회의

Discord

주로 Discord를 활용해서 회의를 진행해요. 온라인 회의인 만큼 집중력이 분산되는 것을 막기 위해 카메라를 킨 상태로 참여해요. 회의를 진행하면서 Notion에 실시간으로 정리하기 때문에 원활한 교류가 가능해요.

데일리 스크럼

매일 오전에 데일리 스크럼을 진행하며 전날 수행한 업무와 오늘 수행할 업무에 대해서 공유해요. 팀원들의 계획과 일정을 파악하고 협업하는 데 도움이 돼요. 또, 해야 하는 일을 정리하면서 업무 효율을 높일 수 있어요.


일정 관리

노션 데이터베이스를 활용해서 일정관리를 진행해요. 작업이름, 상태, 담당자, 마감일을 기입하고 매일 최신화해요. 또, 캘린더를 통해서 파트 일정을 정리하고 참가자를 지정해서 일정이 추가된 경우 팀원이 바로 확인할 수 있어요.

작업 리스트업 일정 캘린더
스크린샷 2025-07-04 오전 2 05 22 스크린샷 2025-07-04 오전 2 06 00

프로젝트 컨벤션 & 협업 가이드

브랜치 전략

Git Flow Git Flow 설명 이미지

브랜치 네이밍 컨벤션

유형 형식 예시
기능 추가 feature/#<이슈번호>/<기능명> feature/#12/user-login-page
버그 수정 fix/#<이슈번호>/<기능명> fix/#34/fix-login-redirect
리팩토링 refactor/#<이슈번호>/<기능명> refactor/#21/refactor-user-service
긴급 패치 hotfix/#<이슈번호>/<기능명> hotfix/#88/fix-navbar-crash
  • 기능명에는 kebab-case 사용
  • 이슈 번호는 GitHub 이슈와 연동

커밋 컨벤션

Udacity Git Style Guide 기반

prefix 설명
feat 새로운 기능 추가
fix 버그 수정
docs 문서 수정 (README 등)
design UI/스타일 변경
refactor 기능 변경 없이 코드 리팩토링
test 테스트 코드 추가, 변경
chore 설정, 빌드, 패키지 등 작업 (프로덕션 코드 영향 없음)
hotfix 배포 후 긴급 수정
feat: 마이페이지 UI 구현
fix: 로그인 시 토큰 누락 오류 수정
refactor: userService 코드 정리
design: 버튼 hover 효과 추가
docs: README에 브랜치 전략 설명 추가
hotfix: 배포 후 500 에러 응급 조치

코드 컨벤션

파일 및 폴더명

kebab-case (예: user-profile.tsx, /user-components)

코드 스니펫

항목 스니펫 설명
UI 컴포넌트 rfc 함수형 컴포넌트, Next.js 스타일 공식 사용
유틸리티 함수 rafc 화살표 함수 형태의 유틸 함수 정의

변수 및 함수

변수 네이밍 camelCase, Boolean 값: is 접두사 사용 (isActive)
상수 대문자 스네이크 케이스 (API_BASE_URL)
이벤트 핸들러 함수 화살표 함수 사용, handle + 명사 + 동사 네이밍 (handleUserClick),

타입 정의

객체 타입: interface
enum 대용, 간단한 타입: type
타입명: PascalCase (UserInfo, ButtonVariant)

CSS 단위

rem 사용


협업 규칙

  1. 📲 카카오톡, 슬랙 등 커뮤니케이션 채널을 수시로 확인하기
  2. 🧩 어려운 일이 생기면 혼자 고민하지 말고 꼭 공유하기 (함께 고민하면 더 빨리 해결할 수 있어요!)
  3. 🗣️ 서로의 의견을 존중하고 배려하는 말투로 소통하기
  4. 🎉 힘들어도 재미있게, 즐기면서 프로젝트 진행하기
  5. 마감 기한을 잘 지키기 (일정이 어려울 땐 미리 말해서 조정하기)

질문 가이드

  1. 직접 찾아보기

    • Google, ChatGPT, 공식 문서 등
    • 영어 검색 권장 → 어려우면 DeepL 등 번역기 활용
  2. 구체적으로 이야기하기

    • 현재 상황(어디서, 어떤 문제가 발생했는지)
    • 내가 알고 있는 것
    • 참고한 자료나 검색한 내용
    • 이해되지 않는 부분
    • 본인이 시도한 해결 방법
  3. 해결한 내용은 팀에 공유하기!

Pull Request (PR) 규칙

  • 합숙 이전: 2명 이상 Approve 후 Merge
  • 합숙 기간: 리드의 Approve로 Merge 가능 (여유있는 다른 팀원들도 꼭 리뷰 달아주기! 못 달아줄 것 같으면 코드라도 한 번 봐주기)
  • 리뷰 확인하면 이모지 남기기
  • 리뷰 반영 시 작업 단위로 커밋 나눠서, 리뷰 댓글에 커밋 번호 남겨서 알려주기
  • 리뷰 반영 후에는 re-request review 하기
  • 열심히 논의하기

코드 리뷰 가이드

  • 부드러운 어조 사용하기
  • 구체적인 피드백 + 참고 링크 함께 작성하기
  • 궁금한 부분도 함께 질문하기
  • 다른 리뷰어가 잘 남겼다고 리뷰 안 남기지 말고 간단하게라도 코멘트랑 남기고 approve/request change 하기
  • LGTM 지양하기

About

크리에이터와 브랜드를 연결해주는 K-코스메 플랫폼, 로코코

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6

Languages