docs(adr): ADR-014 iOS 27 대응으로 UIScene 생명주기 전환 결정을 기록한다 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Updated ADR‐011: 이미지 변환은 자체 서버가 아니라 Cloudflare가 한다 (markdown)
docs(adr): ADR-013에 Go 서버 9/29 품질 100 재변환을 반영하고 적용 순서를 고친다
docs(adr): ADR-013에 변환 흐름 다이어그램과 DB 되돌리기 조건을 붙인다
docs(adr): ADR-013 클라이언트 리사이즈 보류 사유를 근거 부족 하나로 정리한다
docs(adr): ADR-013 적용 범위를 홈·지도 카드 로고까지 넓힌다
docs(adr): ADR-013 변환 주체를 Cloudflare로 정리하고 모달도 2400px 변환으로 바꾼다
docs(adr): ADR-013 모달은 원본 유지, 되돌리기 전 슬라이드 지연 로딩으로 정리
docs(adr): ADR-013 이미지는 원본 그대로 올리고 Cloudflare가 원본에서 변환한다
docs(adr): ADR-011 참고 자료에서 이전 판 링크 제거
docs(adr): ADR-012 강제 업데이트 문단을 나눠 읽기 쉽게 정리
docs(adr): ADR-012 앱 화면은 하나의 웹뷰 셸이 그린다 네이티브 탭을 없애고 단일 웹뷰 셸로 전환한 결정(웹 #1643·#1662·#1665, RN #21·#26·#27). 구버전 앱은 호환 분기 대신 강제 업데이트(min_supported_version 1.6.0, 2026-06-14)로 막았다. 전환 후 3개월간 웹 배포 29회, 화면 변경으로 인한 앱 릴리즈 0건. - 사이드바 ADR 목록에 추가
docs(adr): ADR-011 결정 중심으로 다시 쓰기 14,700자 → 6,500자, 소제목 16개 → 6개(팀 템플릿 기준). - 결정과 무관한 조사 과정(원본 보존 확인, Workers 요금 정정, 배포 전 측정, 탭 eager 결함 분석)은 빼고 이전 판(b0ae055) 링크로 남김 - 근거로 쓰지 않는 상세 진입 전송량 표 제거 - 재검토 조건·미측정 항목·범위 밖 결함은 각 절 본문 한두 줄로 흡수
docs(adr): ADR-011 문체 정리 내용과 숫자는 그대로 두고 읽기 어려운 표현을 걷어냈다. - 굵은 글씨 118곳 → 13곳, 긴 줄표 30개 → 3개(표 빈 칸만) - 글 자체를 설명하는 문장("정직하게 적어둡니다" 등) 제거, 존댓말 "~습니다"로 통일 - "바로잡습니다" 두 절을 사실 서술로 바꾸고 정정 경위는 맨 아래 변경 이력으로 이동 - "다른 대안들"을 결정 절 아래로, 실측 결과를 배포 전/배포 후로 분리 - 적용 순서 2번에 프로덕션 배포일, 단점에 CDN_IMAGE_SIZES 상수 반영 사실 추가
docs(adr): ADR-011 요약과 배포 후 프로덕션 실측 추가 - 맨 위에 문제·결정·결과 3줄 요약 - 배포 후 프로덕션 실측: 66곳 286장 합계 40.6→8.5MB(-79%), 용도별 절감, 동아리별 중앙값 -34%, 286장 중 123장이 커진 원인, 모달 원본 일괄 로드 - 아직 재지 않은 것: 로컬 -79%(산악부 활동사진)와 전 동아리 합계 -79%가 다른 숫자임을 명시
docs(adr): ADR-011 업로드 전 축소를 기각한 이유 보강 화질 영구 손실 하나만 적혀 있어 결정 근거가 약했다. - 한 장이 그리드·썸네일·모달 세 크기로 쓰여 업로드 시점엔 한 크기만 남음 - 업로드 시점 축소는 기존 705개에 적용 안 됨, 요청 시점 변환은 배포 즉시 전부 - 칸 크기가 바뀌면 재업로드 필요 - 업로드 축소는 올리는 바이트라는 별개 문제라 배타적이지 않음, ADR-009 열린 질문으로 연결
docs(adr): ADR-011 적용한 옵션과 모달 원본 유지 결정 반영 - 적용한 옵션 절 신설(#2110): 용도별 크기·fit과 근거(8개 화면 너비 실측), crop/scale-down을 고른 이유, AVIF 출력 면적 상한 2,560,000px - 모달 본 이미지는 원본 유지로 되돌림(재인코딩 시 +43~163%, 최선 -16~18%), 대가로 모달 열 때 원본을 새로 받는 점 명시 - 변환 소스는 DB의 .webp를 그대로 쓰기로 열린 질문 정리 - 첫 요청 지연 1~3초, 비용 2종 기준 1,410건(28%)으로 정정 - 적용 순서 1번 활성화 경위, 2번 #2110 연결, 3번 이후 전체보기 재검토 조건 - 원래 주소의 png가 WebP로 전달된다는 문장 정정(접두사 없는 주소는 변환 안 됨) - 아직 재지 않은 것: before LCP 반사실 결과와 로컬 적용 후 바이트로 갱신
docs(adr): ADR-011 전체보기도 모달 크기 기준으로 줄이도록 변경 전체보기는 원본 해상도가 아니라 모달 크기(최대 1200px)만 필요하다. 그리드만 작은 URL로 바꾸면 모달과 캐시가 갈라져 모달을 열 때 4000px 파일을 전부 새로 받게 되고, 크론 중단 후 올라온 jpg는 format=auto 없이 그대로 나간다. - 전체보기 본 이미지 width=2400,fit=scale-down, 썸네일 width=88 - 활동사진 변형 3종 기준 월 한도 사용량(42%) 추가
docs(adr): ADR-011 참고 자료에서 코드 위치 항목 제거
docs(adr): ADR-011 원본 덮어쓰기 전제 정정 크론은 원본을 덮어쓰지 않는다. 변환본을 새 키(.webp)로 저장하고 원본 삭제 코드는 주석 처리돼 있다. 프로덕션 실측으로 webp 277개 중 274개의 원본이 버킷에 남아 있다(349.7 MB). - '되돌릴 수 없는 쓰기'를 가장 큰 이유로 든 섹션을 정정하고, 남는 결정적 이유(크기별 변형 불가)로 재정리 - 변환 소스(webp vs 원본) 이중 손실 문제를 열린 질문으로 추가 - display:none + eager 다운로드를 네트워크로 검증한 결과 반영 - 해당 동작이 #1084의 의도된 프리마운트라는 맥락 추가
docs(adr): ADR-011 작업 순서를 Mixpanel 실측으로 정정 상세 방문자의 46.2%(547/1184명)가 활동사진 탭을 연다. 탭 조건부 마운트를 먼저 하자고 적었으나, 그 수정은 탭을 여는 24.1% 방문에서 효과가 0이다. width= 적용이 단독 90.5%로 전원에게 효과가 있어 순서를 뒤집었다.
docs(adr): ADR-011 슬롯 폭 계산 정정 및 eager 결함 분리 - 슬롯 292px -> 186px. LeftSection 400px + gap 24px를 빼지 않은 계산이었다. 선형 13.7배 -> 21.5배, 절감 -78.9% -> -90.5%로 정정. - display:none 탭에서 eager 15장이 받아지는 건 별도 결함이라 '범위 밖에서 같이 발견한 것'으로 분리. Cloudflare로 고쳐지지 않으며 프론트 수정이 선행돼야 함을 명시. - 원본을 덮어쓰는 현재 구조가 되돌릴 수 없다는 근거를 결정 섹션에 추가.
docs(adr): ADR-011 이미지 변환은 자체 서버가 아니라 Cloudflare가 한다 Go 변환 서버를 버리고 Cloudflare Image Transformations로 전환하는 결정. 4000px 원본을 292px 슬롯에 전송하던 문제와 실측 근거(단건 -51.4%, 24시간 집계 -74.2%), 적용 순서, 되돌릴 조건을 기록.
ADR‐010: manualChunks 캐치올이 지연 로드를 무효화하던 것을 기록한다
ADR‐007·009: 허용 포맷 목록의 출처와 잃어버린 서버 리사이즈를 기록한다
ADR-008: 상태를 Accepted로 바꾼다 PR #2084가 develop/be에 머지됐다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Updated ADR‐009: 웹뷰 이미지 업로드는 브리지를 경유하지 않는다 (markdown)
Created ADR‐009: 웹뷰 이미지 업로드는 브리지를 경유하지 않는다 (markdown) Updated _Sidebar (markdown)
Updated ADR‐008: 홍보 이미지 키를 동아리 기준으로 잡는다 (markdown)
ADR-008: 홍보 이미지 키를 동아리 기준으로 잡는다 홍보만 키가 게시글(articleId) 기준이라 작성이 두 번의 요청으로 나뉘고 생성 시점에 검증을 걸 수 없었다. 동아리 기준으로 바꾼 결정과 그 대가(삭제 보호를 접두사에서 참조 확인으로 이동)를 남긴다. 원래 왜 게시글 기준이었는지가 어디에도 기록돼 있지 않아 커밋을 역추적해야 했다. 같은 고고학을 반복하지 않도록 이력도 함께 적는다. 구 키를 언제 지워도 되는지의 조건과 확인 쿼리도 포함한다. 상태는 Proposed. PR #2084 머지 후 Accepted로 바꾼다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>