specsfy-specialist-data-modeling

製品データをモデル化する

データベースやライブラリを憶測で選ばずに、永続データを理解し、発展させるには、このスキルを使用してください。変更を提案する前に、技術スタック、現在のシステム、マイグレーション、スキーマ、モデル、契約、テストを確認してください。

作業

1. コードで確認できるエンティティ、その役割、関係を特定します。
2. 各情報のフィールド、型、必須性、由来、ライフサイクル、および参照・変更できるユーザーを記録します。
3. 該当する場合は、一意性、整合性、保持、削除、履歴、マイグレーションについて説明します。
4. spec のデータセクションを更新し、確認済みの回答を $specsfy-aux-database と .specsfy/DATABASE.md に反映します。
5. 作成、読み取り、更新、削除、認可、無効なデータに関するシナリオを導き出します。実装では、検出されたデータベースのスペシャリストを使用します。

フィールド、関係、技術を捏造しないでください。現在のシステムから必要なデータが判断できない場合は、製品で何を保存する必要があるかをユーザーに確認してください。

使用する場面

• テーブル、スキーマ、モデル、マイグレーション、永続データの契約を変更する場合に使用します。
• spec を作成する前に、関係とライフサイクルを把握する場合にも使用します。
• プロジェクトの情報なしに、データベースライブラリを選ぶ目的では使用しないでください。

フロー

1. 既存の技術スタック、マイグレーション、スキーマ、モデル、テストを確認します。
2. 確認できたエンティティ、関係、フィールド、状態を分類します。
3. 一意性、保持、削除、履歴のルールを記録します。
4. 提案を現在の契約およびクエリと照合します。
5. 確認結果をプロジェクトのデータベーススキルに反映します。
6. データベースに関わる変更には、バージョン管理されたファイルを含む [MIGRATION] タスクを必須とし、テスト用データベースで適用を確認します。

規約

• 各フィールドに型、由来、必須性、ライフサイクルを記録します。
• 各関係にカーディナリティと読み込み方法を記載します。
• すべてのマイグレーションで既存データを保持するか、必要な変換を説明します。

アンチパターン

• 製品での用途を確認せずにフィールドを作成する。
• クエリ、ファクトリー、テストを確認せずに関係を変更する。
• 既存の技術スタックを読む前に技術を選ぶ。

検証

• 永続モデルに関係するテストとバリデーターを実行します。
• データベースのコピーでマイグレーションを確認し、適用後のスキーマを比較します。
• タスクを完了する前に、ファイル、適用コマンド、マイグレーション状態の確認クエリを確認します。
• プロジェクトから検証可能な出力を得るまで、モデルの完成を宣言しないでください。

関連スキル

• プロジェクトの永続データマップを維持するには $specsfy-aux-database を使用します。
• Postgres 固有の詳細には $specsfy-specialist-postgres を使用します。
• Laravel のマイグレーションとモデルには $specsfy-specialist-laravel を使用します。

モデリング、マイグレーション、永続データの契約に関する情報源については、references/standards.md を参照してください。