README.md

---
title: Team Messenger (probe)
emoji: 💬
colorFrom: blue
colorTo: gray
sdk: static
pinned: false
short_description: HF만으로 팀 메신저가 되는지 확인하는 시험판
hf_oauth: true
hf_oauth_expiration_minutes: 10080
hf_oauth_scopes:
  - read-repos
  - write-repos
hf_oauth_authorized_org: CJLabKIST
---

# Team Messenger — 시험판 (feasibility probe)

유료 Docker Space를 구독하기 전에, **Hugging Face 기능만으로** 팀 메신저의 핵심 요소가 되는지 확인하는 static Space입니다.

확인 항목 (앱의 Settings · 진단 화면):
1. HF OAuth 로그인 — 일반 창, Space 페이지(iframe), Notion 임베드(iframe + 팝업)
2. CJLabKIST 조직 멤버만 입장 (아니면 Access denied)
3. 조직 멤버 목록 (HF API)
4. 1:1 DM — 대화 ID는 `dm__<작은이름>__<큰이름>`으로 항상 같음
5. 메시지를 private Storage Bucket `CJLabKIST/messenger-probe`에 저장, 새로고침 뒤에도 유지

Notion 임베드: Notion에는 `https://cjlabkist-messenger-probe.static.hf.space/?embed=1`을 넣습니다.
`huggingface.co/spaces/...` 주소는 `X-Frame-Options: DENY`라서 임베드되지 않습니다.
HF 로그인 화면은 iframe 안에서 열리지 않고(`X-Frame-Options: SAMEORIGIN`), HF 페이지의 `COOP: same-origin` 때문에
팝업이 원래 창과의 연결을 잃습니다. 그래서 팝업 로그인 결과를 **암호화해서 public Bucket `CJLabKIST/messenger-handoff`에 잠깐 두고**
iframe이 가져간 뒤 지웁니다. 암호 키는 URL `#` 뒤에만 있어 서버로 가지 않습니다.

저장 방식: 메시지 1개 = 파일 1개 (`messages/<대화ID>/<시각>__<보낸사람>__<id>.json`).
읽고-고쳐-쓰기가 없어서 동시에 보내도 서로 덮어쓰지 않습니다.

**한계 (시험판 전용):** 서버가 없어서 브라우저가 로그인한 사람의 토큰으로 Bucket에 직접 접근합니다.
그래서 DM 비공개가 보장되지 않습니다(조직원은 Bucket을 직접 열면 모든 대화를 볼 수 있음).
이 Space는 public이지만 들어 있는 것은 화면 코드뿐이고, 메시지는 private Bucket에 있어 CJLabKIST 멤버만 읽을 수 있습니다.
본 제품(Docker Space + FastAPI)에서는 서버가 대화 참여자만 읽게 막고, 토큰도 브라우저에 두지 않습니다.