0763a2623b
- 添加验证码登录支持（图形验证码显示和输入） - 修复订单同步，正确解析收件人信息（从logisticses合并） - 修复API端点配置（user.api.it120.cc） - 添加Costura.Fody实现单文件EXE打包 - 添加应用图标（app.ico） - 添加Inno Setup安装脚本（支持Win7+） - 暂时禁用导入发货功能 - 添加.gitignore文件 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
106 lines
2.7 KiB
Markdown
106 lines
2.7 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+ 或 .NET SDK 8.0+
|
||
- .NET Framework 4.8 开发工具
|
||
|
||
## 编译步骤
|
||
|
||
### 方式一：命令行编译（推荐）
|
||
|
||
```bash
|
||
# 还原依赖并编译
|
||
dotnet build PackagingMallShipper.sln -c Release
|
||
|
||
# 输出文件位于
|
||
bin/Release/net48/PackagingMallShipper.exe
|
||
```
|
||
|
||
### 方式二：Visual Studio
|
||
|
||
1. 使用 Visual Studio 2019+ 打开 `PackagingMallShipper.sln`
|
||
2. 还原 NuGet 包
|
||
3. 选择 `Release` 配置
|
||
4. 生成解决方案
|
||
5. 输出文件位于 `bin/Release/net48/` 目录
|
||
|
||
## 配置说明
|
||
|
||
编辑 `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)
|