Project

General

Profile

Feature #1526

open
LY

[T18] 기업·채용공고 조회·검색 API 구현

Feature #1526: [T18] 기업·채용공고 조회·검색 API 구현

Added by Anonymous 11 days ago. Updated 11 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
11/16/2026
Due date:
11/20/2026 (Due in 3 days)
% Done:

0%

Estimated time:

Description

작업 개요

  • 검토 상태: READY_FOR_REVIEW (착수/완료를 의미하지 않음)
  • 작업 종류: 개발 전 1차 작업지시서 후보 · PM/담당자 승인 필요
  • 담당 역할: Backend · 우선순위: P1 · 실제 담당자: 미배정
  • 선행 일감: T05, T06, T13, T14, T09, T10
  • 기준 브랜치: main · 개인 브랜치: task/t18-short-name

1. 목적과 작업 범위

기업 목록/상세, 채용공고 목록/상세, 상태·날짜·직무 필터, 페이지네이션 및 공고 요구 기술 조회 API를 구현한다.
공고 중복·만료 및 외부 출처 메타데이터 처리, 없는 공고·조회 권한·DB 인덱스 사용을 검증한다.

2. 작업 수행 지시

  1. 작업 시작 전 main 기준 관련 문서를 읽고 미확정 요구사항을 기록한다.
    • docs/FULL_SCOPE_TRACEABILITY.md
    • docs/API_CONTRACT.md
    • database/FULL_DATABASE_MODEL.md
  2. 공고 중복·만료, 외부 출처 메타데이터, 페이지네이션, 없는 공고, 조회 권한 및 index 사용을 검증한다.
  3. 기존 운영과 분리된 개인 브랜치(task/t18-short-name)에서 관련 코드·테스트·설명서를 함께 작성한다.
  4. 가능하면 로컬 또는 일회용 DB에서 먼저 검증한다. 승인 없이 공유 Staging DB·서비스를 변경하지 않는다.

3. 산출물

  • /companies, /job-postings 관련 서비스 및 SQL
  • Swagger API 명세 및 pytest 테스트

4. 완료 기준 (Definition of Done)

  • 기업·공고 조회/검색/페이징 및 오류/중복 검증 PASS
  • 테스트·실행 결과와 재현 명령을 PR 설명에 기록
  • 문서/코드/테스트 PR 리뷰 완료 및 CI 결과 확인
  • CI가 범위를 검증하지 못하면 PARTIAL로 표기
  • 작업과 무관한 파일 변경 및 민감정보·비밀번호·토큰이 포함되지 않음

5. 필수 증빙

  • 실제 실행 명령 또는 UI 캡처(비밀정보 마스킹)
  • 정상 및 예외/거부 케이스 각각 1개 이상(해당되는 경우)
  • PR URL, 테스트 실행 SHA, 영향 범위와 미해결 항목

6. 주의·작업 중단 조건

  • 외부 실제 공고 수집은 라이선스/사용권한 승인 전 금지
  • 필요한 권한·환경 미확보 시 HOLD 보고

7. 담당자 확인 체크리스트

  • 작업 범위와 선행조건 확인
  • 필요한 권한·환경 확보(미확보 시 HOLD)
  • 개인 브랜치 및 PR 생성
  • 산출물과 검증 증빙 제출
  • 리뷰 피드백 반영 및 완료 승인

상태 보고

T18_STATUS=NOT_STARTED
PR_URL=
EVIDENCE=
BLOCKER=

사용 가능한 상태: NOT_STARTED | IN_PROGRESS | PASS | PARTIAL | HOLD


Add

Subtasks


Add

Related issues 1 (0 open — 1 closed)

Precedes Feature #1553: [T39] 관심 채용공고 북마크 APIClosed지나 팡11/23/202611/26/2026

Remove relationActions

Also available in: PDF Atom