콘텐츠로 이동

🏭 현황 · 통계 · 게시판

프로젝트 운영의 시야를 담당하는 페이지입니다: 진행률 요약 · 멤버별 현황 · 정식 통계 4종, 그리고 공지/문의 게시판과 FAQ. "지금 프로젝트 얼마나 됐나", "누가 얼마나 했나", "클래스별/반려/불량 집계를 보고 싶다", "공지를 올리고 싶다" 같은 요청이 이 페이지의 도구로 흘러갑니다. 할당작업 개별 건의 상태 확인은 워크샵 · 할당 · 검수를 보세요.

불변식 — 미리 알아야 할 것

  • 모든 리소스는 워크스페이스 소유입니다 — 통계·게시판도 워크스페이스 선택 후에만 조회됩니다. 워크스페이스가 비활성이면 오너 포함 전원 403입니다.
  • 권한은 관계의 역할(워크스페이스 Owner/Admin/Member · 워크샵 Labeler/Reviewer)로 결정됩니다.

진행률 요약 vs 정식 통계 — 역할이 다릅니다

이 페이지의 통계 도구는 두 층으로 나뉩니다. 질문의 성격에 맞는 층을 고르세요.

진행률 요약 (v1) 정식 통계
도구 get_project_progress · get_project_member_breakdown get_project_statistics
답하는 질문 "지금 얼마나 됐나 / 누가 얼마나 했나" "클래스별·작업자별·반려·불량 정식 집계는 어떤가"
성격 라벨링·검수 진행률을 한눈에 보는 현황 점검 kind 4종(worker/class/rejection/defect) 중 택1 조회
갱신 최초 조회 시 백엔드 통계 항목이 초기화될 수 있음(무해) 갱신 주기는 응답 메타(computed_at/realtime)로 표시

"프로젝트 어떻게 되고 있어?" 같은 가벼운 현황 점검은 진행률 요약으로, 클래스 분포·반려 사유·불량 같은 집계 분석은 정식 통계로 갑니다.

도구 한눈에

도구 무엇을 할 때 쓰기 여부
get_project_progress 프로젝트 진행률 한눈에 읽기
get_project_member_breakdown 멤버별 진행 현황 표 읽기
get_project_statistics 정식 통계 4종(worker/class/rejection/defect) 읽기
list_posts 공지·내 문의 글 둘러보기 읽기
get_post 게시글 1건 상세 읽기
list_post_categories 게시판 카테고리 목록 읽기
manage_board 게시글(공지/가이드) 생성/수정/삭제 ✏️ 쓰기(confirm)
list_faqs 자주 묻는 질문 목록 읽기
list_notifications 내 알림 목록 + 읽지 않은 개수 읽기
get_notification 알림 1건 상세 읽기
manage_notifications 알림 읽음/안읽음 처리 ✏️ 쓰기

도구 상세

get_project_progress

프로젝트 진행률 요약 — 작업(라벨링)·검수 완료율과 반려율을 한눈에 봅니다. "이 프로젝트 지금 얼마나 됐어?" 같은 비개발자용 현황 점검에 가장 먼저 부르는 도구입니다. 최초 조회 시 백엔드 통계 항목이 초기화될 수 있습니다(무해).

get_project_member_breakdown

프로젝트 멤버별 진행 현황 — 작업자(labeler) 또는 검수자(reviewer) 각각의 담당량/완료/검수중/반려 건수를 멤버 표로 봅니다. "누가 얼마나 했나"를 확인할 때 부릅니다. 개인정보 보호를 위해 멤버 이름만 표시하고 이메일은 노출하지 않습니다. 최초 조회 시 백엔드 통계 항목이 초기화될 수 있습니다(무해).

  • 주요 인자: project_id, role (labeler 기본 | reviewer)
  • 함께 보기: 프로젝트 전체 요약은 get_project_progress

get_project_statistics

🏭 Workforce. 정식 프로젝트 통계 4종 중 하나를 조회합니다 — kind 필수:

  • worker — 작업자별 집계
  • class — 클래스별 집계
  • rejection — 반려 집계 (반려 사유 태그는 manage_review_tags 참고)
  • defect — 불량 집계

get_project_progress / get_project_member_breakdown (v1, 라벨링·검수 진행률 요약)과는 역할이 다릅니다 — 이 도구는 클래스별·불량·반려의 정식 집계입니다. 갱신 주기는 응답 메타(computed_at/realtime)로 표시되며 하드코딩되지 않습니다.

  • 주요 인자: project_id, kind (worker|class|rejection|defect), datetime (선택)

list_posts

게시글 목록 — 공지(NOTICE)와 요청자 본인이 작성한 글만 반환합니다(워크스페이스 전체 글이 아님). 공지 사항이나 내 문의를 둘러볼 때 부릅니다.

  • 주요 인자: category (카테고리 ID), priority, search, page
  • 함께 보기: 카테고리 ID 는 list_post_categories · 상세는 get_post

get_post

게시글 1건 상세 — list_posts에서 얻은 id 로 제목·내용(HTML)·조회수를 확인합니다. 조회 시 백엔드 조회수(count_read)가 증가합니다.

  • 주요 인자: id

list_post_categories

게시판 카테고리 목록을 봅니다. board(notice/inquiry)로 좁힐 수 있습니다.

  • 주요 인자: board (notice|inquiry), search, page
  • 함께 보기: 여기서 얻은 카테고리로 list_posts를 필터

manage_board

🏭 Workforce. 게시글(공지/가이드)을 생성/수정/삭제합니다(action=create|update|delete). 읽기는 list_posts / get_post 를 씁니다.

첨부 파일은 서버가 바이트를 직접 받지 않습니다 — out-of-band 업로드 흐름 (prepare_data_upload 계열)으로 얻은 참조만 files 에 넘깁니다.

  • 주요 인자: action, post_id (update/delete 대상), project, workshops (노출 워크샵), title, category (notice|guide), role (labeler|reviewer|전체), worker_visibility, is_popup, content, files/remove_files (첨부 참조)
  • 안전장치: 기본 dry-run 미리보기 → confirm=true 재호출 시 실제 적용

list_faqs

자주 묻는 질문(FAQ) 목록을 봅니다. 카테고리·검색으로 좁힐 수 있습니다.

  • 주요 인자: category, search, page

알림 — 나에게 온 소식

알림은 개인에게 오는 소식함입니다. Job 진행(임포트·익스포트·작업데이터 등록·학습)과 권한 변화(멤버 추가·참여 요청·초대)를 알려 줍니다.

알림 ≠ 백그라운드 작업 영역

목록에서 일괄 액션을 돌렸을 때 뜨는 진행 영역은 알림과 별개 표면입니다(이력 1일). 그쪽은 list_async_jobs·get_async_job로 봅니다. 이 절의 도구는 개인 알림함만 다룹니다.

list_notifications

내 알림을 최신순으로 보고, 맨 위에 읽지 않은 개수를 함께 표시합니다. "알림 왔어?"에 이 도구로 답합니다.

  • 주요 인자: page, page_size
  • 제약: 서버에 읽음여부·기간 필터가 없습니다 — 페이지 단위로 훑으며 is_read 열로 직접 판단해야 합니다. (백엔드 필터 신설은 승격 요청 B21 참고.)

get_notification

알림 1건의 제목·본문·연관 데이터·읽은 시각을 봅니다. 조회만으로 읽음 처리되지 않습니다.

  • 주요 인자: id

manage_notifications

알림의 읽음 상태를 바꿉니다.

  • 주요 인자: action (mark_read|mark_unread|mark_all_read), id
  • 동작: mark_read/mark_unread 는 id 가 필요하고, mark_all_read 는 id 없이 내 알림 전체를 읽음 처리합니다. 전체 처리를 되돌리는 일괄 액션은 없습니다 — 실행 전에 확인하세요.
  • 범위 밖: 알림 삭제는 도구로 노출하지 않습니다.