🎉 Teanary V1.3.0 预览版发布 - 性能全面提升，操作体验更流畅

Teanary V1.3.0 功能说明文档

本文档详细介绍了 Teanary 电商平台系统 V1.3.0 的所有功能特性，包括前端展示、后台管理、多节点部署等核心功能。

📋 目录

• 系统概述
• 前端功能
• 管理后台功能
• 多节点部署架构
• 核心业务功能

---

系统概述

Teanary 是一个现代化的全球电商平台系统，基于 Laravel 12.x 和 Livewire 4.x 构建，支持多语言、多货币、多节点部署。系统采用前后端分离的架构，前端使用 Livewire 实现动态交互，后台管理完全基于 Livewire 4 的智能导航技术，提供流畅的操作体验。

V1.3.0 核心改进

V1.3.0 是 Teanary 电商平台系统的一次重大升级，使用 Livewire 4 完全重写了后台管理系统，采用 Laravel 12 最新特性，性能大幅提升，操作体验更加流畅。

⚡ 性能大幅提升 - 操作更流畅

之前的问题：

• 切换页面时需要重新加载整个页面，等待时间长
• 操作响应慢，影响工作效率
• 页面切换时有明显的闪烁感

V1.3.0 的改进：

• ✅ 智能导航技术：切换功能时无需重建整个页面，只更新需要变化的部分
• ✅ 响应速度提升：页面切换速度提升 3-5 倍，操作更流畅
• ✅ 无闪烁体验：页面切换平滑自然，没有明显的加载等待
• ✅ 减少服务器负载：只传输必要的数据，减少带宽消耗

实际感受：

• 从商品列表切换到订单管理，瞬间完成，无需等待
• 编辑商品时，保存后立即看到更新，无需刷新页面
• 批量操作多个商品，响应速度明显加快

🎨 完全自主定制 - 满足各种复杂需求

之前的问题：

• 后台界面受限于 FilamentPHP 的组件，难以实现复杂布局
• 特殊业务需求无法通过现有组件实现
• 界面定制需要大量额外工作

V1.3.0 的改进：

• ✅ 完全移除 FilamentPHP：所有界面完全自主控制
• ✅ 灵活布局：可以根据业务需求自由设计界面布局
• ✅ 自定义组件：可以创建完全符合业务需求的组件
• ✅ 易于扩展：新增功能时，可以快速实现各种复杂界面

实际应用：

• 可以根据业务需求设计独特的商品管理界面
• 可以实现复杂的订单筛选和统计展示
• 可以创建完全符合公司品牌风格的管理后台

🔧 代码质量提升 - 更易维护和扩展

之前的问题：

• 代码中有重复逻辑，修改时需要改多个地方
• 代码结构不够清晰，新功能开发困难
• 缺少测试，修改代码时担心影响其他功能

V1.3.0 的改进：

• ✅ 封装重复代码：相同功能的代码统一封装，修改一处即可
• ✅ 遵循最佳实践：采用 Laravel 12 和 Livewire 4 的最佳实践
• ✅ 全面单元测试：Livewire 组件和 Service 层都有完整的测试覆盖
• ✅ 代码结构清晰：代码组织更合理，新功能开发更容易

实际好处：

• 修改商品相关功能时，只需要改封装好的代码
• 新增功能时，可以参考现有代码结构，开发更快
• 修改代码时，运行测试即可知道是否影响其他功能

技术特点

• 智能导航：Livewire 4 的智能导航技术，页面切换无需重建整个页面，只更新变化部分
• 完全定制：移除 FilamentPHP，所有界面完全自主控制，可灵活定制
• 多语言支持：支持 8 种语言（中文、英文、西班牙语、法语、日语、韩语、德语、俄语）
• 多货币支持：自动汇率换算，支持多种货币结算
• 多节点部署：支持任意数量节点独立部署，数据自动同步

---

前端功能

🏠 首页展示

功能描述：

• 展示系统核心特性和技术栈
• 响应式设计，适配各种设备
• 多语言切换支持
• SEO 优化，友好的 URL 结构

主要特性：

• 技术栈展示（Laravel、PHP、MySQL、Redis、Tailwind CSS、Livewire、Alpine.js、Vite、Ollama AI）
• 核心功能亮点展示
• 在线演示链接
• 响应式布局，移动端友好

📦 商品展示

商品列表页面

功能特性：

• 多级分类浏览
• 商品搜索功能
• 分类筛选
• 商品卡片展示（图片、名称、价格、促销信息）
• 分页加载

商品详情页面

功能特性：

• 多规格选择（颜色、尺寸等）
• 实时价格计算（含促销折扣）
• 库存显示
• 多图片轮播展示
• 商品详情描述
• 规格组合自动匹配 SKU
• 一键加入购物车
• 立即购买功能

商品规格系统：

• 支持多个规格维度（如：颜色、尺寸、材质等）
• 规格值多语言支持
• 自动生成 SKU 组合（笛卡尔积）
• 每个 SKU 独立的价格、库存、图片

商品描述页面

🛒 购物车

功能特性：

• 购物车商品列表展示
• 商品规格信息显示
• 实时价格计算（含促销折扣）
• 数量增减操作
• 商品删除功能
• 全选/反选功能
• 选中商品总价计算
• 促销信息展示（折扣金额、折扣百分比）
• 一键结算功能

促销展示：

• 显示应用的促销活动名称
• 显示折扣金额或百分比
• 显示原价和折后价对比
• 促销描述信息

💳 结账页面

功能特性：

• 收货地址管理
  • 地址列表选择
  • 新增地址表单
  • 地址编辑功能
  • 国家/地区选择
• 配送方式选择
  • 多种配送方式
  • 配送费用计算
  • 配送时间估算
• 支付方式选择
  • PayPal 集成
  • 其他支付方式扩展
• 订单金额计算
  • 商品总价
  • 配送费用
  • 促销折扣
  • 最终支付金额
• 订单确认和提交

---

管理后台功能

📊 管理后台首页

功能特性：

• 数据统计看板
  • 总用户数统计
  • 总订单数统计
  • 总收入统计（多货币自动换算）
  • 最近订单列表
• 实时数据更新
• 多货币显示支持
• 快速导航入口

🛍️ 商品管理

商品列表

功能特性：

• 商品列表展示
  • 商品名称（多语言）
  • 商品状态（上架/下架）
  • 翻译状态
  • 分类信息
  • 库存预警
• 搜索功能
  • 按商品名称搜索
  • 按 SKU 搜索
• 筛选功能
  • 按状态筛选
  • 按翻译状态筛选
  • 按分类筛选
  • 低库存筛选
  • 缺货筛选
• 批量操作
  • 批量删除
  • 批量更新状态
  • 批量更新翻译状态
• 分页显示

商品编辑和 SKU 管理

商品基本信息：

• 商品名称（多语言）
• 商品描述（多语言）
• 商品分类选择
• 商品状态设置
• 商品图片上传
• SEO 信息设置

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

• 规格选择
  • 支持多个规格维度
  • 规格值多选
  • 自动生成 SKU 组合
• SKU 信息设置
  • SKU 编码
  • 价格设置
  • 成本设置
  • 库存数量
  • 状态设置
  • SKU 图片上传
• 批量操作
  • 批量设置价格
  • 批量设置成本
  • 批量设置库存
  • 批量设置状态
• SKU 删除功能
• 实时预览 SKU 组合

📁 分类管理

功能特性：

• 分类列表展示
• 多级分类支持
• 分类信息编辑
  • 分类名称（多语言）
  • 分类描述（多语言）
  • 分类图片
  • 分类 Slug（URL 友好）
  • 父分类选择
  • 翻译状态
• 分类树形结构展示
• 批量操作支持

🏷️ 规格管理

功能特性：

• 规格列表管理
• 规格信息编辑
  • 规格名称（多语言）
  • 规格值管理
• 规格值管理
  • 规格值名称（多语言）
  • 规格值排序
• 多语言支持

🔖 属性管理

功能特性：

• 属性列表管理
• 属性信息编辑
  • 属性名称（多语言）
  • 属性值管理
• 属性值管理
  • 属性值名称（多语言）
  • 属性值排序
• 商品属性关联

🎁 促销管理

促销列表

功能特性：

• 促销列表展示
  • 促销名称（多语言）
  • 促销类型（优惠券/自动促销）
  • 开始/结束时间
  • 启用状态
  • 翻译状态
• 搜索和筛选
  • 按名称搜索
  • 按类型筛选
  • 按状态筛选
  • 按翻译状态筛选
• 批量操作
  • 批量删除
  • 批量更新状态
  • 批量更新翻译状态
• 快速操作
  • 编辑促销基本信息
  • 管理促销规则和设置（新增功能）

促销基本信息编辑

功能特性：

• 促销类型选择
  • 优惠券（Coupon）：需要用户输入优惠码
  • 自动促销（Automatic）：满足条件自动应用
• 时间设置
  • 开始时间
  • 结束时间
• 启用状态设置
• 多语言翻译
  • 促销名称（多语言）
  • 促销描述（多语言）
• 翻译状态管理

促销规则和设置管理

这是 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）限制

功能说明：

• 可以指定参与促销的特定商品 SKU
• 支持搜索商品（按商品名称或 SKU 编码）
• 支持多选商品变体
• 如果不选择任何商品变体，则所有商品都可以参与促销

应用场景：

• 特定商品促销：只选择部分热门商品的 SKU
• 清仓促销：只选择需要清仓的商品 SKU
• 新品促销：只选择新上架商品的 SKU

搜索功能：

• 实时搜索商品名称
• 实时搜索 SKU 编码
• 显示商品名称、SKU、规格信息、价格
• 最多显示 50 个搜索结果

促销计算逻辑：

1. 系统检查促销是否启用
2. 检查促销时间是否在有效期内
3. 检查用户是否在允许的用户组中（如果设置了用户组限制）
4. 检查商品 SKU 是否在允许的列表中（如果设置了 SKU 限制）
5. 检查是否满足促销规则的条件（订单金额或数量）
6. 计算折扣金额
7. 如果有多个促销满足条件，选择折扣最大的一个

📦 订单管理

订单列表

功能特性：

• 订单列表展示
  • 订单号
  • 用户信息
  • 订单金额
  • 订单状态
  • 创建时间
  • 货币信息
• 搜索功能
  • 按订单号搜索
  • 按用户信息搜索
• 筛选功能
  • 按订单状态筛选
  • 按货币筛选
  • 按创建时间范围筛选
• 订单状态管理
• 分页显示

订单详情

功能特性：

• 订单基本信息
  • 订单号
  • 订单状态
  • 创建时间
  • 支付时间
  • 发货时间
• 用户信息
  • 用户姓名
  • 用户邮箱
  • 用户组信息
• 收货地址信息
  • 收货人姓名
  • 联系电话
  • 详细地址
  • 国家/地区
• 订单商品列表
  • 商品名称
  • 商品规格
  • 单价
  • 数量
  • 小计
  • 促销信息
• 订单金额明细
  • 商品总价
  • 配送费用
  • 促销折扣
  • 最终支付金额
• 订单操作
  • 订单状态更新
  • 发货信息录入
  • 订单备注

👥 用户管理

用户列表

功能特性：

• 用户列表展示
  • 用户姓名
  • 用户邮箱
  • 用户组
  • 邮箱验证状态
  • 注册时间
  • 订单数量
• 搜索功能
  • 按姓名搜索
  • 按邮箱搜索
• 筛选功能
  • 按用户组筛选
  • 按邮箱验证状态筛选
• 用户详情查看
• 用户编辑功能

用户详情

功能特性：

• 用户基本信息编辑
  • 用户姓名
  • 用户邮箱
  • 用户组设置
  • 邮箱验证时间设置
  • 密码修改
• 用户头像上传
• 用户订单统计
• 最近订单列表

📍 地址管理

功能特性：

• 用户地址列表
• 地址信息展示
  • 收货人信息
  • 联系电话
  • 详细地址
  • 国家/地区
• 地址编辑功能
• 地址删除功能

📰 文章管理

文章列表

功能特性：

• 文章列表展示
  • 文章标题（多语言）
  • 文章状态
  • 翻译状态
  • 发布时间
• 搜索和筛选
• 批量操作
• 文章编辑入口

文章编辑

功能特性：

• 文章基本信息
  • 文章标题（多语言）
  • 文章摘要（多语言）
  • 文章内容（多语言，富文本编辑器）
  • 文章封面图片
  • 文章状态
  • 翻译状态
• 富文本编辑器支持
• 图片上传功能

⭐ 商品评价管理

功能特性：

• 商品评价列表
• 评价信息展示
  • 用户信息
  • 商品信息
  • 评分
  • 评价内容
  • 评价时间
• 评价审核功能
• 评价删除功能

📈 流量统计

功能特性：

• 访问统计
  • 总访问量
  • 独立访客数
  • 页面浏览量
• 时间范围选择
  • 今天
  • 昨天
  • 最近 7 天
  • 最近 30 天
  • 最近 90 天
• 访客类型筛选
  • 所有访客
  • 真实用户
  • 搜索引擎爬虫
• 爬虫来源筛选
• 数据图表展示
• 统计数据导出

🔔 通知管理

功能特性：

• 系统通知列表
• 通知类型管理
• 通知发送功能
• 通知状态管理

👨‍💼 管理员管理

功能特性：

• 管理员列表
• 管理员信息
  • 姓名
  • 邮箱
  • Token 生成
• 管理员添加/编辑
• 管理员删除

🌐 基础数据管理

语言管理

功能特性：

• 语言列表
• 语言信息
  • 语言名称
  • 语言代码
  • 是否默认语言
  • 翻译状态
• 语言添加/编辑
• 默认语言设置

货币管理

功能特性：

• 货币列表
• 货币信息
  • 货币名称
  • 货币代码
  • 货币符号
  • 汇率
  • 是否默认货币
• 货币添加/编辑
• 汇率更新
• 默认货币设置

地区管理

国家管理：

区域管理：

• 国家列表
• 国家信息（多语言）
• 国家代码（ISO 代码）
• 国家状态

区域管理：

• 区域列表
• 区域信息（多语言）
• 所属国家
• 区域状态

🛒 购物车管理

功能特性：

• 购物车列表
• 购物车商品信息
• 用户购物车查看
• 购物车清理功能

---

多节点部署架构

🌍 多节点部署概念

重要说明：多节点部署不是简单的服务器集群，而是完全独立的系统部署。

核心特点

1. 完全独立的系统

   • 每个节点都是一个完全独立的电商系统
   • 每个节点有自己独立的数据库
   • 每个节点有自己独立的文件存储
   • 每个节点可以运行在不同的服务器上
   • 每个节点可以部署在不同的地理位置（如：中国、美国、欧洲）

2. 功能完全独立

   • 每个节点可以有不同的功能配置
   • 每个节点可以启用或禁用不同的功能模块
   • 每个节点可以有不同的业务逻辑

3. 模板完全独立

   • 每个节点可以使用不同的前端模板
   • 每个节点可以有不同的 UI 设计
   • 每个节点可以有不同的品牌风格
   • 每个节点可以针对不同市场进行界面定制

4. 支付方式完全独立

   • 每个节点可以配置不同的支付方式
   • 中国节点可以使用支付宝、微信支付
   • 美国节点可以使用 PayPal、Stripe
   • 欧洲节点可以使用 SEPA、Klarna
   • 每个节点的支付配置互不影响

5. 数据自动同步

   • 虽然系统独立，但核心业务数据会自动同步
   • 商品信息自动同步到所有节点
   • 分类信息自动同步
   • 用户数据可以选择性同步
   • 订单数据通常不跨节点同步（每个节点独立处理订单）

典型应用场景

场景 1：跨国电商运营

• 中国节点：面向中国市场，使用中文界面，支持支付宝/微信支付，展示适合中国市场的商品
• 美国节点：面向美国市场，使用英文界面，支持 PayPal/Stripe，展示适合美国市场的商品
• 欧洲节点：面向欧洲市场，使用多语言界面，支持 SEPA，展示符合欧盟法规的商品

场景 2：多品牌运营

• 品牌 A 节点：独立的品牌网站，特定的 UI 设计，特定的商品分类
• 品牌 B 节点：另一个独立的品牌网站，不同的 UI 设计，不同的商品分类
• 两个节点共享部分商品数据，但展示方式完全不同

场景 3：测试和生产环境

• 生产节点：正式运营的系统
• 测试节点：用于测试新功能的系统
• 测试节点可以同步生产节点的商品数据，但订单、用户数据独立

数据同步机制

自动同步的数据：

• 商品信息（Product）
• 商品变体（ProductVariant）
• 商品翻译（ProductTranslation）
• 分类信息（Category）
• 分类翻译（CategoryTranslation）
• 规格信息（Specification）
• 规格值（SpecificationValue）
• 属性信息（Attribute）
• 属性值（AttributeValue）
• 促销信息（Promotion）
• 促销规则（PromotionRule）
• 文章信息（Article）
• 媒体文件（图片、资源文件）

不同步的数据（每个节点独立）：

• 订单数据（Order）
• 用户数据（User，可选择同步）
• 购物车数据（Cart）
• 支付配置
• 系统配置
• 模板文件
• 自定义代码

同步工作原理

1. 双向同步

   • 节点 A 创建商品 → 自动同步到节点 B、C、D...
   • 节点 B 更新商品 → 自动同步到节点 A、C、D...
   • 以最新数据为准，自动解决冲突

2. 智能去重

   • 基于数据哈希值检测变更
   • 避免重复同步相同数据
   • 只同步真正有变化的数据

3. 批量同步

   • 多条记录打包成一个请求
   • 大幅提升同步效率
   • 减少网络请求次数

4. 自动重试

   • 网络故障时自动重试
   • 确保数据不丢失
   • 完整的同步日志记录

5. 媒体文件同步

   • 自动同步商品图片
   • 自动同步资源文件
   • 支持文件转换（缩略图等）

详细技术文档请参考：[多节点数据同步文档](docs/SYNC.md](docs/SYNC.md)

---

核心业务功能

🎁 促销系统详解

促销类型

1. 优惠券（Coupon）

   • 需要用户输入优惠码
   • 适用于精准营销
   • 可以限制使用次数

2. 自动促销（Automatic）

   • 满足条件自动应用
   • 无需用户操作
   • 适用于全场促销

促销规则配置

条件类型：

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

  • 当订单总金额达到指定值时触发
  • 示例：满 100 元减 10 元
  • 示例：满 200 元打 9 折

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

  • 当订单商品数量达到指定值时触发
  • 示例：满 3 件打 8.5 折
  • 示例：满 5 件减 50 元

折扣类型：

• 固定金额（Fixed）

  • 直接减免固定金额
  • 示例：减 10 元、减 50 元

• 百分比（Percentage）

  • 按百分比折扣
  • 示例：打 9 折（10% 折扣）、打 8 折（20% 折扣）

促销适用范围

用户组限制：

• 可以指定只有特定用户组才能使用此促销
• 支持多选用户组
• 如果不选择任何用户组，则所有用户都可以使用
• 应用场景：
  • VIP 用户专享：只选择 VIP 用户组
  • 新用户专享：只选择新用户组
  • 特定地区用户：根据用户组区分不同地区用户

商品 SKU 限制：

• 可以指定只有特定商品 SKU 才能参与促销
• 支持搜索商品（按商品名称或 SKU 编码）
• 支持多选商品变体
• 如果不选择任何商品变体，则所有商品都可以参与促销
• 应用场景：
  • 特定商品促销：只选择部分热门商品的 SKU
  • 清仓促销：只选择需要清仓的商品 SKU
  • 新品促销：只选择新上架商品的 SKU

促销计算逻辑

1. 商品级别促销计算

   • 系统检查商品 SKU 是否在促销的商品列表中
   • 检查用户是否在促销允许的用户组中
   • 检查是否满足促销规则条件（基于商品单价和数量）
   • 计算折扣后的商品价格
   • 在商品详情页和购物车中显示促销信息

2. 订单级别促销计算

   • 系统检查订单总金额或商品总数量
   • 检查用户是否在促销允许的用户组中
   • 检查是否满足促销规则条件
   • 计算订单级别的折扣
   • 在结账页面显示促销信息

3. 最优促销选择

   • 如果多个促销同时满足条件，系统自动选择折扣最大的一个
   • 确保用户获得最大优惠

🛍️ 商品管理系统

商品规格系统

规格维度：

• 支持多个规格维度（如：颜色、尺寸、材质、容量等）
• 每个规格可以有多个规格值
• 规格和规格值都支持多语言

SKU 自动生成：

• 系统根据选择的规格值自动生成所有可能的 SKU 组合（笛卡尔积）
• 例如：颜色（红、蓝）× 尺寸（S、M、L）= 6 个 SKU
• 每个 SKU 可以独立设置：
  • SKU 编码
  • 价格
  • 成本
  • 库存数量
  • 状态（上架/下架）
  • 图片

规格选择界面：

• 前端商品详情页支持规格选择
• 选择规格后自动匹配对应的 SKU
• 实时显示 SKU 的价格、库存信息
• 显示该 SKU 的促销信息

商品分类系统

多级分类：

• 支持无限级分类
• 分类树形结构展示
• 分类可以设置父分类
• 商品可以属于多个分类

分类属性：

• 分类名称（多语言）
• 分类描述（多语言）
• 分类图片
• 分类 Slug（URL 友好）
• 翻译状态

商品属性系统

属性定义：

• 可以定义商品属性（如：品牌、材质、产地等）
• 每个属性可以有多个属性值
• 属性和属性值都支持多语言

属性应用：

• 商品可以关联多个属性值
• 属性用于商品筛选和展示
• 属性信息显示在商品详情页

💰 多货币系统

货币管理：

• 支持多种货币
• 每个货币可以设置汇率
• 可以设置默认货币
• 汇率可以随时更新

自动换算：

• 商品价格按当前货币自动换算
• 订单金额按订单创建时的货币记录
• 后台统计时自动换算为默认货币
• 支持货币符号显示

用户货币选择：

• 用户可以切换货币
• 货币选择保存在会话中
• 切换货币后所有价格自动更新

🌐 多语言系统

语言支持：

• 支持 8 种语言（中文、英文、西班牙语、法语、日语、韩语、德语、俄语）
• 可以设置默认语言
• 可以添加更多语言

翻译管理：

• 所有内容都支持多语言翻译
• 翻译状态管理（未翻译、翻译中、已翻译）
• 批量翻译状态更新
• AI 自动翻译支持（集成 Ollama）

翻译内容：

• 商品名称和描述
• 分类名称和描述
• 文章标题和内容
• 促销名称和描述
• 规格和属性名称
• 系统界面文本

📊 订单管理系统

订单状态：

• 待支付（Pending）
• 已支付（Paid）
• 已发货（Shipped）
• 已完成（Completed）
• 已取消（Cancelled）

订单处理：

• 订单创建
• 支付处理
• 发货管理
• 订单状态更新
• 订单取消
• 订单备注

订单统计：

• 总订单数统计
• 总收入统计（多货币自动换算）
• 按状态统计
• 按时间范围统计
• 按货币统计

👥 用户管理系统

用户组功能：

• 可以创建多个用户组
• 用户组支持多语言名称
• 用户可以被分配到不同的用户组
• 用户组用于促销限制、权限控制等

用户功能：

• 用户注册
• 用户登录
• 用户信息管理
• 用户头像上传
• 邮箱验证
• 密码重置

用户订单：

• 用户可以查看自己的订单
• 订单状态跟踪
• 订单详情查看

📈 流量统计系统

统计功能：

• 访问量统计
• 独立访客统计
• 页面浏览量统计
• 访客类型区分（真实用户/搜索引擎爬虫）
• 爬虫来源统计

时间范围：

• 今天
• 昨天
• 最近 7 天
• 最近 30 天
• 最近 90 天

数据展示：

• 数据图表
• 统计数据表格
• 数据导出功能

---

技术实现细节

Livewire 4 智能导航

技术优势：

• 页面切换时只更新变化的部分，不重建整个页面
• 大幅减少数据传输量
• 提升用户体验
• 减少服务器负载
• 响应速度提升 3-5 倍：相比传统页面刷新方式，页面切换速度大幅提升
• 无闪烁体验：页面切换平滑自然，没有明显的加载等待

实现方式：

• 使用 Livewire 4 的 wire:navigate 指令
• 智能检测页面变化
• 只传输必要的组件数据
• 保持页面状态
• 自动处理浏览器历史记录

实际效果：

• 从商品列表切换到订单管理，瞬间完成，无需等待
• 编辑商品时，保存后立即看到更新，无需刷新页面
• 批量操作多个商品，响应速度明显加快

组件化开发

统一组件系统：

• <x-widgets.button> - 按钮组件（支持多种变体：primary、secondary、danger 等）
• <x-widgets.input> - 输入框组件（支持多种类型：text、number、email 等）
• <x-widgets.select> - 下拉选择组件（支持多选、搜索）
• <x-widgets.checkbox> - 复选框组件（支持单选、多选）
• <x-widgets.alert> - 提示消息组件（支持成功、警告、错误等类型）
• <x-widgets.flash-messages> - 实时消息提示系统（右上角显示）
• <x-widgets.card> - 卡片容器组件（统一的卡片样式）
• <x-widgets.breadcrumbs> - 面包屑导航组件（自动生成导航路径）
• <x-widgets.form-field> - 表单字段组件（统一的标签和错误提示）

组件优势：

• 统一的 UI 风格：所有组件遵循统一的设计规范
• 易于维护和更新：修改组件样式，所有使用的地方自动更新
• 提高开发效率：复用组件，减少重复代码
• 保证界面一致性：确保整个系统的界面风格统一
• 完全自主控制：不受第三方组件库限制，可以灵活定制

自定义组件示例：

• 可以根据业务需求创建完全符合业务逻辑的组件
• 可以实现复杂的交互效果
• 可以创建独特的 UI 设计

Observer 模式

级联删除：

• 删除商品时自动删除关联的 SKU
• 删除分类时自动处理商品分类关联
• 删除用户时自动处理订单关联
• 删除促销时自动处理促销规则和关联数据
• 确保数据一致性，避免孤立数据

自动同步触发：

• 数据变更时自动触发同步
• 无需手动操作
• 确保数据及时同步到所有节点
• 支持批量同步，提升效率

Observer 列表：

• ProductObserver - 商品数据变更监听
• ProductVariantObserver - 商品变体变更监听
• CategoryObserver - 分类变更监听
• PromotionObserver - 促销变更监听
• PromotionRuleObserver - 促销规则变更监听
• OrderObserver - 订单变更监听
• 以及其他所有需要同步的模型 Observer

代码质量保证

代码封装：

• Trait 复用：使用 Trait 封装通用功能
  • HasTranslatedNames - 多语言翻译处理
  • UsesLocaleCurrency - 货币和语言服务
  • HasBatchActions - 批量操作功能
  • HasSearchAndFilters - 搜索和筛选功能
  • HasDeleteAction - 删除操作功能
  • HasNavigationRedirect - 导航重定向功能
• Service 层封装：业务逻辑封装在 Service 层
  • ProductService - 商品相关业务逻辑
  • PromotionService - 促销计算逻辑
  • CartService - 购物车业务逻辑
  • SyncService - 数据同步逻辑
• 统一组件：UI 组件统一封装，易于维护

测试覆盖：

• 单元测试：Livewire 组件和 Service 层都有完整的测试覆盖
• 功能测试：关键业务流程都有功能测试
• 同步测试：多节点同步逻辑有专门的测试
• 测试工具：使用 PHPUnit 进行测试，确保代码质量

代码规范：

• PSR-12 标准：遵循 PHP 编码规范
• PHPStan 静态分析：代码质量检查，确保类型安全
• Pint 代码格式化：自动格式化代码，保持代码风格一致

实际好处：

• 修改商品相关功能时，只需要改封装好的代码
• 新增功能时，可以参考现有代码结构，开发更快
• 修改代码时，运行测试即可知道是否影响其他功能

---

总结

Teanary V1.3.0 是一个功能完整、性能优秀的现代化电商平台系统。通过 Livewire 4 的智能导航技术，提供了流畅的操作体验；通过多节点部署架构，支持全球化的业务运营；通过灵活的促销系统，满足各种营销需求。

系统采用模块化设计，易于扩展和维护，是构建现代化电商平台的理想选择。