Skip to content

members.uwksa.ca 변경 이력

읽는 방법

이 문서는 주요 변경점을 요약한 기록입니다. 현재 동작의 판단 기준은 항상 membership.py, config.py, docs/DB_SCHEMA.md를 우선합니다.

2026-10-14 WatCard 사진 업로드 용량 초과(413) 대응 및 로그인 개선

  • 배경: 2026-10-14에 큰 사진 업로드가 Flask(MAX_CONTENT_LENGTH 10MB)와 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_LARGE JSON 에러를 반환합니다(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 회원가입 플로우 도입

  • 신규 회원가입 플로우: /signup GET/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)로 대상 리스트만 교체해 발송