EG-BIM Q&A 피드백 저장 API 연동 Task

기준일: 2026-09-21
대상: qa-test.baroncs.co.kr / Cloudflare Worker baron-qa-gateway-test

목표

작성페이지의 문의를 Cloudflare Worker를 통해 ABC UserFeedback API에 저장한다.

작성페이지
  → Worker POST
  → Q&A SSO 세션 확인
  → Worker가 requester 정보와 API Key 추가
  → ABC UserFeedback API
  → feedbacks 저장
  → { id } 반환
  → 상세 페이지 이동

프로젝트·채널 UUID 확인
채널 필드 확인: title, contents, Category, images
서버 requester 메타데이터 계약 확인
requester_uuid, requester_affiliation, requester_position, requester_grade의 공개 생성 API 지원 확인
SSO 세션 저장 및 /auth/session 확인
Worker에 POST /api/feedbacks 라우트 추가
Worker에서 baron_qa_session 검증
Worker에서 requester 정보 추출
requester_id 매핑: SSO sub
requester_tenant_id 매핑: SSO tenant_id
requester_name 매핑: SSO profile/name
requester_email 매핑: SSO profile/email
requester_department 매핑: SSO tenant/profile department
requester_phone_number 매핑: SSO profile.phones[0] 또는 phone claim
브라우저 요청의 requester 값을 신뢰하지 않도록 처리
Worker Secret ABC_API_KEY로 x-api-key 추가
projectId와 channelId를 Worker 설정에 등록
POST /api/projects/{projectId}/channels/{channelId}/feedbacks 호출
x-source-namespace 추가
x-source-record-id 추가
x-idempotency-consumer 추가
Idempotency-Key와 idempotency-key 호환 처리
응답에서 feedback ID를 추출해 { id } 형식으로 반환
API 실패 시 ABC 오류를 노출하지 않고 안전한 오류 응답 반환
성공 시 작성페이지에서 detail.html?id={id}로 이동

npx wrangler secret put ABC_API_KEY --name baron-qa-gateway-test

ABC 문서에는 현재 /api/projects/... 경로가 실제 시나리오로 기재되어 있다.
/api/v1/...는 패키징 권장 경로로 문서화되어 있으므로 1차 구현은 현재 운영 시나리오인 /api/...를 사용한다.
UUID v7 정책에 맞춰 현재 브라우저의 UUID v4 생성 로직을 교체한다.
현재 공개 생성 API에서 실제로 확인된 메타데이터는 requester_id, requester_tenant_id, requester_email, requester_name, requester_department, requester_phone_number, is_secret다. 모든 값은 문자열로 전송하며 is_secret은 반드시 "true" 또는 "false"를 사용한다. requester_affiliation은 실제 요청에서 invalid field key로 거부되어 1차 저장 payload에서 제외했다. 나머지 확장 메타데이터는 서버 endpoint 지원 여부를 확인한 뒤 다시 추가한다.