diff --git a/.cursor/agent/开发助理/evolution/2026-04-24-wz-app经验吸收与文档.md b/.cursor/agent/开发助理/evolution/2026-04-24-wz-app经验吸收与文档.md new file mode 100644 index 0000000..b7870e7 --- /dev/null +++ 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` 开发进度表已追加。 diff --git a/.cursor/agent/开发助理/evolution/索引.md b/.cursor/agent/开发助理/evolution/索引.md index 1274ba3..2900994 100644 --- 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 | diff --git a/.cursor/agent/开发助理/经验清单.md b/.cursor/agent/开发助理/经验清单.md index 99ed3f2..3853024 100644 --- 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 弹窗已修正 | diff --git a/.cursor/agent/开发助理/项目索引/玩值.md b/.cursor/agent/开发助理/项目索引/玩值.md index 263f88c..ee5b13b 100644 --- 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 diff --git a/.cursor/agent/玩值移动端工程师/evolution/2026-04-24-wz-app占位补齐与wz-api对接.md b/.cursor/agent/玩值移动端工程师/evolution/2026-04-24-wz-app占位补齐与wz-api对接.md new file mode 100644 index 0000000..f15bd2b --- /dev/null +++ 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 请求层、只读大屏与旅程埋点例外、主播接口清单。 diff --git a/.cursor/agent/玩值移动端工程师/evolution/索引.md b/.cursor/agent/玩值移动端工程师/evolution/索引.md index 7f4a070..42b88a6 100644 --- 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) | diff --git a/.cursor/skills/assistant-doc-sync/sync-log.md b/.cursor/skills/assistant-doc-sync/sync-log.md index b658c28..4f90aa9 100644 --- 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 索引 diff --git a/.cursor/skills/wz-app-dev/SKILL.md b/.cursor/skills/wz-app-dev/SKILL.md index 9834cce..6ea10c8 100644 --- 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，再两端各自对接。 diff --git a/new/wz-app/README.md b/new/wz-app/README.md index 9111021..957ff2f 100644 --- 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`。