docs(i18n): translate configure/permissions/ and cloud/ into ja (#388, PR 4 of 7)

content/docs/cloud/ai-credits-and-limits.ja.mdx

@@ -0,0 +1,66 @@
+---
+title: AI クレジットと上限
+seoTitle: "ObjectOS Cloud の AI 利用枠：週ごとの上限、ペース、クレジットパック"
+description: ObjectOS Cloud で製品内 AI がどう計量されるか。構築と質問のための 1 つの利用枠、ローリングする週ごとの上限と 5 時間のペース、クレジットパック、各プランが使うモデル、そして拒否されたときのメッセージ。
+editions: [cloud, enterprise]
+translation:
+  source_sha: 67429e9e53ae8850c44792b0659fead909aa7791fb06d24d6153d6be29182837
+  guide_rev: 1
+  mode: auto
+---
+
+ObjectOS Cloud では私たちが AI モデルを実行するので、製品内 AI（[AI Builder](/docs/build/ai-builder) と、データについての質問に答えるアシスタント）は **AI 利用枠**を消費します。セルフマネージドの ObjectOS Enterprise のデプロイメントでは代わりに自分のモデルを用意し、このページの上限はどれも適用されません。[ObjectOS Enterprise の場合](#on-objectos-enterprise)を参照してください。
+
+## すべての AI の作業に 1 つの利用枠 [#one-allowance-for-all-ai-work]
+
+アプリの構築、データについての質問、アシスタントを通じたアクションの実行は、すべて**同じ利用枠**を消費します。作業の種類ごとの別々の予算はありません。各リクエストは、モデルがそのために行う作業に比例して利用枠を消費し、プランで選択肢がある場合、より高性能なモデルはより多くを消費します。
+
+利用枠は**環境**ごとに数えられます。クラウドコンソールの **Home** に、今週の利用枠をどれだけ使ったかが表示されます。
+
+## 2 つのローリングウィンドウ [#two-rolling-windows]
+
+すべてのプランに同じ 2 つの上限があり、どちらも**ローリング**です。使用量は一定の時間だけ数えられた後に外れるので、余裕はカレンダーの日付ではなく、連続的に戻ってきます。[cloud#2059](https://github.com/objectstack-ai/cloud/issues/2059) で決定されました。
+
+| ウィンドウ | 内容 | Free | Team 以上 |
+|---|---|---|---|
+| **7 日** | 予算：1 週間に収まる AI の作業量 | 環境ごとに週 1 回分の利用枠。厳格な上限です | AI シートごとのより大きな利用枠に、組織の AI シートの数を掛けたもの。[クレジットパック](#buy-ai-credits)で引き上げられます |
+| **5 時間** | ペース：短い集中した利用に収まる量。暴走したセッション 1 つが 1 週間分を使い切れないようにします | 適用されますが、Free の週ごとの利用枠より上にあります | AI シートごとで、シートの数を掛けます。クレジットパックでは引き上げられません |
+
+ObjectOS Cloud が[パブリックプレビュー](/docs/editions/public-preview)の間は、利用枠の正確な大きさは公表されません。Free の利用枠は、最初の体験全体（アプリを構築し、何度か変更し、それでもまだ質問できる）に合わせた大きさです。
+
+## 上限に達したとき [#when-a-limit-is-reached]
+
+リクエストは HTTP `429` で拒否され、チャットにはどの上限に達したか、いつ空くかを示すメッセージが表示されます。
+
+| 状況 | コード | メッセージ |
+|---|---|---|
+| Free、週ごとの利用枠を使い切った | `AI_DESIGN_QUOTA_EXHAUSTED` | *You've used this week's free AI quota. It resets on DATE — upgrade to keep going.* |
+| 有料、週ごとの利用枠を使い切った | `AI_ALLOWANCE_EXHAUSTED` | *Your AI allowance for this week is used up. It resets on DATE, or buy a credit pack to continue now.* |
+| どのプランでも、5 時間のペースに達した | Free では `AI_DESIGN_QUOTA_EXHAUSTED`、有料プランでは `AI_ALLOWANCE_EXHAUSTED` | *You've hit the five-hour AI usage limit. It resets within five hours — then you're good to go.* |
+
+日付は、まだ数えられている最も古い使用量がウィンドウから外れる時点です。エラーの `details.resetsAt` は、同じ時点を ISO タイムスタンプで持っています。環境のほかのものには影響しません。アプリ、データ、連携は動き続けます。
+
+## AI クレジットを購入する [#buy-ai-credits]
+
+有料プランでは、オーナーまたは管理者が、一回限りの **AI クレジットパック**で週ごとの利用枠を補充できます。環境の **Settings → Plan and billing** を開き、**AI credits** → **Buy AI Credits** を選びます。新しいタブで安全なチェックアウトが開きます。
+
+- クレジットパックが引き上げるのは **7 日**の予算だけです。5 時間のペースはレート制限であり、購入で引き上げることはできません。
+- Free はクレジットパックを受け付けません。Free の週ごとの上限を超える方法は [Team へのアップグレード](/docs/cloud/plans-and-seats#upgrade)です。
+- 組織でクレジットパックがまだ販売されていない場合、ボタンはチェックアウトを開く代わりにそのことを伝えます。
+
+## どのモデルが答えるか [#which-model-answers]
+
+すべてのプランは**同じデフォルトのモデル**で答えます。有料プランが Free と違うのは利用枠の大きさであって、より強力なモデルではありません。有料の環境でモデルの選択肢が提供されている場合は、AI チャットで選べます。より高性能なモデルは利用枠をより早く減らします。
+
+## 自分のクライアントを通じた AI はここでは計量されない [#ai-through-your-own-client-is-not-metered-here]
+
+[MCP](/docs/configure/mcp) で接続するエージェント（Claude Code、Cursor など）は、**あなたの**モデルとあなた自身のトークンで動きます。AI 利用枠は消費しません。その制限となるのは、環境の MCP リクエストの上限です（[ストレージと上限](/docs/cloud/storage-and-limits#mcp-limits)）。
+
+## ObjectOS Enterprise の場合 [#on-objectos-enterprise]
+
+セルフマネージドの Enterprise のデプロイメントは、[AI サービス](/docs/configure/ai)で設定する独自のモデルとキーを用意し、モデルのプロバイダーに直接支払います。プラットフォームの AI クレジットも、利用枠も、計量もありません。AI シートごとの料金はライセンスであって、使用量のパッケージではありません。デプロイメントがどれだけの AI の作業をするかは、自分のプロバイダーのアカウントによってのみ制限されます。
+
+## 次へ [#next]
+
+- [プランと AI シート](/docs/cloud/plans-and-seats)：各プランに含まれるもの。
+- [AI Builder](/docs/build/ai-builder)：AI が構築できるもの。

content/docs/cloud/apps.ja.mdx

@@ -0,0 +1,113 @@
+---
+title: アプリ
+seoTitle: "ObjectOS Cloud のアプリ：インストール、更新、公開、CLI からのデプロイ"
+description: ObjectOS Cloud の環境にアプリをインストールし、更新を確認し、環境のアプリを組織向けのパッケージとして公開し、ローカルでビルドしたアプリを os CLI からデプロイします。
+editions: [cloud]
+translation:
+  source_sha: 0adc0c246817f68e5c28824736e064a5591eadd4b69aa953dd25f91a3c85a4a0
+  guide_rev: 1
+  mode: auto
+---
+
+アプリが ObjectOS Cloud の環境に届く方法は 3 つあります。マーケットプレイスまたは組織のレジストリから**インストール**する、環境の中で（[AI Builder](/docs/build/ai-builder) を使うか手作業で）**構築**する、または自分のマシンから `os` CLI で**公開**する、のいずれかです。どの方法でも、インストールされるのは[パッケージ](/docs/build/packages)、つまりオブジェクト、ビュー、フローなどをまとめたバージョン付きのバンドルです。
+
+## アプリをインストールする [#install-an-app]
+
+クラウドコンソールで環境の **Settings → Apps** を開き、**Install an app**（**Install Application**）を選びます。アプリを選んでから、次を設定します。
+
+- **Include sample data**：パッケージのデモレコードで環境を埋め、すぐに試せるようにします。クリーンな本番環境ではチェックを外したままにします。
+- **Accept additional permissions**：初回のインストールではチェックを外したままにします。これは、以前に付与された権限より多くの権限を求める更新のためのものです（[更新を確認する](#check-for-updates)を参照）。
+
+アプリは再起動なしで、環境への次のリクエストから表示されます。インストール後のメッセージには、どのように反映されたか（インストール、再インストール、更新、ロールバックのいずれかと、そのバージョン）と、知っておくべきこと（アプリが使う機能のうちプランに含まれないものなど）が表示されます。
+
+環境の中からインストールすることもできます。環境の **Marketplace** を開き、アプリを見つけて **Install** を選びます。どちらの方法でも、同じパッケージが同じ環境にインストールされます。[マーケットプレイス](/docs/build/marketplace)を参照してください。
+
+インストールは組織のオーナーと管理者が行います。
+
+## 更新を確認する [#check-for-updates]
+
+**Settings → Apps → Check for app updates** は、インストール済みの各アプリを公開されている最新バージョンと比較し、更新があるか、すべてのアプリが最新か、まだ何もインストールされていないかを表示します。
+
+アプリを更新するには、もう一度インストールします。すでにインストールされているアプリをインストールすると、その場で公開済みの最新バージョンに移行します。
+
+新しいバージョンが、アプリに以前付与されていなかった権限を求める場合、更新は `PERMISSION_RECONSENT_REQUIRED` で拒否され、メッセージに追加される各権限が一覧表示されます。内容を確認してから、**Accept additional permissions** にチェックを入れてもう一度インストールし、権限を付与します。
+
+## 環境をパッケージとして公開する [#publish-an-environment-as-a-package]
+
+**Settings → Apps → Publish as a package**（**Publish to Registry**）は、この環境で構築したアプリを、組織のレジストリにあるパッケージの新しいバージョンとして公開します。そこから組織の他のどの環境にもインストールできます。開発環境で構築したアプリは、この方法で本番環境に届きます。
+
+| フィールド | 意味 |
+|---|---|
+| **App Name** | レジストリに表示される名前。デフォルトは環境の名前です。 |
+| **Version** | `1.2.0` のようなセマンティックバージョン。空欄のままにすると、最新バージョンの次のパッチとして公開されます。 |
+| **Visibility** | **Private**：自分の組織だけがインストールできます。**Organization**：組織全体で共有されます。 |
+| **Description** | アプリ全体として何をするか。 |
+| **Release notes** | このバージョンでの変更点。バージョンとともに表示されます。 |
+| **Package ID**（詳細設定） | 逆ドメイン形式の識別子。空欄の場合は環境の名前から導出されます。 |
+
+公開マーケットプレイスへの掲載は、審査を伴う別の手順であり、ここでは提供されません。サイドバーの **Advanced → Packages** に、組織が公開したものがすべて一覧表示されます。
+
+## CLI からデプロイする [#deploy-from-the-cli]
+
+アプリをコードとして（自分のマシン上の ObjectStack プロジェクトとして）開発している場合、`os` CLI でそれを組織に公開し、環境にインストールできます。流れは **ログイン → ビルド → 公開 → インストール** です。
+
+必要なものは、ObjectStack プロジェクト（[Path B — `os init`](/docs/start/community#path-b--os-init-developer) を参照）、`os` CLI、そして環境を持つ ObjectOS Cloud アカウントです。
+
+### 1. ログイン [#1-log-in]
+
+```bash
+os cloud login
+```
+
+これはブラウザのサインインを開き、クラウドトークンを `~/.objectstack/cloud.json` に保存します。サインインリンクを開く代わりに表示するには `--no-browser` を使います。CI ではログインを省略し、`--token` または `OS_CLOUD_API_KEY` 変数で `os package publish` に API キーを渡します。
+
+クラウドログインは、ランタイムにサインインする `os login` とは別のものです。公開には常にクラウドログインが使われます。
+
+### 2. ビルド [#2-build]
+
+```bash
+os build
+```
+
+これはプロジェクトをひとつのアーティファクト `dist/objectstack.json` にコンパイルします。オブジェクト、ビュー、アプリ、ダッシュボード、フロー、サンプルデータが含まれます。後でアップロードされるのはこのアーティファクトだけで、ソースファイル、`node_modules`、ローカルの認証情報がアップロードされることはありません。
+
+### 3. 公開 [#3-publish]
+
+```bash
+os package publish
+```
+
+プロジェクトのルートで実行します。パッケージを組織に登録し（初回のみ。`com.acme.crm` のような逆ドメイン形式のパッケージ id をキーとします）、アーティファクトを新しい不変のバージョンとして公開します。同じバージョンを 2 回公開することはできません。`manifest.version` を上げるか、`--version` を渡します。
+
+| フラグ | 目的 |
+|---|---|
+| `--manifest-id <id>` | 逆ドメイン形式のパッケージ id。デフォルト：アーティファクトから導出 |
+| `--version <semver>` | 公開するバージョン。デフォルト：`manifest.version` |
+| `--visibility <private\|org\|marketplace>` | 誰が表示・インストールできるか。ObjectOS Cloud では新しいパッケージのデフォルトは `org` です。既存のパッケージの公開範囲を維持するにはフラグを省略します |
+| `--install` | 新しいバージョンをすぐに環境にインストールします |
+| `--env <id>` | `--install` の対象環境。デフォルト：`os environments switch` で選択した環境 |
+| `--seed-sample-data` | インストール時にアーティファクトのサンプルデータを含めます |
+| `--note "<text>"` | リリースノート |
+| `--submit` | `marketplace` パッケージの新しいバージョンを審査に提出します |
+
+### 4. インストール [#4-install]
+
+利用者は環境からインストールします。環境の **Marketplace** を開き、パッケージを見つけて **Install** を選ぶか、[前述](#install-an-app)のクラウドコンソールの **Install an app** を使います。
+
+既知の環境にデプロイするパイプラインは、ひとつのコマンドで公開とインストールを行えます。
+
+```bash
+os package publish --env <environment-id> --install --seed-sample-data
+```
+
+これは全か無かです。インストールが拒否された場合（その環境にインストールできない、環境が存在しない、またはそのバージョンがその環境で承認されていない）、何も公開されません。コマンドは拒否内容を表示してゼロ以外で終了するため、パイプラインは失敗します。原因を修正し、同じバージョンをもう一度公開してください。
+
+### マーケットプレイスへの掲載 [#marketplace-listings]
+
+`--visibility marketplace` はパッケージを公開カタログの対象にしますが、新しいバージョンはそれぞれ**下書き**として届きます。審査に送るには `--submit` を渡します。プライベートと組織のパッケージは審査が不要で、組織はすぐにインストールできます。
+
+## 次へ [#next]
+
+- [パッケージ](/docs/build/packages)：パッケージに含まれるものと、バージョンの仕組み。
+- [マーケットプレイス](/docs/build/marketplace)：環境の中からの閲覧とインストール。
+- [CLI リファレンス](/docs/reference/cli)：すべての `os` コマンド。