Skip to content

feat: BE 10.15 연동 — 새 계획 흐름(기능 명세 → API 계약 → 태스크 나누기) - #59

Merged
jeonbinggu merged 2 commits into
developfrom
feat/be-1015-plan-flow
Oct 16, 2026
Merged

jeonbinggu merged 2 commits into
developfrom
feat/be-1015-plan-flow

Conversation

@jeonbinggu

Copy link
Copy Markdown
Member

🔀 Pull Request Title

feat: BE 10.15 연동 — 새 계획 흐름(기능 명세 → API 계약 → 태스크 나누기)


🎞️ 주요 코드 설명

화면 순서

기능 명세 받기(Room 3) → 확정 → (BE 담당) API 계약 확인(문서 › API 계약) → 태스크 나누기(Room 3) → 확정 → 시작

Room 3 (widgets/pm-room)

  • 입력창은 이제 POST /pm/features. 초안 카드가 kind로 갈린다 — feature면 FeatureBody(요약 · 가정 강조 · 기능별 설명/수용 기준/API 필요 · 오가는 데이터), tasks면 기존 태스크 표(빈 draft.specs 섹션은 숨김)
  • 확정·수정·반려는 기존 Actions 그대로. 확정 안내만 종류별로 다르다
  • TaskSplitStep: 확정된 명세가 있으면 계약 현황(n/m 확정, 미확정 기능 배지)과 "태스크 나누기" 버튼. 미리 막지 않고 서버 409를 안내한다(CONTRACTS_NOT_APPROVED면 details.featureKeys + 계약 링크)
  • 계획을 확정하면 태스크·명세·계약을 같이 다시 읽는다(신호가 늦거나 끊겨도 다음 단계가 바로 보이게)

API 계약 (entities/contract, widgets/docs)

  • Room 3는 대표 전용이라 BE 담당이 볼 수 없다 → 문서의 "계약" 탭(목업)을 실제 GET /projects/{id}/contracts로 바꿔 거기서 확정한다. 사이드바 라벨도 "API 계약"
  • ContractCard: pending(작성 중) · draft(요약 · 정하지 못한 것 · OpenAPI 조각 + 확정/수정 요청) · approved(잠김) · failed(errorReason + 수정 요청). 수정 요청 남은 횟수 노출(3회)
  • 버튼은 프로젝트의 BACKEND 담당(에이전트 주인)에게만, BE 담당이 없으면 대표에게. 판정은 서버(403 NOT_CONTRACT_APPROVER)
  • 실시간 contracts 토픽 → 계약 목록 무효화. pending이 있는 동안만 대비용 폴링

📌 PR 설명

  • 기능 명세 요청 · 초안 카드 · 확정/수정/반려
  • API 계약 화면: 상태별 표시, 확정 · 수정 요청(남은 횟수), 확정 권한
  • 태스크 나누기 + 409 NO_FEATURE_SPECS · CONTRACTS_NOT_APPROVED 안내
  • 명세 문서 needsApi · apiNeeds
  • 시작 422 contracts.F-xx 항목 이름 · 계약 링크
  • 실시간 contracts 토픽, 새 에러 문구

검증: pnpm format:check · lint · typecheck 통과. 계약 모양의 목 서버로 대표 계정 확인 — 기능 명세 요청 → 초안 카드 → 확정 → 다음 단계(계약 0/2) → 태스크 나누기 409(F-01, F-03 안내) → 계약 화면에서 F-01 확정(잠김, 1/2) · F-03 수정 요청(피드백 전송, 작성 중, 회차 +1) → 명세 문서의 API 필요 표시.
확인하지 못한 것: 태스크 나누기 성공 이후 흐름(기존 계획 카드와 같음), 팀원(BE 담당이 아닌 사람) 화면의 버튼 숨김, 실제 BE 노트북의 계약 작성, 실시간 신호.


📷 스크린샷

Room 3 기능 명세 초안 · API 계약 화면 — 코멘트로 첨부 예정


🤖 Generated with Claude Code

@vercel

vercel Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
frontend Ready Ready Preview Oct 16, 2026 5:36am UTC

jeonbinggu and others added 2 commits October 16, 2026 14:34
- Room 3: 지시는 기능 명세 요청(POST /pm/features)으로, 기능 명세 초안 카드(요약 · 가정 · 기능별 설명 · 수용 기준 · API 필요)
- Room 3: 기능 명세가 확정되면 "다음 단계" — 계약 현황 + 태스크 나누기(POST /pm/plans, 본문 없음), 409 NO_FEATURE_SPECS · CONTRACTS_NOT_APPROVED(featureKeys) 안내
- entities/contract: 목록 · 확정 · 수정 요청(3회), ContractCard (pending · draft · approved · failed)
- 문서 "API 계약" 탭을 목업에서 실제 API로. 확정 버튼은 BE 담당(없으면 대표)에게만
- 명세 문서에 needsApi · apiNeeds, 태스크 초안의 빈 명세 섹션 숨김
- 시작 422의 contracts.F-xx 항목 이름·계약 링크
- 실시간 contracts 토픽 매핑, 계획 확정 뒤 명세·계약도 다시 읽음

Closes #58

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jeonbinggu
jeonbinggu changed the base branch from feat/be-1014-removal to develop October 16, 2026 05:36
@jeonbinggu
jeonbinggu force-pushed the feat/be-1015-plan-flow branch from ae6f334 to b173d9d Compare October 16, 2026 05:36
@jeonbinggu
jeonbinggu merged commit 7f6a9a2 into develop Oct 16, 2026
3 checks passed
@jeonbinggu
jeonbinggu deleted the feat/be-1015-plan-flow branch October 16, 2026 05:37

This branch was successfully deployed

1 active deployment
Preview — b173d9d8 Deployed Oct 16, 2026 by vercel[bot]
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.

[FEAT] BE 10.15 연동 — 새 계획 흐름(기능 명세 → API 계약 → 태스크 나누기)

1 participant