Project

General

Profile

Feature #1556

open
YK YK

[T16] 사용자 프로필 CRUD API

Feature #1556: [T16] 사용자 프로필 CRUD API

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

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

90%

Estimated time:

Description

등록 정보

  • 신청자: 김여름 (GitHub ID: kyrdufmal-summer)
  • 신청 상태: 신청. 사용자 요청으로 담당자 김여름(계정 표시명: Yeoreum Kim) 지정. PM 승인 여부는 별도 확인.
  • 영역: Backend / 작업지시서 우선순위: P1
  • 등록은 착수·완료 또는 PM 승인 확정을 의미하지 않음. 일정 미정.

목적

/api/v1/me 조회·부분수정/유효성 검사를 DB User/Profile 계약에 맞춰 구현.

개발 범위

사용자 ID는 인증 주체에서만 산출. PATCH omitted/null 구분. email 및 공개범위, 중복/404/422 테스트.

선행조건

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

산출물

router/service/repository/schema; Swagger 증빙; pytest.

  • 개인 브랜치: task/t16-short-name (담당 확정 후 생성)

완료 기준

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

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

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

제한·중단 조건

  • Staging 작성 테스트는 최소권한 앱 계정 확보 후 승인된 Fixture에서만.
  • 승인 없이 공용 Staging DB Schema/DDL/Seed 및 운영 컨테이너·배포 설정 변경 금지. 로컬/격리 테스트 우선.

GitHub 작업지시서 원문

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


Add

Subtasks


Add

Related issues

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

  • Due date set to 11/20/2026
  • Start date set to 11/16/2026

YK Updated by Yeoreum Kim 11 days ago Actions #2

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

YK Updated by Yeoreum Kim 11 days ago Actions #3

  • Status changed from New to In Progress
  • % Done changed from 0 to 10

T16 착수 및 로컬 구현/격리 DB 검증 결과 (2026-11-06)

PR: https://github.com/ai-career-platform/ai-career-platform/pull/40 (Draft)
BRANCH=task/t16-profile-api
TESTED_COMMIT=dc772add07bd329a6a66f0c6ca07ad4df7e071de
T16_STATUS=PARTIAL / 실제 작업 진행 중

GET/PATCH /api/v1/me, Router/Service/Repository/DTO, omit/null, 입력 검증, 본인 접근 제한, problem+json 오류 및 트랜잭션 롤백 구현. 이메일 변경/공개 프로필/임의 POST·DELETE는 T06 계약 밖이므로 추가하지 않음.

로컬: Python 3.13.7 + PostgreSQL 18.4, 57 passed (PostgreSQL 통합 5개 포함). 임시 localhost DB와 비관리자 writer로 검증하고 테스트 서버 종료.
GitHub CI: Python 3.12 + PostgreSQL 18.1, 57 passed. Backend 및 기존 CI Smoke Test 성공.
CI: https://github.com/ai-career-platform/ai-career-platform/actions/runs/42182082561/job/127773764341
상세 재현·계약: https://github.com/ai-career-platform/ai-career-platform/blob/task/t16-profile-api/docs/work-orders/initial-30/T16_IMPLEMENTATION.md

BLOCKER: T14 DB 연결 Draft PR #25(HOLD) 및 T15 실제 JWT/세션 인증이 main에 없음. 테스트는 합성 인증 주체를 의존성 주입하며 기본 앱은 미연동 시 401/503으로 차단. 실제 인증/운영 연동 PASS를 의미하지 않음.

다음: T14/T15 연동 계약·PM 승인, 코드 리뷰 후 실연동 검증. 아직 Review/90%나 Closed/100%로 올리지 않음. 공유 Staging DB·PoC·배포 설정 변경 없음. 기존 계획 일정 유지.

Updated by Anonymous 8 days ago Actions #4

  • % Done changed from 10 to 90

[T16 진행 기록 — main 병합 완료, Staging QA 대기] (2026-11-09)

■ 개발·병합

■ 로컬 재현 (2026-11-09 14:15 KST)

  • main f0118b6, Windows 11 / Python 3.12.13
  • backend pytest: 312 수집, 231 passed / 0 failed / 81 skipped (skip은 격리 DB 필요 테스트), 종료 코드 0

■ 배포·Staging

  • Staging 이미지 포함: YES — #126 (dbaa4ed)로 정식 Backend 통합
  • 자동 배포 게시(staging-publish): main f0118b6 기준 success
    https://github.com/ai-career-platform/ai-career-platform/actions/runs/42566143755
  • Ubuntu 실제 배포·실행 SHA: NOT_VERIFIED (서버 내부에서만 확인 가능)
  • Staging 인증 GET/PATCH 검증: HOLD — 승인된 테스트 계정 필요 (poc/staging/T16_INTEGRATION.md)

■ 상태

  • DEPLOY: HOLD (서버 배포 확인 전) / STAGING_QA: HOLD
  • 공용 DB 쓰기·스키마 변경: 없음
  • 다음: 테스트 계정 준비 후 Staging에서 GET/PATCH 확인 → 결과 댓글 → 종료 요청

YK Updated by Yeoreum Kim 8 days ago Actions #5

※ 바로 위 "이름없음" 댓글(2026-11-09 14:30)은 본인(김여름)이 로그인하지 않은 상태로 작성한 것입니다. 작성자 기록을 위해 같은 내용을 다시 남깁니다.

[T16 진행 기록 — main 병합 완료, Staging QA 대기] (2026-11-09)

■ 개발·병합

■ 로컬 재현 (2026-11-09 14:15 KST)

  • main f0118b6, Windows 11 / Python 3.12.13
  • backend pytest: 312 수집, 231 passed / 0 failed / 81 skipped (skip은 격리 DB 필요 테스트), 종료 코드 0

■ 배포·Staging

  • Staging 이미지 포함: YES — #126 (dbaa4ed)로 정식 Backend 통합
  • 자동 배포 게시(staging-publish): main f0118b6 기준 success
    https://github.com/ai-career-platform/ai-career-platform/actions/runs/42566143755
  • Ubuntu 실제 배포·실행 SHA: NOT_VERIFIED (서버 내부에서만 확인 가능)
  • Staging 인증 GET/PATCH 검증: HOLD — 승인된 테스트 계정 필요 (poc/staging/T16_INTEGRATION.md)

■ 상태

  • DEPLOY: HOLD (서버 배포 확인 전) / STAGING_QA: HOLD
  • 공용 DB 쓰기·스키마 변경: 없음
  • 다음: 테스트 계정 준비 후 Staging에서 GET/PATCH 확인 → 결과 댓글 → 종료 요청

YK Updated by Yeoreum Kim 8 days ago Actions #6

[T16 로컬 E2E 확인] (2026-11-09 15:46 KST)

  • 환경: main ad97f29, 정식 Backend + 로컬 일회용 PostgreSQL 18.4 (migration 0001·0002 + seed)
  • 시나리오: 합성 계정 2개 가입·로그인 → GET/PATCH /api/v1/me
  • 결과: 21/21 PASS
    • 정상: 조회, 일부 수정, null 삭제, 표시 이름 수정, DB 실제 저장 확인
    • 거부 422: display_name null, 빈 요청, 이메일 변경, user_id 지정, 길이 초과, 타입 오류, 쿼리로 타 사용자 지정
    • 거부 401: 토큰 없음, 위조 토큰
    • 본인 격리: B는 A 정보 조회·변경 불가
    • Cache-Control: no-store, Swagger GET/PATCH 표시 확인
  • 전체 backend pytest (DB 테스트 포함): 354 passed / 0 failed / 0 skipped
  • 공용 DB 접속·변경: 없음
  • 남은 것: Staging 확인 HOLD (공용 DB 서버 11/9 무응답, 승인된 테스트 계정 필요)

Also available in: PDF Atom