开源了一个自用的外贸商城(Teanary)

teanary 的个人博客 / 288 / 10 / 创建于 3周前 / 更新于 3周前

AI摘要

【知识分享】本文介绍Teanary全球多节点电商平台系统，该系统支持多节点数据同步、AI自动翻译、Chrome插件商品采集及完整电商功能。技术栈基于Laravel、Tailwind CSS等现代框架，采用AGPL-3.0开源协议，适用于跨国电商运营场景，旨在解决数据一致性、本地化服务及管理效率等问题。

Teanary - 全球多节点电商平台系统

地址:teanary.com/index.html

一个支持多节点部署、AI自动翻译、商品采集的现代化全球电商平台系统。专为解决跨国电商运营难题而设计。

🌟 核心特性

🌍 多节点数据同步系统

解决的核心问题：

✅ 跨国服务器管理难题：服务器在国外，管理网站不方便？在中国部署管理节点，数据自动同步到全球各节点
✅ 本地化运营：不同国家/地区运行独立节点，提供本地化服务，提升用户体验
✅ 数据一致性：多节点数据自动双向同步，以最新数据为准，确保全球数据一致
✅ 故障容灾：单个节点故障不影响其他节点，系统自动重试同步

技术特点：

🔄 双向同步：支持任意数量节点间的数据双向同步
📦 批量同步：多条记录打包同步，大幅提升效率
🔐 安全可靠：API Key 验证，支持 HTTPS 加密传输
📁 文件同步：自动同步媒体文件（图片、资源等）
🔁 自动重试：同步失败自动重试，确保数据不丢失
📊 同步监控：完整的同步日志和状态跟踪

适用场景：

中国管理节点 + 美国/欧洲/亚洲等多个销售节点
不同国家/地区独立运营，数据统一管理
需要本地化服务但统一数据源的场景

🤖 AI 自动翻译系统

功能特点：

🌐 多语言支持：支持 8 种语言自动翻译（中文、英文、西班牙语、法语、日语、韩语、德语、俄语）
📝 内容翻译：自动翻译商品信息、文章内容、分类描述等
🎯 智能识别：自动识别 HTML 内容，保留标签结构
⚡ 批量处理：支持批量翻译，提升效率
🔄 状态跟踪：翻译状态实时跟踪（待翻译、翻译中、已完成、失败）

技术实现：

集成 Ollama 本地 AI 模型，无需第三方 API
支持自定义翻译提示词，优化翻译质量
异步队列处理，不阻塞主流程

🛒 Chrome 插件商品采集

功能特点：

🛍️ 1688 商品采集：一键采集 1688 商品信息
📸 图片自动下载：自动下载商品图片并上传到服务器
🌐 多语言处理：自动提取中文信息，准备翻译
📋 批量导入：支持批量商品导入
🔄 数据同步：采集的商品自动同步到所有节点

使用场景：

从 1688 等平台快速采集商品
批量导入商品到电商平台
自动化商品管理流程

🛍️ 完整电商功能

产品管理：多规格、多图片、多语言产品信息
分类系统：灵活的层级分类和属性筛选
购物车：实时购物车功能
订单管理：完整的订单流程和状态跟踪
支付集成：支持 PayPal 等多种支付方式
促销系统：灵活的促销规则和优惠券
用户系统：用户注册、登录、个人中心
内容管理：多语言文章系统
SEO 优化：自动生成 SEO 标签

🎨 现代化管理后台

Filament 3.x：基于 Laravel 的现代化管理面板
实时数据统计：销售数据、用户统计等
多语言管理：统一管理所有语言内容
媒体管理：图片上传、优化、管理
系统设置：灵活的配置管理

🚀 技术栈

后端技术

Laravel 11.x - PHP Web 框架
PHP 8.1+ - 服务器端语言
MySQL 8.0+ - 数据库
Redis - 缓存和会话存储
Laravel Octane - 高性能应用服务器

前端技术

Tailwind CSS 3.x - 实用优先的 CSS 框架
Livewire 3.x - 全栈框架
Alpine.js - 轻量级 JavaScript 框架
Vite - 现代前端构建工具

管理后台

Filament 3.x - Laravel 管理面板
自定义组件 - 针对业务定制的管理组件

其他工具

Laravel Media Library - 媒体文件管理
Laravel Scout - 全文搜索
Laravel Queue - 队列处理
Laravel Notifications - 通知系统
Ollama - 本地 AI 模型（用于翻译）

📦 快速开始

环境要求

PHP >= 8.1
Composer
Node.js >= 16.x
MySQL >= 8.0
Redis
Ollama (可选，用于 AI 翻译)

安装步骤

克隆项目

git clone https://gitee.com/teanary/teanary_service.git
cd teanary_service

git clone https://github.com/TeanaryService/teanary_srvice.git
cd teanary_service

安装依赖
```
composer install
npm install
```

环境配置

cp .env.example .env
php artisan key:generate

配置数据库
编辑 .env 文件：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=teanary
DB_USERNAME=your_username
DB_PASSWORD=your_password

配置多节点同步（可选）
```
SYNC_ENABLED=true
SYNC_NODE=node1
```

配置其他节点

SYNC_NODE2_URL=node2.example.com
SYNC_NODE2_API_KEY=your-secret-api-key
SYNC_NODE2_TIMEOUT=600


6. **运行数据库迁移**
```bash
php artisan migrate
php artisan db:seed

构建前端资源
```
npm run build
```
启动开发服务器
```
php artisan serve
```

访问 http://localhost:8000 查看网站。

🌐 多节点部署指南

场景示例

场景 1：中国管理 + 全球销售节点

中国节点（管理节点）
├── 美国节点（销售节点）
├── 欧洲节点（销售节点）
└── 亚洲节点（销售节点）

场景 2：多地区独立运营

北京节点
├── 上海节点
├── 广州节点
└── 深圳节点

配置步骤

在每个节点配置环境变量

# 节点 1 配置
SYNC_ENABLED=true
SYNC_NODE=beijing
SYNC_BEIJING_URL=https://beijing.example.com
SYNC_BEIJING_API_KEY=key-for-beijing
SYNC_SHANGHAI_URL=https://shanghai.example.com
SYNC_SHANGHAI_API_KEY=key-for-shanghai

节点 2 配置

SYNC_ENABLED=true
SYNC_NODE=shanghai
SYNC_BEIJING_URL=beijing.example.com
SYNC_BEIJING_API_KEY=key-for-beijing
SYNC_SHANGHAI_URL=shanghai.example.com
SYNC_SHANGHAI_API_KEY=key-for-shanghai


2. **配置雪花 ID 机器 ID**
每个节点必须配置不同的机器 ID：
```env
SNOWFLAKE_MACHINE_ID=1  # 节点 1
SNOWFLAKE_MACHINE_ID=2  # 节点 2

启动队列处理
```
php artisan queue:work
```

详细配置请参考 SYNC.md

📡 API 文档

商品上传接口

接口地址: POST /api/products/add

功能: 上传商品，支持多语言、多规格、分类自动创建、图片上传

请求示例:

curl -X POST https://your-domain.com/api/products/add \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-token" \
  -d '{
    "slug": "product-slug",
    "translations": [
      {
        "language_id": 1,
        "name": "商品名称",
        "description": "商品描述"
      }
    ],
    "variants": [
      {
        "sku": "SKU-001",
        "price": 99.99,
        "stock": 100
      }
    ]
  }'

文章上传接口

接口地址: POST /api/articles/add

功能: 上传文章，支持多语言、图片上传

详细 API 文档请参考代码中的接口定义。

📄 开源协议

本项目采用 AGPL-3.0 (GNU Affero General Public License v3.0) 开源协议。

协议要点

您可以：

✅ 自由使用、研究、修改代码
✅ 自由分发代码
✅ 用于商业项目

您必须：

⚠️ 如果修改代码并部署为网络服务，必须公开修改后的源代码
⚠️ 保留原始版权声明和协议声明
⚠️ 使用相同的协议发布衍生作品

您不能：

❌ 修改代码后作为闭源商业产品售卖
❌ 移除版权声明

为什么选择 AGPL？

保护开源项目的完整性
防止将开源项目包装成闭源商业产品
鼓励贡献回社区

完整协议内容请查看 LICENSE 文件。

🤝 贡献指南

我们欢迎社区贡献！请遵循以下步骤：

Fork 项目
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建 Pull Request

代码规范

遵循 PSR-12 编码标准
使用有意义的变量和函数名
添加适当的注释
编写单元测试
运行代码质量检查：composer check

📊 项目结构

teanary_service/
├── app/
│   ├── Console/          # 控制台命令
│   ├── Enums/           # 枚举类
│   ├── Filament/        # Filament管理面板
│   ├── Http/            # HTTP控制器
│   ├── Jobs/            # 队列任务
│   ├── Livewire/        # Livewire组件
│   ├── Models/          # 数据模型
│   ├── Services/        # 业务服务
│   │   └── SyncService.php  # 多节点同步服务
│   └── Traits/          # 特征类
│       └── Syncable.php     # 同步功能 Trait
├── config/
│   └── sync.php         # 同步配置
├── database/
│   ├── migrations/      # 数据库迁移
│   └── seeders/         # 数据填充
├── lang/                # 多语言文件（8种语言）
├── routes/              # 路由定义
└── tests/               # 测试文件

🧪 测试

# 运行所有测试
composer test

# 运行单元测试
php bin/phpunit tests/Unit/

# 运行功能测试
php bin/phpunit tests/Feature/

📚 相关文档

多节点同步文档 - 详细的多节点同步配置和使用指南
代码优化文档 - 代码架构和优化说明
部署指南 - 生产环境部署说明

🌐 部署指南

高性能部署（推荐）

本项目已配置 Laravel Octane 高性能部署。

首次部署：

vendor/bin/dep deploy:first teanary

常规部署：

vendor/bin/dep deploy teanary

详细部署说明请参考 README 中的部署章节。

Teanary - 让全球电商运营更简单 🌍

本作品采用《CC 协议》，转载必须注明作者和本文链接

teanary

12 声望

暂无个人描述~

3 人点赞

从零开发一个电商项目，功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等

从小程序个人账户申请开始，带你一步步进行开发一个微信小程序，直到提交微信控制台上线发布。

讨论数量: 10

august567

课程读者 10 声望

官网不错是用什么做的

3周前评论

teanary （楼主）

你说的是那个？teanary.com/index.html 这个是项目介绍页，只是个静态页；不带index.html 是用laravel12做的呢

SiuhoY

20 声望

这个AI自动翻译系统是怎么实现的呀？

3周前评论

teanary （楼主）

翻译端在另一个仓库（开源但不公开）；调用ollama接口，翻译基准语言，翻译完成后回写到对应的translates表，触发同步；商城端再同步到所有节点

Runtoweb3

课程读者 338 声望

有吃螃蟹的人么

2周前评论

teanary （楼主）

不要紧嘛，欢迎fork，欢迎start;欢迎拉到本地跑一下，提issues;

Runtoweb3 （作者）

@teanary 我这是要上产品，直接开干，现在是用wordpress+woo

teanary （楼主）

@Runtoweb3 问题不大

Runtoweb3 （作者）

@teanary 你这个支持Octane部署么，习惯了使用docker部署，不想走php-fpm那一套了

teanary （楼主）

@Runtoweb3 octane不是基本操作嘛，gitee.com/teanary/teanary_service/...

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容，与人为善，比聪明更重要！

帮助

开源了一个自用的外贸商城(Teanary)

Teanary - 全球多节点电商平台系统

🌟 核心特性

🌍 多节点数据同步系统

🤖 AI 自动翻译系统

🛒 Chrome 插件商品采集

🛍️ 完整电商功能

🎨 现代化管理后台

🚀 技术栈

后端技术

前端技术

管理后台

其他工具

📦 快速开始

环境要求

安装步骤

配置其他节点

🌐 多节点部署指南

场景示例

配置步骤

节点 2 配置

📡 API 文档

商品上传接口

文章上传接口

📄 开源协议

协议要点

🤝 贡献指南

代码规范

📊 项目结构

🧪 测试

📚 相关文档

🌐 部署指南

高性能部署（推荐）

社区赞助商

关于 LearnKu

资源推荐

服务提供商

其他信息

开源了一个自用的外贸商城(Teanary)

Teanary - 全球多节点电商平台系统

🌟 核心特性

🌍 多节点数据同步系统

🤖 AI 自动翻译系统

🛒 Chrome 插件商品采集

🛍️ 完整电商功能

🎨 现代化管理后台

🚀 技术栈

后端技术

前端技术

管理后台

其他工具

📦 快速开始

环境要求

安装步骤

配置其他节点

🌐 多节点部署指南

场景示例

配置步骤

节点 2 配置

📡 API 文档

商品上传接口

文章上传接口

📄 开源协议

协议要点

🤝 贡献指南

代码规范

📊 项目结构

🧪 测试

📚 相关文档

🌐 部署指南

高性能部署（推荐）

社区赞助商

关于 LearnKu

资源推荐

服务提供商

其他信息

请登录