Neo
6f8f12314f
包含多个会话的累积代码变更： - backend: AI 聊天服务、触发器调度、认证增强、WebSocket、调度器最小间隔 - admin-web: ETL 状态页、任务管理、调度配置、登录优化 - miniprogram: 看板页面、聊天集成、UI 组件、导航更新 - etl: DWS 新任务（finance_area_daily/board_cache）、连接器增强 - tenant-admin: 项目初始化 - db: 19 个迁移脚本（etl_feiqiu 11 + zqyy_app 8） - packages/shared: 枚举和工具函数更新 - tools: 数据库工具、报表生成、健康检查 - docs: PRD/架构/部署/合约文档更新 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
70 lines
3.2 KiB
Markdown
70 lines
3.2 KiB
Markdown
# P8→NS1/RNS1 缺失项 #2：财务看板分段加载策略
|
||
|
||
## 简要结论
|
||
- 状态：⚠️ 部分解决
|
||
- 风险等级：🔴 高
|
||
- 后端 BOARD-3 API 一次返回全部 6 板块数据，无 sections 参数支持分段加载；前端仅赠送卡矩阵做了异步加载，其余板块为 mock 静态数据。
|
||
|
||
## 详细审查
|
||
|
||
### 审查范围
|
||
- `apps/backend/app/routers/xcx_board.py`（BOARD-3 路由定义）
|
||
- `apps/backend/app/schemas/xcx_board.py`（FinanceBoardResponse schema）
|
||
- `apps/backend/app/services/board_service.py`（get_finance_board 服务）
|
||
- `apps/miniprogram/miniprogram/pages/board-finance/board-finance.ts`（前端加载逻辑）
|
||
|
||
### 发现
|
||
|
||
1. **后端 API 不支持分段加载**
|
||
- BOARD-3 路由参数仅有 `time`、`area`、`compare`，无 `sections` 参数
|
||
- `FinanceBoardResponse` 一次性返回全部 6 个 Panel：`overview`、`recharge`、`revenue`、`cashflow`、`expense`、`coach_analysis`
|
||
- `get_finance_board` 服务函数内部顺序构建所有板块数据，无条件跳过机制
|
||
|
||
2. **前端加载策略：大部分为 mock 静态数据**
|
||
- `board-finance.ts` 中 `overview`、`revenue`、`cashflow`、`expense`、`coachAnalysis` 的数据全部在 Page data 中以空字符串初始化，未调用 API
|
||
- 仅 `_loadGiftRows()` 方法通过 `fetchBoardFinance()` 加载了赠送卡矩阵（`recharge.giftRows`）和 AI 洞察数据
|
||
- 页面 `onLoad` 时直接设置 `pageState: 'normal'`，无整体数据加载流程
|
||
|
||
3. **唯一的区域条件过滤**
|
||
- `recharge` 板块在 `selectedArea !== 'all'` 时通过 `wx:if` 隐藏（前端条件渲染）
|
||
- 后端 schema 中 `recharge: RechargePanel | None` 支持 area≠all 时返回 null
|
||
|
||
### 证据
|
||
|
||
```python
|
||
# xcx_board.py — BOARD-3 路由，无 sections 参数
|
||
@router.get("/finance", response_model=FinanceBoardResponse)
|
||
async def get_finance_board(
|
||
time: FinanceTimeEnum = Query(default=FinanceTimeEnum.month),
|
||
area: AreaFilterEnum = Query(default=AreaFilterEnum.all),
|
||
compare: int = Query(default=0, ge=0, le=1),
|
||
user: CurrentUser = Depends(require_permission("view_board_finance")),
|
||
):
|
||
|
||
# FinanceBoardResponse — 一次返回全部 6 板块
|
||
class FinanceBoardResponse(CamelModel):
|
||
overview: OverviewPanel
|
||
recharge: RechargePanel | None
|
||
revenue: RevenuePanel
|
||
cashflow: CashflowPanel
|
||
expense: ExpensePanel
|
||
coach_analysis: CoachAnalysisPanel
|
||
```
|
||
|
||
```typescript
|
||
// board-finance.ts — 仅加载赠送卡数据，其余为 mock
|
||
async _loadGiftRows() {
|
||
const data = await fetchBoardFinance({
|
||
time: this.data.selectedTime,
|
||
area: this.data.selectedArea,
|
||
compare: this.data.compareEnabled ? 1 : 0,
|
||
})
|
||
// 仅处理 giftRows 和 aiInsights
|
||
}
|
||
```
|
||
|
||
### 建议
|
||
1. **后端**：为 BOARD-3 API 增加可选 `sections` 查询参数（如 `sections=overview,recharge`），服务层按需构建板块，未请求的板块返回 null
|
||
2. **前端**：实现分段加载策略——首次加载仅请求 `overview`，用户滚动到对应板块时再按需请求其余板块（利用 IntersectionObserver 或 onPageScroll 触发）
|
||
3. 当前 mock 数据阶段此问题影响不大，但联调前必须完成分段加载改造，否则 6 板块全量查询会导致首屏加载缓慢
|