trim install guide: assume Mac familiarity

INSTALL-macos-ko.md

@@ -1,130 +1,27 @@
-Stem 설치 가이드 (macOS)
+Stem 설치 (macOS, Apple Silicon)
-============================
+================================
-
-승미님께. Stem을 처음 설치하실 때 단계별로 따라하시면 됩니다.
-필요 시간 5분. 모르는 부분이나 막히는 단계 있으시면 화면 그대로
-캡쳐해서 보내주세요.
-
-
-0. 준비 사항
-------------
-- 맥북 (애플 실리콘 M1/M2/M3/M4)
-- 인터넷 연결
-- 본인 Google 계정 (회사 메일 또는 개인 메일)
-- (인텔 맥은 이번 빌드 미지원. macOS 11 Big Sur 이상 권장)
-
-
-1. 다운로드
------------
-아래 주소를 사파리/크롬 주소창에 그대로 붙여넣고 엔터:
 
+1. DMG 다운로드
    https://gitea.muwol.io/eden/stem-app/releases/download/v0.1.0-test1/Stem_0.1.0_aarch64.dmg
 
-다운로드 폴더에 Stem_0.1.0_aarch64.dmg 파일이 생깁니다 (약 46MB).
+2. DMG 열어서 Stem.app을 Applications로 드래그.
+
+3. 첫 실행은 우클릭 > 열기 필수.
+   - Apple Developer 인증서 없이 ad-hoc 서명만 된 빌드라
+     그냥 더블클릭하면 Gatekeeper가 차단함.
+   - Sequoia(15)는 우클릭으로도 안 막아주는 경우가 있음 →
+     시스템 설정 > 개인정보 보호 및 보안 > 보안 섹션 하단 "그래도 열기".
+
+4. Google OAuth 로그인.
+   브라우저로 튀어나갔다가 돌아오면 메인 화면.
+   안 돌아오면 Dock에서 Stem 한 번 클릭.
+
+5. 회사 보안망에서 OAuth 막히면 핫스팟으로 한 번만 로그인.
+   토큰은 Keychain에 저장돼서 이후엔 회사망 OK.
 
 
-2. DMG 열기
+무결성 확인 (선택)
------------
-다운로드 폴더에서 Stem_0.1.0_aarch64.dmg 파일을 더블클릭.
-
-작은 창이 뜨면서 두 개 아이콘이 보입니다.
-- 왼쪽: Stem 앱 아이콘
-- 오른쪽: Applications 폴더 아이콘 (또는 "응용 프로그램")
-
-
-3. 응용 프로그램으로 드래그
----------------------------
-Stem 아이콘을 오른쪽 Applications 폴더 아이콘 위로 끌어다 놓으세요.
-
-복사가 끝나면 DMG 창은 닫아도 됩니다.
-
-
-4. 첫 실행 — 그냥 더블클릭하면 안 됩니다 (중요)
------------------------------------------------
-이 앱은 아직 정식 인증서가 없어서 그냥 더블클릭하면 macOS가 막습니다.
-아래 방법으로 우회하세요.
-
-4-1. Finder에서 응용 프로그램 폴더 열기
-     - Finder 메뉴: 이동 -> 응용 프로그램
-     - 또는 단축키 Shift + Cmd + A
-
-4-2. Stem 아이콘 우클릭 -> 열기
-     (맥북 트랙패드는 두 손가락 탭, 또는 Control 누르고 클릭이 우클릭)
-
-4-3. 경고창에서 "열기" 버튼 클릭
-     메시지 예: "Stem은(는) 확인되지 않은 개발자가 배포한 앱입니다.
-     정말로 여시겠습니까?"
-     -> "열기" (그냥 "확인" 아닌 "열기")
-
-4-4. macOS Sequoia(15)에서 위 방법이 안 될 때
-     - Apple 메뉴 (좌상단 사과) -> 시스템 설정
-     - 왼쪽 사이드바: 개인정보 보호 및 보안
-     - 스크롤 내려서 "보안" 섹션
-     - "Stem은(는) ... 사용이 차단됨" 옆 "그래도 열기" 버튼 클릭
-     - 비밀번호 또는 Touch ID로 확인
-     - 다시 응용 프로그램 폴더의 Stem 아이콘 더블클릭
-
-
-5. 처음 실행 시 로그인
-----------------------
-Stem이 켜지면 시작 화면(랜딩 페이지)이 나옵니다.
-
-1) "시작하기" 또는 "Sign in with Google" 버튼 클릭
-2) 기본 브라우저(사파리/크롬)가 열리며 Google 로그인 페이지로 이동
-3) 본인 Google 계정 선택 -> 권한 확인 -> "허용"
-4) 브라우저: "Stem 앱으로 돌아가도 됩니다" 메시지
-5) Stem 앱 창으로 돌아가면 자동 로그인 완료, ELN 메인 화면 진입
-
-
-6. 잘 됐는지 확인
------------------
-메인 화면에서 다음이 보이면 정상:
-- 좌측 사이드바: Samples / Notes / Lineage / Drylab 메뉴
-- 본인 계정 아이콘이 우상단에 표시
-- 메뉴 아무거나 클릭해서 화면이 바뀜
-
-이 단계까지 오시면 설치 완료입니다.
-
-
-자주 막히는 부분
-================
-
-Q. 더블클릭하니까 "손상되었습니다" 메시지가 떠요.
-A. 우클릭(또는 Control + 클릭) 후 "열기"를 누르셔야 합니다.
-   그냥 더블클릭은 첫 번째에서만 차단됩니다 (4-2 단계).
-
-Q. "그래도 열기" 버튼이 안 보여요.
-A. macOS 12 이하면 위치가 다릅니다: Apple 메뉴 -> 시스템 환경설정 ->
-   보안 및 개인정보 보호 -> 일반 탭 -> 하단에 "확인 없이 열기" 또는
-   "그래도 열기" 버튼.
-
-Q. Google 로그인 후 브라우저는 닫혔는데 앱은 그대로예요.
-A. Dock의 Stem 아이콘을 한 번 클릭해서 앱을 앞으로. 그래도 안 되면
-   앱 종료(Cmd+Q) 후 다시 실행.
-
-Q. 와이파이가 회사 보안망이라 로그인이 안 돼요.
-A. 핸드폰 핫스팟으로 잠깐 바꿔서 한 번 로그인하면 그 이후는 회사망에서도
-   됩니다 (한 번 받은 토큰은 로컬에 저장).
-
-Q. 사용 중 앱이 꺼졌어요.
-A. 다시 더블클릭하면 됩니다. 첫 실행 우회는 한 번만, 이후엔 일반 앱처럼
-   동작합니다. 작성하신 내용은 자동 저장되어 있습니다.
-
-
-삭제하고 싶을 때
-================
-응용 프로그램 폴더에서 Stem.app을 휴지통으로 끌어다 놓으면 됩니다.
-(로그인 정보는 Keychain에 저장되어 있어 완전 삭제는 추가 정리 필요 —
- 그땐 따로 말씀해주세요)
-
-
-안 풀리는 문제
-==============
-화면 캡쳐(Cmd + Shift + 4 -> 영역 드래그)와 함께 메시지 주시면 됩니다.
-
-설치 파일 무결성 확인용 SHA-256 (선택):
-  f0bcfa26f82564459548931ab5406b2735b0cf30321b7fc4b7c0c56b09abbff7  Stem_0.1.0_aarch64.dmg
-
-터미널에서:
   shasum -a 256 ~/Downloads/Stem_0.1.0_aarch64.dmg
-실행해서 같은 값이 나오면 파일 손상 없습니다.
+  → f0bcfa26f82564459548931ab5406b2735b0cf30321b7fc4b7c0c56b09abbff7
+
+문제 있으면 화면 캡쳐 보내주세요.