event-manual — 4S イベント基盤テンプレート

# 18 パッケージのエンジンから、必要な機能だけを選ぶ
node packages/create-event-app/bin.mjs spring-fest \
  --features=cms,sessionCard,surveys,booking,mcp \
  --slug=ivs26 --port=3402

src/worldview.ts — デザイン世界観の唯一の宣言点

export const worldview = defineWorldview({
  name: "spring-fest",
  palette: { bg: "#0c0e12", surface: "#14161c", ink: "#f2f0ea", accent: "#c8a24b" },
  typography: { display: "Shippori Mincho B1", body: "Noto Sans JP" },
  mood: { radius: "sharp", visualsScheme: "auto", watermarkGlyph: "S" },
});
// → サイト CSS 変数 / ビジュアル / セッションカード / メールの4面へ純関数で派生

エージェントに渡す — 1プロンプトで実装させる

各レシピはファイルパス・完全コード・検証手順まで含む自己完結ランブック。コーディングエージェントにレシピ id を1つ渡すだけで実装が完了する（recipe-lint が全レシピの import を実装と CI で照合し、ドリフトを構造的に防いでいる）。

recipe add-surveys に従って apps/<app> にサーベイを実装せよ。
完了条件はレシピの検証節。https://event-manual.zfilms.jp/recipes/add-surveys

機械可読の入口: AGENTS.md ↗ ／設計の正: docs/ARCHITECTURE.md ↗

Topics — 全8部48章

Foundations

Part I · 4章

なぜ event-manual かch.1

3アプリ重複の実態と統合方針

アーキテクチャ全体像ch.2

モジュール地図・feature flag・monorepo

5分で新イベントを立ち上げるch.3

create-event-app → 初回デプロイ

環境変数リファレンスch.4

defineEnv・zod 検証・.env.example

4S Platform

Part II · 6章

4S 統合の全体像ch.5

event-read / profile-read / handoff / admin の4面

イベントデータの取得ch.6

sessionSpeakers[]・3-layer merge・safety-guard

ユーザー / 組織プロフィールch.7

org members・slug 正規化

ログインレス session-handoffch.8

mint/consume・allowlist・Cognito

本人確認と認可ch.9

/users/me verify・jose cookie・DAL・ownership guard

同期モードch.10

write-back vs read-only overlay・webhook HMAC・cron

コンテンツ & データモデル

Part III · 6章

コアデータモデルch.11

Session/Speaker/Room/Venue/Sponsor

JSON-as-DB コンテンツモデルch.12

Resource enum・dev sample overlay

スキーマ駆動 Admin CMSch.13

FieldSchema → GenericForm・locked/advanced

コンテンツストアch.14

fs/GitHub 二重書き込み・楽観ロック・KV ミラー

MCP-first 二層 DBch.15

誰でも MCP でカラムを足せる Neon 層

多言語 i18nch.16

pickLang 2形・LangProvider/useLang・4S languages.en fallback

ビジュアル生成

Part IV · 9章

デザイントークンch.17

EventBrand・grain・watermark・font triplet

セッションカードレイアウトエンジンch.18

1A–10A photo-first balance

手動ファイン調整エディタch.19

onResolved 自動プリフィル・保存と即時反映

フォーマット & サイズマトリクスch.20

SNS + 印刷 A1/A2/A3・mm-PDF・√2

HUD/chrome システムch.21

grid/grain/scanlines/corner/rail/watermark

レンダリングパイプラインch.22

DOM→PNG/PDF/.ai vs Satori/OG の使い分け

日本語タイポグラフィch.23

visualWidth・candidateCuts・DP 改行

パーソナルシェアカードch.24

4S user → next/og ImageResponse 自動生成

スピーカー切り抜きch.25

pluggable CutoutBackend・canvas フォールバック

機能モジュール

Part V · 11章

サーベイ & フィードバックch.26

匿名・3顔評価・二段オートセーブ

スコアリング & リーダーボードch.27

IMDb 加重・プレミアム・キャリブレーション

ライブエンゲージメントch.28

poll/Q&A・KV view-follow・derived host key

予約 & キャパシティch.29

waitlist・冪等 dedup・kill-switch

見積 & 証明書ch.30

tax モード・A4 PDF・押印・batch CSV

リード獲得パイプラインch.31

honeypot・rate-limit・persist-first・fan-out

マッチング & ディレクトリch.32

entity-linking・review queue・PII 最小化

プライバシーch.33

consent gating・k-anonymity・射影ガード

リファラル & ファクションch.34

tier/perk・rankByCount

マップ & タイムテーブルch.35

SvgHotspotLayer・expo booth floor・印刷

メールch.36

Resend transactional + operational + テンプレ + Slack通知

Shell & 運用

Part VI · 6章

Admin シェルとナビ登録ch.37

feature nav.ts self-register

認証と認可ch.38

shared-password realms・Better Auth 昇格パス

アセットストアと一括ダウンロードch.39

3-tier put・bulkZip・namespacing

ビルド設定 & セキュリティヘッダch.40

createNextConfig・CSP・distDir 分離

デプロイ & cronch.41

Vercel CLI・CRON_SECRET・セキュリティヘッダ

新機能の追加ch.42

descriptor + flag + guarded action のフルフロー

移行 & 参照

Part VII · 4章

既存3アプリの収束計画ch.43

フェーズ別

デザイン専用カスタマイズch.44

defineDesign・tokensToCssVars・slots

パッケージ API リファレンスch.45

15 パッケージの主要 export

トラブルシューティングch.46

既知の落とし穴カタログ

プラットフォーム拡張

Part VIII · 2章

モーショングラフィックスch.47

Reveal・CountUp・scroll-driven・spring

機械可読レイヤch.48

llms.txt・registry API・B2A