KiHub icon

KiHub

KiHubはKiCadプロジェクト向けのハードウェアレビュー用プラットフォームです。ビジュアル差分、チェック、ピン留め議論、GitHub連携の追跡可能な判断で、回路図とPCBの変更を文脈の中で確認できます。

KiHub

KiCadプロジェクト向けのハードウェアレビュー用ワークスペース

KiHubはKiCadプロジェクト向けのハードウェアレビュー用プラットフォームです。KiCadでの作成とマージ判断の間に、ブラウザベースのレビュー用ワークスペースを追加し、チームがファイル差分だけに頼らず変更を文脈の中で確認できるようにします。

この製品は編集やリポジトリホスティングではなく、レビューに重点を置いています。KiCadは設計ツールのまま、GitHubは信頼できる唯一の情報源のままであり、KiHubは回路図とPCBの変更に対してビジュアル差分、レビュー用チェック、ピン留め議論、監査可能な判断履歴を重ねます。

チームはGitHubのプルリクエストを自動的にレビューすることも、ブランチ、タグ、コミットを含む任意の2つのリビジョンをオンデマンドで比較することもできます。このワークフローは、リビジョンが承認される前に、ERC、DRC、BOMの完全性、設計ディスカッションなどの準備シグナルを一か所で確認できるように設計されています。

KiHubは制御された共有もサポートします。レビューリンクは読み取り専用ページとして公開でき、セキュリティモデルはリポジトリスコープのアクセス、一時的なソース処理、リポジトリへの書き込みアクセスが不要であることを重視しています。

主な機能

ビジュアルおよびセマンティックな差分

ベース/ヘッドの比較を用いるブラウザベースのワークスペースで、回路図とPCBの変更を確認できます。ビューは、KiCadの構文の生データだけでなく、変更されたハードウェアオブジェクトを表示するよう設計されています。

レビューチェックと準備ゲート

ERC、DRC、回路図からPCBへの整合性、BOMの完全性、プロジェクトポリシーをレビュー工程の一部として表示します。チェックは、情報 संकेतではなく必須ゲートとして表示でき、レビュー担当者がマージ前に準備状況を判断できます。

ピン留めされた設計ディスカッション

質問や修正依頼を、該当する回路図シート、部品、フットプリント、配線、または基板上の位置に紐づけます。スレッドはソースファイルの行番号ではなく、設計コンテキストに関連付けられたまま残ります。

追跡可能なレビュー記録

何が変更されたか、どのチェックが通ったか、誰がそのリビジョンを承認したか、そしてなぜマージ可能だったのかを永続的に記録します。レビュー活動と判断履歴はリビジョンに紐づいたまま維持されます。

PRと手動レビューのワークフロー

GitHubのプルリクエストから開始するか、ブランチ、タグ、コミットを含む任意の2つのリビジョンをオンデマンドで比較できます。KiHubはプルリクエストの更新に合わせてレビューを最新に保ち、PRなしの手動比較もサポートできます。

一般的なレビューシナリオ

  • ハードウェアのプルリクエストをレビューする

    プルリクエストで回路図やPCBが変更され、マージ前にその影響をチームが把握する必要があるときにKiHubを使用します。レビュー担当者は、複数のツールから状況をつなぎ合わせる代わりに、1つのワークスペースでビジュアルな証拠、チェック、スレッドを確認できます。

  • 任意のリビジョンを比較する

    まだPRに含まれていない2つのリビジョン、たとえばブランチとタグ、または1つのコミットと別のコミットを比較する必要があるときに、手動比較フローを使用します。これにより、特定のハードウェアリビジョンを独立してレビューできます。

  • 設計変更を文脈の中で議論する

    コメントがソースファイルの行ではなく、コンデンサ、コネクタ、配線、フットプリント、または基板領域を参照する必要があるときに、レビュー用ワークスペースを使用します。ピン留めされたスレッドによって、議論は設計コンテキストに結び付いたままになります。

  • マージ前に準備状況を評価する

    承認がERC、DRC、回路図からPCBへの整合性、BOMの完全性、またはプロジェクトポリシーなどの準備シグナルに依存する場合に、チェック表示を使用します。レビュー記録は、これらのシグナルを最終的なマージ判断とは切り離して保持します。

  • レビューを外部またはチーム間で共有する

    現在のレビュー状態を確認できるが、編集、マージ、チェックの再実行はできない関係者と共有したい場合に、制御された読み取り専用リンクを使用します。リンクは取り消し可能で、有効期限を設定できます。

Pros and Cons

Pros

  • レビューに意図的に特化しているため、編集用のKiCadやGitHubの代替にはなりません。
  • サイトでは、レガシーまたは混在バージョンのプロジェクトへの対応について、評価前にチームへ確認するよう案内しています。
  • 公開レビューページは読み取り専用なので、編集やマージではなく、証拠の共有を目的としています。

Cons

  • ファイル差分に依存するのではなく、ハードウェアを意識したブラウザーワークスペースでKiCadの変更を表示します。
  • ビジュアル差分、チェック、ディスカッション、判断履歴を1つのレビュー記録にまとめます。
  • プルリクエストのレビューと、ブランチ、タグ、コミットをまたぐ手動比較の両方をサポートします。
  • リポジトリスコープのGitHub Appを使用し、リポジトリへの書き込みアクセスを必要としません。
  • 必要に応じて、他者と共有するための制御された読み取り専用レビューリンクを公開できます。

FAQ

KiHubはKiCadやGitHubの代わりになりますか?

いいえ。KiHubはKiCadとGitHubの間にあるレビュー層として位置づけられています。エンジニアはKiCadで設計を続け、GitHubはリポジトリと信頼できる唯一の情報源のままです。

どのKiCadプロジェクトがサポートされていますか?

KiHubは最新の .kicad_sch および .kicad_pcb プロジェクトで動作します。接続時にリポジトリのツールチェーンが選択され、レガシーまたは混在バージョンのプロジェクトを評価する前にはKiHubに問い合わせることが推奨されています。

KiHubにはどのようなGitHubアクセスが必要ですか?

KiHubは、リポジトリ内容、プルリクエスト、メタデータ、および関連する組織メンバーシップイベントへの読み取りアクセスを持つGitHub Appを使用します。GitHub Checksを通じてレビュー状態をプルリクエストに返すことはできますが、リポジトリへの書き込みアクセスは必要ありません。

プライベートな設計ファイルはどうなりますか?

元のKiCadソースファイルは、レビュー用モデルとアーティファクトを生成するために一時的に処理され、その後、処理完了時にアクティブな処理ストレージから削除されます。

公開レビューリンクはどのように機能しますか?

公開レビューリンクは、リンクを知っている人なら誰でもアクセスできる読み取り専用のリンクで、取り消しや有効期限の設定が可能です。KiHubはプルリクエストレビューや手動比較レビューを自動的に公開することはなく、ユーザーがリンクを作成する必要があります。

Quick Facts

カテゴリ
ハードウェアレビュー用プラットフォーム
主なユーザー
KiCadプロジェクトに取り組むハードウェアチーム
ワークフロー
GitHubのプルリクエストレビューと、ブランチ・タグ・コミットの手動比較
統合モデル
リポジトリスコープの読み取りアクセスを持つGitHub App
対応プロジェクトタイプ
最新の .kicad_sch および .kicad_pcb プロジェクト
価格状況
公開リポジトリは無料、プライベートリポジトリはベータ期間中無料