happy-export/docs/DEVELOPMENT.md

项目开发指南

当前进度

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

已完成的工作

1. 项目结构

   • 前后端分离架构
   • 标准化目录结构
   • 开发环境配置

2. 数据库设计

   • 完整的表结构设计
   • 索引优化
   • SQLite + SQLCipher 加密

3. 后端 API

   • Express 服务器
   • 数据库连接层
   • 基础 CRUD 接口
   • 健康检查接口

4. 前端页面

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

下一步工作

立即可做

1. 安装依赖并启动

   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