動作確認用リンク
- バックエンド ヘルスチェック /v1/health
- Swagger UI (FastAPI 自動生成) /docs
- ReDoc /redoc
- Swagger UI (OpenAPI 仕様書ベース)
- Mailhog (送信メール確認)
サービス構成
backend- FastAPI (port 8000)worker- Celerybeat- Celery Beatslack-bot- Slack Bolt (port 3000)postgres- PostgreSQL 16 (port 5432)redis- Redis 7 (port 6379)mailhog- SMTP 開発用
環境変数
動作には .env ファイルが必要です。
.env.example をコピーして必要な値を入力してください。
主要な必須変数:
JWT_SECRETANTHROPIC_API_KEYGOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRETSLACK_BOT_TOKEN等NOTION_API_KEY等
よく使うコマンド
docker compose up -d- 起動docker compose logs -f backend- ログ追跡docker compose exec backend bash- シェル接続docker compose exec backend alembic upgrade head- マイグレーションdocker compose down -v- 停止 + データ消去
ドキュメント
このスタックは以下の仕様書に基づいて実装されます:
- API 仕様 (OpenAPI 3.1)
- API 補足ドキュメント
- AI オーケストレーター仕様
- Slack Bot 対話設計
- Notion DB テンプレート