==========================================================
 MAI OCR  設置・運用手順（エックスサーバー / PHP8 / MySQL）
==========================================================

■ 概要
 添付画像（JPG/PNG/PDF/ZIP）を読み取り、事前にインポートした一覧Excelの
 「見出し＝項目定義」から作った“器”に、1画像=1レコードとしてOCR保存し、
 適宜Excelに書き出せる、サーバ設置型（買い切り）のWEBアプリです。

■ 動作環境
 - PHP 8系（cURL / ZipArchive / SimpleXML / mbstring / PDO_MySQL 拡張が必要）
 - MySQL（utf8mb4）
 - エックスサーバー等の共有レンタルサーバを想定（cron不要。画面操作で完結）

■ 設置手順
 1. この app/ フォルダの中身を、公開ディレクトリ（例：aiocr.ms123-8.jp の public_html）に
    アップロードする。
 2. _config/ と _uploads/ フォルダに書き込み権限があること（通常はそのままでOK）。
 3. ブラウザで https://（設置先）/ を開く → 初期セットアップ画面に移動する。
 4. 「1. データベース接続情報」を入力：
      DBホスト名 : mysql203.xbiz.ne.jp
      DB名       : ms123_aiocr
      DBユーザー : ms123_aiocr
      DBパスワード: x7WYr3a9
      公開URL    : https://aiocr.ms123-8.jp
    「保存＋接続＋スキーマ適用」を押す。
      → _config/runtime_config.php が生成され、必要なテーブルが作られます。
      （うまくいかない場合は phpMyAdmin で sql/schema.sql を実行してください）
 5. 「利用者ログイン」から利用開始。
      初期ID   : admin
      初期PASS : x7WYr3a9   ← ログイン後、設定/利用者画面で必ず変更してください。

■ APIキー（画像読み取りに必須）
 - 本番キーは config.php に直書きしません。次の優先順で解決します：
     1) DB（app_settings）… 設定画面(/settings/) や /vendor/admin/ で登録。
     2) _config/runtime_config.php の RC_ANTHROPIC_API_KEY … ファイル保持（推奨運用）。
 - ファイル保持の運用：
     _config/runtime_config.sample.php を runtime_config.php にコピーし、RC_ANTHROPIC_API_KEY に
     本番キーを記載 → _config/ をサーバへ設置。以降、丸ごと上書き更新時は _config/ を除外する
     （接続情報・APIキー・原本 _uploads/ が保持されます。DB保存分も再アップでは消えません）。
 - 未設定でも器の作成はできますが、読み取り（OCR）はできません。

■ 使い方
 1. 器を作る（/containers/）：一覧Excel（.xlsx/.csv）を取込 → 1行目の見出しが項目になります。
 2. 器を開く（/records/）：画像/PDF/ZIP をアップロード → 自動で読み取り開始。
      ・画像1枚＝1レコード
      ・PDFは1ページ＝1レコード
      ・ZIPは中の画像を展開して各画像＝1レコード
 3. Excelに書き出す：レコード一覧の「Excelに書き出す」ボタン。

■ セキュリティ / ファイル
 - _config/ … 接続情報（runtime_config.php）。.htaccess で直アクセス拒否。
 - _uploads/ … 原本画像。直アクセス不可。閲覧は /file/?id=（ログイン保護）経由。
 - config.php 等の実体ファイルは .htaccess で直アクセス拒否済み。
 - ※ ファイル一式を丸ごと上書き更新する際は、_config/ と _uploads/ を上書き対象から
      除外してください（接続情報と原本画像を保持するため）。

■ 主要ファイル
 config.php / env_config.php / db.php / common.php / auth.php / repo.php … 土台
 ocr.php            … Claude画像認識によるOCRエンジン
 import_file.php    … 定義Excel/CSVの見出し解析
 export_lib.php     … 依存なしのXLSX/CSV書き出し
 sql/schema.sql     … DBスキーマ（冪等・再実行安全）
 containers/ records/ dashboard/ settings/ users/ login/ logout/ file/ … 機能フォルダ
 vendor/setup|login|admin|logout … ベンダー設置管理
 templates/ assets/ … 共通レイアウト・CSS・JS
