01 헤더 버튼 (PC)

PC와 태블릿에서는 우측 상단의 검색바 안에 6개 버튼이 한 줄로 정렬됩니다. 검색바 자체를 눌러도 검색 모달이 열립니다.

02 헤더 버튼 (모바일)

모바일에서는 헤더 우측에 🔍 검색과 + 영화 추가만 노출됩니다. 나머지 메뉴는 좌측 Book4film 로고를 클릭하면 서랍 형태로 슬라이드됩니다.

로고 클릭 시 좌측에서 서랍이 열립니다

서랍 항목(통계·별점 필터·프로필 공유·💬 위시리스트·⭐ 전문 도서관장·환경설정)을 누르면 서랍이 닫히면서 해당 팝업이 위에서 내려옵니다. PC에서는 동일한 항목들이 헤더 우측 아이콘 버튼으로 직접 노출됩니다 — 좌측부터 검색/+/별점 필터/통계/공유/💬 위시/⭐ 퀘스트/환경설정 순서. 로그아웃은 서랍 하단에 별도로 배치되어 빠르게 접근할 수 있습니다.

03 책 클릭 — 상세 패널

책등을 클릭하면 화면 하단에서 패널이 올라옵니다. 한 번 더 클릭하거나 ESC를 누르면 닫힙니다.

04 본 횟수 조절

같은 영화를 여러 번 봤다면 횟수를 누적할 수 있습니다.

05 한줄평

하단 패널의 ★한줄평 배너를 클릭하면 별점(0.5단위, 0.5~5점)과 한 문장 감상을 남길 수 있습니다.

한 번 작성한 후 다시 한줄평 배너를 누르면 표지에 블러가 입혀지면서 작성한 별점과 감상이 오버레이됩니다.

06 긴 후기글 — 서식 도구

하단 패널의 ✎긴 후기글 배너를 누르면 자유 분량의 후기를 쓸 수 있습니다.

07 책 두께의 의미

책의 두께는 그 영화에 남긴 기록의 분량을 시각적으로 표현합니다.

08 영화 추가하기 (+)

• 감독 — 새 감독 이름을 입력하거나, 입력란 아래의 기존 감독 칩을 클릭하면 자동 입력됩니다.
• 제목 — 영화 제목을 입력합니다.
• 개봉연도 — 제목 오른쪽 작은 칸에 직접 입력하거나, More Info로 자동 채울 수 있습니다. 비워두면 현재 연도로 저장되며, 등록 후에도 📝 버튼으로 언제든 수정 가능합니다.
• 장르 — 10개 장르 중 하나 선택. 책 색상과 패턴이 결정됩니다.
• More Info — TMDB 데이터베이스에서 영화/감독 정보를 가져옵니다. 개봉연도와 포스터 이미지가 자동으로 첨부되어, 출판 즉시 책 패널에 영화 포스터가 표시됩니다.

09 More Info — 감독 / 제목 모드

• 제목 모드 — 영화의 줄거리·개봉연도·평점·포스터를 가져옵니다. 감독 컨텍스트로 정확 매칭: 동명이작이 여러 편 있어도 입력한 감독의 작품을 우선 매칭해 보여줍니다.
• 감독 모드 — 감독의 약력과 대표작을 가져옵니다.
• 💬 위시리스트에 추가 — 검색 결과 아래 버튼을 누르면, 책장에 출판하지 않고 위시리스트에만 저장됩니다. (자세히는 17번 참조)

10 정렬 규칙

• 책장(감독) 순서 — 본 횟수 합계가 많은 감독이 위쪽으로 정렬됩니다.
• 같은 책장 내 — 최신 영화가 왼쪽, 구작이 오른쪽으로 정렬됩니다.

11 통합 검색 (🔍)

헤더의 버튼으로 3가지를 한 자리에서 검색할 수 있습니다.

• 👤 도서관장 — 다른 사용자의 이름을 정확히 입력하여 책장 방문 (대소문자는 구분 없음).
• 🎬 영화 — 영화 제목으로 줄거리·평점·포스터를 즉시 조회 (TMDB).
• 🎭 감독 — 감독 이름으로 약력과 대표작 조회.

📌 최근 검색어

검색한 항목은 각 탭(도서관장·영화·감독) 최대 5개까지 자동 저장되어 칩 형태로 표시됩니다. 칩을 누르면 다시 검색되고, 오른쪽 ✕로 개별 삭제, 상단 "전체 삭제"로 현재 탭의 기록 전체를 지울 수 있습니다.

💡 검색창 하단의 "최근 검색어 저장" 토글을 꺼두면 새 검색이 기록되지 않습니다. 저장된 기록은 본인의 브라우저에만 보관되며 서버로 전송되지 않습니다.

12 다른 도서관 방문하기

검색에서 도서관장을 찾아 카드를 클릭하면 그 사람의 책장을 둘러볼 수 있습니다. 화면 상단에 "← 내 책장으로" 배너가 나타나며, 언제든 클릭해 본인 책장으로 돌아올 수 있습니다.

방문 모드에선 읽기만 가능합니다 — 다른 사람의 영화·리뷰는 수정·삭제할 수 없으며, 영화 추가/필터/환경설정 버튼은 숨겨집니다. 한줄평·별점·본 횟수는 모두 공개되고, 긴 후기글은 작성자가 공개로 설정한 것만 읽을 수 있어요.

💡 본인 책장을 친구에게 공유하려면 헤더의 📨 프로필 공유 버튼을 누르세요. 링크 복사 또는 카카오톡으로 한 번에 보낼 수 있습니다.

13 긴 후기글 — 공개 / 비공개

긴 후기글을 작성할 때 상단의 토글로 공개 여부를 정할 수 있습니다.

• 🔒 비공개 (기본값) — 본인만 읽을 수 있습니다. 사적인 감상이나 미완성 글에 추천.
• 🌐 공개 — 본인의 책장을 방문한 다른 사용자도 읽을 수 있습니다.

※ 한줄평·별점은 항상 공개로 표시됩니다. 비공개로 남기고 싶다면 한줄평 대신 긴 후기글을 활용해주세요.
※ 토글은 언제든지 다시 변경할 수 있어요.

14 백엔드 동기화

모든 기록은 Supabase 데이터베이스에 안전하게 저장됩니다. PC, 휴대폰, 태블릿 어디서든 같은 계정으로 로그인하면 동일한 책장이 보입니다.

⚠️ 비밀번호를 잊으셨다면 로그인 화면의 "비밀번호를 잊으셨나요?" 링크로 가입 시 등록한 이메일로 재설정 메일을 받을 수 있습니다.

15 앱처럼 사용하기

Book4film은 웹앱(PWA)으로 작동합니다. 별도 앱스토어 설치 없이 홈 화면에 추가하면 진짜 앱처럼 풀스크린으로 실행되고, 인터넷이 끊겨도 캐시된 책장을 볼 수 있습니다.

설치 후엔 홈 화면 아이콘을 탭하면 풀스크린 앱처럼 열립니다. 주소창과 탭이 보이지 않아 더 몰입감 있게 책장을 둘러볼 수 있어요.

16 큐레이션 — 이런 영화는 어떠세요?

영화를 6편 이상 추가하면 상단바 바로 아래에 ✨ "이런 영화는 어떠세요?" 배너가 자동으로 표시됩니다. 클릭하면 본인의 책장을 분석해 추천 영화 5편을 포스터·줄거리·감독 정보와 함께 보여줍니다.

• 🎬 감독 우선 추천 (2편) — 본인이 가장 많이 본(또는 가장 자주 추가한) 감독의 다른 작품 2편을 제안합니다.
• 🎭 장르 보완 추천 (2편) — 본인이 가장 많이 본 장르의 인기작 2편을 추가합니다. 위 감독의 새 작품이 부족하면 부족분은 이 장르 추천으로 채워서 항상 5편이 됩니다.
• 🔄 비슷한 영화 (1편) — 본인이 가장 많이 본 감독의 영화 중 가장 자주 본 작품을 기준으로, TMDB의 similar와 recommendations API를 결합하고 장르 교집합까지 따져서 정확도 높게 한 편을 추천합니다.
• 👍 / 👎 피드백 — 추천 카드 하단에서 마음에 들면 👍, 별로면 👎를 누를 수 있어요. 👎 누른 영화는 다음 추천에서 자동으로 제외되어 점점 본인 취향에 맞는 큐레이션이 됩니다.
• 중복 제거 — 이미 추가한 영화는 모든 추천에서 제외됩니다.

💡 추천은 매번 열 때마다 새로 생성됩니다(가중치 기반 랜덤 + 셔플). 같은 책장이어도 다양한 추천을 받을 수 있어요. 피드백은 브라우저에 저장되며, 같은 계정 + 같은 기기에서 유지됩니다.

17 AI 취향 분석

큐레이션에서 👍/👎 피드백을 3회 이상 누르면, 모달 상단에 🤖 AI 분석 패널이 자동으로 나타납니다. 본인이 선호하는 감독·장르, 회피하는 감독·장르를 통계적으로 학습해서 표시해줘요.

• 학습 원리 — 👍 누른 영화의 감독/장르엔 가산점, 👎 누른 영화엔 페널티를 부여합니다. 데이터가 쌓일수록 패턴이 뚜렷해져요.
• 큐레이션 반영 — 학습된 선호 감독/장르는 다음 추천에서 가중치를 받고, 회피 감독/장르는 점수가 깎입니다. 같은 책장이어도 피드백에 따라 점점 다른 추천을 받게 돼요.
• 프라이버시 — 모든 학습 데이터는 본인 브라우저에만 저장되며 서버로 전송되지 않습니다. 다른 기기에서는 따로 학습이 진행돼요.

💡 외부 AI API(OpenAI, Claude 등)를 사용하지 않고 클라이언트 측 통계 학습으로 동작합니다. 빠르고 무료이며 본인 데이터를 보호하는 방식이에요.

18 오프라인 모드

인터넷이 끊긴 상태에서도 책장을 편집할 수 있어요. 오프라인 상태가 되면 화면 하단에 안내 배지가 표시되고, 그동안의 변경사항은 기기에 임시 저장됩니다. 다시 온라인이 되면 자동으로 서버에 동기화돼요.

• 오프라인에서 가능한 것 — 책 추가, 한줄평·긴 후기글 작성/수정, 본 횟수 변경, 책 삭제
• 온라인 필요 — More Info(TMDB 검색), 사진 업로드, 다른 도서관장 검색·방문, 큐레이션. 이 기능들은 오프라인 상태에서 누르면 "⚠️ 인터넷 연결이 필요해요!"라는 알림이 표시됩니다.
• 동기화 — 온라인이 되는 순간 큐에 쌓인 변경사항이 순차적으로 서버에 반영됩니다. 화면 하단 배지에 진행 상황이 표시돼요.
• 충돌 처리 — 마지막 수정이 우선 적용됩니다 (개인 앱이라 충돌 가능성은 낮아요).

💡 PWA로 설치하셨다면 비행기·지하철 등 오프라인 상황에서도 자유롭게 기록을 남길 수 있어요.

19 전문 도서관장 — 호칭 퀘스트

상단 ⭐ 버튼(모바일에선 햄버거 메뉴 → "전문 도서관장")을 누르면 호칭 컬렉션이 열립니다. 특정 조건을 만족하면 호칭이 잠금 해제되며, 모은 호칭이 많을수록 진정한 도서관장으로 인정받아요.

• 장르별 호칭 — 같은 장르의 영화를 5편 이상 기록하면 그 장르의 호칭이 잠금 해제됩니다. (예: 스릴러 5편 → "어디서 어떤 반전이 벌어지려나")
• 감독별 호칭 — 한국·외국 영화 거장 12명의 작품을 4편 이상 기록하면 잠금 해제됩니다. 한글/영문 표기 어느 쪽으로 입력해도 자동 매칭되니 자유롭게 등록하세요.
• 진행률 표시 — 잠겨 있는 호칭도 현재까지 얼마나 모았는지 진행률 바로 확인할 수 있어요.
• 누적 통계 + 시즌 챌린지 — 자세한 내용은 23번 참조.

💡 호칭은 본인의 기록에 따라 자동으로 잠금 해제되며, 수동 인증 절차는 없습니다.

20 위시리스트 — 보고 싶은 영화 모으기

아직 보지 않았지만 언젠가 보고 싶은 영화는 위시리스트에 보관할 수 있어요. PC에선 상단바 우측 💬 말풍선 아이콘을, 모바일에선 좌상단 로고 메뉴의 "위시리스트" 항목을 누르면 됩니다.

• 추가 방법 ① — 🔍 검색 모달: 헤더 검색에서 "🎬 영화" 탭으로 영화를 찾으면, 결과 박스 아래 "💬 위시리스트에 추가해두기" 버튼이 나타납니다.
• 추가 방법 ② — + 영화 추가 모달: More Info로 TMDB 검색 후 결과 박스 아래 같은 버튼이 표시돼요.
• 책장으로 옮기기 — 위시리스트 항목에서 "📚 책장에 추가" 버튼을 누르면 + 모달이 미리 채워진 상태로 열려요. 확인 후 출판하면 됩니다.
• 제거 — 항목의 "🗑 제거" 버튼으로 언제든 삭제 가능합니다.

💡 위시리스트는 모든 기기에서 동기화됩니다. 영화관에서 보고 싶은 영화를 발견했을 때 잠시 담아두기 좋아요.

21 인스타 스토리 공유

한 줄 평을 작성한 영화는 인스타그램 스토리에 멋진 카드 형식으로 공유할 수 있어요. 책 패널을 열고 표지 위 "인스타 공유" 버튼(수정하기 아래)을 누르면 미리보기가 나타납니다.

• 장르별 그라데이션 배경 — 스릴러는 보라, 로맨스는 와인, SF는 짙은 파랑 등 장르에 어울리는 무드의 카드가 자동 생성돼요.
• 📲 인스타 스토리로 바로 보내기 — 모바일에선 OS 공유 시트가 열려 인스타그램을 선택할 수 있어요 (Apple Music/Spotify 공유 방식과 동일).
• 💾 이미지 저장 — PNG 파일로 다운로드한 뒤 직접 업로드.
• 📋 클립보드 복사 — 지원하는 브라우저에서는 바로 복사해서 붙여넣기 가능.
• 글자 수 제한 — 명대사가 너무 길면 자동으로 줄여서 카드가 깔끔하게 유지돼요.

22 상세 취향 분석

상단 통계 팝업에서 "🤖 더 자세한 취향 분석 →" 버튼을 누르면 본인의 취향 데이터를 가로 막대 그래프로 자세히 볼 수 있어요.

• 신뢰도 게이지 — 데이터 양과 일관성이 종합되어 표시됩니다.
• 선호/회피 감독·장르 막대 그래프 — 시간 가중치(반감기 30일)가 반영된 점수를 한눈에 비교할 수 있어요.

💡 큐레이션의 👍/👎 피드백을 누를수록 그래프가 풍부해집니다. 모든 데이터는 본인 계정에만 저장돼요.

23 누적 통계 / 시즌 챌린지

⭐ 전문 도서관장 모달에는 장르·감독 호칭 외에 누적 통계 호칭과 이번 달 챌린지도 함께 표시됩니다.

• 누적 통계 호칭 — "100편 돌파", "재관람 5편", "총 관람 300회" 같은 누적 마일스톤을 달성하면 잠금 해제돼요.
• 이번 달 챌린지 — 매월 1일에 새로 시작되는 단기 챌린지. 현재는 "이번 달 새 영화 3편 기록"이 등장하고, 매월 자동으로 갱신됩니다.

💡 시즌 챌린지는 차차 다양해질 예정입니다.

24 도움이 필요하면

사용 중 문제가 생기거나 개선 제안이 있으시면 hyperreal721@naver.com으로 연락주세요. 즐거운 기록 되시길 바랍니다 🎬