# 珠宝商城微信小程序需求分析整理
本珠宝商城微信小程序以「空托之城」为参考原型，聚焦单门店珠宝经营场景，核心实现商城基础功能、钻戒计算器、版房展示等核心能力，**不接入线上支付、物流位置API**，交易与物流均通过线下/微信沟通完成，同时配套管理后台实现商品、库存、订单的全流程管理，以下是分模块的详细需求整理：

## 一、核心开发基础信息
1. **开发平台**：微信小程序
2. **参考原型**：空托之城小程序
3. **核心限制**：不接入线上支付功能、不对接物流位置API，物流信息仅手动录入展示
4. **核心特色功能**：钻戒计算器、版房专区、精细化珠宝商品规格管理、线下交易配套订单体系

## 二、商城基础功能
### 1. 前端核心页面能力
- 支持**商品列表、分类、详情页**展示，支持商品规格选择、添加购物车操作；
- 商品详情页顶部banner支持**多图+视频**配置，基础信息下方固定展示**商城统一发货公告**（含交易方式、客服微信、公司地址等）；
- 因珠宝商品特殊性，小程序内仅展示价格，无线上支付入口，交易通过微信/线下转账完成。

### 2. 库存管理（管理后台）
- 配置商品时需填写**库存数量**，当库存低于10%时，管理后台首页展示**库存即将售罄商品**；
- 售罄商品按**库存数量从少到多**排序，点击可直接进入对应商品配置页面。

## 三、商品规格管理
珠宝商品规格属性精细化，分为**固定展示的基础属性**和**可选择的详细参数**，且支持规格数据的表格导入导出，是核心特色之一。
### 1. 基础属性（商品详情页直接展示，不可选）
商品名称、基础价格、款号、库存、损耗、工费。

### 2. 详细参数（点击「查看详细参数」弹出，支持多选，不同分类可配置不同选项）
成色、主石、手寸。

### 3. 规格选后展示数据列表（根据所选参数生成，含精准核算数据）
商品型号名称、成色、主石、手寸、金料总重、金料净重、损耗、金耗、金价、金值、主石数量/石重/单价/金额、副石数量/石重/单价/金额、配件金额、加工工费、镶石工费、总工费、总价。

## 四、钻戒计算器
独立功能模块，支持珠宝金工石费用的精准核算，内置固定计算公式，各维度可单独计算，核心公式如下：
1. 净金重(g) = 金重(g) - 主石重(ct)×0.2 - 副石重(ct)×0.2
2. 含耗重(g) = 净金重(g) × 损耗
3. 金值(元) = 含耗重(g) × 倒模金价(元)
4. 主石总价(元) = 主石重(ct) × 主石单价(元)
5. 副石总价(元) = 副石重(ct) × 副石单价(元)
6. 微镶总价(元) = 副石粒数(p) × 微镶费(元)
7. **总价** = 金值 + 主石总价 + 副石总价 + 主石镶费 + 微镶总价 + 3D起板费 + 基本工费 + 其他费用

## 五、购物车&订单全流程管理
### 1. 购物车
- 展示添加的商品列表，支持勾选商品，实时展示**勾选商品总金额**；
- 点击「下单」按钮，跳转至订单提交页。

### 2. 订单提交
- 页面展示**公司地址/物流信息、用户填写发货信息区、发货时间提醒、下单商品列表、贵重物品不退换提醒**；
- 贵重物品提醒需**用户手动勾选**，勾选前「提交订单」按钮灰色不可点，勾选后点亮可点击；
- 点击「提交订单」，直接跳转至订单详情页，同时管理后台生成对应订单信息。

### 3. 订单详情（前端+后台）
#### 前端展示能力
- 核心展示：订单商品列表、订单号、总价、订单状态（待支付/已支付/已发货）；
- 配套展示：下单成功提示、用户物流信息、客服微信号、购买提示；**支付后新增支付时间，发货后新增物流公司/单号**（纯展示，无API对接）；
- 底部功能按钮：「取消订单」「添加客服好友」（弹出二维码）「联系客服」（拉起小程序自带客服）；
- 用户可在「我的-订单详情」查看所有订单，点击进入对应详情页。

#### 管理后台能力
- 支持**手动创建订单**：需关联用户ID，选择商品/型号信息，创建后用户订单列表自动更新；
- 支持**修改订单信息**：修改商品/型号后，前后端价格自动同步更新；
- 订单状态更新：工作人员根据线下操作，手动将订单改为「已支付/已发货」，并上传对应凭证/信息。

### 4. 支付与发货（线下操作+后台录入）
#### 支付流程
用户通过微信/在线客服完成转账后，工作人员在管理后台找到对应订单，将状态改为**已支付**，并**上传支付凭证（图片）、填写支付时间**。

#### 发货流程
商品线下发货后，工作人员在管理后台将订单状态改为**已发货**，并**填写物流公司名、物流单号**（仅前端展示，无物流追踪）。

## 六、版房专区
1. 独立的版房页面，支持管理后台**配置版房信息**，核心为名称、展示图片（每条信息可配置多张图）；
2. 页面含搜索框，支持按产品名称、款号、条码号或款式搜索，无额外操作功能，仅作展示，定制需求需联系客服。

## 七、「我的」页面
参考原型页面，剔除「价格计算器」「推荐平台给好友」功能，保留核心功能入口：
微信用户信息、我的订单、收货地址、联系客服、关于我们、用户协议、隐私政策。

## 八、在线客服功能
1. 小程序内多场景配置客服入口：商品详情页、购物车、订单详情页、我的页面等；
2. 订单详情页支持**两种客服对接方式**：添加客服好友（弹出二维码）、联系客服（拉起小程序自带客服）；
3. 为核心交易配套能力，所有定制、交易、售后问题均通过客服线下沟通完成。

## 九、管理后台核心能力汇总
1. 商品管理：商品配置（含库存、规格、banner）、库存警告展示、商品/规格数据表格导入导出；
2. 订单管理：手动创建/修改订单、订单状态更新（待支付→已支付→已发货）、支付/发货凭证/信息录入；
3. 版房管理：版房信息（名称、图片）的配置与展示；
4. 数据同步：后台操作（创建/修改订单、更新状态）后，前端用户页面自动同步更新。