ページスキーマ ⌇ 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 には非公開）
source_hash — source の ohash フィンガープリント。content equality 判定や redundant write skip に使う
outlinks — このページから出ている内部リンクの配列

赤リンク（バックリンクのみで実体が無いページ）は Page のフィールドではなく、解決時の resolution: 'redlink' という別経路で表現する。

Frontmatter

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

content_id: 01HQ3K5P0G3Z1VXYZ2ABC3DEF
title: Hello World
title_locale:
  ja: こんにちは、世界！
date: 2025-08-20
updated: 2025-08-21
visibility: public
draft: false
layout: grid
tags:
  - video
  - diary
description: A sample page
thumbnail: https://example.com/image.jpg

主なフィールド:

content_id — ULID。省略時は自動生成
title — 文字列（title_locale で {en, ja} の locale 別タイトルを上書き可能）
date — 代表日時（イベント開始日や公開日）。ISO 8601 の日付または日時
until — 期間ものイベントの終了日時。未設定なら index 投入時に date をコピー
updated — 訪問者向けの更新日時（ソートや RSS で使う）。明示的に著者がスタンプする運用（保存時に自動で進めない）
visibility — 'public' / 'unlisted' / 'protected' / 'private' / 'contextual'（→ information-architecture.md）
draft — true で noindex/nofollow + <html> に draft クラス付与。デフォルト false は「公開」
layout — 'page'（デフォルト）/ 'grid' / 'table' 等
tags — tag link の配列。slug に正規化されて outlinks に変換される
aliases — ページの別名（リダイレクト用）
redirect — 別ページへの転送

Link 型

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

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

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

RxDB スキーマ

DB 上では PageDoc = {id, content, softDeleted} の形で保存される。

id — content.content_id 由来の primary key
content — Page 全体（additionalProperties: true、MDC AST のような複雑な JSON を JSON Schema で完全モデル化するのは現実的でないので開けてある）
softDeleted — soft delete フラグ。RxDB native の _deleted ではなく通常フィールドなので、replication が他のフィールド変更と同じ経路で削除を伝播する

サーバ側のみ、PageDoc に seq: number（required + indexed）が追加される。pageSchema.ts で import.meta.server 分岐により schema を fork し、レプリケーション pull のレスポンス組み立て時にサーバ側で seq を destructure で除去してからクライアントへ送る。詳細は replication.md。

主なインデックス: content.content_id, content.slug, softDeleted, content.date, content.until, content.updated, content.visibility.type、および [visibility.type, date/until/updated] の compound index。サーバ側のみ seq。

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