members.uwksa.ca 변경 이력¶
읽는 방법
이 문서는 주요 변경점을 요약한 기록입니다. 현재 동작의 판단 기준은 항상 membership.py, config.py, docs/DB_SCHEMA.md를 우선합니다.
2026-10-14 WatCard 사진 업로드 용량 초과(413) 대응 및 로그인 개선¶
- 배경: 2026-10-14에 큰 사진 업로드가 Flask(
MAX_CONTENT_LENGTH10MB)와 nginx(client_max_body_size 15m)에서 413으로 거부되었습니다. Roboflow 호출 전에 막혀서signup_photo_validations에 기록이 남지 않았고, 실패 알림 메일도 발송되지 않았습니다. 가입 페이지는 HTML 에러 응답을 JSON으로 읽으려다 실패해서 일반 오류 문구만 보여주었습니다. - 업로드 전 브라우저에서 축소 (
templates/signup.html의shrinkImageForUpload()) - 2MB를 넘는 사진은 긴 변 2048px, JPEG(품질 0.9)로 줄여서
/signup/photo-validate로 보냅니다. - 디코딩에 실패하거나 줄인 결과가 더 크면 원본을 그대로 보냅니다.
- 미리보기 크롭도 줄인 이미지를 기준으로 만듭니다.
- 413 안내 문구
- 서버:
/signup/photo-validate에서 413이 나면IMAGE_TOO_LARGEJSON 에러를 반환합니다(membership.py의handle_request_too_large()). - 프론트: nginx가 HTML로 413을 반환해도 "사진 용량이 너무 큽니다" 안내를 표시합니다.
- 최종 제출 시 사진 재업로드 제거: 사진은 검증 단계에서 이미 서버에 저장됩니다. 최종 폼 제출에서는 파일 입력을 빼서 원본 사진을 다시 보내지 않습니다.
- 로그인 콜백 오류 안내 (
membership.py의auth(),templates/login_error.html) - 배경:
/authorize에서MismatchingStateError(CSRF state 불일치)가 나면 사용자에게 500 페이지가 표시되었습니다. 2026-10-06에는 Instagram 인앱 브라우저에서 로그인 중 세션 쿠키가 유실되었고, 2026-10-14에는 여러 탭에서 동시에 로그인해 state가 서로 덮어써졌습니다. 같은 콜백 URL을 새로고침해도 계속 실패했습니다. OAuthError를 잡아 경고 로그를 남기고, "다시 로그인" 버튼과 인앱 브라우저·여러 탭 관련 안내가 있는 페이지를 400으로 보여줍니다.- 쿠키가 저장되지 않는 환경에서 무한 리다이렉트가 생길 수 있어 자동 재로그인은 하지 않습니다.
- 프록시 호스트 인식 (
membership.py의ProxyFix) - 배경: nginx가 gunicorn unix 소켓으로 프록시해서 Flask가 Host를
localhost로 인식했습니다. 그래서 로그인 리다이렉트가next=http://localhost/...로 만들어졌습니다. - nginx가 이미 보내는
X-Forwarded-Host만 신뢰하도록ProxyFix(x_host=1)를 적용했습니다. 다른 헤더(X-Forwarded-For,-Proto,-Prefix)는 신뢰하지 않습니다. - OIDC 콜백 주소는 기존처럼
OIDC_REDIRECT_URI설정을 따르므로 영향이 없습니다. - 변경은
members.uwksa.ca서비스 재시작 후 적용됩니다(적용 완료).
2026-10-07 Manage 목록 정리 및 회원 여부 재확인¶
- 로그인만 한 계정 숨김 (
membership.py의manage_signups(),templates/manage_signups.html) - 배경: UW SSO 로그인에 성공하면 가입 신청 여부와 무관하게
users행이 생성되어, 신청하지 않은 계정도/manage의 현재 유저 목록에 표시되었습니다. - 숨김 기준:
IS_MEMBER=0이고,signup_submissions기록이 없고, WatCard 사진 파일이 없는 계정 - 계정을 삭제하지 않으며, 표 하단의 "모두 보기"(
/manage?all=1)로 다시 확인할 수 있습니다. - 대기중 신청이 있는 계정과 사진이 남아 있는 해제 회원은 계속 표시됩니다.
- 사진 링크: WatCard 사진 파일이 없는 유저는 404가 나는 링크 대신
-로 표시합니다. - 회원 여부 재확인 (
/,/qr-code) - 세션의
is_member값은 로그인 시점 기준이라 DB에서 회원이 해제되어도 남아 있었습니다. 요청마다 DB로 다시 확인합니다. /에서 회원이 아니면/signup으로 보냅니다.- 수동 추가 기록 (
/manage/users/create,/manage/users/<username>/update) - 배경:
/manage에서 직접 추가한 회원은 가입 신청 기록이 없어 누가 언제 넣었는지 남지 않았습니다. users테이블에ADDED_BY,ADDED_AT컬럼을 추가했습니다. 컬럼이 없으면 앱이 시작 후 첫 DB 접근 때 자동으로 추가합니다.- 기록 시점: 운영자가 유저를 직접 생성할 때, 그리고 가입 신청 기록이 없는 유저를 회원으로 바꿀 때
/manage현재 유저 목록에Added manually by/Added manually at으로 표시합니다.- 이 변경 이전에 수동 추가된 회원은
Added manually by: unknown (not recorded)로 표시됩니다. - 적용 전 DB 백업:
/var/lib/members-data/backups/W26.db.20261007-pre-added-by - 변경은
members.uwksa.ca서비스 재시작 후 적용됩니다.
2026-10-01 Fall 2026 제휴 혜택 갱신¶
- 가입 페이지 제휴 목록 갱신 (
templates/signup.html) - 추가: Katsuya (현금 15%, 카드 10%), Manon Bakery ($30 미만 5%, 이상 10%)
- 삭제: BBQ Village, Sweet Dreams Teashop, Chicken Plus (제휴 종료/만료)
- 유지: Izna Poke Plus, K-GOOD STORE MART, Kim's Kitchen, The Bingsu Cafe (모두 2026-12-31까지)
- 학기 문구: Fall 2026, 유효기간 SEP 1 - DEC 23, e-Transfer 주소
uofwaterlooksa@gmail.com - 메인 사이트 동기화:
uwksa.ca의MembershipPage.tsx,HomePage.tsx제휴 목록도 동일하게 반영 - 템플릿 변경은
members.uwksa.ca서비스 재시작 후 적용됩니다.
2026-02-25 운영/신청 개선¶
- 사진 파이프라인 고도화
- 업로드 시 EXIF 자동 회전 → Roboflow → 감지 박스 기준 크롭·정규화
- 승인된 이미지는 표준 WatCard 경로에
<uw_username>.jpg로 저장 - 운영자 관리 확장
/manage에서 신청·회원 레코드 하드 삭제- WatCard 이미지 업로드/교체 지원
- 승인 시 리마인드 메일 자동 발송
- OIDC 보안:
OIDC_REDIRECT_URI가 명시되지 않은 경우 계산된 리다이렉트 URL을https로 강제 - 데이터 파이프라인 정리
- 레거시
members.txt기반 파이프라인 제거 - 현재 기본 DB 경로 정리:
database/W26.db - DB 스키마 문서화:
docs/DB_SCHEMA.md
2026-02-23 회원가입 플로우 도입¶
- 신규 회원가입 플로우:
/signupGET/POST 추가, WatCard 사진 업로드 및 검증 후 제출 저장. - 사진 검증 흐름 정비: 현재 소스 기준 signup 검증 엔드포인트는
/signup/photo-validate이며, validation 결과는signup_photo_validations에 저장됩니다. - 신청 관리 페이지:
/manage및/manage/submissions/<id>/confirm추가,MANAGE_ALLOWED_USERNAMES로 운영자 제어. - 결제 확인 알림 메일:
mailer.py가 Resend API를 사용해 신규 신청 건을 운영자에게 알림 (RESEND_API_KEY,RESEND_FROM_EMAIL필요). - QR 발급·검증:
/qr-code가 30초 만료 JWT QR 발급,/verify에서 검증 및 미가입자 안내. - 환경변수/경로 핵심값
- 인증/세션:
SECRET_KEY,OIDC_CLIENT_ID,OIDC_CLIENT_SECRET,OIDC_DISCOVERY_URL - 가입/업로드:
SIGNUP_TEST_DATABASE(기본DATABASE→ 기본 경로database/W26.db),SIGNUP_UPLOAD_DIR(기본static/images/test-signups),SIGNUP_TEMP_UPLOAD_DIR,MAX_CONTENT_LENGTH - 운영자:
MANAGE_ALLOWED_USERNAMES - 메일:
RESEND_API_KEY,RESEND_FROM_EMAIL, 결제 알림 수신자는mailer.py의OPERATIONS_ALERT_RECIPIENTS - 참고 파일 위치
- 앱/라우트:
membership.py,wsgi.py - 메일:
mailer.py,membershipMailer.py - 이미지 처리:
photo_processor.py - 템플릿:
templates/signup.html,templates/manage_signups.html,templates/verify.html,templates/base.html - 정적자원:
static/images/WATCards/,static/images/test-signups/
2026-02-24 후속 운영 기능 추가¶
- 리마인드 메일러:
membershipMailer.py의send_membership_reminder(recipient_emails)로 대상 리스트만 교체해 발송