chore: happy 出口通初始提交（前端 React + 后端 Express，采购管理已原生化）

2026-09-10 16:16:59 +08:00
commit d8df2c3960
34 changed files with 9343 additions and 0 deletions
@@ -0,0 +1,144 @@
+# 外贸供应链管理系统
+
+一个专为外贸企业设计的供应链与客户管理系统。
+
+## 功能模块
+
+### 业务管理
+- **工作台** - 数据汇总、日程提醒、节日显示
+- **供应商价格管理** - 继承 SKU Manager 完整功能
+- **产品管理** - SKU/SPU 两层管理、包装参数、阶梯价格
+- **PI合同管理** - 合同解析、价格历史追踪
+
+### 客户管理
+- **客户管理** - 客户信息、联系人、跟进记录
+- **新客开发** - 自动获客、AI 智能分析
+- **商机管理** - 销售管道、成交预测
+- **订单管理** - 订单跟踪、备注跟进
+
+## 技术栈
+
+### 后端
+- Node.js + Express
+- SQLite + better-sqlite3-multiple-ciphers
+- 加密存储（SQLCipher）
+
+### 前端
+- React 18
+- React Router
+- Vite
+- 原生 CSS
+
+## 快速开始
+
+### 安装依赖
+
+```bash
+# 后端
+cd backend
+npm install
+
+# 前端
+cd frontend
+npm install
+```
+
+### 启动开发环境
+
+```bash
+# 启动后端服务器（终端1）
+cd backend
+npm start
+
+# 启动前端开发服务器（终端2）
+cd frontend
+npm run dev
+```
+
+### 访问系统
+
+- 前端开发地址: http://127.0.0.1:5300
+- 后端 API 地址: http://127.0.0.1:4300
+
+### 默认账号
+
+- 用户名: `admin`
+- 密码: `admin123`
+
+**⚠️ 首次登录后请立即修改密码！**
+
+## 项目结构
+
+```
+trade-management-system/
+├── backend/              # 后端
+│   ├── db/              # 数据库
+│   │   ├── schema.sql   # 数据库结构
+│   │   └── db.js        # 数据库连接
+│   ├── lib/             # 工具库
+│   ├── routes/          # API 路由
+│   ├── data/            # 数据存储目录
+│   ├── uploads/         # 上传文件
+│   ├── server.js        # 服务器入口
+│   └── package.json
+├── frontend/            # 前端
+│   ├── src/
+│   │   ├── components/  # 组件
+│   │   ├── pages/       # 页面
+│   │   ├── services/    # API 服务
+│   │   ├── styles/      # 样式
+│   │   ├── App.jsx      # 主应用
+│   │   └── main.jsx     # 入口文件
+│   ├── index.html
+│   ├── vite.config.js
+│   └── package.json
+├── docs/                # 文档
+└── README.md
+```
+
+## 数据库
+
+使用 SQLite + SQLCipher 加密存储：
+- 数据库文件: `backend/data/trade.db`
+- 自动初始化表结构
+- 支持备份和迁移
+
+## 开发计划
+
+### Phase 1：基础框架 ✅
+- [x] 项目结构搭建
+- [x] 数据库设计
+- [x] 前后端基础框架
+- [x] 工作台页面
+
+### Phase 2：供应商与产品管理
+- [ ] 迁移 SKU Manager 功能
+- [ ] 阶梯价格管理
+- [ ] 合同解析引擎
+- [ ] 产品图片管理
+
+### Phase 3：客户 CRM
+- [ ] 客户详细页面
+- [ ] 联系人管理
+- [ ] 商机管道视图
+- [ ] 跟进活动时间线
+
+### Phase 4：订单管理
+- [ ] 订单创建和编辑
+- [ ] 订单状态流转
+- [ ] 订单备注系统
+- [ ] PDF 导出
+
+### Phase 5：自动获客
+- [ ] 集成 GoodJob 获客引擎
+- [ ] 数据源适配
+- [ ] AI 智能分析
+- [ ] 线索转化
+
+## 许可证
+
+私有项目
+
+## 作者
+
+Wayne