90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
# 包装商城发货助手
|
||
|
||
> 轻量级订单发货客户端，专为子账号管理员设计
|
||
|
||
## 功能特性
|
||
|
||
- ✅ 手机号登录（API工厂认证）
|
||
- ✅ 订单列表查看（本地SQLite缓存）
|
||
- ✅ 订单同步（增量/全量）
|
||
- ✅ 单个订单发货
|
||
- ✅ 批量发货（并发控制）
|
||
- ✅ 导出待发货订单Excel
|
||
- ✅ 导入快递单号批量发货
|
||
- ✅ 离线查看缓存订单
|
||
|
||
## 技术栈
|
||
|
||
| 组件 | 技术 | 版本 |
|
||
|-----|------|------|
|
||
| 桌面框架 | WPF | .NET Framework 4.8 |
|
||
| 架构模式 | 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.8（Win7已内置，无需额外安装）
|
||
- **磁盘空间**: ~10MB
|
||
|
||
## 开发环境
|
||
|
||
- Visual Studio 2019 Community
|
||
- .NET Framework 4.8 开发工具
|
||
|
||
## 编译步骤
|
||
|
||
1. 使用 Visual Studio 2019 打开 `PackagingMallShipper.sln`
|
||
2. 还原 NuGet 包
|
||
3. 选择 `Release` 配置
|
||
4. 生成解决方案
|
||
5. 输出文件位于 `bin/Release/` 目录
|
||
|
||
## 配置说明
|
||
|
||
编辑 `App.config` 配置API参数：
|
||
|
||
```xml
|
||
<appSettings>
|
||
<!-- API工厂配置 -->
|
||
<add key="ApiBaseUrl" value="https://user.api.it120.cc" />
|
||
<add key="SubDomain" value="vv125s" />
|
||
|
||
<!-- 同步配置 -->
|
||
<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)
|