# wp-front

**Repository Path**: lopinx/wp-front

## Basic Information

- **Project Name**: wp-front
- **Description**: Nuxt + WooCommerce
- **Primary Language**: PHP
- **License**: WTFPL
- **Default Branch**: main
- **Homepage**: https://buchmistrz.pl
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-02
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuickBuy - Premium Vaping E-Commerce

面向中东及全球市场的 Premium Vaping 电商平台。

## 技术栈

- **前端框架**: Vue 3.5 + Vite 6 + TypeScript
- **UI 组件库**: Naive UI
- **状态管理**: Pinia
- **国际化**: vue-i18n（9 种语言，含 RTL 阿拉伯语）
- **后端对接**: WooCommerce REST API（单后端）
- **PWA**: vite-plugin-pwa

## 快速开始

```bash
# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env.development
# 编辑 .env.development 填入 WooCommerce API 密钥和其他配置

# 启动开发服务器
pnpm dev
```

访问 http://localhost:3000

## 环境配置

在 `.env.development` 中配置以下必要变量：

| 变量 | 说明 | 示例 |
|------|------|------|
| `VITE_APP_NAME` | 网站名称 | Quick Buy |
| `VITE_APP_URL` | 站点 URL | https://your-store.com |
| `VITE_WC_URL` | WooCommerce 站点地址 | https://your-store.com |
| `VITE_WC_KEY` | WooCommerce Consumer Key | ck_xxx |
| `VITE_WC_SECRET` | WooCommerce Consumer Secret | cs_xxx |
| `VITE_SOCIAL_EMAIL` | 联系邮箱 | xxx@email.com |
| `VITE_SOCIAL_WHATSAPP` | WhatsApp 号码 | +971501234567 |

可选配置（统计等）参考 `.env.analytics.example`。

## 构建命令

```bash
pnpm build      # 生产构建（vue-tsc --noEmit && vite build）
pnpm typecheck  # TypeScript 类型检查
pnpm lint       # ESLint 检查与自动修复
pnpm preview    # 预览生产构建
```

## 多语言支持

当前支持 9 种语言：

| 代码 | 语言 | 方向 |
|------|------|------|
| en-AU | English (Australia) | LTR |
| pl-PL | Polish | LTR |
| ar-AE | Arabic (UAE) | RTL |
| en-AE | English (UAE) | LTR |
| cs-CZ | Czech | LTR |
| hu-HU | Hungarian | LTR |
| sk-SK | Slovak | LTR |
| zh-CN | Chinese Simplified | LTR |
| zh-TW | Chinese Traditional | LTR |

语言切换通过 Header 中的语言选择器实现，RTL 布局自动适配。

## 架构说明

- 一个前端对应一个 WooCommerce 后端
- 不同国家/市场通过前端 i18n 切换语言，后端配置保持不变
- 后端地址通过 `VITE_WC_URL` 环境变量配置
- 生产部署时，不同市场部署不同前端实例，每个实例配置对应的后端地址

## 目录结构

```
src/
├── pages/          # 页面路由
├── components/     # 组件
│   ├── layout/     # 布局组件（Header/Footer）
│   ├── analytics/  # Cookie 合规组件
│   └── skeleton/   # 骨架屏
├── stores/         # Pinia stores（cart、locale、products、theme、user）
├── composables/    # 组合式函数
├── locales/        # 9 种语言 JSON 文件
├── analytics/      # GA4 / 51LA / 百度统计接入
└── utils/          # 工具函数
```

## 仓库地址

- Gitee：https://gitee.com/lopinx/wp-front
- Issues：https://gitee.com/lopinx/wp-front/issues

## 问题反馈

遇到问题请优先在 [Gitee Issues](https://gitee.com/lopinx/wp-front/issues) 提交 bug 报告或功能请求。

## 贡献指南

详见 [.gitee/CONTRIBUTING.md](.gitee/CONTRIBUTING.md)。