让每件装备
都有自己的表达。

01 / 两个 Logo 的用途

三角主 Logo 用于品牌入口、后台等正式场景；W 小人用于会员、客服等年轻化互动场景。素材由你提供的 AI 原稿导出，未重新绘制。帽子的主图案由商家在后台选择；顾客为额外位置添加图案时可以选择三角主 Logo 或 W 小人。

02 / 去哪里开启、关闭和设置价格

打开后台 → 定制管理 → 商品使用，这里列出全部鱼竿、帽子和眼镜，包括尚未填写工艺的正式商品。模板制作是独立环节，在“模板制作”页先选择品类。页首分别统计每类的商品数、SKU数、已关联数、已启用数及隐藏入口数；体验商品另有标识。

关联工艺后可以先保存草稿。勾选“在商品前台显示定制入口”和“工艺未开放时显示准备中”，顾客会看到“定制方案准备中”，不会获得定制报价。待真实参数和价格填完，再开启总开关。隐藏入口或积分条件仍优先生效；空白加价不等于免费。

1. 打开本地管理后台 → 商品管理。新商品先保存名称、图片和SKU规格。
2. 点击该商品右侧定制设置，选择帽子、鱼竿或眼镜。
3. 勾选开放此商品定制（总开关），再分别勾选所需功能。总开关关闭时，顾客只能购买标准款；单项关闭只影响该项。
4. 填写各功能加价，单位为元，最多两位小数。免费项目填0；正式商品草稿不预填工艺加价。
5. 在商家颜色库填写工艺色号、名称和屏幕示意色，可上传JPG/PNG/WebP实拍色卡，每张不超过8MB。每种颜色可单独停用，最多40色。
6. 点击保存定制设置。刷新商城商品页，检查选项、加价与顺序。

色库按商品保存。工艺色号必须能让仓库/加工方唯一识别材料或工艺；屏幕色只是选色辅助。商品关闭定制、颜色停用或配置变化后，尚未提交的旧购物袋会要求重新选择，不能绕过后台开关。

03 / 入口显示、积分资格与专属邀请

在后台 → 商品管理 → 对应商品 → 定制资格 / 邀请设置。每个商品独立配置，帽子、鱼竿和眼镜均适用。

例如门槛100：99分看不到按钮，100分可以看到。开启积分条件且门槛为0时，仍要求登录。门槛暂不限制具体定制功能，而是控制该商品整体入口。未开启积分条件时，普通入口也可对游客展示，结算仍须登录。保存后刷新商品页面可见；服务器在提交订单时重新校验，旧页面和旧购物袋无法绕过关闭或积分下降。已经提交成功的订单保留原方案。

给个别会员发送一次性链接

1. 请该顾客先在商城登录，取得“我的”页面中的完整会员编号。后台按会员编号或昵称查找，核对完整编号。
2. 确认商品在售、定制总开关开启。在同一页面选择指定会员、有效期（1/3/7/14/30天）。
3. 点击生成指定会员的一次性链接，复制后由你单独发送。程序不会自动发微信或短信。
4. 顾客打开链接并登录，服务器核对会员与商品。即使商城入口隐藏或积分不足，该会员也可以定制；转给其他账号无效。
5. 成功提交一笔含该商品的定制订单后，邀请立即失效，含配镜待核对单。浏览、选色、加入购物袋不消耗；库存不足或提交失败不消耗。一次指一笔订单，该笔可包含同商品的多个SKU/件数，仍受库存限制。
6. 后台记录“已使用”及关联订单号。取消、超时关闭、退款均不恢复邀请；确需重做时核对原因后重新发一条。未使用的邀请可撤销。

邀请与普通资格互相独立：获得邀请不会改变会员积分，也不会让该会员在普通商品页永久获得资格。若顾客本身符合普通入口条件，仍可从普通入口按正常规则下单；一次性限制只适用于使用该条邀请的订单。

本地链接与真实微信链接

按微信官方 URL Link 文档（2026-10-16核对），此接口由服务器调用、当前最长30天、目标需为已发布页面；官方链接支持多人访问。因此本系统另以会员绑定、到期/撤销检查及订单事务核销实现专属一次性权限，不依赖微信链接自身限制次数。真实生成、微信内外跳转、iOS/Android和登录返回仍须使用你们实际账号联调。

后台权限与升级

所有者和运营可以调整规则、生成/复制/撤销邀请；客服和审计员不具备这些操作权限。查询链接和使用都会留审计记录，日志不保存邀请原始令牌。数据库升级到版本4，保留原商品与订单；原商品默认沿用公开入口、不加积分门槛，不会自动替你决定正式门槛。升级前按部署手册备份数据库、图片与加密密钥，密钥丢失会影响邀请链接和历史订单解密。

04 / 帽子定制

单件加价 = 主尺寸功能费 + 所选尺寸费 + 主颜色功能费 + 每个额外Logo的功能费及位置费。未开启的项目和未添加的额外Logo不收费。当前是方案选择与确认，不提供帽子实物图上的精准印花合成；要做实物合成还需每个款式的定位模板。

05 / 鱼竿定制

1. 进入后台定制管理，新建可复用模板，或选择实际商品单独配置。
2. 选择开放自选节位或整竿配色，填写总节数（1–30 节），勾选允许定制的节位。编号从手柄端第 1 节向竿梢递增。
3. 按定制节数填写总加价，整竿配色使用对应总节数的同一档价格，不重复填写。每档为总额，不累加；免费填 0，必要价格留空不能启用。
4. 顾客从开放节位中多选并逐节选色；整竿模式必须完成全部节位。更换 SKU 或模式会清空原选择。
5. 保存后验收前台。模板可批量应用到同类SKU，各SKU后续独立管理。

旧配置在重新保存前保持原计价。编辑时，同节数已有价格优先保留，缺失时才带入原整竿价。请核对后保存。历史订单保留原价，旧购物袋遇到规则变化须重新确认。

06 / 眼镜定制与支付前核对

四个功能分别开关：近视球镜SPH、散光柱镜CYL、瞳距PD、外层镀膜颜色。左右眼分别填写；柱镜非零时须填轴位0–180°，柱镜为零时不收集该眼轴位。瞳距支持总瞳距，或左右单眼瞳距。

当前表单使用D为单位、负柱镜格式，SPH/CYL步长0.25D，PD步长0.5mm。后台的范围是商家接单条件，须按加工能力核实；程序不自动换算验光处方。信息不适用时由客服与顾客核对后重新填写。

1. 顾客选择配置并确认验光信息用途，提交配镜核对单。此时不能支付，库存保留24小时。
2. 客服、运营或所有者进入订单与售后 → 查看，联系顾客核对左右眼、轴位、瞳距和实际加工能力。
3. 核对一致后点击已核对验光数据，开放付款。系统记录操作者，订单进入待支付，付款期限15分钟。
4. 顾客刷新订单后付款，之后才进入ERP推单流程。超时未核对或未付款时释放库存；顾客也可取消。

仅选镀膜颜色时不进入验光核对。若购物袋同时包含配镜商品和其他商品，整单等待核对；需要先买其他商品时分开下单。当前不直接修改已提交方案：有误时取消核对单，由顾客重新选择，保留原记录。核对通知由客服接待完成，尚未配置微信订阅消息自动提醒。

定制模板制作与商品使用

1. 打开定制管理 → 模板制作，先选择鱼竿、太阳镜或帽子。各品类只显示对应的定制项目。
2. 填写模板名称、工艺、颜色和加价。可选择需要开放的项目，同一品类可保存多套不同方案。点击保存模板，或保存并选择使用商品。
3. 在已保存模板右侧点击选择使用商品，搜索并勾选同品类商品的SKU，每次1–100个，可全选当前结果。
4. 选择生效端，预览原方案与新方案，核对后确认应用。各SKU获得独立副本，后续可单独修改。

从商品详情编辑添加模板

1. 打开商品管理 → 编辑 → 定制模板 → 添加定制模板。
2. 选择已保存的同品类模板，再勾选适用的全部或部分规格。可以选择同时启用，启用前须填写完整参数和必要价格。
3. 点击添加到商品编辑返回编辑页；尚未保存的名称、详情等内容会保留。最后点击保存商品并选择生效端。

模板制作不要求先选商品。模板列表支持“复制为新模板”，修改后另存新方案；商品编辑中可看到每个规格所用模板名称。添加模板只替换勾选规格的定制方案，不叠加多套模板。

模板仅包含工艺、颜色、参数及定制加价，整竿使用对应总节数档；批量使用模板不会改动售价、库存、编码、详情、入口权限或历史订单，也不会自动确认正式加工验收。预览后版本变化须重新核对，批次失败整体回滚。参数未填完整时可保存为待启用方案。

07 / 订单、价格与吉客云

每条商品明细都保存下单时的图案、尺寸、位置、色号、节位、验光数据和定制加价。后台后来改配置不会覆盖原订单。相同SKU、不同方案分行；同方案可合并数量，库存按相同SKU合计检查。

最终金额由服务器根据商家配置计算。顾客不能通过修改浏览器价格或提交被关闭的选项获得其他价格/配置。配镜核对完成前禁止支付和发货。

连接器用吉客云销售单明细的goodsMemo（货品备注）传递定制摘要，以sourceSubtradeNo（商城明细ID）区分同一SKU的不同方案，价格包含定制加价。查询时要求备注完整读回；备注截断、丢失或明细被合并时，状态保持待核查，不自动重复新建订单。

08 / 正式上架前逐项准备

• 帽子：每个型号主Logo位置、准确尺寸和可增印位置；正式加价。
• 鱼竿：每个SKU的真实节数、编号图、允许指定的节位、工艺色库。
• 眼镜：可加工SPH/CYL/PD范围、负柱镜接单方式、镀膜选项、核对客服和时效。
• 颜色：正式色号、色名、实拍色卡；演示色号全部替换。
• 政策：明确定制交付周期、修改/取消方式、售后与验光信息处理说明，不直接套用演示文本。
• 联调：微信原生编译和真机逐项操作，至少一笔真实定制订单在吉客云、加工单和实际商品之间核对一致。

当前本地验证记录见项目 docs/定制功能验证记录.md 与 docs/定制资格验证记录.md。服务器、域名、微信及支付配置继续按完整部署手册执行。