Skip to content
wcorn edited this page Jul 5, 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 메모 (Memo, 독립 메모장) 기획 진행 중
8 Tools 보류 (장기 백로그)

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)]
                       ↓
   매일: [오늘 복습 화면]
            앞면 표시 → [Space] → 뒷면 공개 → [Again/Hard/Good/Easy]
                       ↓
              [SM-2로 다음 복습 1건 생성]
                       ↺

6.5 복습 알고리즘: SM-2 (v1과 동일)

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

평가 SM-2 q 의미
AGAIN 0 다시 (실패)
HARD 3 어려움
GOOD 4 보통
EASY 5 쉬움

다음 간격 계산:

if q < 3 (AGAIN):
    interval = 1, ease = max(prev_ease - 0.20, 1.30)
else:
    if sequence == 1: interval = 1
    elif sequence == 2: interval = 6
    else: interval = round(prev_interval × prev_ease)
    ease' = prev_ease + (0.1 - (5-q)·(0.08 + (5-q)·0.02))
    ease  = max(ease', 1.30)

놓친 복습: 별도 OVERDUE 상태 없음. scheduled_at <= now AND status = PENDING을 동적으로 "오늘 복습"으로 표시. 뒤늦게 완료해도 다음 복습은 today + 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는 차기 모듈
  • 다크모드 (디자인 시스템 준수)
  • 카드 복습 화면 키보드 단축키: Space (답 공개) → 1/2/3/4 (평가)

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 월/주/일. 일정+할일+복습 (복습 전용 캘린더를 승격)
연동 설정 /planner/settings 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, 독립 메모장)

상태: 기획 진행 중

상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · 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 개념 없음)

Clone this wiki locally