Feature #1557
closed
YK
상이
[T33] 내 보유 기술·숙련도 API
Feature #1557:
[T33] 내 보유 기술·숙련도 API
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.
- 개인 브랜치: task/t33-user-skills-api
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/138
- Merge SHA: 67c162c (main)
완료 기준¶
- 정상 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 작업지시서 원문¶
Subtasks
Related issues
YK Updated by Yeoreum Kim 11 days ago
- Description updated (diff)
- Assignee set to Yeoreum Kim
Updated by Anonymous 9 days ago
Updated by Anonymous 9 days ago
- 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
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에서 실행하지 않음
- 테스트 사용자: t33-staging-test@example.com 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 결정 대기
- 테스트 사용자 t33-staging-test@example.com 삭제 여부 PM 확인 (보유 기술은 비움)
Updated by Anonymous 8 days ago
리뷰 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
PR #138 main 머지 확인 (67c162c) + 머지 후 Swagger 확인 PASS
https://github.com/ai-career-platform/ai-career-platform/pull/138
- 로컬 Backend(main, 67c162c 포함) + Staging DB, Swagger UI에서 테스트 사용자 t33-staging-test@example.com으로 확인
- 로그인 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
- Description updated (diff)
- Status changed from In Progress to Closed
- % Done changed from 90 to 100
완료 — PR #138 main 머지(67c162c), T33_STATUS=PASS
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/138
- API: GET /api/v1/me/skills, PUT /api/v1/me/skills (전체 교체)
- 검증: Backend tests #22 360 passed / 0 failed / 27 skipped (https://github.com/ai-career-platform/ai-career-platform/actions/runs/42569044875), Staging 수동 확인 13/13 PASS, 머지 후 Swagger 확인 PASS
- 앱 연결 계정: PM 결정 — 학습용 프로젝트라 별도 role(career_app) 분리는 하지 않고 현행 계정 유지. STAGING_APP_ACCOUNT=HOLD 해제 (T07 ACCESS_MATRIX의 SUPERUSER 위험은 기록으로 유지)
- 테스트 사용자 t33-staging-test@example.com: 보유 기술 비움, 계정은 유지