ページスキーマ ⌇ Baku Hashimoto

ページのデータモデルについて。型定義は types/page.ts、RxDB スキーマは utils/rxdb/pageSchema.ts にある。

Page インターフェース

Page は frontmatter の情報に加えて、パース済みの本文やアウトリンクを含む完全なページデータ。

主なフィールド:

path — ファイルパス（拡張子なし）
slug — 正規化済みの識別子（→ information-architecture.md）
content_id — ULID。リネーム追跡用の不変 ID
body — パース済みの本文 AST（MDCRoot、en/ja の多言語対応）
source — Markdown のソースコード（非 admin には非公開）
outlinks — このページから出ている内部リンクの配列
redlink — 赤リンクページかどうか（実体がなく、バックリンクのみで存在するページ）

Frontmatter

YAML frontmatter のスキーマは Zod で定義している（FrontmatterSchema）。Obsidian 互換を意識したフォーマット。

content_id: 01HQ3K5P0G3Z1VXYZ2ABC3DEF
title: Hello World
title_locale:
  ja: こんにちは、世界！
created: 2025-08-20
modified: 2025-08-21
visibility: public
permanent: true
layout: grid
sort_by: modified
sort_order: desc
tags:
  - video
  - diary
description: A sample page
thumbnail: https://example.com/image.jpg
thumbnail_list: https://example.com/image-list.jpg

主なフィールド:

content_id — ULID。省略時は自動生成
title — 文字列、または {en, ja} のオブジェクト
created / modified — ISO 8601 の日付または日時
visibility — 'public' / 'unlisted' / 'protected' / 'private'（→ information-architecture.md）
thumbnail — 基本のサムネイル画像
thumbnail_list — 一覧表示用に優先されるサムネイル画像
permanent — 永続化フラグ。true なら permanent page、false なら note page。特定のタグやレイアウトで自動推定される
theme — CSS 変数の上書き。color_bg や color_note_bg、radius_pill などをページ単位で指定できる
layout — 'page'（デフォルト）/ 'grid' / 'table'
tags — tag link の配列。slug に正規化されて outlinks に変換される
aliases — ページの別名（リダイレクト用）
redirect — 別ページへの転送

例:

theme:
  radius_pill: 2rem

Link 型

ページから出ていくリンクの型。

interface Link {
  type: 'tag' | 'link'
  slug: string
  hash?: string
}

tag — frontmatter の tags と、パスの親ディレクトリから暗黙的に生成
link — 本文中のハイパーリンクから生成

RxDB スキーマ

DB 上ではおおむね PageDoc = {id: string, updatedAt: number, softDeleted: boolean, content: Page} の形で保存される。redlink は実行時に導出されるフィールドなので DB には含まれない。

id — RxDB の primary key。実体は content.content_id から導かれる
updatedAt — 同期と競合解決のための内部タイムスタンプ。Date.now() ベースで更新される
softDeleted — 論理削除フラグ。削除時もドキュメント自体は残り、true に切り替わる

content は additionalProperties: true にしている。MDC の AST のような複雑な JSON を RxDB の JSON Schema で完全にモデル化するのは現実的でないので。

主なインデックス: content.content_id, content.slug, softDeleted, content.created, content.modified, content.visibility.type, updatedAt

slug の重複チェックは upsertPage メソッド内で行っている。同じ slug で異なる content_id のドキュメントが既にあれば、パスに _2, _3, … のサフィックスを付けて自動リネームし、toast で通知する。

この重複チェックの対象になるのは softDeleted: false のドキュメントだけ。削除済みページの slug は再利用できる。