Skip to content
wcorn edited this page Sep 20, 2026 · 35 revisions

PRD: orino

1. 제품 비전

orino는 개인용 서비스 플랫폼이다. 단일 사용자(본인)만 사용하며, 다양한 기능 모듈을 점진적으로 추가해 평생 운영한다.

2. 핵심 원칙

  • 단일 사용자: 본인만 사용한다. 회원가입 기능은 없다.
  • 모듈형 확장: 독립적인 기능 모듈을 하나씩 추가한다.
  • 장기 운영: 유지보수 부담을 최소화하고, 안정적으로 오래 쓸 수 있는 구조를 지향한다.

3. 사용자

구분 내용
사용자 수 1명 (본인)
회원가입 없음
계정 관리 사전 등록된 계정으로 로그인

4. 모듈 로드맵

순서 모듈 상태
1 인증 (로그인) 구현 완료
2 Study Planner v1 (복습 사이클 검증 MVP) 구현 완료 — v2로 재설계
3 Study Planner v2 (노트 + 플래시카드) 구현 완료
3.1 Study Planner v2.1 (노트 트리화 — BE) 구현 완료
3.2 Study Planner v2.2 (노트 Notion 인라인 하위 페이지 — FE) 구현 완료
3.3 Study Planner 복습 캘린더 구현 완료
4 Planner (Google Calendar 연동) 구현 완료 (2026-06)
5 Routine (반복 루틴 / 고정 일정) 구현 완료 (2026-06)
6 주간 계획표 (Weekly Plan, 구 Day Plan) 구현 완료 (2026-06)
7 노트 (Note, 자료 노트 + 독립 노트 통합) 통합 완료 (#740)
8 Tools 보류 (장기 백로그)
9 일상기록 (Lifelog) — 순간 기록 + 흐름 구현 완료 (2026-07-24, Epic #949)
10 여행 (Travel) — 일정 보드 + 알림 + 오프라인 구현 완료 (v2.0 2026-08-09 · v2.1 다구간 2026-08-31) · v2.2 경비·준비 기획 (2026-09-05) · 10/24 실사용 마감
11 단축 URL (링크, Shortlink) — 짧은 주소 + QR + 방문 통계 구현 완료 (2026-08-24, Epic #1246)
12 가계부 (Ledger) 폐기 (2026-09-20) — 안 쓴다. 제거 진행 중 (Ledger-Removal)

5. 모듈 1: 인증 (로그인)

5.1 목표

사전 등록된 계정으로 로그인하여 플랫폼의 모든 기능에 접근할 수 있다.

5.2 기능 요구사항

ID 기능 설명
AUTH-001 로그인 아이디/비밀번호로 로그인
AUTH-002 로그아웃 세션/토큰 무효화
AUTH-003 인증 유지 로그인 상태를 일정 기간 유지
AUTH-004 인증 보호 미인증 요청은 로그인 페이지로 리다이렉트

5.3 인증 방식

항목 값
로그인 방식 아이디 / 비밀번호
인증 토큰 JWT (Access Token + Refresh Token)
Access Token 만료 30분
Refresh Token 만료 14일
Refresh Token 저장 Redis
계정 초기 등록 초기 세팅 스크립트로 DB에 삽입

5.4 비기능 요구사항

  • 비밀번호는 BCrypt 암호화 저장
  • Access Token 만료 시 Refresh Token으로 자동 갱신
  • Refresh Token 만료 시 재로그인
  • 로그인 실패 시 명확한 에러 메시지

5.5 화면

화면 설명
로그인 페이지 아이디/비밀번호 입력 폼, 로그인 버튼
메인 페이지 로그인 성공 후 랜딩 (추후 대시보드로 확장)

5.6 범위 외

  • 회원가입
  • 소셜 로그인
  • 비밀번호 찾기/변경 (추후 모듈로 검토)
  • 다중 사용자 / 권한 관리

6. 모듈 2: Study Planner v2 — 노트 + 플래시카드

v2 범위 정의: 학습 자료마다 Notion 스타일 노트(Tiptap 블록 에디터, 본문 /페이지로 하위 노트를 인라인으로 무제한 중첩)를 작성하고, 그 자료에서 만든 Anki 스타일 플래시카드(앞/뒷면)를 SM-2 알고리즘으로 복습한다. 노트와 카드는 같은 자료 안에서 분리된 두 트랙으로 동작한다. (노트: v2.1 단건→트리, v2.2 인라인 하위 페이지로 발전)

v1과의 차이: v1은 "학습 단위(챕터)" 자체를 복습 대상으로 삼았다. 단위 안에 학습 콘텐츠가 없어 "뭘 복습해야 할지"가 외부 자료에 있었고, 셀프 테스트 흐름이 없었다. v2는 노트로 학습 콘텐츠를 서비스 안에 담고, 카드로 셀프 테스트와 SM-2 복습을 한다.

v1 자산(study_unit, review_schedule의 단위 FK)은 전면 롤백 후 v2 스키마로 재구축한다.

6.1 목표

학습한 내용을 한 곳에 정리하고(노트), 핵심을 카드로 추출해 망각곡선에 맞춰 복습(SM-2)한다.

6.2 서비스 정의

항목 내용
서비스명 Study Planner v2
핵심 가치 Notion 같은 학습 노트 + Anki 같은 SM-2 복습이 한 자료에 묶여있음
플랫폼 Web
차별점 다른 서비스는 "노트(Notion)와 카드(Anki)가 분리". orino는 자료 단위로 둘이 묶여 학습 → 카드 추출 → 복습이 한 흐름

6.3 핵심 요소 (3개)

요소 설명
학습 자료 (Study Material) 책/강의/문제집/MOOC 단위. 노트 트리와 카드 N개를 묶는 그릇
학습 노트 (Note) 자료 1:N 트리 (Notion 인라인 하위 페이지, 무제한 중첩). 본문 /페이지로 하위 노트 생성, Tiptap JSON. 학습한 내용을 중첩 정리
플래시카드 (Flashcard) 자료 1:N, 앞/뒷면. 카드별 SM-2 상태로 복습 일정 자동 관리

6.4 핵심 사용자 플로우

[자료 등록] ─┬─→ [노트 작성] (본문 /페이지로 하위 노트 인라인, 자동 저장)
            │
            └─→ [카드 추가 (앞/뒤)]
                       ↓
              [첫 복습 1건 자동 생성 (1일 후, ease 2.50)]
                       ↓
   매일: [오늘 복습 화면]
            앞면 표시 → 답 적기 → [⌘/Ctrl+Enter] → 뒷면 공개(내 답과 비교)
                                              → [Again/Hard/Good/Easy]
                       ↓
              [SM-2로 다음 복습 1건 생성]
                       ↺

6.5 복습 알고리즘: Anki SM-2 스케줄러

Anki의 SM-2 스케줄러(rslib/src/scheduler/states/review.rs)를 그대로 옮겼다. 상수·수식·하한 모두 Anki 기본값이다.

평가 입력: Anki 표준 4단계 (Again/Hard/Good/Easy) — FSRS와 동일 입력 포맷.

평가 의미 ease 변화 (Anki 상수)
AGAIN 다시 (실패) −0.20 (EASE_FACTOR_AGAIN_DELTA)
HARD 어려움 −0.15 (EASE_FACTOR_HARD_DELTA)
GOOD 보통 0
EASY 쉬움 +0.15 (EASE_FACTOR_EASY_DELTA)

ease 하한 1.30(MINIMUM_EASE_FACTOR), 시작값 2.50(INITIAL_EASE_FACTOR).

다음 간격 계산:

if AGAIN:
    interval = 1, ease = max(prev_ease - 0.20, 1.30)      # due는 당일 10분 뒤(재학습)
else:
    days_late = max(0, 예정일보다 늦게 본 일수)

    hard = max(round(prev_interval × 1.2),                        prev_interval + 1)
    good = max(round((prev_interval + days_late/2) × prev_ease),  hard + 1)
    easy = max(round((prev_interval + days_late) × prev_ease × 1.3), good + 1)

세 가지가 핵심이다.

  1. ease는 갱신 전 값(prev_ease)을 간격에 쓴다. 평가로 바뀐 ease는 다음 회차부터 적용된다. Anki answer_easy도 반환 상태의 ease만 올리고 간격엔 self.ease_factor를 쓴다.
  2. 하한이 hard < good < easy 순서를 강제한다. 배수만으로는 반올림 탓에 뒤집히거나 같아질 수 있다.
  3. 밀린 일수 보너스 — 늦게 봤는데도 기억했다면 그만큼 더 벌린다. Good은 절반만, Easy는 전부, Hard는 반영하지 않는다.

Anki의 학습 단계(learning steps)·졸업 간격은 두지 않는다. 카드 생성 시 1일 뒤 첫 복습을 잡는 것이 졸업 간격 역할을 하고, 그 뒤로는 위 수식만 탄다(SM-2의 "2회차=6일" 같은 고정 단계 없음).

ease 2.50에서 Good만 눌러온 카드(제때 복습):

직전 간격 Again Hard Good Easy
1d 10분 2d 3d 4d
3d 10분 4d 8d 10d
8d 10분 10d 20d 26d
20d 10분 24d 50d 65d

왜 순정 SM-2가 아닌가 (#1001): 교과서 SM-2는 q≥3에서 간격을 직전간격 × 직전ease로만 정해 Hard/Good/Easy가 항상 같은 간격이 된다. rating은 ease만 바꾸고 그 ease는 다음 회차에나 쓰여 효과가 한 회차 늦다. 즉 채점 버튼이 당장은 아무 차이도 만들지 않았다. Anki가 SM-2를 그대로 쓰지 않고 등급별 배수와 하한을 얹은 이유가 이것이다.

규칙 변경 시점에 이미 잡혀 있던 PENDING 일정은 직전 회차 기록(rating·간격·ease·밀린 일수·완료시각) 으로 새 규칙을 다시 돌려 재계산한다(Architecture 참고). 옛 규칙이 놓은 자리에 그대로 있는 행만 손대므로 sibling burying으로 옮겨진 일정은 보존되고, 여러 번 돌려도 멱등이다.

학습일 경계 (#1003): 하루의 경계는 자정이 아니라 새벽 04:00이다. 새벽 1시에 공부한 건 아직 전날 몫으로 친다 — 자정을 경계로 삼으면 밤늦게 공부한 날마다 첫 복습이 하루씩 밀렸다. 복습 due(scheduled_at)가 원래부터 04:00 롤오버였으므로 "오늘"의 정의를 여기에 맞췄다. 다음 복습 날짜·밀린 일수·오늘 복습·오늘 완료 수·오늘/어제/내일 라벨이 모두 이 경계를 쓴다.

놓친 복습: 별도 OVERDUE 상태 없음. scheduled_at <= now AND status = PENDING을 동적으로 "오늘 복습"으로 표시. 뒤늦게 완료해도 다음 복습은 학습일 + new_interval로 잡는다.

6.6 기능 요구사항

ID 영역 기능 설명
SP-V2-001 자료 자료 CRUD 학습 자료 생성/조회/수정/삭제 (제목, 유형). 빈 노트 트리로 시작
SP-V2-002 노트 노트 트리 (인라인 하위 페이지) Tiptap JSON content + childPage 커스텀 노드. 본문 /페이지로 하위 노트 생성·삽입, 블록 클릭 진입, 블록 삭제=노트 삭제. 트리 조회 / 단건 조회 / 생성 / 저장 / 삭제. 본문 PATCH idempotent (자동 저장, 2초 debounce). BE는 v2.1 완료
SP-V2-003 카드 카드 CRUD 자료에 속한 플래시카드 생성(앞/뒤)/수정/삭제. 생성 시 첫 복습 1건 자동 생성
SP-V2-004 복습 오늘 복습 조회 오늘 + 밀린 복습 통합 조회. 평가별 다음 간격 미리보기 포함
SP-V2-005 복습 평가 처리 Again/Hard/Good/Easy 4단계. SM-2로 다음 복습 1건 생성
SP-V2-006 자료 카드 통계 자료별 카드 수 + 오늘 복습 수 표시
SP-V2-007 진입 메인 카드 홈 화면에 "오늘 복습 N건" / "학습 자료 N개" 진입 카드
SP-V2-008 복습 복습 캘린더 월간 달력(투두메이트 스타일)에 예정+완료 복습을 상태별 색으로 표시. 날짜 클릭 시 그날 목록. 보기 전용

6.7 비기능 요구사항

  • 단일 사용자, 단순한 트래픽이므로 인덱스 + 일반 RDB 조회로 충분
  • API 응답 시간: 단순 CRUD/조회 200ms 이내. 노트 저장은 300ms 이내
  • Tiptap content는 JSON 형식 (MySQL JSON 또는 LONGTEXT)
  • 모바일/데스크탑 반응형 (브라우저 기본). PWA는 차기 모듈
  • 다크모드 (디자인 시스템 준수)
  • 카드 복습 화면 키보드 단축키: ⌘/Ctrl+Enter (답 공개 — 답 적는 칸에 포커스가 있는 기본 흐름) → 1/2/3/4 (평가). 입력칸 밖에선 Space도 답 공개

6.8 화면 (5개)

화면 경로 설명
메인 (홈) /home 오늘 복습 카드 + 학습 자료 카드
학습 자료 목록 /planner/materials 자료 카드, 카드 수 + 오늘 복습 수 표시
학습 자료 상세 /planner/materials/:id [노트] (사이드바 트리 + 인라인 하위 페이지 에디터) / [카드] 두 탭
오늘 복습 /planner/reviews/today 카드 단위 4지선다 평가
복습 캘린더 /planner/calendar 월간 달력(투두메이트 스타일), 예정+완료 복습

6.9 v2 범위 외 (장기 백로그)

다음 항목은 v2에 포함하지 않는다. §6.A 참조.

  • 카테고리, 목표/마일스톤
  • 고정 일정, 루틴, 할 일, 자동 스케줄링
  • 캘린더 시간블록 뷰
  • 카드 태그/덱 (현재는 자료가 곧 덱)
  • 카드 일괄 입력 (CSV, Anki 임포트)
  • 노트 내 인라인 카드 블록 (현재 분리 모델)
  • 노트 즐겨찾기/아이콘/커버, 노트 검색 (v2.2는 트리 + 제목 + 인라인 하위 페이지까지)
  • 노트 이동(부모 변경), childPage 블록 복붙 — 차기
  • 노트 협업/공유, 노트 첨부파일
  • 카드 멀티미디어 (이미지/오디오)
  • OCR/URL 학습 자료 입력
  • 알림/푸시, Google Calendar 연동
  • 스트릭, 히트맵, 통계
  • 다중 사용자, 공유

6.10 v1 → v2 전환 (마이그레이션 없음)

v1 출시 직후 사용 데이터가 적음. 점진 마이그레이션 대신 전면 롤백 후 재구축 방식:

  1. v1 BE 도메인(planner/material, planner/review) 및 컨트롤러/서비스 제거
  2. v1 FE 라우트(/planner/materials, /planner/reviews/today) 및 컴포넌트 제거
  3. v1 DB 마이그레이션(study_unit, review_schedule의 v1 구조) 롤백
  4. v2 신규 마이그레이션으로 study_material 재정의, note, flashcard, review_schedule(카드 FK) 신규 생성

별도 롤백 이슈로 트래킹.


6.A 장기 백로그 (v3 이후)

v2 운영 후 점진적으로 확장한다. 각 단계는 독립 모듈로 출시 가능.

6.A.1 분류 + 목표

ID 기능
SP-V3-001 카테고리 CRUD (색상/아이콘)
SP-V3-002 목표 CRUD (1년/6개월/3개월, 마일스톤)
SP-V3-003 학습 자료를 카테고리·목표에 연결
SP-V3-004 카테고리별 시간 통계

6.A.2 노트 ↔ 카드 통합 + 카드 강화

ID 기능
SP-V4-001 노트 내 인라인 card 블록 (Tiptap 커스텀 노드)
SP-V4-002 카드 태그/덱
SP-V4-003 카드 멀티미디어 (이미지/오디오)
SP-V4-004 카드 일괄 입력 (CSV, Anki .apkg 임포트)
SP-V4-005 카드 클로즈(빈칸) 타입

6.A.3 자동 스케줄링 + 캘린더 + 일상 관리

업데이트(2026-06): 일정·할 일·캘린더(SP-V5-001/003/005)는 자체 구현 대신 Google Calendar/Tasks 연동 방식으로 확정되어 독립 모듈 Planner 로 분리됐다(§8). 자동 스케줄링 엔진(SP-V5-004)·루틴·리스케줄링 등 나머지는 여전히 백로그.

ID 기능
SP-V5-001 고정 일정 CRUD (반복/단발) → Planner 모듈(Google 연동)로 이관
SP-V5-002 루틴 CRUD (반복 패턴, 예외, 체크) → 확정·이관: Routine 모듈 (§9) — Google Calendar 반복 이벤트 방식**
SP-V5-003 할 일 CRUD
SP-V5-004 자동 스케줄링 엔진 (가용시간/우선순위/할당)
SP-V5-005 일/주/월 캘린더 뷰
SP-V5-006 리스케줄링 (하루 미루기, 연속 실패)
SP-V5-007 데드라인 역산
SP-V5-008 사용자 선호 설정
SP-V5-009 배치 서비스 (orino-app-batch + ShedLock) 도입

6.A.4 외부 연동 + 알림 + PWA + 동기부여

ID 기능
SP-V6-001 Google Calendar 연동 (OAuth + 동기화) → 확정·이관: Planner 모듈 (§8)
SP-V6-002 학습 자료 간편 입력 (텍스트/OCR/URL)
SP-V6-003 알림 (복습/루틴/마감/스트릭/주간리포트)
SP-V6-004 푸시 알림 + PWA
SP-V6-005 스트릭 (전체/루틴별, 프리즈)
SP-V6-006 히트맵, 통계, 대시보드
SP-V6-007 일일 회고

6.A.5 FSRS 마이그레이션 (v∞)

항목 내용
트리거 누적 리뷰 1,000건 이상 (단일 사용자 약 6~12개월)
방식 FSRS Optimizer (Python)로 사용자별 파라미터 학습 → BE 알고리즘 교체
데이터 호환성 v2 시점부터 rating (4단계) / interval_days / elapsed_days 컬럼을 보존 → 그대로 트레이닝 입력

6.B 범위 외 (전 버전 공통)

  • 오프라인 지원
  • 다중 사용자 / 공유
  • 네이티브 앱 (iOS/Android)
  • AI 기반 학습 추천
  • 소셜 기능 (친구, 랭킹)
  • 학습 콘텐츠 자체 제공 (뷰어, 플레이어)

7. 모듈 3: Tools (보류)

상태: 보류 (Study Planner v2 검증 이후 재개 검토)

기획 문서는 Tools-Module, Tools-Timer, Tools-Open-Items에 보존되어 있다. 진입 시점/우선순위는 v1 검증 결과에 따라 재산정.

7.1 목표

독립적인 미니 도구를 모아놓은 유틸리티 모듈. 학습·게임·업무 보조용 간단한 도구를 한 곳에서 제공하며, 기능 추가가 지속적으로 이루어진다.

7.2 서비스 정의

항목 내용
서비스명 Tools
핵심 가치 독립적인 미니 도구 모음, 지속 확장
플랫폼 Web (FE only, LocalStorage 기반)
특성 각 도구는 완전 독립, 단일 목적, 한 화면 완결

7.3 핵심 원칙

  • 독립성: 각 도구는 완전히 독립. 도구 간 데이터 공유 없음
  • 간결성: 각 도구는 단일 목적, 한 화면에서 완결
  • 확장성: 라우트·컴포넌트·레지스트리 등록만으로 신규 도구 추가
  • FE only (현재): 설정은 LocalStorage에만 저장. BE API 없음
    • 추후 필요 시 BE 동기화 도입 가능

7.4 도구 목록

ID 도구 설명 상태
TOOL-001 메이플 재획 타이머 2단계 주기 알림 타이머 (버프 쿨타임 관리) 기획 완료

7.5 기능 요구사항 (TOOL-001: 메이플 재획 타이머)

ID 기능 설명
TOOL-001-1 시간 설정 Timer 1, Splits, Timer 2 입력 (초 단위)
TOOL-001-2 알림 시퀀스 [time1/splits] × splits + [time2] 반복
TOOL-001-3 타이머 제어 시작 / 일시정지 / 재개 / 리셋 / 정지
TOOL-001-4 소리 알림 공통 사운드 시스템의 mp3 재생 + 볼륨 조절 + 미리듣기
TOOL-001-5 브라우저 알림 Notifications API (옵션)
TOOL-001-6 시각 피드백 알림 순간 카운트다운 영역 플래시
TOOL-001-7 프리셋 저장 자주 쓰는 설정 최대 10개 저장
TOOL-001-8 설정 복원 마지막 설정 자동 복원 (재진입 시)

7.6 비기능 요구사항

  • 시간 정확도: 드리프트 없는 카운트다운 (performance.now() + 목표시각 비교)
  • 백그라운드 탭: 복귀 시 경과 시간 보정
  • 첫 사용자 인터랙션 후 오디오 재생 (브라우저 정책 준수)
  • 반응형 레이아웃: 모바일/데스크탑
  • 다크모드: 디자인 시스템 준수

7.7 화면

화면 경로 설명
Tools 대시보드 /tools 도구 카드 그리드
메이플 재획 타이머 /tools/timer 설정 패널 + 실행 뷰 + 프리셋

7.8 범위 외

  • BE 동기화 (v2+ 검토)
  • 알림 소리 종류 선택 (단일 비프음만)
  • 음성 카운트 ("3초 전!" 등)
  • 실행 이력 로그
  • 3단계 이상의 Timer 단계

8. 모듈 4: Planner (Google Calendar 연동)

상태: ✅ 구현 완료 (2026-06)

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 본 모듈은 §6.A.3/6.A.4의 일정·캘린더·Google 연동 백로그(SP-V5-001/003/005, SP-V6-001)를 Google 연동 방식으로 확정한 결과물이다.

8.1 목표

구글 캘린더처럼 일정을 관리하되, 실제 Google Calendar / Google Tasks와 양방향 연동하고 orino의 SM-2 복습 일정을 같은 캘린더에 함께 본다.

8.2 서비스 정의

항목 내용
서비스명 Planner
핵심 가치 일정(Google)·할 일(Google Tasks)·복습(orino)을 한 캘린더에서 조망·관리
플랫폼 Web
차별점 학습 복습 일정과 실제 구글 일정이 한 화면에 통합. 구글이 source of truth라 휴대폰 구글앱과도 동기

8.3 핵심 요소

요소 설명
일정 (Event) Google Calendar 양방향 연동. 생성/수정/삭제가 구글에 반영. 반복(RRULE)은 구글이 처리
할 일 (Task) Google Tasks 연동. 추가/완료/삭제
복습 (Review) 기존 orino SM-2 복습 스케줄. 읽기 전용 오버레이

8.4 기능 요구사항

ID 영역 기능 설명
PLN-001 연동 Google 연결/상태/해제 OAuth 2.0(offline), refresh token BE 보관, revoke
PLN-002 캘린더 통합 피드 조회 기간 내 일정+할일+복습을 한 번에. 부분 실패 허용
PLN-003 일정 일정 CRUD (양방향) Google Calendar 생성/수정/삭제 프록시
PLN-004 할 일 할 일 CRUD Google Tasks 생성/완료/삭제 프록시
PLN-005 복습 복습 오버레이 읽기 전용 표시 + 오늘 복습 화면 연결
PLN-006 뷰 월/주/일 뷰 뷰 전환 + 기간 이동
PLN-007 복습 복습 캘린더 미러링 복습을 보조 캘린더 "orino 복습"에 dueDate당 종일 묶음으로 단방향 push(폰·워치 표시+알림). 토글 on/off. 상세
PLN-008 목표 월간 목표 월 뷰 년월 제목 오른쪽에 그 달의 목표를 한 단락 자유 텍스트로 적기. 년월당 1개, orino 내부 저장. 상세

8.5 비기능 요구사항

  • 단일 사용자/저트래픽 → 라이브 프록시 + Redis 단기 캐시(미러·syncToken 없음)
  • Google API 호출은 Spring RestClient 직접(무거운 SDK 미도입)
  • 다크모드(디자인 시스템), 월 그리드는 기존 복습 캘린더 유틸 재사용

8.6 화면

화면 경로 설명
통합 캘린더 /planner/calendar 월/주/일. 일정+할일+복습 (복습 전용 캘린더를 승격)
연동 설정 /integrations Google 연결/해제

8.7 범위 외

  • 자동 스케줄링 엔진 / 리스케줄링 (SP-V5 백로그 잔여)
  • 반복 루틴/고정 일정 → 확정·이관: Routine 모듈 (§9)
  • 복습 → Google 내보내기, 여러 캘린더 색상, 드래그 이동, 알림/푸시
  • 자세한 비목표는 결정 기록 §4 참고

9. 모듈 5: Routine (반복 루틴 / 고정 일정)

상태: ✅ 구현 완료 (2026-06)

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 본 모듈은 §6.A.3 백로그 SP-V5-002(루틴 CRUD)를 Google Calendar 반복 이벤트 방식으로 확정해 Planner(§8) 위에 활성화한 결과물이다.

9.1 목표

Todomate의 루틴/고정 일정처럼, 시작일~종료일 + 반복 규칙을 지정하면 일정이 자동으로 반복 생성된다. 체크형 습관(날짜별 완료 체크)과 시간 고정 일정을 한 개념으로 다룬다.

9.2 서비스 정의

항목 내용
서비스명 Routine
핵심 가치 반복 규칙 한 번 지정 → 매일/요일/매월/N일로 자동 생성. 습관은 날짜별 체크
플랫폼 Web (Planner 통합 캘린더 확장)
차별점 루틴 = Google Calendar 반복 이벤트라 휴대폰 구글앱·알림과 동기. 습관 체크만 orino가 오버레이

9.3 핵심 요소

요소 설명
체크형 습관 (habit) 시간 없이 "그날 할 일"로 반복. 종일 이벤트 + 날짜별 완료 체크(orino 저장)
시간 고정 일정 (schedule) 시간이 박힌 반복 일정. 시간 블록 이벤트. 체크 없음
반복 규칙 매일 / 주간(요일) / 매월(특정일) / N일 간격. 시작일~종료일(또는 무기한)
완료 체크 오버레이 routine_check 테이블. 습관의 날짜별 완료만 저장(Google엔 완료 개념 없음)

9.4 기능 요구사항

ID 영역 기능 설명
RTN-001 생성 루틴 생성 종류·반복 규칙·기간 → Google 반복 이벤트(RRULE+태그) 생성
RTN-002 조회 캘린더 표시 통합 피드에 루틴 인스턴스 펼침 + habit 완료 상태 주석
RTN-003 조회 루틴 관리 목록 살아있는 루틴 시리즈 목록(종류·반복 요약)
RTN-004 체크 습관 완료 토글 날짜별 완료 체크/해제 (routine_check)
RTN-005 편집 시리즈 수정 전체 / 이후 모두 / 이 날짜만
RTN-006 삭제 시리즈 삭제 전체 / 이후 모두 / 이 날짜만

9.5 비기능 요구사항

  • Planner BFF·라이브 프록시·OAuth·캐시를 그대로 상속 → 신규 외부 의존성·인증 모델 변경 없음
  • 유일한 신규 영속 테이블은 routine_check(습관 완료 오버레이). 이벤트/반복 미러 없음
  • RRULE은 orino가 직접 작성(UNTIL은 UTC). 시간대는 X-Timezone 기준
  • 다크모드·반응형(디자인 시스템), 공유 프리미티브·상태 컴포넌트 재사용

9.6 화면

화면 경로 설명
통합 캘린더(확장) /planner/calendar 루틴 인스턴스 표시 + 습관 체크 + [+ 루틴]
루틴 관리 /planner/routines 루틴 시리즈 목록·수정·삭제

9.7 범위 외

  • 루틴 알림/푸시, 스트릭·히트맵·통계(SP-V6-005/006)
  • 자동 스케줄링 엔진(SP-V5-004)
  • BYSETPOS("마지막 주 금요일") 등 고급 RRULE, 루틴별 색상(카테고리 모듈과 함께)
  • 자세한 비목표·결정은 Routine 결정 기록

10. 모듈 6: 주간 계획표 (Weekly Plan, 구 Day Plan)

상태: ✅ 구현 완료 (2026-06, WP0 #633 · WP1 #636)

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 옛 "반복 하루 템플릿 + 캘린더 배경 + Google 차임 미러" 설계는 2026-06-27 축소 재설계(WP)로 폐기됐다.

10.1 목표

일~토 한 주를 시간 블록으로 그리는 독립 페이지 한 장. "내가 어떻게 살지"의 모양을 요일별로 배치하는 정적 시각 템플릿이다. 캘린더 연동·알림·반복 펼침이 없고, 멤버당 단일 주간 템플릿으로 orino 내부에만 존재한다.

10.2 화면

화면 경로 설명
주간 계획표 /planner/plan 일~토 × 시간축 그리드. [+ 추가] 버튼으로 요일·시간 블록 생성, 자동 저장, 다중 선택 삭제

10.3 범위 외

  • Google Calendar 연동·차임 미러·알림 (축소 재설계로 폐기)
  • 여러 주간 템플릿, 주차별 인스턴스, 반복 펼침
  • 자세한 결정은 Day Plan 결정 기록

11. 모듈 7: 메모 (Memo, 독립 메모장)

⚠️ [통합됨] 2026-07-06 — 메모는 노트와 단일 도메인으로 병합되었습니다 (#740, PR #741). note.material_id를 nullable로 완화해 자료 종속 노트(material_id 있음)와 독립 노트(NULL)를 한 테이블/도메인으로 통합했다. API /api/notes, 라우트 /notes, 사이드바 "노트". 아래 설계 문서는 분리 시절(Epic #718)의 기록이다.

상태: 폐기 — 노트로 흡수됨 (2026-07-06, #740). 별도 memo 테이블·API·라우트는 존재하지 않는다. 독립 메모는 material_id가 NULL인 노트이고, 진입은 /notes다.

아래는 분리 시절(Epic #718)의 기록이다. 현행 노트 설계는 Study Planner 문서를 본다. 보존된 설계 문서: 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록

11.1 목표

학습 자료(Study Material)와 무관하게 아무 때나 자유롭게 적는 독립 메모장. Study Planner의 노트가 "특정 학습 자료에 대한 필기"라면, 메모는 자료가 없어도 존재하는 범용 캡처 공간이다.

11.2 서비스 정의

항목 내용
서비스명 Memo
핵심 가치 자료에 얽매이지 않는 최상위 메모를 Notion 스타일 트리로 정리
플랫폼 Web
차별점 노트의 Tiptap 에디터 엔진(트리·자동저장·이미지)을 재활용하되, material_id 종속이 없는 독립 도메인

11.3 노트(Note)와의 관계

구분 노트 (Study Planner) 메모 (Memo)
소속 학습 자료(material)에 종속 (material_id NOT NULL) 종속 없음 (최상위)
진입 자료 상세 → [노트] 탭 사이드바 → [메모] 독립 페이지
용도 특정 자료 학습 정리 잡생각·아이디어·할일·범용 기록
저장소 note 테이블 memo 테이블 (신규, 별도)
공유 Tiptap 에디터 엔진·자동 저장 로직 재활용 동일

결정: 노트의 material_id를 nullable로 완화해 겸용하지 않고 별도 memo 테이블·API·라우트로 분리한다. 근거는 결정 기록 참고.

11.4 기능 요구사항

ID 영역 기능 설명
MEMO-001 트리 메모 트리 조회 멤버의 최상위 메모 + 하위 메모 트리 조회
MEMO-002 메모 메모 생성 최상위/하위(parentId) 메모 생성. 빈 doc·기본 제목으로 시작
MEMO-003 메모 단건 조회 메모 본문(Tiptap JSON) 조회
MEMO-004 메모 본문/제목 저장 자동 저장(2초 debounce), PATCH idempotent
MEMO-005 메모 삭제 메모 삭제. 하위 메모 CASCADE 삭제
MEMO-006 트리 이동·정렬 부모 변경(parentId)·형제 정렬(sortOrder)

11.5 비기능 요구사항

  • 단일 사용자·저트래픽 → 인덱스 + 일반 RDB 조회로 충분. 본문 저장 300ms 이내
  • Tiptap content는 MySQL JSON. 이미지는 노트와 동일한 업로드 파이프라인 재사용
  • 다크모드·반응형(디자인 시스템), 노트 에디터 컴포넌트 공유

11.6 화면

화면 경로 설명
메모 /memo 좌: 메모 트리 사이드바([+ 새 메모]·하위 추가·삭제), 우: Tiptap 에디터 + 저장 상태. 빈 상태 안내

11.7 범위 외 (v1)

  • 인라인 하위 페이지(/페이지 childPage 블록) — v1은 트리 사이드바로만 하위 생성. 인라인은 차기(노트 childPage 엔진 일반화 후)
  • 메모 검색, 즐겨찾기/아이콘/커버, 태그
  • 메모 ↔ 노트/카드 상호 변환, 자료로 승격
  • 공유·협업, 첨부파일(이미지 외)
  • 알림/리마인더 (메모에 due 개념 없음)

12. 모듈 8: 일상기록 (Lifelog)

상태: 구현 완료 (2026-07-24) — Epic #949. LOG-001007 전 항목이 #950#958로 완료됐다.

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다.

12.1 목표

지금 순간을 계속 기록(일기+인스타)하고, 흩어진 기록을 **하나의 흐름(예: 제주 여행)**으로 엮어 다시 읽는다. 노트/메모가 "주제별 트리 문서"라면, 일상기록은 "언제 무엇을 겪었나"의 시간 피드 + 사후 서사화다.

12.2 서비스 정의

  • Moment(기록): 사진(다중)·본문·발생시각·위치·기분·태그를 담는 리치 카드. 순간 하나.
  • Flow(흐름): 사용자가 수동으로 만든 기록 컬렉션. 담긴 기록을 시간순 서사·지도로 본다. 기록 ↔ 흐름은 N:M.
  • 노트/메모 트리·에디터를 재사용하지 않는 완전 독립 도메인. 재사용은 노트 이미지 업로드 파이프라인(presigned → MinIO)뿐.

12.3 핵심 기능 요구사항

ID 기능 설명
LOG-001 순간 기록 사진(다중)+본문+발생시각+위치+기분+태그 작성. 사진 없는 텍스트 기록도 허용
LOG-002 피드 역시간순 무한 스크롤. 태그·기간 필터
LOG-003 사진 MinIO presigned 업로드(FE 직접). FE에서 EXIF 추출·썸네일 생성
LOG-004 위치 EXIF GPS 자동 추출 또는 지도 수동 핀. 역/정 지오코딩(Nominatim+캐시)
LOG-005 흐름 수동 생성·기록 담기/빼기·순서 조정. N:M
LOG-006 흐름 타임라인 담긴 기록을 날짜·시간순 서사로
LOG-007 흐름 지도 기록을 지도 핀 + 시간순 경로(react-leaflet + OSM)

12.4 핵심 결정

  • 흐름 묶기 = 수동 컬렉션(자동 클러스터링은 후속). 예측가능성 우선.
  • 사진 = self-hosted MinIO — ELOG-008의 S3 요청료는 AWS S3 이야기이고, 클러스터 내부 MinIO는 요청 과금이 없어 사진 많은 모듈일수록 안전.
  • 지도/지오코딩 = 공개 OSM/Nominatim + BE 캐시(키·과금 없음). 셀프호스트는 후속.
  • 상세 근거는 결정 기록.

12.5 범위 외 (MVP)

  • 자동 흐름 제안, 지도/지오코딩 셀프호스트, 영상·오디오 첨부, 본문 풀텍스트 검색, 공유/공개 링크(단일 사용자 원칙)

13. 모듈 9: 여행 (Travel)

상태: 기획 완료 (2026-08-07) — 마감이 박힌 첫 모듈. 기능 동결 10/13, 실사용 10/24.

제품 결정 정본은 Orino Travel 확정 명세 v2.0이다. 조항 번호(§1.9·§4.2·§4.7·§5 …)를 디자인 핸드오프가 직접 인용하므로 원문을 별도 페이지로 보존한다. 이 절은 요약이다.

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다.

13.1 목표

2026-10-24 일본 여행에서 실제로 쓴다. 여행 계획이 노션·메모·구글 지도 즐겨찾기·캘린더에 흩어져 현지에서 매번 "다음 어디였지"를 재구성하는 문제를 없앤다. 일정 보드 하나가 여행의 유일한 진실이고, 데이터가 끊겨도·알림이 와도·길을 찾아야 해도 그 화면에서 출발한다.

플랫폼은 PWA / Android Chrome, 사용자는 1인. iOS는 범위 외다.

13.2 서비스 정의

  • 여행(Trip): 목적지·기간·타임존·통화. 상태(예정/진행 중/완료)는 저장하지 않고 여행 타임존의 오늘 날짜로 파생한다.
  • 일정(Activity): 제목 + 선택적 시각·장소. 종료 시각·소요시간 없음, 시각 없는 일정 허용. 날짜가 없으면 미배정 보관함 소속.
  • 일정 보드: 날짜 탭 + 일정 리스트 + 사이사이 이동시간. 주 화면이자 이 모듈의 전부.
  • 일상 워크스페이스(학습·기록·플래너)와 병렬 워크스페이스로 분리된다. 로그인 → /select → 여행/일상.

13.3 핵심 기능 요구사항

ID 기능 설명 단계
TRV-001 워크스페이스 분리 /select + 사이드바 스위처. 일상 범위는 변경 없음 1
TRV-002 여행 CRUD 기간 단축 시 잘리는 일정은 보관함으로 이동(삭제 아님) 1
TRV-003 일정 CRUD + 보관함 시각 없는 일정 허용. 날짜 미배정 = 보관함 1
TRV-004 드래그 정렬 롱프레스 → 순서 변경 / 날짜 탭으로 이동 1
TRV-005 장소 검색·담기 Google Places. 이전 여행 평점 4↑ 장소에 ⭐ 좋았던 곳 2
TRV-006 지도 뷰 선택 날짜의 장소를 직선 연결(react-leaflet + OSM) 2
TRV-007 이동시간 직선거리 1.5km 이하 도보/초과 자동차. 딥링크는 항상 대중교통 2
TRV-008 타임존 일정 시각은 여행 타임존 벽시계 시각으로 저장 3
TRV-009 알림 웹푸시(VAPID). 일정 알림 + 출발 알림 + 아침 요약 3
TRV-010 오프라인 조회 Service Worker 캐시. 편집 불가·큐잉 없음 4
TRV-011 도구 환율(ECB) · 날씨(Open-Meteo) · 번역 딥링크 4
TRV-012 기록 평점·메모·사진(최대 10장, MinIO). 여행 시작일 이후에만 4
TRV-013 준비 (v2.2) 네 분류(서류·예약·짐·할 일) 체크리스트. 기한은 D−N, 출발 전날 09:00 알림 하나 v2.2-1
TRV-014 경비 (v2.2 → 독립 2026-09-20) 여행 전용 장부(trip_expense). 여행 단위 예산 하나. 가계부 폐기로 원장 위의 읽기 뷰에서 자급자족 기능으로 바뀌었다 → Travel-Expense-Standalone v2.2-2

13.4 핵심 결정

  • 일정 시각 = 벽시계 시각 저장(DATE + TIME). Instant로 저장하면 타임존 변경 시 전 일정이 밀린다. 알림 발송 시각만 UTC로 별도 저장.
  • 여행 상태·D-day·일차는 파생값. 저장하면 날짜가 넘어갈 때 갱신할 주체가 없다.
  • 오프라인은 조회 전용. 편집 큐잉을 하지 않으므로 충돌 해소 로직이 아예 없다.
  • 실행취소는 FE 지연 발송(소프트 삭제 API 없음).
  • 이동시간은 보드 응답에 포함해 내려준다. 오프라인에서 캐시 하나로 성립하고, 유료 API 호출이 서버 한 곳에서만 일어난다.
  • (v2.2) 경비는 여행이 갖는 데이터가 아니다. → 폐기 (2026-09-20). 가계부를 지우므로 읽을 원장이 없다. 경비는 trip_expense로 독립하고 FK는 ON DELETE CASCADE다 — 여행이 없으면 그 지출도 뜻이 없다 (D-43 · Travel-Expense-Standalone).
  • (v2.2) 준비 기한은 절대 날짜를 저장하지 않는다. 출발일이 바뀌면 날짜로 적은 기한은 조용히 틀린다.
  • 상세 근거는 결정 기록.

13.5 신규 인프라

이 모듈은 orino에 없던 인프라 3종을 세운다 — Service Worker(PWA), 웹푸시(VAPID + 발송 스케줄러), 유료 외부 API(Google Places/Routes). 나머지는 기존 자산 재사용(MinIO 사진 파이프라인, react-leaflet 지도, 앱 셸, 디자인 시스템).

13.6 범위 외

시각 충돌 경고 · 일정 유형 필드 · 지도 롱프레스 추가 · 사진 위치정보 기반 장소 제안 · 오프라인 편집 · 여행 복제 · 커버 이미지 · 앱 내 대중교통 경로 계산 · 앱 내 번역 · 오프라인 지도 · 동행자 공유 · iOS

(v2.2 추가) 영수증 사진·자동 인식 · 더치페이·정산 · 도시별 예산 · 여행 전용 통계 화면 · 일정에 금액 붙이기 · 예산 초과 알림 · 준비 템플릿·지난 여행에서 가져오기 · 준비물 자동 추천 · 무게/수하물 계산 · 준비 항목 → 일정 변환


14. 모듈 10: 단축 URL (링크, Shortlink)

확정 명세는 Shortlink-Spec이 정본이다(§ 번호 인용은 그쪽을 가리킨다). 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록

14.1 목표

한 번 뿌린 주소를 죽지 않게 만든다.

주소를 짧게 만드는 것은 수단이고, 목적은 목적지를 나중에 갈아끼울 수 있게 하는 것이다. orino가 이미 뿌리는 링크는 대부분 수명이 있다 — MinIO presigned URL은 서명이 만료되고, 드라이브 공유 링크는 정리하면 끊긴다. 부모님께 보낸 사진 링크가 2주 뒤에 죽으면 다시 보내는 수밖에 없고, 이미 보낸 메시지는 되돌릴 수 없다.

짧은 주소를 한 겹 씌워 두면 그 주소는 영구히 고정하고 뒤의 목적지만 교체할 수 있다. 이미 뿌린 링크가 전부 살아난다.

부차 목표 둘: 붙여넣고 3초 안에 발급(§4), 그리고 그 링크가 실제로 쓰였는지 확인(§8).

14.2 서비스 정의

s.orino.dev/{5자} — 최종 17자 고정의 짧은 주소를 발급하고, 목록·QR·방문 통계를 관리하는 세 번째 워크스페이스.

  • 일상 워크스페이스의 하위 메뉴가 아니다. 로그인 → /select가 여행 · 일상 · 링크 3카드가 되고, 사이드바 최상단 전환도 3분할이 된다(SL-020)
  • 관리 화면(/links)은 인증이 필요하고, 리다이렉트(s.orino.dev/{slug})는 인증이 없다. orino에서 로그인 없이 열리는 첫 번째 기능 표면이다
  • 사용자 1인. 링크를 받는 사람은 여럿(가족·동행·동호회)이지만 만드는 사람은 하나다

14.3 기능 요구사항

ID 기능 상세 우선순위
SL-001 짧은 주소 발급 목적지 URL → s.orino.dev/{slug}. 슬러그 자동 5자 1
SL-002 빠른 발급 목록 맨 위 상주 입력창. 붙여넣고 Enter → 발급 → 클립보드 자동 복사. 기본 발급 경로다 1
SL-003 커스텀 슬러그 선택. 비우면 자동 5자. 중복 시 발급 거부 2
SL-004 목적지 검증 http/https/mailto/tel만. 목적지가 s.orino.dev면 거부(루프 방지) 1
SL-005 OG 프리뷰 목적지의 제목·썸네일을 보여준다. 비동기이고, 실패해도 발급을 막지 않는다 3
SL-006 메모 · 태그 자유 메모 + 태그 0..N. 태그는 사이드바 필터가 된다 2
SL-007 만료 선택. 만료 후 접근은 SL-021과 구분 없이 실패 2
SL-008 목적지 교체 + 이력 이 모듈의 핵심. 주소는 그대로 두고 목적지만 교체. 교체마다 이력(URL·시각·사유)을 남긴다 1
SL-009 활성 / 비활성 끄면 접근 실패. 되살릴 수 있다 2
SL-010 삭제 소프트 삭제. 슬러그는 영구 점유되어 재발급되지 않는다 1
SL-011 즐겨찾기 목록 상단 별도 섹션 3
SL-012 검색 · 필터 슬러그·목적지·메모 검색 + 상태 칩(전체/활성/꺼짐·만료) + 태그 2
SL-013 리다이렉트 302 + Cache-Control: no-store, 인증 없음, 쿼리스트링 전달(§6.3) 1
SL-014 비밀번호 보호 선택, 기본 꺼짐. 켜면 확인 화면을 한 번 거친다. §7의 예외 조항을 함께 읽어야 한다 3
SL-015 방문 통계 총 방문 · 최근 7일 · 마지막 방문 · 최근 30일 일별 막대 2
SL-016 유입 경로 리퍼러를 도메인 수준까지만 기록 3
SL-017 봇 · 프리뷰 분리 메신저 프리뷰·크롤러는 따로 센다. 화면에 "참고치"임을 밝힌다 2
SL-018 QR 상세·발급 직후에 표시 + PNG 저장 2
SL-019 기기 · 국가 모바일/데스크탑 비율 + 국가 코드. IP는 저장하지 않는다 3
SL-020 진입 — 세 번째 워크스페이스 /select 3카드 + 사이드바 3분할. 일상 사이드바에는 링크를 넣지 않는다 1
SL-021 실패 화면 없음·꺼짐·만료·삭제를 구분하지 않는다. 문구 하나, HTTP 404 하나 1
SL-022 통계 보존 원시 방문 90일 → 이후 일별 집계만 영구 보존 2

14.4 핵심 결정

  • 최종 17자 고정. s.orino.dev(11) + /(1) + 슬러그 5 = 17. 경로 세그먼트(/s/, /l/) 추가·접두어·슬러그 확장 금지. 카카오톡 한 줄에 들어가고 입으로 부를 수 있는 길이가 이 모듈의 존재 이유 중 하나다
  • 슬러그는 영구 점유. 삭제해도 행이 남아 UNIQUE 제약이 재사용을 구조적으로 막는다. 지운 링크의 주소를 다른 목적지에 다시 붙이면, 예전에 그 주소를 받은 사람이 엉뚱한 곳으로 간다
  • 실패는 404 하나. 상태를 구분해 알려주는 순간 슬러그 열거로 "존재하는 주소" 목록을 만들 수 있다. 410도 쓰지 않는다(410은 "있었다"를 알려준다)
  • 리다이렉트는 관리 화면과 독립. SPA 라우터가 아니라 서버가 서빙한다. /links가 깨져도 이미 뿌린 링크는 살아 있어야 한다
  • 통계 실패가 리다이렉트를 막지 않는다. 방문 기록은 비동기이며, 실패해도 302는 나간다
  • IP를 저장하지 않는다. 국가 판정에만 쓰고 버린다. 원시 방문 기록에 IP 컬럼 자체를 두지 않는다
  • 상세 근거는 결정 기록.

14.5 신규 표면 · 신규 의존성

신규 내용
공개 표면 s.orino.dev — orino 최초의 비인증 기능 표면. 보안 위협 모델 §2.5·§3.5에 반영
GeoIP MaxMind GeoLite2-Country. Cloudflare 제거(#456) 이후 국가를 알 수단이 인프라에 없다
QR 렌더링 FE 라이브러리(canvas → PNG). BE는 관여하지 않는다
외부 URL fetch OG 프리뷰. SSRF 방어가 전제 조건이다

재사용: 기존 BE 애플리케이션·Istio Gateway·*.orino.dev 와일드카드 인증서·앱 셸·디자인 시스템.

14.6 범위 외 (v1)

여러 사용자·팀 공유 · 링크 폴더/계층 · 대량 발급(CSV) · A/B 분기 · UTM 빌더 · 클릭 상한 · 지역·기기별 분기 · 커스텀 도메인 추가 · 링크 미리보기 페이지(interstitial) · 통계 CSV 내보내기 · iOS 전용 처리

15. 모듈 11: 가계부 (Ledger) — 폐기 (2026-09-20)

제거한다. 설계 문서 8개는 Ledger-Archive 하나로 압축했고, 제거 작업의 정본은 Ledger-Removal이다.

15.1 무엇이었나

이미 쓴 돈과 앞으로 나갈 돈을 한 화면에 놓아, "이번 달 얼마 쓰게 되고 월말에 얼마 남나"에 답한다. 자산(카드·계좌) 단위 원장 + 카드 청구 사이클 정산 + 정기 항목 자동 기록. 네 번째 워크스페이스였다.

2026-08-28 기획(Epic #1257) → v1·v1.5·v2 구현 완료 → 2026-09-13 청약·대출 확장(Epic #1395) → 2026-09-20 제거 결정.

최종 규모: BE 204파일 / 25,789줄 · FE 56파일 / 17,268줄 · 테이블 24 · 스케줄러 4 · 화면 13. 저장소에서 가장 큰 단일 모듈이었다.

15.2 왜 지우나

안 쓴다 — 손으로 적는 부담이 도구의 가치보다 컸다.

「수동 입력의 통제권은 사람이 갖고, 계산은 서비스가 한다」가 설계였다. 계산 쪽은 약속대로 됐다 — 카드 사이클·정기 항목·예정 타임라인은 손으로 셀 필요를 없앴다. 없애지 못한 것은 입력 자체다. 자동 연동(마이데이터·스크래핑·SMS 파싱)은 처음부터 의도적 비목표였으므로, 입력 부담은 설계로 줄일 수 있는 것이 아니라 이 모듈의 정의에 붙어 있는 것이었다.

완료 판정 1번 「한 달간 실제로 썼다」가 통과하지 않았다. 계산에 관한 나머지 항목이 전부 통과해도 그 하나가 나머지를 무의미하게 만든다. 1번을 1번으로 적어두고도 v1.5·v2·청약대출을 계속 쌓은 것이 이 모듈에서 가장 값비싼 판단이다.

15.3 여행 경비는 살린다

가계부 원장 위에 얹혀 있던 경비(TRV-014)를 여행 전용 장부로 독립시킨 뒤에 지운다. 이관이 끝나기 전에 ledger_transaction을 지우면 여행 지출 기록이 같이 사라지므로, 순서가 안전의 전부다 → Travel-Expense-Standalone

15.4 제거 단계

단계 내용 되돌림
0 여행 경비 독립 — trip_expense 신설·이관·API 이전 가능(이관은 복사)
1 FE — 화면 13개·라우트·진입 동선 제거 revert 한 번
2 BE — API·스케줄러 4·LDG-ERR-* 41·Istio 라우트 제거 revert 한 번
3 DB 테이블 24개 DROP · MinIO ledger/receipts/** 삭제 불가

데이터는 전부 지운다. 덤프를 떠서 보관하지 않는다 — 안 쓰기로 한 도구에 적다 만 기록이고, 남기면 백업·용량·복원 절차에 계속 실린다.

15.5 남는 자리

/select가 3카드로, 사이드바 워크스페이스 스위처가 세그먼트로 돌아간다. 앱의 주기 작업이 7개 → 3개가 되고, MinIO를 훑는 애플리케이션 루프가 사라진다(Periodic-Loops).

Clone this wiki locally