aria-identity-architecture

name	aria-identity-architecture
description	ARIA の識別子ヒエラルキー（JCN/EDINET Code/証券コード）の設計思想と、コード変更シナリオへの対応戦略。

ARIA 識別子アーキテクチャ (Identity Architecture)

ARIA が「企業の同一性」をどのように追跡・保証するかを定義するスキル。

1. 3層識別子ヒエラルキー

層	識別子	安定性	管轄	ARIA での役割
🔒	EDINET Code	準静的	金融庁	真の主キー。物理パス分散（bin=EXX）およびデータ統合の軸
⚠️	国籍付証券コード	動的	JPX	JP:37780 形式。グローバル展開とサブ検索用
🔍	JCN (法人番号)	完全不変	国税庁	最終フォールバック用検索属性

設計原則: 下位の識別子が変更されても、上位の識別子で企業の一貫性を保証する。また、将来のグローバル展開を見据え、証券コードは常に「国籍プレフィックス」を伴う。

1. Identity Bridging (証券コードと EDINET コードの架け橋)

• 原則: EDINET コードリストを主軸とし、JPX 証券コードを Bridge Fill 処理で紐付ける。
• 名寄せキー: edinet_code.fillna(code) を identity_key として使用し、物理的なレコード統合を強制する。詳細は stock-master-reconciler を参照。

2. コード変更シナリオと ARIA の対応

シナリオ	JCN	EDINET Code	証券コード	ARIA の対応
商号変更	不変	不変	不変	stocks_master の company_name を更新。
本店移転	不変	不変	不変	stocks_master の address を更新。
合併 (吸収)	存続会社	存続会社	存続会社	消滅会社の is_disappeared を True に設定。
コード集約	不変	変更	不変	ESE140190.csv を用い、廃止される旧コードを継続コードの former_edinet_codes へ逆方向に追記（マージ）し、現在の識別子を保護。

---

3. 証券コードの正規化と不変性

• 5 桁正規化 & 国籍プレフィックス: 4 桁コードには末尾に 0 を付与し、さらに国籍プレフィックス（例: JP:）を強制付与する。
• 不変性の原理: 一度付与された 5 桁コードは、企業の属性変化に関わらず、ARIA 内での不変の物理キーとして機能する。
• プレフィックス耐性 (Prefix Tolerance): 既存のプレフィックスなしコードとの前方互換性を保つため、CatalogManager はプレフィックスを無視した「コア・マッチング」をフォールバックとして備える。

---

4. Master Data Integrity Laws (マスタデータの 5 鉄則)

ARIA は、以下の「工学的主権」に基づき、マスタデータの整合性を死守します。

1. EDINET SSOT: 同一銘柄は EDINET データを正とし、JPX 側の重複普通株は破棄。
2. JPX 補完: ETF/REIT/PRO 銘柄は JPX 由来を正として受容。
3. Identity Bridging: grouping 直前に証券コードから EDINET コードを逆引き補完。
4. Existence Immutability: 消えた銘柄は is_disappeared=True とし、物理削除しない。
5. Normalize First: 常にプレフィックス付 5 桁コードでマッチングを行う。

詳細は stock-master-reconciler を参照。