Bluehair Today 사용 가이드#

이 문서는 현재 배포된 다중 사용자 인증 버전의 사용법입니다. 모든 날짜와 시간은 Asia/Seoul 기준입니다. 운영자가 가입을 일시 중지한 경우에는 공개 가입 대신 로그인 화면만 보일 수 있습니다.

1. 처음 시작하기#

1. 브라우저에서 https://today.bluehair.blue를 엽니다.
2. 로그인하지 않은 상태에서는 서비스 소개와 로그인 / 무료로 시작 버튼이 보입니다. 다른 Bluehair 서비스의 사용자가 이 주소를 열어도 시간표 내용은 보이지 않습니다.
3. 무료로 시작을 눌러 이름, 이메일, 12자 이상의 비밀번호를 입력합니다.
4. 가입 직후 표시되는 이 기기에 Passkey 추가를 누르는 것을 권합니다. Windows Hello, 지문, 얼굴 인식 또는 기기 잠금으로 다음부터 로그인할 수 있습니다.

초기 이전 기간에는 운영자가 제공한 일회성 소유자 코드가 필요한 가입 화면이 표시될 수 있습니다. 이 코드는 기존 개인 시간표를 단 한 계정으로 옮기기 위한 것이며 다른 사용자와 공유하면 안 됩니다. 이 초기화 화면은 코드 자체가 가입 게이트이므로 Turnstile을 로드하지 않습니다. 공개 가입 전환 뒤에는 가입·비밀번호 로그인 화면에 Turnstile 사람 확인이 활성화됩니다.

꼭 알아둘 제한#

비밀번호 재설정/복구 이메일 발송은 아직 연결되어 있지 않습니다. 따라서 비밀번호와 등록한 Passkey를 안전하게 보관하세요. 기기 교체 전에 다른 기기에도 Passkey를 추가하거나 비밀번호 관리자를 사용하는 것이 좋습니다.

2. 로그인하기#

• Passkey로 로그인: 로그인 화면에서 이 버튼을 누르고 기기 잠금을 확인합니다. 이전에 그 계정에 등록한 Passkey가 있는 기기에서 사용합니다.
• 비밀번호로 로그인: 이메일과 비밀번호를 입력합니다.
• 완료되면 /app의 개인 시간표로 이동합니다. 로그인 쿠키는 이 브라우저와 today.bluehair.blue에만 적용됩니다.

Passkey가 없는 새 기기에서는 먼저 비밀번호로 로그인한 뒤 Passkey를 추가하세요. 공용 PC에서는 로그인 후 반드시 로그아웃하세요.

3. 오늘 일정 확인과 편집#

1. 상단의 현재 카드에서 진행 중인 일정을, 다음 일정에서 곧 시작할 일정을 확인합니다. 시계가 바뀌면 표시도 자동으로 바뀝니다.
2. 오늘의 일회성 할 일은 빠른 입력에 제목·날짜·시간을 넣고 추가합니다.
3. 자세한 일회성 할 일은 할 일 추가, 매주 반복할 일정은 반복 일정 추가를 사용합니다.
4. 기존 항목을 누르면 제목, 설명, 시간, 분류를 수정하거나 삭제할 수 있습니다.
5. 체크리스트 항목을 누르면 오늘 완료 상태가 바뀝니다.

변경은 해당 계정의 작업공간에만 저장됩니다. 같은 계정으로 로그인한 다른 브라우저·기기는 WebSocket 알림을 받고 최신 revision을 다시 읽습니다. 연결이 잠시 끊겼다면 상단의 새로고침을 누르거나 인터넷 연결이 복구될 때까지 기다리세요.

4. 테마 바꾸기#

상단의 테마 · 자동 버튼을 누르면 자동 → 라이트 → 다크 순서로 바뀝니다. 자동은 기기의 시스템 테마를 따릅니다. 선택값은 그 브라우저에 저장되며 일정 데이터와는 별개입니다.

5. ChatGPT 연결하기#

1. ChatGPT에서 Bluehair Today MCP 연결을 시작합니다.
2. 브라우저가 Bluehair Today의 /connect/chatgpt 화면으로 이동하면, 현재 로그인한 이메일과 요청 권한을 확인합니다. 로그인하지 않았다면 먼저 로그인합니다.
3. ChatGPT로 계속을 누릅니다.
4. MCP의 최종 승인 화면에서 읽기/쓰기 권한을 확인하고 연결 승인을 누릅니다.

이 과정에는 APP_TOKEN을 입력하지 않습니다. 연결은 현재 계정의 개인 작업공간에만 묶입니다. 다른 계정으로 ChatGPT를 연결하려면 먼저 Bluehair Today 계정을 바꾸어 로그인한 뒤 다시 연결하세요. ChatGPT의 일반 예약 기능 자체와 시간표 DB가 자동으로 양방향 동기화되지는 않습니다.

6. Android 홈 화면 위젯 사용하기#

현재 지원 버전: Android 0.3.0(code 2)부터 기기 전용 위젯 인증을 지원하며, 운영 배포와 Android 16 실기기 QA를 완료했습니다. 이전 앱은 최신 APK로 덮어설치하세요. 로그인 데이터 보존을 위해 앱 삭제/데이터 지우기는 하지 마세요.

1. 최신 Android 앱을 열어 Bluehair Today 계정으로 로그인합니다. 앱을 한 번 열면 위젯용 기기 등록을 준비합니다. 이 등록은 브라우저 로그인 쿠키를 위젯에 복사하는 방식이 아닙니다.
2. 앱의 홈 화면에 위젯 추가를 누르거나 Android 런처의 위젯 목록에서 Bluehair Today 시간표를 홈 화면에 놓습니다.
3. 인터넷 연결 상태에서 위젯의 새로고침 아이콘을 누르면 그 기기의 최신 오늘 일정·현재 일정·다음 일정을 요청합니다. 배터리 절약 모드에서도 홈 화면을 유지한 채 잠깐 투명 갱신 화면이 실행된 뒤 자동으로 닫힙니다. 위젯의 나머지 영역을 누르면 앱을 열어 로그인 상태와 전체 플래너도 확인할 수 있습니다.
4. PC·모바일 앱·ChatGPT에서 일정을 바꾼 뒤 앱을 열어 두었거나 위젯에서 직접 새로고침하면 즉시 갱신을 시도합니다. 앱이 닫힌 상태의 원격 변경은 Android 백그라운드 작업으로 약 15분 간격에 확인합니다. 배터리 절약 모드·Doze·네트워크 제한에서는 더 늦어질 수 있습니다.

위젯의 "즉시"는 사용자가 앱을 열었거나 새로고침을 누른 경우의 네트워크 요청을 뜻합니다. 다른 기기에서 수정한 내용을 닫힌 앱의 위젯까지 항상 푸시로 즉시 반영하는 기능은 FCM 알림 채널을 추가하기 전에는 보장하지 않습니다.

보안을 위해 Android WebView의 HttpOnly 로그인 쿠키는 백그라운드 위젯에 재사용하지 않습니다. 대신 이 Android 기기의 Keystore 안에서만 보관되는 RSA 개인 키가 등록·요청에 서명하고, 서버에는 공개 키와 기기 등록 정보만 저장됩니다. 앱 데이터 삭제, 기기 변경, 계정 설정에서 해당 기기를 해제한 경우에는 앱을 다시 열어 로그인·등록해야 합니다.

7. Windows에서 사용하기#

인증 전환 이후에는 최신 Windows Bluehair Today 앱을 사용해야 합니다. 앱은 /app을 열며, 첫 실행 또는 세션 만료 시 로그인 화면을 표시합니다.

1. Windows 앱을 실행합니다.
2. 로그인 화면에서 Passkey 또는 비밀번호로 로그인합니다.
3. 작은 반투명 위젯 화면에서는 현재/다음 일정을 확인하고, 전체 플래너 열기로 편집합니다.
4. 트레이 메뉴에서 Windows 로그인 시 자동 시작을 켜거나 끌 수 있습니다.

Windows 앱에 비밀번호나 서버 secret을 저장하거나 입력하지 마세요. 로그인은 WebView의 안전한 계정 세션을 통해서만 처리되어야 합니다.

8. 계정과 연결 관리하기#

플래너 상단의 이메일을 누르거나 /account를 열면 계정 설정으로 이동합니다.

• Passkey 추가: 현재 기기의 Windows Hello, 지문, 얼굴 인식 또는 기기 잠금을 이 계정에 등록합니다.
• Passkey 삭제: 잃어버렸거나 더 이상 사용하지 않는 기기의 Passkey를 목록에서 제거합니다. 마지막 로그인 수단을 지우기 전에는 비밀번호가 안전하게 보관되어 있는지 확인하세요.
• ChatGPT 연결 모두 해제: 계정의 연동 세대를 즉시 바꾸어 기존 MCP 접근 및 갱신 토큰을 더 이상 사용할 수 없게 합니다. 다시 사용하려면 ChatGPT에서 새로 연결해야 합니다.
• Android 위젯 기기: 배포된 기기 전용 위젯 인증 릴리스에서는 이 목록에서 등록한 휴대폰을 확인하고 분실·교체한 기기를 해제할 수 있습니다. 해제된 기기는 더 이상 시간표를 요청하지 못하며, 다시 사용하려면 해당 앱에서 로그인 후 새로 등록해야 합니다. 계정의 모든 연동을 해제하는 동작은 위젯 기기 등록도 함께 무효화합니다.

9. 로그아웃하기#

플래너 상단의 로그아웃을 누르면 서버 세션과 이 브라우저의 해당 계정 캐시를 정리하고 소개 페이지로 돌아갑니다. 분실하거나 공용으로 사용한 기기에서는 즉시 로그아웃하고 계정 설정에서 의심스러운 Passkey를 지운 뒤, ChatGPT 연결 모두 해제를 실행하세요. 계정 복구 이메일 기능은 아직 없으므로 이 절차를 미루지 마세요.

빠른 문제 해결#

운영·백업·배포·장애 대응은 유지·보수 인덱스를 참조하세요.