アイテムとコレクション

サイト(データベース)の中身は、すべて リソースという 1 つのモデルで表され、type(種別)で区別されます。

種別	役割
item(アイテム)	資料 1 点。画像・メタデータ・サムネイルを持つ、サイトの基本単位
collection(コレクション)	アイテムのまとまり。主題別・資料群別の整理に使う
media(メディア)	アイテムに紐づく画像などの面像。アイテムの子リソース
page(ページ)	サイト内の固定ページ(「このデータベースについて」等)
annotation(アノテーション)	画像上の注記。IIIF アノテーションとして保存・表示

リソースは parent_id で親子関係を作れます(media → item、item → collection など)。

メタデータ

各リソースには自由形式のメタデータを付与できます。キーは Dublin Core などの dcterms:*(例 dcterms:creator)を推奨します。メタデータは検索・ファセット(絞り込み)の対象になります。

メタデータ入力を補助する RDF 語彙(用語集)はダッシュボードの「語彙」で管理できます。

アイテムは主に次の方法で登録します。

CSV 一括登録(Omeka CSVImport 互換)— ダッシュボードの「サイト詳細」から CSV をアップロード。種別は item_sets(コレクション)/ items / media を選べ、**検証(ドライラン)**で件数・エラー行を事前確認してから取り込めます。サンプル CSV もダウンロードできます
API(プログラム連携)— POST /dl/{db}/resources で 1 件ずつ、または POST /dl/{db}/import で一括。詳細は開発者向け

画像などのバイナリは、アップロード用の署名付き URL(presigned URL)を発行して S3 互換ストレージに直接アップロードします。

アイテムの個別編集について

現在、ダッシュボードにはアイテムを 1 件ずつ編集する画面はありません。アイテム・コレクション・メディアの登録・更新は上記の CSV または API で行います(ダッシュボードで直接編集できるのは「お知らせ」のみ)。

リソースは 1 件ごとに公開/非公開を設定できます(is_public)。非公開のリソースは、サイトが公開状態でも一覧・検索・API に現れません。サイトを公開する前に、下書き状態のアイテムを非公開のまま準備しておけます。

執筆中

CSV のカラム仕様(Omeka CSVImport 互換のマッピング)、画像アップロードの対応フォーマットと IIIF 化の流れ、TEI テキストの取り込み手順を追記予定。