Project

General

Profile

Actions

Feature #1130

closed
지팡 지팡

Feature #1129: [ROADMAP] AX2 Classroom Jukebox 전체 개발 계획

[STEP 01] 프로젝트 기반과 FastAPI 개발 환경 구축

Feature #1130: [STEP 01] 프로젝트 기반과 FastAPI 개발 환경 구축

Added by 지나 팡 22 days ago. Updated 14 days ago.

Status:
Closed
Priority:
Normal
Assignee:
Start date:
11/03/2026
Due date:
11/04/2026
% Done:

100%

Estimated time:

Description

h2. 목표

프로젝트 기본 구조를 만들고 FastAPI 서버와 자동 테스트를 실행할 수 있게 합니다.

h2. 작업

  • 저장소 기본 디렉터리 구성
  • Python 가상환경과 의존성 파일 구성
  • FastAPI 애플리케이션과 GET /health/live 구현
  • .gitignore, .env.example, README 작성
  • pytest와 GitHub Actions 구성

h2. 완료 기준

  • 로컬 서버와 /docs가 열린다.
  • health API가 200을 반환한다.
  • pytest와 CI가 통과한다.

h2. 선행 작업

없음

지팡 Updated by 지나 팡 18 days ago Actions #1

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

h3. 작업계획

  1. 기존 프로젝트 구조와 STEP 01 요구사항을 비교합니다.
  2. Python 가상환경과 의존성 구성을 점검합니다.
  3. FastAPI 서버, GET /health/live, /docs 동작을 확인합니다.
  4. .gitignore, .env.example, README 구성을 점검합니다.
  5. pytest와 GitHub Actions 실행 결과를 확인합니다.
  6. 부족한 부분은 별도 작업 브랜치에서 수정합니다.
  7. 작업계획 컨펌 후 개발을 진행하고, 완료 시 PR로 전체 검수를 요청합니다.

h3. 산출물 및 검증 기준

  • FastAPI 애플리케이션이 정상 실행됩니다.
  • /health/live가 HTTP 200을 반환합니다.
  • /docs 화면을 열 수 있습니다.
  • pytest와 GitHub Actions가 통과합니다.
  • 환경 설정 방법이 README와 .env.example에 정리되어 있습니다.

h3. 진행 참고

기존에 구현된 코드가 있으므로 삭제하거나 처음부터 다시 만들지 않고, 요구사항과 비교하여 누락된 부분만 보완하겠습니다. 교수님 컨펌 전에는 추가 코드 수정을 진행하지 않겠습니다.

지팡 Updated by 지나 팡 14 days ago Actions #2

  • Due date set to 11/04/2026
  • Start date set to 11/03/2026
  • % Done changed from 10 to 90

h3. 개발 완료 및 전체 검수 요청

  • STEP 01 완료 기준을 다시 점검했습니다.
  • Swagger UI /docs 접근 자동 테스트를 추가했습니다.
  • 로컬 pytest 42개 테스트가 모두 통과했습니다.
  • Alembic 최신 버전 0004 (head), Python 컴파일 검사, Git 공백 검사가 통과했습니다.
  • GitHub Actions CI가 성공했습니다.

PR: https://github.com/GilbertMoon/jina-classroom-jukebox/pull/14
CI: https://github.com/GilbertMoon/jina-classroom-jukebox/actions/runs/41586611243

검토 후 승인 및 머지를 부탁드립니다. 승인 전까지 상태는 In Progress, 진척도는 90%로 유지합니다.

지팡 Updated by 지나 팡 14 days ago Actions #3

  • Status changed from In Progress to Closed
  • % Done changed from 90 to 100

h3. 완료 처리

  • 교수님 PR 검토 및 승인을 확인했습니다.
  • PR #14가 main 브랜치에 정상적으로 머지되었습니다.
  • 머지 커밋: 61556ab8b290d7aff40d0d4ea02d86899f2b8405
  • STEP 01 완료 기준과 CI 성공을 확인했습니다.

STEP 01을 100% 완료하고 일감을 종료합니다.

Actions

Also available in: PDF Atom