Linear migration metadata¶

• Linear issue: TAK-263
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-263/core-gui-テーブルコードと物理テーブル名の表示方針を整理する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAA Core
• Linear assignee:
• Linear labels:
• Linear created: 2026-09-08T14:28:33.944Z
• Linear updated: 2026-09-08T14:28:33.944Z
• Linear archived:

Original description¶

背景¶

Core GUI のアプリ詳細基本設定では、テーブルコード と DBテーブル名 / 物理テーブル名が利用者に見える形で分かれている。

ただし、通常利用者にとって両者の違いは分かりにくく、内部識別子系の項目が増える原因になっている。理想としては物理テーブル名だけに統一したいが、現行プログラムでは テーブルコード が resource 名、生成コード、API、権限、DB名派生などの基点になっている可能性があり、単純廃止は影響が大きい。

ユーザー合意済みの暫定方針として、テーブルコード は登録時にだけ指定し、登録後は更新不能にする。テーブル名 / 物理テーブル名は画面に一切表示しない。

要件¶

• アプリ登録時のみ テーブルコード を入力させる。
• 登録後の基本設定画面では テーブルコード を更新できない。
• 登録後の編集画面で テーブルコード を表示する場合も、編集不可の参照情報に限定する。簡単モードでは原則表示しない。
• DBテーブル名、物理テーブル名、resource.table 相当の項目は Core GUI 上に表示しない。
• 内部の物理テーブル名は テーブルコード から一貫して自動派生させる。
• テーブルコード 変更は通常操作では提供しない。必要な場合は DB、API、権限、生成コード、リリースSQLを含む個別改修として扱う。

受入条件¶

• 新規アプリ登録時に テーブルコード を指定できる。
• 既存アプリの基本設定画面で テーブルコード を編集できない。
• Core GUI の通常画面に DBテーブル名 / 物理テーブル名 入力欄が表示されない。
• 生成される DB 物理名、resource 名、API、権限キー、生成コード名の派生ルールが設計に明記されている。
• 既存 metadata に table が存在する場合の互換読み込み・保存方針が設計に明記されている。
• テーブルコード の重複、命名規則違反、予約語、既存テーブル衝突を登録時に検出できる。
• YAML直接編集だけでしか扱えない正式設定を増やさない。

注意事項¶

• 既存プログラムへの影響が大きいため、テーブルコード の完全廃止はこの issue の対象外。
• 物理テーブル名変更機能は対象外。必要な場合はリリースSQLを伴う個別改修として扱う。
• TAK-262 の項目設定/一覧表示シンプル化と関連するが、本 issue はアプリ基本設定の識別子表示整理を対象とする。
• 実装時は既存 resource.yaml / generator / backend / frontend の name と table の参照箇所を洗い出してから設計する。