Skip to content

fix: 유리 배경을 메뉴바 팝오버와 토스트로 제한 - #42

Merged
hyesngy merged 1 commit into
developfrom
fix/opaque-window-surfaces
Nov 12, 2026
Merged

hyesngy merged 1 commit into
developfrom
fix/opaque-window-surfaces

Conversation

@hyesngy

@hyesngy hyesngy commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

관련 이슈

없음. #31(불투명 배경을 설정 창으로 제한)의 범위를 넓히는 변경입니다.

변경사항

  • 설정 창의 풀이 기록 상세 화면만 반투명하게 비치던 문제를 고쳤습니다. ResultView가 스스로 유리 배경을 깔고 있어, 불투명한 설정 창 안에서 그 영역만 뒤 화면이 비쳤습니다.
  • 결과 패널·온보딩·페이월 창을 불투명으로 바꿨습니다. 창 배경색이 투명이라 제목 표시줄에 아무 배경도 그려지지 않던 문제가 함께 해결됩니다.
  • 유리 배경은 메뉴바 팝오버와 토스트에만 남겼습니다. 잠깐 떴다 사라지는 화면만 유리로 두는 기준입니다.
  • 배경은 창 루트에서만 정하도록 정리했습니다. ResultView와 MenuContentView는 배경을 깔지 않고, 들어가는 창의 배경을 따릅니다.
  • paxoSurface(cornerRadius:isOpaque:)를 paxoGlassSurface(cornerRadius:)와 paxoWindowSurface()로 나눴습니다. 기본값이 유리라서 의도치 않게 유리가 깔리던 일을 이름으로 막습니다.
  • 결과 패널·온보딩·페이월 컨트롤러의 isOpaque = false, backgroundColor = .clear, titlebarAppearsTransparent = false 지정을 지웠습니다. 창 불투명 처리는 paxoWindowSurface() 한 곳에서만 합니다.
  • docs/decisions.md에 배경 기준을 "제안" 상태로 추가했습니다.

변경·영향 범위

담당 주 영역: 앱 기능 (UI)

  • 앱 기능 (Capture / AI / Storage / UI)
  • StoreKit·사용량 정책
  • API·프록시
  • 앱 설정·권한·릴리스
  • 테스트·CI·개발 도구
  • 규칙·문서 (AGENTS.md, docs/)
  • 기타:

PR 분류

  • 일반 변경
  • Critical Path 변경

사전 예측

  • 예상 소요·기대 효과: 반나절 이내. 설정 창 상세 화면과 결과 패널 제목 표시줄의 투명 문제 해결, 화면별 배경 기준 통일.
  • 예상 병목·리스크: #31에서 유리로 되돌린 결과 패널·온보딩·페이월을 다시 불투명으로 바꾸므로 당시 의도와 충돌할 수 있음.
  • 담당 영역 밖 확인 사항: fix: 불투명 배경을 설정 창으로 제한 #31 작성자에게 유리로 되돌린 이유 확인 필요.

실제 결과·트러블슈팅

  • 실제 소요·반영 결과: Swift 파일 10개와 결정 기록 1줄, 24줄 추가·33줄 삭제.
  • 실제 병목·해결 과정: MenuContentView가 결과 패널의 홈 화면으로도 쓰여, 유리 배경을 뷰에서 떼어 MenuBarExtra 루트로 옮겼음. 그대로 두면 불투명해진 패널 안에 유리 구멍이 생김.
  • 배운 점·후속 작업: 상세 화면의 여백(16pt)과 헤더 모양이 목록·복습 화면(20pt)과 다른 점은 이번 범위에서 제외함.

검증 결과

  • 검증 내용:
    • xcrun swift-format lint --recursive --strict Paxo PaxoTests 통과
    • xcodebuild ... build, xcodebuild ... test 통과
    • macOS 27.0.1, 다크 모드에서 설정 → 풀이 기록 → 상세 화면이 불투명하고 둥근 테두리가 없는 것을 캡처로 확인
    • 메뉴바 팝오버(유리), 결과 패널, 온보딩, 페이월은 Xcode 실행으로 직접 확인
    • 라이트 모드와 macOS 14~15에서는 확인하지 못함
  • API Contract 앱·프록시 양쪽 반영 여부: 해당 없음
  • 시크릿 포함 여부: 없음

- 설정 창의 풀이 기록 상세 화면만 반투명하게 비치던 문제 수정
- 결과 패널·온보딩·페이월 창을 불투명으로 바꿔 투명하던 제목 표시줄 해결
- 배경은 창 루트에서만 정하고 ResultView·MenuContentView는 따로 깔지 않음
- paxoSurface를 paxoGlassSurface와 paxoWindowSurface로 나눠 기본값으로 유리가 깔리지 않게 함
- 결정 기록에 배경 기준 추가
@github-actions

Copy link
Copy Markdown

AI 사전 코드 리뷰 (파일럿)

검토 SHA: da8c2b0df8af · 방식: 전체
상태: 미해결 0 · 해결 0 · 오탐 0 · 위험 수용 0
AI 호출: 1/20

메뉴바 팝오버 및 토스트에 유리 반투명 배경(paxoGlassSurface)을 적용하고, 설정·결과 패널·온보딩·페이월 창의 배경을 불투명(paxoWindowSurface) 스타일로 통합 리팩토링한 변경입니다. 결정 사항(docs/decisions.md) 개정 내용과 일치합니다.

ID 심각도 확신·구분 위치 문제 상태
— — — — 수정할 가치가 높은 문제를 찾지 못했습니다. —

사람의 판정: /ai-review false-positive AX-... 이유(10자 이상), /ai-review accepted-risk AX-... 이유(10자 이상), /ai-review reopen AX-...
AI 결과는 승인이나 머지 조건을 대체하지 않습니다.

@hyesngy hyesngy self-assigned this Nov 12, 2026
@hyesngy
hyesngy merged commit a853adc into develop Nov 12, 2026
7 checks passed
@hyesngy
hyesngy deleted the fix/opaque-window-surfaces branch November 12, 2026 07:20
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