2. 핵심 개념 — 노트, 페이지, 토픽, 페이지 타입, 멘션

v3 의 모든 동작은 다섯 가지 단어 위에서 돌아갑니다. 한 번에 정리하고 갑시다.

2.1 노트 (raw, raw_items 테이블)

• 대화에서 떨어진 원본 그대로의 한 토막. 제목, 본문, 블록, 요약을 다 가질 수 있지만 분류는 하지 않습니다.
• 한 번 저장되면 본문은 불변 입니다. 수정하면 update_raw_item 으로 새 버전이 덮어 씌워지지만, 의미적으로는 "원본을 손댔다" 는 사건으로 추적됩니다.
• 화면에서는 /app/raws/[id] 에서 봅니다. 사이드바 노트 가 곧 원본 카탈로그.

2.2 페이지 (page, notes 테이블)

• 노트 하나에서 AI 가 토픽별로 추출한 큐레이션본. 마크다운 본문 + 블록 + 요약을 가지며, 수정 가능 합니다.
• 한 노트 → 여러 페이지. 카파시 + LLM Wiki 를 다룬 노트 하나는 카파시 (人物) 페이지와 LLM Wiki (技術) 페이지 두 개로 분기합니다. 두 페이지 모두 raw_item_id 로 같은 원본을 가리킵니다.
• 페이지마다 토픽 1 개 + 페이지 타입 1 개를 붙입니다. 둘은 직교 축이라서, 카파시 인터뷰 와 LLM Wiki 가이드 는 다른 페이지지만 같은 토픽일 수도 있고 같은 타입일 수도 있어요.
• 화면에서는 /app/notes/[id]. 사이드바 페이지 가 곧 큐레이션 카탈로그.

2.3 토픽 (topic, 사용자 카탈로그)

• 어떤 주제를 다루는가 의 축. 사용자가 직접 만들고 트리로 구성합니다 (parentId 로 중첩 가능).
• 예: 인물 아래 엔지니어, 엔지니어 아래 karpathy. 또는 단순히 프로젝트/notemesh-v3.
• AI 는 분류할 때 list_topics_catalog 로 기존 토픽을 먼저 살핀 뒤 적합한 것을 고릅니다. 마땅한 게 없으면 새 토픽을 제안 하고, 사용자가 승인하면 create_topic 로 만듭니다.
• 카탈로그 관리 화면: /app/catalog.

2.4 페이지 타입 (page type, 사용자 카탈로그)

• 어떤 형식의 글인가 의 축. 토픽과 직교합니다.
• 예: 회의록, 결정 노트, 학습 정리, 코드 스니펫, READING_NOTE.
• 토픽 하나 안에서 같은 페이지 타입이 여럿 쌓이면 린트 가 비슷한 글이 갈라져 있다 고 신호를 줍니다.
• 같은 화면 /app/catalog 에서 토픽 옆 탭으로 관리합니다.

2.5 멘션 칩 ([Title](/notes/UUID))

• 페이지 본문 안에서 다른 페이지나 노트를 가리키는 마크다운 링크의 약속된 형태.
• 두 가지 형태:
  • [Title](/notes/UUID) — 다른 페이지를 가리킵니다.
  • [Title](/raws/UUID) — 원본 노트를 가리킵니다 (페이지가 출처를 인용할 때).
• 모든 recall, get_note, list_recent_notes 응답에는 mention_md 필드가 포함됩니다 — AI 가 그 문자열을 그대로 본문에 붙여 넣기 만 하면 칩이 됩니다. UUID 를 손으로 안 만들어도 됩니다.

---