Sukima Insightの設計・技術選定・コミット履歴を解説

01 / 概要

プロジェクトの概要と目的

SUKIMA INSIGHT GitHub上の全リポジトリと、公開済みWeb・PWA・iOS・Androidのアクセス、CTR、CVR、売上、改善施策を横断管理する分析SaaSです。 構成 apps/dashboard : KPI・ファネル・リポジトリ比較・販売画面 services/collector : マルチテナント収集・集計API services/collector/github sync.mjs : GitHub全リポジトリ同期 packages/analytics web : 同意ベースのWeb計測SDK docs/SYSTEM DESIGN.md : 販売を前提にしたシステム設計 開発 初期開発キーは dev change me です。本番では必ず環境変数を変更してください。

本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

• 単一アプリケーション構成
• 機能単位の責務分割

04 / 変更履歴

コミットから見る実装の変遷

以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。

1. 2026/08/15
   支援・購入への導線を追加する4626f85をGitHubで確認 ↗
2. 2026/08/11
   feat: 25プロジェクト・11段階ファネル・15件レコメンド・流入チャネル・週次トレンド・デバイス比率・前週比カラム追加d6c3537をGitHubで確認 ↗
3. 2026/08/11
   feat: 20プロジェクト・9段階ファネル・10件レコメンド・トップページ分析・具体的プライシング追加a4d72f0をGitHubで確認 ↗
4. 2026/07/19
   機能・コンテンツを追加bdbcc2eをGitHubで確認 ↗
5. 2026/07/19
   機能・コンテンツを追加11f8e93をGitHubで確認 ↗
6. 2026/07/19
   プロジェクトの初期構成を作成05220adをGitHubで確認 ↗
7. 2026/07/19
   プロジェクトの初期構成を作成c2c24edをGitHubで確認 ↗

05 / 学び

このプロジェクトから得られる学び

• 変更を小さく記録する

  コミット単位で目的を分けると、実装の意図を追跡しやすくなります。

• 構成と技術選定を結び付ける

  JavaScriptの採用理由と各ディレクトリの責務を説明できることが保守性につながります。

• READMEと実装を同時に育てる

  説明とコードを近い状態に保つことが、再利用と振り返りを助けます。

06 / よくある質問

よくある質問