# express-front

**Repository Path**: nandazzia/express-front

## Basic Information

- **Project Name**: express-front
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 快递

## README

# US Parcel System

一个基于 Vue 3 和 Vite 构建的现代化快递/包裹系统前端项目。

## 技术栈
- Vue 3
- Vite
- Vue Router
- Pinia（状态管理）
- TailwindCSS
- Chart.js（数据可视化）
- i18next（国际化）
- Stripe（支付集成）
- Axios（API 请求）

## 主要功能
- 用户认证（登录/注册、修改密码/邮箱）
- 订单管理（创建、查看、支付、追踪）
- 地址管理
- 账单与发票
- 管理员后台
- 多语言支持
- 响应式设计
- 数据可视化
- 帮助中心与客服

## 目录结构
```
src/
├── api/          # API 接口
├── assets/       # 静态资源
├── components/   # 公共组件
├── router/       # 路由配置
├── views/        # 页面视图
│   ├── orders/   # 订单相关页面
│   ├── dashboard/# 用户/管理员中心
│   ├── addresses/# 地址管理
│   ├── billing/  # 账单与发票
│   ├── support/  # 帮助中心
│   ├── auth/     # 认证页面
│   ├── contact/  # 联系我们
│   ├── policies/ # 政策页面
│   └── ...
├── App.vue       # 根组件
└── main.js       # 入口文件
```

## 安装与使用

1. 克隆项目
```bash
git clone [仓库地址]
cd us-parcel-system
```
2. 安装依赖
```bash
yarn install
```
3. 启动开发服务器
```bash
yarn dev
```
4. 构建生产版本
```bash
yarn build
```

## 环境变量
在项目根目录创建 `.env` 文件：
```env
VITE_API_BASE_URL=你的API地址
VITE_STRIPE_PUBLIC_KEY=你的Stripe公钥
```

## 主要页面与逻辑
- `/login` - 用户登录
- `/register` - 用户注册
- `/dashboard` 或 `/account` - 用户中心
- `/orders/new` - 创建新订单
- `/orders` - 订单列表
- `/orders/:id` - 订单详情与追踪
- `/orders/:id/confirmation` - 订单确认页面（下单成功后跳转，显示订单详情与支付入口等）
- `/orders/guest/:id/confirmation` - 游客下单确认页面
- `/billing` - 账单与发票
- `/addresses` - 地址管理
- `/support` - 帮助中心
- `/contact` - 联系我们
- `/admin` - 管理员后台
- `/terms`, `/privacy`, `/refund` - 政策页面
- **Services 跳转说明**：导航栏和底部的"Services"链接，未登录时跳转到登录页，已登录时跳转到"我的账户"页面。

## 主要依赖（来自 package.json）
- Vue: ^3.4.29
- Vite: ^5.3.1
- Vue Router: ^4.2.5
- Pinia: ^2.1.7
- TailwindCSS: ^3.4.1
- Chart.js: ^4.4.1
- i18next: ^23.8.2
- Axios: ^1.6.7
- Stripe: ^7.3.0

## 部署说明
1. 构建项目：
```bash
yarn build
```
2. 将 `dist` 目录下的文件部署到你的 Web 服务器。

## 许可证
[请在此处补充你的许可证信息]

## 数据说明

- 本项目所有页面和功能均已对接真实后端API，已彻底取消所有mock（模拟）数据。
- 所有订单、用户、账单、地址等数据均通过接口与后端实时交互，确保数据的真实性和一致性。