コイン収集計画の手法
いつ使用するか
- ユーザーがNumistaのCSVエクスポートをアップロードし、ギャップ分析を希望する場合
- ユーザーが「[シリーズ名]で何が足りないか」と尋ねる場合
- ユーザーが新しいシリーズを始めたい、完全なリストが必要な場合
- ユーザーがコインフェアの買い物リストや購入優先順位を尋ねる場合
- ユーザーが既存のコレクションパターンに基づいてシリーズの提案を希望する場合
ステップ1: Numistaエクスポートの解析
重要なCSV列:
Country, Issuer, Ruling authority, Title, Type, Face value,
Reference, N# number, Gregorian year, Mintmark, Composition,
Grade, Collection, Comment
主要な解析パターン:
デザイン名抽出 — 名前は肖像情報の後の括弧内にあります:
import re
m = re.search(r'\((.*?)\)', title)
design_name = m.group(1) if m else title
複数肖像シリーズ（英国）の場合 — 肖像プレフィックスを除去:
m = re.search(r'portrait;\s*(.+?)\)', title)
非流通貨のフィルタリング（収集家が銀貨/金貨プルーフを除外する場合）:
if 'silver' in comp.lower() and 'clad' not in comp.lower():
continue # 純銀をスキップ
重複排除（デザイン、年、造幣局） — 同じデザイン+年+造幣局は1エントリとしてカウントを追跡します。
ステップ2: シリーズマスターリストの構築
調査ソース（信頼性順）:
- Numistaカタログページ — KM#、日付、組成において信頼性が高い
- ウェブ検索 シリーズ概要（PCGS、NGC記事、中国向け百度百科）
- ユーザーのNumistaエクスポートのN#番号と既知のシリーズの相互参照
収集パターンからのシリーズ識別:
Typeフィールドを確認: 「Circulating commemorative」 vs 「Standard circulation」- 額面と組成でグループ化してシリーズを特定
- 連続するシーケンスの年範囲を確認（ギャップ = 不足しているコイン）
一般的なシリーズ構造:
| 国 | シリーズ | 額面 | フォーマット | 年 |
|---|---|---|---|---|
| 米国 | 50州クォーター | 25c | Cu-Niクラッド | 1999-2008 |
| 米国 | DC及び準州 | 25c | Cu-Niクラッド | 2009 |
| 米国 | America the Beautiful | 25c | Cu-Niクラッド | 2010-2021 |
| 米国 | American Women | 25c | Cu-Niクラッド | 2022-2025 |
| 英国 | ラウンドポンドエンブレム | £1 | Ni-黄銅 | 1983-2015 |
| 英国 | 12角ポンド | £1 | バイメタル | 2016年以降 |
| 中国 | 十二生肖（Lunar Zodiac） | 10元 | バイメタル | 2015-2026 |
| 中国 | 世界文化遺産 | 5元 | 黄銅 | 2002-2006 |
| 中国 | 世界遺産の山々 | 5元 | 黄銅（正方形） | 2019年以降 |
| 中国 | 京劇 | 5元 | 黄銅 | 2023-2027 |
| 中国 | 国立公園 | 10元 | バイメタル | 2023年以降 |
| 中国 | 書道「和」 | 5元 | 黄銅 | 2013-2022 |
| 中国 | 台湾名所 | 5元 | 黄銅 | 2003-2005 |
| 中国 | レッドブック動物 | 5元 | 銅 | 1995-1998 |
| インド | 藩王国 | 各種 | 各種 | 各種 |
ステップ3: ギャップ分析
収集済みセットの構築:
collected = {} # (design_name, year) -> set of mints or count
マスターリストとの相互参照:
for year, name in master_list:
if (name, year) in collected:
status = "HAVE"
else:
status = "NEED"
造幣局バリアントシリーズ（米国クォーター）の場合:
PとDを別々に追跡します。両方を列として表示 — 収集済みは太字、未収集は薄いグレー。
単一バリアントシリーズ（英国ポンド、中国）の場合:
単純なチェック/未チェックボックス。
ステップ4: 新しいシリーズの提案
ユーザーが「他に何を収集すべきか」と尋ねた場合、以下のフィルターを適用:
互換性基準:
- 既存のコレクションと同じ額面/フォーマット（ユーザーが5元黄銅を収集している場合、他の5元黄銅シリーズを提案）
- 同じ価格帯 — 流通記念硬貨、プルーフや地金ではない
- 完結可能 — 既知の総数を持つ有限シリーズ
- 入手可能性 — コインがディーラーから妥当な価格でまだ入手可能
- テーマの一致 — 収集家の表明した興味（以下の収集家プロファイルを参照）
提案の優先順位:
- 高: 同じフォーマット、同じ国、20コイン未満、安価、入手可能
- 中: 同じ国、異なるフォーマットだが手頃
- 低: 異なる国だがテーマが一致
ステップ5: 買い物リスト
コインフェア向け:
- 地理的に優先順位付け（地元のフェアは地元および地域のコインを最も良く扱う、例：南インドのフェアは南インド藩王国に最適）
- 優先度でグループ化: 高（おそらく存在）、中（ディーラーに尋ねる）、専門（専門ディーラーのみ）
- ディーラーが認識する具体的な額面名を含める
- フェアでチェックするための空のチェックボックスを追加
オンライン購入向け:
- どのコインが一般的な流通貨（安価）で、どのコインが記念硬貨（プレミアム）かを注記
- 希少または収集家需要の高いコインにフラグを立てる
ステップ6: 出力
バインダー対応PDF用にa5-coinスキルを使用するか、デジタル追跡用にopenpyxlを使用してExcelで出力を生成します。
Excel出力列:
S.No, 正式名称, 年, 額面, 現在の州/国, 地域, 英国時代（インド用）, コレクションにあるか?, 所有コイン数, 優先順位
PDF出力:
a5-coinスキルを使用 — Carlitoフォント、グレースケール、6穴パンチ、連続フローレイアウト。
収集家プロファイル（自分の情報を記入）
このセクションは短く保ち、コレクションの変更に応じて更新してください。スキルは提案や買い物リストにこれを使用します。
- Numistaユーザー名: <あなたのハンドル>
- おおよそのコレクションサイズ: <数>
- アクティブなサブコレクション: <例：英国ラウンドポンド、中国十二生肖、米国クォーター>
- 印刷: <カラー/グレースケール>, バインダー: <A5 Filofax / その他>
- 自宅の都市（コインフェアリスト用）: <都市>
- 除外: <例：銀貨/金貨プルーフなし>
既知のギャップ（日付）
- <シリーズ>: <所持数>/<合計>, 不足している <リスト>