Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs/#179 리드미 추가 #180

Merged
merged 11 commits into from
Feb 3, 2025
Merged

docs/#179 리드미 추가 #180

merged 11 commits into from
Feb 3, 2025

Conversation

LeeHanEum
Copy link
Member

@LeeHanEum LeeHanEum commented Feb 1, 2025

Summary

레포지토리 리드미 파일을 작성하였습니다.

Tasks

  • 서비스 개요 작성
  • 코드 컨트리뷰터 작성
  • 시스템 아키텍처 다이어그램 작성
  • 애플리케이션 아키텍처 다이어그램 작성
  • 프로젝트 구조 (마크다운) 작성
  • 라이선스 작성

@Copilot Copilot bot review requested due to automatic review settings February 1, 2025 05:36
@LeeHanEum LeeHanEum linked an issue Feb 1, 2025 that may be closed by this pull request
6 tasks

Choose a reason for hiding this comment

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

Copilot reviewed 1 out of 1 changed files in this pull request and generated no comments.

@LeeHanEum LeeHanEum marked this pull request as draft February 1, 2025 05:36
Copy link
Contributor

coderabbitai bot commented Feb 1, 2025

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

프로젝트에 새로운 MIT 라이선스가 추가되어 2025년 KGU Developers의 저작권 고지를 포함하며, 소프트웨어의 사용, 복사, 수정, 병합, 배포 등에 관한 조건과 면책 조항이 명시되었습니다. 또한 README.md에 프로젝트 개요, 기여자, 시스템 아키텍처, 애플리케이션 아키텍처, 프로젝트 구조 및 라이선스 정보를 상세히 설명하는 여러 신규 섹션이 추가되었습니다.

Changes

파일 변경 요약
LICENSE 새로운 MIT 라이선스 추가 (2025년 KGU Developers 저작권 고지 포함)
README.md 신규 섹션 추가: About, Contributors, System Architecture, Application Architecture, Project Structure, License

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ 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.
    • Generate unit testing code for this file.
    • 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. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • 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 src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

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

Documentation and Community

  • 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.

@LeeHanEum LeeHanEum requested a review from a team February 1, 2025 05:36
@LeeHanEum LeeHanEum added the ✨feature create new feature label Feb 1, 2025
Copy link

github-actions bot commented Feb 1, 2025

Test Coverage Report

Overall Project 95.72% 🍏

There is no coverage information present for the Files changed

Copy link

codecov bot commented Feb 1, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Impacted file tree graph

@@            Coverage Diff             @@
##             develop     #180   +/-   ##
==========================================
  Coverage      93.29%   93.29%           
  Complexity       134      134           
==========================================
  Files             49       49           
  Lines            388      388           
  Branches           4        4           
==========================================
  Hits             362      362           
  Misses            21       21           
  Partials           5        5           

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 817badb...13d5d6d. Read the comment docs.

@LeeShinHaeng
Copy link
Contributor

컨트리뷰터, 프로젝트 구조 추가 작업 시작하겠습니다!

@LeeHanEum
Copy link
Member Author

컨트리뷰터, 프로젝트 구조 추가 작업 시작하겠습니다!

좋습니다. Auth 모듈 분리를 가정하고 작업 진행해주세요~

@LeeShinHaeng
Copy link
Contributor

우선 초안으로 프로젝트 구조의 큰 그림을 추가했습니다.
auth 모듈의 경우 분리하는 것을 가정하고 따로 표시했습니다!
고치거나 추가할 부분이 있다면 편하게 말씀해주세요 😀

@LeeHanEum LeeHanEum marked this pull request as ready for review February 2, 2025 16:17
Copy link
Contributor

@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

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

7-12: 주석 처리된 개선 포인트 검토
HTML 주석 내에 개발 완료 후 추가할 내용을 기재해두셨습니다.
향후 해당 내용의 공개 여부나 별도 문서화 여부를 결정할 때, 주석 대신 별도의 “개발 노트” 섹션으로 정리하는 방안을 고려해보세요.


97-119: Domain Module Detail Structure 섹션 개선

  • 코드 블록 시작 시 언어 태그(e.g., ```plaintext)를 추가해서 markdownlint(MD040) 경고를 방지할 것을 권장합니다.
  • 전반적으로 디렉터리 구조와 각 폴더의 역할이 명확하게 설명되어 있습니다.
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

99-99: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 817badb and 57e4d76.

⛔ Files ignored due to path filters (2)
  • images/application_architecture.png is excluded by !**/*.png
  • images/system_architecture.png is excluded by !**/*.png
📒 Files selected for processing (2)
  • LICENSE (1 hunks)
  • README.md (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • LICENSE
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

47-47: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)


82-82: Multiple spaces after hash on atx style heading
null

(MD019, no-multiple-space-atx)


84-84: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)


99-99: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)

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

1-2: About 섹션 제목 확인
"## 👋🏻 About" 섹션 제목이 명확하게 추가되어 있어 문서의 시작 부분을 잘 안내합니다.


3-6: 프로젝트 소개 문구 점검
경기대학교 AI컴퓨터공학부 서버 레포지토리의 목적과 주체가 명확하게 설명되어 있습니다. 필요에 따라 향후 시각적 요소(로고 등)를 추가하는 것도 고려해볼 만합니다.


13-13: 서버 API와 프론트엔드 연계 정보
서버 API 개발 역할과 프론트엔드 레포지토리 링크가 포함되어 있어, 프로젝트 전체 구성이 잘 설명되고 있습니다.


15-21: 기여자 섹션 구성 확인
기여자 정보를 표 형식으로 깔끔하게 정리하여, 각 기여자의 프로필과 역할이 한눈에 들어옵니다.


22-34: 시스템 아키텍처 섹션 점검
시스템의 운영 환경, 모듈 분리, 모니터링 및 로깅 등의 구성 요소를 명확하게 기술하였고, 관련 이미지도 포함되어 있어 이해하기 쉽습니다.


35-42: 애플리케이션 아키텍처 섹션 확인
이미지를 통한 시각적 설명과 함께 멀티 모듈 아키텍처의 장점을 잘 기술하였습니다.


120-121: 라이선스 섹션 확인
MIT 라이선스 조건과 LICENSE 파일에 대한 링크를 명확하게 제공하여, 사용자가 라이선스 정보를 쉽게 확인할 수 있습니다.


43-81: 🛠️ Refactor suggestion

프로젝트 구조 섹션 및 코드 블록 개선 필요

  • 프로젝트의 디렉터리 구조가 명확하게 제시되어 있어 이해하기 쉽습니다.
  • 제안: 코드 블록 시작 시 언어 태그(예: ```plaintext)를 추가하여 markdownlint의 MD040 경고를 해소하고, 가독성을 높일 수 있습니다.
  • 주의: 여러 위치에서 "buid.gradle"로 표기된 부분이 보입니다. 일반적으로는 "build.gradle"이 맞으므로 오타인지 확인해보시기 바랍니다.
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

47-47: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)


82-96: API Module Detail Structure 섹션 개선

  • 헤딩 "### API Module Detail Structure"에서 해시(#) 다음 공백이 과도하게 사용되었습니다. 단일 공백을 사용하여 MD019 규칙을 준수해 주세요.
  • 코드 블록에도 언어 태그(e.g., ```plaintext)를 추가하여, 문서의 markdown 포맷 경고(MD040)를 해결할 수 있습니다.
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

82-82: Multiple spaces after hash on atx style heading
null

(MD019, no-multiple-space-atx)


84-84: Fenced code blocks should have a language specified
null

(MD040, fenced-code-language)

Copy link
Contributor

@LeeShinHaeng LeeShinHaeng left a comment

Choose a reason for hiding this comment

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

LGTM 👍

@LeeHanEum LeeHanEum merged commit 6bf4d2e into develop Feb 3, 2025
2 of 3 checks passed
@LeeHanEum LeeHanEum deleted the docs/#179-readme branch February 3, 2025 05:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
✨feature create new feature
Projects
None yet
Development

Successfully merging this pull request may close these issues.

레포지토리 리드미 파일 작성
3 participants