oz_externship - mypart

김기훈·2025년 12월 10일

부트캠프 프로젝트

목록 보기
15/39

내 파트

기능메서드URL
질문 등록POST/api/v1/qna/questions
질문 목록 조회GET/api/v1/qna/questions
질문 상세 조회GET/api/v1/qna/questions/{question_id}
질문 수정PUT/api/v1/qna/questions/{question_id}

  • 질문 등록("/api/v1/qna/questions")

    • 웹사이트 이용자 중 수강생 권한을 가진 로그인 유저는 질의응답 메뉴로 접속하여 질문 등록 가능
    • 질문 등록 시 입력 항목
      • 제목
      • 질문 내용 ( 마크다운 문법 사용 가능, 이미지 첨부 가능 )
      • 카테고리 (대분류 > 중분류 > 소분류)
      • 내용에 첨부된 이미지들

  • 질의응답 목록 조회("/api/v1/qna/questions")

    • 모든 웹사이트 이용자는 질의응답 메뉴로 접속하여 등록된 질의응답 목록을 조회 가능
      • 모든 이용자 가능 → 권한 X
    • 질의응답 목록 조회 시 상단의 탭을 이용하여
      • 답변 작성 여부에 따라 목록을 조회 가능
      • (추가) 질문 카테고리별로 필터링을 적용 가능
    • 질의응답 목록 조회 시
      • 검색 기능을 활용하여 원하는 질의응답 항목을 찾기 가능
    • 조회된 질의응답 목록은
      • 최신순으로 정렬되어야하며 페이지네이션이 적용
    • 목록에서 각 항목은 카드 형태로 노출
    • 질의응답 목록에서 조회가능한 항목 ( 각 카드에 포함되어야 하는 항목 )

      • 질의응답 카테고리 ( 대분류 > 중분류 > 소분류 형태 )
      • 작성자 정보
        • 프로필 이미지
        • 닉네임
      • 질의응답 제목
      • 질문 내용
      • 답변 수
      • 조회수
      • 질문 작성일시
      • 질문 내용에 포함된 이미지의 썸네일 이미지"

  • 질의응답 상세 조회("/api/v1/qna/questions/{question_id}")

    • 모든 웹사이트 이용자는 조회된 질의응답 목록 중에서 특정 항목을 클릭하여 상세 조회 가능
    • 특정 항목을 클릭 시 상세조회 페이지로 이동
    • 상세 조회 페이지에서 확인 가능한 항목

      • 질문 제목
      • 질문 내용
      • 질문 내용에 첨부된 이미지
      • 질문 작성자 정보
        • 프로필 썸네일 이미지
        • 닉네임
      • 질문 카테고리 정보
        • 대, 중, 소분류 카테고리 이름
      • 질문 조회수
      • 질문 작성일시
  • 답변 목록

    • 답변 작성자 정보
      • 프로필 썸네일 이미지
      • 닉네임
    • 답변 내용
    • 답변 작성일시
    • 답변 채택 여부
  • 답변에 대한 댓글 목록

    • 댓글 작성자 정보
      • 프로필 썸네일 이미지
      • 유저 닉네임
    • 댓글 내용
    • 댓글 작성일시

  • 질문 수정("/api/v1/qna/questions/{question_id}")

    • 웹사이트 이용자 중 수강생 권한을 가진 로그인 유저는 질의응답 메뉴로 접속하여
      • 자신이 작성한 질문 내용을 수정 가능
    • 질의응답 상세 페이지 내에 위치한 수정하기 버튼을 클릭하여 해당 질문 내용을 수정 가능
    • 수정하기 버튼은 작성자 본인외에 노출되지 않아야 함
    • 수정 가능한 항목

      • 제목
      • 질문 내용 ( 마크다운 문법 사용 가능, 이미지 첨부 가능 )
      • 카테고리
      • 내용에 첨부된 이미지들"

카테고리

  • 어드민 페이지에서 기능만 구현하고 프론트단은 구현하지 않는다.

질의응답 카테고리 등록

  • 스태프 / 관리자 권한을 가진 유저는 어드민 페이지 내의 질의응답 관리 메뉴의
  • 카테고리 관리 메뉴에 접속하여 질의응답 카테고리를 등록 가능
    • 카테고리 분류

      • 대분류 카테고리 → 프론트엔드, 백엔드 등
      • 중분류 카테고리 → 프로그래밍 언어, 웹프레임워크, Web, OS, 라이브러리 등
      • 소분류 카테고리 → JavaScript, Python, Django, React Next.js, FastAPI 등
    • 카테고리 등록 시 입력 항목

      • 카테고리 종류 → 대분류, 중분류, 소분류
      • 카테고리 이름
      • 부모 카테고리 → 중, 소분류 카테고리의 경우

카테고리 목록 조회

  • 스태프 / 관리자 권한을 가진 유저는 어드민 페이지 내의 질의응답 관리 메뉴의
  • 카테고리 관리 메뉴에 접속하여 시스템에 등록된 질의응답 카테고리들을 목록으로 조회 가능
  • 카테고리 목록 조회 시 검색필터 + 검색 기능을 활용하여 조회 가능
    • 카테고리 목록 조회에서 확인 가능한 항목

      • 카테고리 ID / 카테고리명 / 카테고리 분류 타입 ( 대, 중, 소 )
      • 자식 카테고리
        • 카테고리 분류가 대, 중일 경우 자식 카테고리의 명칭
        • 소분류일 경우 빈칸
      • 부모 카테고리
        • 카테고리 분류가 중, 소일 경우 부모 카테고리의 명칭
        • 대분류일 경우 빈칸
      • 등록일시
      • 수정일시

카테고리 삭제

  • 스태프 / 관리자 권한을 가진 유저는 어드민 페이지 내의 질의응답 관리 메뉴의
  • 카테고리 관리 메뉴에 접속하여 시스템에 등록된 질의응답 카테고리를 삭제 가능
  • 조회된 카테고리 목록에서 삭제할 카테고리를 선택하고 삭제하기 버튼을 클릭하여 삭제
  • 카테고리 삭제 전, 대, 중, 소분류에 따라 경고 메시지 팝업이 나옴
    • 대분류의 경우

      • 해당 카테고리에 속한 중분류, 소분류 카테고리가 함께 삭제
      • 각 카테고리에 속한 질의응답은 일반질문 카테고리로 전환 / 삭제된 항목 복구 불가
    • 중분류의 경우

      • 해당 카테고리에 속한 소분류 카테고리가 함께 삭제
      • 각 카테고리에 속한 질의응답은 일반질문 카테고리로 전환 / 삭제된 항목 복구 불가
    • 소분류의 경우

      • 해당 카테고리에 속한 질의응답은 일반질문 카테고리로 전환 / 삭제된 항목 복구 불가

질의응답 관리


질의응답 목록 조회

  • 스태프 / 관리자 권한을 가진 유저는 어드민 페이지 내의 질의응답 관리 메뉴에 접속하여
  • 수강생들이 등록한 질의응답을 목록으로 조회 가능
  • 질의응답 목록 조회 시 검색, 정렬 기능을 적용 가능
    • 목록 조회 시 확인 가능한 항목

      • 질문 고유 ID / 질문 제목 / 대분류 카테고리 > 중분류 카테고리 > 소분류 카테고리
      • 내용 / 작성자 ( 닉네임 ) / 조회수 / 답변 작성 여부 ( Y / N ) / 작성일시 / 수정일시

질의응답 상세 조회

  • 수강생들이 등록한 질의응답을 상세 조회 가능
  • 조회된 질의응답 목록에서 특정 항목을 클릭하여 해당 항목에 대한 상세를 조회 가능
    • 질의응답 상세 조회 항목

      • 질문 작성자 정보

        • 프로필 썸네일 이미지 / 유저 닉네임 / 과정 (ex.초격차 프론트엔드 14기)
      • 질의응답 제목 / 질문 내용
      • 조회수 / 답변 작성 여부 ( Y / N ) / 질문 작성일시 / 질문 수정일시
      • 답변 목록

        • 일반 수강생의 경우
          • 프로필 썸네일 이미지 / 유저 닉네임 / 과정 - 기수 정보 (ex.초격차 프론트엔드 8기)
        • 조교의 경우
          • 프로필 썸네일 이미지 / 유저 닉네임 / 직함 (ex.초격차 프론트엔드 8기 조교)
        • 운영매니저, 러닝코치, 어드민의 경우
          • 프로필 썸네일 이미지 / 유저 닉네임 / 직함 (ex. 교육 운영 매니저, 러닝 코치, 관리자)
        • 답변 내용 / 답변 채택 여부 / 답변 작성일시 / 답변 수정일시

질의응답 내역 삭제

  • 수강생들이 등록한 질의응답 내역을 삭제 가능
  • 조회된 질의응답 목록에서 항목을 선택하고 삭제하기 버튼을 클릭하여 삭제
  • 질의응답 상세 조회 모달 내에 위치한 삭제하기 버튼을 클릭하여 삭제
  • 질의응답 내역 삭제 시 해당 질문, 질문에 작성된 답변, 답변에 작성된 댓글들이 모두 함께 삭제
  • 답변 삭제

    • 수강생들이 질문에 대해 작성한 답변을 삭제 가능
    • 질의응답 상세 조회 모달 내
      • 답변 목록에서 각 항목에 위치한 삭제버튼 ( x 아이콘
profile
안녕하세요.

0개의 댓글