Skip to content

[Docs] #144 - 리꾸#153

Merged
OneTen19 merged 2 commits intodevelopfrom
docs/#144-readme
Feb 25, 2026
Merged

[Docs] #144 - 리꾸#153
OneTen19 merged 2 commits intodevelopfrom
docs/#144-readme

Conversation

@OneTen19
Copy link
Copy Markdown
Member

@OneTen19 OneTen19 commented Feb 25, 2026

🌴 작업한 브랜치

  • docs#144

✅ 작업한 내용

리꾸했습니다


Frame 2087328876

Frame 2087328927

“Neki, 네컷의 순간이 이어지는 곳”

네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는 서비스

QR 스캔 한 번으로 앨범에 즉시 저장

흩어져 있던 종이 사진과 디지털 파일을 NEKI 하나로 끝내세요. QR 스캔 한 번으로 앱에서 바로 저장하고, 날짜별/폴더별로 정리됩니다.

QR이 없어도 걱정 NO

예전에 찍어둔 사진이나 QR 유효기간이 지난 사진도 직접 업로드하여 동일하게 관리할 수 있습니다.

"오늘 뭐 하지?" 포즈 고민 해결

카메라 앞에서 당황하지 마세요! NEKI가 제안하는 트렌디한 포즈와 '랜덤 포즈' 기능이 당신의 자연스러운 촬영을 도와드립니다.

원하는 브랜드만 쏙쏙! 완벽한 네컷 지도

지금 바로 찍고 싶을 때, 주변의 사진관을 확인하세요. 브랜드 필터를 사용해 내가 선호하는 브랜드만 골라 찾을 수 있습니다.

추억을 테마별로 관리

친구, 연인, 특별한 기념일 등 목적에 맞춰 폴더를 만들고 소중한 순간들을 테마별로 기록하세요.


Contributors

윤금용 김한열

Tech Stack

분류 기술 / 도구 역할 버전
IDE & SDK Xcode & SPM Apple의 공식 IDE, Swift 기반 의존성 관리 도구 26.2
UI 프레임워크 SwiftUI 코드의 간결성과 직관성을 통해 빠르고 쉽게 사용자 인터페이스를 설계하고 유지보수가 가능 -
아키텍처 TCA 상태 관리, 단방향 데이터 흐름, 테스트, 사이드 이펙트 처리에 강력하고 일관된 아키텍처 라이브러리 1.23.1
네트워크 계층 URLSession Apple 플랫폼 서버 통신 핵심 네트워킹 API 클래스 -
이미지 처리 Kingfisher 효율적인 이미지 다운로드 및 캐싱을 통해 네트워크 이미지 로딩 성능 향상 8.6.2
비동기 처리 Swift Concurrency 명확하고 안전한 비동기 흐름 관리를 통해 복잡한 비동기 로직의 가동성과 유지보수성 향상 -
로그 관리 Logger 구조화된 로깅을 지원하여 성능 저하 없이 효율적으로 로그 수집 및 분석 가능 -
네컷 지도 NMapsMap 네이버 클라우드 플랫폼에서 제공하는 네이버 지도 SDK 3.23.0
QR 스캐너 AVFoundation 오디오 및 비디오 미디어 데이터를 만들고, 편집, 재생, 기록 및 처리하는 강력한 최상위 프레임워크 -
로그인 KakaoOpenSDK 카카오 소셜 로그인을 통한 간편한 사용자 인증 2.27.1
버전 관리 Git, GitHub 분산 버전 관리 시스템을 통한 형상 관리 및 협업 2.46.0
협업 도구 Figma, Notion UI/UX 디자인 리소스 공유 및 프로젝트 문서화, 태스크 관리 2.46.0

Architecture

스크린샷 2026-02-25 오후 7 43 20

Micro Clean Architecture

모듈화와 계층 분리의 결합

기능 단위의 모듈화(Modular)와 내부 3계층 분리(Clean Architecture)를 동시에 적용

4대 핵심 모듈

APP(라우팅), Core(공통 로직/네트워크), Shared(디자인/UI), Features(도메인별 기능)로 역할 분리

Feature 내부 분리

각 도메인 모듈 내부는 Presentation, Domain, Data 계층으로 철저히 분리되어 의존성 최소화

📁 Neki-iOS
├── 📁 APP                  // 앱 진입점 및 최상위 라우팅
   └── 📁 Sources
       ├── 📁 Application
       ├── 📁 MainTab
       └── 📁 Onboarding

├── 📁 Core                 // 공통 비즈니스 로직 및 인프라
   └── 📁 Sources
       ├── 📁 Auth         (Data, Domain, Presentation)
       ├── 📁 Network      (Base, TokenStorage 등)
       ├── 📁 ImagePicker
       └── 📁 Logger

├── 📁 Features             // 도메인별 분리된 기능 모듈 (Micro Clean Architecture)
   ├── 📁 Archive          (아카이브 탭)
      └── 📁 Sources
          ├── 📁 Data
          ├── 📁 Domain
          └── 📁 Presentation
   ├── 📁 Map              (지도 탭)
      └── 📁 Sources
          ├── 📁 Data, Domain, Presentation
   ├── 📁 MyPage           (마이페이지 탭)
      └── 📁 Sources
          ├── 📁 Data, Domain, Presentation
   ├── 📁 Pose             (포즈 추천 탭)
      └── 📁 Sources
          ├── 📁 Data, Domain, Presentation
   └── 📁 QRCodeScanner    (QR 스캐너)
       └── 📁 Sources
           ├── 📁 Data, Domain, Presentation

└── 📁 Shared               // 공통 UI 및 디자인 시스템
    └── 📁 DesignSystem
        ├── 📁 Resources    (Assets, Fonts, Animations)
        └── 📁 Sources
            ├── 📁 Component(Button, Modal, TextField, Toast 등)
            ├── 📁 Modifier
            └── 📁 Color, Font

Convention

Coding

Swift 스타일쉐어 가이드를 기반으로

팀원의 기존 스타일을 반영하였습니다.

Commit

[Feat] : 새로운 기능 구현
[Fix] : 버그, 오류 해결
[Chore] : 코드 수정, 내부 파일 수정, 애매한 것들이나 잡일은 이걸로!
[Add] : 라이브러리 추가, 에셋 추가
[Del] : 쓸모없는 코드 삭제
[Docs] : README나 WIKI 등의 문서 개정
[Refactor] : 전면 수정이 있을 때 사용합니다.
[Setting] : 프로젝트 설정관련이 있을 때 사용합니다.
[Merge] : Pull Develop

예시 [Feat] #1 - 메인 UI 구현


Summary by CodeRabbit

  • Documentation
    • README가 새로운 헤더 이미지, 프로젝트 태그라인과 함께 개선됨
    • 프로젝트 기능, 아키텍처, 기술 스택, 기여자 정보가 상세히 추가됨
    • 개발 컨벤션 및 커밋 메시지 가이드라인 섹션이 새로 구성됨

Updated README with new images, features, and tech stack details.
Updated the README.md to improve service description and QR scan functionality.
@OneTen19 OneTen19 added this to the YAPP 27기 기간 내 작업 milestone Feb 25, 2026
@OneTen19 OneTen19 self-assigned this Feb 25, 2026
@OneTen19 OneTen19 added Docs 📑 문서 작성 및 수정 (README.md 등) 한열 🧄 한열 작업 labels Feb 25, 2026
@OneTen19 OneTen19 linked an issue Feb 25, 2026 that may be closed by this pull request
1 task
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Feb 25, 2026

개요

README.md 파일이 대규모로 재작성되고 구조가 개편되었습니다. 헤더 이미지, 새로운 섹션(기여자, 기술 스택, 아키텍처, 컨벤션), 그리고 프로젝트 구조 설명이 추가되었으며, 기존 내용이 재구성되었습니다.

변경사항

코호트 / 파일(s) 요약
README 구조 및 콘텐츠 개편
README.md
헤더 이미지 추가, 프로젝트 설명 섹션 재구성, 기여자 및 기술 스택 테이블 도입, Micro Clean Architecture 설명 추가, 모듈 구조 트리 업데이트, 코딩 컨벤션 및 커밋 메시지 가이드라인 추가 (106줄 추가, 43줄 삭제)

예상 코드 리뷰 노력

🎯 3 (Moderate) | ⏱️ ~25 분

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed 제목이 PR의 주요 변경사항을 명확하게 설명하고 있습니다. [Docs] 태그와 이슈 번호 #144를 포함하며, '리꾸'는 README의 전면 개편을 의미합니다.
Description check ✅ Passed PR 설명이 템플릿의 주요 섹션을 포함하고 있습니다. 작업 내용, 기능 소개, 기여자, 기술 스택, 아키텍처, 컨벤션을 상세히 설명했으며, 스크린샷과 이미지도 포함되어 있습니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/#144-readme

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
README.md (1)

20-20: README 내 TODO 주석은 이슈로 분리하는 편이 좋겠습니다.

Line 20의 <!-- 기능 소개 PPT 추가 예정 -->는 배포 문서에 남기기보다 GitHub Issue로 추적하는 편이 유지보수에 유리합니다.

원하시면 TODO를 템플릿화한 이슈 본문(완료 조건/담당/마감 포함)으로 바로 작성해드릴게요.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 20, Remove the inline README TODO comment `<!-- 기능 소개 PPT
추가 예정 -->` and create a tracked GitHub Issue instead; update README.md to delete
that HTML comment and, when creating the Issue, use a template that includes
title, description, acceptance criteria, assignee, and due date so the work
referenced by the deleted comment is tracked (you can copy the comment text into
the Issue body).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 9: Add meaningful alt text to the inline <img> tags used in the README,
e.g., the image in the "#### QR 스캔 한 번으로 앨범에 즉시 저장" heading and the other
occurrences noted (lines 11,13,15,17,24,26,32,51,111,138); locate the markdown
image tags (the <img ... /> elements) and add a descriptive alt attribute
(alt="...") that conveys the icon/banner purpose for screen reader users,
keeping the alt concise and context-specific.
- Line 7: The heading at line containing "###  네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는
서비스" skips from H1 to H3 and uses two spaces after the hashes; change the
heading level to the appropriate sequential level (e.g., use "##" if the
previous is H1) and normalize spacing to a single space after the hash marks,
and make the same single-space/level fix for the other affected heading (the one
at the line matching the same pattern around line 55) so all headings follow
consistent H1→H2→H3 order and use one space after '#'.
- Line 26: The contributor avatar image tags in the README use an incorrect
height attribute (height="3400") which breaks layout; update the <img> elements
(the ones with width="200px" height="3400" and their counterpart) to use a
sensible height (e.g., height="200px") or remove the height attribute and rely
on width/CSS for consistent sizing so both avatar images render properly and the
README layout is not broken.

---

Nitpick comments:
In `@README.md`:
- Line 20: Remove the inline README TODO comment `<!-- 기능 소개 PPT 추가 예정 -->` and
create a tracked GitHub Issue instead; update README.md to delete that HTML
comment and, when creating the Issue, use a template that includes title,
description, acceptance criteria, assignee, and due date so the work referenced
by the deleted comment is tracked (you can copy the comment text into the Issue
body).

ℹ️ Review info

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a8ec0aa and 07f8c5b.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
> “Neki, 네컷의 순간이 이어지는 곳”

## Foldering
### 네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는 서비스
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

헤딩 레벨/공백 규칙을 맞춰 문서 구조를 안정화해주세요.

Line 7은 H1 -> H3로 한 단계 건너뛰고 있고, Line 7/Line 55 모두 ### 처럼 해시 뒤 공백이 2칸입니다. 렌더링은 되더라도 문서 목차/린트 일관성이 깨집니다.

수정 예시
-###  네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는 서비스 
+## 네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는 서비스

-###  Micro Clean Architecture
+### Micro Clean Architecture

Also applies to: 55-55

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 7-7: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)


[warning] 7-7: Multiple spaces after hash on atx style heading

(MD019, no-multiple-space-atx)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 7, The heading at line containing "###  네컷사진의 시작부터 보관까지,
당신의 기록을 완성하는 서비스" skips from H1 to H3 and uses two spaces after the hashes;
change the heading level to the appropriate sequential level (e.g., use "##" if
the previous is H1) and normalize spacing to a single space after the hash
marks, and make the same single-space/level fix for the other affected heading
(the one at the line matching the same pattern around line 55) so all headings
follow consistent H1→H2→H3 order and use one space after '#'.

Comment thread README.md
### 네컷사진의 시작부터 보관까지, 당신의 기록을 완성하는 서비스

```Text
#### <img width="30" height="30" src="https://github.com/user-attachments/assets/7ec36287-820f-4efb-9c46-dc9c85e92263" /> QR 스캔 한 번으로 앨범에 즉시 저장
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

인라인 이미지에 alt를 추가해 접근성을 보완해주세요.

여러 이미지 태그에 대체 텍스트가 없어 스크린리더 사용자에게 정보가 전달되지 않습니다. 특히 섹션 아이콘/배너는 문맥 전달용이라 alt가 필요합니다.

수정 예시
-#### <img width="30" height="30" src="https://github.com/user-attachments/assets/7ec36287-820f-4efb-9c46-dc9c85e92263" /> QR 스캔 한 번으로 앨범에 즉시 저장
+#### <img width="30" height="30" alt="QR 저장 아이콘" src="https://github.com/user-attachments/assets/7ec36287-820f-4efb-9c46-dc9c85e92263" /> QR 스캔 한 번으로 앨범에 즉시 저장

-<img width="3240" height="400" src="https://github.com/user-attachments/assets/fee4035c-4bac-4921-95ec-93318bd2bdf9" />
+<img width="3240" height="400" alt="NEKI 푸터 배너" src="https://github.com/user-attachments/assets/fee4035c-4bac-4921-95ec-93318bd2bdf9" />

Also applies to: 11-11, 13-13, 15-15, 17-17, 24-24, 26-26, 32-32, 51-51, 111-111, 138-138

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 9-9: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 9, Add meaningful alt text to the inline <img> tags used
in the README, e.g., the image in the "#### QR 스캔 한 번으로 앨범에 즉시 저장" heading and
the other occurrences noted (lines 11,13,15,17,24,26,32,51,111,138); locate the
markdown image tags (the <img ... /> elements) and add a descriptive alt
attribute (alt="...") that conveys the icon/banner purpose for screen reader
users, keeping the alt concise and context-specific.

Comment thread README.md

## <img width="40" height="40" src="https://github.com/user-attachments/assets/06940c34-fa04-461f-acd6-f6e121ffdd61" /> Contributors

| <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/99116619?v=4" /> | <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/63261054?v=4" /> |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Contributors 아바타 높이 값이 비정상적으로 큽니다.

Line 26의 height="3400"은 오타로 보이며 README 렌더링에서 레이아웃을 크게 깨뜨릴 수 있습니다.

수정 예시
-| <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/99116619?v=4" /> | <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/63261054?v=4" /> |
+| <img width="200" height="200" alt="Remaked-Swain 프로필" src="https://avatars.githubusercontent.com/u/99116619?v=4" /> | <img width="200" height="200" alt="OneTen19 프로필" src="https://avatars.githubusercontent.com/u/63261054?v=4" /> |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/99116619?v=4" /> | <img width="200px" height="3400" src="https://avatars.githubusercontent.com/u/63261054?v=4" /> |
| <img width="200" height="200" alt="Remaked-Swain 프로필" src="https://avatars.githubusercontent.com/u/99116619?v=4" /> | <img width="200" height="200" alt="OneTen19 프로필" src="https://avatars.githubusercontent.com/u/63261054?v=4" /> |
🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 26-26: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 26-26: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 26, The contributor avatar image tags in the README use an
incorrect height attribute (height="3400") which breaks layout; update the <img>
elements (the ones with width="200px" height="3400" and their counterpart) to
use a sensible height (e.g., height="200px") or remove the height attribute and
rely on width/CSS for consistent sizing so both avatar images render properly
and the README layout is not broken.

Copy link
Copy Markdown
Member

@Remaked-Swain Remaked-Swain left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이뿌덩 ㅎㅎ

@OneTen19 OneTen19 merged commit b4291a7 into develop Feb 25, 2026
1 check passed
@OneTen19 OneTen19 deleted the docs/#144-readme branch February 25, 2026 11:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs 📑 문서 작성 및 수정 (README.md 등) 한열 🧄 한열 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] 리꾸(리드미 꾸미기라는 뜻)

2 participants