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>
2.3 KiB
2.3 KiB
P9→NS1/RNS1 缺失项 #23：客户详情页"可用月数"的计算说明
简要结论
- 状态：❌ 未解决
- 风险等级：🟡 低
available_months字段仅在客户看板 Schema 中定义，客户详情页 API 未返回该字段，计算公式未在代码中实现
详细审查
审查范围
apps/backend/app/services/customer_service.py—get_customer_detail()返回字段apps/backend/app/schemas/xcx_board.py— Schema 定义apps/backend/app/services/board_service.py— 看板服务apps/backend/app/services/fdw_queries.py— 数据查询
发现
xcx_board.py中定义了available_months: str # "约0.8个月"和monthly_consume: floatfdw_queries.py中查询了monthly_consume字段（来自v_dws_member_consumption_summary）- 但在整个后端代码中，未找到
available_months的计算赋值逻辑——仅有 Schema 定义 customer_service.py的get_customer_detail()返回字段中无available_months- 客户详情页前端也未展示"可用月数"字段
- P9 定义的计算公式（余额 ÷ 月均消耗）和边界处理（月均消耗为 0 时）均未实现
证据
# xcx_board.py — 仅有 Schema 定义
class CustomerBoardItem(BaseModel):
monthly_consume: float
available_months: str # "约0.8个月"
# customer_service.py — get_customer_detail() 返回值中无 available_months
return {
"id": customer_id,
"name": name,
"phone": phone,
"balance": balance,
"consumption_60d": consumption_60d,
"days_since_visit": days_since_visit,
# 无 available_months
}
# 全局搜索 available_months 赋值逻辑 → 无结果
# 仅在 Schema 定义中出现
建议
- 在
customer_service.py或board_service.py中实现计算逻辑：def _calc_available_months(balance: float, monthly_consume: float) -> str: if monthly_consume <= 0: return "—" # 月均消耗为 0，无法计算 months = balance / monthly_consume return f"约{months:.1f}个月" - 需要确认
monthly_consume的口径：是 60 天月均还是历史全量月均 - 边界处理：余额为 0 → "0个月"；月均消耗为 0 → 显示"—"或"充足"
- 将计算结果添加到
get_customer_detail()返回值中，前端在 Banner 统计区域展示