Bug Report

Bug Report

사용자가 「이슈 티켓 만들어줘」 또는 「버그 리포트」 라고 하고 ClickUp 부모 링크를 주면 → 템플릿 본문으로 하위 이슈를 생성한다.

주 도메인: Flower · AdBuddy
서버: QA 또는 운영

입력 패턴

이슈 티켓 만들어줘 / 버그 리포트
ClickUp: https://app.clickup.com/t/...  (또는 AM-xxxxx)
(현상 / 기대결과 / 이미지·Figma 등)
담당: BE · FE (있으면)

부모 링크가 없으면 먼저 요청한다. 있으면 바로 하위 이슈로 생성.

도메인 · 디바이스 매트릭스

환경 정보에 디바이스·서버를 적는다. 제목에는 넣지 않는다.

• Flower + 모바일 언급 → Flower는 PC web만 가능하다고 짧게 알리고 PC web으로 작성할지 확인

Workflow

1. 부모 ClickUp 조회 → list_id
2. 도메인 + 디바이스 + 서버 확정
3. 중분류 확정 (화면/메뉴명, 예: Ad requests, 지역 선택)
4. 본문 작성 (공통 구조 + 디바이스별 환경 블록)
5. 첨부(이미지/영상/Figma/로그) 반영
6. ClickUp 하위 이슈 생성
   • Test Type = Report (고정)
   • 담당자: 사용자가 지정한 BE/FE (미지정이면 짧게 확인)
   • 첨부 업로드 → 설명에 미디어 삽입
7. 채팅에 커스텀 ID + URL 반환

예시·필드 상세: templates.md

제목

형식 (고정):

[중분류]현상요약

• 중분류 = 화면/메뉴/기능 단위 (짧게)
• 현상요약 = 한 줄 요약
• 도메인·디바이스·경로 장황하게 넣지 않음

예:

• [Ad requests]플랫폼 필터에 ALL 노출
• [Ad requests]CP 변경 시 Placement 미초기화
• [지역 선택]키보드가 화면을 밀어 올림
• [리소스>콘텐츠]Linear 콘텐츠 미노출

ClickUp Custom Fields

생성 시 설정:

• Release Target: 사용자가 지정한 경우에만 설정. 미지정이면 비워 둠.

담당자:

• 사용자가 BE / FE 를 주면 둘 다 assignees에 넣는다
• 예: BE 유순조 + FE 차진영 → 둘 다 지정
• 미지정 시 한 줄만 확인 후 생성

문체 (중요)

리포트 목적: 간결하게, 핵심만, 빠르게 읽히게.

사람이 읽으므로 가독성 우선. 기계적 나열·수다스러운 해요체 모두 피한다.

피할 것:

• ~확인됨 / ~미포함 / A ≠ B (차이 N = …) 같은 분석 메모 나열
• ~해요 / ~주세요 등 구어체
• 같은 사실 반복, 장황한 배경 설명

권장 [문제점] 패턴:

[문제점]
(조건)에서 (기대와 다른 실제 결과)
필요 시 실제 노출 문구·핵심 수치만 짧게
timeline: YYYY-MM-DD 확인
발생빈도(재현율): 항상 | 간헐 | 미확인

본문 공통 구조

섹션 이름·순서를 바꾸지 않는다.

[문제점]
현상만 기재
timeline
발생빈도(재현율)

[기대 결과]
정상적으로 동작해야하는 기준 기재

[재현 절차]
동일 현상을 재현할 수 있도록 최소 단계로 작성

[상세 환경 정보]
(디바이스 템플릿 + 서버)

[첨부 자료]
스크린샷, 영상, 로그, 기획서(figma) 등 참고 자료 첨부

작성 규칙

• [문제점]: 현상만 (원인·개선안 X). 2~4줄 이내 권장
• [기대 결과]: 정상 기준만. 가능하면 기대 문구/동작을 한 줄~짧은 불릿
• [재현 절차]: 최소 단계 번호 목록. 단계당 한 행동
• 모르는 값: 미확인 또는 - (섹션 삭제 금지)
• 사용자 원문 의도 유지, 템플릿 칸에 배치
• [첨부 자료]에 TC(테스트케이스) 문구/시트 링크는 넣지 않음 — 스크린샷·영상·로그·Figma만

[상세 환경 정보] — 디바이스별

모든 경우에 서버: QA | 운영 을 넣는다.

Flower QA 웹 캡처 기본 계정(알려준 경우): QA_Automation / Theme QA (비밀번호는 티켓에 적지 않음)

PC web (Flower / AdBuddy)

[상세 환경 정보]
URL:
OS: mac or window
브라우저:
서버: QA | 운영
테스트 계정 정보

Mobile web (AdBuddy만)

[상세 환경 정보]
URL:
OS/OS Version:
브라우저:
서버: QA | 운영
테스트 계정 정보

Mobile app (AdBuddy만)

[상세 환경 정보]
OS/OS Version
App Version
Device Model
서버: QA | 운영
테스트 계정 정보

STB/OTT 등 예외 Target이 필요하면 templates.md의 확장 템플릿 사용.

스크린샷 / 첨부

• 사용자가 준 이미지·Figma·로그·영상은 반드시 첨부
• 웹이고 캡처가 필요하면 Playwright로 해당 화면 캡처 후 첨부
• 동영상 요청 시 재현 영상 첨부
• TC 시트/케이스명 문구는 [첨부 자료]에 넣지 않음
• 로그인 필요 시 계정 요청 (추측 로그인 금지)
• ClickUp: request_attachment_upload → 업로드 → 본문에 링크/![](url) 삽입

ClickUp 체크

• 부모 하위 이슈로 생성
• 제목 [중분류]현상요약
• Test Type = Report
• 담당자 BE/FE 반영
• 본문 5섹션 + 서버(QA/운영)
• 첨부 + 본문 미디어
• 커스텀 ID + URL 전달

출력 (채팅)

1. 티켓 제목 + 링크 (커스텀 ID)
2. 담당자 / Test Type
3. 첨부 여부