458 lines
15 KiB
Markdown
458 lines
15 KiB
Markdown
# 智能项目定价模型 - 产品需求文档（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** | **必须传入** | 用于调用统计 |
|
||
|
||
**正确调用示例**：
|
||
```python
|
||
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" # 必填！
|
||
)
|
||
```
|
||
|
||
**错误示例**：
|
||
```python
|
||
# ❌ 错误：缺少 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 # 利润预测
|
||
```
|
||
|
||
**文件结构要求（必须包含）**：
|
||
|
||
```python
|
||
"""功能描述"""
|
||
|
||
# 必须包含 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 核心页面
|
||
|
||
1. **仪表盘**：关键指标概览
|
||
2. **成本核算**：成本录入与计算
|
||
3. **市场行情**：竞品价格管理与分析
|
||
4. **智能定价**：定价建议与策略模拟
|
||
5. **利润模拟**：收入利润测算
|
||
6. **数据管理**：基础数据维护
|
||
|
||
### 6.2 交互流程
|
||
|
||
```
|
||
┌─────────────────────────────────────────┐
|
||
│ 仪表盘 │
|
||
│ - 项目成本概览 │
|
||
│ - 市场价格趋势 │
|
||
│ - 利润预估 │
|
||
└─────────────────────────────────────────┘
|
||
│
|
||
┌─────────────────────────────┼─────────────────────────────┐
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
|
||
│ 成本核算 │ │ 市场行情 │ │ 智能定价 │
|
||
│ │ │ │ │ │
|
||
│ → 耗材成本 │ │ → 竞品管理 │ │ → 定价建议 │
|
||
│ → 人工成本 │ │ → 价格录入 │ │ → 策略模拟 │
|
||
│ → 固定分摊 │ │ → 市场分析 │ │ → 报告导出 │
|
||
│ │ │ │ │ │
|
||
│ ↓ 输出 │ │ ↓ 输出 │ │ ↓ 输出 │
|
||
│ 最低成本线 │─────┬─────│ 市场定价区间 │─────┬─────│ 定价方案 │
|
||
└───────────────┘ │ └───────────────┘ │ └───────────────┘
|
||
│ │ │
|
||
└─────────────┬─────────────┘ │
|
||
│ │
|
||
▼ ▼
|
||
┌───────────────────────────────────────┐
|
||
│ 利润模拟 │
|
||
│ - 收入/利润测算 │
|
||
│ - 敏感性分析 │
|
||
│ - 盈亏平衡点 │
|
||
└───────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 7. 验收标准
|
||
|
||
### 7.1 功能验收
|
||
|
||
- [ ] 成本核算：能正确计算项目最低成本线
|
||
- [ ] 市场行情：能录入并分析市场价格数据
|
||
- [ ] 智能定价：能生成合理的定价建议
|
||
- [ ] 利润模拟：能准确计算利润和盈亏平衡点
|
||
|
||
### 7.2 性能验收
|
||
|
||
- [ ] 页面加载时间 < 2 秒
|
||
- [ ] AI 响应有流式输出反馈
|
||
- [ ] 支持 100+ 并发用户
|
||
|
||
### 7.3 安全验收
|
||
|
||
- [ ] 无 API Key 硬编码
|
||
- [ ] 敏感数据加密存储
|
||
- [ ] 操作日志完整记录
|
||
|
||
---
|
||
|
||
## 8. 附录
|
||
|
||
### 8.1 术语表
|
||
|
||
| 术语 | 说明 |
|
||
|------|------|
|
||
| 最低成本线 | 项目所有成本之和，是定价的最低边界 |
|
||
| 毛利率 | (售价 - 成本) / 售价 × 100% |
|
||
| 盈亏平衡点 | 收入等于总成本时的销量 |
|
||
| 敏感性分析 | 分析某变量变化对结果的影响程度 |
|
||
|
||
### 8.2 参考文档
|
||
|
||
- 《瑞小美 AI 接入规范》
|
||
- 《瑞小美系统技术栈标准与字符标准》
|
||
|
||
---
|
||
|
||
*瑞小美技术团队 · 2026-01-19*
|