============================================================
  COBOL2Java v2.0.0 説明書
  COBOL → Java 自動変換ツール（GUI / CLI 対応）
============================================================

■ ソフト名
  COBOL2Java

■ バージョン
  2.0.0

■ 作者名
  highdefinitionaudiodriver

■ 連絡先
  GitHub: https://github.com/highdefinitionaudiodriver
  リポジトリ: https://github.com/highdefinitionaudiodriver/cobol2java
    バグ報告・機能要望:
           highdefinitionaudiodriver@gmail.com

■ 動作環境
  対応OS: Windows 10 / 11（64bit推奨）
          macOS, Linux（ソースから実行可）
  必要メモリ: 512MB以上
  ディスク容量: 約30MB（EXE単体）
  ランタイム: 不要（EXE版は同梱済み。ソース版はPython 3.9以上）

■ ソフト種別
  フリーソフト（MITライセンス）

■ カテゴリ
  プログラミング > 変換・移行ツール

■ 概要
  COBOL2Javaは、COBOLソースコード（.cbl, .cob, .cobol）をモダンなJavaソースコードに
  自動変換するデスクトップアプリケーションです。

  単純な行単位の変換ではなく、COBOLのDIVISION構造を解析し、Javaのクラス設計
  （データクラス、列挙型、サービス層、ファイルハンドラ）へのOOP変換を行います。

  GUIとCLIの両方に対応し、CI/CDパイプラインへの組み込みも可能です。

■ 主な機能

  【変換機能】
  ・COBOLソースコードのJavaへの自動変換（OOP設計）
  ・データクラス、Enum、サービスクラスの自動抽出
  ・getter/setter、toString()、Javadocの自動生成
  ・EXEC SQL → JDBC PreparedStatement 変換
  ・EXEC CICS → 抽象インタフェース変換
  ・EXEC DLI（IMS）対応
  ・COPY文の検出・記録
  ・再帰的サブフォルダ一括変換（ディレクトリ構造を維持）

  【パーサーアーキテクチャ（v2.0 新機能）】
  ・3フェーズ構造化パーサー
    - Phase 1: DATA DIVISION 構造化解析（句の宣言的抽出）
    - Phase 2: PROCEDURE DIVISION 構造化解析（動詞レジストリ＋再帰下降ブロック解析）
    - Phase 3: DIVISION レベル統合（前処理・DIVISION検出・ルーティング）
  ・レガシー正規表現パーサーへの自動フォールバック
  ・新しい動詞の追加が1行で可能な拡張性

  【拡張ポイント（Strategy Pattern）（v2.0 新機能）】
  ・ファイルI/O変換戦略（java.io / VSAM→DB）
  ・SQL変換戦略（JDBC / JPA・Hibernate）
  ・CICS変換戦略（カスタム実装対応）
  ・ConversionStrategyRegistryによるプラグイン的な切替

  【ベンダー方言サポート（10種）】
  ・IBM Enterprise COBOL (z/OS)
  ・富士通 NetCOBOL
  ・NEC ACOS-4 COBOL
  ・日立 VOS3 / COBOL2002
  ・Micro Focus Visual COBOL
  ・Unisys MCP / ClearPath
  ・Bull/Atos GCOS COBOL
  ・HP/Tandem NonStop COBOL
  ・GnuCOBOL (OpenCOBOL)
  ・標準 COBOL-85/2002/2014
  ・ベンダー自動判別機能搭載

  【GUI（MVC アーキテクチャ）（v2.0 リファクタリング済み）】
  ・Model / View / Controller の分離設計
  ・59言語対応の多言語インタフェース
  ・入力/出力フォルダの選択
  ・パッケージ名・エンコーディング・拡張子の設定
  ・リアルタイム変換ログ表示
  ・変換のキャンセル機能

  【CLI モード】
  ・ヘッドレス実行（-i, -o オプション指定）
  ・CI/CDパイプラインへの組み込み対応
  ・バッチ処理による大量ファイル一括変換

  【テストスイート】
  ・184件のpytestテスト（0.25秒で完走）
  ・GitHub Actions CI対応（Python 3.9〜3.12マトリックスビルド）
  ・flake8 / black による静的解析

■ 対応言語（UI）
  59言語: 日本語, English, 中文, 한국어, ไทย, Tiếng Việt,
  Bahasa Indonesia, Bahasa Melayu, हिन्दी, বাংলা, தமிழ்,
  Français, Deutsch, Italiano, Español, Português,
  Русский, Українська, Polski, العربية, עברית, فارسی,
  Türkçe, Svenska, Suomi ほか全59言語

■ インストール方法

  【EXE版（推奨）】
  1. COBOL2Java.exe をダウンロード
  2. 任意のフォルダに配置
  3. ダブルクリックで起動
  ※ インストール作業・ランタイムのインストールは不要です。

  【ソース版】
  1. Python 3.9 以上をインストール
  2. リポジトリをクローン:
     git clone https://github.com/highdefinitionaudiodriver/cobol2java.git
  3. cd cobol2java
  4. python main.py で起動

■ 使い方

  【GUI モード】
  1. アプリケーションを起動
  2. 「入力フォルダ」に変換対象のCOBOLファイルがあるフォルダを指定
  3. 「出力フォルダ」に変換後のJavaファイルの出力先を指定
  4. 必要に応じてオプションを設定:
     - パッケージ名（デフォルト: com.migrated）
     - ソースエンコーディング（UTF-8, Shift_JIS, EUC-JP 等）
     - ファイル拡張子（.cbl, .cob, .cobol）
     - ベンダー方言（自動検出 または 手動選択）
     - getter/setter生成、Javadoc生成、BigDecimal使用 等
  5. 「変換」ボタンをクリック
  6. ログパネルで変換の進捗を確認

  【CLI モード】
  python main.py -i ./input_folder -o ./output_folder --vendor auto
  python main.py -i ./input_folder -o ./output_folder --vendor ibm --package com.example

  主なオプション:
    -i, --input    : 入力フォルダ（必須）
    -o, --output   : 出力フォルダ（必須）
    -p, --package  : パッケージ名（デフォルト: com.migrated）
    -e, --encoding : エンコーディング（デフォルト: utf-8）
    --vendor       : ベンダー方言（auto/standard/ibm/fujitsu/nec/hitachi 等）
    --no-getters   : getter/setter生成を無効化
    --no-javadoc   : Javadocコメント生成を無効化

■ ファイル構成
  COBOL2Java.exe          - 実行ファイル（Windows用）
  main.py                 - エントリポイント（CLI + GUI起動）
  src/
    cobol_parser.py       - COBOLパーサー（AST生成）
    division_parser.py    - DIVISION検出・ルーティング
    lark_data_parser.py   - DATA DIVISION 構造化パーサー
    lark_procedure_parser.py - PROCEDURE DIVISION 構造化パーサー
    oop_transformer.py    - AST → Java OOPモデル変換
    java_generator.py     - Java ソースコード生成
    conversion_strategies.py - 変換戦略インタフェース
    vendor_extensions.py  - ベンダー方言処理
    gui_model.py          - GUIモデル層（MVC）
    gui_view.py           - GUIビュー層（MVC）
    gui_controller.py     - GUIコントローラ層（MVC）
    i18n.py               - 多言語対応（59言語）
    version.py            - バージョン情報
  tests/                  - テストスイート（184件）
  samples/                - サンプルCOBOLファイル
  README.md               - GitHub用ドキュメント

■ アンインストール方法
  フォルダごと削除してください。
  レジストリへの書き込みは一切行いません。

■ 免責事項
  本ソフトウェアの使用により生じたいかなる損害に対しても、
  作者は一切の責任を負いません。
  自己責任にてご利用ください。

■ 著作権・ライセンス
  Copyright (c) 2026 highdefinitionaudiodriver
  MITライセンスに基づき自由に使用・改変・再配布できます。
  詳細はLICENSEファイルを参照してください。

■ 変更履歴
  v2.0.0 (2026-03-28)
    - 3フェーズ構造化パーサー導入（DATA/PROCEDURE/DIVISION統合）
    - Strategy Pattern による拡張ポイント追加（File I/O, SQL, CICS）
    - MVC アーキテクチャへのGUIリファクタリング
    - テストスイート拡充（184件、pytest対応）
    - GitHub Actions CI ワークフロー追加
    - COMP-3, POINTER, COMP-1/2 の型変換修正
    - COPY文検出の改善
    - 宣言的動詞レジストリによるPROCEDURE DIVISION解析

  v1.0.0 (2026-03-15)
    - 初版リリース
    - GUI / CLI 対応
    - 10ベンダー方言サポート
    - 59言語UI
    - 再帰的サブフォルダ変換
    - PyInstaller による EXE 生成対応

============================================================
