本文档详细介绍了 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. 完全独立的系统

• 每个节点都是一个完全独立的电商系统

• 每个节点有自己独立的数据库

• 每个节点有自己独立的文件存储

• 每个节点可以运行在不同的服务器上

• 每个节点可以部署在不同的地理位置（如：中国、美国、欧洲）

 

1. 功能完全独立

• 每个节点可以有不同的功能配置

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

• 每个节点可以有不同的业务逻辑

 

1. 模板完全独立

• 每个节点可以使用不同的前端模板

• 每个节点可以有不同的 UI 设计

• 每个节点可以有不同的品牌风格

• 每个节点可以针对不同市场进行界面定制

 

1. 支付方式完全独立

• 每个节点可以配置不同的支付方式

• 中国节点可以使用支付宝、微信支付

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

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

• 每个节点的支付配置互不影响

 

1. 数据自动同步

• 虽然系统独立，但核心业务数据会自动同步

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

• 分类信息自动同步

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

• 订单数据通常不跨节点同步（每个节点独立处理订单）

 

典型应用场景

 

场景 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...

• 以最新数据为准，自动解决冲突

 

1. 智能去重

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

• 避免重复同步相同数据

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

 

1. 批量同步

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

• 大幅提升同步效率

• 减少网络请求次数

 

1. 自动重试

• 网络故障时自动重试

• 确保数据不丢失

• 完整的同步日志记录

 

1. 媒体文件同步

• 自动同步商品图片

• 自动同步资源文件

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

 

详细技术文档请参考：多节点数据同步文档

 

---

 

核心业务功能

 

🎁 促销系统详解

 

促销类型

 

1. 优惠券（Coupon）

• 需要用户输入优惠码

• 适用于精准营销

• 可以限制使用次数

 

1. 自动促销（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 是否在促销的商品列表中

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

• 检查是否满足促销规则条件（基于商品单价和数量）

• 计算折扣后的商品价格

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

 

1. 订单级别促销计算

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

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

• 检查是否满足促销规则条件

• 计算订单级别的折扣

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

 

1. 最优促销选择

• 如果多个促销同时满足条件，系统自动选择折扣最大的一个

• 确保用户获得最大优惠

 

🛍️ 商品管理系统

 

商品规格系统

 

规格维度：

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

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

• 规格和规格值都支持多语言

 

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 的智能导航技术，提供了流畅的操作体验；通过多节点部署架构，支持全球化的业务运营；通过灵活的促销系统，满足各种营销需求。

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