# sssan-00/php-to-csharp-migration-harness architecture

> Architecture diagram of the GitHub repository sssan-00/php-to-csharp-migration-harness, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sssan-00/php-to-csharp-migration-harness
- Repository: https://github.com/sssan-00/php-to-csharp-migration-harness

## Overview

これは、Junie CLIを使ってPHPからC#／Razor Pagesへの移行を管理するローカル実行ハーネスです。利用者は設定して移行単位を準備し、Runでカプセルごとの移行と対象ファイルの反映を進め、ビルド・チェッカーで検証します。Run記録を使って再開でき、ダッシュボードから複数Runを操作できます。Diff Viewerとアンカーで対応行をレビューする機能もあります。矢印はREADMEの説明と提示されたソース範囲・索引で確認できる関係に限定しました。

Main entry points: [`src/migration_harness/workflow.py`](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/workflow.py) (移行ワークフロー), [`src/migration_harness/dashboard.py`](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/dashboard.py) (ダッシュボード), [`src/migration_harness/run_manager.py`](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/run_manager.py) (Run管理), [`src/migration_harness/junie_cli.py`](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/junie_cli.py) (Junie連携)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["操作・設定"]
  node_cli["CLI<br/>[cli.py]"]
  node_dashboard["ダッシュボード<br/>[dashboard.py]"]
  node_dashboard_ui["ダッシュボードUI<br/>[dashboard.js]"]
  node_settings["設定検証<br/>[config.py]"]
  node_settings_form["設定フォーム<br/>[settings_form.py]"]
  node_run_manager["Run管理<br/>[run_manager.py]"]
end

subgraph group_migration["移行実行"]
  node_workflow["移行ワークフロー<br/>[workflow.py]"]
  node_capsules["コンテキスト分割<br/>[capsules.py]"]
  node_source_context["ソース資料<br/>[source_context.py]"]
  node_rule_materials["ルール資料<br/>[rule_materials.py]"]
  node_junie["Junie連携<br/>[junie_cli.py]"]
  node_conversation["Junie対話"]
  node_targets["移行先反映"]
end

subgraph group_validation["検証・保存"]
  node_build_checker["ビルド・チェッカー<br/>[checker_output.py]"]
  node_records[("Run記録<br/>[run_records.py]")]
end

subgraph group_review["レビュー"]
  node_diff_viewer["Diff Viewer<br/>[diff_viewer.py]"]
  node_anchors["対応行アンカー<br/>[review_anchors.py]"]
  node_editor_queue[("編集キュー<br/>[editor_queue.py]")]
end

subgraph group_support["実行基盤"]
  node_execution["実行制御<br/>[execution.py]"]
  node_files["安全なファイル操作<br/>[files.py]"]
  node_timings["工程計時<br/>[timings.py]"]
end

node_operator(("利用者"))

node_operator -->|"起動する"| node_cli
node_operator -->|"操作する"| node_dashboard
node_dashboard -->|"設定を使う"| node_settings
node_dashboard -.->|"Runを管理"| node_run_manager
node_dashboard -->|"Runを実行"| node_workflow
node_dashboard_ui -.->|"画面を操作"| node_dashboard
node_settings_form -.->|"設定を検証"| node_settings
node_run_manager -->|"再開を振分"| node_workflow
node_workflow -->|"カプセルを処理"| node_capsules
node_workflow -->|"資料を準備"| node_source_context
node_workflow -->|"ルールを準備"| node_rule_materials
node_workflow -->|"移行を依頼"| node_junie
node_workflow -->|"編集を反映"| node_targets
node_workflow -->|"検証を実行"| node_build_checker
node_workflow -->|"進捗を保存"| node_records
node_junie -->|"工程を制御"| node_execution
node_conversation -->|"指示を振分"| node_workflow
node_workflow -->|"編集指示を読む"| node_editor_queue
node_workflow -->|"工程を計時"| node_timings
node_workflow -->|"作業ファイルを扱う"| node_files
node_operator -->|"対応を確認"| node_diff_viewer
node_diff_viewer -->|"アンカーを扱う"| node_anchors
node_anchors -->|"対応を保存"| node_records

click node_cli "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/cli.py"
click node_dashboard "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/dashboard.py"
click node_dashboard_ui "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/dashboard.js"
click node_settings "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/config.py"
click node_settings_form "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/settings_form.py"
click node_run_manager "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/run_manager.py"
click node_workflow "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/workflow.py"
click node_capsules "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/capsules.py"
click node_source_context "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/source_context.py"
click node_rule_materials "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/rule_materials.py"
click node_junie "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/junie_cli.py"
click node_conversation "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/junie_conversation.py"
click node_targets "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/worktree_targets.py"
click node_build_checker "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/checker_output.py"
click node_records "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/run_records.py"
click node_diff_viewer "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/diff_viewer.py"
click node_anchors "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/review_anchors.py"
click node_editor_queue "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/editor_queue.py"
click node_execution "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/execution.py"
click node_files "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/files.py"
click node_timings "https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/timings.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_dashboard,node_dashboard_ui,node_settings,node_settings_form,node_run_manager toneBlue
class node_workflow,node_capsules,node_source_context,node_rule_materials,node_junie,node_conversation,node_targets toneAmber
class node_build_checker,node_records toneMint
class node_diff_viewer,node_anchors,node_editor_queue toneRose
class node_execution,node_files,node_timings,node_operator toneIndigo
```

## Components

### 操作・設定

- [CLI](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/cli.py): `src/migration_harness/cli.py`
- [ダッシュボード](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/dashboard.py): `src/migration_harness/dashboard.py`
- [ダッシュボードUI](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/dashboard.js): `src/migration_harness/dashboard.js`
- [設定検証](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/config.py): `src/migration_harness/config.py`
- [設定フォーム](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/settings_form.py): `src/migration_harness/settings_form.py`
- [Run管理](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/run_manager.py): `src/migration_harness/run_manager.py`

### 移行実行

- [移行ワークフロー](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/workflow.py): `src/migration_harness/workflow.py`
- [コンテキスト分割](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/capsules.py): `src/migration_harness/capsules.py`
- [ソース資料](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/source_context.py): `src/migration_harness/source_context.py`
- [ルール資料](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/rule_materials.py): `src/migration_harness/rule_materials.py`
- [Junie連携](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/junie_cli.py): `src/migration_harness/junie_cli.py`
- [Junie対話](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/junie_conversation.py): `src/migration_harness/junie_conversation.py`
- [移行先反映](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/worktree_targets.py): `src/migration_harness/worktree_targets.py`

### 検証・保存

- [ビルド・チェッカー](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/checker_output.py): `src/migration_harness/checker_output.py`
- [Run記録](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/run_records.py): `src/migration_harness/run_records.py`

### レビュー

- [Diff Viewer](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/diff_viewer.py): `src/migration_harness/diff_viewer.py`
- [対応行アンカー](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/review_anchors.py): `src/migration_harness/review_anchors.py`
- [編集キュー](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/editor_queue.py): `src/migration_harness/editor_queue.py`

### 実行基盤

- [実行制御](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/execution.py): `src/migration_harness/execution.py`
- [安全なファイル操作](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/files.py): `src/migration_harness/files.py`
- [工程計時](https://github.com/sssan-00/php-to-csharp-migration-harness/blob/main/src/migration_harness/timings.py): `src/migration_harness/timings.py`

### Other components

- **利用者**

## Connections

- 利用者 → CLI: 起動する (evidence: `README.md`)
- 利用者 → ダッシュボード: 操作する (evidence: `README.md`)
- ダッシュボード → 設定検証: 設定を使う (evidence: `src/migration_harness/dashboard.py`)
- ダッシュボード → Run管理: Runを管理 (evidence: `src/migration_harness/dashboard.py`)
- ダッシュボード → 移行ワークフロー: Runを実行 (evidence: `README.md`)
- ダッシュボードUI → ダッシュボード: 画面を操作
- 設定フォーム → 設定検証: 設定を検証
- Run管理 → 移行ワークフロー: 再開を振分 (evidence: `src/migration_harness/run_manager.py`)
- 移行ワークフロー → コンテキスト分割: カプセルを処理 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → ソース資料: 資料を準備 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → ルール資料: ルールを準備 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → Junie連携: 移行を依頼 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → 移行先反映: 編集を反映 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → ビルド・チェッカー: 検証を実行 (evidence: `README.md`)
- 移行ワークフロー → Run記録: 進捗を保存 (evidence: `src/migration_harness/workflow.py`)
- Junie連携 → 実行制御: 工程を制御 (evidence: `src/migration_harness/junie_cli.py`)
- Junie対話 → 移行ワークフロー: 指示を振分 (evidence: `src/migration_harness/junie_conversation.py`)
- 移行ワークフロー → 編集キュー: 編集指示を読む (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → 工程計時: 工程を計時 (evidence: `src/migration_harness/workflow.py`)
- 移行ワークフロー → 安全なファイル操作: 作業ファイルを扱う (evidence: `src/migration_harness/workflow.py`)
- 利用者 → Diff Viewer: 対応を確認 (evidence: `README.md`)
- Diff Viewer → 対応行アンカー: アンカーを扱う (evidence: `src/migration_harness/diff_viewer.py`)
- 対応行アンカー → Run記録: 対応を保存 (evidence: `README.md`)
