# Issue Register

## Prioritized Issues

| ID | Priority | Area | Finding | Evidence | Impact | Recommended Action |
|---|---|---|---|---|---|---|
| ARCH-001 | P0 | flake / deployment | 本流 `node01/02/03` が欠損 `docs/.../configuration.nix` を参照 | `flake.nix:486,498,510` / `nix eval .#nixosConfigurations.node01...` 失敗 | 本流デプロイ経路が評価時点で停止 | 参照先を復元 or `baremetal/*` 等の現存モジュールへ切替 |
| ARCH-002 | P0 | ISO install | ISO 自動インストールが欠損 `docs/.../disko.nix` 依存 | `nix/iso/ultracloud-iso.nix:236` | 自動インストール実行不能 | ISO の disko 参照を実在パスに差し替え |
| ARCH-003 | P0 | bootstrap | `deployer.local` phone-home 前提だが Nix 配線なし（鶏卵） | `nix/iso/ultracloud-iso.nix:48,90` / `rg deployer flake.nix` no match / `.github/workflows/nix.yml:49` | ゼロから起動手順が閉じない | Deployer の Nix package/module/nixosConfiguration を追加し、起動順を明文化 |
| TC-001 | P1 | test-cluster | `node02/03` で `services.chainfire.joinAddr` option 不存在 | `nix/test-cluster/node02.nix:33`, `node03.nix:33`, `nix/modules/chainfire.nix` | テストクラスタ評価失敗 | `joinAddr` を廃止し `initialPeers` 等へ統一 |
| TC-002 | P1 | test-cluster | `node06` が `creditservice` 有効化時に `config.services.flaredb` 欠落 | `nix/modules/creditservice.nix:5` / `nix/test-cluster/node06.nix:8-13` / `nix eval ...node06...` 失敗 | gateway node 評価不能 | `creditservice` module を optional 化し flaredb 非存在時 fallback |
| ARCH-004 | P1 | first-boot | `leader_url` が `https://...:2379`、join は REST `/admin/member/add`（HTTP 側） | `nix/modules/first-boot-automation.nix:46,148,259` / `nix/modules/ultracloud-cluster.nix:63` / `chainfire/.../rest.rs:143` / `chainfire/.../server.rs:175-178` | first-boot join 失敗の高リスク | `leader_url` を `http://<admin_http_addr>` 契約へ改定 |
| ARCH-005 | P1 | first-boot / flaredb | first-boot が FlareDB `/admin/member/add` を叩くが実装なし | `nix/modules/first-boot-automation.nix:270` / `flaredb/.../rest.rs:149-157` | FlareDB join 自動化が成立しない | FlareDB に join API 追加 or first-boot ロジック改修 |
| COMP-001 | P1 | config contract | PrismNet module `IAM_ENDPOINT` は binary で未消費 | `nix/modules/prismnet.nix:105` / `prismnet/.../config.rs:83-89` / `prismnet/.../main.rs:215-222` | IAM 接続先が意図どおり反映されない | module 側キーを binary 契約（`PRISMNET__AUTH__...` か CLI）へ統一 |
| COMP-002 | P1 | config contract | PlasmaVMC module `IAM_ENDPOINT` は binary で未消費 | `nix/modules/plasmavmc.nix:97` / `plasmavmc/.../config.rs:54-61` / `plasmavmc/.../main.rs:137-141` | 同上 | 同上 |
| COMP-003 | P1 | config contract | FiberLB/LightningStor の `*_IAM_ADDR` は binary で未消費 | `nix/modules/fiberlb.nix:123`, `lightningstor.nix:128` / 各 `config.rs` 既定 50051 | IAM 接続ミス | CLI arg or config file 生成を module に追加 |
| COMP-004 | P1 | config contract | CreditService module が IAM addr を注入せず default 50051 に依存 | `nix/modules/creditservice.nix:80-96` / `creditservice/.../main.rs:61` | IAM 実配置 (50080) と不一致 | `iamAddr` option と `CREDITSERVICE_IAM_ADDR` 注入を追加 |
| COMP-005 | P2 | config contract | `FIBERLB_PRISMNET_ADDR`, `PRISMNET_ENDPOINT`(flashdns), `FLAREDB_IAM_ENDPOINT` 未消費 | `nix/modules/fiberlb.nix:127`, `flashdns.nix:111`, `flaredb.nix:108` | 運用者に誤解を与える死設定 | 未使用設定を削除 or binary 実装追加 |
| ARCH-006 | P2 | architecture | `cluster-config` 生成ロジックが二重実装 | `ultracloud-cluster.nix:49-91` / `nix-nos/topology.nix:91-136` | ドリフトリスク | 片方を正本化して他方を委譲 |
| QLT-001 | P2 | quality | 多数 package で `doCheck = false` | `flake.nix:206,240,263,276,290,306,329,345` | 回帰検知が弱い | 失敗テストの原因別 backlog を切り出し段階的復帰 |

## Suggested Remediation Order

1. `ARCH-001`, `ARCH-002`, `ARCH-003` を先に潰し、デプロイ経路を閉じる。  
2. `TC-001`, `TC-002` を修正し、検証クラスタを安定化する。  
3. `ARCH-004`, `ARCH-005`, `COMP-001` 〜 `COMP-004` で設定契約を一致させる。  
4. `ARCH-006`, `COMP-005`, `QLT-001` を継続改善タスク化する。

