# ファイルと権限

> チームのフォルダー、フォルダーのルール、そして AI が開くすべてのファイルをサーバーが依頼した本人の権限で確認する仕組み。

会社の知識は、サーバー上の 1 つのチームフォルダーに入っています。誰が何を見られるかは、フォルダーのルールで決まります。AI が依頼した本人より多くのものを見ることはありません。

## チームのフォルダー

| フォルダー | 見える人 | 用途 |
|---|---|---|
| `shared/` | ルールのとおり。ふつうは全員 | 全社向けの資料 |
| `groups/<group>/` | そのグループと、ルールで追加された人 | 営業や経理などのチームの資料。そのグループのスキルは中の `skills/` に置きます |
| `projects/<project>/` | ルールのとおり | 専用のフォルダーと指示を持つ仕事 |
| `skills/` | 全員が読めます。書き込めるのはスキル管理者です | チームスキルとチームのルール |
| `users/<id>/` | 本人だけ | 個人のファイルと個人のスキル |

## アクセスの決まり方

サーバー上の 1 つの権限チェックが、すべてのアクセスを判断します。AI がそれを迂回できないよう、OS が防いでいます。

- 開けないファイルは「拒否」されるのではなく、**見えなくなります**。ファイル画面、AI の回答、検索、プレビュー、バージョン履歴、ゴミ箱、リアルタイムの更新もすべて同じルールに従います。
- ある人のアクセスは、ファイルの上にあって、その人を指定している **いちばん近いルール** で決まります。人のルールはグループのルールより優先されます。複数のグループに入っている場合は、いちばん広いアクセスが適用されます。
- 変更は **すぐに** 反映されます。AI はツールを使うたびに権限を読み直します。
- アクセスを外しても、それまでにそのファイルを引用した回答は消えません。

## フォルダーを共有する

オーナーと管理者は、Google Drive と同じようにフォルダーを共有します。**ファイル › フォルダーの ⋯ › 共有**、または **管理 › フォルダーの権限 › 共有** を使います。どちらも同じダイアログが開きます。

1. **ユーザーやグループを追加する**

   名前を入力します。一人ひとり、またはグループごとに **閲覧者** か **編集者** を選びます。**アクセス権を削除** も同じメニューにあります。

2. **一般的なアクセスを確認する**

   **制限付き** の場合は、一覧にある人だけが開けます。またはチーム全体を **閲覧者** か **編集者** にします。独自の設定がないフォルダーには、上のフォルダーから受け継いだ内容が **そこで変更** と一緒に表示されます。

3. **保存する前に確認する**

   ダイアログには、誰がアクセスできるようになるか、誰ができなくなるかが表示されます。保存するまで何も変わりません。アクセスを広げるときは先に確認されます。上のフォルダーで入れる人を締め出す制限をかけるときも、同じく確認されます。

![「Marketing」の共有ダイアログ：ユーザーやグループを追加、アクセスできるユーザーに閲覧者の Sam Ortiz、「budget」から受け継いだ編集者の Dana Brooks（そこで変更つき）、管理権限のオーナーと管理者、その下に一般的なアクセスの制限付きと、設定 › アクセスを制限](../../images/files/share-dialog.webp "フォルダーの共有ダイアログ")

アクセスは Google Drive と同じように足し算です。フォルダーで与えたアクセスは、上のフォルダーで与えたアクセスに上乗せされます。それより低い役割は選べません。その行には、高い役割がどこから来ているかが表示されます（「「全社共有」から受け継いだ編集者」）。

上のフォルダーより少ないアクセスにするには、**設定 › アクセスを制限** をオンにします。すると、そこに追加した人とグループだけが開けるようになります。**アクセス権が削除されました** には、上のフォルダーは開けてもこのフォルダーは開けない人が一覧で表示されます。**追加** を押すと、その人を閲覧者として戻せます。制限をまたオフにすると、上のフォルダーより低い役割は、上のフォルダーと同じレベルに引き上げられます。

オーナーと管理者は、チームのフォルダーをいつでも開けます。ただし、自分がメンバーでないプロジェクトは除きます。オーナーと管理者は、**管理権限** の 1 行にまとめて表示されます。

> **注意:** アクセスが足し算になったアップデートのあと、一部のフォルダーでは人が名前で一覧に載っています（**フォルダーの仕組みが変わったときに追加** というタグつき）。フォルダーの権限には、その人たちの名前を示すお知らせが 1 回だけ表示されます。名前で追加された人は、あとでグループを抜けてもアクセスが残ります。**管理 › グループ** とその人のページでは、保存する前にそのことが表示され、**今すぐ外す** を選べます。

**管理 › フォルダーの権限 › フォルダー** には、入っているフォルダーと違う共有のしかたをしているフォルダーだけが、ファイル画面と同じ名前で一覧表示されます。人を締め出しているフォルダーには **制限あり** と表示されます。**共有** を押すと、そのフォルダーの共有ダイアログが開きます。プロジェクトのフォルダーは 1 行にまとまります。メンバーはプロジェクトの側で変更します。

![管理 › フォルダーの権限 › フォルダー：違う共有のしかたをしているフォルダーと、それぞれの共有相手と共有ボタン](../../images/files/folder-permissions.webp "フォルダーの権限のフォルダー")

**人が開けるもの** には、1 人の人（つまりその人の AI）について、フォルダーごとに閲覧者か編集者かとその理由、そして開けないフォルダーが表示されます。

> **警告:** `skills/` には、メンバー全員の AI が従う指示が入っています。ここに書き込める人はスキル管理者になります。AI が `skills/` に保存する前に、サーバーが人に確認を求めます。グループの `groups/<group>/skills/` も同じです。そのグループのメンバー全員の AI が従い、グループのフォルダーに書き込めるメンバーなら誰でも変更できます。

![人が開けるもの：フォルダーごとの閲覧者または編集者とその理由、その下に開けないもの](../../images/files/by-person.webp "人が開けるもの")

## ファイルを扱う

![ファイル画面：全社共有、グループ、プロジェクト、チームスキル、個人が並ぶチームのフォルダー](../../images/files/files.webp "ファイル画面")

![スマートフォンのファイル：最近のファイル、チームフォルダー、プロジェクトフォルダー、自分のファイル、ゴミ箱](../../images/files/files-phone.webp "スマートフォンのファイル")

- **アップロード**：ファイル画面から、ファイルやフォルダーごとアップロードします。
- **バージョン履歴**：変更のたびにバージョンが残り、開いたり復元したりできます。
- **ゴミ箱**：**ファイル › ゴミ箱** には、復元できるものが、名前と元の場所つきで表示されます（「price-sheet.xlsx · 全社共有 › Sales」）。何度も削除されたファイルは、コピーをまとめて 1 行で表示されます。**復元** を押すと最新のものが戻り、行を開くとほかのコピーも復元できます。ほかの人が削除したものも一覧にある場合は、**自分が削除** で自分の分だけを表示できます。チームの保存期間（管理 › チーム設定。標準は 30 日）が過ぎると、完全に削除されます。それぞれの行に、いつ削除されるかが表示されます。
- **形式**：AI は PDF、Office、HWP/HWPX のファイルから文字を読み取り、写真やスキャンしたページは画像として見ます（管理者はこれをオフにできます）。Linux サーバーでは OCR は行いません。
- **確認**：見られる人が限られた内容を、より多くの人が見られる場所に AI が書き込もうとするときは、サーバーが先に確認します。

## HTML を PDF にする

AI が作った見積書や報告書などの HTML ファイルを、ページと同じ見た目の PDF にできます。色や背景、結合した表のセル、ページ自身の `@page` ルールで決めた用紙サイズと余白（指定がなければ A4）、改ページもそのまま反映されます。

- **プレビューから**：`.html` ファイルを開き、プレビューの上部にある **PDFとして保存** を押します。PDF はページと同じ名前で、その隣に保存され、お知らせにリンクが表示されます。同じページの PDF を 2 つ目に作ると `name (2).pdf` として保存され、1 つ目を上書きすることはありません。読み取りしかできないフォルダーでは、代わりに PDF がダウンロードされます。スマートフォンでは **⋯** メニューにあります。
- **AI に頼む**：「quote.html を PDF にして」と頼みます。AI はページをそのまま印刷します。Markdown に書き直すことはありません。
- **PDF に使われるもの**：ページと、チームのフォルダーにあるそのページ用の画像、スタイルシート、フォントを相対パスで使います。Web のアドレスは読み込みません。Web 上の画像は、プレビューと同じく灰色の四角で表示されます。画像をチームのフォルダーに保存して、パスで指定してください。ページの中のスクリプトは動かないため、スクリプトで描く部分は表示されません。その部分はふつうの HTML で書いてください。
- **上限**：200 ページ、50 MB まで。1 ページにつき約 1 分かかります。サーバーでは一度にいくつかの PDF だけを作り、残りは順番を待ちます。
- **使える環境**：サーバーは、変換用のサンドボックスの中で、ネットワークなしのヘッドレス Chromium を使って印刷します。Linux サーバーでは、Debian の `chromium` パッケージが入っていれば使えます（開発環境はこれをインストールします。開発環境で作ったホスティング用のサーバーイメージにも入っています）。Linux サーバーでは、印刷ごとにほかの変換とは別のメモリ上限がかかり、サーバーに 3 GB 以上のメモリが必要です（同時に 2 つ印刷するには 6 GB から）。ブラウザーがないサーバーや、メモリが足りないサーバーでは、この操作は表示されず、AI は HTML を印刷できないと答えます。管理者は `MYCEL_HTML_PDF_BROWSER` でブラウザーを指定できます（[環境変数](/docs/reference/environment.md)（英語））。

詳しくは、[セキュリティと権限](https://github.com/trina-app/trina-ax/blob/main/docs/security-and-permissions.md)（英語）と[権限モデル（韓国語）](https://github.com/trina-app/trina-ax/blob/main/docs/PERMISSIONS.md)を参照してください。
