chore: happy 出口通初始提交（前端 React + 后端 Express，采购管理已原生化）
This commit is contained in:
Drsakura
@@ -0,0 +1,154 @@
|
||||
# 项目开发指南
|
||||
|
||||
## 当前进度
|
||||
|
||||
✅ **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
|
||||
Reference in New Issue
Block a user