アーキテクチャ設計 (Architecture)

研究室 PC（原本・目録）                         計算サーバ（Newton・Archimedes）
┌──────────────────────────────┐               ┌──────────────────────────────┐
│ 取り込み元（原本．読むだけ）   │               │ ~/data/tiasdata/<名前>/v<版>/  │
│   clinical-data/TIASJudgeModel │               │   manifest.csv・dataset.json   │
│        │ tiasdata import       │               │   files/<sha256>.<拡張子>      │
│        ▼                       │  tiasdata     │        ▲                       │
│ 目録 catalog.sqlite            │  deliver      │        │ tiasdata.load()      │
│ ストア store/<sha256>          │ ────────────▶ │ 使う側（TIASJudgeModel 等）    │
│ バンドル bundles/<名前>/v<版>/ │  （直送）     └──────────────────────────────┘
└──────────────────────────────┘
        ▲ ssh labpc "tiasdata ..."（手元 PC から操作．ENV_02）

TIASDataHub/
├── src/tiasdata/
│   ├── config.py          # 設定ファイルの読み込み・検証（pydantic）
│   ├── catalog/           # 目録（SQLite）の接続・マイグレーション・各表の操作
│   │   └── migrations/    # スキーマ変更の SQL（catalog/・identity/ の 2 系列．NNNN_<内容>.sql）
│   ├── store.py           # ストア（ハッシュの計算・コピー・検証）
│   ├── kinds/             # ファイルの種類・所見の種類の定義（値の検証用の型）
│   ├── importers/         # 取り込み元ごとの読み取り（例: 舌色の 9 フォルダ）
│   ├── manifest.py        # manifest.csv の生成（純関数．catalog に依存しない）
│   ├── repo.py            # リポジトリのルートと git の状態
│   ├── datasets.py        # データセットの定義の評価・版の作成
│   ├── bundle.py          # バンドルの書き出し・読み込み・検証
│   ├── deliver.py         # 計算サーバへの受け渡し
│   └── cli.py             # エントリポイント
├── datasets/              # データセットの定義（TOML）
├── holds/                 # 取り込み元ごとの保留リスト（TOML．SPEC_03「保留リスト」）
├── tests/                 # ダミーデータのみで動くテスト
└── docs/

E:\clinical-data\
├── TIASJudgeModel\            # 取り込み元（原本．基盤は読むだけで変更しない）
├── TongueSegmentation\        # 取り込み元（原本）
├── DeepTIAS_TIASJudgeModel\   # 取り込み元（舌色データセットの DeepTIAS 出力．番号ごと）
├── DeepTIAS後_ID_番号.xlsx    # 画像の番号 → 患者 ID・何枚目の対応表（取り込みで読む）
├── tiasdata\                  # 基盤のデータ（catalog.root）
│   ├── catalog.sqlite         # 目録
│   ├── store\                 # ストア（store\<先頭 2 文字>\<sha256>.<拡張子>）
│   ├── bundles\               # 書き出したバンドル（受け渡し後は削除してよい．再生成できる）
│   └── backups\               # 目録のバックアップ
└── tiasdata-identity\         # 対応表（identity.sqlite）．目録とは別のフォルダ

[catalog]
root = "E:/clinical-data/tiasdata"                     # catalog.sqlite・store/・bundles/・backups/
identity = "E:/clinical-data/tiasdata-identity/identity.sqlite"

[sources.tiasjudgemodel]                                            # 取り込み元（名前で指定する）
path = "E:/clinical-data/TIASJudgeModel"
importer = "tongue_color_folders"
patient_map = "E:/clinical-data/DeepTIAS後_ID_番号.xlsx"  # 画像の番号 → 患者 ID・何枚目（患者 ID は identity.sqlite にだけ入れる）

[servers.newton]                                                    # 受け渡し先
host = "hasegawa@192.168.23.14"
key = "C:/Users/Papin/.ssh/id_ed25519_newton"
root = "~/data/tiasdata"

[servers.archimedes]
host = "hasegawa@192.168.23.15"
key = "C:/Users/Papin/.ssh/id_ed25519_newton"
root = "~/data/tiasdata"