Repository navigation
PRD
orino는 개인용 서비스 플랫폼이다. 단일 사용자(본인)만 사용하며, 다양한 기능 모듈을 점진적으로 추가해 평생 운영한다.
- 단일 사용자: 본인만 사용한다. 회원가입 기능은 없다.
- 모듈형 확장: 독립적인 기능 모듈을 하나씩 추가한다.
- 장기 운영: 유지보수 부담을 최소화하고, 안정적으로 오래 쓸 수 있는 구조를 지향한다.
| 구분 | 내용 |
|---|---|
| 사용자 수 | 1명 (본인) |
| 회원가입 | 없음 |
| 계정 관리 | 사전 등록된 계정으로 로그인 |
| 순서 | 모듈 | 상태 |
|---|---|---|
| 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 | 보류 (장기 백로그) |
사전 등록된 계정으로 로그인하여 플랫폼의 모든 기능에 접근할 수 있다.
| ID | 기능 | 설명 |
|---|---|---|
| AUTH-001 | 로그인 | 아이디/비밀번호로 로그인 |
| AUTH-002 | 로그아웃 | 세션/토큰 무효화 |
| AUTH-003 | 인증 유지 | 로그인 상태를 일정 기간 유지 |
| AUTH-004 | 인증 보호 | 미인증 요청은 로그인 페이지로 리다이렉트 |
| 항목 | 값 |
|---|---|
| 로그인 방식 | 아이디 / 비밀번호 |
| 인증 토큰 | JWT (Access Token + Refresh Token) |
| Access Token 만료 | 30분 |
| Refresh Token 만료 | 14일 |
| Refresh Token 저장 | Redis |
| 계정 초기 등록 | 초기 세팅 스크립트로 DB에 삽입 |
- 비밀번호는 BCrypt 암호화 저장
- Access Token 만료 시 Refresh Token으로 자동 갱신
- Refresh Token 만료 시 재로그인
- 로그인 실패 시 명확한 에러 메시지
| 화면 | 설명 |
|---|---|
| 로그인 페이지 | 아이디/비밀번호 입력 폼, 로그인 버튼 |
| 메인 페이지 | 로그인 성공 후 랜딩 (추후 대시보드로 확장) |
- 회원가입
- 소셜 로그인
- 비밀번호 찾기/변경 (추후 모듈로 검토)
- 다중 사용자 / 권한 관리
v2 범위 정의: 학습 자료마다 Notion 스타일 노트(Tiptap 블록 에디터, 본문
/페이지로 하위 노트를 인라인으로 무제한 중첩)를 작성하고, 그 자료에서 만든 Anki 스타일 플래시카드(앞/뒷면)를 SM-2 알고리즘으로 복습한다. 노트와 카드는 같은 자료 안에서 분리된 두 트랙으로 동작한다. (노트: v2.1 단건→트리, v2.2 인라인 하위 페이지로 발전)v1과의 차이: v1은 "학습 단위(챕터)" 자체를 복습 대상으로 삼았다. 단위 안에 학습 콘텐츠가 없어 "뭘 복습해야 할지"가 외부 자료에 있었고, 셀프 테스트 흐름이 없었다. v2는 노트로 학습 콘텐츠를 서비스 안에 담고, 카드로 셀프 테스트와 SM-2 복습을 한다.
v1 자산(
study_unit,review_schedule의 단위 FK)은 전면 롤백 후 v2 스키마로 재구축한다.
학습한 내용을 한 곳에 정리하고(노트), 핵심을 카드로 추출해 망각곡선에 맞춰 복습(SM-2)한다.
| 항목 | 내용 |
|---|---|
| 서비스명 | Study Planner v2 |
| 핵심 가치 | Notion 같은 학습 노트 + Anki 같은 SM-2 복습이 한 자료에 묶여있음 |
| 플랫폼 | Web |
| 차별점 | 다른 서비스는 "노트(Notion)와 카드(Anki)가 분리". orino는 자료 단위로 둘이 묶여 학습 → 카드 추출 → 복습이 한 흐름 |
| 요소 | 설명 |
|---|---|
| 학습 자료 (Study Material) | 책/강의/문제집/MOOC 단위. 노트 트리와 카드 N개를 묶는 그릇 |
| 학습 노트 (Note) | 자료 1:N 트리 (Notion 인라인 하위 페이지, 무제한 중첩). 본문 /페이지로 하위 노트 생성, Tiptap JSON. 학습한 내용을 중첩 정리 |
| 플래시카드 (Flashcard) | 자료 1:N, 앞/뒷면. 카드별 SM-2 상태로 복습 일정 자동 관리 |
[자료 등록] ─┬─→ [노트 작성] (본문 /페이지로 하위 노트 인라인, 자동 저장)
│
└─→ [카드 추가 (앞/뒤)]
↓
[첫 복습 1건 자동 생성 (1일 후, ease 2.50)]
↓
매일: [오늘 복습 화면]
앞면 표시 → [Space] → 뒷면 공개 → [Again/Hard/Good/Easy]
↓
[SM-2로 다음 복습 1건 생성]
↺
평가 입력: 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로 잡는다.
| 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 | 복습 | 복습 캘린더 | 월간 달력(투두메이트 스타일)에 예정+완료 복습을 상태별 색으로 표시. 날짜 클릭 시 그날 목록. 보기 전용 |
- 단일 사용자, 단순한 트래픽이므로 인덱스 + 일반 RDB 조회로 충분
- API 응답 시간: 단순 CRUD/조회 200ms 이내. 노트 저장은 300ms 이내
- Tiptap content는 JSON 형식 (MySQL
JSON또는LONGTEXT) - 모바일/데스크탑 반응형 (브라우저 기본). PWA는 차기 모듈
- 다크모드 (디자인 시스템 준수)
- 카드 복습 화면 키보드 단축키:
Space(답 공개) →1/2/3/4(평가)
| 화면 | 경로 | 설명 |
|---|---|---|
| 메인 (홈) | /home |
오늘 복습 카드 + 학습 자료 카드 |
| 학습 자료 목록 | /planner/materials |
자료 카드, 카드 수 + 오늘 복습 수 표시 |
| 학습 자료 상세 | /planner/materials/:id |
[노트] (사이드바 트리 + 인라인 하위 페이지 에디터) / [카드] 두 탭 |
| 오늘 복습 | /planner/reviews/today |
카드 단위 4지선다 평가 |
| 복습 캘린더 | /planner/calendar |
월간 달력(투두메이트 스타일), 예정+완료 복습 |
다음 항목은 v2에 포함하지 않는다. §6.A 참조.
- 카테고리, 목표/마일스톤
- 고정 일정, 루틴, 할 일, 자동 스케줄링
- 캘린더 시간블록 뷰
- 카드 태그/덱 (현재는 자료가 곧 덱)
- 카드 일괄 입력 (CSV, Anki 임포트)
- 노트 내 인라인 카드 블록 (현재 분리 모델)
- 노트 즐겨찾기/아이콘/커버, 노트 검색 (v2.2는 트리 + 제목 + 인라인 하위 페이지까지)
- 노트 이동(부모 변경), childPage 블록 복붙 — 차기
- 노트 협업/공유, 노트 첨부파일
- 카드 멀티미디어 (이미지/오디오)
- OCR/URL 학습 자료 입력
- 알림/푸시, Google Calendar 연동
- 스트릭, 히트맵, 통계
- 다중 사용자, 공유
v1 출시 직후 사용 데이터가 적음. 점진 마이그레이션 대신 전면 롤백 후 재구축 방식:
- v1 BE 도메인(
planner/material,planner/review) 및 컨트롤러/서비스 제거 - v1 FE 라우트(
/planner/materials,/planner/reviews/today) 및 컴포넌트 제거 - v1 DB 마이그레이션(
study_unit,review_schedule의 v1 구조) 롤백 - v2 신규 마이그레이션으로
study_material재정의,note,flashcard,review_schedule(카드 FK) 신규 생성
별도 롤백 이슈로 트래킹.
v2 운영 후 점진적으로 확장한다. 각 단계는 독립 모듈로 출시 가능.
| ID | 기능 |
|---|---|
| SP-V3-001 | 카테고리 CRUD (색상/아이콘) |
| SP-V3-002 | 목표 CRUD (1년/6개월/3개월, 마일스톤) |
| SP-V3-003 | 학습 자료를 카테고리·목표에 연결 |
| SP-V3-004 | 카테고리별 시간 통계 |
| ID | 기능 |
|---|---|
| SP-V4-001 | 노트 내 인라인 card 블록 (Tiptap 커스텀 노드) |
| SP-V4-002 | 카드 태그/덱 |
| SP-V4-003 | 카드 멀티미디어 (이미지/오디오) |
| SP-V4-004 | 카드 일괄 입력 (CSV, Anki .apkg 임포트) |
| SP-V4-005 | 카드 클로즈(빈칸) 타입 |
업데이트(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) 도입 |
| 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 | 일일 회고 |
| 항목 | 내용 |
|---|---|
| 트리거 | 누적 리뷰 1,000건 이상 (단일 사용자 약 6~12개월) |
| 방식 | FSRS Optimizer (Python)로 사용자별 파라미터 학습 → BE 알고리즘 교체 |
| 데이터 호환성 | v2 시점부터 rating (4단계) / interval_days / elapsed_days 컬럼을 보존 → 그대로 트레이닝 입력 |
- 오프라인 지원
- 다중 사용자 / 공유
- 네이티브 앱 (iOS/Android)
- AI 기반 학습 추천
- 소셜 기능 (친구, 랭킹)
- 학습 콘텐츠 자체 제공 (뷰어, 플레이어)
상태: 보류 (Study Planner v2 검증 이후 재개 검토)
기획 문서는 Tools-Module, Tools-Timer, Tools-Open-Items에 보존되어 있다. 진입 시점/우선순위는 v1 검증 결과에 따라 재산정.
독립적인 미니 도구를 모아놓은 유틸리티 모듈. 학습·게임·업무 보조용 간단한 도구를 한 곳에서 제공하며, 기능 추가가 지속적으로 이루어진다.
| 항목 | 내용 |
|---|---|
| 서비스명 | Tools |
| 핵심 가치 | 독립적인 미니 도구 모음, 지속 확장 |
| 플랫폼 | Web (FE only, LocalStorage 기반) |
| 특성 | 각 도구는 완전 독립, 단일 목적, 한 화면 완결 |
- 독립성: 각 도구는 완전히 독립. 도구 간 데이터 공유 없음
- 간결성: 각 도구는 단일 목적, 한 화면에서 완결
- 확장성: 라우트·컴포넌트·레지스트리 등록만으로 신규 도구 추가
-
FE only (현재): 설정은 LocalStorage에만 저장. BE API 없음
- 추후 필요 시 BE 동기화 도입 가능
| ID | 도구 | 설명 | 상태 |
|---|---|---|---|
| TOOL-001 | 메이플 재획 타이머 | 2단계 주기 알림 타이머 (버프 쿨타임 관리) | 기획 완료 |
| 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 | 설정 복원 | 마지막 설정 자동 복원 (재진입 시) |
-
시간 정확도: 드리프트 없는 카운트다운 (
performance.now()+ 목표시각 비교) - 백그라운드 탭: 복귀 시 경과 시간 보정
- 첫 사용자 인터랙션 후 오디오 재생 (브라우저 정책 준수)
- 반응형 레이아웃: 모바일/데스크탑
- 다크모드: 디자인 시스템 준수
| 화면 | 경로 | 설명 |
|---|---|---|
| Tools 대시보드 | /tools |
도구 카드 그리드 |
| 메이플 재획 타이머 | /tools/timer |
설정 패널 + 실행 뷰 + 프리셋 |
- BE 동기화 (v2+ 검토)
- 알림 소리 종류 선택 (단일 비프음만)
- 음성 카운트 ("3초 전!" 등)
- 실행 이력 로그
- 3단계 이상의 Timer 단계
상태: ✅ 구현 완료 (2026-06)
상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 본 모듈은 §6.A.3/6.A.4의 일정·캘린더·Google 연동 백로그(SP-V5-001/003/005, SP-V6-001)를 Google 연동 방식으로 확정한 결과물이다.
구글 캘린더처럼 일정을 관리하되, 실제 Google Calendar / Google Tasks와 양방향 연동하고 orino의 SM-2 복습 일정을 같은 캘린더에 함께 본다.
| 항목 | 내용 |
|---|---|
| 서비스명 | Planner |
| 핵심 가치 | 일정(Google)·할 일(Google Tasks)·복습(orino)을 한 캘린더에서 조망·관리 |
| 플랫폼 | Web |
| 차별점 | 학습 복습 일정과 실제 구글 일정이 한 화면에 통합. 구글이 source of truth라 휴대폰 구글앱과도 동기 |
| 요소 | 설명 |
|---|---|
| 일정 (Event) | Google Calendar 양방향 연동. 생성/수정/삭제가 구글에 반영. 반복(RRULE)은 구글이 처리 |
| 할 일 (Task) | Google Tasks 연동. 추가/완료/삭제 |
| 복습 (Review) | 기존 orino SM-2 복습 스케줄. 읽기 전용 오버레이 |
| 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 내부 저장. 상세 |
- 단일 사용자/저트래픽 → 라이브 프록시 + Redis 단기 캐시(미러·syncToken 없음)
- Google API 호출은 Spring
RestClient직접(무거운 SDK 미도입) - 다크모드(디자인 시스템), 월 그리드는 기존 복습 캘린더 유틸 재사용
| 화면 | 경로 | 설명 |
|---|---|---|
| 통합 캘린더 | /planner/calendar |
월/주/일. 일정+할일+복습 (복습 전용 캘린더를 승격) |
| 연동 설정 | /planner/settings |
Google 연결/해제 |
- 자동 스케줄링 엔진 / 리스케줄링 (SP-V5 백로그 잔여)
- 반복 루틴/고정 일정 → 확정·이관: Routine 모듈 (§9)
- 복습 → Google 내보내기, 여러 캘린더 색상, 드래그 이동, 알림/푸시
- 자세한 비목표는 결정 기록 §4 참고
상태: ✅ 구현 완료 (2026-06)
상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 본 모듈은 §6.A.3 백로그 SP-V5-002(루틴 CRUD)를 Google Calendar 반복 이벤트 방식으로 확정해 Planner(§8) 위에 활성화한 결과물이다.
Todomate의 루틴/고정 일정처럼, 시작일~종료일 + 반복 규칙을 지정하면 일정이 자동으로 반복 생성된다. 체크형 습관(날짜별 완료 체크)과 시간 고정 일정을 한 개념으로 다룬다.
| 항목 | 내용 |
|---|---|
| 서비스명 | Routine |
| 핵심 가치 | 반복 규칙 한 번 지정 → 매일/요일/매월/N일로 자동 생성. 습관은 날짜별 체크 |
| 플랫폼 | Web (Planner 통합 캘린더 확장) |
| 차별점 | 루틴 = Google Calendar 반복 이벤트라 휴대폰 구글앱·알림과 동기. 습관 체크만 orino가 오버레이 |
| 요소 | 설명 |
|---|---|
| 체크형 습관 (habit) | 시간 없이 "그날 할 일"로 반복. 종일 이벤트 + 날짜별 완료 체크(orino 저장) |
| 시간 고정 일정 (schedule) | 시간이 박힌 반복 일정. 시간 블록 이벤트. 체크 없음 |
| 반복 규칙 | 매일 / 주간(요일) / 매월(특정일) / N일 간격. 시작일~종료일(또는 무기한) |
| 완료 체크 오버레이 |
routine_check 테이블. 습관의 날짜별 완료만 저장(Google엔 완료 개념 없음) |
| ID | 영역 | 기능 | 설명 |
|---|---|---|---|
| RTN-001 | 생성 | 루틴 생성 | 종류·반복 규칙·기간 → Google 반복 이벤트(RRULE+태그) 생성 |
| RTN-002 | 조회 | 캘린더 표시 | 통합 피드에 루틴 인스턴스 펼침 + habit 완료 상태 주석 |
| RTN-003 | 조회 | 루틴 관리 목록 | 살아있는 루틴 시리즈 목록(종류·반복 요약) |
| RTN-004 | 체크 | 습관 완료 토글 | 날짜별 완료 체크/해제 (routine_check) |
| RTN-005 | 편집 | 시리즈 수정 | 전체 / 이후 모두 / 이 날짜만 |
| RTN-006 | 삭제 | 시리즈 삭제 | 전체 / 이후 모두 / 이 날짜만 |
- Planner BFF·라이브 프록시·OAuth·캐시를 그대로 상속 → 신규 외부 의존성·인증 모델 변경 없음
- 유일한 신규 영속 테이블은
routine_check(습관 완료 오버레이). 이벤트/반복 미러 없음 - RRULE은 orino가 직접 작성(
UNTIL은 UTC). 시간대는X-Timezone기준 - 다크모드·반응형(디자인 시스템), 공유 프리미티브·상태 컴포넌트 재사용
| 화면 | 경로 | 설명 |
|---|---|---|
| 통합 캘린더(확장) | /planner/calendar |
루틴 인스턴스 표시 + 습관 체크 + [+ 루틴] |
| 루틴 관리 | /planner/routines |
루틴 시리즈 목록·수정·삭제 |
- 루틴 알림/푸시, 스트릭·히트맵·통계(SP-V6-005/006)
- 자동 스케줄링 엔진(SP-V5-004)
- BYSETPOS("마지막 주 금요일") 등 고급 RRULE, 루틴별 색상(카테고리 모듈과 함께)
- 자세한 비목표·결정은 Routine 결정 기록
상태: ✅ 구현 완료 (2026-06, WP0 #633 · WP1 #636)
상세 설계는 유스케이스 · 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록에 있다. 옛 "반복 하루 템플릿 + 캘린더 배경 + Google 차임 미러" 설계는 2026-06-27 축소 재설계(WP)로 폐기됐다.
일~토 한 주를 시간 블록으로 그리는 독립 페이지 한 장. "내가 어떻게 살지"의 모양을 요일별로 배치하는 정적 시각 템플릿이다. 캘린더 연동·알림·반복 펼침이 없고, 멤버당 단일 주간 템플릿으로 orino 내부에만 존재한다.
| 화면 | 경로 | 설명 |
|---|---|---|
| 주간 계획표 | /planner/plan |
일~토 × 시간축 그리드. [+ 추가] 버튼으로 요일·시간 블록 생성, 자동 저장, 다중 선택 삭제 |
- Google Calendar 연동·차임 미러·알림 (축소 재설계로 폐기)
- 여러 주간 템플릿, 주차별 인스턴스, 반복 펼침
- 자세한 결정은 Day Plan 결정 기록
상태: 기획 진행 중
학습 자료(Study Material)와 무관하게 아무 때나 자유롭게 적는 독립 메모장. Study Planner의 노트가 "특정 학습 자료에 대한 필기"라면, 메모는 자료가 없어도 존재하는 범용 캡처 공간이다.
| 항목 | 내용 |
|---|---|
| 서비스명 | Memo |
| 핵심 가치 | 자료에 얽매이지 않는 최상위 메모를 Notion 스타일 트리로 정리 |
| 플랫폼 | Web |
| 차별점 | 노트의 Tiptap 에디터 엔진(트리·자동저장·이미지)을 재활용하되, material_id 종속이 없는 독립 도메인 |
| 구분 | 노트 (Study Planner) | 메모 (Memo) |
|---|---|---|
| 소속 | 학습 자료(material)에 종속 (material_id NOT NULL) |
종속 없음 (최상위) |
| 진입 | 자료 상세 → [노트] 탭 | 사이드바 → [메모] 독립 페이지 |
| 용도 | 특정 자료 학습 정리 | 잡생각·아이디어·할일·범용 기록 |
| 저장소 |
note 테이블 |
memo 테이블 (신규, 별도) |
| 공유 | Tiptap 에디터 엔진·자동 저장 로직 재활용 | 동일 |
결정: 노트의
material_id를 nullable로 완화해 겸용하지 않고 별도memo테이블·API·라우트로 분리한다. 근거는 결정 기록 참고.
| ID | 영역 | 기능 | 설명 |
|---|---|---|---|
| MEMO-001 | 트리 | 메모 트리 조회 | 멤버의 최상위 메모 + 하위 메모 트리 조회 |
| MEMO-002 | 메모 | 메모 생성 | 최상위/하위(parentId) 메모 생성. 빈 doc·기본 제목으로 시작 |
| MEMO-003 | 메모 | 단건 조회 | 메모 본문(Tiptap JSON) 조회 |
| MEMO-004 | 메모 | 본문/제목 저장 | 자동 저장(2초 debounce), PATCH idempotent |
| MEMO-005 | 메모 | 삭제 | 메모 삭제. 하위 메모 CASCADE 삭제 |
| MEMO-006 | 트리 | 이동·정렬 | 부모 변경(parentId)·형제 정렬(sortOrder) |
- 단일 사용자·저트래픽 → 인덱스 + 일반 RDB 조회로 충분. 본문 저장 300ms 이내
- Tiptap content는 MySQL
JSON. 이미지는 노트와 동일한 업로드 파이프라인 재사용 - 다크모드·반응형(디자인 시스템), 노트 에디터 컴포넌트 공유
| 화면 | 경로 | 설명 |
|---|---|---|
| 메모 | /memo |
좌: 메모 트리 사이드바([+ 새 메모]·하위 추가·삭제), 우: Tiptap 에디터 + 저장 상태. 빈 상태 안내 |
- 인라인 하위 페이지(
/페이지childPage 블록) — v1은 트리 사이드바로만 하위 생성. 인라인은 차기(노트 childPage 엔진 일반화 후) - 메모 검색, 즐겨찾기/아이콘/커버, 태그
- 메모 ↔ 노트/카드 상호 변환, 자료로 승격
- 공유·협업, 첨부파일(이미지 외)
- 알림/리마인더 (메모에 due 개념 없음)