Project

General

Profile

Feature #1536

open
중안

[T30] 1차 Staging 통합 배포·운영 검증

Feature #1536: [T30] 1차 Staging 통합 배포·운영 검증

Added by Anonymous 11 days ago. Updated 11 days ago.

Status:
New
Priority:
Normal
Assignee:
Start date:
11/23/2026
Due date:
12/04/2026 (Due in 17 days)
% Done:

0%

Estimated time:

Description

GitHub 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/docs/initial-30-work-orders-20261106/docs/work-orders/initial-30/T30.md

검토 및 착수 조건

  • 담당 역할: QA/운영. 신청자: 안중섭 (GitHub skshdwkdvkfl55-art). PM 담당 확정 전.
  • 원문 우선순위: P1. 선행 일감: T12, T13, T14, T19, T28, T29. 기준 브랜치: main.
  • 선행 일감이 미완료면 설계 또는 mock까지만 진행하고 실연동은 HOLD로 보고한다.

작업 범위와 산출물

  • 승인된 Frontend·Backend·DB 버전의 Staging 통합 동작과 장애 시 복구 절차를 검증한다.
  • CI→GHCR→Ubuntu Pull 자동배포, /api/version 기대 SHA, DB volume·Seed·권한, 프런트 페이지·API·헬스를 확인하고 성공·실패를 구분한다.
  • 산출물: docs/deployment/RELEASE_EVIDENCE.md, SHA·digest·health 기록, rollback runbook.
  • task/t30-short-name 개인 브랜치에서 작업하고 PR을 연다.

완료 기준 및 주의

  • 승인 릴리스의 화면·API·DB·버전과 상태 Healthy PASS, DB·복구 검증.
  • 대상 외 운영 Docker 프로젝트 금지, DB volume 보존, 자동 migration 금지.
  • PR에 재현 명령, 테스트 결과, CI URL과 SHA를 기록하고 민감정보를 포함하지 않는다.

상태 보고: T30_STATUS=NOT_STARTED|IN_PROGRESS|PASS|PARTIAL|HOLD / PR_URL= / EVIDENCE= / BLOCKER=


Add

Subtasks


Add

Related issues

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

  • Due date set to 12/04/2026
  • Start date set to 11/23/2026

상이 Updated by 상재 이 11 days ago Actions #2

[T06 API 계약 검토 중 발견 — T30 담당 안중섭님 확인 부탁드립니다] (작성: 이상재, T06 #1529)

h3. 경로 접두사 불일치

  • T13 Backend 골격(main, PR #14)은 앱 안에서 @API_V1_PREFIX = "/api/v1"@ 을 씁니다 (backend/app/core/config.py).
  • Staging Nginx는 @/api/@ 를 떼고 FastAPI로 넘깁니다 (poc/staging/README.md, PR #18).
  • 그대로 배포하면 외부 @/api/v1/auth/login@ 요청이 앱에 @/v1/auth/login@ 으로 도착해 404 가 납니다. @/api/health@, @/api/version@ 은 앱 경로가 @/health@, @/version@ 이라 문제없습니다.

h3. 해결안 (둘 중 하나)

앱 접두사를 @/v1@ 로 변경 (Nginx 그대로)

Nginx가 @/api/v1/@ 은 떼지 않고 그대로 넘기도록 변경 (앱 그대로)

API 계약(T06)의 외부 주소 @/api/v1/...@ 는 어느 쪽이든 바뀌지 않습니다.

Also available in: PDF Atom