feat(backend): 아임웹 회원 유입경로·신청 기록 관리자 API 추가

아임웹 관리자 페이지에서 회원을 유입경로·그룹 기준으로 보고, 무료 강의 신청을
기록·조회하기 위한 백엔드다. 관리자 화면(아임웹)과 API(wandergo.net)가 다른 사이트라
인증은 쿠키 대신 Bearer 토큰으로 한다.

- 관리자 인증: env 단일 계정(ADMIN_USERNAME/PASSWORD)을 여러 사람이 공유,
  기기별 세션(로그아웃은 그 기기만, 비밀번호 변경 시 전체 무효)
- 아임웹 Open API 연동: OAuth 연결·토큰 갱신, 회원·그룹 주기 동기화,
  가입 폼 '홈페이지' 항목의 유입정보 파싱, 회원 엑셀 '유입경로' 가져오기 스크립트
- 회원 조회: 유입경로·그룹·기간 필터, 유입원 집계
- 강의 신청 기록: 신청 완료 화면이 보내는 공개 API(회원 확인·중복 방지·요청 제한),
  오픈카톡 클릭 기록, 관리자 신청 내역 조회
- CORS 다중 도메인, env 검증(운영 필수값), CI e2e 전 마이그레이션 적용,
  개발 컨테이너 메모리 한도 2g, 에러 코드 IMWEB_001~005·APPLY_001

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-05 16:21:25 +09:00
parent 4be82a716b
commit c54df9cefa
84 changed files with 6612 additions and 132 deletions
+19 -1
View File
@@ -40,7 +40,8 @@ REDIS_DATA_DIR=./data/redis
# API 경로 설정
# ==========================================
BACKEND_API_URL=http://localhost:3000/api
CORS_ORIGIN=http://localhost:5173
# 127.0.0.1:5173 은 imweb/serve-local.js 로 관리자 화면을 '다른 사이트' 조건(운영의 아임웹 ↔ wandergo.net)으로 띄울 때 쓴다
CORS_ORIGIN=http://localhost:5173,http://127.0.0.1:5173
# ==========================================
# Rate Limiting (API 남용 방지)
@@ -79,3 +80,20 @@ COMPOSE_PROFILES=
# ==========================================
UPLOAD_DATA_DIR=./data/uploads
UPLOAD_MAX_SIZE_MB=5
# ==========================================
# 아임웹 연동 (회원 유입경로 관리자 화면)
#
# 비밀값(IMWEB_CLIENT_ID / IMWEB_CLIENT_SECRET)은 backend/.env.{APP_ENV} 에 둔다.
# OAuth redirect URI 는 BACKEND_API_URL + /imweb/oauth/callback 으로 자동 계산된다
# → 아임웹 개발자센터 앱 설정의 redirect URI 와 **정확히 같아야** 한다.
#
# IMWEB_SITE_CODE 아임웹 사이트 코드 (사이트 HTML 의 siteCode 값)
# IMWEB_ADMIN_PAGE_URL 아임웹 연결을 마친 뒤 돌아갈 관리자 화면 주소
# IMWEB_SYNC_INTERVAL_MINUTES 회원 전체 동기화 주기 (분, 기본 60)
# IMWEB_PAGE_SIZE 동기화 때 한 번에 받는 회원 수 (기본 100)
# ==========================================
IMWEB_SITE_CODE=S20230730923b9e1418574
IMWEB_ADMIN_PAGE_URL=http://localhost:5173/imweb-members.html
IMWEB_SYNC_INTERVAL_MINUTES=60
IMWEB_PAGE_SIZE=100