プロジェクト

プロジェクトとは

プロジェクトは、アプリケーション開発の中心となる機能です。コードの管理、ダッシュボードの公開、アクセス分析、ログ確認などを統合的に管理できます。

主な特徴

統合的な管理: コード、公開、ログ、分析を一元管理
スペースとの連携: 必ずスペースに所属し、スペースメンバーと権限を共有
複数の作成方法: データソースをインポート、GitHubリポジトリをインポートから選択可能
フィードバック収集: チーム内でのコメント・フィードバック機能

プロジェクトの作成

すべてのプロジェクトはスペースに所属する必要があります。スペースメンバーは自動的にそのスペース内のすべてのプロジェクトにアクセスできます。

スペース詳細画面で「プロジェクトを作成」をクリック

スペース一覧からスペースを選択し、画面右上にある「+プロジェクトを作成」ボタンをクリックします。

所属するスペースを選択

「スペース」ドロップダウンで、プロジェクトを作成するスペースを変更することができます。

プロジェクトは必ずスペースに所属し、チーム協業を可能にします。

作成方法を選択

以下3つの作成方法から選択できます（詳細は下記参照）:

Excel、CSV、Jupyter Notebookファイルのアップロード
外部データソースから作成
GitHubからリポジトリをインポート

作成方法の種類

Excel、CSV、Jupyter Notebookファイルのアップロード

データファイルからダッシュボードを作成します。アップロード後、エディターが開き、データの可視化やインタラクティブなダッシュボード構築が可能です。

対応形式:

Excel (.xlsx, .xls)
CSV (.csv)
Jupyter Notebook (.ipynb)

手順:

ファイルアップロード

プロジェクト作成動線からデータソースとして対象ファイルをアップロード
その他必要情報（プロジェクト名、プロジェクトの追加情報）を入力し、プロジェクトを作成
エディターが立ち上がり、チャットからSquadbase DBにアップロードしたデータを格納
処理完了後、エディターで編集

外部データソースから作成

外部データソースの接続方法はデータソースページを参照ください。

GitHubからリポジトリをインポート

既存のGitHubリポジトリをインポートしてプロジェクトを作成します。

事前にGitHub連携を完了させる必要があります。GitHub連携についてはGitHub連携ページを参照ください。

前提条件:

GitHubアカウントの連携が必要
対象リポジトリへのアクセス権限

手順:

プロジェクト作成動線から「開発者オプション」を選択
GitHub Organizationを選択
インポートするリポジトリ、ブランチを選択し、プロジェクト名、ドメインを入力
「Create & Deploy」ボタンからプロジェクトが作成されます

メンバーアクセスについて

プロジェクト作成時、以下のアクセスルールが適用されます：

Automatic Access（自動アクセス）: スペースメンバー全員が自動的にプロジェクトにアクセス可能
Permission Level（権限レベル）: Organization Role（Admin、Creator、Viewer）に基づいてアクセスレベルが決定
Additional Members（追加メンバー）: プロジェクト作成後、スペース外のメンバーも個別に招待可能

プロジェクトの表示と管理

プロジェクト一覧

スペース詳細画面にプロジェクトがカード形式で表示されます。

各カードの表示内容:

プレビュー画像: プロジェクトのスクリーンショット
プロジェクト名: プロジェクトの名称
最終更新時刻: "最終更新 XX 時間前" 形式で表示
アプリを開くボタン: 公開済みアプリケーションを開く
- 公開されていない場合はグレーアウト（無効）
エディターを開くボタン: エディターを開く
ピンボタン: 特定のプロジェクトを固定表示に設定
- 左側のサイドバーに固定表示され、素早くアクセスできます
- 固定表示を解除する場合は、同じメニューから「プロジェクトのピン留めを解除」を選択
複製ボタン: プロジェクトを複製
- 複製時には、以下の内容が引き継がれます：
  - ソースコード
  - システム環境および環境変数
  - データソース
  - Squadbase DB（スキーマ情報）

プロジェクト詳細画面

プロジェクト名をクリックすると、詳細画面が表示されます。

ヘッダー部分

メンバーアバター: アクセス権を持つメンバーのアイコンが表示されます
アプリを開く: デプロイ済みアプリを開く
エディターを開く: コードエディタを開く
タブナビゲーション: 6つのタブで機能を切り替え

プロジェクトタブ

プロジェクトの概要と最新情報を表示します。

リポジトリ

表示項目:

リポジトリ種別: SquadbaseのデフォルトのGitHub設定か、ご自身のGitHubアカウントが連携されているかを表示します
ブランチ: デフォルトでmainが設定されます

デプロイメント（最新デプロイメント）

最新のデプロイメント状況を確認できます。

表示項目:

ステータス: 準備完了、エラーなど
環境: Production、Previewなどの環境
コミットハッシュ: デプロイされたコードのバージョン
Current バッジ: 現在公開中のデプロイメント
コミットメッセージ: 変更内容の説明
デプロイ時刻と実行者: いつ、誰がデプロイしたか

分析

アプリケーションへのアクセス状況を分析できます。

機能:

期間選択: 週次などで期間を選択
Page Views グラフ: 日別のアクセス数を視覚化

詳細はアクセス分析機能を参照してください。

チーム内でフィードバックを収集できます。

カテゴリ:

Feedback: 一般的なフィードバック・使用感
Bug Report: バグ・不具合の報告
Feature Request: 新機能の提案
Question: 質問・確認事項
Note: メモ・ドキュメント

操作:

「新しいコメント」ボタンから新規コメントを作成

デプロイメント管理

デプロイメントタブ

プロジェクトのデプロイメント（公開）履歴を管理します。

画面構成:

環境絞り込み: "すべての環境"または特定環境で絞り込み
Create Deployment +: 新規デプロイメントを作成
デプロイメント一覧: テーブル形式で表示

一覧の表示内容:

項目	説明
コミットハッシュ	デプロイされたコードのバージョン
Current バッジ	現在公開中のデプロイメント
環境	Production、Previewなど
ステータス	Ready、Errorなど
デプロイ時間	ビルド時間 + 経過時間
コミットメッセージ	変更内容の説明
デプロイ日時	デプロイが実行された日時
デプロイ実行者	デプロイを実行したユーザー
詳細を見る	デプロイメントの詳細を表示

操作:

詳細を見る: デプロイメントの詳細を確認
ページネーション: 複数ページにわたる履歴を閲覧

ログ監視と管理

ログタブ

プロジェクトの実行ログとアクセスログを確認します。エラーのトラブルシューティング、アプリケーションの動作確認、セキュリティ監視に活用できます。

アクセス方法: プロジェクト詳細画面 > ログタブ

ログの種類

ランタイムログ（実行ログ）
- アプリケーションの動作ログ（Error / Warning / Info / Debug など）
- 用途: エラー原因調査、動作確認、パフォーマンス問題の特定
アクセスログ
- HTTP リクエストログ（URL / Method / Status / Response time / Client IP など）
- 用途: アクセス分析、404/500の特定、セキュリティ監視