메뉴
open-process-miningの環境セットアップ、データリセット、トラブルシューティングをガイドします。「OPMをセットアップ」「環境構築」「データベースをリセット」「コンテナが起動しない」「dbtエラー」「フロントエンドが表示されない」「open-process-miningの初期設定」「OPMのトラブルシューティング」などのキーワードで発動します。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | opm-setup |
| description | open-process-miningの環境セットアップ、データリセット、トラブルシューティングをガイドします。「OPMをセットアップ」「環境構築」「データベースをリセット」「コンテナが起動しない」「dbtエラー」「フロントエンドが表示されない」「open-process-miningの初期設定」「OPMのトラブルシューティング」などのキーワードで発動します。 |
open-process-miningの環境構築、データリセット、問題解決をガイドします。
../opm-core/references/data-pipeline-patterns.mdユーザーの状況に応じて、以下のいずれかのフローを案内する。
docker compose version で確認git clone https://github.com/suwa-sh/open-process-mining.git
cd open-process-mining
cp .env.example .env
開発者環境（ホットリロード、ボリュームマウント）:
docker compose -f compose.dev.yml up -d
利用者環境（安定版イメージ、read-only マウント）:
docker compose up -d
# サンプルデータ生成（開発者環境のみ）
python scripts/generate_sample_data.py
# dbt でデータ投入（開発者環境）
docker compose -f compose.dev.yml run --rm dbt bash -c "cd /app/dbt && dbt deps && dbt seed && dbt run"
# dbt でデータ投入（利用者環境）
docker compose run --rm dbt bash -c "cd /app/dbt && dbt deps && dbt seed && dbt run"
データを初期状態に戻したい場合:
# 開発者環境
docker compose -f compose.dev.yml down -v
docker compose -f compose.dev.yml up -d
# node_modules が削除されるため再インストール
docker compose -f compose.dev.yml exec frontend npm install
# サンプルデータを再投入
python scripts/generate_sample_data.py
docker compose -f compose.dev.yml run --rm dbt bash -c "cd /app/dbt && dbt deps && dbt seed && dbt run"
# 利用者環境
docker compose down -v
docker compose up -d
docker compose run --rm dbt bash -c "cd /app/dbt && dbt deps && dbt seed && dbt run"
注意: -v フラグで PostgreSQL の全データ（Named Volume）が削除される。
ユーザーの問題に応じて診断・解決を案内する。
docker compose -f compose.dev.yml ps # 状態確認
docker compose -f compose.dev.yml logs # ログ確認
docker compose -f compose.dev.yml logs postgres # DB ログ
# 接続確認
docker compose -f compose.dev.yml run --rm dbt bash -c "cd /app/dbt && dbt debug"
# パッケージインストール
docker compose -f compose.dev.yml run --rm dbt bash -c "cd /app/dbt && dbt deps"
# テスト実行（データ品質）
docker compose -f compose.dev.yml run --rm dbt bash -c "cd /app/dbt && dbt test --store-failures"
docker compose -f compose.dev.yml logs frontend # Vite ログ確認
docker compose -f compose.dev.yml restart frontend # 再起動
docker compose -f compose.dev.yml logs backend
# ヘルスチェック
docker compose -f compose.dev.yml exec -T backend python -c \
"import requests; print(requests.get('http://localhost:8000/health').json())"
dbt は public スキーマにテーブルを作成する。
# スキーマ確認
docker compose -f compose.dev.yml exec postgres psql -U process_mining -d process_mining_db -c "\dn"
# テーブル一覧
docker compose -f compose.dev.yml exec postgres psql -U process_mining -d process_mining_db -c "\dt public.*"
docker compose（ハイフンなし）docker-compose は非推奨# 最新イメージの取得
docker compose --profile dbt --profile dlt pull
# コンテナの再起動
docker compose up -d
# dbt の再実行（スキーマ変更がある場合）
docker compose run --rm dbt bash -c "cd /app/dbt && dbt deps && dbt run"
| サービス | URL |
|---|---|
| フロントエンド | http://localhost:5173 |
| バックエンド API | http://localhost:8000 |
| Swagger UI | http://localhost:8000/docs |
| PostgreSQL | localhost:5432 |
.env ファイルでDB接続情報を設定（デフォルトはサンプル値）.env のパスワードを変更することpostgres-data に永続化されるopen-process-miningに新しいプロセスタイプをCSV手動投入で追加します。CSVデータとdbt stagingモデルを生成し、stg_all_eventsに統合します。「新しいプロセスを追加」「CSVデータソースを追加」「プロセスタイプを追加」「イベントログを投入」「dbt seedデータを作成」「CSVからプロセスマイニング」などのキーワードで発動します。
open-process-miningにdlt (data load tool) を使った外部システム連携データソースを追加します。dltソース、パイプライン、dbt stagingモデル、設定ファイルを一式生成します。「dltソースを追加」「外部APIからデータ取得」「dltパイプラインを作成」「外部システム連携」「APIからイベントログ」「dltでデータ投入」などのキーワードで発動します。
open-process-miningに成果メトリックを追加します。成果データCSVまたはdbtマートモデルを生成し、fct_case_outcomesに統合して成果分析を可能にします。「成果メトリックを追加」「成果分析データを作成」「KPIを追加」「メトリックを定義」「outcomeデータを追加」「成果指標を設定」などのキーワードで発動します。
open-process-miningの共有リソースを提供する内部スキルです。他のopm系スキルから参照されます。直接トリガーされることは想定していません。