PART 03 — データ項目定義書
業務データ項目の論理定義・コード体系を定める

ID     | 業務名       | 物理名        | 型          | 桁   | フォーマット    | 説明
-------|-------------|--------------|-------------|------|----------------|----------------------------------
DI-001 | 注文ID       | order_id     | 数値(整数)  | 19   | —              | システム内部の注文一意識別子
DI-002 | 注文番号     | order_no     | 文字列      | 15   | ORD-YYYYMMDD-NNNNN | 顧客向けの注文番号。人が読む用
DI-003 | 注文日       | order_date   | 日付        | —    | YYYY-MM-DD     | 注文が確定した業務上の日付
DI-004 | 注文ステータス| status       | コード      | 2    | コードで定義    | 注文の現在状態（後述）
DI-005 | 合計金額     | total_amount | 数値(実数)  | 12,2 | —              | 税込み合計金額（日本円）
DI-006 | ユーザーID   | user_id      | 数値(整数)  | 19   | —              | ユーザーマスタの外部キー
DI-007 | メールアドレス| email        | 文字列      | 255  | RFC5321        | 通知・ログイン用メールアドレス

"""
PostgreSQL からデータ項目定義書の CSV 雛形を生成する
pip install psycopg2-binary
"""
import csv, psycopg2

DSN = "host=localhost dbname=myapp user=postgres password=secret"

QUERY = """
SELECT
    c.table_name,
    c.column_name,
    c.data_type,
    COALESCE(c.character_maximum_length::text,
             c.numeric_precision::text, '') AS "length",
    c.is_nullable,
    c.column_default,
    pgd.description
FROM information_schema.columns c
LEFT JOIN pg_catalog.pg_statio_all_tables st
    ON st.schemaname = c.table_schema AND st.relname = c.table_name
LEFT JOIN pg_catalog.pg_description pgd
    ON pgd.objoid = st.relid AND pgd.objsubid = c.ordinal_position
WHERE c.table_schema = 'public'
ORDER BY c.table_name, c.ordinal_position
"""

conn = psycopg2.connect(DSN)
with conn.cursor() as cur:
    cur.execute(QUERY)
    rows = cur.fetchall()

with open("data_items_draft.csv", "w", newline="", encoding="utf-8-sig") as f:
    w = csv.writer(f)
    w.writerow(["項目ID", "テーブル", "物理名", "データ型", "桁数", "NULL可否",
                "デフォルト", "コメント（業務名として活用）"])
    for i, row in enumerate(rows, 1):
        w.writerow([f"DI-{i:04d}", *row])

conn.close()
print(f"✅ data_items_draft.csv に {len(rows)} 項目を出力しました")
print("  → コメント列を業務名として編集し、データ項目定義書を完成させてください")