# 智能项目定价模型 - 产品需求文档（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*