15 KiB
15 KiB
智能项目定价模型 - 产品需求文档（PRD）
版本：v1.0
创建日期：2026-01-19
最后更新：2026-01-19
负责人：待定
1. 文档概述
1.1 项目背景
医美行业项目定价面临多重挑战：成本构成复杂（耗材、人工、固定成本）、市场竞争激烈、定价缺乏数据支撑。传统定价方式依赖经验，难以在成本控制、市场竞争、利润目标之间找到最优平衡点。
1.2 项目目标
构建智能项目定价模型系统，通过数据驱动的方式，帮助机构：
- 精准核算项目成本，明确最低成本线
- 实时掌握市场行情，了解竞品定价
- 智能生成定价建议，支持多种定价策略
- 模拟利润测算，辅助经营决策
1.3 目标用户
| 角色 | 职责 | 使用场景 |
|---|---|---|
| 运营总监 | 整体定价策略制定 | 查看定价建议、利润模拟 |
| 财务人员 | 成本核算与管理 | 录入成本数据、成本分析 |
| 市场人员 | 市场信息收集 | 录入竞品价格、市场分析 |
| 店长 | 门店执行与反馈 | 查看定价参考、调整建议 |
2. 功能需求
2.1 模块一：成本核算模块
2.1.1 功能描述
精确核算单个项目的完整成本构成，自动计算项目最低成本线。
2.1.2 功能清单
| 功能点 | 优先级 | 描述 |
|---|---|---|
| 耗材成本管理 | P0 | 设备折旧、针剂、产品用量等 |
| 人工成本计算 | P0 | 操作时长 × 人效（时薪） |
| 固定成本分摊 | P0 | 房租水电等固定费用按项目分摊 |
| 成本汇总计算 | P0 | 自动汇总计算项目最低成本线 |
| 成本模板管理 | P1 | 预设常用成本模板，快速应用 |
| 成本历史记录 | P1 | 记录成本变化，支持趋势分析 |
2.1.3 详细需求
2.1.3.1 耗材成本管理
- 支持录入耗材基础信息：名称、单位、单价、供应商
- 支持设置耗材在项目中的用量
- 设备折旧计算：
- 录入设备原值、预计使用年限、残值率
- 自动计算单次使用折旧成本 = (原值 - 残值) / 总使用次数
- 支持批量导入耗材清单（Excel）
2.1.3.2 人工成本计算
- 录入项目操作时长（分钟）
- 配置不同岗位/级别的时薪标准
- 自动计算：人工成本 = 操作时长 × 时薪
- 支持多人协作项目的人工成本累计
2.1.3.3 固定成本分摊
- 录入月度固定成本（房租、水电、物业等）
- 设置分摊规则：
- 按项目数量平均分摊
- 按项目营收占比分摊
- 按项目时长占比分摊
- 自动计算单项目分摊金额
2.1.3.4 成本汇总
项目最低成本线 = 耗材成本 + 人工成本 + 固定成本分摊
输出：
- 成本构成明细
- 成本占比饼图
- 最低成本线（建议不低于此价格销售）
2.2 模块二：市场行情模块
2.2.1 功能描述
收集并分析周边竞品价格、标杆机构价格、区域市场均价，输出市场定价参考区间。
2.2.2 功能清单
| 功能点 | 优先级 | 描述 |
|---|---|---|
| 竞品价格录入 | P0 | 手动录入周边竞品同类项目价格 |
| 标杆机构参考 | P0 | 维护标杆机构价格带 |
| 区域均价分析 | P0 | 统计区域市场均价 |
| 市场区间输出 | P0 | 输出市场定价区间 |
| 智能价格爬取 | P2 | 自动爬取公开平台价格信息 |
| 价格趋势分析 | P1 | 价格历史变化趋势图 |
2.2.3 详细需求
2.2.3.1 竞品价格管理
- 竞品机构信息：名称、地址、定位（高端/中端/大众）、距离
- 竞品项目信息：
- 项目名称（支持关联到本店项目）
- 原价、促销价、会员价
- 价格来源（官网/美团/大众点评/实地调研）
- 采集时间
- 支持标记重点关注竞品
2.2.3.2 标杆机构参考
- 维护行业标杆机构清单
- 记录标杆机构各品类价格带
- 支持按品类查看标杆定价
2.2.3.3 市场分析输出
- 区域均价：同品类项目的市场平均价
- 价格分布：低/中/高价位段分布
- 输出市场定价区间：[最低价, 最高价]，建议中位价
2.3 模块三：智能定价建议
2.3.1 功能描述
综合成本、市场、目标利润率，通过 AI 分析给出智能定价建议，支持多种定价策略模拟。
2.3.2 功能清单
| 功能点 | 优先级 | 描述 |
|---|---|---|
| 综合定价计算 | P0 | 综合成本+市场+利润率计算 |
| 定价建议生成 | P0 | AI 分析生成价格建议区间 |
| 定价策略模拟 | P0 | 引流款/利润款/高端款策略 |
| 策略效果预测 | P1 | 预测不同策略的市场效果 |
| 定价报告导出 | P1 | 导出完整定价分析报告 |
2.3.3 详细需求
2.3.3.1 综合定价计算
输入参数：
- 项目成本数据（来自成本核算模块）
- 市场行情数据（来自市场行情模块）
- 目标毛利率（可配置，默认 50%-70%）
计算逻辑：
成本定价 = 项目成本 / (1 - 目标毛利率)
市场定价 = 市场均价 ± 调整系数
2.3.3.2 定价策略模拟
| 策略类型 | 定位 | 定价逻辑 | 适用场景 |
|---|---|---|---|
| 引流款 | 低价引流 | 成本价 + 微利（10%-20%） | 新店开业、淡季促销 |
| 利润款 | 常规销售 | 成本价 + 标准利润（40%-60%） | 日常经营 |
| 高端款 | 高端定位 | 市场高价位 或 成本 + 高利润 | 高端客群、稀缺项目 |
2.3.3.3 AI 定价建议（集成瑞小美 AI）
- 调用
shared_backend.AIService生成智能建议 - AI 分析维度：
- 成本合理性评估
- 市场竞争力分析
- 利润空间判断
- 风险提示
- 输出结构化定价建议报告
2.4 模块四：利润模拟测算
2.4.1 功能描述
输入预估客量，模拟收入与利润，进行敏感性分析，评估价格变动对利润的影响。
2.4.2 功能清单
| 功能点 | 优先级 | 描述 |
|---|---|---|
| 收入利润模拟 | P0 | 输入客量，计算预估收入/利润 |
| 敏感性分析 | P0 | 价格变动对利润的影响分析 |
| 盈亏平衡点 | P0 | 计算盈亏平衡所需客量 |
| 场景对比 | P1 | 多场景利润对比 |
| 可视化图表 | P1 | 利润曲线、敏感性图表 |
2.4.3 详细需求
2.4.3.1 收入利润模拟
输入：
- 定价方案（可选择不同策略）
- 预估客量（日/周/月）
输出：
- 预估收入 = 单价 × 客量
- 预估毛利 = 收入 - 成本 × 客量
- 毛利率 = 毛利 / 收入
2.4.3.2 敏感性分析
分析价格变动对利润的影响：
- 价格 ±5%、±10%、±15%、±20% 时的利润变化
- 生成敏感性分析表格
- 可视化利润变化曲线
2.4.3.3 盈亏平衡分析
盈亏平衡客量 = 固定成本 / (单价 - 单位变动成本)
输出：
- 盈亏平衡点客量
- 当前预估客量下的安全边际
- 达到目标利润所需客量
3. 非功能需求
3.1 性能要求
| 指标 | 要求 |
|---|---|
| 页面加载时间 | < 2 秒 |
| AI 响应时间 | < 10 秒（流式输出） |
| 并发支持 | 100+ 用户同时在线 |
| 数据计算 | 成本/利润计算 < 500ms |
3.2 安全要求
- 用户身份认证（OAuth）
- 敏感数据加密存储
- 操作日志记录
- API Key 从门户系统统一获取（禁止硬编码）
3.3 兼容性要求
- 浏览器：Chrome、Edge、Firefox、Safari 最新版本
- 屏幕：适配 1280px 及以上宽度
- 移动端：响应式布局（P1）
4. AI 能力集成
4.1 集成规范（强制）
遵循《瑞小美 AI 接入规范》：
| 规范 | 要求 | 说明 |
|---|---|---|
| 统一服务 | 通过 shared_backend.AIService 调用 |
❌ 禁止直接请求 API |
| 服务商降级 | 4sapi.com → OpenRouter.ai | 自动降级 |
| Key 管理 | 从门户系统获取 | ❌ 禁止硬编码 |
| db_session | 必须传入 | 用于记录调用日志 |
| prompt_name | 必须传入 | 用于调用统计 |
正确调用示例：
from shared_backend.services.ai_service import AIService
# ✅ 正确：传入 module_code、db_session、prompt_name
ai = AIService(module_code="pricing_model", db_session=db)
response = await ai.chat(
messages=[...],
prompt_name="pricing_advice" # 必填！
)
错误示例：
# ❌ 错误：缺少 db_session，无法记录日志
ai = AIService(module_code="pricing_model")
# ❌ 错误：缺少 prompt_name，无法统计
response = await ai.chat(messages=[...])
4.2 AI 应用场景
| 场景 | 功能 | 调用方式 | prompt_name |
|---|---|---|---|
| 定价建议生成 | 综合分析生成定价建议 | ai.chat() |
pricing_advice |
| 市场分析报告 | 分析市场数据生成报告 | ai.chat() |
market_analysis |
| 利润预测分析 | 分析利润趋势与风险 | ai.chat() |
profit_forecast |
4.3 提示词文件规范（强制）
文件位置：{模块}/后端服务/prompts/{功能名}_prompts.py
智能项目定价模型/
└── 后端服务/
└── prompts/
├── pricing_advice_prompts.py # 定价建议
├── market_analysis_prompts.py # 市场分析
└── profit_forecast_prompts.py # 利润预测
文件结构要求（必须包含）：
"""功能描述"""
# 必须包含 PROMPT_META
PROMPT_META = {
"name": "pricing_advice", # 唯一标识（必填）
"display_name": "智能定价建议", # 后台显示名称（必填）
"description": "综合分析生成定价建议", # 功能描述（必填）
"module": "pricing_model", # 所属模块（必填）
"variables": ["project_name", "cost_data", "market_data"], # 变量列表（必填）
}
# 必须包含 SYSTEM_PROMPT
SYSTEM_PROMPT = """你是专业的医美行业定价分析师..."""
# 必须包含 USER_PROMPT
USER_PROMPT = """请为以下项目生成定价建议：
项目名称：{project_name}
成本数据：{cost_data}
市场行情：{market_data}
"""
提示词元数据会自动注册到数据库，可在后台查看和管理
5. 数据字典（概要）
5.1 核心实体
| 实体 | 说明 |
|---|---|
| Project | 服务项目 |
| Material | 耗材 |
| Equipment | 设备 |
| StaffLevel | 人员级别 |
| FixedCost | 固定成本 |
| Competitor | 竞品机构 |
| CompetitorPrice | 竞品价格 |
| PricingPlan | 定价方案 |
| ProfitSimulation | 利润模拟 |
详细数据库设计见《数据库设计文档》
6. 交互原型（待设计）
6.1 核心页面
- 仪表盘：关键指标概览
- 成本核算：成本录入与计算
- 市场行情：竞品价格管理与分析
- 智能定价：定价建议与策略模拟
- 利润模拟：收入利润测算
- 数据管理：基础数据维护
6.2 交互流程
┌─────────────────────────────────────────┐
│ 仪表盘 │
│ - 项目成本概览 │
│ - 市场价格趋势 │
│ - 利润预估 │
└─────────────────────────────────────────┘
│
┌─────────────────────────────┼─────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ 成本核算 │ │ 市场行情 │ │ 智能定价 │
│ │ │ │ │ │
│ → 耗材成本 │ │ → 竞品管理 │ │ → 定价建议 │
│ → 人工成本 │ │ → 价格录入 │ │ → 策略模拟 │
│ → 固定分摊 │ │ → 市场分析 │ │ → 报告导出 │
│ │ │ │ │ │
│ ↓ 输出 │ │ ↓ 输出 │ │ ↓ 输出 │
│ 最低成本线 │─────┬─────│ 市场定价区间 │─────┬─────│ 定价方案 │
└───────────────┘ │ └───────────────┘ │ └───────────────┘
│ │ │
└─────────────┬─────────────┘ │
│ │
▼ ▼
┌───────────────────────────────────────┐
│ 利润模拟 │
│ - 收入/利润测算 │
│ - 敏感性分析 │
│ - 盈亏平衡点 │
└───────────────────────────────────────┘
7. 验收标准
7.1 功能验收
- 成本核算：能正确计算项目最低成本线
- 市场行情：能录入并分析市场价格数据
- 智能定价：能生成合理的定价建议
- 利润模拟：能准确计算利润和盈亏平衡点
7.2 性能验收
- 页面加载时间 < 2 秒
- AI 响应有流式输出反馈
- 支持 100+ 并发用户
7.3 安全验收
- 无 API Key 硬编码
- 敏感数据加密存储
- 操作日志完整记录
8. 附录
8.1 术语表
| 术语 | 说明 |
|---|---|
| 最低成本线 | 项目所有成本之和，是定价的最低边界 |
| 毛利率 | (售价 - 成本) / 售价 × 100% |
| 盈亏平衡点 | 收入等于总成本时的销量 |
| 敏感性分析 | 分析某变量变化对结果的影响程度 |
8.2 参考文档
- 《瑞小美 AI 接入规范》
- 《瑞小美系统技术栈标准与字符标准》
瑞小美技术团队 · 2026-01-19