kemov

けもV の非公式ファンサイトです 🐾

構成

サイトは kemov.nanase.cc で公開しています。1 つの Cloudflare Worker が、公開サイト・API・管理サイトの応答と、データの収集をまとめて受け持ちます。

flowchart LR
  dist["dist/<br/>src/ の Vue を<br/>Vite でビルドしたサイト"]
  yt["YouTube"]
  subgraph W["Cloudflare Worker（worker/）"]
    direction TB
    site["公開サイトの配信"]
    api["/api<br/>公開の API"]
    admin["/admin<br/>管理サイト"]
    cron["定期的な収集"]
  end
  subgraph S["データ"]
    direction TB
    pub[("R2<br/>kemov-public")]
    d1[("D1<br/>kemov")]
    backup[("R2<br/>kemov-backup")]
  end
  dist --> site
  yt --> cron
  api -- "読む" --> pub
  api -- "読む" --> d1
  admin -- "公開する JSON" --> pub
  admin -- "書く" --> d1
  cron -- "書く" --> d1
  cron -- "夜間のバックアップ" --> backup
  classDef code fill:#f6efe0,stroke:#c9ad6e,color:#2b2413
  classDef worker fill:#e3f1ed,stroke:#7fb5aa,color:#12302a
  classDef store fill:#eceef7,stroke:#9aa3c8,color:#1d2240
  class dist,yt code
  class site,api,admin,cron worker
  class d1,backup,pub store
  style W fill:#f3f9f7,stroke:#b5d3cc,color:#12302a
  style S fill:#f5f6fb,stroke:#c3c8e0,color:#1d2240

Loading

• 公開サイトに出るデータは、すべて D1 から作り直せる
• main へ push すると、Deploy ワークフローが worker とサイトをまとめてデプロイする

詳しくは 全体の構成 にあります。

開発の始め方

bun と mise を使います。固定した版を入れ、依存を入れ、開発サーバーを起動します。

mise install
bun install --frozen-lockfile
bun run dev

環境変数・ビルド・テスト・worker の動かし方は 開発 にあります。

文書

仕組みと運用の文書は docs/ にあります。

• 手順書
  • 開発: 手元で動かし、検査する
  • マイグレーション: スキーマを変える
  • 復旧: 壊れたデータベースを戻す
  • 設定とデプロイ: Cloudflare と GitHub の設定、デプロイの戻し方
  • メンバーの増減: メンバーを足す、活動終了日を書く、名前などを直す
• リファレンス
  • 全体の構成: 要求の受け分け、収集、デプロイ、仕様の索引
  • 管理サイト: 設計の方針、認証、画面
  • データ: D1 と R2、列の書き手、バックアップ
  • 公開の API: /api のエンドポイント
  • 管理サイトの API: /admin/api のエンドポイント、公開の条件

ライセンス

MIT

著作物について

けもV の著作物（画像など）の著作権は、けものフレンズプロジェクト（KFP）と けものフレンズVプロジェクト（KFPV）にあります。これらはこのリポジトリに含めてはいけません。使うときは、リンクで参照してください。