talivia

## 概要 Taliviaは、創業者向けの収益 атрибу션（帰属分析）に焦点を当てたオープンソースの自己ホスト型分析プラットフォームです。Web解析、セッション再生、チームコラボレーション機能、共有分析ダッシュボード、インポート/エクスポート機能に加え、決済プロセッサからの顧客収益データへの直接接続を提供します。 本プロジェクトは、Commercially HostedなTalivia Cloudサービスの自己ホスト版に相当します。マネージドホスティングではGoogle Search Console、Bing Webmaster Tools、GitHubアクティビティ、X/Reddit/TikTokなどのソーシャルメンションとの統合が追加されます。 ## 機能 - **Web解析**：埋め込みJavaScriptスニペットによる訪問追跡 - **セッション再生**：Webサイト上のユーザーセッションの任意の再生 - **収益帰属分析**：サブスクリプションライフサイクル、返金、紛争、ファーストタッチ/ラストタッチ帰属 - **決済統合**：Stripe、LemonSqueezy、Polar、Dodo、Yolfi、Manual Payment API - **コラボレーション**：ウェブサイト協力作成者、共有分析ダッシュボード - **インポート/エクスポート**：データ移行・バックアップワークフロー - **暗号通貨換算**：CoinGecko経由のオプション為替レート換算 - **AI Agent Kit**：Codex、Claude Code、ChatGPTなどのエージェント向けのMCP互換ツールキット ## テクノロジースタック - ランタイム：Node.js 22 LTS または 24 LTS - パッケージマネージャー：pnpm 10+ - データベース：PostgreSQL - ORM：Prisma - コンテナ化：Docker Engine with Docker Compose ## セットアップ ### ローカル開発 1. Node.js 22/24 LTS、pnpm 10+、および新規PostgreSQLインスタンスが利用可能であることを確認します。 2. `.env.example`を`.env`にコピーし、`openssl rand -hex 32`で32バイトのシークレットを生成します。 3. `.env`内に`DATABASE_URL`と`APP_SECRET`を設定します。 4. 依存関係をインストールしマイグレーションを実行： ```bash pnpm install --frozen-lockfile pnpm exec prisma migrate deploy pnpm dev ``` 5. `http://localhost:3000`を開き、`admin`/`admin`でサインインします。**Settings → Account**で即座にブートストラップパスワードを変更してください。 ### Docker ```bash cp .env.example .env openssl rand -hex 32 docker compose up --build -d ``` コンテナはアプリケーション起動前にOSSデータベースマイグレーションを自動的に適用します。起動後、デフォルトの管理者パスワードを変更してください。 ## 設定 | 変数 | 必須 | 目的 | |---|---|---| | `DATABASE_URL` | はい | PostgreSQL接続文字列 | | `APP_SECRET` | はい | セッション署名と資格情報暗号化用の32バイトランダム値 | | `COINGECKO_API_KEY` | いいえ | 暗号通貨為替レート換算を有効化；なしでも動作可能 | ## 初回使用 1. Taliviaでウェブサイトエントリを作成します。 2. 提供された追跡スニペットを対象サイトに挿入します。 3. ダッシュボードに訪問が表示されることを確認します。 4. ウェブサイト設定でセッション再生をオプションで有効化します。 5. **Website settings → Payments**で顧客収益を接続します。 リバースプロキシ背後で実行する場合は、フックURLが正しく生成されるよう元の`Host`および`X-Forwarded-Proto`ヘッダーを転送してください。 ## バックアップとアップグレード アップグレード前にPostgreSQLデータベースをバックアップします。Composeデプロイメントの場合： ```bash docker compose exec -T postgres pg_dump -U talivia -d talivia_oss > talivia-backup.sql ``` 将来のリリースは`prisma/migrations`に順序付きマイグレーションを追加します。`pnpm exec prisma migrate deploy`で適用します；公式コンテナは起動時にこれを自動的に実行します。既存のマイグレーションを編集してはいけません。 ## AI Agent KitとMCP TaliviaはMCP対応クライアントと互換性のあるオープンソースのAgent Kit（[github.com/talivia-group/agent](https://github.com/talivia-group/agent)）を配布しています。エージェントは追跡をインストールし、フレームワーク固有のセットアッププランを生成し、ライブ分析イベントを検証し、訪問を支払い帰属に追跡できます。 - ホストOAuthエンドポイント（Talivia Cloud）：`https://talivia.com/mcp` - ローカルstdioモード：`npx -y @talivia/agent mcp` 自己ホスト版はTalivia Cloud OAuthエンドポイントを公開しません。 ## セキュリティとライセンス 脆弱性報告とデプロイメントガイドラインは[SECURITY.md](SECURITY.md)に記載されています。開発ワークフローの詳細は[CONTRIBUTING.md](CONTRIBUTING.md)に記載されています。TaliviaはMIT Licenseの下でリリースされています。 ## 比較 TaliviaはDatafastの代替としてマーケティングされており、単一の自己ホストデプロイメント内にビルトインの収益帰属分析とマルチプロセッサ決済統合を強調しています。