Feature #1526
open
LY
[T18] 기업·채용공고 조회·검색 API 구현
Feature #1526:
[T18] 기업·채용공고 조회·검색 API 구현
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. 작업 수행 지시¶
- 작업 시작 전 main 기준 관련 문서를 읽고 미확정 요구사항을 기록한다.
- docs/FULL_SCOPE_TRACEABILITY.md
- docs/API_CONTRACT.md
- database/FULL_DATABASE_MODEL.md
- 공고 중복·만료, 외부 출처 메타데이터, 페이지네이션, 없는 공고, 조회 권한 및 index 사용을 검증한다.
- 기존 운영과 분리된 개인 브랜치(task/t18-short-name)에서 관련 코드·테스트·설명서를 함께 작성한다.
- 가능하면 로컬 또는 일회용 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
Subtasks