# 包装商城发货助手

> 轻量级订单发货客户端，专为子账号管理员设计

## 功能特性

- ✅ 手机号登录（API工厂认证）
- ✅ 订单列表查看（本地SQLite缓存）
- ✅ 订单同步（增量/全量）
- ✅ 单个订单发货
- ✅ 批量发货（并发控制）
- ✅ 导出待发货订单Excel
- ✅ 导入快递单号批量发货
- ✅ 离线查看缓存订单

## 技术栈

| 组件 | 技术 | 版本 |
|-----|------|------|
| 桌面框架 | WPF | .NET Framework 4.6.2 |
| 架构模式 | MVVM | CommunityToolkit.Mvvm 8.2 |
| 本地数据库 | SQLite | System.Data.SQLite 1.0.118 |
| Excel处理 | ClosedXML | 0.102.2 |
| JSON处理 | Newtonsoft.Json | 13.0.3 |

## 系统要求

- **操作系统**: Windows 7 SP1 或更高版本
- **运行时**: .NET Framework 4.6.2（Win7 SP1 原生支持）
- **磁盘空间**: ~10MB

## 开发环境

- Visual Studio 2019+ 或 .NET SDK 8.0+
- .NET Framework 4.6.2+ 开发工具

## 编译步骤

### 方式一：命令行编译（推荐）

```bash
# 还原依赖并编译
dotnet build PackagingMallShipper.sln -c Release

# 输出文件位于
bin/Release/net462/PackagingMallShipper.exe
```

### 方式二：Visual Studio

1. 使用 Visual Studio 2019+ 打开 `PackagingMallShipper.sln`
2. 还原 NuGet 包
3. 选择 `Release` 配置
4. 生成解决方案
5. 输出文件位于 `bin/Release/net462/` 目录

## 配置说明

编辑 `App.config` 配置API参数：

```xml
<appSettings>
  <!-- API工厂配置 -->
  <add key="ApiBaseUrl" value="https://api.it120.cc" />
  <add key="SubDomain" value="let5see" />
  
  <!-- 同步配置 -->
  <add key="SyncPageSize" value="50" />
  <add key="ShipConcurrency" value="3" />
</appSettings>
```

## 数据存储

本地数据库位置：`%LOCALAPPDATA%\PackagingMallShipper\data.db`

## 使用流程

1. **登录** - 使用API工厂子账号登录
   - 输入用户名或手机号
   - 输入密码
   - 输入图形验证码（点击图片可刷新）
   - 首次登录建议勾选"记住用户名"
2. **同步订单** - 点击"同步订单"获取最新订单
3. **查看订单** - 切换状态筛选，搜索订单
4. **发货方式一** - 导出Excel → 填写快递信息 → 导入发货
5. **发货方式二** - 选择订单 → 填写快递信息 → 单个发货

## 项目结构

```
PackagingMallShipper/
├── Models/          # 数据模型
├── ViewModels/      # 视图模型（MVVM）
├── Views/           # XAML视图
├── Services/        # 业务服务
├── Data/            # 数据访问层
├── Helpers/         # 工具类
├── Converters/      # 值转换器
└── Resources/       # 资源文件
```

## 相关文档

- [技术方案文档](../enterprise-management/docs/轻量级订单发货客户端方案.md)