動作環境

• Python 3.13+
• Node.js 18.17+
• PostgreSQL 16.1+
• Docker
• hasura-cli

ローカル開発環境構築

※ Mac (M4) MacOS 15.3（24D2059）にて確認

1. uv sync

2. docker compose up

3. 環境変数 DATABASE_URL を設定

4. uv run python scripts/initialize_or_update_db.py を実行してテーブルを生成

5. uv run python scripts/initialize_master_data.py を実行して初期データをインポート

6. uv run python -m celery -A metaboatrace.crawlers worker --loglevel=info

7. uv run python -m celery -A metaboatrace.crawlers flower (管理画面)

8. uv run python -m celery -A metaboatrace.crawlers beat (定期実行)

運用

• 公式サイトのクローリング
• 欠損データの補完

データ管理

• データのインポート/エクスポート
• Hasura Metadata の管理手順

トラブルシューティング

• トラブルシューティング