Repository navigation
Routine Usecase
wcorn edited this page Jul 23, 2026
·
3 revisions
📁 「플래너」 통합 모듈의 하위 영역 루틴("내가 하는 일", 진실=Google). 통합 개요는 플래너 모듈 개요 참고.
범위: 시작일~종료일 + 반복 규칙(매일/요일/매월/N일)을 지정하면 Google Calendar 반복 이벤트(RRULE) 가 자동 생성되는 통합 루틴. 체크형 습관(날짜별 완료 체크)과 시간 고정 일정을 한 개념으로 다룬다. 습관의 완료 체크만 orino에 오버레이로 저장한다.
상태: ✅ 구현 완료 — R0
R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597). Planner(Google Calendar 연동) 모듈 위에 올라간다. 결정 근거는 결정 기록 참고.
| 액터 | 설명 |
|---|---|
| 사용자 | 단일 사용자(본인). JWT로 orino에 로그인된 상태 |
| Calendar API (반복 이벤트 RRULE source of truth) | |
| orino BE | Google 토큰 보관·프록시(BFF). RRULE 작성·시리즈 편집·습관 체크 오버레이 담당 |
- orino에 로그인되어 있다 (JWT 유효).
- Google 계정이 연동되어 있어야 한다 (루틴 = Google 반복 이벤트). 미연동 시 루틴 생성은 409로 막고 연결 CTA를 노출한다.
- Planner 통합 캘린더(
/planner/calendar)가 동작한다 (루틴 인스턴스는 이 피드로 펼쳐져 표시된다).
| 종류 | 정의 | 예시 | 표현 |
|---|---|---|---|
| 체크형 습관 (habit) | 시간대 없이 "그날 할 일"로 반복. 날짜별 완료 체크 | 운동, 영단어, 물 마시기 | 종일 이벤트 + 체크 동그라미. 완료는 orino routine_check에 기록 |
| 시간 고정 일정 (schedule) | 시간이 박힌 반복 일정 | 매주 화 10시 팀 회의 | 시간 블록 이벤트. 체크 없음 |
둘 다 동일한 생성/편집 흐름을 공유하며, "종일 토글" 하나로 갈린다.
| 패턴 | 입력 | RRULE 매핑 |
|---|---|---|
| 매일 | — | FREQ=DAILY |
| N일 간격 | 간격 N | FREQ=DAILY;INTERVAL=N |
| 주간(요일 선택) | 요일 집합 | FREQ=WEEKLY;BYDAY=MO,WE,FR |
| 매월 특정일 | 일자 집합 | FREQ=MONTHLY;BYMONTHDAY=1,15 |
- 시작일: 이벤트 DTSTART. 첫 인스턴스 기준.
-
종료일:
UNTIL. 비우면 무기한(open-ended).
- 사용자가 캘린더 또는 루틴 화면에서 [+ 루틴] 클릭.
- 종류 = 습관(체크형) 선택 → 제목 "운동하기", 종일 ON.
- 반복 = 주간, 요일 = 월·수·금. 시작일 = 오늘, 종료일 = 비움(무기한).
- 저장 → BE가
RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR+ 종일 이벤트로 Google Calendar에 반복 이벤트 생성(habit 태그). - 캘린더의 월·수·금 칸마다 "운동하기" 체크 항목이 자동 표시된다.
- [+ 루틴] → 종류 = 고정 일정, 종일 OFF.
- 제목 "팀 회의", 시간 10:00~11:00. 반복 = 주간 · 화. 시작일 지정.
- 저장 → BE가
RRULE:FREQ=WEEKLY;BYDAY=TU+ 시간 블록 이벤트로 Google에 생성(schedule 태그). - 주/일 뷰의 화요일 10시 슬롯에 반복 표시.
- 캘린더(또는 "오늘의 루틴" 섹션)에서 오늘 습관 항목의 동그라미 클릭.
- BE가
routine_check에 (recurringEventId, 오늘 날짜) 행을 upsert → 완료 표시(낙관적 갱신). - 다시 클릭 → 행 삭제 → 미완료로 복귀.
- 완료 상태는 기기 간 동기화된다(서버 저장). 시간 고정 일정엔 체크가 없다.
- 루틴 인스턴스(또는 루틴 목록) → [수정].
- 시간/요일/제목 변경 후 저장 시 적용 범위를 묻는다.
- 전체 시리즈: 마스터 이벤트 patch (과거 포함 전부).
-
이후 모두: 기존 시리즈를 분할 지점 전날까지로 끊고(
UNTIL), 분할일부터 새 반복 이벤트 생성. - 이 날짜만: 해당 인스턴스만 예외(exception)로 patch.
- Google에 반영, 캘린더 갱신.
- 루틴 → [삭제] → 범위 선택(전체 / 이후 모두 / 이 날짜만).
- 전체=시리즈 삭제, 이후 모두=
UNTIL로 끊기, 이 날짜만=인스턴스 취소(cancelled exception). - 삭제된 인스턴스의
routine_check행은 정리(전체/이후 삭제 시 해당 범위 체크 삭제).
- 루틴 관리 화면에서 현재 살아있는 루틴 시리즈 목록을 본다(종류·반복 규칙·기간 요약).
- 항목에서 바로 수정/삭제 진입.
| 상황 | 동작 |
|---|---|
| Google 미연동 | 루틴 생성/수정/삭제 시도 → 409, "Google 연결이 필요합니다" CTA |
| access token 만료 | BE가 refresh로 자동 재발급(사용자 인지 없음) — Planner와 동일 |
invalid_grant |
연동 무효 → 재연결 요구 |
| Google API 일시 오류/레이트리밋 | 생성/편집 실패 토스트, 낙관적 갱신 롤백 |
| 체크 토글 중 네트워크 오류 | 낙관적 갱신 롤백 + 재시도 안내 |
| 'following' 분할 중 2단계 중 실패 | 멱등 재시도. 부분 적용 방지를 위해 분할 순서·검증 명시(결정 기록) |
[통합 캘린더 (/planner/calendar)]
│ ├─ [+ 루틴] → [루틴 생성 폼] (종류·반복·기간) → 저장(구글 반영)
│ ├─ 습관 인스턴스 ○ 클릭 → 체크/해제 (routine_check)
│ ├─ 루틴 인스턴스 클릭 → [상세] → [수정]/[삭제] → 범위 선택
│ └─ [오늘의 루틴] 섹션 → 종일 습관 체크 리스트
└─ [루틴 관리 (/planner/routines)] → 시리즈 목록 → 수정/삭제
- 루틴별 알림/푸시 (Planner 공통 비목표와 동일)
- 스트릭/히트맵/통계 (체크 데이터 축적 후 차기 — SP-V6-005/006)
- 자동 스케줄링(가용시간 배치) — 여전히 백로그(SP-V5-004)
- 매월 "마지막 주 금요일" 등 BYDAY+BYSETPOS 고급 규칙 (1차 제외)
- 루틴을 Google Tasks로 생성 (루틴은 Calendar 이벤트로 확정)