レポート管理と公開

作成されたレポートのステータス管理、確認・編集、およびユーザーへの共有機能について説明します。 システム上でのレポートの管理は、管理画面の「レポート管理（/settings/reports）」から行います。

1. レポート管理画面の使い方

レポート管理画面（/settings/reports）は、アップロード済みのレポートを一覧表示し、公開・非公開の切り替えや編集・削除を行うための画面です。

1.1 画面へのアクセス方法

レポート管理画面には2つのアクセス方法があります。

方法1: メインメニューから

flowchart LR
    A["サイドメニュー"] --> B["レポート管理"]
    B --> C["レポート一覧画面"]

    style C fill:#e3f2fd,stroke:#1565c0,stroke-width:2px

1. サイドメニューまたはメインメニューから 「レポート管理」 を選択します。
2. すべてのレポートが一覧表示されます。

方法2: ユーザー管理から（特定ユーザーのレポートのみ表示）

flowchart LR
    A["ユーザー管理"] --> B["対象ユーザーの行"]
    B --> C["「レポート」列の<br>「一覧」ボタン"]
    C --> D["該当ユーザーの<br>レポート一覧"]

    style D fill:#e3f2fd,stroke:#1565c0,stroke-width:2px

1. サイドメニューから 「ユーザー管理」 を開きます。
2. 対象ユーザーの行を探します。
3. 「レポート」列 にある 「一覧」ボタン をクリックします。
4. 該当ユーザーのレポートのみが絞り込まれた状態で一覧が表示されます。

1.2 レポート一覧の見方

レポート一覧テーブルには以下の列が表示されます。

操作列のボタン:

1.3 ステータス表示の見方

各レポート行の 「ステータス」列 には、2つのバッジが並んで表示されます。

バッジ1: 公開状態

バッジ2: 閲覧状況

表示例:

:icon{name="heroicons:check-circle" class="text-green-600"} 公開  :icon{name="heroicons:eye" class="text-blue-500"} 閲覧済   ← ユーザーがアクセス済み
:icon{name="heroicons:check-circle" class="text-green-600"} 公開  :icon{name="heroicons:minus-circle" class="text-gray-400"} 未閲覧   ← 公開したがまだ見られていない
:icon{name="heroicons:minus-circle" class="text-gray-400"} 非公開 :icon{name="heroicons:minus-circle" class="text-gray-400"} 未閲覧   ← まだ公開していない

!NOTE 閲覧カウント: 公開レポート（/r/:shortUrl）が閲覧されるたびに view_count がインクリメントされます。この数値は、レポート詳細画面でも確認できます。

2. レポートのステータス（状態）

アップロードされたすべてのレポートは、以下の2つの状態（ステータス）を持ちます。

!NOTE DBステータスの draft は、UI上では「下書き」ではなく「非公開」と統一して表示されます。

3. レポート詳細の確認

3.1 レポート詳細画面を開く

レポート詳細画面では、レポートの内容確認、公開・非公開の切り替え、削除が行えます。

操作手順:

flowchart LR
    A["レポート管理画面"] --> B["対象レポート行を<br>クリック"]
    B --> C["レポート詳細画面<br>(/settings/reports/:id)"]

    style C fill:#e3f2fd,stroke:#1565c0,stroke-width:2px

1. レポート管理画面（/settings/reports）を開きます。
2. 一覧テーブルから、確認したいレポートの行全体をクリックします。
   • または 「詳細」ボタン（:icon{name="heroicons:eye"} 目のアイコン）をクリックします。
3. レポート詳細画面（/settings/reports/:id）が開きます。

3.2 画面の構成

レポート詳細画面は以下のように構成されています。

画面右上のボタン:

レポート詳細画面の画面右上には、ステータスに応じて以下のボタンが表示されます。

表示内容:

3.3 サマリと詳細モードの切り替え

レポート詳細画面では、「サマリ」「詳細」ボタンで表示モードを切り替えられます。

flowchart LR
    A["サマリモード"] -->|「詳細」ボタン| B["詳細モード"]
    B -->|「サマリ」ボタン| A

    style A fill:#fff3cd,stroke:#ff6f00,stroke-width:2px
    style B fill:#e3f2fd,stroke:#1565c0,stroke-width:2px

操作方法:

1. レポート詳細画面の上部にある 「サマリ」「詳細」ボタン をクリックします。
2. 表示が即座に切り替わります。

3.4 スナップショット機能（過去の不変性）

レポートは公開された時点の「項目名」「会社のロゴ」「表示の単位」などが**スナップショット（データの凍結）**として保存されます。

メリット:

• 将来、システム設定の項目名を変更しても、過去に公開したレポートの中身は当時のまま保証・保持されます。
• ユーザーに提供したレポートの見た目が勝手に変わることがありません。

!NOTE 公開後にマッピング設定や会社情報を変更しても、既存の公開済みレポートには影響しません。新しく作成するレポートから新しい設定が反映されます。

4. レポートの公開（共有）

作成したレポートをユーザーに共有する手順を説明します。

4.1 公開の全体フロー

flowchart TD
    A["1. レポート一覧から<br>対象レポートを選択"] --> B["2. レポート詳細画面を開く"]
    B --> C["3. 内容を確認"]
    C --> D["4. 「公開する」ボタンをクリック"]
    D --> E["5. ステータスが「公開」に変更"]
    E --> F["6. 短縮URL自動生成<br>(例: /r/ABC123XYZ)"]
    F --> G["7. 短縮URLをコピー"]
    G --> H["8. メール・LINE等で<br>ユーザーへ送信"]

    style E fill:#c8e6c9,stroke:#388e3c,stroke-width:2px
    style F fill:#fff3cd,stroke:#ff6f00,stroke-width:2px
    style H fill:#e3f2fd,stroke:#1565c0,stroke-width:2px

4.2 公開手順（詳細）

レポートを公開してユーザーに共有する手順を説明します。

ステップ1: レポート管理画面を開く

1. サイドメニューから 「レポート管理」 を選択します。
2. 公開したいレポートを一覧から探します。
   • ステータスが 「非公開」 になっているレポートを探してください。

ステップ2: レポート詳細画面を開く

1. 対象レポートの行全体をクリックします。
   • または 「詳細」ボタン（:icon{name="heroicons:eye"} 目のアイコン）をクリックします。
2. レポート詳細画面が開きます。

ステップ3: 内容を確認

1. レポートの内容を確認します。
   • 基本情報（レポート番号、採取日、圃場名など）が正しいか
   • 診断結果の数値が正しいか
2. 必要に応じて 「サマリ」「詳細」ボタン で表示を切り替えて確認します。

!TIP 公開前に必ず内容を確認してください。公開後も修正可能ですが、ユーザーがすでに閲覧している可能性があります。

ステップ4: 公開する

1. 画面右上の 「公開する」ボタン（緑色）をクリックします。
2. ステータスが 「公開」 に変更されます。
3. 同時に、ユーザー共有用の短縮URL（例: https://soil-report.cloud/r/ABC123XYZ）が自動的に発行されます。
4. 画面に 短縮URLが表示されます。

4.3 短縮URLのコピーと確認

公開後、レポート詳細画面に短縮URL表示エリアが表示されます。

短縮URLをコピーする:

1. 短縮URLの横にある 「コピー」ボタン（:icon{name="heroicons:clipboard-document"} クリップボードアイコン）をクリックします。
2. URLがクリップボードにコピーされます。
3. 「コピーしました」というメッセージが表示されます。

ユーザー向けプレビューで確認する:

1. 画面右上の 「ユーザー向けプレビュー」ボタン（青色）をクリックします。
2. 新しいタブが開き、ユーザーが見る画面と同じレポート表示（/r/:shortUrl）が表示されます。
3. ユーザーに見える内容を確認します。

!NOTE プレビューボタンは、レポートが「公開」状態の時のみ表示されます。

4.4 ユーザーへの通知

!IMPORTANT自動メール送信はありません 現在のPhase 1運用ルールでは、公開ボタンを押してもユーザーに自動でメールは送信されません。

短縮URLをユーザーへ送る:

コピーした短縮URLを、LINEやメール等の普段お使いのコミュニケーションツールでユーザーへ送信してください。

共有方法の例:

メッセージ例:

お世話になっております。
土壌診断レポートが完成しましたので、以下のURLからご確認ください。

https://soil-report.cloud/r/ABC123XYZ

ご不明点がございましたら、お気軽にお問い合わせください。

4.5 公開後の確認

ユーザーがレポートを閲覧すると、以下のように変化します。

レポート一覧画面:

• ステータス列の 「閲覧済」バッジ（:icon{name="heroicons:eye" class="text-blue-500"} 青色）が表示されます。
• 閲覧前は 「未閲覧」バッジ（:icon{name="heroicons:minus-circle" class="text-gray-400"} 灰色）が表示されています。

レポート詳細画面:

• 閲覧回数（view_count）が表示され、閲覧されるたびにカウントが増えます。

!NOTE 閲覧カウントは、ユーザーが短縮URL（/r/:shortUrl）からアクセスするたびに1増加します。同じユーザーが複数回閲覧すると、その回数分カウントされます。

5. 公開/非公開の切り替え

5.1 ステータス切り替えフロー

flowchart LR
    A["非公開<br>(draft)"] -->|「公開する」| B["公開<br>(published)"]
    B -->|「非公開にする」| A

    style A fill:#fff3cd,stroke:#ff6f00,stroke-width:2px
    style B fill:#c8e6c9,stroke:#388e3c,stroke-width:2px

5.2 非公開化の用途

間違って公開してしまった場合や、内容に誤りがあった場合は、「非公開にする」ボタンを押すことで:

• ステータスが draft に戻ります
• 短縮URLからのアクセスが遮断されます
• 管理者・メンバーは引き続き管理画面から閲覧・編集可能です

修正後、再度「公開する」ボタンで公開できます（同じ短縮URLが再利用されます）。

6. レポートの削除

レポートが不要になった場合や、誤って作成してしまった場合は、レポートを削除できます。

6.1 削除の方法

レポートの削除には2つの方法があります。

方法1: レポート一覧から削除

flowchart LR
    A["レポート管理画面"] --> B["対象レポートの行"]
    B --> C["「削除」ボタン<br>（:icon{name="heroicons:trash"}ゴミ箱アイコン）"]
    C --> D["確認ダイアログ"]
    D --> E["「削除」をクリック"]
    E --> F["削除完了"]

    style F fill:#ffcdd2,stroke:#c62828,stroke-width:2px

1. レポート管理画面（/settings/reports）を開きます。
2. 削除したいレポートの行を探します。
3. 「操作」列 にある 「削除」ボタン（:icon{name="heroicons:trash"} ゴミ箱アイコン）をクリックします。
4. 確認ダイアログが表示されます。
5. 「削除」ボタン をクリックすると、レポートが削除されます。

方法2: レポート詳細画面から削除

flowchart LR
    A["レポート詳細画面"] --> B["画面右上の<br>「削除」ボタン（赤色）"]
    B --> C["確認ダイアログ"]
    C --> D["「削除」をクリック"]
    D --> E["削除完了<br>レポート一覧に戻る"]

    style E fill:#ffcdd2,stroke:#c62828,stroke-width:2px

1. レポート詳細画面（/settings/reports/:id）を開きます。
2. 画面右上の 「削除」ボタン（赤色）をクリックします。
3. 確認ダイアログが表示されます。
4. 「削除」ボタン をクリックすると、レポートが削除されます。
5. レポート管理画面に自動的に戻ります。

6.2 削除の仕様

論理削除:

• レポートはシステムから完全に見えなくなり除外されます。
• データベース上は保持されますが、画面には一切表示されなくなります。

レポート番号の保持:

• 割り振られた「レポート管理番号」は欠番として保持され、使い回されることはありません。
• 例: RPT-2024-001 を削除しても、次に作成されるレポートは RPT-2024-002 となります。

短縮URLの無効化:

• 公開中のレポートを削除すると、短縮URL（/r/:shortUrl）からのアクセスも不可能になります。
• ユーザーがアクセスすると「レポートが見つかりません」というエラーが表示されます。

!WARNING削除したレポートは復元できません 削除前に必ず以下を確認してください:

• レポート番号、ユーザー名、圃場名が正しいか
• 本当に削除してよいレポートか
• ユーザーに通知済みで、今後も必要なレポートではないか

6.3 削除前の確認事項

レポートを削除する前に、以下を確認してください。

確認項目:

削除が推奨されるケース:

• 誤って作成してしまったレポート
• テストで作成したレポート
• ユーザーが削除を依頼したレポート
• 古すぎて不要になったレポート

削除が推奨されないケース:

• 公開中で、ユーザーが閲覧済みのレポート（非公開化を検討）
• 内容に誤りがあるレポート（削除ではなく編集で対応）

7. よくある質問

Q1. 公開したレポートを修正できますか？

A. はい。公開中のレポートでも編集可能です。修正は即座に反映されます。

Q2. 短縮URLは変更できますか？

A. いいえ。短縮URLは一度発行されると変更できません。同じレポートは同じURLで公開され続けます。

Q3. 公開したレポートが誰に見られたか確認できますか？

A. はい。レポート一覧の「閲覧済」バッジと、レポート詳細画面の「閲覧回数」で確認できます。

Q4. 一度非公開にしたレポートを再度公開できますか？

A. はい。「公開する」ボタンで再度公開できます。同じ短縮URLが再利用されます。

Q5. ユーザーに自動でメール通知されますか？

A. いいえ。現在のPhase 1では自動通知機能はありません。短縮URLを手動でユーザーへ送付してください。