Project

General

Profile

Feature #1557

closed
YK 상이

[T33] 내 보유 기술·숙련도 API

Feature #1557: [T33] 내 보유 기술·숙련도 API

Added by Yeoreum Kim 11 days ago. Updated 8 days ago.

Status:
Closed
Priority:
High
Assignee:
Start date:
11/09/2026
Due date:
11/26/2026
% Done:

100%

Estimated time:

Description

등록 정보

  • 담당자: 이상재 (GitHub ID: sangjae-lee97) — 2026-11-09 김여름(kyrdufmal-summer)에서 담당 변경
  • 영역: Backend / 작업지시서 우선순위: P1

목적

인증 사용자의 보유 스킬 조회·추가·수정·삭제 및 숙련도 범위 검증 구현.

개발 범위

유효 스킬 코드, 중복 삽입, 숙련도 상·하한, 타인 user_id 접근 차단과 PATCH/PUT 의미 테스트.

선행조건

  • 선행 일감: T05,T06,T14,T15,T17
  • 관련 요구사항 및 DB/API 계약의 확정·미확정 사항 확인. 선행 결과의 실제 완료 증빙 또는 명시적으로 승인된 mock 계약 확인 후 구현. 선행 미완료 시 설계/mock 범위로 제한하고 실제 연동은 HOLD.
  • 참조: docs/FULL_SCOPE_TRACEABILITY.md, docs/API_CONTRACT.md, database/FULL_DATABASE_MODEL.md, docs/AI_SYSTEM_ARCHITECTURE.md

산출물

/api/v1/me/skills 관련 API·서비스·Repository·pytest.

완료 기준

  • 정상 CRUD·422·404·중복/소유권 테스트 통과.
  • 정상·오류·입력 경계 및 권한/보안 테스트의 재현 가능한 증빙 제출.
  • 코드·문서·테스트 PR 리뷰 및 CI 결과 확인. mock/격리 환경만 검증했거나 CI가 범위를 검증하지 못하면 PARTIAL, 미실행 검사를 PASS로 표시하지 않음.
  • 작업과 무관한 변경 및 비밀정보·실제 사용자 개인정보 노출 없음.

테스트 증빙 (개발 후 제출)

  • 실제 실행 명령과 재현 방법, 테스트 로그, 정상 및 예외/거부 사례.
  • Swagger 또는 해당 화면 캡처(비밀정보 마스킹), PR URL, CI 실행 URL, 테스트 커밋 SHA.
  • 영향 범위, 미해결 항목, BLOCKER 기록. 현재 개발·테스트 미수행.

제한·중단 조건

  • skills 사전/숙련도 정의가 미승인이면 DTO·mock 우선.
  • 승인 없이 공용 Staging DB Schema/DDL/Seed 및 운영 컨테이너·배포 설정 변경 금지. 로컬/격리 테스트 우선.

GitHub 작업지시서 원문

https://github.com/ai-career-platform/ai-career-platform/blob/docs/next-30-work-orders-20261106/docs/work-orders/next-30/T33.md


Add

Subtasks


Add

Related issues

길문 Updated by 길래 문 11 days ago Actions #1

  • Due date set to 11/26/2026
  • Start date set to 11/23/2026

YK Updated by Yeoreum Kim 11 days ago Actions #2

  • Description updated (diff)
  • Assignee set to Yeoreum Kim

Updated by Anonymous 9 days ago Actions #3

  • Description updated (diff)
  • Status changed from New to In Progress
  • Assignee changed from Yeoreum Kim to 상재 이
  • Start date changed from 11/23/2026 to 11/09/2026
  • % Done changed from 0 to 10

담당 변경: 김여름 → 이상재 (팀 협의). 작업 착수 — 브랜치 task/t33-user-skills-api. T41(#1584)·T45(#1585)의 선행이라 먼저 진행

Updated by Anonymous 9 days ago Actions #4

  • Description updated (diff)
  • % Done changed from 10 to 90

PR 생성 + 리뷰 요청(Crasnec)
https://github.com/ai-career-platform/ai-career-platform/pull/138

  • API: GET /api/v1/me/skills(이름순), PUT /api/v1/me/skills(전체 교체, 빈 목록이면 모두 삭제)
  • 검증: 숙련도 1~5·null, 최대 100개, 중복 422 DUPLICATE_SKILL, 없는·보유하지 않은 폐기 기술 422, user_id 422, 비로그인 401, DB 오류 503(롤백)
  • T17(#117) 기준: Skill DTO·skills 테이블 선언 재사용, 공용 ORM 모델 추가 없음
  • 테스트: 29 passed (T33), 전체 260 passed / 85 skipped (Windows 로컬·클라우드 동일), PostgreSQL 16 일회용 DB(T05 DDL + T10 Seed) 7 passed
  • Swagger 화면 확인은 T34(#1558) 연동 때 진행
  • Staging 변경 없음

Updated by Anonymous 8 days ago Actions #5

T33 Staging 수동 확인 — T33_STAGING_MANUAL=PASS (13/13)
https://github.com/ai-career-platform/ai-career-platform/pull/138

  • 방법: PM이 부여한 Staging 테스트 권한으로 로컬 Backend(task/t33-user-skills-api @ 51ca1f5)를 Staging DB에 연결해 HTTP로 확인. pytest는 Staging에서 실행하지 않음
  • 테스트 사용자: 1개만 사용, 기존 Seed 사용자 데이터 변경 없음
  • PASS: DB 연결, 가입·로그인, 기술 검색(T17), 조회, 2개 저장, 교체(1개·숙련도 4), 재조회 일치, 중복 422 DUPLICATE_SKILL, 숙련도 6 → 422, 없는 기술 422, 비로그인 401, 거부 후 데이터 유지, 정리(빈 목록)
  • Staging 사전 점검(career_reader, 읽기 전용): 51개 테이블·컬럼 T09와 동일, T10 Seed 건수 동일, 약관 3건

남은 사항

  • 리뷰 P0: PostgreSQL 테스트 정렬 비교 수정 커밋 push 후 Backend tests 결과·HEAD SHA를 PR에 기록 (POSTGRESQL_TEST=FIX_REQUIRED → 재검증 대기)
  • STAGING_APP_ACCOUNT=HOLD: Staging에 career_app 역할 없음. 이번 확인은 ai_career_poc(SUPERUSER)로 수행. 앱 연결 계정(A: career_app 생성 / B: 현행 유지) PM 결정 대기
  • 테스트 사용자 삭제 여부 PM 확인 (보유 기술은 비움)

Updated by Anonymous 8 days ago Actions #6

리뷰 P0 반영 — POSTGRESQL_TEST=PASS (재검증 요청)
https://github.com/ai-career-platform/ai-career-platform/pull/138

  • 수정: 1d1e0ef — tests/test_my_skills_postgres.py 정렬 비교를 같은 DB의 ORDER BY skills.name, skills.skill_id 결과와 직접 비교 (API·DB·Migration 변경 없음)
  • main 충돌 해결: 3695854 (main ad97f29 병합, api_v1.py·README 양쪽 유지)
  • 일회용 PostgreSQL(ko-KR Collation)에서 CI 실패 재현 후 수정본 7 passed
  • GitHub Actions Backend tests #22: 360 passed, 0 failed, 27 skipped
    https://github.com/ai-career-platform/ai-career-platform/actions/runs/42569044875
  • 최종 HEAD SHA: 3695854918cb7caa55351aede8401641a07a2a1b
  • 남은 사항: STAGING_APP_ACCOUNT=HOLD(앱 계정 A/B PM 결정), 테스트 사용자 삭제 여부 PM 확인

Updated by Anonymous 8 days ago Actions #7

PR #138 main 머지 확인 (67c162c) + 머지 후 Swagger 확인 PASS
https://github.com/ai-career-platform/ai-career-platform/pull/138

  • 로컬 Backend(main, 67c162c 포함) + Staging DB, Swagger UI에서 테스트 사용자 으로 확인
  • 로그인 200 → GET /me/skills 200 [] → PUT (pytest, 숙련도 3) 200 → GET 200 일치 → 정리 PUT {"items":[]} 200 []
  • 중간 422 2건은 입력 실수에 대한 정상 거부(저장 변화 없음)
  • 확인 후 서버 종료·토큰 로그아웃, 비밀번호·토큰 미기록
  • 남은 사항: STAGING_APP_ACCOUNT=HOLD(앱 연결 계정 A/B), 테스트 사용자 삭제 여부 — PM 결정 대기

Updated by Anonymous 8 days ago Actions #8

  • Description updated (diff)
  • Status changed from In Progress to Closed
  • % Done changed from 90 to 100

완료 — PR #138 main 머지(67c162c), T33_STATUS=PASS

Also available in: PDF Atom