Skip to content

MVP 백엔드 범위 확정과 핵심 학습 API 정리 - #8

Merged
Sadturtleman merged 2 commits into
mainfrom
codex/mvp-backend
Nov 8, 2026
Merged

Sadturtleman merged 2 commits into
mainfrom
codex/mvp-backend

Conversation

@Sadturtleman

@Sadturtleman Sadturtleman commented Nov 7, 2026 •

Copy link
Copy Markdown
Owner

Summary

기본 서버를 MVP 모드로 전환합니다. 8개 주제의 로그인·학습·코드 저장·격리 실행·채점·추적을 제공하고 관리자·리뷰·문의·분석 전송·내보내기를 비활성화합니다.

PRODUCT_MODE=mvp (default)
  config: 지원 기능·주제·실행 제한
  core API: 인증 → 학습 → 기록 → 실행·추적
  maintenance: 만료 정리·워커 임대 회복·호스트 관리
  excluded: 관리자·리뷰·비즈니스 이벤트·PDF·Android

기존 웹은 config를 따라 제외 API 호출과 메뉴를 생략합니다. DB 테이블과 기존 데이터는 보존하며 새 마이그레이션은 없습니다. FE 계약과 실행·롤백 방법은 docs/mvp-backend.md에 있습니다.

Evidence

  • Before: 서버가 관리자·리뷰·PDF API와 분석 전송을 활성화하고 웹 초기화에서 리뷰 이용량을 필수 조회했습니다.
    After: MVP API 검사에서 제외 기능 404, 8개 주제, 코드 저장·실행 중복 방지·추적·소유권·임대 회복과 이벤트 원장 0건을 확인했습니다.

  • 타입 검사·전체 빌드 통과. 최신 CI에서 PostgreSQL 포함 단위/API 검사 63개, 기존 브라우저 22개와 MVP 브라우저 1개가 통과했습니다.

  • MVP Playwright 검사 통과: 학습·예측·편집기·새로고침, 제외 API 미호출.

  • 실제 Firecracker/KVM에서 8개 주제 × 3개 언어 = 24개 프로그램과 공개 테스트 60회 모두 AC 및 추적 수집을 확인했습니다. 경계 8개와 세 언어 객체 참조·단일 스레드 검사 6개도 통과했습니다. VM 검사

  • GCP 결제 활성화 후 Supabase 일시 중지를 해제하고 Cloud Run에 MVP 이미지를 배포했습니다. 누락된 워커 이미지·전용 네트워크·워커 2대를 복구했습니다.

  • 운영 API → Supabase 큐 → 두 Firecracker 워커 → GCS 추적 저장 → 결과 조회에서 24개 프로그램·공개 테스트 60건 모두 AC와 추적 수집을 확인했습니다. 임시 검증용 DB 세션을 사용했으며 실제 Google OAuth 완료 검증을 대신하지는 않습니다.

  • 운영 /api/config MVP 모드, 비로그인 API 401, 제외 기능 404, 브라우저 HTML 경로 응답 200을 확인했습니다. 워커 대기열 자동 시작과 최대 4개 동시 실행을 확인했습니다.

  • 배포 이미지: us-central1-docker.pkg.dev/algostep/algostep/api:f613b6d4-ee29-4233-9d75-46f6c49921e0. 워커 이미지: algostep-worker-mvp-20261108.

  • 임시 검증 계정·세션·기록을 정리하고 추적 삭제 유지보수를 실행했습니다. 임시 빌더 VM·디스크·계정 제거와 소스 읽기 권한 회수를 완료했습니다.

  • 유휴 기준을 검증 중에만 60초로 줄여 Scheduler의 두 워커 자동 중지 요청을 확인했습니다. 운영 기준은 900초(15분)로 복원했고 최종 리비전 algostep-mvp-verified의 트래픽 100%와 두 워커 TERMINATED를 확인했습니다.

Merge Danger

Door: two-way

테이블 삭제 없음. 이전 이미지로 롤백 가능. full 모드를 다시 켜면 보존한 리뷰·분석 대기 작업도 처리될 수 있습니다.

Blast Radius: application

기본 API 범위가 축소됩니다. API와 호환 웹을 함께 배포해야 합니다. 실제 실행 워커 프로토콜·이미지는 변경하지 않았습니다.

@Sadturtleman
Sadturtleman merged commit 66603b1 into main Nov 8, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant