30秒で分かる要点
sosolu-siteとは?
Sosolu Siteは、Astroを中心に設計・実装したプロジェクトです。 主にAstroを使用し、公開コミットから機能追加と改善を積み重ねた過程を確認できます。
01 / 概要
プロジェクトの概要と目的
sosolu site sosolu.tokyo — 既存のジャンル別ランキングサイト( syunnjack/ ranking )を横断して比較する、 ユーザーレビュー(UGC)主体のメタ比較ハブ。 設計方針: docs/DOMAINS.md ./docs/DOMAINS.md (ドメイン割り当て)。 rakuten02 リポジトリの docs/SEO AIO LLMO.md / docs/RANKING SITES.md も参照。 セットアップ チェック PRとmainへのpushでは .github/workflows/ci.yml がこの2つを走らせる。 Vercelの確認でもビルドは走るが、失敗に気付くのがデプロイ後になるため、 マージ前にPR上でも確認する。 デプロイ Vercelに接続すると @astrojs/vercel アダプタでそのままデプロイ可能。 src/pages/api/reviews.ts はVercel Postgresに接続する。 POSTGRES URL 等の環境変数が未設定の場合、 レビューAPIは503を返し、フロント側は「準備中」表示にフォールバックする(サイト自体は落ちない)。 DB接続後は db/schema.sql を実行してテーブルを作成すること。 schema.sql は ADD COLUMN IF NOT EXISTS を含むので、既存テーブルにそのまま流しても良い。 環境変数 変数 必須 用途 POSTGRES URL レビュー機能に必要 Vercel Postgres接続。未設定ならレビューAPIは503を返す REVIEW IP SALT 任意(推奨) 投稿元IPをハッシュ化するときのソルト。未設定だと連投チェックが効かない ドメイン 本番は sosolu.tokyo の一本。保有している他ドメイン( sosolu.email など18件)は src/middleware.ts が301で sosolu.tokyo へ寄せる。対象ドメインは src/lib/site.ts の REDIRECT HOSTS
本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。
02 / 使用技術
使用技術と役割
主要な実装言語として、プロダクトの中心機能を構成します。
03 / 設計
構成から読み解く設計
主な項目は です。
- 単一アプリケーション構成
- 機能単位の責務分割
04 / 変更履歴
コミットから見る実装の変遷
以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。
- リダイレクト確認をActionsから実行できるようにする (#5)17f6514をGitHubで確認 ↗
- リダイレクト確認をActionsから実行できるようにするa0d9159をGitHubで確認 ↗
- Search Console の所有権確認タグを追加する (#4)c70a777をGitHubで確認 ↗
- Search Console の所有権確認タグを追加する1612ee8をGitHubで確認 ↗
- Vercelへのドメイン一括登録をGitHub Actionsから実行できるようにする (#3)c7a0517をGitHubで確認 ↗
- Vercelへのドメイン一括登録をGitHub Actionsから実行できるようにするa0b4e27をGitHubで確認 ↗
- ドメイン設定の検証スクリプトと、実施手順の具体化 (#2)4fb681cをGitHubで確認 ↗
- ドメイン設定の検証スクリプトと、実施手順の具体化1f86a7fをGitHubで確認 ↗
- sosolu.email などの保有ドメインを sosolu.tokyo へ寄せ、サイト全体を作り込む (#1)26ce28cをGitHubで確認 ↗
- CI(型チェックとビルド)を追加する8d7b3d6をGitHubで確認 ↗
- sosolu.email などの保有ドメインを sosolu.tokyo へ寄せ、サイト全体を作り込む4190880をGitHubで確認 ↗
- 支援・購入への導線を追加する5281389をGitHubで確認 ↗
05 / 学び
このプロジェクトから得られる学び
- 変更を小さく記録する
コミット単位で目的を分けると、実装の意図を追跡しやすくなります。
- 構成と技術選定を結び付ける
Astroの採用理由と各ディレクトリの責務を説明できることが保守性につながります。
- READMEと実装を同時に育てる
説明とコードを近い状態に保つことが、再利用と振り返りを助けます。
06 / よくある質問
よくある質問
sosolu-siteは何を作るプロジェクトですか?
Sosolu Siteは、Astroを中心に設計・実装したプロジェクトです。
sosolu-siteの主要技術は何ですか?
Astroを中心に構成されています。
この記事の情報源は何ですか?
公開README、リポジトリ構成、既定ブランチのGitHubコミット履歴です。
コメント
この記事へのコメント
お名前だけで投稿できます。アカウント登録やログインは不要です。 いただいたコメントは確認のうえ公開します。