Initial commit: 智能项目定价模型

docs/用户操作手册.md

@@ -0,0 +1,488 @@
+# 智能项目定价模型 - 用户操作手册
+
+> **版本**：v1.0  
+> **更新日期**：2026-01-20  
+> **适用对象**：运营总监、财务人员、市场人员、店长
+
+---
+
+## 目录
+
+1. [系统概述](#1-系统概述)
+2. [登录与导航](#2-登录与导航)
+3. [基础数据管理](#3-基础数据管理)
+4. [成本核算](#4-成本核算)
+5. [市场行情](#5-市场行情)
+6. [智能定价](#6-智能定价)
+7. [利润模拟](#7-利润模拟)
+8. [仪表盘](#8-仪表盘)
+9. [常见问题](#9-常见问题)
+
+---
+
+## 1. 系统概述
+
+### 1.1 系统功能
+
+智能项目定价模型是一套帮助医美机构科学定价的智能系统，主要功能包括：
+
+| 功能模块 | 描述 | 主要用户 |
+|----------|------|----------|
+| **成本核算** | 精准计算项目成本，明确最低成本线 | 财务人员 |
+| **市场行情** | 收集竞品价格，分析市场定价区间 | 市场人员 |
+| **智能定价** | AI 智能分析，生成定价建议 | 运营总监 |
+| **利润模拟** | 模拟不同定价的利润情况 | 运营总监、店长 |
+
+### 1.2 浏览器要求
+
+- Chrome 90+（推荐）
+- Firefox 88+
+- Edge 90+
+- Safari 14+
+
+建议使用 1280px 及以上宽度的屏幕。
+
+---
+
+## 2. 登录与导航
+
+### 2.1 系统登录
+
+1. 打开浏览器，访问系统地址
+2. 使用瑞小美 SCRM 账号登录
+3. 登录成功后进入系统首页（仪表盘）
+
+### 2.2 主导航菜单
+
+| 菜单 | 功能 |
+|------|------|
+| 仪表盘 | 系统概览、关键指标展示 |
+| 成本核算 → 服务项目 | 项目成本明细管理 |
+| 市场行情 → 竞品管理 | 竞品机构与价格管理 |
+| 市场行情 → 标杆价格 | 标杆机构价格参考 |
+| 市场行情 → 市场分析 | 市场价格分析 |
+| 智能定价 | AI 定价建议与方案管理 |
+| 利润模拟 | 利润测算与敏感性分析 |
+| 基础设置 | 分类、耗材、设备等基础数据 |
+
+---
+
+## 3. 基础数据管理
+
+基础数据是系统运行的基础，请在使用核心功能前先维护好基础数据。
+
+### 3.1 项目分类管理
+
+**路径**：基础设置 → 项目分类
+
+用于对服务项目进行分类，如：皮肤管理、注射类、光电类、手术类。
+
+**操作步骤**：
+
+1. 点击「新增分类」按钮
+2. 填写分类名称
+3. 选择父分类（可选，用于创建子分类）
+4. 设置排序号
+5. 点击「确定」保存
+
+### 3.2 耗材管理
+
+**路径**：基础设置 → 耗材管理
+
+维护项目所需的耗材信息。
+
+**操作步骤**：
+
+1. 点击「新增耗材」
+2. 填写信息：
+   - **耗材编码**：唯一标识，如 MAT001
+   - **耗材名称**：如"冷凝胶"
+   - **单位**：如"ml"、"支"、"个"
+   - **单价**：单位采购价格
+   - **类型**：耗材/针剂/产品
+   - **供应商**：供应商名称（可选）
+3. 点击「确定」保存
+
+**批量导入**：
+
+1. 点击「导入」按钮
+2. 下载 Excel 模板
+3. 按模板格式填写数据
+4. 上传文件完成导入
+
+### 3.3 设备管理
+
+**路径**：基础设置 → 设备管理
+
+维护设备信息及折旧计算。
+
+**关键字段**：
+
+| 字段 | 说明 |
+|------|------|
+| 设备原值 | 购买价格 |
+| 残值率 | 设备报废时的残余价值比例，默认 5% |
+| 预计使用年限 | 设备使用寿命 |
+| 预计使用次数 | 整个生命周期的使用次数 |
+| 单次折旧成本 | 自动计算：(原值 - 残值) / 总次数 |
+
+### 3.4 人员级别
+
+**路径**：基础设置 → 人员级别
+
+配置不同岗位的时薪标准。
+
+| 级别 | 示例时薪 |
+|------|----------|
+| 初级美容师 | 30 元/小时 |
+| 中级美容师 | 50 元/小时 |
+| 高级美容师 | 80 元/小时 |
+| 主治医师 | 200 元/小时 |
+
+### 3.5 固定成本
+
+**路径**：基础设置 → 固定成本
+
+录入每月固定成本，用于分摊到项目成本中。
+
+**成本类型**：
+
+- 房租
+- 水电费
+- 物业费
+- 其他
+
+**分摊方式**：
+
+| 方式 | 说明 |
+|------|------|
+| 按项目数量 | 固定成本平均分摊到每个项目 |
+| 按营收占比 | 根据项目营收比例分摊 |
+| 按时长占比 | 根据项目操作时长比例分摊 |
+
+---
+
+## 4. 成本核算
+
+### 4.1 创建服务项目
+
+**路径**：成本核算 → 服务项目 → 新增项目
+
+1. 点击「新增项目」
+2. 填写基本信息：
+   - **项目编码**：唯一标识
+   - **项目名称**：如"光子嫩肤"
+   - **所属分类**：选择分类
+   - **操作时长**：单次服务时长（分钟）
+   - **项目描述**：可选
+3. 点击「确定」创建
+
+### 4.2 配置成本明细
+
+创建项目后，需要配置具体的成本构成。
+
+**添加耗材成本**：
+
+1. 在项目列表点击「成本明细」
+2. 切换到「耗材成本」标签
+3. 点击「添加耗材」
+4. 选择耗材，填写用量
+5. 系统自动计算：总成本 = 单价 × 用量
+
+**添加设备折旧**：
+
+1. 切换到「设备折旧」标签
+2. 点击「添加设备」
+3. 选择设备，填写使用次数（通常为 1）
+4. 系统自动使用设备的单次折旧成本
+
+**配置人工成本**：
+
+1. 切换到「人工成本」标签
+2. 点击「添加人工」
+3. 选择人员级别
+4. 填写操作时长（分钟）
+5. 系统自动计算：人工成本 = 时长 × 时薪
+
+### 4.3 计算成本汇总
+
+配置完所有成本项后：
+
+1. 点击「计算成本」按钮
+2. 选择固定成本分摊方式
+3. 系统计算并显示成本汇总：
+   - 耗材成本
+   - 设备折旧成本
+   - 人工成本
+   - 固定成本分摊
+   - **最低成本线**（总成本）
+
+> **提示**：最低成本线是项目定价的下限，低于此价格销售将亏损。
+
+### 4.4 成本分析
+
+成本汇总页面提供：
+
+- **成本构成饼图**：直观展示各类成本占比
+- **成本明细表**：详细的成本项列表
+- **成本建议**：针对成本结构的优化建议
+
+---
+
+## 5. 市场行情
+
+### 5.1 竞品机构管理
+
+**路径**：市场行情 → 竞品管理
+
+**添加竞品机构**：
+
+1. 点击「新增竞品」
+2. 填写信息：
+   - **机构名称**：竞品机构名称
+   - **地址**：机构地址
+   - **距离**：与本店距离（公里）
+   - **定位**：高端/中端/大众
+   - **是否重点关注**：标记重点竞品
+3. 点击「确定」保存
+
+### 5.2 竞品价格录入
+
+**录入价格**：
+
+1. 在竞品列表点击「价格管理」
+2. 点击「添加价格」
+3. 填写信息：
+   - **项目名称**：竞品的项目名称
+   - **关联本店项目**：可选，便于对比
+   - **原价**：标价
+   - **促销价**：活动价格（可选）
+   - **会员价**：会员价格（可选）
+   - **价格来源**：官网/美团/大众点评/实地调研
+   - **采集日期**：价格获取日期
+4. 点击「确定」保存
+
+> **建议**：定期更新竞品价格，保持数据时效性。
+
+### 5.3 标杆价格
+
+**路径**：市场行情 → 标杆价格
+
+维护行业标杆机构的价格参考。
+
+**添加标杆价格**：
+
+1. 点击「新增标杆」
+2. 填写标杆机构名称
+3. 选择项目分类
+4. 填写价格区间（最低价、最高价、均价）
+5. 选择价格档位（低端/中端/高端/奢华）
+6. 设置生效日期
+
+### 5.4 市场分析
+
+**路径**：市场行情 → 市场分析
+
+**执行分析**：
+
+1. 选择要分析的项目
+2. 选择参与分析的竞品（可多选）
+3. 点击「执行分析」
+4. 查看分析结果：
+   - **价格统计**：最低价、最高价、均价、中位价
+   - **价格分布**：低/中/高价位占比
+   - **建议区间**：市场定价参考区间
+   - **竞品对比**：各竞品价格详情
+
+---
+
+## 6. 智能定价
+
+### 6.1 创建定价方案
+
+**路径**：智能定价
+
+**操作步骤**：
+
+1. 点击「新建方案」
+2. 选择项目
+3. 填写方案名称（如"2026年Q1定价方案"）
+4. 选择定价策略：
+   - **引流款**：低价吸引新客，利润率 10%-20%
+   - **利润款**：日常定价，利润率 40%-60%
+   - **高端款**：高端定位，利润率 60%+
+5. 设置目标毛利率
+
+### 6.2 获取 AI 定价建议
+
+1. 在定价方案中点击「AI 建议」
+2. 系统自动整合：
+   - 项目成本数据
+   - 市场行情数据
+   - 目标利润率
+3. AI 分析并生成建议，包括：
+   - **建议价格区间**
+   - **推荐定价及理由**
+   - **不同策略的建议价格**
+   - **风险提示**
+   - **优化建议**
+
+### 6.3 策略模拟
+
+对比不同定价策略的效果：
+
+| 策略 | 定价逻辑 | 适用场景 |
+|------|----------|----------|
+| 引流款 | 成本 + 10%-20% 利润 | 新店开业、淡季促销 |
+| 利润款 | 成本 + 40%-60% 利润 | 日常经营 |
+| 高端款 | 市场高位或成本 + 高利润 | 高端客群、稀缺项目 |
+
+### 6.4 确定最终定价
+
+1. 参考 AI 建议和策略模拟结果
+2. 填写最终定价
+3. 保存方案
+4. 可导出定价报告（PDF/Excel）
+
+---
+
+## 7. 利润模拟
+
+### 7.1 创建利润模拟
+
+**路径**：利润模拟
+
+**操作步骤**：
+
+1. 选择定价方案
+2. 点击「新建模拟」
+3. 填写模拟参数：
+   - **模拟名称**：如"乐观预期"
+   - **模拟价格**：可使用方案价格或自定义
+   - **预估客量**：预期服务人数
+   - **周期类型**：日/周/月
+4. 点击「计算」
+
+### 7.2 查看模拟结果
+
+| 指标 | 说明 |
+|------|------|
+| 预估收入 | 价格 × 客量 |
+| 预估成本 | 单位成本 × 客量 |
+| 预估利润 | 收入 - 成本 |
+| 利润率 | 利润 / 收入 × 100% |
+| 盈亏平衡客量 | 达到盈亏平衡需要的最小客量 |
+| 安全边际 | 当前客量超出盈亏平衡点的数量 |
+
+### 7.3 敏感性分析
+
+分析价格变动对利润的影响：
+
+1. 点击「敏感性分析」
+2. 系统自动计算价格 ±5%、±10%、±15%、±20% 时的利润变化
+3. 查看分析结果：
+   - **敏感性表格**：不同价格下的利润
+   - **利润曲线图**：可视化价格-利润关系
+   - **风险评估**：价格弹性分析
+
+### 7.4 多场景对比
+
+创建多个模拟方案进行对比：
+
+- **乐观预期**：客量较高
+- **正常预期**：客量适中
+- **保守预期**：客量较低
+
+通过对比帮助制定更稳健的定价决策。
+
+---
+
+## 8. 仪表盘
+
+**路径**：仪表盘（首页）
+
+### 8.1 概览数据
+
+| 指标 | 说明 |
+|------|------|
+| 项目总数 | 系统管理的服务项目数量 |
+| 已定价项目 | 已创建定价方案的项目数 |
+| 平均成本 | 所有项目的平均成本 |
+| 跟踪竞品数 | 监控的竞品机构数量 |
+
+### 8.2 成本趋势
+
+展示项目成本的变化趋势，帮助发现成本波动。
+
+### 8.3 市场趋势
+
+展示市场价格的变化趋势，了解行业动态。
+
+### 8.4 最近活动
+
+显示系统最近的操作记录，如定价方案创建、成本更新等。
+
+---
+
+## 9. 常见问题
+
+### Q1: 成本计算结果与预期不符？
+
+**可能原因**：
+- 耗材用量填写错误
+- 设备折旧参数不准确
+- 人员时薪未及时更新
+- 固定成本数据过期
+
+**解决方法**：
+1. 检查各项成本明细数据
+2. 确认基础数据是否最新
+3. 重新计算成本汇总
+
+### Q2: AI 定价建议响应慢？
+
+**说明**：AI 分析需要综合大量数据，通常需要 5-10 秒。
+
+**建议**：
+- 耐心等待，系统会显示加载状态
+- 如超过 30 秒无响应，刷新页面重试
+
+### Q3: 如何导出定价报告？
+
+1. 进入定价方案详情页
+2. 点击右上角「导出」按钮
+3. 选择格式（PDF 或 Excel）
+4. 下载保存
+
+### Q4: 竞品价格数据从哪里获取？
+
+建议来源：
+- 竞品官网
+- 美团/大众点评等平台
+- 实地调研
+- 行业报告
+
+录入时请标注价格来源，便于评估数据可靠性。
+
+### Q5: 固定成本分摊方式如何选择？
+
+| 方式 | 适用场景 |
+|------|----------|
+| 按项目数量 | 项目差异小，适合均摊 |
+| 按营收占比 | 高价值项目承担更多成本 |
+| 按时长占比 | 长时间项目承担更多成本 |
+
+建议根据机构实际情况选择，或咨询财务人员。
+
+---
+
+## 技术支持
+
+如遇问题，请联系：
+
+- **系统管理员**：[联系方式]
+- **技术支持**：瑞小美技术团队
+
+---
+
+*瑞小美技术团队 · 2026-01-20*