DB リファレンス · manifest v1 · 自動生成

DB スキーマ・リファレンス

リレーショナル層は二層構造 — core（実カラム。手書き SQL migration + 人間承認でのみ変更）と extension（meta jsonb のキー。MCP の db_schema_addField で即追加）。このページは @event/crm-schema の DEFAULT_MANIFEST から生成している — entity や field をここに手書きしない。 manifest を更新すればこのページも変わる。

entities:organization user member entity_lp consent suppression dsr_log audit_log

標準 core フィールドSTANDARD_CORE_FIELDS · 全テーブル共通

全 entity が必ず持つ system 管理カラム。MCP / admin からの書き込みは splitPatch が常に拒否する。物理 DELETE は不可 — deletedAt を刻む soft-delete のみ。

field	型	layer	writableBy	必須	制約	説明
`id`	string	core	system	必須	—	uuid 主キー
`createdAt`	timestamp	core	system	—	—	作成時刻
`updatedAt`	timestamp	core	system	—	—	更新時刻（書き込み毎に system が刻む）
`deletedAt`	timestamp	core	system	—	—	soft-delete 時刻。MCP からの物理 DELETE は不可
`version`	number	core	system	—	—	楽観ロック。update 時に一致必須・自動 increment

organization6 fields

組織（buyer / guild / sponsor 等の主体）

field	型	layer	writableBy	必須	制約	説明
`name`	string	core	admin · mcp	必須	1–200 文字	表示名
`slug`	string	core	admin	必須	`^[a-z0-9-]{1,64}$`	一意ハンドル（URL 連結用）
`logo`	string	core	admin · mcp	—	最大 500 文字	ロゴ URL
`fourSOrgId`	string	core	admin	—	—	4S org との連結点
`companyJp`	string	core	admin · mcp	—	最大 200 文字	日本語法人名
`companyEn`	string	core	admin · mcp	—	最大 200 文字	英文社名

user4 fields

ユーザー（4S 連結）

field	型	layer	writableBy	必須	制約	説明
`email`	string	core	admin	—	最大 254 文字	メールアドレス
`name`	string	core	admin · mcp	—	最大 100 文字	表示名
`image`	string	core	admin · mcp	—	最大 500 文字	アバター URL
`fourSUserId`	string	core	admin	—	—	4S sub（不変キー）

member6 fields

組織メンバーシップ（org × user）

field	型	layer	writableBy	必須	制約	説明
`organizationId`	ref → organization	core	admin	必須	—	所属組織
`userId`	ref → user	core	admin	必須	—	ユーザー
`role`	enum	core	admin	—	`owner \| editor \| viewer \| advisor`	権限
`title`	string	core	admin · mcp	—	最大 100 文字	役職（自由記述）
`displayOrder`	number	core	admin · mcp	—	—	表示順（低い順）
`publicVisible`	boolean	core	admin · mcp	—	—	公開 LP に出すか

entity_lp7 fields

汎用公開エンティティ LP（content jsonb + Zod 凍結）

field	型	layer	writableBy	必須	制約	説明
`slug`	string	core	admin	必須	`^[a-z0-9-]{1,64}$`	公開 URL の slug
`organizationId`	ref → organization	core	admin	必須	—	所有組織
`title`	string	core	admin · mcp	—	最大 200 文字	LP タイトル
`status`	enum	core	admin	—	`draft \| private \| preview \| published \| suspended`	公開状態（B14 ルールの写像先）
`previewToken`	string	core	system	—	—	限定公開トークン（system 発行）
`content`	json	core	admin	—	—	LP 本文（アプリの Zod schema が凍結）
`publishedAt`	timestamp	core	system	—	—	公開時刻

consent5 fields

同意記録（法的証跡）

field	型	layer	writableBy	必須	制約	説明
`subjectKey`	string	core	admin	必須	—	対象キー
`granted`	boolean	core	admin	—	—	同意済みか
`scope`	string	core	admin	—	—	同意の範囲
`source`	string	core	admin	—	—	由来
`policyVersion`	string	core	admin	—	—	ポリシーバージョン

suppression2 fields

掲載抑止リスト（fail-closed）

field	型	layer	writableBy	必須	制約	説明
`key`	string	core	admin	必須	—	抑止キー
`reason`	string	core	admin	—	—	理由

dsr_log4 fields

データ主体請求ログ（開示/訂正/削除/停止）

field	型	layer	writableBy	必須	制約	説明
`kind`	enum	core	admin	必須	`disclosure \| correction \| deletion \| suspension`	種別
`subjectKey`	string	core	admin	—	—	対象
`requester`	string	core	admin	—	—	申請者識別（生 PII 禁止）
`status`	string	core	admin	—	—	処理状態

audit_log4 fields

監査ログ（追記専用 — trigger が UPDATE/DELETE を拒否）

field	型	layer	writableBy	必須	制約	説明
`actor`	string	core	system	必須	—	操作主体
`action`	string	core	system	必須	—	操作
`targetType`	string	core	system	—	—	対象種別
`targetId`	string	core	system	—	—	対象 ID

カラムを足すには

拡張レイヤへの追加は MCP の db_schema_addField 一発（ALTER TABLE 不要・Neon 未接続でも効く）。追加されたフィールドは manifest の version が上がり、このページにも extension バッジ付きで現れる。固定コアの変更だけは db_migration_propose → SQL 生成 → 人間承認 PR。

recipe add-database ch.15 MCP-first 二層 DB