# CLAUDE.md — n8n Helm Chart

> **共通ルール（要約）** — 詳細は `P:\Claude\CLAUDE.md`（全体共通）と `P:\Claude\HelmChart\CLAUDE.md`（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。
> 作業前に pull ／ 機能変更時は README 更新 ／ 作業単位ごとに commit → push まで ／ コミットに AI クレジットを付けない ／ pull で入った変更を revert しない ／ Helm はローカル実行不可（Python のみ可）。

## リポジトリ概要

n8n ワークフロー自動化ツールを Kubernetes 上にデプロイするHelmチャートです。
Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。
`n8nio/n8n` 公式マルチアーキテクチャイメージ（linux/arm64 対応）を使用します。

- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/n8n.git`
- **主アプリ**: n8n（チャートのバージョン = n8n のバージョン。サブアプリは無いため、n8n 更新時は常にリリース）

## ARM 対応について

`n8nio/n8n` は linux/arm64 に対応したマルチアーキテクチャイメージです。
Raspberry Pi 4 以降（arm64）で動作します。

## チャート構成

| リソース | 説明 |
|---|---|
| Deployment | n8n 本体（シングルコンテナ） |
| Service | LoadBalancer / ClusterIP（ポート 5678） |
| PVC | n8n データ（ワークフロー・認証情報・SQLite DB）永続化 |
| Secret | 暗号化キー・Basic認証パスワード・DBパスワード |
| Ingress | オプション（nginx ingress controller 対応） |
| HPA | オプション（※SQLiteモード時はスケールアウト非推奨） |
| PDB | Pod Disruption Budget |
| NetworkPolicy | オプション |

## データ永続化

n8n のデータは `/home/node/.n8n` に保存されます。
`persistence.enabled: true`（デフォルト）で PVC に永続化されます。
**persistence.enabled: false の場合、Pod 再起動でデータが失われます。**

## データベース

- デフォルト: SQLite（`/home/node/.n8n/database.sqlite`）
- 本番推奨: PostgreSQL（`n8n.database.type: postgresdb`）

## README 更新時の反映先

- イメージバージョン・設定値の変更 → values の表を更新
- テンプレート追加・削除 → チャート構成表を更新
- 設定項目の追加・変更 → 設定リファレンス表を更新
- 注意事項・制限事項の変更 → 該当セクションを更新