Skip to content

docs: Mandu 상태관리 권장 스택(Query + Zustand) 제안#157

Open
RaptBliss wants to merge 1 commit intomainfrom
docs/state-management-recommendation
Open

docs: Mandu 상태관리 권장 스택(Query + Zustand) 제안#157
RaptBliss wants to merge 1 commit intomainfrom
docs/state-management-recommendation

Conversation

@RaptBliss
Copy link
Collaborator

요약

  • Mandu 상태관리 권장 스택을 제안하는 문서를 추가했습니다.
  • 문서 경로: docs/plans/17_state_management_recommendation.md

핵심 제안

  • 서버 상태: TanStack Query
  • 클라이언트/UI 상태: Zustand
  • 역할 경계와 금지/비권장 패턴을 명확히 정의

포함 내용

  • 배경/문제정의
  • 역할 분리 모델
  • Mandu 아키텍처 정합성
  • 권장 구현 패턴 (Query+UI store, Mutation+Invalidate, SSE sync)
  • 단계별 도입안/ KPI / 리스크 / Exit Criteria

기대 효과

  • 팀 간 상태관리 패턴 표준화
  • SSR + Island + Realtime 조합의 재현성 향상
  • 상태관리 관련 디버깅/운영 비용 절감

@coderabbitai
Copy link

coderabbitai bot commented Feb 17, 2026

Warning

Rate limit exceeded

@konamgil has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 29 minutes and 56 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 4f8a0ae and 9c3532c.

📒 Files selected for processing (1)
  • docs/plans/17_state_management_recommendation.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/state-management-recommendation

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.

@gemini-code-assist
Copy link

Summary of Changes

Hello @RaptBliss, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 Mandu 프로젝트의 상태 관리 전략을 표준화하기 위한 권장 스택 제안 문서를 도입합니다. 서버 상태와 클라이언트/UI 상태를 각각 TanStack Query와 Zustand로 명확히 분리하여, 팀 간의 일관된 개발 패턴을 확립하고, SSR, Island, 실시간 기능과의 정합성을 높이며, 상태 관리 관련 디버깅 및 운영 비용을 절감하는 것을 목표로 합니다.

Highlights

  • Mandu 상태 관리 권장 스택 제안 문서 추가: Mandu 프로젝트의 상태 관리 표준화를 위한 권장 스택 제안 문서를 추가했습니다.
  • 서버 상태 및 클라이언트/UI 상태 스택 정의: 서버 상태 관리는 TanStack Query를, 클라이언트/UI 상태 관리는 Zustand를 사용하도록 명확히 제안합니다.
  • 역할 경계 및 구현 패턴 명시: 서버 상태와 UI 상태의 역할 경계를 정의하고, 금지/비권장 패턴 및 권장 구현 패턴(Query+UI store 결합, Mutation+Invalidation, SSE+Query Sync)을 제시합니다.
  • 단계별 도입 계획 및 기대 효과: 제안된 스택의 단계별 도입안, KPI, 리스크 및 대응 방안, 그리고 정착 기준(Exit Criteria)을 포함하여 구체적인 실행 계획을 설명합니다.
Changelog
  • docs/plans/17_state_management_recommendation.md
    • Mandu 상태 관리 권장 스택 제안 문서가 추가되었습니다.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

Mandu 상태관리 권장 스택 제안 문서는 매우 잘 구성되어 있으며, TanStack Query와 Zustand의 역할을 명확하게 정의하고 Mandu 아키텍처와의 정합성을 잘 설명하고 있습니다. 핵심 원칙, 권장 패턴, 단계별 도입안, KPI, 리스크 및 대응, 그리고 Exit Criteria까지 상세하게 다루고 있어 개발자들이 상태 관리 패턴을 이해하고 적용하는 데 큰 도움이 될 것입니다. 전반적으로 훌륭한 제안서입니다.


## 7) 단계별 도입안

## Phase 0

Choose a reason for hiding this comment

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

medium

  1. 단계별 도입안 섹션 아래의 Phase 0 제목이 ## 레벨로 되어 있어, 주 섹션과 동일한 레벨로 보입니다. 문서의 계층 구조를 명확히 하기 위해 ### (H3) 레벨로 변경하는 것이 좋겠습니다.
Suggested change
## Phase 0
### Phase 0

- `mandu-chat-demo`에 baseline 적용
- query key 규칙 문서화

## Phase 1

Choose a reason for hiding this comment

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

medium

  1. 단계별 도입안 섹션 아래의 Phase 1 제목이 ## 레벨로 되어 있어, 주 섹션과 동일한 레벨로 보입니다. 문서의 계층 구조를 명확히 하기 위해 ### (H3) 레벨로 변경하는 것이 좋겠습니다.
Suggested change
## Phase 1
### Phase 1

- 공통 helper 제공 (`getRouteQueryKey`)
- mutation/invalidation 관례화

## Phase 2

Choose a reason for hiding this comment

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

medium

  1. 단계별 도입안 섹션 아래의 Phase 2 제목이 ## 레벨로 되어 있어, 주 섹션과 동일한 레벨로 보입니다. 문서의 계층 구조를 명확히 하기 위해 ### (H3) 레벨로 변경하는 것이 좋겠습니다.
Suggested change
## Phase 2
### Phase 2

- SSE invalidation helper 도입
- 실시간 시나리오 회귀 테스트 추가

## Phase 3

Choose a reason for hiding this comment

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

medium

  1. 단계별 도입안 섹션 아래의 Phase 3 제목이 ## 레벨로 되어 있어, 주 섹션과 동일한 레벨로 보입니다. 문서의 계층 구조를 명확히 하기 위해 ### (H3) 레벨로 변경하는 것이 좋겠습니다.
Suggested change
## Phase 3
### Phase 3

- 대응: 공식 예제/문서/템플릿 제공

리스크: 역할 경계 혼동
- 대응: "서버 상태 vs UI 상태" 결정표 문서화

Choose a reason for hiding this comment

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

medium

"결정표 문서화"라는 표현은 의미 전달에 문제가 없지만, "결정 가이드 문서 제공" 또는 "결정표 문서 제공"과 같이 '문서' 또는 '가이드'를 제공한다는 의미를 좀 더 명확하게 강조하는 것이 좋을 것 같습니다.

Suggested change
- 대응: "서버 상태 vs UI 상태" 결정표 문서화
- 대응: "서버 상태 vs UI 상태" 결정 가이드 문서 제공

@konamgil konamgil force-pushed the docs/state-management-recommendation branch from 996fb95 to 9c3532c Compare March 3, 2026 04:58
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