Skip to content

refactor: 클라이언트 Webhook을 Event 명칭·경로로 마이그레이션#181

Merged
ZaMan0806 merged 1 commit into
developfrom
refactor/client-webhook-to-event
Jun 17, 2026
Merged

refactor: 클라이언트 Webhook을 Event 명칭·경로로 마이그레이션#181
ZaMan0806 merged 1 commit into
developfrom
refactor/client-webhook-to-event

Conversation

@ZaMan0806

Copy link
Copy Markdown
Collaborator

개요 💡

datagsm-server#373으로 서버에서 WebhookEvent로 리네이밍되고 엔드포인트가 /v1/webhooks/v1/events로 변경됨에 따라, 웹 클라이언트의 명칭·경로·API를 모두 Event 기준으로 통일합니다.

기존 클라이언트는 여전히 /webhooks 경로와 "웹훅" UI 라벨, /v1/webhooks API를 사용하고 있어 server#373과 정합이 맞지 않던 상태를 해소합니다.

작업내용 ⌨️

헤더 / 라우트

  • 공유 헤더 네비게이션(NAV_LINKS) 라벨 WebhookEvent, 경로 /webhooks/events (client·docs·status 헤더에 자동 반영)
  • 라우트 디렉터리 app/webhooks/app/events/ (구 /webhooks 경로 제거)

API (@repo/shared)

  • webhookUrleventUrl, /v1/webhooks/v1/events, webhookIdeventId
  • webhookQueryKeyseventQueryKeys
  • 목록 응답 래퍼 키 webhooksevents (server#373 EventListResDto 기준)

FSD 레이어 리네이밍 (apps/client/src)

  • entities/webhooksentities/events, views/webhooksviews/events, widgets/webhookswidgets/events
  • 심볼: WebhookEvent, WebhookFormDialogEventFormDialog, useGetWebhooksuseGetEvents, useCreateWebhook/useUpdateWebhook/useDeleteWebhookuseCreateEvent/useUpdateEvent/useDeleteEvent, useWebhookEventSelectionuseEventSelection
  • 상수: WEBHOOK_EVENTSEVENT_TYPES, MAX_WEBHOOKS_PER_ACCOUNTMAX_EVENTS_PER_ACCOUNT, WebhookEventOptionEventTypeOption

사용자 노출 문구

  • 페이지 제목·다이얼로그·토스트·빈 상태 문구의 "웹훅" → "이벤트", ADD/EDIT WEBHOOKADD/EDIT EVENT

변경 없이 유지된 계약 — 페이로드/DTO 필드(target_url/events/secret/is_active/created_at), 이벤트 enum 값(STUDENT_GRADUATED 등), 서명 헤더(X-DataGSM-Signature)는 그대로입니다(server#373에서도 미변경).

관련 이슈 🚨

리뷰 요청사항 👀

  • /webhooks 경로는 리다이렉트 없이 제거했습니다(아직 외부 공유 링크가 없다는 전제). 우려되면 알려주세요.
  • EventListDataevents: Event[]와 각 Eventevents: string[](구독 이벤트 타입 목록)이 중첩되는데, 이는 server#373의 EventListResDto.events / EventResDto.events 구조를 그대로 따른 것입니다.
  • pnpm check-types(모노레포 9개 패키지), client pnpm lint(0 warning)·pnpm build 모두 통과 확인했습니다.

서버에서 Webhook이 Event로 리네이밍(datagsm-server#373)됨에 따라 웹
클라이언트의 명칭·경로·API를 Event 기준으로 통일합니다.

- 헤더 네비게이션 라벨 Webhook → Event, 경로 /webhooks → /events
- API URL /v1/webhooks → /v1/events, 목록 응답 키 webhooks → events
- webhookUrl/webhookQueryKeys → eventUrl/eventQueryKeys
- entities/views/widgets의 webhooks 디렉터리 및 심볼을 events로 리네이밍
  (Webhook → Event, WEBHOOK_EVENTS → EVENT_TYPES 등)
- 이벤트 페이지 내 사용자 노출 문구(웹훅 → 이벤트) 통일
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
datagsm-front-admin Ready Ready Preview, Comment Jun 16, 2026 11:38am
datagsm-front-client Ready Ready Preview, Comment Jun 16, 2026 11:38am
datagsm-front-docs Ready Ready Preview, Comment Jun 16, 2026 11:38am
datagsm-front-oauth Ready Ready Preview, Comment Jun 16, 2026 11:38am
datagsm-front-status Ready Ready Preview, Comment Jun 16, 2026 11:38am

Request Review

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request refactors the codebase by renaming all webhook-related features, types, components, hooks, and API endpoints to 'events'. This includes updating routing, schemas, dialogs, lists, and query keys. The feedback recommends replacing hardcoded query keys like ['events'] with the helper function eventQueryKeys.getEvents() in both EventFormDialog and EventList to ensure consistency and prevent future breakage if query keys change.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread apps/client/src/widgets/events/ui/EventFormDialog/index.tsx
Comment thread apps/client/src/widgets/events/ui/EventList/index.tsx

@junjuny0227 junjuny0227 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

수고하셨습니다

@ZaMan0806 ZaMan0806 merged commit 4d40c83 into develop Jun 17, 2026
7 checks passed
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.

2 participants