HOUME

나다운 집을 만들어주는 여정, 하우미

HOUME는 나만의 개성 있는 공간을 디자인하고 꾸밀 수 있도록 도와주는 AI 기반 인테리어 플랫폼입니다.

HOUME Web Developers

엄경호	박소이	임지성	조성하	문혜성
@maehwasoo	@soyyyyy	@jstar000	@earl9rey	@sndks

Tech Stack

역할	종류
Build Tool
Library
Programming Language
Styling
Data Fetching
UI Documentation
Formatting
Package Manager
Deployment
Version Control

Architecture

src/
├── layout/              # 앱 전체에 적용되는 공통 레이아웃 컴포넌트
├── pages/               # 페이지 단위로 기능을 나눈 디렉토리 (Route에 해당)
│   ├── home/            # 홈 페이지 관련 기능
│   │   ├── components/
│   │   ├── constants/
│   │   ├── apis/
│   │   ├── types/
│   │   ├── utils/
│   │   └── hooks/
│   └── login/           # 로그인/회원가입 관련 기능
│       ├── components/
│       ├── constants/
│       ├── apis/
│       ├── types/
│       ├── utils/
│       └── hooks/
├── routes/              # 라우팅 관련 설정
├── shared/              # 전역에서 공유되는 공통 코드
│   ├── apis/            # 공통 API 함수
│   ├── assets/          # 이미지, 아이콘, 폰트 등 정적 리소스
│   ├── components/      # 재사용 가능한 공통 UI 컴포넌트
│   ├── constants/       # 앱 전체에서 사용하는 공통
│   ├── styles/          # 전역 스타일, 테마, 공통 CSS
│   ├── types/           # 공통 타입 정의
│   ├── utils/           # 공통 유틸 함수들
│   └── hooks/           # 전역 커스텀 훅
└── stories/             # Storybook을 위한 스토리 파일

pages/ 아래에 페이지 단위로 폴더를 구성하고, 각 폴더 내부에 필요한 요소들을 모아두는 기능 기반 구조를 사용했습니다.
각 도메인은 독립적으로 구성하되, 도메인 단위로 코드를 응집하고 공통 요소는 따로 모아 재활용하는 원칙을 준수합니다.

Git

Git Flow

Convention

• Branch Convention type/설명/#이슈번호

• Issue Convention [type] 제목

• Pull Request Convention [type] 제목

• Commit Convention type: 제목

커밋유형	의미
feat	새로운 기능 추가
fix	버그 수정
docs	문서 수정
style	코드 포맷팅, 세미콜론 누락, 코드 변경이 없는 경우, 비즈니스 로직 변경 X
refactor	코드 리팩토링
test	테스트 코드, 리팩토링 테스트 코드 추가, 비즈니스 로직 변경 X
chore	설정 변경사항 (빌드 스크립트, assets, 패키지 매니저 등), 프로덕션 코드 변경 X
design	CSS 등 사용자 UI 디자인 추가/수정
comment	주석 추가/수정
rename	파일 및 폴더명 수정
remove	파일 삭제

나다운 집을 만들어가는 여정, HOUME