Skip to content

Conversation

@1026hz
Copy link
Contributor

@1026hz 1026hz commented Nov 4, 2025

☝️Issue Number

closes #131

📌 개요

OT(Operational Transformation) 기반의 동시편집 시스템을 Yjs CRDT(Conflict-free Replicated Data Type) 기반으로 리팩토링했습니다.
기존 OT 엔진의 복잡한 변환 로직을 제거하고, Yjs의 자동 충돌 해결 기능으로 더 안정적이고 유지보수하기 쉬운 동시편집 시스템을 구축했습니다.

🔁 변경 사항

refactor: OT 엔진 및 관련 클래스 삭제
chore: 사용하지 않는 파일 삭제
refactor: Note 엔티티 및 DTO를 Y.Doc 바이너리 저장 방식으로 변경
refactor: Yjs Y.Doc 기반 저장/복원 로직 추가 (Redis/DB 통합 처리)
refactor: WebSocket 메시지 포맷을 Yjs Y.Doc 업데이트 방식으로 변경
refactor: 컨트롤러 및 스케줄러를 Yjs 동기화 방식으로 업데이트
refactor: Redis 키 및 WebSocket 이벤트 리스너 Yjs 컨텍스트에 맞게 변경

1. 데이터 모델 변경

  • Note 엔티티: OT 관련 필드 제거 → ydoc_binary (Y.Doc 바이너리) 추가
  • NoteResponseDto: Y.Doc 바이너리 초기화 데이터 포함
  • 저장 방식: 텍스트 기반 → Y.Doc 바이너리 (CRDT 상태 전체 저장)

2. WebSocket 메시지 포맷 변경

  • 기존: { operation: {...}, revision: ... } (OT 연산)
  • 신규: { yjsUpdate: "base64...", noteId: ... } (Yjs Y.Doc 업데이트)

3. Redis 저장 방식 개선

  • 기존: 연산별 저장 (충돌 해결 필요)
  • 신규: 전체 Y.Doc 상태 저장 (자동 충돌 해결, 복원 시 완전한 상태 보장)

4. 컨트롤러/스케줄러 업데이트

  • NoteController: Y.Doc 초기화 로직 추가
  • NoteWebSocketController: STOMP 기반 Yjs 동기화
  • NoteAutoSaveScheduler: Y.Doc 바이너리 자동 저장 (5단계 검증 로깅)
  • NoteRedisService: Y.Doc 업데이트 저장/검증 (5단계 상세 로깅)

5. 의존성 추가

  • build.gradle: Yjs 라이브러리 추가 (y-noDb)

📸 스크린샷

스크린샷 2025-11-04 오전 10 39 38

👀 기타 더 이야기해볼 점

@1026hz 1026hz self-assigned this Nov 4, 2025
@1026hz 1026hz merged commit d6db69e into develop Nov 4, 2025
3 checks passed
@1026hz 1026hz deleted the refactor/#131 branch November 26, 2025 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants