PART 02 — 画面詳細設計書
入出力項目・バリデーション・イベント処理の定義

■ 単項目バリデーション

  [user_name] ユーザー名
    VAL-001: 必須チェック → "ユーザー名は必須です"
    VAL-002: 文字数 1〜50文字 → "ユーザー名は1〜50文字で入力してください"
    VAL-003: 使用可文字 半角英数字・アンダースコア・ハイフン
             正規表現: ^[a-zA-Z0-9_\-]+$
             エラー: "ユーザー名は英数字・アンダースコア・ハイフンのみ使用できます"
    VAL-004: 重複チェック（DB照合）users.username と重複禁止
             エラー: "このユーザー名はすでに使用されています"

  [email] メールアドレス
    VAL-010: 必須チェック → "メールアドレスは必須です"
    VAL-011: フォーマットチェック
             正規表現: ^[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}$
             エラー: "メールアドレスの形式が正しくありません"
    VAL-012: 重複チェック users.email と重複禁止
             エラー: "このメールアドレスはすでに登録されています"

  [password] パスワード
    VAL-020: 必須チェック
    VAL-021: 文字数 8〜72文字
             エラー: "パスワードは8〜72文字で入力してください"
    VAL-022: 複雑性 大文字・小文字・数字・記号を各1文字以上含む
             エラー: "パスワードは大文字・小文字・数字・記号を含む必要があります"

  [birth_date] 生年月日
    VAL-030: 日付形式チェック YYYY-MM-DD
    VAL-031: 範囲チェック 1900-01-01 以降・今日以前
             エラー: "正しい生年月日を入力してください"

■ 相関バリデーション

  COR-001: [password] と [password_confirm] が一致すること
           エラー: "パスワードが一致しません"

  COR-002: [start_date] ≤ [end_date] であること（期間指定の場合）
           エラー: "終了日は開始日以降を指定してください"

  COR-003: [payment_method]=クレジットカードのとき [card_number] は必須
           エラー: "クレジットカード番号を入力してください"

■ 表示/非表示制御

  [corporate_section]（法人情報欄）
    表示条件: [member_type] = "法人"（member_type=02）
    非表示時: DOM から削除（display:none）ではなく hidden 属性を使用

  [admin_note]（管理者備考欄）
    表示条件: ログインユーザーのロールが ADMIN or SUPER_ADMIN
    非表示時: レンダリング自体しない（サーバーサイドで制御）

■ 活性/非活性制御

  [submit_button]（登録ボタン）
    非活性条件: 必須項目（VAL-001, VAL-010, VAL-020）のいずれかが未入力
    活性化タイミング: 必須項目の全入力確認時（onBlur ごとにチェック）

  [city]（市区町村セレクト）
    初期状態: 非活性（disabled）
    活性化タイミング: [prefecture] が選択されたとき（EVT-003 完了後）

■ 初期表示データ取得

  [user_id]         : URLパラメータから取得（/screen/edit?id={user_id}）
  [prefecture]      : マスターAPI（GET /api/prefectures）で取得・キャッシュ（1時間）
  [created_at]      : 編集モード時のみ表示。API（GET /api/members/{id}）から取得

"""
HTMLファイルまたはURLからフォーム要素を抽出し、
画面詳細設計書の「入力項目定義」草稿をCSVで出力するスクリプト
"""
from bs4 import BeautifulSoup
import requests
import csv
import sys

def extract_form_elements(html: str) -> list[dict]:
    """フォーム要素を抽出して属性情報を辞書リストで返す"""
    soup = BeautifulSoup(html, "lxml")
    rows = []

    # input, select, textarea を対象
    targets = soup.find_all(["input", "select", "textarea"])

    for el in targets:
        tag = el.name
        input_type = el.get("type", "text") if tag == "input" else tag
        name = el.get("name", el.get("id", "（名前なし）"))
        label_el = soup.find("label", attrs={"for": el.get("id", "")})
        label_text = label_el.get_text(strip=True) if label_el else ""

        # バリデーション属性を収集
        validations = []
        if el.get("required") is not None:
            validations.append("必須")
        maxlen = el.get("maxlength") or el.get("max")
        minlen = el.get("minlength") or el.get("min")
        if maxlen:
            validations.append(f"最大{maxlen}")
        if minlen:
            validations.append(f"最小{minlen}")
        pattern = el.get("pattern")
        if pattern:
            validations.append(f"pattern={pattern}")

        # セレクトの選択肢を抽出
        options = ""
        if tag == "select":
            opts = el.find_all("option")
            options = " / ".join(
                f"{o.get('value','')}:{o.get_text(strip=True)}"
                for o in opts if o.get("value")
            )

        rows.append({
            "項目ID":       name,
            "論理名":       label_text,
            "UI種別":       input_type,
            "必須":         "◎" if "必須" in validations else "○",
            "桁数/範囲":   f"{minlen}〜{maxlen}" if (minlen or maxlen) else "",
            "パターン":     pattern or "",
            "選択肢":       options,
            "初期値":       el.get("value", el.get("placeholder", "")),
            "その他属性":   " ".join(validations),
        })

    return rows


def main(source: str) -> None:
    # URLかファイルパスを判定
    if source.startswith("http"):
        resp = requests.get(source, timeout=10)
        resp.encoding = resp.apparent_encoding
        html = resp.text
    else:
        with open(source, encoding="utf-8") as f:
            html = f.read()

    rows = extract_form_elements(html)

    out_path = "screen_input_items.csv"
    fieldnames = ["項目ID","論理名","UI種別","必須","桁数/範囲","パターン","選択肢","初期値","その他属性"]
    with open(out_path, "w", newline="", encoding="utf-8-sig") as f:
        writer = csv.DictWriter(f, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(rows)

    print(f"{len(rows)} 件の入力項目を {out_path} に出力しました。")


# ── 実行 ───────────────────────────────────────────────────
if __name__ == "__main__":
    # 引数なしの場合はサンプルHTMLで動作確認
    if len(sys.argv) < 2:
        sample = """
        <form>
          <label for="email">メールアドレス</label>
          <input id="email" name="email" type="email" required maxlength="100"
                 pattern="[a-zA-Z0-9._%+\\-]+@[a-zA-Z0-9.\\-]+\\.[a-zA-Z]{2,}" />
          <label for="age">年齢</label>
          <input id="age" name="age" type="number" min="18" max="120" />
          <label for="pref">都道府県</label>
          <select id="pref" name="prefecture" required>
            <option value="">選択してください</option>
            <option value="13">東京都</option>
            <option value="27">大阪府</option>
          </select>
        </form>
        """
        rows = extract_form_elements(sample)
        for r in rows:
            print(r)
    else:
        main(sys.argv[1])