creating-oracle-to-postgres-migration-bug-report

Oracle から PostgreSQL への移行に関するバグレポートの作成

使用する場面

• Oracle と PostgreSQL の動作の違いが原因で発生した不具合を記録する場合
• Oracle から PostgreSQL への移行プロジェクトのバグレポートを作成またはレビューする場合

バグレポートの形式

references/BUG-REPORT-TEMPLATE.md のテンプレートを使用してください。各レポートには、次の項目を含める必要があります。

• Status：✅ RESOLVED、⛔ UNRESOLVED、または ⏳ IN PROGRESS
• Component：影響を受けるエンドポイント、リポジトリ、またはストアドプロシージャ
• Test：関連する自動テストの名前
• Severity：Low / Medium / High / Critical — 影響範囲に基づいて判断します
• Problem：Oracle で期待される動作と、PostgreSQL で確認された動作
• Scenario：シードデータ、操作、期待される結果、実際の結果を含む再現手順（順序付き）
• Root Cause：不具合の原因となる Oracle と PostgreSQL の具体的な動作の違い
• Solution：実施した、または必要な変更と、明示的なファイルパス
• Validation：両方のデータベースで修正を確認する手順

Oracle から PostgreSQL への移行に関するガイダンス

• Oracle を正とします — Oracle のベースラインに基づいて期待される動作を示します
• データ層の違いを明確に記載します：空文字列と NULL、型変換の厳密さ、照合順序、シーケンス値、タイムゾーン、パディング、制約
• クライアントコードの変更は、正しい動作に必要な場合を除き避けてください。変更を提案する場合は、内容を明確に記載し、理由を説明してください

文体

• 平易な言葉を使い、短い文で、次に行うことを明確にします
• 現在形または過去形を一貫して使います
• 手順と検証には箇条書きと番号付きリストを使用します
• 根拠として必要最小限の SQL 抜粋やログを示します。機密データは省き、再現可能なスニペットを使用します
• 既存のランタイムと言語のバージョンに従い、推測に基づく修正は避けます

ファイル名の規則

バグレポートは .github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md に保存します。ここで：

• {ProjectName} は、プロジェクトのアセンブリ名またはフォルダー名です。スペースは - に置き換えます（例：MyApp.DataAccess）
• <DescriptiveSlug> は、不具合の内容を表す短い PascalCase の識別子です（例：EmptyStringNullHandling、RefCursorUnwrapFailure）