@careerchain/stdd 0.1.1 → 0.1.3

package/assets/.claude/skills/documenting-specifications/templates/screen-items-definition.md

@@ -1,179 +0,0 @@
-# SCREEN_ITEMS_DEFINITION.md テンプレート
-
-**目的**: 画面の入力項目・表示項目を「UI × バリデーション × DBマッピング」の粒度で定義する実装SSoT（Single Source of Truth）
-
-**配置**: `docs/<app>/<path>/SCREEN_ITEMS_DEFINITION.md`
-
-**作成タイミング**（オプション。以下に当てはまる画面で作成を検討）:
-
-- フォーム項目が多い画面
-- 複雑なバリデーションルール／操作モード（Create / Edit / View）がある
-- 表示形式（フォーマット・単位）や DB カラムとの対応の明示が必要
-
-**画面タイプ別の使い分け**:
-
-| 画面タイプ | 使うセクション |
-| --- | --- |
-| 入力フォーム（登録・編集） | 0. 操作モード / 1. 画面項目定義（入力） / 操作ボタン定義 / 3. バリデーション適用ルール |
-| 一覧・検索 | 1.x 検索条件項目 + 1.x 一覧表示項目 |
-| 詳細・表示専用 | 1. 画面項目定義（表示） + 表示レイアウト |
-
-不要なセクション（操作モード・バリデーション適用ルール等）は表示専用画面では省略してよい。
-
-> **記述粒度の方針**: 本書は技術スタック非依存とする。言語固有の型（TS型等）・ORM・フレームワーク詳細は記載せず TECH_DESIGN.md に委ねる。DBマッピング（保存先テーブル・カラム）は画面項目と DB スキーマの対応を示す SSoT として記載する。
-
-## テンプレート構造
-
-```markdown
-# [画面名]（[SCREEN_ID]）画面項目定義
-
-本ドキュメントは、[画面名]画面における **画面項目定義（実装SSoT）** を定義する。
-
-- 画面レイアウト（Excel / 画像 / WF）を正（SSoT）とする
-- DB スキーマは画面項目定義に追従する（DB のメタデータは本書には定義しない）
-- SELECT 項目は label-only（表示文字列＝保存値）とする
-- デフォルト値の表記は **null で統一**する
-
----
-
-## 0. 操作モード定義  ← 入力フォームの場合のみ
-
-| モード | 説明                       |
-| ------ | -------------------------- |
-| Create | 新規登録時の操作           |
-| Edit   | 既存編集時の操作           |
-| View   | 参照専用モード（初期表示） |
-
-※ View モードではすべての項目を非活性とする（表中には明示しない）
-
----
-
-## 1. 画面項目定義（UI × Validation × DB Mapping）
-
-### 表記ルール  ← 操作モードを持つ画面のみ
-
-- **必須条件**：操作モード（Create / Edit）ごとの必須可否を記載（例: Create: 必須 / Edit: 必須）
-- **活性条件**：操作モード（Create / Edit）ごとの入力可否を記載（例: Create: 活性 / Edit: 非活性）
-- **デフォルト値**：新規登録時（Create）のみ適用
-- **SELECT定義**：`2. SELECT項目定義` 内の参照先ID（例: `S.1 業界`）を記載
-
-#### 列の意味（列レジェンド）
-
-| 列 | 内容 |
-| --- | --- |
-| 項目名 | 画面に表示するラベル |
-| 必須（条件） | 必須可否。操作モードがある場合はモードごと |
-| 活性（条件） | 入力可否。操作モードがある場合はモードごと |
-| デフォルト値 | Create 時の初期値（なければ null） |
-| 入力コンポーネント | Text / TextArea / Number / Date / Select / Checkbox / Tag など |
-| 制約 | maxLen / 範囲（0–100）/ 相関（From ≤ To）/ 形式 など |
-| SELECT定義 | SELECT 項目の参照先ID（なければ – ） |
-| DBテーブル | 保存先テーブル |
-| DBカラム | 保存先カラム |
-| 備考 | 連動・特記事項（新規カラム・FK 等もここに記す） |
-
----
-
-### 1.1 [セクション名（例: 基本情報）]  ← 入力フォーム
-
-| 項目名 | 必須条件 | 活性条件 | デフォルト値（Create） | 入力コンポーネント | 制約 | SELECT定義 | DBテーブル | DBカラム | 備考 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| [項目名] | Create: 必須 / Edit: 必須 | Create: 活性 / Edit: 活性 | null | Text | maxLen=100 | – | [table] | [column] | |
-| [項目名] | Create: 任意 / Edit: 任意 | Create: 活性 / Edit: 活性 | null | Select | – | S.1 [選択肢名] | [table] | [column] | |
-
----
-
-### 1.x 検索条件項目  ← 一覧・検索画面
-
-| 項目名 | 必須 | 活性 | デフォルト値 | 入力コンポーネント | 制約 | SELECT定義 | DBテーブル | DBカラム | 備考 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| [項目名] | 任意 | 活性 | null | Text | 部分一致 | – | [table] | [column] | OR検索 |
-
-### 1.x 一覧表示項目  ← 一覧・検索画面
-
-| 項目名 | 表示 | ソート | DBテーブル | DBカラム | 備考 |
-| --- | --- | --- | --- | --- | --- |
-| [項目名] | ○ | ○ | [table] | [column] | |
-
----
-
-### 1.x [タブ名]表示項目  ← 詳細・表示専用画面
-
-| 項目名 | 表示 | DBテーブル | DBカラム | 備考 |
-| --- | --- | --- | --- | --- |
-| [項目名] | ○ | [table] | [column] | 表示形式（例: 「XX歳」/ From–To）を備考に記載 |
-
----
-
-### 1.x 操作ボタン定義  ← ボタンを持つ画面
-
-| ボタン名 | 表示条件 | 活性条件 | アクション | 備考 |
-| --- | --- | --- | --- | --- |
-| [登録] | Create / Edit モード | Create: 活性 / Edit: 活性 / View: 非活性 | 全バリデーション後に保存 | |
-| [キャンセル] | Create / Edit モード | Create: 活性 / Edit: 活性 | 未保存変更があれば破棄確認 | |
-
----
-
-## 2. SELECT項目定義（共通参照）
-
-- 本画面で使用する SELECT 項目の選択肢は共通定義（例: `[SELECT_ITEM_DEFINITION.md](../../../common/SELECT_ITEM_DEFINITION.md)`）を参照する。
-- 表中の「SELECT定義」列には、参照先ID（例: `S.1 業界`）を記載する。
-- 共通定義を持たない場合は、本セクションに `S.x [名称]` 単位で選択肢一覧を直接定義する。
-
----
-
-## 3. バリデーション適用ルール  ← 下書き保存等のモードがある画面
-
-| バリデーション種別 | 説明 | Create / Edit（本登録） | 下書き保存 |
-| --- | --- | --- | --- |
-| 必須チェック | 必須条件列で「必須」と定義された項目の入力有無を検証 | ✅ 適用 | ❌ スキップ |
-| 型チェック | 型の整合性を検証 | ✅ 適用 | ✅ 適用 |
-| 桁数・文字数チェック | maxLen 等の上限値を検証 | ✅ 適用 | ✅ 適用 |
-| 形式チェック | 日付・メール等のフォーマットを検証 | ✅ 適用 | ✅ 適用 |
-| 範囲・相関チェック | From ≤ To、0–100 等を検証 | ✅ 適用 | ✅ 適用 |
-
-※ スキップされるのは必須チェックのみ。入力値が存在する場合の型・桁数・形式・範囲チェックは常に実施する。
-
----
-
-## 4. DBスキーマ変更方針（[table]）
-
-- **1. 画面項目定義の表に記載された DBカラムを正とする**
-- 既存 DB に同一カラム名が存在する場合はそれを利用する
-- 存在しない場合は新規追加する
-- 使用されていないカラムを削除する際は、必ず開発者へ確認をとる
-- 新規追加が必要なカラムも `1. 画面項目定義` 表の DBテーブル / DBカラム に記載し（必要なら備考に「新規」と注記）、別表で再掲しない（SSoTの二重化を避ける）
-
----
-
-## 5. 補足
-
-- 本ドキュメントは、実装・DB設計・QA における **Single Source of Truth** とする
-- （画面固有の前提: ページング方式・閲覧権限・未登録項目の表示「-」など）
-```
-
-## 重要なポイント
-
-### 記述すべき内容
-
-- 画面に存在するすべての入力項目・表示項目を網羅
-- 各項目の：必須/活性条件、デフォルト値、入力コンポーネント、制約、SELECT参照、DBマッピング（テーブル・カラム）
-- 操作モード（Create / Edit / View）がある場合はモードごとの差異
-- 操作ボタンの表示/活性条件とアクション
-- バリデーション適用ルール（特に下書き保存など必須チェックを緩めるモード）
-
-### 記述不要な内容
-
-- ユーザージャーニー・画面遷移の文脈 → REQUIREMENTS.md に記載
-- 技術設計・アーキテクチャ・実装コード → TECH_DESIGN.md に記載
-- 言語固有の型定義・実装技術に依存する記述（TS型・ORM・フレームワーク詳細）→ TECH_DESIGN.md に記載
-- DB のメタデータ詳細（インデックス・RLS 等）→ TECH_DESIGN.md に記載
-- 関数名・クラス名・ファイル行番号などのコード参照
-
-### 運用上の原則
-
-- **画面レイアウト（Excel / 画像 / WF）を正（SSoT）とし、DB スキーマは画面項目定義に追従する**
-- 本書は技術スタック非依存。言語固有の型やフレームワーク詳細は持ち込まない
-- SELECT 項目は label-only（表示文字列＝保存値）を基本とする
-- デフォルト値の表記は null で統一する
-- 共通の選択肢は SELECT 共通定義ファイルに切り出し、本書からは参照IDで指す