一个专业的报关单制作系统，支持预报单和最终报关单的制作，具有Excel文件上传、自动匹配HS CODE、自动计算关税等功能。

功能特性

核心功能

- **报关单制作**：支持预报单和最终报关单两种类型

- **Excel文件上传**：

  - 发票Excel表格：自动匹配HS CODE、数量、单价、总金额、关税金额

  - 装箱单Excel表格：自动匹配数量、件数、重量、体积

- **HS CODE管理**：支持Excel导入HS CODE数据库，自动匹配关税税率

- **自动计算**：根据HS CODE自动计算关税金额

- **日期处理**：自动生成公历日期和伊斯兰历日期

- **数据存储**：SQLite数据库存储，支持数据持久化

技术架构

- **后端**：Python + FastAPI + SQLAlchemy

- **前端**：Vue 3 + Element Plus

- **数据库**：SQLite（支持MySQL/PostgreSQL）

- **文件处理**：pandas + openpyxl

安装部署

后端部署

1. **克隆项目**

   ```bash

   git clone <项目地址>

   cd customs_declaration/backend

   ```

2. **安装依赖**

   ```bash

   pip install -r requirements.txt

   ```

3. **启动服务**

   ```bash

   uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

   ```

前端部署

1. **安装依赖**

   ```bash

   cd ../frontend

   npm install

   ```

2. **启动开发服务器**

   ```bash

   npm run dev

   ```

3. **构建生产版本**

   ```bash

   npm run build

   ```

使用指南

1. 导入HS CODE数据库

- 准备包含以下列的Excel文件：

  - `code`：HS CODE编码

  - `description`：商品描述

  - `arabic_description`：阿拉伯语描述（可选）

  - `duty_rate`：关税税率（小数形式，如0.1表示10%）

- 在系统中点击"HS CODE管理" -> "导入HS CODE"

2. 创建报关单

- 进入"创建报关单"页面

- 填写报关单基本信息：类型、提单号、发票号、收货人、发货人

- 上传发票Excel文件（包含hs_code、description、quantity、unit、unit_price列）

- 上传装箱单Excel文件（包含hs_code、quantity、package_count、weight、volume列）

- 系统会自动匹配HS CODE、计算关税金额

- 点击"提交"按钮创建报关单

3. 管理报关单

- 在"报关单列表"页面查看所有报关单

- 点击"查看"按钮查看报关单详情

API文档

后端API文档可通过访问 `http://localhost:8000/docs` 查看。

主要API端点：

- **报关单API**：`/api/customs/declarations/*`

- **文件上传API**：`/api/customs/upload/*`

- **HS CODE API**：`/api/customs/hscode/*`

注意事项

1. **Excel文件格式**：

   - 发票Excel：必须包含hs_code、description、quantity、unit、unit_price列

   - 装箱单Excel：必须包含hs_code、quantity、package_count、weight、volume列

   - HS CODE Excel：必须包含code、description、duty_rate列

2. **HS CODE匹配**：

   - 系统会根据Excel中的hs_code字段自动匹配数据库中的HS CODE

   - 如未找到匹配的HS CODE，关税税率默认为0

3. **日期处理**：

   - 系统自动生成公历日期和伊斯兰历日期

   - 伊斯兰历日期为简化计算，实际项目中可使用更精确的转换库

4. **数据安全**：

   - 建议在生产环境中使用MySQL或PostgreSQL数据库

   - 建议配置适当的访问控制

 故障排查

1. **文件上传失败**：

   - 检查文件格式是否正确

   - 检查文件大小是否超过10MB

2. **HS CODE匹配失败**：

   - 检查Excel中的hs_code格式是否正确

   - 检查HS CODE数据库是否已导入

3. **系统错误**：

   - 查看服务器日志获取详细错误信息

   - 检查数据库连接是否正常