Content Architecture

内部確認用・noindex

「何を、どの構造で、どのように管理・更新するか」の見取り図です。 このページは各領域の概要と関係・正本の所在だけを持ちます。 用語定義の本文は Glossary、 運用フローの詳細は Entry Workflow が正本です。 画面での伝え方(Presentation Patterns)は Design System が担当し、両者へ同じ定義を複製しません。

責務の関係: Content Architecture=何を、どの構造で管理するか / CIPValue Framework / IPA=特定Contextでどう価値ある形へ提示するか / Design System=UIとしてどう一貫して実現するか。

関連: GlossaryEntry Workflow

Content Types

サイトが扱うコンテンツの種別と、それぞれの正本。種別を増やすときは、既存の器(エントリー・くらしガイド等)で吸収できないかを先に検討します。

  • Entry(スポット / 記事 / イベント)Current

    掲載先・読み物・イベントの総称。entry_type(place / article / event)で骨格を1つ選ぶ。共通詳細 /entry/[slug]。

    正本: content/entries/*.md

  • Life Guide(くらしガイド)Current

    制度・手続きの編集ページ。13カテゴリ+トピック。エントリーとは別コレクション。

    正本: src/lib/*-topics.ts + content/life-guide/*.md

  • Task(よくある用事)Draft

    用事を完了させる横断入口。一覧は稼働、状況別ページはプレースホルダー。

    正本: src/lib/tasks.ts

  • Notice(お知らせ)Current

    運営からのお知らせ。1ファイルに複数件をまとめて管理し、個別詳細ページは持たない。告知バーは最新1件を表示。

    正本: content/notices/notices.md + src/lib/notices.ts

  • Safety Data(防災ポイント)Current

    AED・避難所等の位置データ。「近く」検索で使用。広告なし。

    正本: content/safety/ + src/lib/safety-data.ts

  • Fixed Page(固定・法務ページ)Current

    利用規約・プライバシー等の法務系と、about等の案内ページ。

    正本: content/pages/*.md + src/app/(案内ページ)

  • Advertising / Sponsorship DataDraft

    広告主(advertising)と協賛(sponsorship)は別系統。募集ページは稼働、掲載データ運用はこれから。

    正本: agent project-documents/advertising-architecture.md・sponsorship-policy.md

Content Model

コンテンツ共通のモデル観。項目定義の正本は agent entry-architecture.md、掲載可否・書き方の正本は agent content-policy.md。

Required / Optional Fields
エントリーはtitle・entry_type・tagsが必須。任意項目(住所・営業時間・座標等)は骨格ごとに使い分ける。定義: entry-architecture.md + src/lib/entries.ts(実装)。
Relationships
related_entries でエントリー間を相互参照。くらしガイド→エントリーは一方向リンク。
Status
listing_status(public / sample / private 等)で公開状態を管理。sponsor_status は協賛表示用。
Dates
source_date(取得日)・verified_date(確認日)・next_review_date(再確認予定)・event_start / event_end(開催期間)。
Sources / Verification
全公開情報に出典と確認日を持たせ、詳細ページ最下部へ自動表示する。
Publication Rules
公開可否・高リスク領域の扱いは content-policy.md が正本。人の承認なしに公開しない。

Entry Model

エントリー(掲載先・記事・イベント)の構造。正本は content/entries/*.md(frontmatter+GFM本文)と、その読み取り実装 src/lib/entries.ts。

Entry Types(骨格)
place(場所が主役)/ article(読み物)/ event(日時が主役)の3種のみ。骨格は増やさず、業種差は要素で吸収する。
Frontmatter
slug・title・entry_type・tags・area_tags・feature_tags・related_entries・listing_status・住所/座標・営業情報・出典系・images など。
Body / Media
本文はGFM。先頭H1はヒーローで表示するため本文から除去。画像は images.main / images.logo(公開画像の正本はCloudflare R2)。
Listing Status
public 以外(sample・private 等)は一覧・検索に出さない運用。現状の実データは Site Reference で確認。
Review Dates
verified_date 降順が新着順。next_review_date が鮮度診断(Planned)の基準になる。

実データの状態は Site Reference で確認できます。

Taxonomy

分類の正本は agent project-documents/tag-taxonomy.md(判定実装は src/lib/fields.ts)。新しいタグは必ず正本へ追記してから使います。

Fields(フィールド)
食べる/遊ぶ・学ぶ/買う/サービス・体験/松阪を知る/くらしガイドの6大区分。tagsからの判定で決まり、1エントリーが複数フィールドに同時該当してよい。
Tags / ジャンル
エントリーに付与する自由属性。フィールド判定・ジャンル(焼肉・カフェ等)の土台。表記ゆれは Site Reference の Tags セクションで確認。
Area Tags
地域(松阪駅周辺 等)の軸。
Feature Tags
特集への束ね軸。
Categories(くらしガイド)
くらしガイドだけが持つ固定カテゴリ(13種)。タグ判定ではなく固定ページ。
Terminology Rules
「フィールド/ジャンル/カテゴリ」等の用語衝突を避ける規則。詳細は Glossary。

Glossary

プロジェクト用語の詳細辞書は専門ビュー /glossary が担当します(このページには定義本文を複製しません)。

Glossary(用語集) は、探し方の軸・エントリーと骨格・ページ種別・運営用語を人間向けにまとめた索引です。 定義の正本は agent tag-taxonomy.mdsite-spec.md で、用語を変えるときは正本を先に直し、Glossaryを追随させます。

Content Lifecycle

コンテンツの一生の全体像。工程・分担・保存場所の詳細は専門ビュー /entry-workflow が正本です。

Source → Source Index → Entry Candidate → Draft → Review → Public Markdown → Publish → Update → Archive / Retire

公開判断(「公開OK」への移行と本番公開の最終承認)は必ず人が行います。 詳細は Entry Workflow へ。

Information Sources / Provenance

出典と更新根拠の管理。取り込み手順の正本は agent workflows/source-intake.md。

Source Types
公式サイト・広報・現地取材・フォーム提供・資料の5系統。一次情報を優先する。
保存場所
生データは agent inbox/、整理済みナレッジは agent sources/、索引はNotion Source Index DB。
Verification Dates
取得日(source_date)と確認日(verified_date)を分けて記録する。
Citation Rules
公開ページには出典と確認日を表示。高リスク情報は必ず一次情報で確認する。
Internal References
プロジェクト推進・技術調査など内部利用の資料は agent project-documents/references/ に分け、公開サイトへ混ぜない。

Publication Flow

下書きから公開まで。詳細な工程は /entry-workflow(正本: agent workflows/entry-collection-to-publication.md)。

Draft / Review
agent drafts/ で下書き→人がレビュー。
Canonical Markdown
公開原稿の正本はサイトリポジトリの content/(Notionは審査・管理の場で、公開の正本ではない)。
Build / Publication
Next.js のstatic build→Deploy Previewで人が確認→Netlifyへ公開。
Post-publication Review
公開後も確認日・反応を見て更新する(成長ループ)。

Update and Expiration

更新・期限切れの扱い。現在は運用ルールのみで、機械的な検出は Site Reference の Content Freshness(Planned)が担う予定です。

Review Due
next_review_date を過ぎたら再確認する。
Event Completion
イベントは event_end 後に「開催終了」表示へ自動で変わる(src/lib/event-status.ts)。
Closure / Removal
閉店・削除依頼は workflows/entry-correction-update.md に従い、訂正・削除フォーム(/correction)から受け付ける。
Archive
掲載を止める場合も履歴はGitに残る。listing_status で非公開化する。

Repository Responsibilities

どこに何を置くか。個人情報・請求情報・フォーム回答の生データはGit外で管理し、プロジェクト参照ページにも表示しません。

Site Repository(01-matsusaka-guide)
実装コード・公開原稿Markdown・公開アセット。実在ルート・UI・トークンの正本。
Agent Repository(01-matsusaka-guide-agent)
設計文書(project-documents/)・運用手順(workflows/)・ソースナレッジ(sources/)・下書き(drafts/)。
Notion
受付・審査・候補管理(Entry Candidate DB・Source Index DB)。公開の正本ではない。
Cloudflare R2
公開画像の正本。
Git外
個人情報・請求情報・契約情報・非公開連絡先・フォーム回答の生データ。