majiayu000 XBRL パース・エキスパート (XBRL Parser Expert)
ARIAにおけるEDINETからのXBRL/Inline XBRLデータの抽出と解析を、「事実基底」かつ完全に決定論的な手法で処理するための専門スキルおよび規範です。
1. タクソノミの絶対的特定手法 (Facts over Prediction)
金融庁の「～以後に終了する事業年度に係る書類から適用」といった文章表現に対し、システムが日付計算による「タクソノミバージョンの推測」を行うことは厳禁です。
XBRL仕様およびEDINET「報告書インスタンス作成ガイドライン」に基づき、パーサーはファイル内に物理的に宣言された名前空間（Namespace）または schemaRef のみに依存してロードする辞書（タクソノミ）を決定しなければなりません。
- 取得前判別: EDINET API v2 のレスポンスフィールド
periodEnd（対象期間終了日）を用いて使用タクソノミ群をフィルタリングする。 - 解析時判別:
<xbrli:xbrl>または<html>要素のxmlns:jppfs等の名前空間URI（例:http://disclosure.edinet-fsa.go.jp/taxonomy/jppfs/2020-03-31/...）を正規表現等で抽出し、ロードすべきタクソノミバージョンを確定的に解決する。
2. NULL 基底アーキテクチャ (NULL Base Architecture)
XBRLデータ構造は企業によって大きく拡張（提出者別タクソノミ）されるため、特定のタグ（例: jppfs_cor:NetSales）が存在しない場合があります。
- 要素が見つからない場合、決して
0や-1や""（空文字）などのSentinel Value（番兵値）で埋めず、必ずNone(NULL) を返すこと。 0件の結果と要素なしは、財務・監査上、全く異なる意味を持ちます。「異常なゼロ」を発生させないため、欠落は欠落として扱います。
3. フェイルファスト (Fail-Fast Parsing)
- スキーマのURIと、処理対象のタクソノミ辞書のバージョンが不一致の場合、推し量ってパースを続行せず、例外（例:
TaxonomyVersionMismatchError）を発生させて直ちに停止すること。 - メタデータ（
periodEnd等）と、パースしたXBRL内のCurrentPeriodEndDateDEIが矛盾する場合、データの誠実性が担保できないため、警告を記録し処理を停止（または隔離キューへ移動）すること。
4. リソースエコノミー (API & Memory Economy)
大量の有価証券報告書のXBRL（数十MB単位のファイルが数千件）を処理するため、以下の制限を順守します。
- メモリ上の巨大なDOMツリー構築（
xml.etree全体ロードなど）を避け、可能な限り SAX やlxmlのiterparseを使用したストリーミングパースを検討すること。 - 頻出するタクソノミ辞書（xsd/xml）ファイルは、実行ごとに再読み込みせず、メモリ（または高速なKVS等）にキャッシングし、IOアクセスを最小化すること。
5. ドキュメント不可知性 (Document Agnostic Parsing)
XBRLデータは、有価証券報告書だけでなく、四半期報告書、半期報告書、臨時報告書など様々な開示書類に添付されます。
- 書類を分類・フィルタリングする際は、特定の
formCodeやordinanceCodeのホワイトリスト（ハードコード）に依存してはならず、EDINET APIのxbrlFlag == 1を第一の物理的事実として優先すること。 - XBRLZIP展開時に、ファイル名に
"asr"(Annual Securities Report) などの特定書類を示す文字列が含まれることを前提とするロジックは厳禁です。XBRLファイルは必ずPublicDocフォルダ配下に.xbrlまたは.xsdとして存在するというディレクトリ構造そのものの「事実」を抽出条件とすること。