# Aria Identity Architecture

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

- Skill: `majiayu000/aria-identity-architecture` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/aria-identity-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/aria-identity-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/aria-identity-architecture

---

# 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](file:///Users/yoshi_dai/repos/ARIA/.agent/skills/stock-master-reconciler/SKILL.md) を参照。

## 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](file:///Users/yoshi_dai/repos/ARIA/.agent/skills/stock-master-reconciler/SKILL.md) を参照。