Add banner + dialogue modules with admin dashboards (#15)

Introduces two new game-facing modules built on the standard module
scaffold (service.ts / routes.ts / client-routes.ts + schema in
src/schema/) plus a shared Link value object that both modules — and
future click-target consumers — use to express "where a click goes".

Backend (apps/server)

- `modules/link/` — LinkAction value object: none | external | internal.
  Registry whitelists 10 active internal routes (shop, mail, lottery,
  check-in, dialogue, …) plus 10 pending routes (friend, guild, quest,
  activity, leaderboard, inventory). Each route declares its params schema
  so banner/dialogue forms can validate eagerly on both client and server.
- `modules/banner/` — multi-slot carousel groups; each banner carries
  mobile+desktop image URLs, LinkAction, visibility window, and reuses
  mail's broadcast/multicast targeting (GIN index on target_user_ids).
  Admin CRUD + reorder; client API `GET /groups/:alias` resolves only
  aliased (= published) groups.
- `modules/dialogue/` — branching NPC/tutorial scripts. Nodes graph stored
  as jsonb, validated on every write (start node exists, next pointers
  resolve, no duplicate ids, rewards reference known item definitions).
  Client flow: start (grants onEnter rewards) → advance (with optional
  optionId) → completion. Rewards granted idempotently via
  item_grant_logs `(source, sourceId)` pre-check.
- Migration 0010 adds 4 tables with partial-unique alias indexes
  matching the convention used by check-in/shop/item/lottery/exchange.
- Vitest coverage: link validator unit tests + banner/dialogue service
  integration tests against a real Neon dev branch.

Admin dashboard (apps/admin)

- `/banner` and `/dialogue` routes: list → create → detail/edit with
  a shared `LinkActionEditor` component that reads LINK_ROUTES and
  renders route-specific param inputs dynamically.
- `ScriptEditor` uses a structured form (not JSON) with inline node
  and option cards, reusing shop's `ItemEntryEditor` for rewards and
  the shared LinkActionEditor for option click actions.
- Sidebar gains Banners (GalleryHorizontal) and Dialogue (MessagesSquare).
- ~125 i18n keys each in en.json / zh.json.

Fixes along the way

- `env.ts`: Better Auth's `auth.api.getSession` return type doesn't
  merge the organization plugin's `activeOrganizationId` field. Switch
  to `auth.$Infer.Session` + an explicit intersection for the plugin
  field, eliminating ~136 pre-existing TS errors across every admin
  route handler.
- `_dashboard.tsx`: under Vite SSR, `better-auth/react`'s `useSession`
  triggers an "invalid hook call" because of a React dual-package hazard.
  Moved the session-aware logic into a mounted-guarded child so the
  dashboard renders correctly in the dev preview.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: dengzhaofun

.claude/settings.local.json

@@ -1,7 +1,8 @@
 {
   "permissions": {
     "allow": [
-      "Bash(pnpm exec:*)"
+      "Bash(pnpm exec:*)",
+      "Bash(pnpm install:*)"
     ]
   }
 }

apps/admin/messages/en.json

@@ -406,5 +406,139 @@
   "shop_growth_only": "Growth pack only.",
   "shop_back_to_products": "Back to products",
   "shop_back_to_categories": "Back to categories",
-  "shop_manage_stages": "Manage growth stages"
+  "shop_manage_stages": "Manage growth stages",
+
+  "nav_banner": "Banners",
+  "nav_dialogue": "Dialogue",
+
+  "banner_title": "Banner Groups",
+  "banner_new_group": "New Group",
+  "banner_edit_group": "Edit Group",
+  "banner_empty": "No banner groups yet.",
+  "banner_failed_load": "Failed to load banner groups:",
+  "banner_group_created": "Group created",
+  "banner_group_updated": "Group updated",
+  "banner_group_deleted": "Group deleted",
+  "banner_failed_create_group": "Failed to create group",
+  "banner_failed_update_group": "Failed to update group",
+  "banner_failed_delete_group": "Failed to delete group",
+  "banner_field_alias": "Alias",
+  "banner_field_alias_hint": "Slug used by the client app to resolve this group. Leave blank to keep it as a draft.",
+  "banner_field_name": "Name",
+  "banner_field_description": "Description",
+  "banner_field_layout": "Layout",
+  "banner_field_interval": "Auto-rotate interval (ms)",
+  "banner_field_active": "Active",
+  "banner_layout_carousel": "Carousel",
+  "banner_layout_single": "Single",
+  "banner_layout_grid": "Grid",
+  "banner_banners_title": "Banners",
+  "banner_banners_empty": "No banners in this group yet.",
+  "banner_new_banner": "New Banner",
+  "banner_edit_banner": "Edit Banner",
+  "banner_banner_created": "Banner created",
+  "banner_banner_updated": "Banner updated",
+  "banner_banner_deleted": "Banner deleted",
+  "banner_failed_create_banner": "Failed to create banner",
+  "banner_failed_update_banner": "Failed to update banner",
+  "banner_failed_delete_banner": "Failed to delete banner",
+  "banner_field_banner_title": "Title",
+  "banner_field_image_mobile": "Image URL (mobile)",
+  "banner_field_image_desktop": "Image URL (desktop)",
+  "banner_field_alt_text": "Alt text",
+  "banner_field_sort_order": "Sort order",
+  "banner_field_visible_from": "Visible from",
+  "banner_field_visible_until": "Visible until",
+  "banner_field_target_type": "Audience",
+  "banner_field_target_user_ids": "End user IDs (comma or newline separated)",
+  "banner_target_broadcast": "Broadcast (everyone)",
+  "banner_target_multicast": "Multicast (listed users)",
+  "banner_back_to_groups": "Back to groups",
+  "banner_back_to_group": "Back to group",
+  "banner_delete_group_title": "Delete this group?",
+  "banner_delete_group_desc": "This removes the group and all its banners.",
+  "banner_delete_banner_title": "Delete this banner?",
+  "banner_delete_banner_desc": "This permanently removes the banner.",
+  "banner_move_up": "Move up",
+  "banner_move_down": "Move down",
+  "banner_draft_badge": "Draft (no alias)",
+  "banner_status_active": "Active",
+  "banner_status_inactive": "Inactive",
+  "banner_col_preview": "Preview",
+  "banner_col_title": "Title",
+  "banner_col_visibility": "Visibility",
+  "banner_col_target": "Audience",
+  "banner_col_link": "Link",
+  "banner_col_status": "Status",
+  "banner_col_actions": "Actions",
+
+  "dialogue_title": "Dialogue Scripts",
+  "dialogue_new_script": "New Script",
+  "dialogue_edit_script": "Edit Script",
+  "dialogue_empty": "No dialogue scripts yet.",
+  "dialogue_failed_load": "Failed to load dialogue scripts:",
+  "dialogue_script_created": "Script created",
+  "dialogue_script_updated": "Script updated",
+  "dialogue_script_deleted": "Script deleted",
+  "dialogue_failed_create_script": "Failed to create script",
+  "dialogue_failed_update_script": "Failed to update script",
+  "dialogue_failed_delete_script": "Failed to delete script",
+  "dialogue_field_alias": "Alias",
+  "dialogue_field_alias_hint": "Slug used by the client app to trigger this script. Leave blank to keep it as a draft.",
+  "dialogue_field_name": "Name",
+  "dialogue_field_description": "Description",
+  "dialogue_field_start_node": "Start node",
+  "dialogue_field_repeatable": "Repeatable",
+  "dialogue_field_active": "Active",
+  "dialogue_nodes_title": "Nodes",
+  "dialogue_nodes_empty": "This script has no nodes yet. Add at least one.",
+  "dialogue_add_node": "Add node",
+  "dialogue_remove_node": "Remove node",
+  "dialogue_node_id": "Node ID",
+  "dialogue_node_speaker_name": "Speaker name",
+  "dialogue_node_speaker_avatar": "Speaker avatar URL",
+  "dialogue_node_speaker_side": "Speaker side",
+  "dialogue_side_left": "Left",
+  "dialogue_side_right": "Right",
+  "dialogue_node_content": "Content",
+  "dialogue_node_next": "Default next node",
+  "dialogue_node_next_none": "— (end of script)",
+  "dialogue_node_on_enter_rewards": "On-enter rewards",
+  "dialogue_options_title": "Options",
+  "dialogue_add_option": "Add option",
+  "dialogue_remove_option": "Remove option",
+  "dialogue_option_id": "Option ID",
+  "dialogue_option_label": "Label",
+  "dialogue_option_next": "Next node",
+  "dialogue_option_rewards": "Option rewards",
+  "dialogue_option_action": "Click action",
+  "dialogue_delete_script_title": "Delete this script?",
+  "dialogue_delete_script_desc": "This permanently removes the script and all player progress for it.",
+  "dialogue_back_to_scripts": "Back to scripts",
+  "dialogue_save_script": "Save script",
+  "dialogue_col_name": "Name",
+  "dialogue_col_alias": "Alias",
+  "dialogue_col_nodes": "Nodes",
+  "dialogue_col_repeatable": "Repeatable",
+  "dialogue_col_status": "Status",
+  "dialogue_draft_badge": "Draft (no alias)",
+  "dialogue_error_name_required": "Name is required",
+  "dialogue_error_start_node_invalid": "Start node must match one of the nodes",
+  "dialogue_error_duplicate_node_id": "Duplicate node id",
+  "dialogue_error_duplicate_option_id": "Duplicate option id within a node",
+  "dialogue_error_bad_next": "'next' points to a node that does not exist",
+
+  "link_none": "No action",
+  "link_external": "External URL",
+  "link_internal": "Internal route",
+  "link_url": "URL",
+  "link_open_in": "Open in",
+  "link_open_blank": "New tab",
+  "link_open_self": "Same tab",
+  "link_route": "Route",
+  "link_param_label": "Param",
+  "link_add_param": "Add param",
+  "link_pending_badge": "Pending module",
+  "link_action": "Click action",
+  "link_param_hint_uuid": "Must be a UUID"
 }

apps/admin/messages/zh.json

@@ -406,5 +406,139 @@
   "shop_growth_only": "仅成长礼包可用。",
   "shop_back_to_products": "返回商品列表",
   "shop_back_to_categories": "返回分类列表",
-  "shop_manage_stages": "管理成长阶段"
+  "shop_manage_stages": "管理成长阶段",
+
+  "nav_banner": "轮播图",
+  "nav_dialogue": "对话",
+
+  "banner_title": "轮播位",
+  "banner_new_group": "新建轮播位",
+  "banner_edit_group": "编辑轮播位",
+  "banner_empty": "暂无轮播位。",
+  "banner_failed_load": "加载轮播位失败：",
+  "banner_group_created": "轮播位已创建",
+  "banner_group_updated": "轮播位已更新",
+  "banner_group_deleted": "轮播位已删除",
+  "banner_failed_create_group": "创建轮播位失败",
+  "banner_failed_update_group": "更新轮播位失败",
+  "banner_failed_delete_group": "删除轮播位失败",
+  "banner_field_alias": "别名",
+  "banner_field_alias_hint": "客户端按该别名取轮播位。留空则视为未发布草稿。",
+  "banner_field_name": "名称",
+  "banner_field_description": "说明",
+  "banner_field_layout": "布局",
+  "banner_field_interval": "自动轮播间隔（毫秒）",
+  "banner_field_active": "启用",
+  "banner_layout_carousel": "轮播",
+  "banner_layout_single": "单张",
+  "banner_layout_grid": "网格",
+  "banner_banners_title": "轮播图",
+  "banner_banners_empty": "该轮播位下还没有轮播图。",
+  "banner_new_banner": "新建轮播图",
+  "banner_edit_banner": "编辑轮播图",
+  "banner_banner_created": "轮播图已创建",
+  "banner_banner_updated": "轮播图已更新",
+  "banner_banner_deleted": "轮播图已删除",
+  "banner_failed_create_banner": "创建轮播图失败",
+  "banner_failed_update_banner": "更新轮播图失败",
+  "banner_failed_delete_banner": "删除轮播图失败",
+  "banner_field_banner_title": "标题",
+  "banner_field_image_mobile": "移动端图片 URL",
+  "banner_field_image_desktop": "桌面端图片 URL",
+  "banner_field_alt_text": "替代文本",
+  "banner_field_sort_order": "排序",
+  "banner_field_visible_from": "上架时间",
+  "banner_field_visible_until": "下架时间",
+  "banner_field_target_type": "投放对象",
+  "banner_field_target_user_ids": "终端用户 ID（以逗号或换行分隔）",
+  "banner_target_broadcast": "全员广播",
+  "banner_target_multicast": "定向多播",
+  "banner_back_to_groups": "返回轮播位列表",
+  "banner_back_to_group": "返回轮播位",
+  "banner_delete_group_title": "删除该轮播位？",
+  "banner_delete_group_desc": "将同时删除轮播位下所有轮播图。",
+  "banner_delete_banner_title": "删除该轮播图？",
+  "banner_delete_banner_desc": "此操作不可撤销。",
+  "banner_move_up": "上移",
+  "banner_move_down": "下移",
+  "banner_draft_badge": "草稿（未设别名）",
+  "banner_status_active": "启用",
+  "banner_status_inactive": "停用",
+  "banner_col_preview": "预览",
+  "banner_col_title": "标题",
+  "banner_col_visibility": "可见时段",
+  "banner_col_target": "投放对象",
+  "banner_col_link": "跳转",
+  "banner_col_status": "状态",
+  "banner_col_actions": "操作",
+
+  "dialogue_title": "对话剧本",
+  "dialogue_new_script": "新建剧本",
+  "dialogue_edit_script": "编辑剧本",
+  "dialogue_empty": "暂无对话剧本。",
+  "dialogue_failed_load": "加载对话剧本失败：",
+  "dialogue_script_created": "剧本已创建",
+  "dialogue_script_updated": "剧本已更新",
+  "dialogue_script_deleted": "剧本已删除",
+  "dialogue_failed_create_script": "创建剧本失败",
+  "dialogue_failed_update_script": "更新剧本失败",
+  "dialogue_failed_delete_script": "删除剧本失败",
+  "dialogue_field_alias": "别名",
+  "dialogue_field_alias_hint": "客户端按该别名触发本剧本。留空视为未发布草稿。",
+  "dialogue_field_name": "名称",
+  "dialogue_field_description": "说明",
+  "dialogue_field_start_node": "起始节点",
+  "dialogue_field_repeatable": "可重复",
+  "dialogue_field_active": "启用",
+  "dialogue_nodes_title": "节点",
+  "dialogue_nodes_empty": "本剧本还没有节点，请先添加一个。",
+  "dialogue_add_node": "添加节点",
+  "dialogue_remove_node": "删除节点",
+  "dialogue_node_id": "节点 ID",
+  "dialogue_node_speaker_name": "说话人名称",
+  "dialogue_node_speaker_avatar": "说话人头像 URL",
+  "dialogue_node_speaker_side": "说话人位置",
+  "dialogue_side_left": "左",
+  "dialogue_side_right": "右",
+  "dialogue_node_content": "台词",
+  "dialogue_node_next": "默认下一节点",
+  "dialogue_node_next_none": "—（剧本结束）",
+  "dialogue_node_on_enter_rewards": "进入节点奖励",
+  "dialogue_options_title": "选项",
+  "dialogue_add_option": "添加选项",
+  "dialogue_remove_option": "删除选项",
+  "dialogue_option_id": "选项 ID",
+  "dialogue_option_label": "文案",
+  "dialogue_option_next": "下一节点",
+  "dialogue_option_rewards": "选项奖励",
+  "dialogue_option_action": "跳转动作",
+  "dialogue_delete_script_title": "删除该剧本？",
+  "dialogue_delete_script_desc": "将删除剧本及所有玩家进度，不可恢复。",
+  "dialogue_back_to_scripts": "返回剧本列表",
+  "dialogue_save_script": "保存剧本",
+  "dialogue_col_name": "名称",
+  "dialogue_col_alias": "别名",
+  "dialogue_col_nodes": "节点数",
+  "dialogue_col_repeatable": "可重复",
+  "dialogue_col_status": "状态",
+  "dialogue_draft_badge": "草稿（未设别名）",
+  "dialogue_error_name_required": "名称必填",
+  "dialogue_error_start_node_invalid": "起始节点必须匹配其中一个节点",
+  "dialogue_error_duplicate_node_id": "节点 ID 重复",
+  "dialogue_error_duplicate_option_id": "同一节点内的选项 ID 重复",
+  "dialogue_error_bad_next": "'next' 指向的节点不存在",
+
+  "link_none": "不跳转",
+  "link_external": "外部链接",
+  "link_internal": "内部路由",
+  "link_url": "URL",
+  "link_open_in": "打开方式",
+  "link_open_blank": "新标签页",
+  "link_open_self": "当前标签页",
+  "link_route": "路由",
+  "link_param_label": "参数",
+  "link_add_param": "添加参数",
+  "link_pending_badge": "模块待实现",
+  "link_action": "跳转动作",
+  "link_param_hint_uuid": "必须是 UUID"
 }

apps/admin/src/components/AppSidebar.tsx

@@ -3,9 +3,11 @@ import { Link } from "@tanstack/react-router"
 import {
   ArrowLeftRight,
   CalendarCheck,
+  GalleryHorizontal,
   KeyRound,
   LayoutDashboard,
   Mail,
+  MessagesSquare,
   Package,
   ShoppingCart,
 } from "lucide-react"
@@ -34,6 +36,8 @@ function getNavItems() {
     { title: m.nav_exchange(), to: "/exchange" as const, icon: ArrowLeftRight },
     { title: m.nav_shop(), to: "/shop" as const, icon: ShoppingCart },
     { title: m.nav_mail(), to: "/mail" as const, icon: Mail },
+    { title: m.nav_banner(), to: "/banner" as const, icon: GalleryHorizontal },
+    { title: m.nav_dialogue(), to: "/dialogue" as const, icon: MessagesSquare },
     { title: m.nav_api_keys(), to: "/api-keys" as const, icon: KeyRound },
   ]
 }