opensoma 0.5.1 → 0.6.0

package/src/shared/utils/swmaestro.test.ts

@@ -1,17 +1,43 @@
 import { describe, expect, it } from 'bun:test'
 
-import { buildRoomReservationPayload, resolveVenue } from './swmaestro'
+import {
+  buildMentoringPayload,
+  buildRoomCancelPayload,
+  buildRoomReservationPayload,
+  buildRoomUpdatePayload,
+  buildUpdateMentoringPayload,
+  resolveVenue,
+  validateAttendeeCount,
+} from './swmaestro'
+
+const baseExisting = {
+  rentId: 18718,
+  itemId: 17,
+  title: '멘토링',
+  date: '2026-05-31',
+  startTime: '21:00',
+  endTime: '21:30',
+  attendees: 4,
+  notes: '',
+  statusCode: 'RS001',
+}
 
 describe('resolveVenue', () => {
   it('prepends "토즈-" to bare TOZ location names', () => {
     expect(resolveVenue('광화문점')).toBe('토즈-광화문점')
     expect(resolveVenue('양재점')).toBe('토즈-양재점')
     expect(resolveVenue('강남컨퍼런스센터점')).toBe('토즈-강남컨퍼런스센터점')
-    expect(resolveVenue('건대점')).toBe('토즈-건대점')
     expect(resolveVenue('강남역토즈타워점')).toBe('토즈-강남역토즈타워점')
     expect(resolveVenue('선릉점')).toBe('토즈-선릉점')
-    expect(resolveVenue('역삼점')).toBe('토즈-역삼점')
-    expect(resolveVenue('홍대점')).toBe('토즈-홍대점')
+  })
+
+  it('preserves trailing spaces that native ships for 건대/역삼/홍대 <option> values', () => {
+    expect(resolveVenue('건대점')).toBe('토즈-건대점 ')
+    expect(resolveVenue('역삼점')).toBe('토즈-역삼점 ')
+    expect(resolveVenue('홍대점')).toBe('토즈-홍대점 ')
+    expect(resolveVenue('토즈-건대점')).toBe('토즈-건대점 ')
+    expect(resolveVenue('토즈-역삼점')).toBe('토즈-역삼점 ')
+    expect(resolveVenue('토즈-홍대점')).toBe('토즈-홍대점 ')
   })
 
   it('passes through TOZ locations that already have the prefix', () => {
@@ -44,7 +70,7 @@ describe('resolveVenue', () => {
 })
 
 describe('buildRoomReservationPayload', () => {
-  it('sets rentEndde to the last selected slot so the server reserves only the chosen slots', () => {
+  it('sets rentEndde using the native lastSlot.minute+29 formula so tooltips render :59 like swmaestro.ai', () => {
     const payload = buildRoomReservationPayload({
       roomId: 17,
       date: '2026-04-20',
@@ -53,7 +79,7 @@ describe('buildRoomReservationPayload', () => {
     })
 
     expect(payload.rentBgnde).toBe('2026-04-20 13:00:00')
-    expect(payload.rentEndde).toBe('2026-04-20 13:30:00')
+    expect(payload.rentEndde).toBe('2026-04-20 13:59:00')
     expect(payload['time[0]']).toBe('13:00')
     expect(payload['time[1]']).toBe('13:30')
     expect(payload['time[2]']).toBeUndefined()
@@ -62,7 +88,7 @@ describe('buildRoomReservationPayload', () => {
     expect(payload['chkData_3']).toBeUndefined()
   })
 
-  it('handles a single-slot reservation', () => {
+  it('emits :29 for a single :00 slot so the tooltip mirrors native behavior', () => {
     const payload = buildRoomReservationPayload({
       roomId: 17,
       date: '2026-04-20',
@@ -71,7 +97,7 @@ describe('buildRoomReservationPayload', () => {
     })
 
     expect(payload.rentBgnde).toBe('2026-04-20 13:00:00')
-    expect(payload.rentEndde).toBe('2026-04-20 13:00:00')
+    expect(payload.rentEndde).toBe('2026-04-20 13:29:00')
     expect(payload['time[0]']).toBe('13:00')
     expect(payload['time[1]']).toBeUndefined()
   })
@@ -85,7 +111,7 @@ describe('buildRoomReservationPayload', () => {
     })
 
     expect(payload.rentBgnde).toBe('2026-04-20 23:00:00')
-    expect(payload.rentEndde).toBe('2026-04-20 23:30:00')
+    expect(payload.rentEndde).toBe('2026-04-20 23:59:00')
   })
 
   it('rejects non-consecutive slots', () => {
@@ -121,3 +147,213 @@ describe('buildRoomReservationPayload', () => {
     ).toThrow('At least one time slot is required')
   })
 })
+
+describe('buildRoomUpdatePayload', () => {
+  it('serialises the existing reservation unchanged when no overrides are supplied', () => {
+    const payload = buildRoomUpdatePayload(baseExisting)
+
+    expect(payload).toEqual({
+      menuNo: '200058',
+      rentId: '18718',
+      itemId: '17',
+      receiptStatCd: 'RS001',
+      title: '멘토링',
+      rentDt: '2026-05-31',
+      rentBgnde: '2026-05-31 21:00:00',
+      rentEndde: '2026-05-31 21:30:00',
+      infoCn: '',
+      rentNum: '4',
+      pageQueryString: '',
+    })
+  })
+
+  it('applies title, attendees, and notes overrides while keeping the schedule fields', () => {
+    const payload = buildRoomUpdatePayload(baseExisting, {
+      title: '스터디',
+      attendees: 6,
+      notes: '리뷰 세션',
+    })
+
+    expect(payload.title).toBe('스터디')
+    expect(payload.rentNum).toBe('6')
+    expect(payload.infoCn).toBe('리뷰 세션')
+    expect(payload.rentBgnde).toBe('2026-05-31 21:00:00')
+    expect(payload.rentEndde).toBe('2026-05-31 21:30:00')
+    expect(payload['time[0]']).toBeUndefined()
+  })
+
+  it('rewrites schedule fields and re-emits time/chkData entries when slots change', () => {
+    const payload = buildRoomUpdatePayload(baseExisting, {
+      slots: ['22:00', '22:30', '23:00'],
+    })
+
+    expect(payload.rentBgnde).toBe('2026-05-31 22:00:00')
+    expect(payload.rentEndde).toBe('2026-05-31 23:29:00')
+    expect(payload['time[0]']).toBe('22:00')
+    expect(payload['time[1]']).toBe('22:30')
+    expect(payload['time[2]']).toBe('23:00')
+    expect(payload['chkData_1']).toBe('2026-05-31|22:00|17')
+    expect(payload['chkData_3']).toBe('2026-05-31|23:00|17')
+  })
+
+  it('uses the new roomId and date when both schedule overrides are provided', () => {
+    const payload = buildRoomUpdatePayload(baseExisting, {
+      roomId: 22,
+      date: '2026-06-01',
+      slots: ['10:00', '10:30'],
+    })
+
+    expect(payload.itemId).toBe('22')
+    expect(payload.rentDt).toBe('2026-06-01')
+    expect(payload.rentBgnde).toBe('2026-06-01 10:00:00')
+    expect(payload.rentEndde).toBe('2026-06-01 10:59:00')
+    expect(payload['chkData_1']).toBe('2026-06-01|10:00|22')
+  })
+
+  it('rejects invalid slot overrides', () => {
+    expect(() => buildRoomUpdatePayload(baseExisting, { slots: ['22:00', '23:00'] })).toThrow(
+      'Time slots must be consecutive',
+    )
+  })
+
+  it('preserves the existing status code so confirmed reservations stay confirmed', () => {
+    const payload = buildRoomUpdatePayload({ ...baseExisting, statusCode: 'RS001' }, { title: '수정본' })
+    expect(payload.receiptStatCd).toBe('RS001')
+  })
+})
+
+describe('buildRoomCancelPayload', () => {
+  it('flips receiptStatCd to RS002 while keeping every other field identical to the existing reservation', () => {
+    const payload = buildRoomCancelPayload(baseExisting)
+
+    expect(payload.receiptStatCd).toBe('RS002')
+    expect(payload.rentId).toBe('18718')
+    expect(payload.title).toBe('멘토링')
+    expect(payload.rentBgnde).toBe('2026-05-31 21:00:00')
+    expect(payload.rentEndde).toBe('2026-05-31 21:30:00')
+    expect(payload.rentNum).toBe('4')
+  })
+})
+
+const baseMentoring = {
+  title: '스터디',
+  type: 'public' as const,
+  date: '2026-05-10',
+  startTime: '14:00',
+  endTime: '15:00',
+  venue: '스페이스 A1',
+}
+
+describe('buildMentoringPayload', () => {
+  it('splits the registration period into date + time fields the new form expects', () => {
+    const payload = buildMentoringPayload(baseMentoring)
+
+    expect(payload.bgndeDate).toBe('2026-05-10')
+    expect(payload.bgndeTime).toBe('00:00')
+    expect('bgnde' in payload).toBe(false)
+    expect('endde' in payload).toBe(false)
+  })
+
+  it('defaults receiptType to UNTIL_LECTURE and aligns enddeDate/enddeTime with the lecture start', () => {
+    const payload = buildMentoringPayload(baseMentoring)
+
+    expect(payload.receiptType).toBe('UNTIL_LECTURE')
+    expect(payload.enddeDate).toBe('2026-05-10')
+    expect(payload.enddeTime).toBe('14:00')
+  })
+
+  it('uses the user-supplied registration end window when receiptType is DIRECT', () => {
+    const payload = buildMentoringPayload({
+      ...baseMentoring,
+      receiptType: 'DIRECT',
+      regStart: '2026-05-01',
+      regStartTime: '09:00',
+      regEnd: '2026-05-09',
+      regEndTime: '18:00',
+    })
+
+    expect(payload.receiptType).toBe('DIRECT')
+    expect(payload.bgndeDate).toBe('2026-05-01')
+    expect(payload.bgndeTime).toBe('09:00')
+    expect(payload.enddeDate).toBe('2026-05-09')
+    expect(payload.enddeTime).toBe('18:00')
+  })
+
+  it('sends the stateCd and qustnrAt values the current form posts', () => {
+    const payload = buildMentoringPayload(baseMentoring)
+
+    expect(payload.stateCd).toBe('A')
+    expect(payload.qustnrAt).toBe('N')
+    expect(payload.openAt).toBe('Y')
+  })
+
+  it('maps public/lecture types to MRC010/MRC020 and validates the default attendee count', () => {
+    expect(buildMentoringPayload({ ...baseMentoring, type: 'public' }).reportCd).toBe('MRC010')
+    expect(buildMentoringPayload({ ...baseMentoring, type: 'public' }).applyCnt).toBe('3')
+    expect(buildMentoringPayload({ ...baseMentoring, type: 'lecture' }).reportCd).toBe('MRC020')
+    expect(buildMentoringPayload({ ...baseMentoring, type: 'lecture' }).applyCnt).toBe('6')
+  })
+
+  it('rejects attendee counts that violate the form rules', () => {
+    expect(() => buildMentoringPayload({ ...baseMentoring, maxAttendees: 1 })).toThrow(
+      '자유 멘토링은 2명 이상 5명 이하로 설정해야 합니다.',
+    )
+    expect(() => buildMentoringPayload({ ...baseMentoring, maxAttendees: 6 })).toThrow(
+      '자유 멘토링은 2명 이상 5명 이하로 설정해야 합니다.',
+    )
+    expect(() => buildMentoringPayload({ ...baseMentoring, type: 'lecture', maxAttendees: 4 })).toThrow(
+      '멘토 특강은 6명 이상으로 설정해야 합니다.',
+    )
+  })
+
+  it('passes through the venue resolver so TOZ aliases are normalised', () => {
+    expect(buildMentoringPayload({ ...baseMentoring, venue: '광화문점' }).place).toBe('토즈-광화문점')
+  })
+
+  it('mirrors native checkForm() by replacing double quotes in qustnrSj with single quotes', () => {
+    const payload = buildMentoringPayload({ ...baseMentoring, title: '"테스트" 멘토링' })
+
+    expect(payload.qustnrSj).toBe("'테스트' 멘토링")
+  })
+
+  it('mirrors the native DEXT5 empty-body placeholder when content is missing', () => {
+    const nativeEmpty =
+      '<p style="font-family: 굴림; font-size: 12pt; line-height: 1.2; margin-top: 0px; margin-bottom: 0px;">&nbsp;</p>'
+
+    expect(buildMentoringPayload(baseMentoring).qestnarCn).toBe(nativeEmpty)
+    expect(buildMentoringPayload({ ...baseMentoring, content: '' }).qestnarCn).toBe(nativeEmpty)
+    expect(buildMentoringPayload({ ...baseMentoring, content: '   \n  ' }).qestnarCn).toBe(nativeEmpty)
+  })
+
+  it('passes through rich HTML from the editor unchanged', () => {
+    const payload = buildMentoringPayload({ ...baseMentoring, content: '<p>세션 본문</p>' })
+
+    expect(payload.qestnarCn).toBe('<p>세션 본문</p>')
+  })
+})
+
+describe('buildUpdateMentoringPayload', () => {
+  it('injects the target qustnrSn while reusing the insert payload shape', () => {
+    const payload = buildUpdateMentoringPayload(9999, baseMentoring)
+
+    expect(payload.qustnrSn).toBe('9999')
+    expect(payload.bgndeDate).toBe('2026-05-10')
+    expect(payload.receiptType).toBe('UNTIL_LECTURE')
+    expect(payload.stateCd).toBe('A')
+  })
+})
+
+describe('validateAttendeeCount', () => {
+  it('accepts public counts within 2-5 and lecture counts of 6 or more', () => {
+    expect(() => validateAttendeeCount('public', 2)).not.toThrow()
+    expect(() => validateAttendeeCount('public', 5)).not.toThrow()
+    expect(() => validateAttendeeCount('lecture', 6)).not.toThrow()
+    expect(() => validateAttendeeCount('lecture', 100)).not.toThrow()
+  })
+
+  it('rejects counts outside the server-enforced bounds', () => {
+    expect(() => validateAttendeeCount('public', 1)).toThrow()
+    expect(() => validateAttendeeCount('public', 6)).toThrow()
+    expect(() => validateAttendeeCount('lecture', 5)).toThrow()
+  })
+})

package/src/shared/utils/swmaestro.ts

@@ -13,6 +13,29 @@ export function toMentoringType(type: string): 'public' | 'lecture' {
   return 'public'
 }
 
+export type ReceiptType = 'UNTIL_LECTURE' | 'DIRECT'
+
+function sanitizeTitle(title: string): string {
+  return title.replace(/"/g, "'")
+}
+
+export function resolveMaxAttendees(type: 'public' | 'lecture', maxAttendees?: number): number {
+  if (maxAttendees !== undefined) {
+    validateAttendeeCount(type, maxAttendees)
+    return maxAttendees
+  }
+  return type === 'lecture' ? 6 : 3
+}
+
+export function validateAttendeeCount(type: 'public' | 'lecture', count: number): void {
+  if (type === 'public' && (count < 2 || count > 5)) {
+    throw new Error('자유 멘토링은 2명 이상 5명 이하로 설정해야 합니다.')
+  }
+  if (type === 'lecture' && count < 6) {
+    throw new Error('멘토 특강은 6명 이상으로 설정해야 합니다.')
+  }
+}
+
 export function buildMentoringPayload(params: {
   title: string
   type: 'public' | 'lecture'
@@ -22,16 +45,27 @@ export function buildMentoringPayload(params: {
   venue: string
   maxAttendees?: number
   regStart?: string
+  regStartTime?: string
   regEnd?: string
+  regEndTime?: string
+  receiptType?: ReceiptType
   content?: string
 }): Record<string, string> {
+  const receiptType: ReceiptType = params.receiptType ?? 'UNTIL_LECTURE'
+  const bgndeDate = params.regStart ?? params.date
+  const bgndeTime = params.regStartTime ?? '00:00'
+  const { enddeDate, enddeTime } = resolveReceiptEnd(receiptType, params)
+
   return {
     menuNo: MENU_NO.MENTORING,
     reportCd: toReportCd(params.type),
-    qustnrSj: params.title,
-    bgnde: params.regStart ?? params.date,
-    endde: params.regEnd ?? params.date,
-    applyCnt: String(params.maxAttendees ?? (params.type === 'lecture' ? 6 : 1)),
+    qustnrSj: sanitizeTitle(params.title),
+    receiptType,
+    bgndeDate,
+    bgndeTime,
+    enddeDate,
+    enddeTime,
+    applyCnt: String(resolveMaxAttendees(params.type, params.maxAttendees)),
     eventDt: params.date,
     eventStime: params.startTime,
     eventEtime: params.endTime,
@@ -39,14 +73,27 @@ export function buildMentoringPayload(params: {
     qestnarCn: formatEditorContent(params.content ?? ''),
     atchFileId: '',
     fileFieldNm_1: '',
-    stateCd: 'QST020',
+    stateCd: 'A',
     openAt: 'Y',
-    qustnrAt: 'Y',
+    qustnrAt: 'N',
     qustnrSn: '',
     pageQueryString: '',
   }
 }
 
+function resolveReceiptEnd(
+  receiptType: ReceiptType,
+  params: { date: string; startTime: string; endTime: string; regEnd?: string; regEndTime?: string },
+): { enddeDate: string; enddeTime: string } {
+  if (receiptType === 'UNTIL_LECTURE') {
+    return { enddeDate: params.date, enddeTime: params.startTime }
+  }
+  return {
+    enddeDate: params.regEnd ?? params.date,
+    enddeTime: params.regEndTime ?? params.startTime,
+  }
+}
+
 export function buildUpdateMentoringPayload(
   id: number,
   params: Parameters<typeof buildMentoringPayload>[0],
@@ -67,7 +114,7 @@ export function buildDeleteMentoringPayload(id: number): Record<string, string>
 
 export function buildApplicationPayload(id: number): Record<string, string> {
   return {
-    menuNo: MENU_NO.EVENT,
+    menuNo: MENU_NO.MENTORING,
     qustnrSn: String(id),
     applyGb: 'C',
     stepHeader: '0',
@@ -130,6 +177,17 @@ export function validateReservationSlots(slots: string[]): void {
   }
 }
 
+// Mirror the native /officeMng/view.do form, which sets rentEndde to
+// `${lastSlot.hour}:${lastSlot.minute + 29}` (see the native JS:
+// `et = last.data('hour')+':'+(last.data('minute')*1+29)`). Last slot '13:30'
+// becomes '13:59'; last slot '12:00' becomes '12:29'. Native does not carry
+// minutes into the hour, so we replicate that string-concat behavior exactly.
+function slotNativeEnd(slot: string): string {
+  const [hourPart, minutePart] = slot.split(':')
+  const minute = Number(minutePart) + 29
+  return `${hourPart}:${String(minute).padStart(2, '0')}`
+}
+
 export function buildRoomReservationPayload(params: {
   roomId: number
   date: string
@@ -147,7 +205,7 @@ export function buildRoomReservationPayload(params: {
     menuNo: MENU_NO.ROOM,
     itemId: String(params.roomId),
     rentBgnde: `${params.date} ${firstSlot}:00`,
-    rentEndde: `${params.date} ${lastSlot}:00`,
+    rentEndde: `${params.date} ${slotNativeEnd(lastSlot)}:00`,
     title: params.title,
     rentDt: params.date,
     rentNum: String(params.attendees ?? 1),
@@ -164,6 +222,87 @@ export function buildRoomReservationPayload(params: {
   return payload
 }
 
+export function buildRoomUpdatePayload(
+  existing: {
+    rentId: number
+    itemId: number
+    title: string
+    date: string
+    startTime: string
+    endTime: string
+    attendees: number
+    notes: string
+    statusCode: string
+  },
+  params: {
+    title?: string
+    roomId?: number
+    date?: string
+    slots?: string[]
+    attendees?: number
+    notes?: string
+  } = {},
+): Record<string, string> {
+  const roomId = params.roomId ?? existing.itemId
+  const date = params.date ?? existing.date
+
+  let startTime = existing.startTime
+  let endTime = existing.endTime
+  if (params.slots?.length) {
+    validateReservationSlots(params.slots)
+    startTime = params.slots[0]
+    endTime = slotNativeEnd(params.slots[params.slots.length - 1])
+  }
+
+  const payload: Record<string, string> = {
+    menuNo: MENU_NO.ROOM,
+    rentId: String(existing.rentId),
+    itemId: String(roomId),
+    receiptStatCd: existing.statusCode || 'RS001',
+    title: params.title ?? existing.title,
+    rentDt: date,
+    rentBgnde: `${date} ${startTime}:00`,
+    rentEndde: `${date} ${endTime}:00`,
+    infoCn: params.notes ?? existing.notes,
+    rentNum: String(params.attendees ?? existing.attendees),
+    pageQueryString: '',
+  }
+
+  if (params.slots?.length) {
+    params.slots.forEach((slot, index) => {
+      payload[`time[${index}]`] = slot
+      payload[`chkData_${index + 1}`] = `${date}|${slot}|${roomId}`
+    })
+  }
+
+  return payload
+}
+
+export function buildRoomCancelPayload(existing: {
+  rentId: number
+  itemId: number
+  title: string
+  date: string
+  startTime: string
+  endTime: string
+  attendees: number
+  notes: string
+}): Record<string, string> {
+  return {
+    menuNo: MENU_NO.ROOM,
+    rentId: String(existing.rentId),
+    itemId: String(existing.itemId),
+    receiptStatCd: 'RS002',
+    title: existing.title,
+    rentDt: existing.date,
+    rentBgnde: `${existing.date} ${existing.startTime}:00`,
+    rentEndde: `${existing.date} ${existing.endTime}:00`,
+    infoCn: existing.notes,
+    rentNum: String(existing.attendees),
+    pageQueryString: '',
+  }
+}
+
 export function parseApplicationHistory(html: string): ApplicationHistoryItem[] {
   const root = parse(html)
   const rows =
@@ -184,49 +323,13 @@ export function parseApplicationHistory(html: string): ApplicationHistoryItem[]
     )
 }
 
-export function parseEventDetail(html: string): Record<string, unknown> {
-  const root = parse(html)
-  const labels = extractLabelMap(root)
-  const contentNode =
-    root.querySelector('[data-content]') ??
-    root.querySelector('.board-view-content') ??
-    root.querySelector('.view-content') ??
-    root.querySelector('.content-body')
-
-  return {
-    id: extractNumber(labels.NO ?? labels.번호 ?? root.querySelector('[name="bbsId"]')?.getAttribute('value') ?? '0'),
-    title: labels.제목 ?? cleanText(root.querySelector('h1, h2, .title')?.text),
-    content: decodeHtmlEntities(contentNode?.innerHTML.trim() ?? ''),
-    fields: labels,
-  }
-}
-
-function extractLabelMap(root: ReturnType<typeof parse>): Record<string, string> {
-  const map: Record<string, string> = {}
-
-  for (const row of root.querySelectorAll('tr')) {
-    const headers = row.querySelectorAll('th')
-    const values = row.querySelectorAll('td')
-
-    if (headers.length === 1 && values.length === 1) {
-      map[cleanText(headers[0]?.text).replace(/:$/, '')] = cleanText(values[0]?.text)
-    }
-
-    if (headers.length > 1 && headers.length === values.length) {
-      headers.forEach((header, index) => {
-        map[cleanText(header.text).replace(/:$/, '')] = cleanText(values[index]?.text)
-      })
-    }
-  }
-
-  return map
-}
-
 const EDITOR_P_STYLE = 'font-family: 굴림; font-size: 12pt; line-height: 1.2; margin-top: 0px; margin-bottom: 0px;'
+const EMPTY_EDITOR_HTML = `<p style="${EDITOR_P_STYLE}">&nbsp;</p>`
 
 function formatEditorContent(content: string): string {
-  if (!content) return ''
+  if (!content) return EMPTY_EDITOR_HTML
   const decoded = decodeHtmlEntities(content)
+  if (!decoded.trim()) return EMPTY_EDITOR_HTML
   if (/<(?:p|div|h[1-6]|ul|ol|table|br)\b/i.test(decoded)) {
     return decoded
   }

package/src/shared/utils/team-action-params.test.ts

@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'bun:test'
+
+import { UserGb } from '../../http'
+import { buildTeamActionPayload } from './team-action-params'
+
+describe('buildTeamActionPayload', () => {
+  it('builds the native payload from teamId and user identity', () => {
+    expect(
+      buildTeamActionPayload('60e6785c8c404142b12cf9ed2a3d811f', {
+        userId: 'neo@example.com',
+        userNm: '전수열',
+        userNo: 'f6d192ad3b3e4ee29f1d238714ab92c1',
+        userGb: UserGb.Mentor,
+      }),
+    ).toEqual({
+      userNo: 'f6d192ad3b3e4ee29f1d238714ab92c1',
+      userNm: '전수열',
+      userGb: 'T',
+      teamNo: '60e6785c8c404142b12cf9ed2a3d811f',
+    })
+  })
+
+  it('falls back to userGb="T" when the identity has no userGb', () => {
+    const payload = buildTeamActionPayload('team-1', {
+      userId: 'neo@example.com',
+      userNm: '전수열',
+      userNo: 'abc',
+      userGb: UserGb.Unknown,
+    })
+    expect(payload.userGb).toBe('T')
+  })
+})

package/src/shared/utils/team-action-params.ts

@@ -0,0 +1,10 @@
+import { UserGb, type UserIdentity } from '../../http'
+
+export function buildTeamActionPayload(teamId: string, user: UserIdentity): Record<string, string> {
+  return {
+    userNo: user.userNo,
+    userNm: user.userNm,
+    userGb: user.userGb || UserGb.Mentor,
+    teamNo: teamId,
+  }
+}