フィールドタイプ

オブジェクトに宣言できるすべてのフィールドタイプ — 何を格納し、どのオプションを受け付け、REST、Console、AI Builder にどう現れるか。

48 個の組み込みフィールドタイプを、ファミリーごとに分類しています。完全な Zod スキーマは packages/spec/src/data/field.zod.ts にあります — このページは実用的なサマリーです。

コアプロパティ（すべてのフィールド）

プロパティ	型	デフォルト	目的
`name`	string (snake_case)	—	マシン識別子 — REST パスセグメント、SQL カラム
`label`	string	—	Console での表示ラベル
`type`	FieldType	—	下記の型テーブルを参照
`required`	boolean	`false`	NOT NULL 制約
`unique`	boolean	`false`	ユニークインデックス
`searchable`	boolean	`false`	`/api/v1/search` 用にインデックス化
`multiple`	boolean	`false`	値の配列を格納
`defaultValue`	unknown	—	初期値（リテラルまたは CEL）
`hidden`	boolean	`false`	デフォルトの Console ビューから非表示
`readonly`	boolean	`false`	フォームで無効化
`system`	boolean	`false`	自動注入（id, created_at, …）
`externalId`	boolean	`false`	外部キーによる upsert の対象
`inlineHelpText`	string	—	ツールチップ / ヘルパーテキスト
`conditionalRequired`	`P` 述語	—	CEL が真のとき必須
`trackHistory`	boolean	`false`	値の変更を、レコードのアクティビティタイムラインに人間が読める形式のエントリとして表示（ADR-0052）

テキストファミリー

型	用途	主なオプション
`text`	短い文字列	`maxLength`, `minLength`
`textarea`	複数行	`maxLength`
`email`	メールアドレス	フォーマット検証あり。小文字化される
`url`	URL	フォーマット検証あり
`phone`	電話番号	E.164
`password`	一方向シークレット	認証サブシステムによってハッシュ化され、GET では返されない
`secret`	復号可能なシークレット（API キー、トークン、DB パスワード）	crypto プロバイダーによって保存時に暗号化され、不透明な参照として格納され、読み取り時にマスクされる。フェイルクローズ——プロバイダー未設定では、書き込みは平文を永続化せずにスローする
`markdown`	markdown 本文	Console プレビューでレンダリング
`html`	サニタイズ済み HTML	書き込み時に DOMPurify を適用
`richtext`	WYSIWYG	Console エディタ + シリアライズされた JSON

数値

型	用途	主なオプション
`number`	浮動小数点	`min`, `max`, `precision`, `scale`
`currency`	金額	`currencyConfig: { precision, currencyMode: 'fixed' \| 'dynamic', defaultCurrency }`
`percent`	0〜100 %	`min`, `max`, `scale`

integer と decimal は別の型ではありません。整数には scale: 0 を指定した number、固定小数には precision+scale を指定した number を使用してください。

日付 / 時刻

型	格納するもの	備考
`date`	カレンダー日付	タイムゾーンなし
`datetime`	瞬間	UTC
`time`	壁時計の時刻	日付なし

ロジック

型	備考
`boolean`	チェックボックス
`toggle`	boolean と同じ。スイッチ UI

選択

型	備考
`select`	単一選択 — オプションをインラインで宣言するか、picklist から参照
`multiselect`	複数選択。配列として格納
`radio`	ラジオ表示の `select` の UI エイリアス
`checkboxes`	チェックボックス表示の `multiselect` の UI エイリアス

オプションの形:

options: [
  { value: 'low',    label: 'Low' },
  { value: 'high',   label: 'High',   color: '#e02' },
  { value: 'urgent', label: 'Urgent', color: '#c00' }
]

リレーション

型	多重度	セマンティクス
`lookup`	多対一	緩い参照。親を削除してもデフォルトでは子は削除されない
`master_detail`	多対一、カスケード	親なしには子が存在できない。権限は親から継承される
`tree`	自己参照	階層構造（同じオブジェクト上の parent_id）

共通オプション:

{
  type: 'lookup',
  reference: 'account',                       // target object name
  lookupFilters: [                            // narrow the lookup picker
    { field: 'status', operator: 'eq', value: 'active' }
  ],
  deleteBehavior: 'set_null'                  // 'set_null' | 'cascade' | 'restrict'
}

算出

型	機能	主なオプション
`formula`	導出値。読み取り時または再計算時に評価される	`expression: F\`record.qty * record.unit_price`` — CEL を参照
`summary`	子リレーションのロールアップ	`summaryOperations: { object, field, function, filter? }`（`count` \| `sum` \| `avg` \| `min` \| `max`。省略可能な `filter` — クエリの `where` 条件、例 `{ status: 'received' }` — は条件に一致する子行のみを集計、16.0+）
`autonumber`	自動採番される表示番号	`format`（例: `TKT-{0000}`）、`startAt`

Formula の例:

{
  name: 'profit_margin',
  type: 'formula',
  expression: F`(record.revenue - record.cost) / record.revenue * 100`
}

メディア

型	用途	主なオプション
`image`	画像添付	`multiple` / `accept` / `maxSize`（下記参照）
`file`	任意のファイル	同上
`avatar`	プロフィール画像	正方形クロップ、適切なデフォルト
`video`	動画アップロード	再生時間 + サムネイルキャプチャ
`audio`	音声	波形プレビュー

{
  type: 'file',
  multiple: true,                             // store an array of attachments
  accept: ['image/png', 'image/jpeg'],        // MIME types / extensions
  maxSize: 10_000_000                         // bytes
}

構造化

型	格納するもの	備考
`json`	任意の JSON	Postgres では JSONB として格納
`composite`	名前付きフィールドを持つサブレコード	インライン構造体。別テーブルではない
`repeater`	composite 値の配列	子オブジェクトなしの一対多

拡張 UI

型	備考
`location`	緯度/経度 + 精度
`address`	番地 / 市区町村 / 地域 / 郵便番号 / 国
`code`	ソースコードフィールド — `language`, `theme`, `lineNumbers`
`color`	`colorFormat: 'hex' \| 'rgb' \| 'rgba' \| 'hsl'`, `presetColors[]`
`rating`	1〜N 個の星 — `max`, `icon`
`slider`	スライダー UI を持つ範囲付き数値
`signature`	手書き署名。画像として格納
`qrcode`	値を QR またはバーコード（EAN / UPC / Code128）としてレンダリング
`progress`	導出されたパーセントをバーとして表示
`tags`	オートコンプリート付きの自由形式タグ配列
`vector`	埋め込みカラム — フラットな `dimensions`（例: OpenAI 埋め込みは `1536`）。ネストされた `vectorConfig`（`distanceMetric`/`indexed`/`indexType`）は 16.0 で削除

システムフィールド（すべてのオブジェクトに自動注入）

フィールド	型	備考
`id`	text (ULID)	主キー
`created_at`	datetime	UTC の挿入時刻
`updated_at`	datetime	UTC の最終書き込み時刻
`created_by`	lookup → `user`	挿入したユーザー
`updated_by`	lookup → `user`	最後に書き込んだユーザー
`version`	integer	楽観的並行性トークン

これらは宣言しません — オブジェクトごとに ObjectSpec.systemFields: false でオプトアウトできます（推奨されることはほとんどありません）。

フィールドがスタックを流れる仕組み

*.object.ts (field spec)
   │
   ├─► Postgres / MySQL / SQLite column + index + constraint
   ├─► REST: validated on POST/PATCH, exposed on GET
   ├─► Console: form widget + list column
   ├─► AI Builder: tool argument schema (so the AI knows what to ask)
   └─► Audit: change-tracked if `trackHistory: true`