Notion Automatic Habits Insert

NotionのHabitsデータベースからTodoを自動生成してTodosデータベースに挿入するWebhookサーバー。

📋 概要

このアプリケーションは、Notionの習慣追跡システムを自動化するWebhookサーバーです。外部からのHTTPリクエストをトリガーとして、以下の処理を実行します：

Habits データベースからデータを取得
習慣データをTodoアイテムに変換
Todosデータベースに自動挿入

🏗️ アーキテクチャ

レイヤードアーキテクチャと依存性注入パターンに基づいて設計されています：

Presentation層: WebhookServer - HTTPリクエストの処理
Domain層: OrchestrationService - ビジネスロジックの統合
Repository層: データアクセスとキャッシュ管理
Service層: 外部API（Notion）との連携

詳細は .cursorrules/architecture.md を参照してください。

🚀 クイックスタート

前提条件

Docker & Docker Compose
Dev Container CLI または VSCode 拡張機能（開発時）

1. リポジトリをクローン

git clone <repo-url> notion-automatic-habits-insert
cd notion-automatic-habits-insert

2. 環境設定

docker-compose.example.ymlをコピーしてdocker-compose.ymlを作成：

cp app/docker-compose.example.yml app/docker-compose.yml

必要な環境変数を設定：

environment:
  - INTEGRATION_SECRET=your_notion_api_key
  - HABITS_DATABASE_ID=your_habits_database_id
  - TODOS_DATABASE_ID=your_todos_database_id
  - PORT=8080
  - WEBHOOK_PATH=/webhook
  - WEBHOOK_SECRET=your_webhook_secret
  - NODE_ENV=development
  - LOG_LEVEL=DEBUG

3. サーバーを起動

cd app
docker compose up --build

サーバーは http://localhost:8080 で起動します。

注意: デフォルトでは開発環境（target: development）で起動します。本番環境で使用する場合は、docker-compose.ymlのtargetをproductionに変更してください。

🔐 環境変数

名前	説明	必須	デフォルト
`INTEGRATION_SECRET`	Notion APIの統合シークレット	✓	-
`HABITS_DATABASE_ID`	HabitsデータベースのID	✓	-
`TODOS_DATABASE_ID`	TodosデータベースのID	✓	-
`PORT`	サーバーのポート番号	-	`8080`
`WEBHOOK_PATH`	Webhookのエンドポイントパス	-	`/webhook`
`WEBHOOK_SECRET`	Webhook認証用のシークレット	-	-
`NODE_ENV`	実行環境（development/production）	-	`development`
`LOG_LEVEL`	ログレベル（DEBUG/INFO/WARN/ERROR）	-	環境に応じて自動設定

📡 API エンドポイント

ヘルスチェック

GET /health

レスポンス:

{
  "status": "ok",
  "timestamp": "2025-10-15T12:00:00.000Z"
}

ルート

GET /

レスポンス:

{
  "message": "Notion Automatic Habits Insert Webhook Server",
  "version": "1.0.0",
  "endpoints": {
    "health": "/health",
    "webhook": "/webhook"
  }
}

Webhook

POST /webhook

ヘッダー:

Content-Type: application/json
X-Webhook-Secret: your_webhook_secret

レスポンス（成功時）:

{
  "success": true,
  "habitCount": 10,
  "todoCount": 15,
  "linkedCount": 15,
  "executionTime": 2500,
  "responseTime": 2505,
  "timestamp": "2025-10-15T12:00:00.000Z"
}

レスポンス（エラー時）:

{
  "success": false,
  "error": "エラーメッセージ",
  "executionTime": 1200,
  "responseTime": 1205,
  "timestamp": "2025-10-15T12:00:00.000Z"
}

🔧 使用例

cURL

# Webhook を実行
curl -X POST http://localhost:8080/webhook \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: your_webhook_secret"

# ヘルスチェック
curl http://localhost:8080/health

GitHub Actions / 外部CI

- name: Trigger Notion Habits Update
  run: |
    curl -X POST ${{ secrets.WEBHOOK_URL }}/webhook \
      -H "Content-Type: application/json" \
      -H "X-Webhook-Secret: ${{ secrets.WEBHOOK_SECRET }}"

Notion Automation

Notionの自動化機能やZapier、Make.comなどのツールから、指定したURLにPOSTリクエストを送信することで、自動的にHabitsからTodosへの変換・挿入が実行されます。

🛠️ 開発

Dev Container での開発

devcontainer.example.jsonをコピーしてdevcontainer.jsonを作成
VSCodeでDev Containerを起動

devcontainer up --workspace-folder .

ローカルでの実行

cd app
npm install
npm run dev

TypeScript型チェック

cd app
npm run type-check

Linter

cd app
npm run lint        # 自動修正
npm run lint:check  # チェックのみ

フォーマット

cd app
npm run format        # 自動フォーマット
npm run format:check  # チェックのみ

📁 プロジェクト構造

app/
├── src/
│   ├── domain/           # ドメインロジック
│   │   ├── fetch/        # Habits取得
│   │   ├── convert/      # Habits→Todo変換
│   │   ├── insert/       # Todos挿入
│   │   └── orchestration/# 全体のフロー管理
│   ├── presentation/     # HTTPサーバー
│   ├── shared/           # 共通ユーティリティ
│   │   ├── cache/        # キャッシュ管理
│   │   ├── config/       # 設定管理
│   │   ├── di/           # 依存性注入
│   │   ├── errors/       # エラーハンドリング
│   │   ├── factories/    # ファクトリーパターン
│   │   ├── logger/       # ロガー
│   │   ├── retry/        # リトライ機構
│   │   └── validation/   # バリデーション
│   └── main.ts           # エントリーポイント
├── Dockerfile
├── docker-compose.yml
├── package.json
└── tsconfig.json

📊 ログレベル設定

アプリケーションは環境に応じて自動的にログレベルを設定します：

デフォルト設定

環境	ログレベル	出力されるログ
`development`	`DEBUG`	すべてのログ（DEBUG, INFO, WARN, ERROR）
`production`	`WARN`	WARN以上のみ（WARN, ERROR）
`test`	`ERROR`	ERRORのみ

カスタム設定

環境変数 LOG_LEVEL でログレベルを上書きできます：

# 本番環境でもDEBUGログを出力したい場合
LOG_LEVEL=DEBUG

# 開発環境でもWARN以上のみにしたい場合
LOG_LEVEL=WARN

Docker Compose での設定例

environment:
  - NODE_ENV=development # 開発環境
  - LOG_LEVEL=DEBUG # 開発環境ではDEBUG以上

本番環境での設定例：

environment:
  - NODE_ENV=production
  - LOG_LEVEL=WARN # 本番環境ではWARN以上のみ

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

ポートが使用中

# ポート8080を使用しているプロセスを確認
lsof -i :8080

# または別のポートを使用
PORT=3001 docker compose up

Notion API エラー

INTEGRATION_SECRETが正しく設定されているか確認
NotionのIntegrationがHabitsとTodosデータベースにアクセス権限を持っているか確認

キャッシュのクリア

コンテナを再構築：

cd app
docker compose down
docker compose up --build

または、ローカル開発時：

cd app
npm run dev

📚 関連ドキュメント

📝 ライセンス

ISC

Name		Name	Last commit message	Last commit date
Latest commit History 253 Commits
.cursor		.cursor
.devcontainer		.devcontainer
.github		.github
.husky		.husky
.vscode		.vscode
app		app
bin		bin
docs		docs
.commitlintrc.json		.commitlintrc.json
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.markdownlint-cli2.jsonc		.markdownlint-cli2.jsonc
.markdownlint.jsonc		.markdownlint.jsonc
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
.yamllint.yml		.yamllint.yml
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
cspell.jsonc		cspell.jsonc
package-lock.json		package-lock.json
package.json		package.json

License

argondev22/notion-automatic-habits-insert

Folders and files

Latest commit

History

Repository files navigation

Notion Automatic Habits Insert

📋 概要

🏗️ アーキテクチャ

🚀 クイックスタート

前提条件

1. リポジトリをクローン

2. 環境設定

3. サーバーを起動

🔐 環境変数

📡 API エンドポイント

ヘルスチェック

ルート

Webhook

🔧 使用例

cURL

GitHub Actions / 外部CI

Notion Automation

🛠️ 開発

Dev Container での開発

ローカルでの実行

TypeScript型チェック

Linter

フォーマット

📁 プロジェクト構造

📊 ログレベル設定

デフォルト設定

カスタム設定

Docker Compose での設定例

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

ポートが使用中

Notion API エラー

キャッシュのクリア

📚 関連ドキュメント

📝 ライセンス

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 2

Uh oh!

Contributors 4

Uh oh!

Languages