[hyun030514]

📋 PR 타입

• feature — 새로운 기능 추가
• fix — 버그 수정
• style — 코드 스타일 수정 (로직 변경 없음)
• refactor — 리팩토링
• docs — 문서 수정
• test — 테스트 코드
• design — UI/UX 변경
• chore — 설정/빌드 작업
• merge

---

🗂 작업 영역

• 워크벤치 — 회의 · 캡처 · AI검토 · 회의실
• 업무 — 보드 · 액션 · 프로젝트 · 인수인계
• 조직 — 역할별 대시보드 · 사원/회의실 관리 · 구독
• 공유 셸 · 디자인 시스템
• 공통 · 인프라

---

🙋 관련 역할

• OWNER (대표)
• ADMIN (관리자)
• LEADER (팀장)
• MEMBER (사원)
• SYSTEM (서비스 운영자 — 확장, 데모 제외)
• 공통

---

📝 작업 내용

Closes #598

요약

지연 배지와 진척율에서 저장값·계산값이 흐트러진 자리를 붙인다.

무엇을 왜

① 지연 판정 (FE-14)

• isDelayed(src/constants/action.ts)를 확정 규칙(진행중 && 마감 경과, docs/WORKFLOW.md §7 "진행중 칸 안의 배지")으로 좁힌다. 예전엔 status !== DONE이라 할일 상태의 마감 경과도 지연으로 찍었다. BE ActionSummaryResponse가 이미 확정 규칙을 쓰고 있어 화면과 서버가 다른 값을 만들던 상태를 해소한다.
• 마감 경과 비교를 isPastDue(dueDate, today) 한 함수로 뽑는다. today를 주입 가능하게 두고, isDelayed·isCardDelayed가 이 하나만 부른다 — 자정 계산이 두 벌이면 서버·브라우저 시각이 갈리는 자정 무렵에 목록과 보드가 다른 배지를 단다.
• 보드의 isCardDelayed는 마감 경과만 판정하고 칸 판정은 호출부가 한다(드래그 override를 놓치지 않기 위해 — board-view.tsx의 columnOf(card)가 override를 포함한다).
• 프로젝트 타임라인만 BE 판정을 그대로 옮긴다(ProjectTeamAction.isDelayed ← BeProjectTimelineItem.isDelayed). 지금까지 매퍼에서 조용히 버려지고 있었다 — 화면이 다시 계산하지 않아 자정 경계 어긋남을 피한다.
• PROJECT_TEAM_ACTIONS_MOCK에 isDelayed를 확정 규칙대로 고정한다(전부 false — 목 시점 기준 마감이 지난 진행중 없음).

② 진척율 계약 (FE-15)

• ProjectListItem.actionTotal·actionDone 주석을 "이 프로젝트의 개인 액션(리프) 수"로 정정(WORKFLOW.md §1) — BE-12 후 문서·코드가 다시 어긋나지 않도록.
• BeProjectSummary.progressPct와 toProjectListItem 위에 왜 progressPct를 안 옮기는지 남긴다(FE 반올림 규칙 정본 유지·목 경로도 진척율 필요).
• getProgressPercent 주석에 "여기가 진척율의 유일한 구현"·"BE-12 전에는 분모가 팀 액션까지 세고 있어 FE는 보정하지 않는다"를 명시.

릴리즈 노트 대상 (배지가 사라지는 자리)

할일 + 마감 경과 액션에서 배지가 사라진다 — 예전 규칙(status !== DONE)이 확정 규칙(IN_PROGRESS)으로 좁혀졌기 때문.

• 내 액션 목록 (/app/my/actions)
• 팀 액션 목록 (/team/action, /app/projects/:projectId/team/:teamActionId)
• 마이페이지 대시보드 (/my)
• 팀 액션 상세 타임라인
• 인수인계 액션 목록 (/app/handover/:id)
• 팀장 인수인계 액션 목록 (/owner/leader-handovers/:id)
• 사원 상세 담당 액션 카드 (/manage/members/:id)

프로젝트 타임라인은 BE-13 배포 전까지 예전 동작 유지(BE가 아직 status != DONE 기준).

안 하는 것

• 로컬 계산을 전부 지우고 BE isDelayed만 쓰기 — 목 경로·보드에는 BE 값이 안 온다
• FE에서 팀 액션 보정 계산 — FE는 무엇이 세어졌는지 모른다
• BE 수정(BE-12·BE-13·BE-18)
• 프로젝트 상세에 진척율 새로 추가 — 명세에 없는 항목
• overdue 파라미터로 '지연만 보기' 필터 신설 — 별건
• BeActionSummary.isDelayed를 UI 계약(MyActionListItem 등)에 싣기 — 목 경로도 함께 굴러야 해서 로컬 계산 유지

확인법

• 오늘 이전 마감의 할일 액션: 배지가 사라진다(위 목록)
• 오늘 이전 마감의 진행중 액션: 배지 유지
• 보드 카드를 완료 칸으로 드래그 중 지연 배지가 즉시 사라진다(override 반영)
• Jest: 142 suites · 1482 tests

체크리스트

• npx tsc --noEmit
• npx eslint <바뀐 13파일> --max-warnings=0
• npx jest --silent (142 suites · 1482 tests)
• npx next build

---

✅ 작업 체크리스트

기본

• 브랜치 명명 규칙 준수
• 커밋 컨벤션 준수 (type: 제목 #{이슈번호})
• 아래 Closes # 에 이슈 번호 기입
• 불필요한 console · 주석 처리된 코드 제거
• 민감 정보 없음 (토큰 · 키 · .env)

Z 필수

• 🔐 권한 2축 검사 — 역할 가드 + 리소스 소유권, 그리고 서버에서 재검사
• 🧬 zod — 타입이 스키마에서 파생(z.infer) · 매퍼에 safeParse
• 🕵️ 정직성 — 목 · 미구현 · 폴백이면 주석과 화면에 명시
• 🎨 디자인 토큰 사용 · 다크 값도 정의됨

품질

• ⚡ 최적화
• ♿ a11y
• ♻️ 재사용 확인
• 🧪 loading / error / empty 3상태
• 브라우저 전용 API 사용 시 미지원 · 권한거부 안내 있음

---

🔗 연관 이슈

Closes #598

---

📸 스크린샷 (선택)

Before	After

---

💬 리뷰 포인트

---

📝 추가 메모

[coderabbitai]

Warning

Review limit reached

@hyun030514, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 85425fa9-8361-4f6e-89d9-2336993896fc

📥 Commits

Reviewing files that changed from the base of the PR and between 518da86 and 1cdfa2d.

📒 Files selected for processing (13)

• src/app/(shell)/app/projects/[projectId]/page.tsx
• src/constants/action.test.ts
• src/constants/action.ts
• src/features/board/components/board-view.tsx
• src/features/board/lib.test.ts
• src/features/board/lib.ts
• src/features/member/manage-mapper.ts
• src/features/project/lib.ts
• src/features/project/mapper.test.ts
• src/features/project/mapper.ts
• src/features/project/mock/projects.ts
• src/features/project/mock/team-actions.ts
• src/features/project/types.ts

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[hyun030514]

@coderabbitai full review.

[coderabbitai]

@hyun030514 전체 변경 사항을 다시 검토합니다.

⚠️ Action not completed

Review rate limited.

---

Your included review limit is currently reached under our Fair Usage Limits Policy. This review may still proceed through usage-based billing if eligible. Your next included review will be available in 4 minutes.

[hyun030514]

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[CallmeEterHist]

확인했습니다.