Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
137 changes: 47 additions & 90 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,123 +1,80 @@
# 🚀 프로젝트 이름
# 🚀 보소 BOSO
<img width="1920" height="1080" alt="썸네일" src="https://github.com/user-attachments/assets/e4f3f6b5-0e87-430e-8c60-3c4aca610223" />
<img width="1920" height="1080" alt="온보딩" src="https://github.com/user-attachments/assets/c0aee785-3066-4ea9-b8ec-4a0ef3aa8b84" />

![배너 이미지 또는 로고](링크)
> 소리를 듣지 않아도, 영상의 순간을 온전히 느낄 수 있습니다. 보소(BOSO)가 영상의 현장감을 당신의 화면 위로 전해드립니다.

> 간단한 한 줄 소개 – 프로젝트의 핵심 가치 또는 기능

[![Swift](https://img.shields.io/badge/Swift-5.9-orange.svg)]()
[![Xcode](https://img.shields.io/badge/Xcode-15.0-blue.svg)]()
[![License](https://img.shields.io/badge/license-MIT-green.svg)]()
[![SwiftUI](https://img.shields.io/badge/SwiftUI-5.9-orange.svg)]()
[![Xcode](https://img.shields.io/badge/Xcode-26.0-blue.svg)]()

---

## 🗂 목차
- [소개](#소개)
- [프로젝트 기간](#프로젝트-기간)
- [기술 스택](#기술-스택)
- [기능](#기능)
- [시연](#시연)
- [폴더 구조](#폴더-구조)
- [팀 소개](#팀-소개)
- [Git 컨벤션](#git-컨벤션)
- [테스트 방법](#테스트-방법)
- [프로젝트 문서](#프로젝트-문서)
- [라이선스](#lock_with_ink_pen-license)

---
<br>
<br>

## 📱 소개

> 프로젝트의 주요 목적과 사용자가 얻게 될 경험을 설명해주세요.
> 청각장애인이 맥북으로 재생되는 영상의 소리를 실시간 자막과 시각적 효과로 확인하며, 몰입감 있게 시청할 수 있도록 돕는 앱

[🔗 앱스토어/웹 링크](https://example.com)

<br>

## 📆 프로젝트 기간
- 전체 기간: `YYYY.MM.DD - YYYY.MM.DD`
- 개발 기간: `YYYY.MM.DD - YYYY.MM.DD`
- 전체 기간: `2025.09.01 - 2025.11.28`
- 개발 기간: `2025.10.23 - 2025.11.21`

<br>

## 🛠 기술 스택

- Swift / SwiftUI / UIKit / Firebase 등
- 아키텍처: MVVM / MVC / Clean Architecture 등
- 기타 도구: Figma, Notion, GitHub Projects 등
### Envrionment
<div align="left">
<img src="https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white" />
</div>

### Development
<div align="left">
<img src="https://img.shields.io/badge/Xcode-007ACC?style=for-the-badge&logo=Xcode&logoColor=white" />
<img src="https://img.shields.io/badge/SwiftUI-42A5F5?style=for-the-badge&logo=swift&logoColor=white" />
</div>

## 🌟 주요 기능

- ✅ 기능 1
- ✅ 기능 2
- ✅ 기능 3
### Communication
<div align="left">
<img src="https://img.shields.io/badge/Miro-FFFC00.svg?style=for-the-badge&logo=Miro&logoColor=050038" />
<img src="https://img.shields.io/badge/Notion-white.svg?style=for-the-badge&logo=Notion&logoColor=000000" />
<img src="https://img.shields.io/badge/Figma-F24E1E?style=for-the-badge&logo=figma&logoColor=white" />
</div>

> 필요시 이미지, GIF, 혹은 링크 삽입
<br>

## 🌟 주요 기능

## 🖼 화면 구성 및 시연

| 기능 | 설명 | 이미지 |
|------|------|--------|
| 예시1 | 기능 요약 | ![gif](링크) |
| 예시2 | 기능 요약 | ![gif](링크) |

- ✅ 실시간 자막 제공 _ 맥북에서 재생되는 영상의 소리를 캡처하여 STT로 변환하여 자막을 실시간으로 표시합니다.
<img width="378" height="240.5" alt="Frame-7" src="https://github.com/user-attachments/assets/ee34b37d-f540-43a3-a7f1-c80e276393e8" />
<img width="378" height="240.5" alt="Frame-1" src="https://github.com/user-attachments/assets/c08533bb-29e0-49cc-b372-dcdffca2ad38" />

## 🧱 폴더 구조
- ✅ 청각 신호 시각화 _ 소리 크기, 분위기, 휘슬 등 특정 청각적 요소를 글자 크기, 색상, 애니메이션 등으로 시각화합니다.
<img width="378" height="240.5" alt="Frame-3" src="https://github.com/user-attachments/assets/8dd5ae0f-eab9-419e-9fa9-0d42d21f7e87" />
<img width="378" height="240.5" alt="Frame-4" src="https://github.com/user-attachments/assets/4b8bbd87-2862-44e7-b4fc-53bac1fceb90" />
<img width="378" height="240.5" alt="Frame-5" src="https://github.com/user-attachments/assets/7f3ae849-7d30-4795-bd30-7ec5b2ad4ce6" />
<img width="378" height="240.5" alt="Frame-6" src="https://github.com/user-attachments/assets/d904daa9-5eb9-485d-b0d4-63bf8be7f708" />

```
📦ProjectName
┣ 📂Feature
┃ ┣ 📂SceneA
┃ ┗ 📂SceneB
┣ 📂Core
┣ 📂UI
┣ 📂Test
┗ 📂Resources
```
- ✅ 효과 On/Off _ 영상 종류나 상황에 따라 시각적 표현 기능을 자유롭게 켜거나 끌 수 있습니다
<img width="378" height="240.5" alt="Frame-2" src="https://github.com/user-attachments/assets/7402c92a-a4e5-4cbc-a321-589de970cc84" />

<br>

## 🧑‍💻 팀 소개

| 이름 | 역할 | GitHub |
|------|------|--------|
| 홍길동 | iOS Developer | [@hong](https://github.com/hong) |
| 김개발 | PM | [@devkim](https://github.com/devkim) |

[🔗 팀 블로그 / 미디엄 링크](https://medium.com/example)

## 🔖 브랜치 전략
`(예시)`
- `main`: 배포 가능한 안정 버전
- `develop`: 통합 개발 브랜치
- `feature/*`: 기능 개발 브랜치
- `bugfix/*`: 버그 수정 브랜치
- `hotfix/*`: 긴급 수정 브랜치

## 🌀 커밋 메시지 컨벤션
`(예시)`
[Gitmoji](https://gitmoji.dev) + [Conventional Commits](https://www.conventionalcommits.org)

### 예시
- ✨ feat: 로그인 화면 추가
- 🐛 fix: 홈 진입 시 크래시 수정
- ♻️ refactor: 데이터 모델 구조 정리


## ✅ 테스트 방법

1. 이 저장소를 클론합니다.
```bash
git clone https://github.com/yourteam/project.git
```
2. `Xcode`로 `.xcodeproj` 또는 `.xcworkspace` 열기
3. 시뮬레이터 환경 설정: iPhone 15 / iOS 17
4. `Cmd + R`로 실행 / `Cmd + U`로 테스트 실행
### Openock = Open + (k)nock

모두가 접근할 수 있는 열린 세상을 두드리는 팀

## 📎 프로젝트 문서
| <img width="401" height="401" alt="enoch" src="https://github.com/user-attachments/assets/e67f2fa3-f9da-4451-a402-e8fac8166b07" /> | <img width="401" height="401" alt="leon" src="https://github.com/user-attachments/assets/3dba1c59-c360-452b-9599-5342a7d733a9" /> | <img width="401" height="401" alt="mary" src="https://github.com/user-attachments/assets/9104e718-b46a-440c-aefd-79539ce9efa8" /> | <img width="401" height="401" alt="paduck" src="https://github.com/user-attachments/assets/d14d6389-63ef-476a-8291-077a2091b2ca" /> | <img width="401" height="401" alt="root" src="https://github.com/user-attachments/assets/ecf81805-6447-4585-b576-3416618308fe" /> | <img width="401" height="401" alt="Frame-4" src="https://github.com/user-attachments/assets/ea08566f-1a37-43dd-9808-2e0d6110cc89" /> |
|:------:|:------:|:------:|:------:|:------:|:------:|
| [**Enoch (한혜빈)**](https://github.com/HanHyeBeen)<br>*PM, Tech*| [**Leon (김혜서)**](https://github.com/being0825)<br>*Design* | [**Mary (임희서)**](https://github.com/Ellyhs)<br>*Tech* | [**Paduck (서용원)**](https://github.com/paohree)<br>*Tech* | [**Root (맹지주)**](https://github.com/maengjj)<br>*Tech* | [**Wendy (윤예람)**](https://github.com/altol2)<br>*Design* |

- [기획 히스토리](링크)
- [디자인 히스토리](링크)
- [기술 문서 (아키텍처 등)](링크)
<br><br><br>


## 📝 License
Expand Down