From 5366c5683001ebe9726334fc9808463a66405948 Mon Sep 17 00:00:00 2001
From: empty <let5sne.mac@gmail.com>
Date: Wed, 17 Dec 2025 13:54:11 +0800
Subject: [PATCH] first commit

---
 README.md | 89 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e2df600
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+# 包装商城发货助手
+
+> 轻量级订单发货客户端，专为子账号管理员设计
+
+## 功能特性
+
+- ✅ 手机号登录（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)