공지사항 관리 기능 QA 가이드 문서 작성

[OKSUchun]

📌 Description

[OKSUchun]

공지사항 작성

기본 테스트 환경

관리자 유저 username: admin / password: admin

• 링크 : 공지사항 생성 | HelloPy Admin

성공 케이스 (Happy Path)

기본 데이터 생성

• 필수 필드(제목, 본문) 입력 후 정상 등록

• 상단 고정 여부 체크/미체크 후 등록

• 생성일시, 수정일시 자동 기록 확인

본문 컨텐츠 처리

• 텍스트만 있는 본문 등록

• 이미지가 포함된 본문 등록

실패 케이스 (Edge Cases)

필수 필드 누락

• 제목 없이 등록 시도 → 에러 메시지 확인

• 본문 없이 등록 시도 → 에러 메시지 확인

유효성 검증

• 제목 최대 길이(255자) 초과 → 에러 메시지 확인

• 지원하지 않는 이미지 형식 업로드 → 에러 메시지 확인

• 허용된 최대 이미지 크기 초과 → 에러 메시지 확인

권한 검증

• 권한 없는 사용자의 접근 시도 → 로그인 화면으로 리다이렉트

[OKSUchun]

공지사항 조회

기본 테스트 환경

관리자 유저 username: admin / password: admin

• 링크 : http://admin.hello-py.com:8080/api/notice/

시나리오: 사용자가 공지사항 목록 페이지에 접속

성공 케이스 (Happy Path)

1.1 공지사항 목록 조회

• 공지사항이 최신순으로 정렬되어 있는가?

• 페이지네이션이 정상 작동하는가?

1.2 공지사항 상세 조회

• 링크: http://admin.hello-py.com:8080/api/notice/3

시나리오: 사용자가 특정 공지사항을 클릭

• 제목과 내용이 올바르게 표시되는가?

• 작성일이 올바른 형식으로 표시되는가? -> UTC 로 return 됨

• 이미지나 첨부파일이 있는 경우 정상적으로 표시되는가?

2. 예외 상황 테스트 (Edge Cases)

2.1 필터 적용
시나리오: 사용자가 고정 파라미터를 사용

• 상단 고정 링크: http://admin.hello-py.com:8080/api/notice/?is_pinned={boolean}

• 고정 여부 옵션에 해당되는 공지사항만 표시되는가?

• 고정 쿼리 파라미터 해제시 전체 공지사항이 표시되는가?

• 링크: http://admin.hello-py.com:8080/api/notice/

2.2 비정상 접근

시나리오: 잘못된 접근이나 삭제된 공지사항 조회

• 일반 링크: http://admin.hello-py.com:8080/api/notice/100
• 존재하지 않는 공지사항 접근 시 "not_found" 메시지 표시
• 삭제된 공지사항 접근 시 "not_found" 메시지 표시

2.3 특수 상황

• 공지사항이 없는 경우"등록된 공지사항이 없습니다" 메시지 표시

[OKSUchun]

테스트 환경 정보

테스트 URL: http://admin.hello-py.com:8080/admin/notice/notice/

테스트 데이터:

일반 공지사항 3개

상단 고정 공지사항 1개

첨부파일이 있는 공지사항 1개

1. 기본 동작 테스트 (Happy Path)

1.1 단일 공지사항 삭제

• 일반 공지사항 삭제 -> 정상적으로 삭체처리, 목록에서 제거 확인

• 상단 고정 공지사항 삭제 -> 정상적으로 삭제 처리, 목록에서 제거 확인

1.2. 다중 공지사항 삭제

• 여러 공지사항 동시 삭제 -> 선택된 모든 항목 삭제 확인

1.3. 첨부파일이 있는 공지사항 삭제

•  첨부파일이 있는 공지사항 삭제 -> 공지사항과 함께 첨부파일도 함께 삭제 , 스토리지에서 파일 제거 확인

2. 예외 상황 테스트 (Edge Cases)

2.1 권한 검증

• 비로그인 상태 삭제 시도-> 로그인 페이지로 리다이렉트
•  일반 사용자 삭제 시도

[OKSUchun]

스토리지에서 파일을 제거여부를 어떻게 확인하면 될까요?