更新wz-app项目，新增2026-04-24的占位补齐与wz-api对接记录，完善经验清单和项目索引文档，确保文档内容的完整性与一致性，同时优化相关功能以提升用户体验。

2026-04-24 10:42:12 +08:00
parent c3e89e5563
commit 3f0add60a5
9 changed files with 65 additions and 2 deletions
--- a/.cursor/agent/开发助理/evolution/2026-04-24-wz-app经验吸收与文档.md
+++ b/.cursor/agent/开发助理/evolution/2026-04-24-wz-app经验吸收与文档.md
@@ -0,0 +1,16 @@
+# 2026-04-24 — wz-app 经验吸收与文档同步（跨端摘要）
+
+## 背景
+
+玩值次线 **`new/wz-app`** 完成占位清零与 wz-api 联调类改造，涉及文档多份与 **wz-app-dev** 规范补充。
+
+## 跨端要点
+
+- **文档真源**：`迁移-API对照表.md`、`迁移-wz-app路由映射.md`、`进度-看板.md`、`MIGRATION.md` 与实现保持同步；新增/变更 C 端调用的路径必须登记。
+- **管理端**：公会/旅程/主播数据运营侧沿用既有 **`/api/admin/wz/*`**（如 journey-events 查询），本次 C 端未要求新增 admin 页面。
+- **API**：现有 `streamer/*`、`screen/data/dashboard`、`analytics/journey-events` 已满足本批；评论持久化属后续需求。
+
+## 索引
+
+- 玩值移动端工程师：`evolution/2026-04-24-wz-app占位补齐与wz-api对接.md`
+- 项目索引：`agent/开发助理/项目索引/玩值.md` 开发进度表已追加。
--- a/.cursor/agent/开发助理/evolution/索引.md
+++ b/.cursor/agent/开发助理/evolution/索引.md
@@ -4,6 +4,7 @@

 | 日期 | 摘要 | 文件 |
 |------|------|------|
+| 2026-04-24 | wz-app 经验吸收与文档同步（跨端摘要） | 2026-04-24-wz-app经验吸收与文档.md |
 | 2026-04-22 | TS 原生编译跨平台（Perry）全员吸收与 Skill 沉淀 | 2026-04-22-TS原生编译跨平台全员吸收.md |
 | 2026-03-21 | MBTI 头像小程序全链路兜底 + 匹配接口回填 | 2026-03-21-MBTI头像C端全链路兜底.md |
 | 2026-03-16 | 用户交互习惯分析（基于 agent-transcripts） | 2026-03-16-交互习惯分析.md |
--- a/.cursor/agent/开发助理/经验清单.md
+++ b/.cursor/agent/开发助理/经验清单.md
@@ -22,6 +22,7 @@

 | 日期 | 角色 | 类型 | 升级 Skill | 摘要 |
 |------|------|------|------------|------|
+| 2026-04-24 | 玩值移动端、开发助理 | 迁移/联调/文档 | wz-app-dev SKILL §5 | wz-app 占位清零：大屏只读、主播/观众 API、公会旅程埋点、动态评论本地态、删 Stub；对照表/看板/MIGRATION 同步 |
 | 2026-04-22 | 玩值API、玩值管理端、玩值移动端、开发助理 | 技术选型方法论 | ts-native-cross-platform SKILL | 基于 Perry 文章沉淀跨平台统一评估框架：POC 先行、指标门禁、工具链前置、回退机制 |
 | 2026-02-27 | 小程序、团队 | 最佳实践 | SKILL-小程序开发 §6、SKILL-管理端开发 §4.1 | 输入框 padding 用 view/div 包裹 |
 | 2026-02-28 | 小程序、管理端 | 最佳实践 | miniprogram §6、admin §4.1 | input 边距口诀「外边包 view、内部 width 100%」；match 弹窗已修正 |
--- a/.cursor/agent/开发助理/项目索引/玩值.md
+++ b/.cursor/agent/开发助理/项目索引/玩值.md
@@ -14,5 +14,6 @@
 | 2026-04-20 | wz-app | **策略**：主做 **H5**，后续 **App**；小程序按需；README/边界规则/wz-app-dev/看板/真源 README 已同步 |
 | 2026-04-21 | wz-app | 完整迁移计划落地：路由映射、TabBar+subPackages 占位、`src/`+Vite 工具链、token+登录注册+我的、首页 streamers；文档/看板/日志 |
 | 2026-04-23 | 玩值三端 | 直播+点卡：wz-api C 端点卡与 admin 房间详情；wz-app LivePage、mall 点卡、动态入口；对照表/看板已更新 |
+| 2026-04-24 | wz-app（Vite） | 占位补齐：Screen 接 dashboard+健康+build-info；主播工作台/观众洞察接 streamer API；Guild 创建意向接 journey；Moments 评论本地态；删 Stub；`api/app`+`lib/journey`；对照表/看板/MIGRATION 同步；build 通过 |

-最后更新：2026-04-23
+最后更新：2026-04-24
--- a/.cursor/agent/玩值移动端工程师/evolution/2026-04-24-wz-app占位补齐与wz-api对接.md
+++ b/.cursor/agent/玩值移动端工程师/evolution/2026-04-24-wz-app占位补齐与wz-api对接.md
@@ -0,0 +1,23 @@
+# 2026-04-24 — wz-app 占位补齐与 wz-api 对接
+
+## 场景
+
+`new/wz-app`（Vite + React）按「占位补齐与团队开发指挥计划」消除纯占位页与核心演示态，并与 wz-api 契约对齐。
+
+## 结论 / 做法
+
+1. **大屏 `/screen`**：`ScreenPage` 拉 **`GET /api/screen/data/dashboard`** 展示聚合统计，并联 **`GET /api/app/health`**、**`GET /api/public/build-info`**；失败时明确错误提示与刷新。C 端只读，完整运营多屏仍在 wz-admin。
+2. **主播域**：`StreamerStudioPage` 用 **`GET /api/app/streamer/me`** 同步状态，**`POST /api/app/streamer/live`** 开/关播，**`GET /api/app/streamer/live/cloud`** 取推拉流占位 URL；非已审主播引导「申请大神」。`StreamerAudiencePage` 用 **`GET /api/app/streamer/audience-insights`** 展示旅程事件汇总与列表。
+3. **公会**：`GuildListPage` 新晋/排行榜用数据填充；「创建公会」弹窗提交 **`POST /api/app/analytics/journey-events`**（如 `guild_create_intent`），封装在 **`new/wz-app/src/lib/journey.ts`**（`sessionId` / `clientEventId` / `source: h5`，未登录补 `anonymousId`）。
+4. **社区**：`MomentsPage` 评论为**会话内本地列表**，全站持久化需后续 C 口；`ZoneDetailPage` 四宫格改为真实路由跳转；`StarDetailPage` 分享为复制主页链接。
+5. **API 封装**：集中在 **`new/wz-app/src/api/app.ts`**（含 `screenDataDashboard`、`publicBuildInfo`、`appStreamerMe`、live、cloud、audience-insights）；**禁止** C 端调 `/api/admin/*`。
+6. **收尾**：删除未再引用的 `StackStubPage` / `ParamStubPage`；更新 `MIGRATION.md`、路由映射、**`开发文档/玩值/迁移-API对照表.md`**、**`进度-看板.md`**；`npm run build` 通过。
+
+## 待续
+
+- 动态评论落库：需新增 **`/api/app/*`** 评论接口后再接 `MomentsPage`。
+- 观众洞察：当前为旅程事件简化版；若产品要「按观众维度」指标，需 API 扩展与管理端配置。
+
+## 升级 Skill
+
+- `wz-app-dev`：补充 **new/wz-app** 下 Vite 请求层、只读大屏与旅程埋点例外、主播接口清单。
--- a/.cursor/agent/玩值移动端工程师/evolution/索引.md
+++ b/.cursor/agent/玩值移动端工程师/evolution/索引.md
@@ -2,6 +2,7 @@

 | 日期 | 主题 |
 |------|------|
+| 2026-04-24 | [wz-app 占位补齐与 wz-api 对接](2026-04-24-wz-app占位补齐与wz-api对接.md) |
 | 2026-04-23 | [全屏直播与点卡商城](2026-04-23-全屏直播与点卡商城.md) |
 | 2026-04-22 | [wz-app Uno 与 custom-tabbar](2026-04-22-wz-app-Uno与custom-tabbar.md) |
 | 2026-04-22 | [TS原生编译跨平台吸收（Perry）](2026-04-22-TS原生编译跨平台吸收.md) |
--- a/.cursor/skills/assistant-doc-sync/sync-log.md
+++ b/.cursor/skills/assistant-doc-sync/sync-log.md
@@ -6,6 +6,10 @@

 ---

+## 2026-04-24
+
+- 吸收经验：玩值移动端 + 开发助理 — wz-app 占位补齐与 wz-api 对接（`evolution/2026-04-24-*.md`、经验清单、项目索引玩值、wz-app-dev §5 补充）
+
 ## 2026-04-23

 - 玩值三端直播+点卡打通：纪要 `meeting/2026-04-23_玩值三端直播点卡打通.md`；经验入库玩值 API/管理端/移动端；项目索引玩值.md、迁移对照表、进度看板、会议 README 索引
--- a/.cursor/skills/wz-app-dev/SKILL.md
+++ b/.cursor/skills/wz-app-dev/SKILL.md
@@ -41,3 +41,15 @@ description: Trigger when 编辑 old/app、new/wz-app 玩值 C 端、Next/React
 ## 4. 变更检查

 与 **wz-api** 或 **wz-admin** 联动的功能变更，完成后走 **`.cursor/skills/change-checklist/SKILL.md`（玩值三端：API + 管理端 + `old` C 端）**。
+
+---
+
+## 5. `new/wz-app`（Vite + React，次线）
+
+- **联调与封装**：C 口请求集中在 **`new/wz-app/src/api/app.ts`**，环境变量用 **`VITE_WZ_API_BASE`**（**无**末尾 `/`）。鉴权、401 等逻辑与 wz-api `/api/app/*` 一致。
+- **与 §1 的例外**（只读、仍禁止 admin/db）：
+  - **大屏**：页面如 **`/screen`** 可调用 **`GET /api/screen/data/dashboard`** 展示只读看板；可并联 **`GET /api/app/health`**、**`GET /api/public/build-info`** 做健康与版本条。
+  - **旅程/埋点**：**`POST /api/app/analytics/journey-events`** 可经 **`new/wz-app/src/lib/journey.ts`** 复用（`sessionId` / `clientEventId` / `source: h5`；未登录补 `anonymousId`）。
+- **主播**（均仍在 `/api/app` 下）：**`streamer/me`**、**`streamer/live`（开/关播）**、**`streamer/live/cloud`**、**`streamer/audience-insights`**；实现参考 `Stream*`、`StreamerStudioPage`、`StreamerAudiencePage`。
+- **文档**：改路由或新调接口时，同步 **`开发文档/玩值/迁移-wz-app路由映射.md`**、**`迁移-API对照表.md`**、**`MIGRATION.md`**、**`进度-看板.md`**，并 `npm run build` 自测通过。
+- **与主线 `old/app` 去重**：避免两套长期分叉同一业务；`new/wz-app` 仅作壳/灰度/实验时，优先把契约落在文档与 wz-api，再两端各自对接。
--- a/new/wz-app/README.md
+++ b/new/wz-app/README.md
@@ -12,7 +12,11 @@
 1. **先启动后端** `new/wz-api`（需 `DB_DSN` 等；**`PORT` 见 `new/wz-api/.env.development`，本仓库默认 `48080`**）。可访问 `http://127.0.0.1:48080/health` 确认存活。
 2. 本目录执行 `npm install` → **`npm run dev`**（Vite 默认 5173）。
 3. 前端请求 `/api/...` 由 Vite 代理到 **`WZ_API_PROXY_TARGET`**（**必须与 wz-api 的 `PORT` 一致**；与仓库默认对齐为 **48080**）。
-4. **手机/局域网**访问 dev：使用 `npm run dev`（已配置 `--host` 时见 `package.json`），用电脑 IP + `:5173` 打开；此时 `/api` 仍由运行 Vite 的电脑本机代理到 `127.0.0.1:PORT`（若手机需直连 wz-api，可设 `VITE_API_BASE_URL=http://电脑IP:PORT` 并保证 wz-api 监听 `0.0.0.0`、防火墙放行 **同一 PORT**）。
+4. **手机/局域网**访问 dev：使用 `npm run dev`（已配置 `--host` 时见 `package.json`），用电脑 IP + `:5173`（或终端里给出的端口如 `5174`）打开；此时 `/api` 仍由运行 Vite 的电脑本机代理到 `127.0.0.1:PORT`（若手机需直连 wz-api，可设 `VITE_API_BASE_URL=http://电脑IP:PORT` 并保证 wz-api 监听 `0.0.0.0`、防火墙放行 **同一 PORT**）。
+
+5. **`GET /api/app/mall/point-cards` 在浏览器里 404**：先**绕过 Vite**访问后端根地址（端口与 wz-api 的 `PORT` 一致，默认 `48080`）：`http://127.0.0.1:48080/api/app/mall/point-cards`。
+   - 若该直连仍是 **404**，而 **`GET /api/app/streamers` 为 200**，说明当前正在跑的 wz-api **可执行文件过旧、未编进点卡路由**，与仓库 `new/wz-api` 不一致；请在 `new/wz-api` 执行 `go build -o 你的路径/wz-api.exe ./cmd/server` 或 `go run ./cmd/server`，**停掉旧进程后**用新构建重启。
+   - 若直连为 **502/连不上** 而前端 404，多为未启动 wz-api 或 `WZ_API_PROXY_TARGET` 与 wz-api `PORT` 不一致（见上第 1、3 步）。

 与请求封装、错误提示：`src/lib/request.ts`、`src/lib/config.ts`。