HQBase

HQBaseについて

HQBaseは、アプリケーション、メール、Cloudflare認証情報を顧客のインフラに保持しながら、チームに共有メールボックスを扱うための単一の場所を提供します。含まれるもの：

• 共有メールボックスとチームアクセス制御。

• マルチドメイン設定、下書き、監査履歴。

• インストール、更新、バックアップ、リカバリ操作。

• OAuthで保護されたリモートMCPサーバー。

インストール、日常利用、アーキテクチャ、運用については、製品ドキュメントを参照してください。

Related MCP server: Gmail MCP Connector

ローカル開発

アプリケーションを起動

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

オプションのシードコマンドを実行する前に、これらの値を.dev.varsに追加してください：

• BETTER_AUTH_SECRET

• HQBASE_LOCAL_SEED_PASSWORD（8〜128文字）

シードコマンドはローカルのD1にのみ書き込み、Cloudflare OAuthには接続しません。http://127.0.0.1:5173/を開き、owner@hqbase.testとしてそのパスワードでサインインしてください。Viteはポート5173でライブリロード付きのフロントエンドを提供し、APIリクエストをポート8787のWrangler Workerにプロキシします。

初回セットアップフローを使用するには、シードコマンドを省略してhttp://localhost:5173/setupを開いてください。

ローカルデータのリセット

すべてのローカルD1データを破棄し、スキーマを再構築し、デモワークスペースを再作成するには：

pnpm db:reset:local
pnpm db:seed:local

リセットコマンドは破壊的で、ローカルのみに影響します。デプロイ済みのデータベースは変更されません。

セットアップインターフェースのプレビュー

プレゼンテーション専用のオンボーディング作業用：

pnpm dev:setup-ui

http://127.0.0.1:5173/__ui/setupを開いてください。

変更の検証

完全なローカル品質ゲートを実行：

pnpm check
pnpm deploy:dry-run

wrangler.jsoncを変更した後、pnpm cf:typegenを実行してください。

mainへのプッシュは同じ品質ゲートとデプロイのドライランを実行します。デプロイされたステージングは手動で、署名付きリリースワークフロー内でも実行されます。リリースは、以前の安定版が正確な署名付き候補にアップグレードし、そのチェックに合格するまでドラフトのままです。顧客のインストールと更新は、デプロイ前に署名付きマニフェストとアーティファクトダイジェストを検証します。

ドキュメント

hqbase.io/docsは、ユーザーおよびオペレーター向けガイド、製品仕様、メンテナー手順の公開ソースです。

コントリビューション

プルリクエストを開く前に、コントリビューションガイドをお読みください。

セキュリティ

脆弱性を報告するには、セキュリティポリシーのプライベートプロセスに従ってください。

ライセンス

HQBaseはGNU Affero General Public License v3.0 onlyの下で利用可能です。