# 项目开发指南

## 当前进度

✅ **Phase 1 已完成：基础框架搭建**

### 已完成的工作

1. **项目结构**
   - 前后端分离架构
   - 标准化目录结构
   - 开发环境配置

2. **数据库设计**
   - 完整的表结构设计
   - 索引优化
   - SQLite + SQLCipher 加密

3. **后端 API**
   - Express 服务器
   - 数据库连接层
   - 基础 CRUD 接口
   - 健康检查接口

4. **前端页面**
   - React + React Router
   - 6个核心页面：
     - 工作台（Dashboard）
     - 供应商管理
     - 产品管理
     - 客户管理
     - 订单管理
     - 新客开发
   - 响应式布局
   - 完整的样式系统

## 下一步工作

### 立即可做

1. **安装依赖并启动**
   ```bash
   cd D:\wayne\Personal\trade-management-system
   
   # 安装后端依赖
   cd backend
   npm install
   
   # 安装前端依赖
   cd ..\frontend
   npm install
   
   # 或者直接双击 start.bat
   ```

2. **测试基础功能**
   - 访问 http://127.0.0.1:5300
   - 测试供应商和客户的增删改查
   - 检查工作台数据展示

### 短期规划（1-2周）

1. **迁移 SKU Manager 核心功能**
   - 复制合同解析引擎
   - 复制产品管理逻辑
   - 复制图片处理功能
   - 复制 AI 配置模块

2. **完善供应商管理**
   - 供应商详情页
   - 阶梯价格表录入
   - 报价记录管理
   - 导入导出功能

3. **完善产品管理**
   - 产品详情页
   - SKU/SPU 两层管理
   - 包装参数编辑
   - 产品图片上传

### 中期规划（3-4周）

1. **客户 CRM**
   - 客户详情页
   - 联系人管理
   - 跟进记录时间线
   - 商机管道视图

2. **订单管理**
   - 订单创建向导
   - 订单详情页
   - 订单状态流转
   - 订单备注系统

3. **报价单生成**
   - 客户报价单
   - PDF 导出
   - 模板定制

### 长期规划（1-2个月）

1. **自动获客**
   - 集成 GoodJob 获客引擎
   - 数据源适配器
   - AI 智能分析
   - 线索转化流程

2. **高级功能**
   - 权限管理系统
   - 数据分析报表
   - 导入导出优化
   - 移动端适配

## 技术决策记录

### 为什么选择 SQLite？
- 单文件数据库，备份简单
- 支持加密（SQLCipher）
- 适合中小规模（10万级数据）
- 零配置，易于部署

### 为什么选择 React？
- 组件化开发效率高
- 生态系统成熟
- 与 GoodJob 技术栈一致

### 为什么不用现成的 ERP？
- ERPNext 过于复杂，定制成本高
- 需要高度定制化的业务流程
- 完全掌控代码和数据

## 常见问题

### Q: 如何备份数据？
A: 直接复制 `backend/data/trade.db` 文件

### Q: 如何迁移到 MySQL？
A: 修改 `backend/db/db.js` 使用 mysql2 驱动

### Q: 如何部署到服务器？
A: 
1. 后端：`npm start` 或 PM2
2. 前端：`npm run build` 后用 Nginx 托管
3. 配置反向代理

### Q: 如何集成 SKU Manager？
A: 
1. 复制 `lib/` 目录下的解析器
2. 复制 `parsers/` 目录
3. 调整数据库表结构对应关系

## 联系方式

项目负责人：Wayne