ドキュメント

実装ガイド

組織全体に向けてCoRoidを導入するための8段階の手順で、顧客との初回ミーティングから90日目のレビューまでをカバーします。

本ガイドは、組織にCoRoidを導入する担当者を対象としています。その人を「実装担当者」と呼び、導入先の組織を「顧客」と呼びます。実装担当者は顧客のために働く場合もあれば、顧客が雇用する企業で働く場合もあります。

開始するでは、新規アカウントの担当者をマージ済みのpull requestまで導入します。本ガイドではそれ以降の内容を扱い、CoRoidを組織全体のシステム、ルール、プロセスに合わせて設定します。

8つの段階

各段階では文書または成果物が生成され、すべて顧客が保持します。段階は順番に実施し、前の段階が完了してから次の段階に進んでください。

段階生成されるもの完了条件
1調査調査文書:顧客の目標、システム、ルール、および対象となるプロセス顧客が文書に同意すること
2インストール作業に必要なプランの下で、CoRoid内に顧客の組織を作成します。顧客のオーナーにはOwnerロールが割り当てられ、各実装担当者はメンバーとなります。
3接続Gitホスト、サインイン情報、チャットチャンネル、ツールを接続します。CoRoidがリポジトリを読み取れるようになり、各ユーザーは自身のアカウントでサインインできます。
4設定プロジェクト、品質管理、指示事項、AIプロファイル、自動化処理、ワークフロー、レビュールール、スキルを設定します。調査文書に記載された各ルールに対応する設定が行われるか、CoRoidへの要求がなされます。
5パイロット運用1つのプロジェクトと1つのワークフローを2週間実際に使用します。2週間が終了し、顧客が本番稼働を決定します。
6本番稼働本番稼働チェックリストで、顧客の署名が必要です。顧客がチェックリストに署名します。
7引き継ぎ引き継ぎノート、およびエクスポートされた設定とワークフロー文書です。顧客がこれらを取得し、外部からのアクセスは無効化または制限されます。
890日目のレビュー90日目の評価結果と変更事項の一覧です。顧客が一覧に同意します。

作業の大半は第1段階と第4段階で行われます。簡易的な調査では後に誰も説明できない設定が生まれます。

決定権者

決定権は顧客にあります。実装担当者は問い合わせ、提案し、設定を行います。

  • 顧客は自社を代表して決定する人物を指名します。その人物がCoRoid内の組織を管理し、本番稼働チェックリストに署名します。
  • 実装担当者は各決定事項とその理由を記録します。引き継ぎノートはこれらの記録に基づいて作成されます。
  • 要件が不明確な場合は顧客に確認してください。ルールを推測してはいけません。

コンサルタント向けのアクセスルール

「コンサルタント」とは、顧客のために働かない実装担当者のことです。コンサルタントはこれらのルールに従って顧客の組織内で作業します。

  • 各人に個別のアカウントを割り当てます。各コンサルタントは自身のアカウントでサインインします。1つのアカウントで複数の組織に参加できるため、コンサルタントは各顧客で同じアカウントを使用します。
  • 共有アカウントは使用しません。他人になりすがってサインインしたり、パスワード、アクセストークン、復旧コードを共有したりしては決して実行しないでください。
  • 顧客のサインインルールプロファイルで二要素認証を有効にしてください。顧客がシングルサインオン(SSO)を要求する場合、顧客は自身のIDプロバイダー内にアカウントを提供します。
  • 作業に必要な最低限のロール顧客は各コンサルタントを設定 → メンバーに招待します。本ガイドでの作業にはAdminロールが必要です。Ownerロールは顧客が保持します。詳細は チームを招待する。
  • 引き継ぎ時にアクセスを無効化します。引き継ぎ時には、顧客が各コンサルタントのアカウントを削除するか、意図的に低いロールを割り当てます。その前に、各コンサルタントは自身が作成したアクセストークンを無効化します。詳細は引き継ぎ。
  • 顧客データを顧客のシステム外に持ち出してはいけません。コード、タスク、ケース、エクスポートデータを自身のコンピュータやシステムにコピーしてはいけません。設定バンドルなどのエクスポートファイルは顧客に渡され、そこに保存されます。

コンサルタントはメンバーが2人以上のプランを利用する組織にのみ参加できます。Freeプランではオーナーが唯一のメンバーです。詳細はプランと料金。

開始前に

まずこれらのページをご覧ください。本ガイドではこれらのページへのリンクを掲載しており、内容を繰り返しません。