業務プロセス
スタジオを組織でどう運用するかを整理したドキュメントです。誰でもアプリを作れる ツールのため、作る人と使う人を分けるルールがないと、すぐに混乱します。
チュートリアルとは異なります
チュートリアルが「アプリを1つ初めて作ってデプロイしてみる」なら、 このドキュメントは「複数の人が継続的に作り、使う」ことです。
役割は3つです
| 役割 | 業務 |
|---|---|
| admin | 環境設定・ユーザー管理・AIプロバイダー・デプロイ先 |
| builder | アプリを作成しデプロイする (アカウント作成時のデフォルト) |
| viewer | デプロイされたアプリを閲覧する |
アカウントは環境設定 → ユーザー管理で作成し、役割を付与します → 初期パスワード変更。
全員をbuilderにしないでください
デフォルト値がbuilderのため、そのまま作成すると全員がアプリを作成できてしまいます。アプリが増えるほど、
誰が何を作ったのかがわからなくなります。閲覧のみの人はviewerにしてください。
全体の流れ
矢印がレーンを越える場所が引き継ぎポイントです。
1. 導入 — 作成前に決めること
| 順序 | 業務 | 担当 |
|---|---|---|
| 1 | インストール → ワンラインインストール | admin |
| 2 | デフォルトパスワード変更 → 初期パスワード変更 | admin |
| 3 | AIプロバイダー接続 + 接続テスト → 環境設定 | admin |
| 4 | ビルド標準確定 — スタック・レイアウト・依存関係のロック | admin |
| 5 | アカウント発行・役割付与 | admin |
| 6 | 最初のアプリの試作 | builder |
4番を先に決めると後が楽になります
ビルド標準を開いたままにすると、人によって異なるスタックのアプリが作成されます。依存関係のロックと レイアウト規約の強制を有効にすると、成果物が均一になります → 環境設定(管理者)。
2. アプリ作成 — 要件からデプロイまで
| ステップ | 業務 | 成果物 |
|---|---|---|
| 要件整理 | 1画面 = 1文に分割する | 要件1行 |
| 生成 | ホームから文章で開始 → ホームからアプリ作成 | ドラフト画面 |
| 調整 | ビルダーで言葉で修正する → ビルダー | 完成画面 |
| レビュー | 依頼した人が実際に確認する | 確認 |
| デプロイ | デプロイドロワー → カタログと共有 | アプリURL |
| 共有 | URLを現場に連絡 | — |
チャット欄にパスワード・APIキーを貼り付けないでください
会話内容がアプリコードに残る可能性があります。キーが必要な場合はadminに依頼してください → シークレット管理。
3. 運用 — 周期のある業務
| 周期 | 業務 | 担当 |
|---|---|---|
| 毎日 | ワッチャー通知確認 → ワッチャーと通知 | 現場 |
| 週1回 | AI使用量・デプロイ失敗件数 | admin |
| 月1回 | 未使用アプリ整理、バックアップ復旧リハーサル | admin |
| 四半期 | キーローテーション → パスワード・APIキー変更 | admin |
トークンが急増した場合
ワッチャー周期が短すぎるか、「ビジョン自己検証」が有効なまま大量ビルドが実行された可能性が高いです。 統計画面でまず確認してください。
4. 現場ノウハウの蓄積
同じ指示を毎回書き直すのは無駄です。繰り返されるルールはスキルとして登録しておくと、 以降の生成に自動的に反映されます → 現場スキル。
| 登録する価値があるもの | 例 |
|---|---|
| 画面規約 | "全画面上部に会社ロゴ" |
| 色ルール | "稼働率80%未満は赤色" |
| 用語 | 現場で使用する設備略称 |
よくずれるポイント
| 症状 | 主な原因 |
|---|---|
| 「アプリが多すぎて何が何だかわからない」 | 命名規則なしで作成 + 未使用アプリを削除しない |
| 「人によって画面の見た目が異なる」 | ビルド標準を有効にしていない |
| 「AIコストが突然増えた」 | ワッチャー周期・ビジョン自己検証 |
| 「アプリ作成者が退職して修正できない」 | アプリも資産 — オーナーを決めて引き継ぎましょう |
| 「デプロイしたのに現場で開けない」 | ポート接続インストールでアプリリスナーポートがブロックされている |
関連ドキュメント
- チュートリアル — 最初のアプリを作成してデプロイする
- 環境設定(管理者) — ビルド標準・AIプロバイダー
- アプリカタログと共有
- バックアップと復旧