Skip to content

Routine Usecase

wcorn edited this page Jul 23, 2026 · 3 revisions

유스케이스: Routine (반복 루틴 / 고정 일정)

📁 「플래너」 통합 모듈의 하위 영역 루틴("내가 하는 일", 진실=Google). 통합 개요는 플래너 모듈 개요 참고.

범위: 시작일~종료일 + 반복 규칙(매일/요일/매월/N일)을 지정하면 Google Calendar 반복 이벤트(RRULE) 가 자동 생성되는 통합 루틴. 체크형 습관(날짜별 완료 체크)과 시간 고정 일정을 한 개념으로 다룬다. 습관의 완료 체크만 orino에 오버레이로 저장한다.

상태: ✅ 구현 완료 — R0R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597). Planner(Google Calendar 연동) 모듈 위에 올라간다. 결정 근거는 결정 기록 참고.

1. 액터

액터 설명
사용자 단일 사용자(본인). JWT로 orino에 로그인된 상태
Google Calendar API (반복 이벤트 RRULE source of truth)
orino BE Google 토큰 보관·프록시(BFF). RRULE 작성·시리즈 편집·습관 체크 오버레이 담당

2. 사전 조건

  • orino에 로그인되어 있다 (JWT 유효).
  • Google 계정이 연동되어 있어야 한다 (루틴 = Google 반복 이벤트). 미연동 시 루틴 생성은 409로 막고 연결 CTA를 노출한다.
  • Planner 통합 캘린더(/planner/calendar)가 동작한다 (루틴 인스턴스는 이 피드로 펼쳐져 표시된다).

3. 핵심 개념: 통합 루틴 두 종류

종류 정의 예시 표현
체크형 습관 (habit) 시간대 없이 "그날 할 일"로 반복. 날짜별 완료 체크 운동, 영단어, 물 마시기 종일 이벤트 + 체크 동그라미. 완료는 orino routine_check에 기록
시간 고정 일정 (schedule) 시간이 박힌 반복 일정 매주 화 10시 팀 회의 시간 블록 이벤트. 체크 없음

둘 다 동일한 생성/편집 흐름을 공유하며, "종일 토글" 하나로 갈린다.

4. 반복 규칙 (시작일~종료일 + 패턴)

패턴 입력 RRULE 매핑
매일 — FREQ=DAILY
N일 간격 간격 N FREQ=DAILY;INTERVAL=N
주간(요일 선택) 요일 집합 FREQ=WEEKLY;BYDAY=MO,WE,FR
매월 특정일 일자 집합 FREQ=MONTHLY;BYMONTHDAY=1,15
  • 시작일: 이벤트 DTSTART. 첫 인스턴스 기준.
  • 종료일: UNTIL. 비우면 무기한(open-ended).

5. 핵심 시나리오

UC-1. 체크형 습관 만들기 (예: 운동, 월·수·금)

  1. 사용자가 캘린더 또는 루틴 화면에서 [+ 루틴] 클릭.
  2. 종류 = 습관(체크형) 선택 → 제목 "운동하기", 종일 ON.
  3. 반복 = 주간, 요일 = 월·수·금. 시작일 = 오늘, 종료일 = 비움(무기한).
  4. 저장 → BE가 RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR + 종일 이벤트로 Google Calendar에 반복 이벤트 생성(habit 태그).
  5. 캘린더의 월·수·금 칸마다 "운동하기" 체크 항목이 자동 표시된다.

UC-2. 시간 고정 일정 만들기 (예: 매주 화 10시 회의)

  1. [+ 루틴] → 종류 = 고정 일정, 종일 OFF.
  2. 제목 "팀 회의", 시간 10:00~11:00. 반복 = 주간 · 화. 시작일 지정.
  3. 저장 → BE가 RRULE:FREQ=WEEKLY;BYDAY=TU + 시간 블록 이벤트로 Google에 생성(schedule 태그).
  4. 주/일 뷰의 화요일 10시 슬롯에 반복 표시.

UC-3. 오늘의 습관 체크 / 해제

  1. 캘린더(또는 "오늘의 루틴" 섹션)에서 오늘 습관 항목의 동그라미 클릭.
  2. BE가 routine_check에 (recurringEventId, 오늘 날짜) 행을 upsert → 완료 표시(낙관적 갱신).
  3. 다시 클릭 → 행 삭제 → 미완료로 복귀.
  4. 완료 상태는 기기 간 동기화된다(서버 저장). 시간 고정 일정엔 체크가 없다.

UC-4. 루틴 수정 — 범위 선택 (전체 / 이후 모두 / 이 날짜만)

  1. 루틴 인스턴스(또는 루틴 목록) → [수정].
  2. 시간/요일/제목 변경 후 저장 시 적용 범위를 묻는다.
    • 전체 시리즈: 마스터 이벤트 patch (과거 포함 전부).
    • 이후 모두: 기존 시리즈를 분할 지점 전날까지로 끊고(UNTIL), 분할일부터 새 반복 이벤트 생성.
    • 이 날짜만: 해당 인스턴스만 예외(exception)로 patch.
  3. Google에 반영, 캘린더 갱신.

UC-5. 루틴 삭제 — 범위 선택

  1. 루틴 → [삭제] → 범위 선택(전체 / 이후 모두 / 이 날짜만).
  2. 전체=시리즈 삭제, 이후 모두=UNTIL로 끊기, 이 날짜만=인스턴스 취소(cancelled exception).
  3. 삭제된 인스턴스의 routine_check 행은 정리(전체/이후 삭제 시 해당 범위 체크 삭제).

UC-6. 루틴 목록 조망 (관리)

  1. 루틴 관리 화면에서 현재 살아있는 루틴 시리즈 목록을 본다(종류·반복 규칙·기간 요약).
  2. 항목에서 바로 수정/삭제 진입.

6. 예외 / 오류 시나리오

상황 동작
Google 미연동 루틴 생성/수정/삭제 시도 → 409, "Google 연결이 필요합니다" CTA
access token 만료 BE가 refresh로 자동 재발급(사용자 인지 없음) — Planner와 동일
invalid_grant 연동 무효 → 재연결 요구
Google API 일시 오류/레이트리밋 생성/편집 실패 토스트, 낙관적 갱신 롤백
체크 토글 중 네트워크 오류 낙관적 갱신 롤백 + 재시도 안내
'following' 분할 중 2단계 중 실패 멱등 재시도. 부분 적용 방지를 위해 분할 순서·검증 명시(결정 기록)

7. 화면 흐름

[통합 캘린더 (/planner/calendar)]
   │  ├─ [+ 루틴] → [루틴 생성 폼] (종류·반복·기간) → 저장(구글 반영)
   │  ├─ 습관 인스턴스 ○ 클릭 → 체크/해제 (routine_check)
   │  ├─ 루틴 인스턴스 클릭 → [상세] → [수정]/[삭제] → 범위 선택
   │  └─ [오늘의 루틴] 섹션 → 종일 습관 체크 리스트
   └─ [루틴 관리 (/planner/routines)] → 시리즈 목록 → 수정/삭제

8. 범위 외 (유스케이스)

  • 루틴별 알림/푸시 (Planner 공통 비목표와 동일)
  • 스트릭/히트맵/통계 (체크 데이터 축적 후 차기 — SP-V6-005/006)
  • 자동 스케줄링(가용시간 배치) — 여전히 백로그(SP-V5-004)
  • 매월 "마지막 주 금요일" 등 BYDAY+BYSETPOS 고급 규칙 (1차 제외)
  • 루틴을 Google Tasks로 생성 (루틴은 Calendar 이벤트로 확정)

Clone this wiki locally