memobot 1.3.3

Google Drive-synchronized floating Post-it memo pad for Windows, macOS, and Linux

Memo-Bot v1.3.3 📌

구글 드라이브 기반의 완벽히 동기화되는 크로스 플랫폼 포스트잇 메모장입니다. 안드로이드(Flutter)와 데스크톱(Windows, macOS, Linux - Python/PyWebView) 환경을 지원하며, 사용자의 구글 드라이브 **숨겨진 앱 폴더 (Application Data Folder)**를 이용해 보안이 매우 뛰어나고 깔끔한 동기화를 수행합니다.

---

🎨 기술 스택 및 특징

• Desktop Client: Python + PyWebView (HTML/JS/CSS). OS 내장 웹뷰를 사용하므로 배포 파일 및 메모리 소모가 최소화됩니다.
• Mobile Client (Android): Flutter (Material 3 다크 모드). 모던하고 유려한 포스트잇 리스트 및 편집 인터페이스 제공.
• Sync Engine: Google Drive AppData API. 사용자의 파일 목록에 노출되지 않는 고유 앱 저장소를 사용하고, 파일의 appProperties 메타데이터를 캐싱하여 트래픽 소모가 매우 적고 반응이 빠른 동기화를 지원합니다.

---

📂 데이터 저장 경로 및 파일 포맷

메모를 작성하고 저장하면 각 메모는 로컬 컴퓨터에 개별 JSON 파일 형태로 저장됩니다.

1. 로컬 저장 경로

• Windows: C:\Users\<사용자명>\.memobot\notes\
• macOS / Linux: ~/.memobot/notes/

2. 파일 형식 및 이름

• 각 메모당 note_<고유ID>.json 형식으로 저장됩니다. (예: note_a1b2c3d4.json)

3. JSON 데이터 구조 예시

메모의 내용, 색상, 좌표 및 크기, 태그 정보뿐만 아니라 첨부된 이미지 데이터까지 단일 JSON 파일 내에 보관합니다.

{
  "id": "a1b2c3d4-...",
  "content": "메모 내용입니다. #태그",
  "color": "yellow",
  "tags": ["태그"],
  "x": 120,
  "y": 250,
  "width": 250,
  "height": 250,
  "is_folded": false,
  "on_top": true,
  "updated_at": "2026-06-04T12:57:08Z",
  "image": "data:image/png;base64,iVBORw0KGgoAAA..." // 첨부된 이미지 데이터 (Base64 인코딩)
}

[!NOTE] 구글 드라이브 동기화가 실행되면 구글 드라이브의 숨겨진 앱 전용 저장소(AppData Folder) 폴더에도 로컬과 동일한 파일명 및 JSON 데이터 포맷으로 저장 및 동기화됩니다.

---

🔑 구글 드라이브 API 설정 (OAuth 2.0)

양쪽 플랫폼에서 동기화 기능을 활성화하기 위해 Google Cloud Console에서 OAuth 2.0 자격 증명을 설정해야 합니다.

1. Google Cloud Console 접속:

   • Google Cloud Console에 구글 계정으로 로그인합니다.
   • 새 프로젝트를 생성합니다 (예: Memo-Bot).

2. Google Drive API 활성화:

   • API 및 서비스 > 라이브러리로 이동합니다.
   • Google Drive API를 검색하고 사용(Enable) 버튼을 클릭합니다.

3. OAuth 동의 화면 설정:

   • API 및 서비스 > OAuth 동의 화면으로 이동합니다.
   • User Type을 **외부(External)**로 선택하고 생성을 누릅니다.
   • 필수 정보(앱 이름, 이메일 등)를 입력합니다.
   • 범위(Scopes) 설정 단계에서 .../auth/drive.appdata 범위를 추가합니다 (구글 드라이브의 앱 전용 숨겨진 폴더 읽기/쓰기 권한).
   • 테스트 사용자 (Test Users) 등록 단계에서 동기화 테스트에 사용할 본인의 구글 이메일을 반드시 추가합니다.

[!IMPORTANT] OAuth 동의 화면의 퍼블리싱 상태가 테스트(Testing) 모드인 경우, 테스트 사용자로 이메일 계정이 등록되어 있어야만 구글 로그인이 정상 처리되고 차단 에러(403 access_denied)가 발생하지 않습니다.

4. 사용자 인증 정보(Credentials) 생성:
   • API 및 서비스 > 사용자 인증 정보로 이동합니다.
   • 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
   • 애플리케이션 유형을 **데스크톱 앱(Desktop App)**으로 선택하고 이름을 입력 후 생성합니다.
   • 생성된 클라이언트 ID의 JSON 파일을 다운로드합니다.

---

💻 데스크톱 앱 실행 및 배포 (Python)

1. 자격 증명 파일 배치

다운로드받은 클라이언트 비밀번호 JSON 파일을 client_secrets.json으로 이름을 변경하여 다음 경로에 저장합니다.

• Windows: C:\Users\<사용자명>\.memobot\client_secrets.json
• macOS/Linux: ~/.memobot/client_secrets.json

2. 개발자 모드 로컬 실행

cd desktop
# 가상환경 생성 및 활성화
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 의존성 패키지 설치
pip install -e .

# 앱 실행
memobot

3. PyPI 배포용 빌드 및 업로드

패키지 청소, 빌드, 업로드를 일괄적으로 자동 처리해주는 배치 스크립트가 제공됩니다:

# Windows 환경에서 빌드 및 배포 배치파일 실행
./publish_pypi.bat

• 실행 시 기존 빌드 임시 파일들을 모두 초기화하고, build 및 twine 모듈을 자동으로 최신 설치/업그레이드한 후 빌드를 수행합니다.
• 빌드 완료 후 [1] TestPyPI 업로드, [2] 공식 PyPI 업로드, [3] 업로드 없이 빌드만 수행 중 하나를 선택해 진행할 수 있습니다.
• 배포 완료 시 사용자는 pip install memobot 명령어만으로 크로스 플랫폼(Windows, macOS, Linux) 환경에 설치하고 memobot 명령어로 즉시 앱을 실행할 수 있습니다.

4. PyPI 패키지 관리 방법 (설치, 업데이트, 삭제)

일반 사용자는 파이썬이 설치된 환경에서 아래의 pip 명령어를 사용해 패키지를 편리하게 관리할 수 있습니다.

• 설치 (Install):

  pip install memobot
  

• 실행 (Run): 설치 후 터미널이나 명령 프롬프트에서 아래 명령을 실행하면 데스크톱 앱이 실행됩니다 (윈도우 환경에서는 검은색 콘솔창 없이 백그라운드용 앱으로 실행됩니다).

  memobot
  

• 최신 버전 업데이트 (Update):

  pip install --upgrade memobot
  

• 삭제 (Uninstall):

  pip uninstall memobot
  

---

📱 모바일 앱 실행 (Flutter Android)

1. Flutter 의존성 구성

cd mobile
flutter pub get

2. 안드로이드 플랫폼 설정

구글 로그인 연동을 위해 안드로이드 앱의 패키지명과 디버그 서명 키(SHA-1)를 Google Cloud Console의 동일 프로젝트에 등록해야 합니다.

1. OAuth 클라이언트 ID 추가 생성:
   • Google Cloud Console > 사용자 인증 정보 > OAuth 클라이언트 ID 생성.
   • 유형을 Android로 선택합니다.
   • 패키지 이름 입력 (예: com.example.memobot).
   • 개발용 SHA-1 지문 인증서를 입력합니다 (JDK의 keytool을 통해 조회 가능).
2. 서비스 파일 다운로드:
   • 필요에 따라 Firebase와 결합하여 사용할 경우 google-services.json을 mobile/android/app/ 아래에 배치할 수 있으나, 본 구현에서는 google_sign_in 패키지가 클라이언트 ID를 통해 직접 동작하므로 최소한의 설정만으로 작동 가능합니다.

3. 앱 실행

flutter run

---

🔄 동기화 및 충돌 방지 세부 설계

• Tombstoning (소프트 삭제): 사용자가 앱 내에서 메모를 삭제하면 파일이 즉시 영구 삭제되지 않고 내부 필드가 is_deleted: true로 갱신됩니다. 이는 다른 디바이스가 동기화 시점에 해당 메모를 로컬에서도 똑같이 지워주도록 유도하며, 완벽한 삭제 전파를 제공합니다.
• Last-Write-Wins (최종 쓰기 우선): 오프라인 수정을 포함하여 서로 다른 기기에서 같은 포스트잇을 수정한 경우, JSON 내부의 updated_at 타임스탬프를 기준으로 더 늦게 편집된 최종 데이터를 기준으로 덮어씁니다.

---

🚀 업데이트 내역 (Changelog)

v1.3.3 (2026-06-06)

• 버튼 미니멀화 및 도움말 가이드 추가: 대시보드 제어 버튼을 슬림하고 미니멀하게 디자인을 조정하고, 해시태그, 메모링크(WikiLinks), AI(Gemini) 설정 및 사용법을 상세 안내하는 도움말 가이드 모달을 탑재했습니다.

v1.3.2 (2026-06-06)

• Gemini API 키 다중 입력 UI 개선: 단일 입력창에 쉼표로 길게 나열해야 했던 기존 방식 대신, 설정 창에서 한 칸에 키 하나씩 깔끔하게 등록할 수 있도록 다중 키 동적 추가(+)/삭제(휴지통) 인터페이스를 구현했습니다. 기존 백엔드 자동 키 순환(rotation) 알고리즘과 100% 하위 호환됩니다.

v1.3.1 (2026-06-05)

• 옵디시언 스타일 위키링크 [[ ]] 연동: 메모 본문 내 대괄호 링크([[메모 제목]]) 클릭 시 해당 메모 창을 즉시 포커스하고, 메모가 없는 경우 자동으로 첫 줄 제목을 가진 신규 메모를 생성해 연동해주는 WikiLinks 기능을 탑재했습니다.
• 구글 드라이브 삭제된 메모 완전 삭제: 구글 드라이브와 동기화 시, 이미 소프트 삭제(Tombstone) 처리된 삭제 대기 메모가 동기화 목록에 남아 잔존하는 현상을 방지하도록 원격 및 로컬에서 영구 삭제 처리하는 루틴을 보강했습니다.
• 기본 웰컴 메모 비활성화: 앱 처음 실행 시 로컬 저장소에 기본으로 생성되던 2개의 튜토리얼 성격의 가이드 메모가 생성되지 않도록 수정하여 더 깔끔한 시작 화면을 제공합니다.
• 날짜 포맷 변경: 메모 생성 및 업데이트 시, 시간(시/분/초) 정보만 노출되던 화면에 년-월-일 정보가 함께 노출되도록 날짜 표시 포맷을 수정했습니다 (YYYY-MM-DD HH:MM:SS).
• 필터 초기화 자동화: 해시태그나 메모 내용을 수정한 후 저장 시, 편집한 메모가 현재 검색 또는 태그 필터 때문에 보이지 않는 현상을 방지하기 위해 필터를 자동으로 '전체'로 초기화하여 방금 수정한 메모가 대시보드에 즉시 노출되도록 개선했습니다.
• 슬림 카드 뷰 & 휠 스크롤 지원: 대시보드에서 접힌 상태의 메모 카드를 대폭 슬림화(38px)하고 접힌 상태에서도 메모 본문 첫 번째 줄이 상단에 노출되도록 최적화했습니다. 추가로, 스크롤바 노출 없이 마우스 휠 스크롤을 감지해 간편하게 오르내릴 수 있도록 편의성을 강화했습니다.
• 버전 뱃지 추가: 매니저 창 헤더의 로고 우측에 메인 테마와 조화로운 Glassmorphism 스타일의 버전 뱃지(v1.3.1)를 부착했습니다.