新增功能时，可以参考现有代码构造，开辟更快

修改代码时，运行测试即可知道是否影响其他功能

多节点安排：支撑随便率性数量节点自力安排，数据主动同步

商品根本信息：

• 商品名称（多说话）

• 商品描述（多说话）

• 商品分类选择

• 商品状况设置

• 商品图片上传

• 前提类型：

• 搜刮引擎优化 信息设置

SKU 治理（商品变体治理）：

• 规格选择

• 支撑多个规格维度

• 规格值多选

• SKU 信息设置

• SKU 编码

• 价格设置

• 库存数量

• 状况设置

• SKU 图片上传

• 批量操作

• 批量设置价格

• 批量设置成本

• 批量设置库存

• SKU 删除功能

• 及时预览 SKU 组合

分类列表展示

多级分类支撑

分类信息编辑

分类名称（多说话）

分类描述（多说话）

分类图片

分类 Slug（URL 友爱）

父分类选择

翻译状况

分类树形构造展示

批量操作支撑

促销列表

功能特点：

•  

  促销列表展示

• 收货人信息

• 促销名称（多说话）

• 促销类型（优惠券/主动促销）

• 开端/停止时光

• 启用状况

• 翻译状况

• 按名称搜刮

• 按类型筛选

• 按状况筛选

• 按翻译状况筛选

• 批量操作

• 批量删除

• 批量更新状况

• 批量更新翻译状况

• 快速操作

• 编辑促销根本信息

• 治理促销规矩和设置（新增功能）

促销根本信息编辑

功能特点：

• 促销类型选择

• 数据图表

• 时光设置

• 开端时光

• 停止时光

• 多说话翻译

• 促销名称（多说话）

• 促销描述（多说话）

•  

  促销规矩和设置治理

   

  主动生成 SKU 组合

• 

   

  这是 V1.3.0 新增的核心功能，供给完全的促销规矩设备：

   

  1. 促销规矩治理

   

  规矩设备：

  • 订单总金额最低（Order Total Min）：当订单总金额达到指定值时触发

  • 订单数量最低（Order Qty Min）：当订单商品数量达到指定值时触发

  • 前提值：设置触发促销的具体数值

  • 扣头类型：

  • 固定金额（Fixed）：直接减免固定金额

  • 百分比（Percentage）：按百分比扣头

  • 扣头值：设置扣头的具体数值

  应用示例：

  • 满 100 元减 10 元：前提类型=订单总金额最低，前提值=100，扣头类型=固定金额，扣头值=10

  • 满 3 件打 9 折：前提类型=订单数量最低，前提值=3，扣头类型=百分比，扣头值=10

  • 满 200 元打 8.5 折：前提类型=订单总金额最低，前提值=200，扣头类型=百分比，扣头值=15

   

  规矩治理：

  • 删除促销规矩

  • 编辑规矩参数

  • 体系主动选择最优扣头（多个规矩时选择扣头最大年夜的）

   

  2. 用户组限制

   

  功能解释：

  • 可以选择特定的用户组才能应用此促销

  • 支撑多选用户组

  • 假如不选择任何用户组，则所有效户都可以应用

  • 用户组用于促销限制、权限控制等

  已选中的用户组会以标签情势显示在顶部

总收入统计（多泉币主动换算）

应用处景：

• VIP 用户专享促销：只选择 VIP 用户组

• 新用户专享：只选择新用户组

• 特定地区用户：根据用户组区分不合地区用户

3. 商品变体（SKU）限制

主动促销（Automatic）：知足前提主动应用

功能解释：

• 可以指定介入促销的特定商品 SKU

• 支撑搜刮商品（按商品名称或 SKU 编码）

• 支撑多选商品变体

• 假如不选择任何商品变体，则所有商品都可以介入促销

添加多个促销规矩

特定商品促销：只选择部分热点商品的 SKU

清仓促销：只选择须要清仓的商品 SKU

新品促销：只选择新上架商品的 SKU

计算扣头后的商品价格

👥 用户治理体系

检查用户是否在许可的用户组中（假如设置了用户组限制）

检查商品 SKU 是否在许可的列表中（假如设置了 SKU 限制）

检查是否知足促销规矩的前提（订单金额或数量）

计算扣头金额

假如有多个促销知足前提，选择扣头最大年夜的一个

ProductVariantObserver - 商品变体变革监听

订单号

用户信息

订单金额

订单状况

泉币信息

搜刮功能

翻译状况治理

按用户信息搜刮

按订单状况筛选

按泉币筛选

订单状况治理

用户购物车查看

分页显示

搜刮和筛选

👥 用户治理

✅ 灵活构造：可以根据营业需求自由设计界面构造

用户列表

功能特点：

•  

  🛍️ 商品治理体系

  用户列表展示

• 用户姓名

• 用户邮箱

• 用户组

• 邮箱验证状况

• 按创建时光范围筛选

• 注册时光

• 订单数量

• 搜刮功能

• 按姓名搜刮

• 按邮箱搜刮

• 筛选功能

• 按用户组筛选

• ✅ 封装反复代码：雷同功能的代码同一封装，修改一处即可

• 按邮箱验证状况筛选

• 用户详情查看

• 用户编辑功能

用户详情

功能特点：

• 用户根本信息编辑

• 用户姓名

• 筛选功能

• 用户邮箱

• 用户组设置

• 邮箱验证时光设置

• 暗码修改

• 用户头像上传

• 用户订单统计

• 比来订单列表

📍 地址治理

✅ 周全单位测试：Livewire 组件和 Service 层都有完全的测试覆盖

功能特点：

• 用户地址列表

• 地址信息展示

• 接洽德律风

• 具体地址

• 国度/地区

• 地址编辑功能

• 地址删除功能

功能特点：

• 文章列表展示

• 文章标题（多说话）

• 文章状况

• 多图片轮播展示

• 翻译状况

• 宣布时光

• 搜刮和筛选

• 批量操作

• 文章编辑进口

文章编辑

功能特点：

• 文章根本信息

• 文章标题（多说话）

• 文章摘要（多说话）

• 文章内容（多说话，富文本编辑器）

• 文章封面图片

• 文章状况

• 翻译状况

• 富文本编辑器支撑

• 图片上传功能

⭐ 商批评价治理

功能特点：

• 商批评价列表

• 属性信息显示在商品详情页

评价信息展示

用户信息

品牌 B 节点：另一个自力的品牌网站，不合的 UI 设计，不合的商品分类

商品信息

评分

评价内容

评价时光

评价审核功能

评价删除功能

功能特点：

• 拜访统计

• 总拜访量

• 自力访客数

• 页面浏览量

• 时光范围选择

• 今天

• 昨天

• 比来 7 天

• 比来 30 天

• 比来 90 天

• 访客类型筛选

• 所有访客

• 真实用户

• 爬虫来源筛选

• 统计数据导出

🔔 通知治理

功能特点：

• 配送方法选择

• 体系通知列表

• 通知类型治理

• 通知发送功能

• 通知状况治理

👨‍💼 治理员治理

功能特点：

• 治理员列表

• 治理员信息

• 姓名

• PayPal 集成

• 邮箱

• Token 生成

• 实际好处：

  • 治理员添加/编辑

  • 治理员删除

   

  🌐 基本数据治理

   

  说话治理

   

  

   

  功能特点：

  • 说话列表

  • 说话信息

  • 说话代码

  • 是否默认说话

  • 翻译状况

  • 说话添加/编辑

  • 数据图表展示

  • 默认说话设置

   

  泉币治理

   

  

   

  功能特点：

  • 泉币列表

  • 泉币信息

  • 泉币名称

  • 泉币代码

  • 泉币符号

  • 特定商品促销：只选择部分热点商品的 SKU

  • 汇率

  • 泉币添加/编辑

  • 汇率更新

  • 默认泉币设置

   

  地区治理

   

  国度治理：

   

  

   

  区域治理：

   

  

  • 国度列表

  • 国度代码（ISO 代码）

  • 国度状况

   

  区域治理：

  • 区域列表

  • 所属国度

  • 区域状况

   

  🛒 购物车治理

   

  

   

  搜刮引擎爬虫

• 功能特点：

  • 购物车商品信息

  • 购物车清理功能

   

  ---

   

  多节点安排架构

   

  🌍 多节点安排概念

   

  重要解释：多节点安排不是简单的办事器集群，而是完全自力的体系安排。

   

  1. 完全自力的体系

  • 每个节点都是一个完全自力的电商体系

  • 每个节点有本身自力的数据库

  • 每个节点有本身自力的文件存储

  • 每个节点可以安排在不合的地舆地位（如：中国、美国、欧洲）

   

  1. 功能完全自力

  • 每个节点可以有不合的功能设备

  • 每个节点可以启用或禁用不合的功能模块

  •  

    1. 每个节点可以有不合的 UI 设计

    2. 每个节点可以有不合的品牌风格

    3. 最终付出金额

    4. 每个节点可以针对不合市场进行界面定制

   

  1. 付出方法完全自力

  • ✅ 遵守最佳实践：采取 Laravel 12 和 Livewire 4 的最佳实践

  • 每个节点可以设备不合的付出方法

  • 中国节点可以应用付出宝、微信付出

  • 美国节点可以应用 PayPal、Stripe

  • 欧洲节点可以应用 SEPA、Klarna

  • 每个节点的付出设备互不影响

   

  1. 数据主动同步

  • 固然体系自力，但核心营业数据会主动同步

  • 商品信息主动同步到所有节点

  • 分类信息主动同步

  • 订单数据平日不跨节点同步（每个节点自力处理订单）

   

  典范应用处景

   

  场景 1：跨国电商运营

  • 中国节点：面向中国市场，应用中文界面，支撑付出宝/微信付出，展示合适中国市场的商品

  • 美国节点：面向美国市场，应用英文界面，支撑 PayPal/Stripe，展示合适美国市场的商品

  • 欧洲节点：面向欧洲市场，应用多说话界面，支撑 SEPA，展示相符欧盟律例的商品

   

  场景 2：多品牌运营

  • 品牌 A 节点：自力的品牌网站，特定的 UI 设计，特定的商品分类

  • 两个节点共享部分商品数据，但展示方法完全不合

  数据变革时主动触发同步

•  

  场景 3：测试和临盆情况

  • 临盆节点：正式运营的体系

  • 测试节点：用于测试新功能的体系

  •  

    数据同步机制

     

     

    📁 分类治理

    主动同步的数据：

    • 商品信息（Product）

    • 商品变体（ProductVariant）

    • 商品翻译（ProductTranslation）

    • 分类信息（Category）

    • 分类翻译（CategoryTranslation）

    • 规格信息（Specification）

    • 规格值（SpecificationValue）

    • 属性信息（Attribute）

    • 属性值（AttributeValue）

    • 促销信息（Promotion）

    • 促销规矩（PromotionRule）

    • 文章信息（Article）

    • 媒体文件（图片、资本文件）

     

    每个泉币可以设置汇率

  • 不合步的数据（每个节点自力）：

    • 订单数据（Order）

    • 用户数据（User，可选择同步）

    • 购物车数据（Cart）

    • 付出设备

    • 体系设备

    • 模板文件

    • 自定义代码

     

    同步工作道理

     

    1. 节点 A 创建商品 → 主动同步到节点 B、C、D...

    2. 节点 B 更新商品 → 主动同步到节点 A、C、D...

    3. 以最新数据为准，主动解决冲突

   

  1. 智能去重

  • 基于数据哈希值检测变革

  • 避免反复同步雷同数据

  • 只同步真正有变更的数据

   

  1. 批量同步

  • 多笔记录打包成一个请求

  • 说话名称

  • 大年夜幅晋升同步效力

  • 削减收集请求次数

   

  1. 主动重试

  • 收集故障时主动重试

  • 确保数据不损掉

  • 完全的同步日记记录

  媒体文件同步

• 主动同步商品图片

• 主动同步资本文件

• 支撑文件转换（缩略图等）

 

具体技巧文档请参考：多节点数据同步文档

 

---

 

核心营业功能

 

🎁 促销体系详解

 

促销类型

 

1. 优惠券（Coupon）

• 须要用户输入优惠码

• 实用于精准营销

• 可以限制应用次数

优惠券（Coupon）：须要用户输入优惠码

•  

  1. 主动促销（Automatic）

  • 知足前提主动应用

  • 无需用户操作

  • 实用于全场促销

   

  促销规矩设备

   

  前提类型：

  • 订单总金额最低（Order Total Min）

  • 当订单总金额达到指定值时触发

  • 示例：满 100 元减 10 元

  • 示例：满 200 元打 9 折

   

  • 订单数量最低（Order Qty Min）

  • 当订单商品数量达到指定值时触发

  • 示例：满 3 件打 8.5 折

  • 示例：满 5 件减 50 元

   

  扣头类型：

  • 固定金额（Fixed）

  • 直接减免固定金额

  • 示例：减 10 元、减 50 元

   

  • 百分比（Percentage）

  • 按百分比扣头

  •  

    促销实用范围

     

    价格

  • 属性列表治理

  • 用户组限制：

    • 可以指定只有特定用户组才能应用此促销

    • 支撑多选用户组

    • 假如不选择任何用户组，则所有效户都可以应用

    • 应用处景：

    • VIP 用户专享：只选择 VIP 用户组

    • 新用户专享：只选择新用户组

    • 特定地区用户：根据用户组区分不合地区用户

     

    商品 SKU 限制：

    • 自定义组件示例：

      • 可以指定只有特定商品 SKU 才能介入促销

      • 支撑搜刮商品（按商品名称或 SKU 编码）

      • 支撑多选商品变体

      • 假如不选择任何商品变体，则所有商品都可以介入促销

      • 清仓促销：只选择须要清仓的商品 SKU

      • 新品促销：只选择新上架商品的 SKU

       

      促销计算逻辑

      创建时光

    •  

      1. 商等级别促销计算

      • 体系检查商品 SKU 是否在促销的商品列表中

      • 启用状况设置

      • 检查用户是否在促销许可的用户组中

      •  

        检查是否知足促销规矩前提（基于商品单价和数量）

      • 在商品详情页和购物车中显示促销信息

      订单级别促销计算

    • 体系检查订单总金额或商品总数量

    • 检查用户是否在促销许可的用户组中

    • 检查是否知足促销规矩前提

    • 实市价格计算（含促销扣头）

    • 计算订单级其余扣头

    • 在结账页面显示促销信息

     

    1. 最优促销选择

    • 假如多个促销同时知足前提，体系主动选择扣头最大年夜的一个

    • 确保用户获得最大年夜优惠

     

    商品规格体系

     

    规格维度：

    • 支撑多个规格维度（如：色彩、尺寸、材质、容量等）

    • 每个规格可以有多个规格值

    • 规格和规格值都支撑多说话

     

    每个节点可以有不合的营业逻辑

    SKU 主动生成：

    • 体系根据选择的规格值主动生成所有可能的 SKU 组合（笛卡尔积）

    • 例如：色彩（红、蓝）× 尺寸（S、M、L）= 6 个 SKU

    • 每个节点可以应用不合的前端模板

    • 每个 SKU 可以自力设置：

    • SKU 编码

    • 成本

    • 库存数量

    • 状况（上架/下架）

    • 图片

     

    前端商品详情页支撑规格选择

  • 选择规格后主动匹配对应的 SKU

  • 及时显示 SKU 的价格、库存信息

  • 显示该 SKU 的促销信息

   

  商品分类体系

  多级分类：

  • 支撑无穷级分类

  • 其他付出方法扩大

  • 分类树形构造展示

  • 分类可以设置父分类

  • 区域信息（多说话）

  •  

    文章列表

    商品可以属于多个分类

   

  分类属性：

  • 规格选择界面：

    •  

      1. 分类名称（多说话）

      2. 统计数据表格

      3. 分类描述（多说话）

      4. 分类图片

      5. 分类 Slug（URL 友爱）

      6. 翻译状况

     

    商品属性体系

     

    属性定义：

    • 可以定义商品属性（如：品牌、材质、产地等）

    • 每个属性可以有多个属性值

    • 属性和属性值都支撑多说话

     

    属性应用：

    • 比来 7 天

    • 商品可以接洽关系多个属性值

    • 属性用于商品筛选和展示

    •  

      💰 多泉币体系

       

      泉币治理：

      • 支撑多种泉币

      • 可以设置默认泉币

      • 汇率可以随时更新

       

      主动换算：

      • 商品价格按当前泉币主动换算

      • 订单金额按订单创建时的泉币记录

      • 支撑泉币符号显示

       

      用户可以切换泉币

    • 泉币选择保存在会话中

    • 切换泉币后所有价格主动更新

     

    📰 文章治理

     

    🌐 多说话体系

     

    说话支撑：

    • 可以设置默认说话

    • 可以添加更多说话

     

    翻译治理：

    • 所有内容都支撑多说话翻译

    • 翻译状况治理（未翻译、翻译中、已翻译）

    • 暗码重置

    批量翻译状况更新

  • AI 主动翻译支撑（集成 Ollama）

   

  翻译内容：

  • OrderObserver - 订单变革监听

  • 商品名称和描述

  • 分类名称和描述

  • 文章标题和内容

  • 促销名称和描述

  • 规格和属性名称

  • 体系界面文本

   

   

  📊 订单治理体系

   

  双向同步

• 订单状况：

  • 待付出（Pending）

  • 已付出（Paid）

  • 已发货（Shipped）

  • 已完成（Completed）

  • 已撤消（Cancelled）

   

  订单处理：

  • 订单创建

  • 付出处理

  • 发货治理

  • 订单状况更新

  • 订单撤消

  • 订单备注

   

  订单统计：

  • 总订单数统计

  • 总收入统计（多泉币主动换算）

  • 按状况统计

  • 按时光范围统计

  • 按泉币统计

   

  用户组功能：

  • 用户组支撑多说话名称

  • 用户可以被分派到不合的用户组

  •  

    用户功能：

    • 用户注册

    • 用户登录

    • 用户信息治理

    • 用户头像上传

    • 邮箱验证

    •  

      用户订单：

      • 用户可以查看本身的订单

      • 订单状况跟踪

      • 订单详情查看

       

      📈 流量统计体系

       

      功能特点：

      • 统计功能：

        • 拜访量统计

        • 自力访客统计

        • 页面浏览量统计

        • 访客类型区分（真实用户/搜刮引擎爬虫）

        • 爬虫来源统计

         

        时光范围：

        • 今天

        • 昨天

        • 比来 30 天

        • 比来 90 天

         

        数据展示：

        • 数据导出功能

         

        ---

         

        技巧实现细节

        技巧优势：

        • 页面切换时只更新变更的部分，不重建全部页面

        • 大年夜幅削减数据传输量

        • 晋升用户体验

        • 削减办事器负载

        • 响应速度晋升 3-5 倍：比拟传统页面刷新方法，页面切换速度大年夜幅晋升

        • 无闪烁体验：页面切换腻滑天然，没有明显的加载等待

         

        实现方法：

        • 应用 Livewire 4 的 wire:navigate 指令

        • 智能检测页面变更

        • 只传输须要的组件数据

        • 主动处理浏览器汗青记录

        保持页面状况

      • 实际后果：

        • 用户数据可以选择性同步

        • 功能特点：

          • 从商品列表切换到订单治理，刹时完成，无需等待

          • 编辑商品时，保存后急速看到更新，无需刷新页面

          • 批量操作多个商品，响应速度明显加快

           

          组件化开辟

           

          同一组件体系：

          • - 按钮组件（支撑多种变体：primary、secondary、danger 等）

          • - 输入框组件（支撑多种类型：text、number、email 等）

          • - 下拉选择组件（支撑多选、搜刮）

          • - 复选框组件（支撑单选、多选）

          • - 提示消息组件（支撑成功、警告、缺点等类型）

          • - 及时消息提示体系（右上角显示）

          • - 卡片容器组件（同一的卡片样式）

          • - 面包屑导航组件（主动生成导航路径）

          • - 表单字段组件（同一的标签和缺点提示）

           

          商品编辑和 SKU 治理

           

          模板完全自力

        • 组件优势：

          • 同一的 UI 风格：所有组件遵守同一的设计规范

          • 易于保护和更新：修改组件样式，所有应用的处所主动更新

          • 进步开辟效力：复用组件，削减反复代码

          • 地址列表选择

          • 包管界面一致性：确保全部体系的界面风格同一

          • 促销计算逻辑：

            1.  

               可以实现复杂的交互后果

            2. 可以创建独特的 UI 设计

           

          Observer 模式

           

          级联删除：

          • 删除商品时主动删除接洽关系的 SKU

          • 删除分类时主动处理商品分类接洽关系

          • 删除用户时主动处理订单接洽关系

          • 删除促销时主动处理促销规矩和接洽关系数据

          • 确保数据一致性，避免孤立数据

           

          主动同步触发：

          • 无需手动操作

          • 确保数据及时同步到所有节点

          • 支撑批量同步，晋升效力

           

          Observer 列表：

          • ProductObserver - 商品数据变革监听

          • 每个节点可以运行在不合的办事器上

          • 属性值排序

          • CategoryObserver - 分类变革监听

          • PromotionObserver - 促销变革监听

          • PromotionRuleObserver - 促销规矩变革监听

          • 以及其他所有须要同步的模型 Observer

           

          代码质量包管

           

          代码封装：

          • Trait 复用：应用 Trait 封装通用功能

          • HasTranslatedNames - 多说话翻译处理

          • UsesLocaleCurrency - 泉币和说话办事

          • HasBatchActions - 批量操作功能

          • HasSearchAndFilters - 搜刮和筛选功能

          • HasDeleteAction - 删除操作功能

          • HasNavigationRedirect - 导航重定向功能

          • Service 层封装：营业逻辑封装在 Service 层

          • ProductService - 商品相干营业逻辑

          • PromotionService - 促销计算逻辑

          • CartService - 购物车营业逻辑

          • SyncService - 数据同步逻辑

          • 商品搜刮功能

          • 同一组件：UI 组件同一封装，易于保护

          支撑 8 种说话（中文、英文、西班牙语、法语、日语、韩语、德语、俄语）

        •  

          测试覆盖：

          • 功能测试：症毕营业流程都有功能测试

          • 同步测试：多节点同步逻辑有专门的测试

          • 测试对象：应用 PHPUnit 进行测试，确保代码质量

           

          代码规范：

          • 检查促销时光是否在有效期内

          • PSR-12 标准：遵守 PHP 编码规范

          • PHPStan 静态分析：代码质量检查，确保类型安然

          • Pint 代码格局化：主动格局化代码，保持代码风格一致

           

          Livewire 4 智能导航

           

          实际好处：

          • 修改商品相干功能时，只须要改封装好的代码

          • 新增功能时，可以参考现有代码构造，开辟更快

          • 修改代码时，运行测试即可知道是否影响其他功能

           

          ---

           

          总结

          Teanary V1.3.0 是一个功能完全、机能优良的现代化电商平台体系。经由过程 Livewire 4 的智能导航技巧，供给了流畅的操作体验；经由过程多节点安排架构，支撑全球化的营业运营；经由过程灵活的促销体系，知足各类营销需求。

          体系采取模块化设计，易于扩大和保护，是构建现代化电商平台的幻想选择。