================================================================================
 LegalOS Inbox v0.1.0 -- 利用案内
================================================================================

LegalOS Inbox は、法務部内部での「受付・添付・進捗・滞留管理」用ツールです。

本 EXE は、初回起動から 30 日間「30 日無料トライアル」としてすべての機能を
無償でご利用いただけます。製品版ライセンスキーを入力すると恒久的に
「製品版ライセンス認証済み」状態に移行し、以後トライアル制限は解除されます。

  ▼ トライアル期間: 初回起動日から 30 日
  ▼ 期間中: すべての機能が利用可能
  ▼ 期間後: 既存の受付・添付の閲覧は引き続き可能。
            新規受付の作成・ファイル追加・出力等の編集系操作は停止します。
            既存データは削除されません。
  ▼ 製品版への切替: 「ファイル」→「ライセンスキーを入力…」から
                     購入時にお渡しする製品版ライセンスキーを入力してください。
  ▼ ライセンス状態の表示: ログイン画面とステータスバーで動的に表示されます。
        - 未認証（トライアル中）: 「トライアル版（残り N 日）」
        - トライアル最終日:        「トライアル版（本日まで）」
        - トライアル期限切れ:      「トライアル期間が終了しました」
        - 製品版認証後:            「製品版ライセンス認証済み」

  既知の制約は KNOWN_LIMITATIONS_LegalOS_Inbox.txt を、起動・操作の詳細は
  本ファイルを、簡易な動作確認は QUICK_START_LegalOS_Inbox.txt を参照
  してください。

================================================================================
 1. クイックスタート
================================================================================

  1) ZIP を任意のフォルダに展開する（例: C:\LegalOS_Inbox\）
  2) フォルダ内の LegalOS_Inbox.exe をダブルクリック
  3) 初回起動：初期セットアップウィザードで管理者ユーザーを作成する
       （ユーザーID / 表示名 / パスワード 8 文字以上）
  4) 2 回目以降：ログイン画面で同じ ID + パスワードを入力してログイン
  5) ホーム画面で sample/ フォルダのサンプルメールをドロップして動作確認

  ※ 初回起動時に SmartScreen の警告（「WindowsによってPCが保護されました」）
    が表示される場合があります。コード署名を行っていないためです。
    「詳細情報」→「実行」で起動できます。

  ※ 3 分で動作確認したい場合は同梱の QUICK_START_LegalOS_Inbox.txt、
    トライアル仕様の詳細は TRIAL_NOTICE_LegalOS_Inbox.txt、
    詳細な動作確認は CHECKLIST_LegalOS_Inbox.txt を参照してください。

================================================================================
 2. まず試す操作
================================================================================

  ■ 手動受付の作成
      ホーム画面の「＋ 新規受付」ボタンから、件名を入れて登録できます。

  ■ メールファイルからの自動受付（要 sample/）
      ホーム画面のドロップエリアに sample/sample_request.eml をドラッグ。
      → 件名・送信者・本文・添付が自動入力された新規受付ダイアログが開く。

  ■ ダッシュボードと出力
      ホームの「ダッシュボード」ボタンから 4 タブの集計画面に遷移。
      上部の「CSV出力」「Excel出力」で集計結果をエクスポート。

================================================================================
 3. 初期セットアップ・ログイン・ユーザー管理（Phase LI-09C / LI-09D）
================================================================================

  ■ 初回起動（users テーブルが空のとき）
      初期セットアップウィザードが自動で表示されます。
      管理者ユーザーを 1 名作成してください。

        - 管理者ユーザーID（必須・英数字推奨・大文字小文字は同一視）
        - 管理者表示名（必須・日本語可。受付一覧/履歴に表示される）
        - 管理者パスワード（必須・8 文字以上）+ 確認入力
        - 会社名・部署名（任意・ログイン画面に表示）

      作成完了後、自動的にログイン画面に遷移します。

  ■ 2 回目以降の起動
      ログイン画面でユーザーID + パスワードを入力します。
      パスワードは PBKDF2-HMAC-SHA256（200,000 反復）で
      ハッシュ保管されており、平文では DB に保存されません。

  ■ ユーザー管理（管理者のみ）
      メニュー「ファイル」→「ユーザー管理…」から:

        - ユーザー追加（ID / 表示名 / 役割 / パスワード）
        - 表示名・役割の変更（管理者 / 法務責任者 / 法務担当者）
        - パスワード再設定（管理者が他ユーザーのパスワードをリセット）
        - 無効化 / 有効化（is_active トグル。物理削除はしません）

      ガード:
        - 唯一の有効 admin の降格・無効化は禁止
        - 自分自身の無効化は禁止

  ■ パスワードを忘れた場合
      管理者にお願いして「パスワード再設定」してもらってください。
      管理者しかいない場合は配布元にお問い合わせください。

  ※ 当バージョンは ID + パスワードのみの認証です。
    SSO / Active Directory 連携 / MFA は提供していません。

================================================================================
 4. データ・ログ保存場所
================================================================================

  EXE と同じフォルダ配下に LegalInbox_Data/ が自動作成されます。

    LegalOS_Inbox_v0.1.0_<種別>/
    ├─ LegalOS_Inbox.exe
    ├─ legalinbox_config.yaml
    ├─ README_LegalOS_Inbox.txt        ... 本ファイル
    ├─ CHECKLIST_LegalOS_Inbox.txt    ... 配布確認チェックリスト
    ├─ _internal/                     ... ランタイム + 同梱ライブラリ
    ├─ sample/                        ... 動作確認用サンプル
    │   ├─ README_sample.txt
    │   ├─ sample_request.eml
    │   ├─ sample_contract.txt
    │   └─ sample_note.txt
    └─ LegalInbox_Data/               ... データルート（自動作成）
        ├─ legalinbox.db              ... SQLite データベース
        ├─ files/                     ... 受付ごとの添付ファイル
        ├─ exports/                   ... CSV / Excel 出力先
        └─ logs/                      ... ログファイル
            └─ legalos_inbox_YYYYMMDD.log

  本 EXE はコンソールを表示しないため、何か問題があった際は
  ``LegalInbox_Data/logs/legalos_inbox_YYYYMMDD.log`` を確認してください。

  ログ方針:
    - 起動・config 読込・DB 初期化・依存可否を必ず記録
    - メール解析の成功/失敗・件名（80 文字まで）程度は記録
    - 本文全文・添付の中身はログに出さない

================================================================================
 5. ファイル D&D の使い方
================================================================================

  ホーム画面のドロップエリアにファイル / フォルダ / メールファイルを
  ドロップすると、新規受付の補完ダイアログが開きます。

    通常ファイル → 受領資料 として保存
    フォルダ → 直下のファイルが受領資料として一括取込
    .eml / .msg → メール内容を解析して件名・送信者・本文・添付を自動入力

  受付詳細画面のドロップエリアに追加ファイルをドロップすると、
  ファイル区分（受領資料 / 追加資料 / 法務作業版 / 相手方修正版 /
  最終版 / 参考資料 / 元メール）を選んで取り込めます。

  D&D が動かない環境では、ドロップエリア内の「ファイルを選択…」ボタンを
  クリックすると、ファイル選択ダイアログから同じ操作ができます。

================================================================================
 6. .eml / .msg メールファイルの扱い
================================================================================

  ■ .eml （Python 標準 email ライブラリで解析）
      日本語件名・送信者名・添付のデコードに対応しています。
      ホーム画面に D&D するだけで、件名・送信者・本文・添付が
      自動入力された新規受付ダイアログが開きます。

  ■ .msg （Outlook Classic 形式、extract-msg ライブラリで解析）
      環境によっては解析できない場合があります。その場合は元 .msg を
      「元メール」(source_email) として保存し、受付情報はユーザーが
      手動入力する運用にフォールバックします（アプリは落ちません）。

  ■ 取り込まれる情報
      - 件名 → 受付の「件名」欄（自動補完）
      - 送信者名 / メールアドレス → 「依頼者」欄（自動補完）
      - 受信日時 → メタ情報として保存
      - 本文（plain 優先、HTML は簡易テキスト化）→ 「本文」欄
      - 添付ファイル → 受領資料として保存
      - 元メール本体 → 「元メール」(source_email) 区分で保存

  ■ 添付の除外（安全側固定）
      - 危険拡張子（.exe / .bat / .cmd / .ps1 / .vbs / .js / .scr / .msi）
      - Office 一時ファイル（~$xxx.docx）
      - .tmp / .lock / .swp / .part
      - 0 バイト
      → 取り込み前に警告ダイアログまたは内訳メッセージで通知。

================================================================================
 7. ファイル添付確認
================================================================================

  受付詳細画面の「保存先フォルダを開く」ボタンで、各受付の添付ファイル
  保存先をエクスプローラーで開けます。

    LegalInbox_Data/files/INQ-2026-NNNN_<件名>/
      00_source_email/         ... 元メール
      10_received/             ... 受領資料
      20_additional/           ... 追加資料
      30_legal_working/        ... 法務作業版
      40_counterparty_revision/... 相手方修正版
      50_final/                ... 最終版
      90_reference/            ... 参考資料

  ファイル名は ``INQ-NNNN-NNNN_YYYYMMDD_HHMM_区分_元ファイル名.ext`` 形式で
  保存されます。

================================================================================
 8. ダッシュボードと出力
================================================================================

  ホームの「ダッシュボード」ボタンから 4 タブの集計画面が開きます。

    概要      ... ステータス別 / 滞留先別 / 期限関連の集計
    担当者別  ... 各担当者の負荷を表で確認
    期限・滞留 ... 期限超過一覧 / 7 日超滞留一覧（行ダブルクリックで詳細）
    分類別    ... 依頼元別 / 種別別

  上部の出力ボタン:
    CSV出力          ... 受付一覧（UTF-8 BOM 付き）
    Excel出力        ... 6 シート構成の管理レポート
    出力先フォルダを開く ... LegalInbox_Data/exports/ をエクスプローラーで開く

================================================================================
 9. 30 日トライアル / ライセンスキー
================================================================================

  ■ トライアル期間
      初回起動日から 30 日間、すべての機能を利用できます。
      残日数はメイン画面下部のステータスバーに表示されます。

        例: "トライアル版（残り 30 日）"
            "トライアル版（残り 14 日）"
            "トライアル版（本日まで）"
            "トライアル期間が終了しました"
            "製品版ライセンス認証済み"  （ライセンスキー入力後）

  ■ 期限切れ後の挙動
      - 既存の受付・添付ファイル・タイムライン・ダッシュボードは
        引き続き **閲覧可能** です。
      - 既存データは削除されません。
      - 新規受付の作成・ドラッグ＆ドロップ取込・ファイル追加・メモ追加・
        ステータス変更・CSV / Excel 出力は **一時停止** します。
      - 操作しようとすると「トライアル期間が終了しているため、この操作は
        利用できません」というメッセージが表示されます。

  ■ 製品版ライセンスキーの入力
      アプリのメニューから:  「ファイル」→「ライセンスキーを入力…」

      ライセンスキー入力ダイアログが開きます。購入時にお渡しするキーを
      入力して「ライセンス認証」を押してください。
      認証成功後、ステータスバーが「製品版ライセンス認証済み」に変わり、
      無期限で利用できるようになります。

  ■ ライセンス状態の保管について
      ライセンス状態を管理するファイルが LegalInbox_Data/ 配下に
      自動作成されます。**通常は編集しないでください**。
      手動で編集すると、状態が「ライセンス状態を確認できません」に
      なり、編集操作が一時的に制限されることがあります。

      ライセンス状態が破損した場合でも、既存の受付・添付ファイルは
      削除されません。問題が続く場合は配布元にお問い合わせください。

================================================================================
10. 既知の制約
================================================================================

  本配布候補版の既知の制約は同梱の
  KNOWN_LIMITATIONS_LegalOS_Inbox.txt にまとめています。
  以下に主要な点だけ抜粋します。

  - Outlook / Teams / Slack 等の API 連携は未対応（保存済み .eml / .msg を D&D）
  - .msg 解析は環境・ファイル形式により失敗する場合あり（その場合も元メール保存）
  - 営業日計算ではなく暦日計算
  - ライセンス制御はオフライン簡易方式（サーバー照会なし、完全な耐改ざん性は非保証）
  - コード署名なし（SmartScreen 警告が出る可能性）
  - インストーラーではなく ZIP 配布、PyInstaller onedir
  - 大規模データでの性能は未検証
  - SSO / Active Directory / MFA は未対応（本ツール内 ID + パスワードのみ）
  - LegalDesk 認証ブリッジは未統合（次フェーズ以降）
  - 複数 PC からの同時編集は正式検証外

================================================================================
11. トラブルシュート
================================================================================

  【EXE が起動しない】
      Dev版 → コンソールに出るエラーメッセージを確認
      Windowed版 → LegalInbox_Data/logs/legalos_inbox_YYYYMMDD.log を確認

  【D&D が反応しない】
      ステータスバー右側に「D&D: 無効」が出ている場合、tkinterdnd2 の
      ロードに失敗しています。ドロップエリアの「ファイルを選択…」ボタン
      で代替できます。

  【.msg が取り込めない】
      ファイルとしての保存（source_email）には成功します。
      受付情報は手動で補完してください。次フェーズで改善予定です。

  【Excel 出力が利用できない】
      本ビルドには openpyxl を同梱しています。何らかの理由で「openpyxl
      が未導入」と表示される場合は CSV 出力を利用してください。

  【日本語ファイル名 / 本文が文字化けする】
      CSV を直接 Excel で開いて文字化けする場合、別の表計算ソフトで開くか、
      Excel の「データ」→「テキスト/CSV から」インポートを試してください。
      本ビルドの CSV は UTF-8 BOM 付きで出力されています。

  【設定ファイルエラーが出る】
      legalinbox_config.yaml の YAML 構文を確認してください。
      復旧したい場合は、配布フォルダ内の legalinbox_config.yaml を
      再展開してください（または ZIP から再コピー）。

================================================================================
12. 補足ドキュメント（営業・LP 制作担当向け）
================================================================================

  リポジトリ側の legalinbox/docs/ 配下に、製品概要 / 機能一覧 / 操作マニュアル /
  トライアル案内 / FAQ / LP コピー / スクリーンショット撮影ガイド / 顧客向け
  既知制約 / トライアル配布案内文 を整理しています。

    legalinbox/docs/product_overview.md
    legalinbox/docs/feature_list.md
    legalinbox/docs/user_manual.md
    legalinbox/docs/trial_guide.md
    legalinbox/docs/faq.md
    legalinbox/docs/lp_copy.md
    legalinbox/docs/screenshot_guide.md
    legalinbox/docs/known_limitations_customer.md
    legalinbox/docs/trial_distribution_message.md

  ※ 配布 ZIP の容量を抑えるため、上記 docs/ は **ZIP には同梱していません**。
    必要な担当者へは別途共有してください。

================================================================================
13. このビルドについて
================================================================================

  バージョン: v0.1.0
  製品名:     LegalOS Inbox
  対象 OS:    Windows 10 / 11
  ライセンス: 初回起動から 30 日無料トライアル → ライセンスキー入力で製品版へ移行

  同梱物:
    LegalOS_Inbox.exe                    ... アプリ本体
    legalinbox_config.yaml               ... 設定ファイル
    README_LegalOS_Inbox.txt             ... 本ファイル（詳細手順）
    QUICK_START_LegalOS_Inbox.txt        ... 3 分で動作確認するクイックスタート
    TRIAL_NOTICE_LegalOS_Inbox.txt       ... トライアル仕様・期限切れ挙動の説明
    CHECKLIST_LegalOS_Inbox.txt          ... 配布確認チェックリスト
    KNOWN_LIMITATIONS_LegalOS_Inbox.txt  ... 既知の制約一覧
    CHANGELOG_LegalOS_Inbox.txt          ... 変更履歴
    distribution_manifest.txt            ... 配布物マニフェスト
    sample/                              ... 動作確認用サンプル（架空データ）
    LegalInbox_Data/                     ... データルート（DB / 添付 / exports / logs の空骨組）
    _internal/                           ... ランタイム + 同梱ライブラリ

  ZIP の SHA256 は ZIP と同階層に置かれた
  ``<zipname>.sha256`` ファイルで確認できます。

確認結果は同梱の CHECKLIST_LegalOS_Inbox.txt に記入の上ご返送ください。
