https://github.com/developeracademy-postech/2025-c4-m6-omr
사용자가 특정 장소에 음악을 남기고, 다른 사람의 음악을 발견할 수 있는 위치 기반 뮤직 아카이빙 앱
https://github.com/developeracademy-postech/2025-c4-m6-omr
Last synced: 16 days ago
JSON representation
사용자가 특정 장소에 음악을 남기고, 다른 사람의 음악을 발견할 수 있는 위치 기반 뮤직 아카이빙 앱
- Host: GitHub
- URL: https://github.com/developeracademy-postech/2025-c4-m6-omr
- Owner: DeveloperAcademy-POSTECH
- License: other
- Created: 2025-07-06T04:31:17.000Z (12 months ago)
- Default Branch: develop
- Last Pushed: 2025-08-28T08:32:23.000Z (10 months ago)
- Last Synced: 2025-08-28T09:36:07.150Z (10 months ago)
- Language: Swift
- Homepage:
- Size: 47.9 MB
- Stars: 9
- Watchers: 0
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 🌷PIUM - 꽃으로 남기는 나의 기억
> PIUM은 사용자가 특정 위치에 3D 꽃 오브젝트와 사진, 텍스트 기록을 남길 수 있는 공간 기반의 아카이빙 앱입니다.
[]()
[]()
[]()
---
## 🗂 목차
- [소개](#소개)
- [프로젝트 기간](#프로젝트-기간)
- [기술 스택](#기술-스택)
- [기능](#기능)
- [시연](#시연)
- [폴더 구조](#폴더-구조)
- [팀 소개](#팀-소개)
- [Git 컨벤션](#git-컨벤션)
- [테스트 방법](#테스트-방법)
- [프로젝트 문서](#프로젝트-문서)
- [라이선스](#lock_with_ink_pen-license)
---
## 📱 소개
> PIUM은 사용자가 특정 위치에 3D 꽃 오브젝트와 사진, 텍스트 기록을 남길 수 있는 공간 기반의 아카이빙 앱입니다.
사용자는 방문한 장소에 당시의 추억을 기록하는 오브젝트를 남기고 이를 AR뷰를 통해 되돌아 볼 수 있습니다.
공간과 기록이 함께하는 경험을 제공합니다.
[🔗 앱스토어/웹 링크](https://example.com)
## 📆 프로젝트 기간
- 전체 기간: `2025.07.DD - 2025.07.DD`
- 개발 기간: `2025.07.14 - YYYY.MM.DD`
## 🛠 기술 스택
- Swift 5.9 / SwiftUI / UIKit
- Xcode 15.0
- 아키텍처: MVVM
- 프레임워크: MapKit, ARKit, RealityKit
- 테스트: XCTest
- 기타 도구: Figma, Notion, GitHub Projects
- CI/CD: 미정
- 배포: 미정
## 🌟 주요 기능
- ✅ 장소 기반 3D 오브젝트 기록 남기기
사용자는 현재 위치를 기반으로 3D 꽃 오브젝트와 사진, 텍스트 기록을 남길 수 있습니다.
같은 장소에 다시 방문 했을시 여전히 남겨져 있는 나의 꽃 오브젝트를 볼 수 있습니다.
- ✅ 나의 기록 다시 보기
내가 남긴 기록을 리스트 뷰, 지도 뷰로 다시 볼 수 있습니다.
## 🖼 화면 구성 및 시연
| 기능 | 설명 | 이미지 |
|------|------|--------|
| 예시1 | 기능 요약 |  |
| 예시2 | 기능 요약 |  |
## 🧱 폴더 구조
```
📦ProjectName
┣ 📂Feature
┃ ┣ 📂SceneA
┃ ┗ 📂SceneB
┣ 📂Core
┣ 📂UI
┣ 📂Test
┗ 📂Resources
```
## 🧑💻 팀 소개
| [Elena (김지윤)](https://github.com/Jykim-111) | [Avery (정서진)](https://github.com/averysjung) | [OneThing (천은송)](https://github.com/freeskyES) | [Woody (이창건)](https://github.com/Mark3891) | [Henry (김현목)](https://github.com/NOP-YA) | [Kave (황지민)](https://github.com/RoastedJM) |
|:---:|:---:|:---:|:---:|:---:|:---:|
| 
| 
| 
| 
| 
| 
|
## 🔖 브랜치 전략
→ [docs/branch-guide.md](docs/branch-guide.md) 문서를 참고해주세요.
## 📚 커밋 컨벤션 가이드
→ [docs/commit-guide.md](docs/commit-guide.md) 문서를 참고해주세요.
## ✅ 테스트 방법
1. 이 저장소를 클론합니다.
```bash
git clone https://github.com/DeveloperAcademy-POSTECH/2025-C4-M6-OMR.git
```
2. `Xcode`로 `.xcodeproj` 또는 `.xcworkspace` 열기
3. 시뮬레이터 환경 설정: iPhone 15 / iOS 17
4. `Cmd + R`로 실행 / `Cmd + U`로 테스트 실행
## 📎 프로젝트 문서
- [기획 히스토리](링크)
- [디자인 히스토리](링크)
- [기술 문서 (아키텍처 등)](링크)
## 📝 License
This project is licensed under the ~~[CHOOSE A LICENSE](https://choosealicense.com). and update this line~~