Linear migration metadata¶

• Linear issue: TAK-27
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-27/resourcename-未指定時に-table-名で補完する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project:
• Linear assignee:
• Linear labels:
• Linear created: 2026-05-30T04:28:40.331Z
• Linear updated: 2026-06-21T05:33:08.877Z
• Linear archived:

Original description¶

背景¶

resource.yaml の resource.name と resource.table の違いが分かりづらい。
現状実装では MetadataLoader が resource.GetString("name") / resource.GetString("table") として読み込んでおり、どちらも必須になっている。

ただし実務上は name と table が同じになるケースが多く、name はEPAA上のCRUD識別子、table はDBテーブル名という違いを理解するまで混乱しやすい。

要望¶

resource.name が未指定の場合、resource.table と同じ値をデフォルトとして補完できるようにする。

対応案¶

• resource.table は引き続き必須にする。
• resource.name は任意にし、未指定なら table の値を使う。
• 明示的に name が指定された場合は現在通りその値を使う。
• validator / metadata loading / 生成ドキュメント / マニュアルを更新する。

受け入れ条件¶

• resource.name 未指定、resource.table 指定のみの *.resource.yaml が metadata validation を通る。
• 生成されるAPIルート、コード識別子、relations.resource 参照は補完後の name で一貫する。
• name と table を別名にした既存ケースが壊れない。
• docs/manuals/resource-yaml.html に、name 未指定時は table を使うこと、name と table の違い、SQL aliasではないことを明記する。

補足¶

現状のマニュアルでは当面 name は必須と説明する必要があるが、このタスク対応後は「通常は省略可、DB名と違うCRUD名にしたい時だけ指定」に整理できる。