Skip to content

docs: 리드미 초안 작성 중...#186

Merged
Neibce merged 13 commits intomainfrom
docs/readme
Aug 25, 2025
Merged

docs: 리드미 초안 작성 중...#186
Neibce merged 13 commits intomainfrom
docs/readme

Conversation

@Neibce
Copy link
Owner

@Neibce Neibce commented Aug 25, 2025

Important

Expanded README.md with detailed onboarding, feature specs, expert feedback, and enhanced user experience for role-specific navigation and health/emotion records.

  • Documentation:
    • Expanded README.md with onboarding/signup flow, feature specifications, expert feedback (3.4), directory structure (3.5), and deployment instructions.
    • Improved section numbering, image consistency, and visual representation.
  • User Features:
    • Enhanced onboarding/signup flow: nickname/profile/role selection, family code validation.
    • Role-specific navigation and parent landing, detailed health/emotion record (including photo upload).
    • Enhanced reward/temperature index display and plans for wearable integration/report sharing.
  • Misc:
    • Improved collaboration tool (CodeRabbit) and schedule flow integration.

This description was created by Ellipsis for 009d419. You can customize this summary. It will automatically update as commits are pushed.


Summary by CodeRabbit

  • 문서화
    • README 대대적 재구성 및 확장: 개발 목표·타깃 분석·기능 명세·시연·테스트 시나리오·배포/빌드 안내 등 전반 보강
    • 온보딩/화면 흐름(로그인·회원가입·부모/자녀 랜딩·메인/리워드/건강 기록) 상세화, 협업 도구(CodeRabbit) 반영
  • 새로운 기능(사용자 관점)
    • 건강 기록(통증·약 복용·운동 시간)·가족 만보기·마음 기록(사진 업로드 포함) 항목 분리·확장
    • 리워드 시스템·온도지수 시각화·공유 리포트·웨어러블 연동 계획 반영

@coderabbitai
Copy link

coderabbitai bot commented Aug 25, 2025

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

README.md가 대대적으로 재구성되어 온보딩/회원가입 흐름과 건강·마음 기록, 리워드·온도 지수, 기능 명세(3.3), 전문가 피드백(3.4), 디렉토리 구조(3.5), 테스트·배포·비즈니스 모델 문서가 상세화되었음. 코드/API 변경은 없음.

Changes

Cohort / File(s) Change Summary
문서 통합 및 기능·아키텍처 확장
README.md
- 온보딩/회원가입 흐름 상세화: 이메일 유효성검사, 계정 존재 체크, 단계별 회원가입(비밀번호→닉네임→프로필→역할→가족코드 생성/입력/검증) 및 역할별 랜딩 경로
- 건강 기록 재구성: 통증 부위/약 복용 체크/운동 시간/걸음수/건강 상태 등 트리 구조 재배치 및 부모·자녀별 경로 명시
- 마음 기록(소통) 확장: 사진 업로드, 가시성 규칙, 입력·조회·상세 화면 흐름 기술
- 리워드 및 온도 지수 시각화·지속 사용 트리거(리워드/알림/UI 맞춤) 설명 보강
- 신규 섹션 추가: 3.3 기능명세서, 3.4 전문가 피드백(만보기 랭킹/카카오톡 리포트/웨어러블 연동 계획 포함), 3.5 디렉토리 구조 재구성
- 설치/시연·배포 문서 보강: Firebase 설정 형식 개선, 수동 빌드·의존성·릴리즈 절차, 시연 영상 및 테스트 시나리오·기간 명시
- 비즈니스 모델·리스크·사회적 가치·전문가 피드백 반영 내용 추가

Sequence Diagram(s)

sequenceDiagram
    participant User as 사용자
    participant Onboarding as 온보딩화면
    participant EmailSvc as 이메일검증
    participant Auth as 인증서비스
    participant Signup as 회원가입흐름
    participant FamilySvc as 가족서비스

    rect rgba(135,206,250,0.10)
    Note right of Onboarding: 초기 이메일 입력 및 분기
    end

    User->>Onboarding: 이메일 입력
    Onboarding->>EmailSvc: 포맷/유효성 검사
    EmailSvc-->>Onboarding: 유효/무효

    alt 이메일 유효
        Onboarding->>Auth: 계정 존재 확인
        Auth-->>Onboarding: 계정 있음
        Onboarding->>User: 로그인 화면으로 분기
    else 계정 없음
        Onboarding->>Signup: 회원가입 단계 시작
        Signup->>User: 비밀번호 → 닉네임 → 프로필 아이콘 → 역할 선택
        Signup->>FamilySvc: 가족코드 생성/입력/검증
        FamilySvc-->>Signup: 코드 발급/검증 결과
        Signup->>Auth: 계정 생성/완료
        Auth-->>Signup: 생성 성공
        Signup->>User: 역할별 랜딩 페이지로 이동
    end
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

깡총, README 숲에 길을 낸다 🐇
이메일 길목 닦고, 닉네임 꽃 심고,
건강·마음 지도에 별을 찍고,
디렉토리 뿌리까지 살금살금 정리했네.
토끼 발자국 따라 출발! ✨

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Caution

Changes requested ❌

Reviewed everything up to 0c93060 in 2 minutes and 8 seconds. Click for details.
  • Reviewed 396 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 7 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:25
  • Draft comment:
    Consider adding a table of contents for easier navigation in this lengthy README.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
2. README.md:3
  • Draft comment:
    Improve image alt text for accessibility; use descriptive text instead of '온기_썸네일'.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
3. README.md:177
  • Draft comment:
    Avoid using inline HTML
    tags within table cells; consider using markdown line breaks or separate rows for consistency.
  • Reason this comment was not posted:
    Decided after close inspection that this draft comment was likely wrong and/or not actionable: usefulness confidence = 10% vs. threshold = 50% While the comment suggests a valid markdown best practice, this is a very minor formatting issue that doesn't affect functionality or readability significantly. The current format with
    still renders correctly. This seems like an overly pedantic suggestion that doesn't warrant a PR comment. The suggestion would make the markdown more "pure" and consistent. Some markdown processors might handle HTML tags differently. The current format works fine and is readable. The benefit of changing it is minimal and not worth the overhead of a PR comment. This comment about HTML formatting is too minor and doesn't provide enough value to justify keeping it in the PR.
4. README.md:842
  • Draft comment:
    Consider moving the detailed directory structure to a separate file or appendix to improve overall readability.
  • Reason this comment was not posted:
    Comment was on unchanged code.
5. README.md:130
  • Draft comment:
    Typographical error: Consider adding a space after the period. Change "유도한다.단순한 경쟁이 아닌..." to "유도한다. 단순한 경쟁이 아닌...".
  • Reason this comment was not posted:
    Decided after close inspection that this draft comment was likely wrong and/or not actionable: usefulness confidence = 10% vs. threshold = 50% While the suggestion would improve readability slightly, this is an extremely minor formatting issue. The meaning is perfectly clear without the space. The rules say not to make purely informative comments or comments that are obvious/unimportant. This seems to fall into that category. The space would technically improve readability and follow proper punctuation rules. Some could argue proper formatting is important for professionalism. While proper formatting is good, this is such a minor issue that it doesn't warrant a PR comment. The rules explicitly say not to make unimportant comments. Delete this comment as it points out an extremely minor formatting issue that doesn't meaningfully impact understanding.
6. README.md:448
  • Draft comment:
    There is an inconsistency in the spacing of '건강 기록 버튼'. In line 445 it is written with a space ('건강 기록 버튼'), while here it appears as '건강기록 버튼'. Please standardize the term for clarity.
  • Reason this comment was not posted:
    Comment was on unchanged code.
7. README.md:833
  • Draft comment:
    Typographical: There should be a space between the closing parenthesis and '등' in "Apple Health(애플 워치)등과 연동하여". Consider changing it to "Apple Health(애플 워치) 등과 연동하여" for consistency.
  • Reason this comment was not posted:
    Decided after close inspection that this draft comment was likely wrong and/or not actionable: usefulness confidence = 10% vs. threshold = 50% While the suggestion is technically correct according to Korean spacing rules, this is an extremely minor formatting issue that doesn't impact readability or functionality. PR comments should focus on more substantive issues. Additionally, this kind of minor formatting suggestion could be handled by automated tools rather than manual review comments. The spacing rule is technically correct, so removing this comment means accepting slightly incorrect Korean formatting. Some might argue that maintaining proper language formatting is important for professionalism. While proper formatting is good, this level of nitpicking in PR comments creates noise and distracts from more important issues. The benefit of fixing this tiny spacing issue doesn't justify the cognitive overhead of an additional PR comment. Delete this comment as it's too minor of an issue to warrant a PR comment. This kind of formatting detail would be better handled by automated tools.

Workflow ID: wflow_hznmed1DhsOsPlZL

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

README.md Outdated
| **웨어러블 및 헬스케어 연동** | 현재는 걸음 수 정보만 수집하고 있으며, 향후 Google Fit, Samsung Health(갤럭시 워치), Apple Health(애플 워치)등과 연동하여 **건강 데이터를 보다 체계적으로 자동으로 수집·분석할 수 있도록 구현할 계획** |


| ![[화면 1] 가족 만보기 랭킹 시스템 화면](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/%EB%B6%80%EB%AA%A8_-_%EA%B1%B4%EA%B0%95%EA%B8%B0%EB%A1%9D_-_%EA%B0%80%EC%A1%B1_%EB%A7%8C%EB%B3%B4%EA%B8%B0_%EB%9E%AD%ED%82%B9%201.png) | ![[화면 2] 카카오톡 건강 분석 리포트 공유](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/image%204.png) |
Copy link

Choose a reason for hiding this comment

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

Replace non-standard image syntax (e.g., ![[화면 1] ...]) with standard markdown image syntax for better readability.

Suggested change
| ![[화면 1] 가족 만보기 랭킹 시스템 화면](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/%EB%B6%80%EB%AA%A8_-_%EA%B1%B4%EA%B0%95%EA%B8%B0%EB%A1%9D_-_%EA%B0%80%EC%A1%B1_%EB%A7%8C%EB%B3%B4%EA%B8%B0_%EB%9E%AD%ED%82%B9%201.png) | ![[화면 2] 카카오톡 건강 분석 리포트 공유](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/image%204.png) |
| ![화면 1 가족 만보기 랭킹 시스템 화면](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/%EB%B6%80%EB%AA%A8_-_%EA%B1%B4%EA%B0%95%EA%B8%B0%EB%A1%9D_-_%EA%B0%80%EC%A1%B1_%EB%A7%8C%EB%B3%B4%EA%B8%B0_%EB%9E%AD%ED%82%B9%201.png) | ![화면 2 카카오톡 건강 분석 리포트 공유](README%20md%20%EC%9E%91%EC%84%B1%20223f0cc1d61280f7af41dc746142684f/image%204.png) |

Copy link

@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: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

1085-1097: 민감 정보/건강 데이터 수집 언급 → 개인정보 처리방침 링크 필요

건강/위치/사진 등 민감정보 취급이 반복 언급됩니다. 최소한의 데이터 항목, 저장 위치, 보관 기간, 제3자 제공/파기 정책, 동의/철회 절차를 명시한 개인정보 처리방침 문서 링크를 README에 추가해 주세요.

원하시면 초안 템플릿을 제공하겠습니다.

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

93-107: 용어 일관성: '온도 지수 시각' → '시각화'로 통일 권장

'시각화' 용어를 이미 사용 중이므로 동일 용어로 맞추면 읽기 흐름이 좋아집니다.

다음처럼 수정 제안:

-    - 온도계 형태의 직관적인 온도 지수 시각
+    - 온도계 형태의 직관적인 온도 지수 시각화

112-136: 헤딩을 굵게(Emphasis)로 대체 사용하고 있어 markdownlint MD036 위반

섹션 제목을 굵게 텍스트(...)로 쓰지 말고 적절한 헤딩 레벨(####/#####)로 변경해 주세요. (동일 패턴이 이 블록 전반에 반복됩니다.)

다음과 같이 헤딩으로 변환 제안:

-**1. 통증 부위 입력 기능**
+##### 1. 통증 부위 입력 기능
...
-**2. 약 복용 체크 기능**
+##### 2. 약 복용 체크 기능
...
-**3. 운동시간 기록 기능**
+##### 3. 운동시간 기록 기능
...
-**4. 가족 만보기 기능**
+##### 4. 가족 만보기 기능

127-131: 문장부호 및 띄어쓰기 다듬기(가독성)

마침표 뒤 공백 누락과 장문을 두 문장으로 나누면 읽기 쉬워집니다.

- 또한, 타 가족과의 걸음 수를 비교하고 순위를 공유함으로써, 가족 간 건강한 경쟁을 유도한다.단순한 경쟁이 아닌, 함께 걷는 즐거움과 응원의 문화를 만들어내는 데에 중점을 둔다.
+ 또한, 타 가족과의 걸음 수를 비교하고 순위를 공유함으로써 가족 간 건강한 경쟁을 유도한다.
+ 단순한 경쟁이 아닌, 함께 걷는 즐거움과 응원의 문화를 만드는 데에 중점을 둔다.

140-142: 블록 인용 내 문장 길이와 강세 최소화

블록 인용(>) 안에서 줄바꿈
남용이 있어 모바일에서 줄 높이가 커질 수 있습니다. 인용 내 강세는 필요한 키워드만 유지해 주세요.

예시로, 불필요한
제거 및 핵심 키워드만 굵게 유지 권장.

Also applies to: 132-136


177-179: 테이블 앞뒤 공백(Line break) 부족 — markdownlint MD058

테이블 위·아래에 빈 줄을 추가해 렌더링/가독성 문제를 예방하세요.


362-362: 이미지 대체 텍스트(alt) 보강

alt="Flow_Chart_..."는 정보 전달력이 낮습니다. 화면/플로우의 목적을 요약한 alt로 바꾸면 접근성과 검색성이 좋아집니다.

예: alt="온보딩~로그인 전체 사용자 플로우 차트", alt="홈 화면 구성 요소(도넛 그래프/사이드바/리워드) 플로우".

Also applies to: 368-368


520-527: 굵게 텍스트 중복 표기 정리 및 문장 흐름 개선

굵게 범위가 단어 단위로 끊겨 어색합니다.

-- 이후 **등록하기** **버튼**을 클릭하면 약 복용 일정 추가 팝업 화면으로 이동한다.
+- 이후 **등록하기 버튼**을 클릭하면 약 복용 일정 추가 팝업 화면으로 이동한다.

575-582: 맞춤법/표기 통일: '좌·우', '마음 기록' 띄어쓰기

강조로 감싸진 가운데점과 붙임표기가 혼재합니다.

-- 해당 날짜에 가족 구성원이 기록한 마음 기록을 좌 **·** 우로 스와이프하여 확인할 수 있다.
+- 해당 날짜에 가족 구성원이 기록한 마음 기록을 좌·우로 스와이프하여 확인할 수 있다.
...
-- ‘마음기록을 업로드 해볼까요?’
+- ‘마음 기록을 업로드해볼까요?’

592-592: 섹션 레벨/넘버링 확인: 3.3 바로 앞 뒤 컨텍스트 점검

3.2.* 세부 섹션 다음에 3.3이 이어지며, 이후 3.4/3.5가 존재합니다. 상위 3장 구조는 일관적이지만 2장(상세설계)에서는 2.2가 비어 있습니다. 2.2 섹션 존재 여부를 확인하고 필요 시 추가/번호 재정렬이 필요합니다.


671-671: 용어 일관성: '만보기 횟수' ↔ '걸음 수' 통일

문서 전반에서 '걸음 수'를 주로 사용합니다. '만보기 횟수'는 혼란을 줄 수 있어 '걸음 수'로 통일 권장.

- | 14     | 사이드바 3               | 만보기 횟수 간이 알림                                                                     |
+ | 14     | 사이드바 3               | 걸음 수 간이 알림                                                                        |

1006-1009: 외부 설치 링크(특히 APK) 안전성 안내 추가 권장

외부 도메인 APK 배포는 위·변조 우려가 있습니다. GitHub Releases에 서명한 AAB/APK와 SHA256 해시를 함께 제공하고, 서명 정보(keystore SHA-1/Signer)도 명시해 주세요.

해시 생성 예시:

shasum -a 256 app-release.apk

1012-1014: 비공개 자격증명 취급 가이드 보강

Firebase 설정 파일 미포함 고지는 좋습니다. 여기에 배포 파이프라인에서 GitHub Actions Secrets/Encrypted Vars로 주입하는 절차와 로컬 개발용 .env 관리 가이드를 추가하면 안전성이 올라갑니다.

원하시면 Actions 워크플로 샘플(yaml)과 .gitignore/.env 템플릿을 드리겠습니다.


288-293: 오탈자 정정

  • Line 288~289: "디지털 취약계능일" → "디지털 취약계층일"
  • Line 292: "사회적가지" → "사회적 가치"
  • Line 805: "떄" → "때"
- 디지털 취약계능일 가능성이 높다고 판단하여
+ 디지털 취약계층일 가능성이 높다고 판단하여
...
- ### 1.5. 사회적가지 도입 계획
+ ### 1.5. 사회적 가치 도입 계획
...
- 내가 마음 기록을 남기지 않았을 떄
+ 내가 마음 기록을 남기지 않았을 때

Also applies to: 805-805


15-24: 문서 길이 대비 목차(TOC) 부재

문서가 장대해 스크롤 탐색이 어렵습니다. 최상단에 자동 생성 TOC를 추가하면 가독성이 크게 개선됩니다.

예: GitHub 호환 TOC(마크다운 앵커 기반) 또는 DocToc 배지 사용.

Also applies to: 25-31


1006-1009: 스토어/배포 링크 상태 모니터링 자동화 제안

검증 결과 현재 모든 링크가 정상(200 OK) 응답을 반환했습니다.
향후 스토어 링크나 외부 APK가 변경될 경우 자동으로 감지할 수 있도록, CI 파이프라인에 주기적인 상태 코드 검사 스크립트를 추가할 것을 권장드립니다.

  • 대상 위치: README.md Lines 1006–1009

샘플 CI 체크 스크립트:

#!/bin/bash
urls=(
  "https://testflight.apple.com/join/ywaeumFn"
  "https://play.google.com/store/apps/details?id=com.ongi2025.ongi"
  "https://statics.jun0.dev/app-release.apk"
)
for u in "${urls[@]}"; do
  code=$(curl -s -o /dev/null -w '%{http_code}' "$u")
  echo "$code $u"
done

435-442: 들여쓰기 통일: 서브 항목은 2 스페이스로 수정 필요

README.md 전체에 걸쳐 서브 항목 앞 들여쓰기가 4스페이스(또는 그 이상)로 혼재되어 있습니다. Markdown 스타일 가이드(MD007)에 따라 하위 목록은 2스페이스로 통일해 주세요.

  • 대상 위치 예시
    • 3.2.3 로그인 페이지 하위 목록 (435–442)
    • 기타 하위 목록 (451–457 등)

  • 수정 예시

-    - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
+  - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
  • 들여쓰기 검사 스크립트
#!/bin/bash
# 4스페이스 이상 들여쓴 하위 목록 찾기
rg -n '^ {4,}- ' README.md
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 2b95747 and 0c93060.

📒 Files selected for processing (1)
  • README.md (16 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

112-112: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


117-117: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


122-122: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


126-126: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


179-179: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


438-438: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


439-439: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


440-440: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


441-441: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


505-505: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


511-511: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


523-523: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


549-549: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


551-551: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


578-578: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)

🔇 Additional comments (3)
README.md (3)

1055-1055: 테스트 기간 표기 불일치(요일/기간) 확인 필요

"8/11(화) - 8/17(일) ; 6일 간"이라고 되어 있으나, 2025-08-11은 월요일, 17은 일요일이며 기간은 7일입니다. 실제 진행 일수/포맷을 확인 후 정정해 주세요. 예: "2025-08-11(월) ~ 2025-08-17(일), 7일간".

- - **테스트 기간**: 8/11(화) - 8/17(일) ; 6일 간 진행되었다.
+ - **테스트 기간**: 2025-08-11(월) ~ 2025-08-17(일), 7일간 진행

824-839: 이미지 링크 상대 경로/공백 문제 없음

현재 README.md의 모든 이미지가 GitHub user-attachments를 통한 절대 URL로 삽입되어 있으며, 상대 경로나 공백이 포함된 링크는 존재하지 않습니다. 따라서 추가 수정은 필요하지 않습니다.


328-346: 버전 정보 동기화 확인 요청

아래 내용을 참고해 README에 적힌 기술 버전이 실제 설정과 일치하는지 검증해 주세요.

  • Spring Boot
    • backend/ongi/build.gradle
      id 'org.springframework.boot' version '3.5.3'로 설정되어 있어 README(3.5.3)와 일치합니다.
  • Flutter
    • frontend/ongi/pubspec.yaml의 Dart SDK 제약(environment: sdk: ^3.8.1)만 확인되며, Flutter SDK 버전(3.35.1)은 코드베이스에서 직접 추출되지 않습니다.
    • .metadata 파일 또는 flutter --version 명령으로 실제 프로젝트에 사용 중인 Flutter 버전을 확인하고 README를 업데이트해 주세요.
  • MySQL
    • 코드 및 의존성 설정 내에서 MySQL 서버 버전(8.4.6)을 정의한 부분을 찾을 수 없습니다.
    • RDS 설정, Docker/Infra IaC 스크립트 등 배포 환경에서 사용 중인 MySQL 버전을 검증해 주세요.

Copy link

@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: 1

♻️ Duplicate comments (2)
README.md (2)

469-469: 교차 참조 오표기(중복 지적): 3.2.5 → 3.2.6

뒤로가기 대상이 메인 페이지인데 번호가 3.2.5로 표기되어 있습니다. 3.2.6으로 수정 필요합니다.

-- 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+- 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.

479-479: 교차 참조 오표기(중복 지적): 3.2.5 → 3.2.6

리워드 페이지의 뒤로가기 대상 번호도 동일 이슈입니다.

- - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+ - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.
🧹 Nitpick comments (13)
README.md (13)

112-126: 굵은 텍스트를 실제 헤딩으로 전환해 MD036 경고 해결

현재 굵은 텍스트()를 헤딩 대용으로 쓰고 있어 linter(MD036)가 경고합니다. 동일 레벨(####) 서브헤딩으로 변경해 목차/앵커 생성도 이점이 있습니다.

아래와 같이 변경 제안드립니다:

-**1. 통증 부위 입력 기능**
+#### 1. 통증 부위 입력 기능
 ...
-**2. 약 복용 체크 기능**
+#### 2. 약 복용 체크 기능
 ...
-**3. 운동시간 기록 기능**
+#### 3. 운동시간 기록 기능
 ...
-**4. 가족 만보기 기능**
+#### 4. 가족 만보기 기능

Also applies to: 132-137, 140-142


177-179: 표 주변 공백 추가로 MD058 해결

테이블 전후에 빈 줄이 없어 MD058 경고가 발생합니다. 위아래에 공백 한 줄씩 추가하세요.

-
 |                                 본 앱에는 ‘프리미엄 구독 시스템’이 존재합니다. 위와 같은 유료 서비스 및 혜택을 위해 돈을 최대 얼마까지 지불할 의향이 있으신가요?<br>(한 달 기준으로 선택해 주세요.)                                  |
 |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
 | <img width="501" height="394" alt="건강_소통_앱_온기_설문조사 xlsx" src="https://github.com/user-attachments/assets/f879fd05-ccdf-465b-8987-2ee5548f9d58" /> |
+

438-441: 하위 목록 들여쓰기(2스페이스)로 MD007 해결

하위 불릿 들여쓰기가 4칸이라 MD007 경고가 납니다. 2칸으로 통일을 권장합니다.

예시 패치:

-    - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
+  - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
-    - 정보가 일치하고 해당 사용자가 부모인 경우, 부모 랜딩 페이지(3.2.4)로 이동한다.
+  - 정보가 일치하고 해당 사용자가 부모인 경우, 부모 랜딩 페이지(3.2.4)로 이동한다.
-    - 정보가 일치하지 않는다면, 경고 문구가 화면 하단에 표시된다.
+  - 정보가 일치하지 않는다면, 경고 문구가 화면 하단에 표시된다.
-    - 이후 각 버튼을 누르면 해당 상세 페이지로 이동하여 부모가 기록한 건강 정보를 열람할 수 있다.
+  - 이후 각 버튼을 누르면 해당 상세 페이지로 이동하여 부모가 기록한 건강 정보를 열람할 수 있다.
-    - 신체도에서 오늘의 **통증 부위**를 선택하고 우측 상단의 **확인 버튼**을 클릭하면 건강 상태 입력이 완료된다.
+  - 신체도에서 오늘의 **통증 부위**를 선택하고 우측 상단의 **확인 버튼**을 클릭하면 건강 상태 입력이 완료된다.
-    - 등록하지 않은 경우 기본 알약 아이콘 표시
+  - 등록하지 않은 경우 기본 알약 아이콘 표시
-    - `평균 걸음 수: (1주간 가족 총 걸음 수) ÷ 가족 인원 수`
+  - `평균 걸음 수: (1주간 가족 총 걸음 수) ÷ 가족 인원 수`
-    - 우리 가족 순위 카드는 주황색으로 강조된다.
+  - 우리 가족 순위 카드는 주황색으로 강조된다.
-    - 사진 및 코멘트, 위치, 선택한 감정이 표시된다.
+  - 사진 및 코멘트, 위치, 선택한 감정이 표시된다.

Also applies to: 505-505, 511-511, 523-523, 549-549, 551-551, 578-578


474-474: 단위 표기 일관화(℃ ↔ °C)

문서 내에서 ℃와 °C가 혼재합니다. 국제 표기(°C)로 통일을 제안합니다.

-  → 기본 온도 36.5℃를 제외한 **실제 사용 가능 온도** 표시
+  → 기본 온도 36.5°C를 제외한 **실제 사용 가능 온도** 표시

185-185: 오탈자 수정: ‘던다’ → ‘덜어준다’

문맥상 비용 부담을 낮춘다는 의미로 보입니다.

-  조직과 리퍼럴 수수료, 공동 마케팅 비용을 분담해 비용적 부담감을 던다.
+  조직과 리퍼럴 수수료, 공동 마케팅 비용을 분담해 비용적 부담감을 덜어준다.

263-263: 오탈자 수정: ‘젋은’ → ‘젊은’

-    - 젋은 세대: 일상 속에서 사용을 지속할 만한 감정적 동기가 제공되지 못한다.
+    - 젊은 세대: 일상 속에서 사용을 지속할 만한 감정적 동기가 제공되지 못한다.

288-292: 맞춤법/표기 교정: ‘디지털 취약계능’/‘사회적가지’

의도하신 단어는 ‘디지털 취약계층’, ‘사회적 가치’로 보입니다.

-    - 부모의 위치로 가입하는 사용자는 디지털 취약계능일 가능성이 높다고 판단하여 큰 글자, 큰 기록 버튼, 최소 터치 플로우 등을 통해 인지적 부담을 낮춘 입력 방식을
+    - 부모의 위치로 가입하는 사용자는 디지털 취약계층일 가능성이 높다고 판단하여 큰 글자, 큰 기록 버튼, 최소 터치 플로우 등을 통해 인지적 부담을 낮춘 입력 방식을
-### 1.5. 사회적가지 도입 계획
+### 1.5. 사회적 가치 도입 계획

314-314: 헤딩 공백 추가: ‘2.상세설계’ → ‘2. 상세설계’

번호와 제목 사이 공백을 넣어 일관성을 유지하세요.

-## 2.상세설계
+## 2. 상세설계

580-581: 표기 일관화: ‘마음기록’ 띄어쓰기 및 문장 교정

섹션 전반에서 ‘마음 기록’으로 사용하므로 일치시키고, ‘업로드해 볼까요?’로 띄어쓰기 보정합니다.

-  3.2.17)로 이동한다.
+  3.2.17)로 이동한다.
- - 모든 가족 구성원이 마음 기록을 업로드하지 않은 경우, ‘마음기록을 업로드 해볼까요?’ 라는 텍스트 및 **사각형 버튼**이 표시되고, 이를 클릭하면 마음 기록 입력 페이지(
+ - 모든 가족 구성원이 마음 기록을 업로드하지 않은 경우, ‘마음 기록을 업로드해 볼까요?’라는 텍스트 및 **사각형 버튼**이 표시되고, 이를 클릭하면 마음 기록 입력 페이지(

922-949: 프론트 디렉터리 트리 좋습니다 + 사소한 공백 수습

구조 가독성 좋습니다. 한 줄 사소 공백만 정리 제안드립니다.

-        ├── utils/               # 공통 유틸리티 함수 및 헬퍼 클래스 폴더 
+        ├── utils/               # 공통 유틸리티 함수 및 헬퍼 클래스 폴더

954-960: APK 배포 무결성 안내 추가 제안

직접 APK 링크를 제공하시는 만큼, 사용자 신뢰를 위해 SHA-256 체크섬과 서명(keystore) 지문(SHA-1/256) 표기를 권장합니다. 보안/배포 FAQ 섹션으로 안내 링크를 두면 더 좋습니다.

원하시면 체크섬 산출 및 표기 예시 블록을 만들어 드리겠습니다.


1006-1006: 기간 산정 확인 필요: 8/11 ~ 8/17 ‘6일 간’ 표기

포함 기준이라면 7일간이 맞습니다. 영문권 독자도 고려해 YYYY-MM-DD 형식과 타임존 명시를 권장합니다.

수정 예시:

-- **테스트 기간**: 8/11(화) - 8/17(일) ; 6일 간 진행되었다.
+- **테스트 기간**: 2025-08-11 ~ 2025-08-17; 7일간 진행.

320-324: 이미지 대체 텍스트(a11y) 구체화 권장

일부 alt가 ‘image 2’ 등 비서술적입니다. 스크린리더와 썸네일 미표시 환경을 위해 화면 목적/핵심 요소가 드러나도록 alt를 구체화해 주세요.

예)

  • “Full-Stack Architecture 다이어그램(서비스/DB/스토리지 구성)”
  • “홈 화면 레이아웃(도넛 그래프/사이드바/리워드 버튼)”

Also applies to: 360-386, 390-394

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 0c93060 and bb652fb.

📒 Files selected for processing (1)
  • README.md (17 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

112-112: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


117-117: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


122-122: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


126-126: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


179-179: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


438-438: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


439-439: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


440-440: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


441-441: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


505-505: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


511-511: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


523-523: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


549-549: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


551-551: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


578-578: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)

🔇 Additional comments (2)
README.md (2)

93-93: 헤딩 레벨 하향 조정 적절함

상위 섹션 대비 하위 주제임이 명확해져 문서 스캔이 쉬워졌습니다.


398-407: 온보딩 흐름 명확화 좋습니다

이메일 유효성 → 계정 존재 여부 분기 → 로그인/회원가입으로의 자연스런 이동이 잘 설명되어 있습니다.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed cd4ebfb in 1 minute and 29 seconds. Click for details.
  • Reviewed 53 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 3 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:174
  • Draft comment:
    Improved table cell formatting: Added a
    to split the sentence for better readability. Confirm that the whitespace changes are intentional.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
2. README.md:209
  • Draft comment:
    Header levels changed from H3 to H4 for '앱 사용 의향 및 시장 진입 전략' and '핵심 기능 선호도'. Ensure this is consistent with the overall document structure.
  • Reason this comment was not posted:
    Comment looked like it was already resolved.
3. README.md:238
  • Draft comment:
    Blank line removal before the '1.3.4. 인사이트 요약' section appears stylistic—verify that the visual separation remains clear.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None

Workflow ID: wflow_KR8XWh5bsYH4yH5n

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 98bfe80 in 46 seconds. Click for details.
  • Reviewed 48 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 5 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:247
  • Draft comment:
    Changed heading from '### 기존 건강 앱' to '#### 기존 건강 앱' for improved hierarchy consistency.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
2. README.md:260
  • Draft comment:
    Updated heading '### 기존 서비스 대비 차별점' to '#### 기존 서비스 대비 차별점' to maintain a consistent structure.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
3. README.md:964
  • Draft comment:
    Modified heading for '의존성 설치' from level 3 to level 4; ensure it aligns with the overall document hierarchy.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
4. README.md:978
  • Draft comment:
    Adjusted heading for 'Android 릴리즈 빌드' from level 3 to level 4; verify consistency with adjacent sections.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
5. README.md:986
  • Draft comment:
    Changed heading for 'iOS 릴리즈 빌드 (macOS 전용)' to level 4, which appears consistent with the other sections.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None

Workflow ID: wflow_wXUi2eDQn0Qgu5tE

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 9834a5b in 49 seconds. Click for details.
  • Reviewed 38 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 2 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:832
  • Draft comment:
    Table formatting for the expert feedback screenshots has been tweaked. The updated alignment is clearer, but please verify that the markdown renders consistently across viewers.
  • Reason this comment was not posted:
    Confidence changes required: 33% <= threshold 50% None
2. README.md:955
  • Draft comment:
    The QR code table in the installation section is now split into two rows with added spacing. Ensure this new layout displays well on various devices.
  • Reason this comment was not posted:
    Confidence changes required: 33% <= threshold 50% None

Workflow ID: wflow_w1YDeRHdrGAzBsfl

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed db4c273 in 1 minute and 16 seconds. Click for details.
  • Reviewed 550 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 6 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:5
  • Draft comment:
    Suggestion: Consider adding a Table of Contents at the beginning of this README to help navigate the extensive content.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
2. README.md:114
  • Draft comment:
    Consider using native Markdown formatting for line breaks instead of HTML
    tags for consistency across renderers.
  • Reason this comment was not posted:
    Comment was on unchanged code.
3. README.md:283
  • Draft comment:
    Typo detected: "사회적가지 도입 계획" might be intended as "사회적 기여 도입 계획".
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
4. README.md:1041
  • Draft comment:
    Ensure that including team member emails is intentional; consider privacy implications if this repository is public.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
5. README.md:120
  • Draft comment:
    Typographical error: In the description for the '운동시간 기록 기능', '하루동안' should be corrected to '하루 동안' with a space.
  • Reason this comment was not posted:
    Comment was on unchanged code.
6. README.md:123
  • Draft comment:
    Typographical error: There is a missing space after the period in the sentence "...건강한 경쟁을 유도한다.단순한 경쟁이 아닌...". Please insert a space after the period.
  • Reason this comment was not posted:
    Comment was on unchanged code.

Workflow ID: wflow_P6Mga1Yj1iGU8UEQ

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@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: 2

♻️ Duplicate comments (1)
README.md (1)

427-427: 교차 참조 번호 오기: 메인 페이지는 3.2.6입니다 (3.2.5 → 3.2.6).

이전 리뷰에서도 지적된 동일 이슈로, 내비게이션·뒤로가기 안내의 교차 참조 번호가 잘못되어 있습니다. 독자가 섹션을 찾지 못할 수 있으니 즉시 정정 권장합니다.

다음 수정안을 적용해 주세요:

-    - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.5)로 이동한다.
+    - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.6)로 이동한다.
- - 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+ - 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.
- - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+ - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.

Also applies to: 456-456, 466-466

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

167-169: 테이블 전후 공백 라인 추가(MD058): 표 주변에 빈 줄이 필요합니다.

표가 인접 문단과 붙어 있어 마크다운 렌더러에 따라 깨질 수 있습니다. 표 앞뒤에 빈 줄을 한 줄씩 추가하세요.

예시 패치:

-166
-167 |                                본 앱에는 ‘프리미엄 구독 시스템’이 존재합니다.<br>위와 같은 유료 서비스 및 혜택을 위해 돈을 최대 얼마까지 지불할 의향이 있으신가요?<br>(한 달 기준으로 선택해 주세요.)                                |
+166
+
+167 |                                본 앱에는 ‘프리미엄 구독 시스템’이 존재합니다.<br>위와 같은 유료 서비스 및 혜택을 위해 돈을 최대 얼마까지 지불할 의향이 있으신가요?<br>(한 달 기준으로 선택해 주세요.)                                |
 168 |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
 169 | <img width="501" height="394" alt="건강_소통_앱_온기_설문조사 xlsx" src="https://github.com/user-attachments/assets/f879fd05-ccdf-465b-8987-2ee5548f9d58" /> |
-170 > 설문조사를 바탕으로 분석한 결과, 1,900~3,400원 사이의 금액으로 책정하는 것이 좋다는 결론이 도출되었다. 따라서 본 앱의 유료 서비스 가격을 2,900원으로 결정하였다.
+170
+> 설문조사를 바탕으로 분석한 결과, 1,900~3,400원 사이의 금액으로 책정하는 것이 좋다는 결론이 도출되었다. 따라서 본 앱의 유료 서비스 가격을 2,900원으로 결정하였다.
-210 #### 핵심 기능 선호도
-211 | 순위 | 기능            | 선호 비율   |
+210 #### 핵심 기능 선호도
+
+211 | 순위 | 기능            | 선호 비율   |
 212 |----|---------------|---------|
 213 | 1  | 부모 건강 모니터링 기능 | **32%** |
 214 | 2  | 부모 건강 관리 기능   | **31%** |
 215 | 3  | 가족 간 건강 소통 기능 | **27%** |
 216 | 4  | 가족 공동 참여 기능   | **21%** |
-217
+217

Also applies to: 211-217


338-340: 목록 들여쓰기 불일치(MD007): 일부 항목이 4칸 들여쓰기입니다. 2칸 규칙으로 통일하세요.

여러 구간에서 하위 목록이 아닌데 과도하게 들여쓰기 되어 있습니다. 대표 구간만 예시로 패치 제안드립니다.

-    - CodeRabbit
-    - Jira
+  - CodeRabbit
+  - Jira
-    - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
-    - 정보가 일치하고 해당 사용자가 부모인 경우, 부모 랜딩 페이지(3.2.4)로 이동한다.
-    - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.6)로 이동한다.
-    - 정보가 일치하지 않는다면, 경고 문구가 화면 하단에 표시된다.
+  - 비밀번호 입력 필드에 비밀번호를 입력하고 **로그인 버튼**을 클릭하면, 이메일과 비밀번호가 동일한 사용자의 정보인지 확인한다.
+  - 정보가 일치하고 해당 사용자가 부모인 경우, 부모 랜딩 페이지(3.2.4)로 이동한다.
+  - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.6)로 이동한다.
+  - 정보가 일치하지 않는다면, 경고 문구가 화면 하단에 표시된다.

같은 방식으로 지적 라인들에 2칸 들여쓰기로 정렬하면 markdownlint 경고가 사라집니다.

Also applies to: 425-428, 492-492, 498-498, 510-510, 536-536, 538-538, 565-565, 650-650


305-305: 장/절 제목 표기 형식 통일

일부 제목은 숫자 뒤 공백·마침표 사용이 불일치합니다. “N.M. 제목” 형태로 통일 권장합니다.

-## 2.상세설계
+## 2. 상세 설계
-### 7.2 향후 활용 방안 및 비즈니스 모델
+### 7.2. 향후 활용 방안 및 비즈니스 모델

Also applies to: 1001-1001


437-444: 용어 통일: ‘네비게이션’ → ‘내비게이션’

국립국어원 표기 기준에 맞춰 ‘내비게이션’으로 통일하면 문서 일관성이 좋아집니다. 표·설명·레이블 전반에 일괄 적용을 권장합니다.

예:

  • “네비게이션 바” → “내비게이션 바”
  • 표 라벨/설명 내 동일 교정

Also applies to: 756-757, 631-647


567-568: 줄바꿈으로 괄호가 끊겨 가독성 저하

“페이지(3.2.17)” 부분이 줄바꿈으로 분리되어 읽기 흐름이 끊깁니다. 동일 행에 배치해 주세요.

-  ‘마음기록을 업로드 해볼까요?’ 라는 텍스트 및 **사각형 버튼**이 표시되고, 이를 클릭하면 마음 기록 입력 페이지(
-  3.2.17)로 이동한다.
+  ‘마음기록을 업로드 해볼까요?’ 라는 텍스트 및 **사각형 버튼**이 표시되고, 이를 클릭하면 마음 기록 입력 페이지(3.2.17)로 이동한다.

958-960: 테스트 기간 표기 명확화(연도·기간 일관성)

날짜 범위에 연도가 누락되어 있고 “6일 간” 표현이 포함/제외 여부가 불명확합니다. 독자의 혼동을 막기 위해 연도 표기 및 (포함/제외) 기준을 명시해 주세요.

예시:

  • “테스트 기간: 2025-08-11(월) ~ 2025-08-17(일), 7일간(양 끝일 포함)” 또는
  • “테스트 기간: 2025-08-11(월) ~ 2025-08-17(일), 6일간(양 끝일 중 마지막 날 제외)”

909-912: 외부 배지/QR 링크 접근성 보강

이미지 링크에 대체 텍스트가 축약되어 있어 스크린 리더 사용자에 불친절할 수 있습니다. 버튼 목적을 명확히 적어 주세요.

-| [<img height="50" alt="image" src=".../f0142e99-...png" />](https://testflight.apple.com/join/ywaeumFn)
+| [<img height="50" alt="iOS TestFlight로 온기 설치" src=".../f0142e99-...png" />](https://testflight.apple.com/join/ywaeumFn)

동일 방식으로 Google Play, APK 링크에도 적용 권장.


788-791: 이미지 캡션 마크업 표준화

캡션을 대괄호 텍스트로만 표기하기보다, figcaption 또는 캡션 텍스트를 일반 문장으로 표 아래/위에 배치하면 시맨틱·접근성이 개선됩니다.

예:

  • 표 아래에 “화면 1. 가족 만보기 랭킹 시스템 화면 / 화면 2. 카카오톡 건강 분석 리포트 공유” 형태로 서술 추가

156-165: 가격/과금 서술의 출처 연결 강화

본문에 2,900원 가격 결정 근거(설문조사)와 수익 구조가 서술되어 있으므로, 설문 섹션(1.3)으로의 내부 링크(anchor) 또는 별도 문서 링크를 추가하면 독해 흐름이 좋아집니다.

예:

  • “(자세한 근거: 1.3. 타겟 사용자 분석 → 주요 조사 결과)”에 내부 링크 추가

Also applies to: 1026-1031

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between bb652fb and db4c273.

📒 Files selected for processing (1)
  • README.md (30 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

169-169: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


211-211: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


338-338: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


339-339: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


425-425: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


426-426: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


427-427: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


428-428: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


492-492: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


498-498: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


510-510: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


536-536: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


538-538: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


565-565: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


650-650: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


717-717: Table column count
Expected: 3; Actual: 4; Too many cells, extra data will be missing

(MD056, table-column-count)

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed a439ab2 in 1 minute and 7 seconds. Click for details.
  • Reviewed 47 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 5 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:6
  • Draft comment:
    Consider adding a Table of Contents for easier navigation in this very long document.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
2. README.md:125
  • Draft comment:
    Avoid mixing HTML
    tags with Markdown syntax; use Markdown line breaks or separate paragraphs for consistency.
  • Reason this comment was not posted:
    Comment was on unchanged code.
3. README.md:122
  • Draft comment:
    Add a space after the period for better readability (e.g., '경쟁을 유도한다.단순한 경쟁' should be '경쟁을 유도한다. 단순한 경쟁').
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
4. README.md:26
  • Draft comment:
    Consider splitting the overly detailed sections or using collapsible subsections to improve readability.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
5. README.md:3
  • Draft comment:
    Enhance image alt texts for accessibility; use descriptive phrases instead of generic terms.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.

Workflow ID: wflow_o76QHfQ9etQ8FE4N

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed c034cba in 1 minute and 15 seconds. Click for details.
  • Reviewed 45 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 8 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:282
  • Draft comment:
    Typo in section heading: "사회적가지 도입 계획" – likely meant to be "사회적 가치 도입 계획".
  • Reason this comment was not posted:
    Comment was on unchanged code.
2. README.md:277
  • Draft comment:
    Typo: "디지털 취약계능" should likely be "디지털 취약계층" to correctly refer to the target group.
  • Reason this comment was not posted:
    Comment was on unchanged code.
3. README.md:2
  • Draft comment:
    Consider adding a Table of Contents at the beginning to help navigate this long document.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
4. README.md:3
  • Draft comment:
    Improve image alt text descriptions for better accessibility instead of using auto-generated names.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
5. README.md:5
  • Draft comment:
    Consider using standard markdown formatting for line breaks instead of HTML <br/> tags for consistency.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
6. README.md:801
  • Draft comment:
    Specify the language in code block fences (e.g., 'bash' or 'tree') for improved syntax highlighting.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
7. README.md:1
  • Draft comment:
    The README is very lengthy; consider splitting it into modular sections or additional docs for better maintainability.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.
8. README.md:284
  • Draft comment:
    Typographical note: The heading '사회적가지 도입 계획' appears to contain a potential typo. Did you mean '사회적 가치 도입 계획' or '사회적 기여 도입 계획'?
  • Reason this comment was not posted:
    Comment was on unchanged code.

Workflow ID: wflow_lRolUSSJZYQSlnR4

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 7638e64 in 1 minute and 56 seconds. Click for details.
  • Reviewed 20 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 3 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:242
  • Draft comment:
    The header bullet '셀프 건강 관리 시스템, 공유의 부재' was removed—ensure that its removal doesn’t reduce clarity in grouping related points.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% The comment is asking the author to ensure that the removal of a header bullet doesn't reduce clarity. This is a request for confirmation of intention, which violates the rules.
2. README.md:246
  • Draft comment:
    Using an HTML
    tag in the '단방향적 기능의 흐름' bullet may not be ideal in Markdown; consider standard Markdown formatting for line breaks.
  • Reason this comment was not posted:
    Decided after close inspection that this draft comment was likely wrong and/or not actionable: usefulness confidence = 20% vs. threshold = 50% While technically correct that Markdown line breaks are preferred over HTML tags, this is a very minor formatting issue that doesn't affect functionality or readability. The current format works fine and is consistent with other parts of the document. Making this change would provide minimal value. The comment is technically accurate - using Markdown formatting is generally preferred over HTML tags when possible. And consistency in formatting can be important for maintainability. However, this is an extremely minor formatting issue that works fine as-is. The current format is readable and functional. Making this change would provide very little value while creating unnecessary work. This comment should be deleted as it suggests a very minor formatting change that provides minimal value and creates unnecessary work.
3. README.md:251
  • Draft comment:
    Typographical issue: "젋은 세대" should likely be "젊은 세대" as per standard Korean spelling.
  • Reason this comment was not posted:
    Comment was not on a location in the diff, so it can't be submitted as a review comment.

Workflow ID: wflow_dGdKxGKIVIfjeeGk

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed e9407fe in 55 seconds. Click for details.
  • Reviewed 13 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:429
  • Draft comment:
    Remove the extra leading whitespace before the comment for consistent formatting.
  • Reason this comment was not posted:
    Comment looked like it was already resolved.

Workflow ID: wflow_BbSEazwap3sbLagJ

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 83f514c in 47 seconds. Click for details.
  • Reviewed 13 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 1 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:1000
  • Draft comment:
    Added period after '7.2' to maintain consistent section numbering.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative, as it only states that a period was added for consistency in section numbering. It does not provide any actionable feedback or suggestions for improvement.

Workflow ID: wflow_J0Ao8uP69gbQpIRQ

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 009d419 in 1 minute and 2 seconds. Click for details.
  • Reviewed 40 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 6 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. README.md:102
  • Draft comment:
    Improved clarity: changed '시각' to '시각화' for clearer description.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
2. README.md:145
  • Draft comment:
    Grammar fix: Added subject marker for better phrasing in the reminder feature.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
3. README.md:248
  • Draft comment:
    Typo corrected: '젋은 세대' changed to '젊은 세대'.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
4. README.md:301
  • Draft comment:
    Consistent formatting: Added space after '2.' in the section header.
  • Reason this comment was not posted:
    Confidence changes required: 0% <= threshold 50% None
5. README.md:148
  • Draft comment:
    Typographical improvement: The addition of the particle ‘를’ in “앱 접속 빈도를 증가시킬 수 있다” corrects the grammar. Nice fix!
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative, as it only praises a typographical improvement without suggesting any changes or asking for clarification. It does not provide any actionable feedback or raise any concerns about the code.
6. README.md:251
  • Draft comment:
    Typographical correction: The original "젋은 세대" has been updated to "젊은 세대". Please ensure that this change was intentional for clarity.
  • Reason this comment was not posted:
    Comment looked like it was already resolved.

Workflow ID: wflow_RJ9Dmv0oo71z4eNl

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

@Neibce Neibce merged commit 17a3855 into main Aug 25, 2025
3 checks passed
Copy link

@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: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

960-962: 테스트 기간 날짜·요일 및 기간 일수 수정 필수

아래 위치의 날짜·요일 정보와 기간 일수가 실제와 불일치하여 혼동을 유발합니다. 반드시 아래와 같이 절대 날짜·요일 표기 및 일수 산정 근거를 명확히 수정해 주세요.

  • 파일: README.md
    라인: 960–962
- **테스트 기간**: 8/11(화) - 8/17(일) ; 6일 간 진행되었다.
+ **테스트 기간**: 2025년 8월 11일(월) ~ 2025년 8월 17일(일); 7일간 진행
+  - 산정 기준: 시작일 및 종료일 포함
♻️ Duplicate comments (8)
README.md (8)

759-759: 오탈자 및 띄어쓰기: ‘떄’→‘때’, ‘블러처리’→‘블러 처리’

사용자 노출 텍스트로 즉시 교정 권장합니다. (기존 동일 이슈)

-| 5      | 세부 페이지 2        | 내가 마음 기록을 남기지 않았을 떄<br>- 다른 가족이 남긴 기록이 블러처리됨<br>- 내가 기록을 남겨야 다른 가족의 기록을 볼 수 있음 |
+| 5      | 세부 페이지 2        | 내가 마음 기록을 남기지 않았을 때<br>- 다른 가족이 남긴 기록이 블러 처리됨<br>- 내가 기록을 남겨야 다른 가족의 기록을 볼 수 있음 |

789-792: 이미지 캡션/표 레이아웃: 표준 마크다운 이미지 문법으로 간결화

현재 HTML + 표 조합입니다. 동일 너비 제어가 꼭 필요하지 않다면 표준 마크다운 이미지 문법으로 간소화하면 가독성과 유지보수성이 좋아집니다. 과거 리뷰에서 지적된 비표준 문법 교체의 연장선입니다.

대안 예:

![화면 1 가족 만보기 랭킹 시스템 화면](<url1>) | ![화면 2 카카오톡 건강 분석 리포트 공유](<url2>)

424-424: 교차 참조 번호 오기: 메인 페이지 섹션은 3.2.6입니다

아래 교차 참조가 잘못되어 있습니다. 메인 페이지 헤딩은 3.2.6이므로 번호를 정정해 주세요. 기존 리뷰에서도 동일 지적이 있었던 항목입니다.

-    - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.5)로 이동한다.
+    - 정보가 일치하고 해당 사용자가 자녀인 경우, 메인 페이지(3.2.6)로 이동한다.
- - 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+ - 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.
- - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.5)로 이동한다.
+ - 화면 좌측 상단에 있는 **뒤로 가기 버튼**을 클릭하면 메인 페이지(3.2.6)로 이동한다.

Also applies to: 453-453, 463-463


716-716: 테이블 열 개수 불일치(MD056) — 마지막 파이프 제거 필요

해당 행이 4열로 파싱되어 렌더링이 깨집니다. 마지막 공백 셀을 제거하세요. 과거 동일 이슈였습니다.

-| 2      | 걸음 수 확인 | - 우리 가족들의 걸음 수 확인 가능<br>- 1등에게 왕관 표시 |                   |
+| 2      | 걸음 수 확인 | - 우리 가족들의 걸음 수 확인 가능<br>- 1등에게 왕관 표시 |

276-277: 오탈자: ‘디지털 취약계능’ → ‘디지털 취약계층’

사용자 노출 문서의 오탈자입니다. 신뢰도 관점에서 즉시 교정 권장합니다. 과거에도 지적된 항목입니다.

-    - 부모의 위치로 가입하는 사용자는 디지털 취약계능일 가능성이 높다고 판단하여 큰 글자, 큰 기록 버튼, 최소 터치 플로우 등을 통해 인지적 부담을 낮춘 입력 방식을
+    - 부모의 위치로 가입하는 사용자는 디지털 취약계층일 가능성이 높다고 판단하여 큰 글자, 큰 기록 버튼, 최소 터치 플로우 등을 통해 인지적 부담을 낮춘 입력 방식을

282-282: 오탈자: ‘사회적가지’ → ‘사회적 가치’

섹션 제목의 철자 오류입니다. 이전 리뷰와 동일 맥락의 오탈자 교정입니다.

-### 1.5. 사회적가지 도입 계획
+### 1.5. 사회적 가치 도입 계획

678-678: 붙임표기 교정: ‘재확인 할’ → ‘재확인할’

맞춤법/띄어쓰기 교정이 필요합니다. (과거 동일 지적)

-    - 선택된 부위를 재확인 할 수 있음
+    - 선택된 부위를 재확인할 수 있음

509-509: 굵게 처리 범위 오류 — 버튼 텍스트만 굵게

굵게 처리 범위가 어색합니다. 버튼 텍스트만 굵게 유지해 주세요. (이전 리뷰와 유사 지적)

-- 이후 **등록하기** **버튼**을 클릭하면 약 복용 일정 추가 팝업 화면으로 이동한다.
+- 이후 **등록하기 버튼**을 클릭하면 약 복용 일정 추가 팝업 화면으로 이동한다.
🧹 Nitpick comments (12)
README.md (12)

576-576: 수평선 스타일(MD035) — 공백 제거

수평선 뒤 공백으로 규칙 위반이 발생합니다. 공백을 제거해 주세요.

---- 
+---

166-168: 테이블 전후 공백(MD058) — 표 주변에 빈 줄 추가

마크다운 표는 앞뒤로 빈 줄이 필요합니다. 아래 구간에 빈 줄을 추가해 주세요.

Also applies to: 209-216


174-175: 어휘 선택 교정: ‘부담감을 던다’ → ‘부담감을 덜다’

문맥상 ‘덜다’가 자연스럽습니다.

-  조직과 리퍼럴 수수료, 공동 마케팅 비용을 분담해 비용적 부담감을 던다.
+  조직과 리퍼럴 수수료, 공동 마케팅 비용을 분담해 비용적 부담감을 덜다.

458-458: 단위 표기 통일: °C vs ℃ 혼용

문서 전반에서 온도 단위가 ‘℃’와 ‘°C’로 혼용됩니다. 한 가지로 통일하세요. 아래 예시는 ‘°C’로 통일하는 수정안입니다.

-  → 기본 온도 36.5℃를 제외한 **실제 사용 가능 온도** 표시
+  → 기본 온도 36.5°C를 제외한 **실제 사용 가능 온도** 표시
-| 4      | 리워드 교환에 사용 가능한 온도 표시 | 사용 가능한 온도<br>- 가족 온도 지수에서 기본 온도 36.5°C를 뺀 값                                      |                                                                                                 
+| 4      | 리워드 교환에 사용 가능한 온도 표시 | 사용 가능한 온도<br>- 가족 온도 지수에서 기본 온도 36.5°C를 뺀 값                                      |

Also applies to: 635-635


95-107: 목록 들여쓰기(MD007) — 하위 목록 2칸 들여쓰기로 정렬

여러 군데서 하위 목록의 들여쓰기(스페이스)가 4칸으로 감지되어 규칙 위반이 납니다. 전체적으로 하위 목록은 2칸 들여쓰기로 맞춰 주세요. 아래는 대표 구간 예시입니다.

예시(대표 구간 95~107):

-- 부모 세대
-    - 직관적이고 단순한 디자인으로 **사용이 쉬운 화면 구성**
+- 부모 세대
+  - 직관적이고 단순한 디자인으로 **사용이 쉬운 화면 구성**

유사 패턴을 337, 422425, 489, 495, 507, 533535, 649 등에도 적용해 주세요.

Also applies to: 337-337, 422-425, 489-489, 495-495, 507-507, 533-535, 649-649


911-914: 배포 섹션 보강 제안: QR/외부 APK 링크의 신뢰성 안내

외부 도메인(APK 직접 링크)와 QR 이미지를 제공하는 경우, 사용자 신뢰를 위해 서명 방식(예: Play/App Store 배포 또는 코드서명), 체크섬(SHA-256), 그리고 최신 버전 안내를 함께 표기하는 것을 권장합니다.

추가 문구 예:

  • “APK는 릴리스 서명되어 있으며, 해시: SHA-256 xxxxx...로 검증 가능합니다. 스토어 버전과 동일한 빌드입니다.”
  • “안전한 설치를 위해 가급적 스토어 경로 사용을 권장합니다.”

240-267: 용어/표현 일관성: ‘만보기/걸음 수’, ‘네비게이션/내비게이션’ 등 통일

  • 문서 내 ‘만보기’ vs ‘걸음 수’가 혼재합니다. 사용자 지향 용어로 하나로 통일(예: ‘걸음 수’)을 권장합니다.
  • ‘네비게이션 바’ vs ‘내비게이션 바’도 표준 표기 하나로 통일 권장.

원한다면 전역 치환 후보 목록을 드리겠습니다.

Also applies to: 268-274


487-490: 접근 제어/가시성 규칙의 예외 케이스 명시 필요

  • 자녀가 여러 명인 경우 부모 선택 드롭다운의 기본 선택/권한 범위(읽기 전용 vs 수정 가능)를 명시하면 흐름 이해가 좋아집니다.
  • 마음 기록 가시성(업로드 여부에 따른 블러 처리)에 관리자/부모 예외, 신고/차단 등 안전장치가 있는지 간략 문구 추가 권장.

Also applies to: 553-566


1003-1040: 개인정보 보호/보안 섹션 보강 제안

건강/감정 데이터는 민감 정보입니다. 암호화, 데이터 보존/삭제 정책, 동의/철회, 제3자 공유(카카오톡 리포트) 시 개인정보 처리 방침 준수 등을 별도 하위 섹션으로 명시해 주세요.

추가 섹션 예시:

### 7.3. 개인정보 보호 및 보안
- 데이터 암호화: 전송(TLS) 및 저장 시(예: AES-256) 암호화
- 접근 제어: 역할 기반 접근 제어(RBAC), 가족 단위 권한 분리
- 보존 정책: 사진/건강기록 보존 기간 및 삭제(영구 삭제) 절차
- 동의/철회: 데이터 수집·이용·제3자 공유에 대한 동의 및 철회 UI
- 로그/감사: 민감 데이터 접근에 대한 감사 로그

182-186: 조사 기간 표현 구체화

“약 7일간”은 모호합니다. 시작/종료일을 포함해 정확한 종료일을 병기해 주세요.

-### 조사 개요
-- **조사 기간**: 2025년 8월 2일 ~ 약 7일간
+### 조사 개요
+- **조사 기간**: 2025년 8월 2일 ~ 8월 8일 (7일간, 시작/종료일 포함)

911-914: QR 이미지 대체 텍스트/링크 텍스트 보강(접근성)

이미지 안에만 의미가 담기면 스크린리더 접근성이 떨어집니다. 링크 텍스트에 플랫폼명을 명시하거나 alt를 더 서술적으로 바꿔 주세요.

-| [<img height="50" alt="image" src=".../appstore.png" />](...)
+| [iOS(TestFlight)로 설치](https://testflight.apple.com/join/ywaeumFn)

또는 alt를 “iOS용 TestFlight 설치 배지”처럼 구체화.


318-338: 문서·실제 설정 버전 불일치 검증 자동화 제안

README.md의 기술 스택(Flutter 3.35.1, Spring Boot 3.5.3, MySQL 8.4.6 등)과 실제 프로젝트 설정 파일 간에 다음과 같은 불일치가 확인되었습니다. 이를 릴리스 단계에서 자동으로 검증하거나, GitHub Actions 등 CI 워크플로우에 스크립트를 추가해 동기화를 보장할 것을 권장드립니다.

  • README.md (2.2. 사용 기술)
    • Flutter 3.35.1 vs. pubspec.yaml의 Dart SDK ^3.8.1 (Flutter 버전 정보 미표기)
    • fastlane 버전 미기재
  • Android 모듈 (frontend/ongi/android/app/build.gradle.kts)
    • sourceCompatibility/targetCompatibility는 Java 11으로 설정됐으나, minSdk/targetSdk 버전, Gradle 플러그인 버전(com.android.tools.build) 정보 미검출
  • iOS 프로젝트 (ios/Podfile 미발견)
    platform :ios, use_frameworks! 등 Podspec 정보가 없음
  • Backend (backend/ongi/build.gradle)
    org.springframework.boot 플러그인 버전(3.5.3) 및 Java toolchain 설정 확인 권장
    • MySQL 커넥터 존재 여부만 확인(버전 미표기)
  • Firebase 설정 파일
    • android/app/google-services.json 없음
    • ios/Runner/GoogleService-Info.plist 없음

위 항목들을 문서에 반영하거나, 아래처럼 주요 설정 파일에서 버전·키워드를 추출해 README.md 내용과 비교하는 스크립트를 CI에 통합해 자동 검증할 것을 제안드립니다.

#!/bin/bash
# 루트에서 실행: pubspec.yaml, build.gradle*, Podfile, Firebase 설정 파일 등 버전·존재 여부 검증

set -euo pipefail

echo "== Flutter/Dart 설정 확인 =="
rg -nP 'environment:\s*\n.*sdk:\s*\^?\d+\.\d+\.\d+' pubspec.yaml

echo "== Android Gradle 설정 확인 =="
rg -nP 'id\s*\(?["'\'']com\.android\.application["'\'']\s*version\s*["'\'']\d+\.\d+\.\d+' frontend/ongi/android/*.gradle* || true
rg -nP 'compileSdkVersion|minSdkVersion|targetSdkVersion' frontend/ongi/android/app/build.gradle.kts || true

echo "== iOS Podspec 확인 =="
if [ -f ios/Podfile ]; then rg -n 'platform :ios|use_frameworks!' ios/Podfile; else echo "Podfile 없음"; fi

echo "== Spring Boot/Java/MySQL 버전 확인 =="
rg -nP 'id\s*["'\'']org\.springframework\.boot["'\'']\s*version\s*["'\'']\d+\.\d+\.\d+' backend/ongi/build.gradle
rg -nP 'java\.sourceCompatibility|java\.targetCompatibility' backend/ongi/build.gradle

echo "== Firebase 설정 파일 존재 여부 =="
[ -f android/app/google-services.json ] && echo "google-services.json 있음" || echo "google-services.json 없음"
[ -f ios/Runner/GoogleService-Info.plist ] && echo "GoogleService-Info.plist 있음" || echo "GoogleService-Info.plist 없음"

Optional: 위 스크립트를 GitHub Actions 워크플로우에 추가해 PR 단계에서 자동 실패(fail) 처리하도록 설정하면, 문서·설정 간 버전 미스매치를 사전에 방지할 수 있습니다.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between db4c273 and 009d419.

📒 Files selected for processing (1)
  • README.md (35 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

105-105: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


106-106: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


107-107: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


168-168: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


210-210: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


249-249: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


250-250: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


251-251: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


337-337: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


422-422: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


423-423: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


424-424: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


425-425: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


489-489: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


495-495: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


507-507: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


533-533: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


535-535: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


562-562: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


576-576: Horizontal rule style
Expected: ---; Actual: ---

(MD035, hr-style)


649-649: Unordered list indentation
Expected: 2; Actual: 4

(MD007, ul-indent)


716-716: Table column count
Expected: 3; Actual: 4; Too many cells, extra data will be missing

(MD056, table-column-count)

@Neibce Neibce deleted the docs/readme branch August 25, 2025 10:51
Neibce added a commit to 2025-PNU-SW-Hackathon/PNUSW-2025-OnGi-10 that referenced this pull request Aug 25, 2025
* docs: 리드미 초안 작성 중...

* 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...

* docs: 리드미 초안 작성 중...
This was referenced Aug 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant