新增后台Dashboard并修正画板规范图选择

新增后台 Dashboard 默认入口、日周月筛选和运营汇总页签

补充后台 Dashboard 数据契约、接口统计和文档

修正画板角色与图标规范图选择、缓存和提示状态

修复创作页桌面导航类型收窄错误

更新 Codex 环境初始化脚本和相关回归测试记录

docs/technical/【后台管理】Dashboard运营看板方案-2026-06-23.md

@@ -0,0 +1,40 @@
+# 后台 Dashboard 运营看板方案
+
+## 范围
+
+- 后台管理默认入口为 `#dashboard`，原服务 / 数据库状态页保留为 `#overview`，导航展示名为“服务总览”。
+- Dashboard 由 `GET /admin/api/dashboard` 提供统一 BFF 投影，前端只展示后端返回的 `range`、`metrics`、`charts`、`operations` 和 `warnings`。
+- 本次不修改 SpacetimeDB schema，不新增统计表；读取现有 private 表后在 api-server 聚合。
+
+## 查询参数
+
+`GET /admin/api/dashboard?granularity=day|week|month&anchor=YYYY-MM-DD`
+
+- `granularity` 默认为 `day`。
+- `anchor` 使用北京时间日历日期。`week` 和 `month` 选择包含该日期的自然周 / 自然月。
+- 前端在日 / 周 / 月模式分别展示日期、周、月份选择器；周选择器会把选中的周转换为该周周一作为 `anchor`，月份选择器会转换为当月 1 日作为 `anchor`。
+- 前端每 5 分钟自动刷新一次，同时保留手动刷新按钮。
+
+## 指标口径
+
+- 生产素材数：`editor_project_resource` 中 `source_type = 'generated'` 的资源，按 `created_at` 映射到北京时间业务日。
+- 消耗泥点数：`profile_wallet_ledger` 中 `source_type = asset_operation_consume` 且 `amount_delta < 0` 的流水绝对值，按 `created_at` 映射到北京时间业务日。
+- 总注册用户：`profile_dashboard_state` 行数。
+- 访问次数：`tracking_daily_stat` 中 `scope_kind = site` 的日聚合次数。它表示站点级成功路由 / 站点级事件，不把用户级钱包、任务、生成等业务操作混入访问次数。
+- 访问人数：当前数据只具备登录用户维度，按 `tracking_daily_stat` 中 `scope_kind = user` 的 `scope_id` 去重；匿名访问人数需要未来补充稳定 visitor id 后才能统计。
+- 当前使用人数：最近 5 分钟内 `tracking_event` 中有 `user_id` 的登录用户去重；不跟随页面选择的历史日 / 周 / 月。
+- 运营汇总页签：复用同一时间窗，展示运营指标卡、素材类型分布和访问模块分布。
+
+## 前后端文件
+
+- 后端路由：`server-rs/crates/api-server/src/modules/admin.rs`
+- 后端聚合：`server-rs/crates/api-server/src/admin.rs`
+- 契约：`server-rs/crates/shared-contracts/src/admin.rs`、`apps/admin-web/src/api/adminApiTypes.ts`
+- 前端页面：`apps/admin-web/src/pages/AdminDashboardPage.tsx`
+- 后台路由：`apps/admin-web/src/app/adminRoutes.ts`
+
+## 验证
+
+- `cargo test -p api-server --manifest-path server-rs/Cargo.toml admin`
+- `npm run admin-web:typecheck`
+- `npx vitest run apps/admin-web/src/pages/AdminDashboardPage.test.tsx apps/admin-web/src/app/adminRoutes.test.ts --reporter verbose`