# freight-clearance

**Repository Path**: liangjiami/freight-clearance

## Basic Information

- **Project Name**: freight-clearance
- **Description**: 货代清关
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 货运清关管理系统

一个基于 Vue 3 + TypeScript 构建的货运清关管理系统，提供完整的货运数据管理和 Excel 报表生成功能。

## 功能特性

- **用户认证**：提供登录功能，支持不同角色权限管理
- **基础数据管理**：
  - 地址管理
  - 价格管理
  - 产品管理
  - 货运管理
- **Excel 操作**：
  - Excel 报表生成
  - Excel 数据导入
- **数据可视化**：直观的表格数据展示和操作

## 技术栈

- **前端框架**：Vue 3
- **语言**：TypeScript
- **UI 组件**：Element Plus
- **状态管理**：Vuex/Pinia
- **网络请求**：Axios
- **路由管理**：Vue Router
- **图表可视化**：ECharts

## 项目结构

```
├── src/
│   ├── api/              # API 接口和模拟数据
│   │   ├── address.ts    # 地址相关数据
│   │   ├── login.ts      # 登录认证
│   │   ├── price.ts      # 价格数据
│   │   ├── product.ts    # 产品数据
│   │   └── shipment.ts   # 货运数据
│   ├── assets/           # 静态资源
│   ├── components/       # 公共组件
│   │   ├── common/       # 通用组件
│   │   ├── ExcelGenerate.vue
│   │   ├── Layout/       # 布局组件
│   │   ├── StepUpload/   # 步骤上传
│   │   ├── TableAction/  # 表格操作
│   │   └── UploadExcel/  # Excel 上传
│   ├── constants/        # 常量定义
│   ├── router/           # 路由配置
│   ├── store/            # 状态管理
│   ├── utils/            # 工具函数
│   ├── views/            # 页面视图
│   │   ├── BaseData/     # 基础数据页面
│   │   ├── FileGenerate/ # 文件生成
│   │   └── Login/        # 登录页面
│   ├── App.vue           # 根组件
│   └── main.ts           # 入口文件
├── index.html            # HTML 模板
├── package.json          # 项目依赖
├── tsconfig.json         # TypeScript 配置
└── vite.config.ts        # Vite 配置
```

## 安装与运行

### 环境要求

- Node.js 16+
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

## 使用说明

### 登录系统

系统提供了模拟用户登录功能，用户名和密码均为以下值之一：

- admin
- user
- test

### 基础数据管理

1. **地址管理**：管理货运相关的地址信息，支持国家和州省等数据筛选
2. **价格管理**：管理货运价格数据，支持多币种
3. **产品管理**：管理产品信息，包括品牌等属性
4. **货运管理**：管理货运单据，支持多种状态追踪

### Excel 操作

- **生成报表**：根据模板生成 Excel 报表文件
- **导入数据**：将 Excel 文件中的数据导入系统

## 主要组件

| 组件名称 | 功能描述 |
|---------|---------|
| ExcelGenerate | Excel 报表生成组件 |
| StepUpload | 分步上传组件 |
| TableAction | 表格操作按钮组件 |
| UploadExcel | Excel 文件上传组件 |
| Layout | 页面布局组件 |
| SearchInput | 搜索输入组件 |
| Dialog | 弹窗组件 |

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建一个 Pull Request

## 许可证

本项目基于 MIT 许可证开源。

## 联系方式

如有问题或建议，请通过项目 Issues 页面反馈。