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

01 / 概要

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

vs jt / スグスウ 登録・アプリ不要で近くの喫煙スポット、直近の混雑状況、口コミを確認できるスマホ特化サイトです。正式ドメインは sugusuu.jp 、 sugusuu.com はメインドメインへ転送します。 ローカル起動 MVPに含むもの 現在地中心のスポットマップと絞り込み リスト表示、スポット詳細、ルート導線 ゲストによる1タップ混雑投稿とポイント QRチェックインのUIフロー 写真・口コミ閲覧導線 空き通知の許可フロー PWAマニフェスト / Service Worker Supabase + PostGIS用の初期スキーマ 本番接続時はMapboxまたはMapLibre、Supabase、Web Push送信API、画像Storageを環境変数経由で接続してください。 ビルドとLint GitHub Actionsデプロイ main / master への push で .github/workflows/deploy.yml .github/workflows/deploy.yml が実行されます。 事前に以下の Repository Secrets を設定してください。 SSH HOST SSH USERNAME SSH PRIVATE KEY デプロイ先は sugusuu.jp/public html を想定しています。

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

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

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

04 / 変更履歴

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

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

1. 2026/08/15
   支援・購入への導線を追加する0f1d327をGitHubで確認 ↗
2. 2026/08/11
   説明資料を更新2290819をGitHubで確認 ↗
3. 2026/08/10
   機能・コンテンツを追加8e29d2fをGitHubで確認 ↗
4. 2026/08/09
   不具合や設定を修正6d547fbをGitHubで確認 ↗
5. 2026/08/04
   機能・コンテンツを追加f9ea225をGitHubで確認 ↗
6. 2026/08/04
   実装内容を更新d0e163dをGitHubで確認 ↗
7. 2026/08/03
   機能・コンテンツを追加e6493e2をGitHubで確認 ↗
8. 2026/07/22
   実装内容を更新7c375d5をGitHubで確認 ↗
9. 2026/07/22
   実装内容を更新d5e2efaをGitHubで確認 ↗
10. 2026/07/22
    機能・コンテンツを追加2a86c7cをGitHubで確認 ↗
11. 2026/07/22
    実装内容を更新972d06cをGitHubで確認 ↗

05 / 学び

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

• 変更を小さく記録する

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

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

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

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

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

06 / よくある質問

よくある質問