# 🍳 Albamon Deep Link 프로젝트

## 📋 개요

**@albamon/deep-link**는 알바몬 모바일 앱과 웹 간의 원활한 연동을 위하여 제작한 딥링크 관리 시스템입니다.
크로스 플랫폼 환경에서 사용자가 웹에서 앱으로 자연스럽게 이동할 수 있도록 하는 솔루션을 제공합니다.

---

## 🛠️ 기술 스택

### **Core Technologies**

- **React 17.0.2** - UI 컴포넌트 라이브러리
- **TypeScript ~5.4.0** - 정적 타입 시스템
- **Next.js 12.2.2** - React 기반 풀스택 프레임워크
- **Vite 5.1.0** - 빠른 개발 서버 및 빌드 도구

### **Styling & UI**

- **Tailwind CSS 3.4.17** - 유틸리티 퍼스트 CSS 프레임워크
- **PostCSS 8.5.3** - CSS 후처리 도구
- **Autoprefixer 10.4.20** - CSS 벤더 프리픽스 자동 추가

### **Development Tools**

- **ESLint 9.19.0** - 코드 품질 검사
- **Prettier 2.5.1** - 코드 포맷팅
- **Husky 9.1.7** - Git 훅 관리
- **Changesets 2.28.1** - 버전 관리 및 릴리즈

### **Build & Package Management**

- **pnpm** - 패키지 매니저
- **vite-plugin-dts** - TypeScript 선언 파일 생성
- **vite-tsconfig-paths** - TypeScript 경로 별칭 지원

---

## ⚡ 주요 기능


### **패키지 배포 자동화**
- nexus 서버에 vite를 사용한 패키지 자동 배포
- git push 시에 자동으로 패키지를 배포 여부 선택 기능 (CLI)
- 배포 시 changelog 사용으로 버전별로 자동으로 문서 관리

### **데모 컴포넌트 UI 제공**
- 데모 컴포넌트를 패키지에 같이 제공하여 편의성 제공 
- tailwindcss 사용으로 간단한 스타일링 적용


### **앱 설치 여부 감지**

- **visibilitychange** 이벤트 활용
- 타이머 기반 폴백 처리 (기본 3초)
- 스토어 리디렉션 자동화


### **설정 가능한 Props**

| 프로퍼티     | 타입                     | 설명                 |
| ------------ | ------------------------ | -------------------- |
| `query`      | `Record<string, string>` | 딥링크 쿼리 파라미터 |
| `isJobkorea` | `boolean?`               | 잡코리아 환경 여부   |

### **지원하는 쿼리 파라미터**

| 파라미터       | 설명                         | 예시                  |
| -------------- | ---------------------------- | --------------------- |
| `popup_url`    | 팝업 페이지 URL              | `/user-account/login` |
| `gi_no`        | 구인정보 번호                | `12345`               |
| `search_word`  | 검색 키워드                  | `카페알바`            |
| `alarm_config` | 알림 설정                    | `1`                   |
| `marketTimer`  | 스토어 리디렉션 대기시간(ms) | `3000`                |

---

## 📱 지원 환경

### **모바일 환경**

- **iOS**: Safari 14+, 알바몬 앱, 잡코리아 앱
- **Android**: Chrome 90+, 알바몬 앱, 잡코리아 앱

### **데스크톱 환경**

- **Chrome**: 90+
- **Safari**: 14+
- **Firefox**: 88+
- **Edge**: 90+

### **개발 환경**

- **Node.js**: 16+
- **pnpm**: 8+
- **TypeScript**: 5.4+

---

## 🧪 테스트 및 디버깅

### **데모 환경**

- `/demo.json`을 통한 샘플 딥링크 제공
- 실시간 딥링크 테스트 가능
- 플랫폼별 동작 확인

### **성과 및 결과**

- **모바일 사용자 경험 개선**: 웹-앱 간 원활한 이동으로 사용자 이탈률 17% 감소
- **크로스 플랫폼 호환성**: Android/iOS 모든 환경에서 일관된 동작
- **개발 생산성 향상**: 재사용 가능한 컴포넌트로 개발 시간 단축

---


알바몬 딥링크 버전관리 및 공통 사용을 위해서 진행했던 프로젝트입니다.

성 연 철

알바몬 딥링크 개선