PART 02 — ファイルレイアウト定義書
CSV・固定長・XML ファイル連携の完全仕様

■ ファイル基本仕様
ファイル名  : SALES_YYYYMMDD.csv（例: SALES_20260618.csv）
文字コード  : UTF-8（BOMなし）
改行コード  : LF
区切り文字  : カンマ（,）
囲み文字    : ダブルクォーテーション（"）フィールドに , や改行を含む場合のみ
ヘッダー    : あり（1行目）
トレーラー  : あり（最終行、"TOTAL",件数,合計金額）

■ レコード定義（データ行）
No | ヘッダー名    | 論理名     | 型     | 桁数 | 必須 | フォーマット      | 備考
---|--------------|-----------|--------|------|------|-----------------|------------------
1  | order_id     | 注文ID     | 数値   | 19   | ○    | 整数              |
2  | order_date   | 注文日     | 文字列 | 10   | ○    | YYYY-MM-DD       | UTCではなくJST日付
3  | product_code | 商品コード  | 文字列 | 20   | ○    | 英数字+ハイフン   |
4  | quantity     | 数量       | 数値   | 5    | ○    | 整数 1以上        |
5  | unit_price   | 単価       | 数値   | 12   | ○    | 整数（円）税抜き  |
6  | total_amount | 合計金額   | 数値   | 12   | ○    | 整数（円）税込み  |
7  | customer_name| 顧客名     | 文字列 | 100  | ○    | 自由文字列        | 全角可

■ サンプルデータ
order_id,order_date,product_code,quantity,unit_price,total_amount,customer_name
12345,2026-06-18,PROD-001,2,5000,11000,山田太郎
12346,2026-06-18,PROD-002,1,3000,3300,田中花子
TOTAL,2,14300

■ ファイル基本仕様
ファイル名  : PRODUCT_MASTER.dat
文字コード  : Shift_JIS
改行コード  : CRLF
レコード長  : 200バイト固定

■ レコード定義
開始バイト | バイト数 | 論理名     | 型     | 詰め  | 説明
----------|---------|-----------|--------|------|----------------------------------
1         | 10      | 商品コード  | 英数字 | 右空白 | 半角英数字+ハイフン
11        | 60      | 商品名     | 文字列 | 右空白 | 全角文字は2バイトカウント
71        | 10      | 単価       | 数値   | 左ゼロ | 整数（円）
81        | 5       | 在庫数     | 数値   | 左ゼロ | 整数
86        | 1       | 販売フラグ  | コード | —     | "1"=販売中 "0"=販売停止
87        | 8       | 更新日     | 日付   | —     | YYYYMMDD 形式
95        | 106     | 予備       | 空白   | 空白   | 将来拡張用

■ サンプルデータ（16進で確認のこと）
PROD-001  山田商事特製　高品質ノート       0000050000010020260618

"""
連携 CSV ファイルのレイアウト・データバリデーション
"""
import csv, re
from pathlib import Path
from datetime import datetime

LAYOUT = [
    {"name": "order_id",     "required": True,  "type": "int",  "max_len": 19},
    {"name": "order_date",   "required": True,  "type": "date", "format": "%Y-%m-%d"},
    {"name": "product_code", "required": True,  "type": "str",  "pattern": r"^[A-Z0-9\-]{1,20}$"},
    {"name": "quantity",     "required": True,  "type": "int",  "min": 1},
    {"name": "unit_price",   "required": True,  "type": "int",  "min": 0},
    {"name": "total_amount", "required": True,  "type": "int",  "min": 0},
    {"name": "customer_name","required": True,  "type": "str",  "max_len": 100},
]

def validate_value(val: str, rule: dict) -> str | None:
    if rule["required"] and not val.strip():
        return f"必須項目が空白"
    if not val.strip():
        return None
    if rule["type"] == "int":
        if not val.isdigit():
            return "整数でない"
        v = int(val)
        if "min" in rule and v < rule["min"]:
            return f"{rule['min']}以上が必要"
        if "max_len" in rule and len(val) > rule["max_len"]:
            return f"{rule['max_len']}桁超過"
    elif rule["type"] == "date":
        try:
            datetime.strptime(val, rule["format"])
        except ValueError:
            return f"日付フォーマット {rule['format']} 不正"
    elif rule["type"] == "str":
        if "max_len" in rule and len(val.encode("utf-8")) > rule["max_len"] * 3:
            return f"文字列長超過"
        if "pattern" in rule and not re.match(rule["pattern"], val):
            return f"フォーマット不正: {rule['pattern']}"
    return None

def validate_csv(filepath: str) -> list[dict]:
    errors = []
    with open(filepath, encoding="utf-8") as f:
        reader = csv.DictReader(f)
        for row_num, row in enumerate(reader, start=2):
            if list(row.keys())[0] == "TOTAL":
                continue
            for rule in LAYOUT:
                val = row.get(rule["name"], "")
                err = validate_value(val, rule)
                if err:
                    errors.append({"row": row_num, "field": rule["name"], "error": err, "value": val})
    return errors

errors = validate_csv("SALES_20260618.csv")
if errors:
    print(f"❌ バリデーションエラー {len(errors)} 件:")
    for e in errors:
        print(f"  行{e['row']:4d} [{e['field']}] {e['error']} (値: '{e['value']}')")
else:
    print("✅ バリデーション OK")