Project

General

Profile

Feature #1520

open
성최 성최

[통합] AI Career Platform 1차 작업지시서

Feature #1520: [통합] AI Career Platform 1차 작업지시서

Added by 성호 최 11 days ago. Updated 11 days ago.

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

0%

Estimated time:
(Total: 0:00 h)

Description

작성 기준: 2026-11-06 / 기준 브랜치: main / 담당자 배정·개별 착수 전 검토용

목적 및 산출물

DB, Backend, Frontend, AI/ML, QA·DevOps 개발자가 요구사항·산출물·검증 기준을 확인하고 개인 브랜치에서 독립적으로 작업할 수 있도록 1차 작업지시서 30개를 작성했습니다. 이 일감은 작성한 지시서를 모아 검토하는 용도입니다. 담당자·일정은 이 초안에서 미확정이며, 기존 개별 일감의 실제 상태와 담당자는 Redmine을 기준으로 확인합니다. 문서 작성 상태는 AUTHORED입니다. 기능 구현 및 검증 상태는 개별 일감과 PR에서 확인합니다.

사용 방법

  1. PM/PL은 선행조건과 미확정 요구를 검토하고 담당자·기간·Redmine 이슈를 정합니다.
  2. 개발자는 해당 T번호 문서의 담당자 확인 체크리스트를 검토합니다.
  3. main 기준 task/t##-short-name 개인 브랜치에서 작업하고 PR에 실행 명령, 테스트, 화면·Swagger 증빙을 첨부합니다.
  4. 실제 완료 기준 검증 시 PASS, 미검증은 PARTIAL, 선행조건·권한 미확보는 HOLD로 기록합니다.
  5. Staging DB DDL·Seed 및 기존 운영·자동배포 설정 변경에는 PM/JM 별도 승인이 필요합니다.

일감 목록 및 개별 지시서

공통 환경·설계

  • T01 DB 개발환경 세팅 가이드
  • T02 Backend 개발환경 세팅 가이드
  • T03 Frontend 개발환경 세팅 가이드
  • T04 전체 기능·화면 요구사항 기준선 확정
  • T05 전체 DB ERD 및 테이블 계약 확정
  • T06 전체 API·DTO 계약 확정

Database

  • T07 DB 계정·권한·접근 제한 검증
  • T08 PostgreSQL Migration 체계 구축
  • T09 전체 DB Schema 생성 SQL 작성
  • T10 초기 Seed·Fixture 데이터 제작
  • T11 DB 제약조건·인덱스·권한 테스트
  • T12 승인된 Staging Migration·Seed 적용

Backend

  • T13 FastAPI 애플리케이션 골격 구축
  • T14 PostgreSQL DB 연결·세션 수명주기
  • T15 인증·인가 API 구현
  • T16 사용자 프로필 CRUD API
  • T17 직무·기술 조회·검색 API
  • T18 기업·채용공고 조회·검색 API

Frontend

  • T19 Frontend 프로젝트 기본 구조·실행
  • T20 Frontend 공통 레이아웃·UI 컴포넌트
  • T21 로그인·사용자 인증 UI
  • T22 사용자 프로필 조회·수정 UI
  • T23 직무·기술 탐색 UI
  • T24 기업·채용공고 탐색 UI

AI/ML

  • T25 AI·ML 공통 데이터·Feature 계약
  • T26 Skill Gap 규칙 기반 Baseline
  • T27 직무 적합도·추천 규칙 기반 Baseline

QA·DevOps

  • T28 PR·CI·QA 기본 정책 검증 강화
  • T29 Frontend↔Backend 통합 API 회귀 테스트
  • T30 1차 Staging 통합 배포·운영 검증

선행 관계 및 작업 순서

  • T01~T04와 T28의 현 CI 상태 점검은 독립 착수 가능합니다. 환경 가이드는 실제 PoC 코드를 기준으로 작성합니다.
  • T04 이후 T05·T06 설계를 확정합니다. S03의 46개 테이블은 검토 후보입니다.
  • DB 경로는 T07 권한 → T08 Migration → T09 DDL → T10 Seed → T11 제약·권한 테스트 → T12 승인된 Staging 적용입니다. 상세 선행조건은 개별 지시서를 따릅니다.
  • T13·T19 골격은 합의된 API Mock과 독립 환경에서 병렬 시작할 수 있습니다. T14T18·T20T24는 기반 기능에 맞춰 병합합니다.
  • T25 데이터 계약, T26~T27 baseline, T29 E2E, T30 Staging 통합 검증을 진행합니다.

환경 및 변경 제한

  • 2026-11-06 기준 main에는 poc/, docs/, database/가 있고 독립 backend/, frontend/는 계획 범위입니다.
  • Staging PostgreSQL 18.1의 내부망 프록시 연결을 확인했습니다. 읽기 계정의 권한 부정 테스트와 접근 제한·전송 암호화 증빙은 남아 있습니다.
  • SUPERUSER 비밀번호는 공유하지 않습니다. 별도 최소권한 계정이 준비될 때까지 Backend 로컬 쓰기는 HOLD입니다.
  • 기존 Ubuntu Auto-CD의 Compose SHA 보호와 운영 설정을 유지합니다. 실습을 위해 compose.yaml이나 automation/config.json을 바꾸지 않습니다.
  • docker compose down -v, 글로벌 Docker prune, 실제 DB 초기화, 공개 채널의 비밀번호·토큰 게시를 금지합니다.

공통 PR 증빙 템플릿

[AI Career Platform 일감 작업 완료 보고]
- 일감 ID / 제목:
- 담당자:
- Redmine Issue: (미등록이면 NONE)
- 브랜치 / PR URL:
- 구현/문서 변경 범위:
- 선행조건 완료: YES / HOLD
- 로컬 실행·테스트 명령:
- 정상/예외 증빙:
- CI run URL / SHA:
- DB Schema 또는 Seed 변경: YES / NO
- Staging 서비스 변경: YES / NO
- 보안·복구·특이사항:
- 최종 상태: PASS / PARTIAL / HOLD

관련 문서


Add

Subtasks 2 (2 open — 0 closed)

Feature #1528: [T21] 로그인·사용자 인증 UINewDONGHYUN Woo11/12/202611/17/2026

Remove subtaskActions
Feature #1543: [T22] 사용자 프로필 조회·수정 UINewDONGHYUN Woo11/16/202611/20/2026

Remove subtaskActions

Add

Related issues

성최 Updated by 성호 최 11 days ago Actions #1

  • Subject changed from [통합] AI Career Platform 1차 일감 30개 작업지시서 to [통합] AI Career Platform 1차 작업지시서

Updated by Anonymous 11 days ago Actions #2

  • Subtask #1528 added

Updated by Anonymous 11 days ago Actions #3

  • Subtask #1543 added

성최 Updated by 성호 최 11 days ago Actions #4

  • Assignee set to 성호 최

Also available in: PDF Atom