# 技术栈

## 版本信息
| 版本 | 日期 | 描述 | 作者 |
|------|------|------|------|
| 3.0 | 2025-10-20 | 集团AI智能进销存系统技术栈 | Winston |

## 后端技术栈
| 类别 | 技术 | 版本 | 用途 | 备注 |
|------|------|------|------|------|
| 运行时 | Node.js | 20.19.2 | 服务器运行时环境 | ES模块支持 |
| 框架 | Hono | 4.8.5 | Web框架和API路由 | RPC类型安全 |
| 数据库 | PostgreSQL | 17 | 数据持久化存储 | 多租户支持 |
| ORM | TypeORM | 0.3.25 | 数据库操作抽象 | 实体管理 |
| 缓存 | Redis | 7 | 会话和数据缓存 | 性能优化 |
| 存储 | MinIO | latest | 对象存储服务 | 文件管理 |
| 验证 | Zod | 4.x | Schema验证 | 类型安全 |
| 认证 | JWT | 9.0.2 | 用户认证和安全 | Bearer Token |
| 文档 | @hono/zod-openapi | latest | OpenAPI文档生成 | Swagger UI |

## 前端技术栈（Web）
| 类别 | 技术 | 版本 | 用途 | 备注 |
|------|------|------|------|------|
| 框架 | React | 19.1.0 | 用户界面构建 | 最新版本 |
| 构建工具 | Vite | 7.0.0 | 开发服务器和构建 | 热重载支持 |
| 路由 | React Router | v7 | 前端路由管理 | 声明式路由 |
| 状态管理 | React Query | 5.83.0 | 服务端状态管理 | 数据同步 |
| UI组件 | shadcn/ui | latest | 组件库 | 基于Radix UI |
| 样式 | Tailwind CSS | 4.1.11 | 原子化CSS框架 | 设计一致性 |
| 类型检查 | TypeScript | 5.x | 类型安全 | 严格模式 |

## 小程序技术栈
| 类别 | 技术 | 版本 | 用途 | 备注 |
|------|------|------|------|------|
| 框架 | Taro | 4.1.4 | 多端小程序框架 | 一次开发多端运行 |
| UI框架 | React | 18.0.0 | 小程序UI构建 | 与Web端共享逻辑 |
| 状态管理 | @tanstack/react-query | 5.84.1 | 服务端状态管理 | 与Web端一致 |
| 表单处理 | react-hook-form | 7.62.0 | 表单状态管理 | 类型安全 |
| 验证 | Zod | 4.0.14 | Schema验证 | 与后端一致 |
| 样式 | Tailwind CSS | 4.1.11 | 原子化CSS框架 | 跨端样式 |

## AI服务集成
| 服务 | 用途 | 集成方式 | 数据流 |
|------|------|----------|--------|
| 销售预测 | 基于历史数据预测未来销售 | DeepSeek API + 提示词工程 | 销售数据 → DeepSeek → 预测结果 |
| 库存优化 | 智能库存分配和补货建议 | DeepSeek API + 提示词工程 | 库存数据 → DeepSeek → 优化建议 |
| 供应商匹配 | 基于采购需求推荐供应商 | DeepSeek API + 提示词工程 | 采购需求 → DeepSeek → 供应商推荐 |
| 客户分析 | 客户行为分析和信用评估 | DeepSeek API + 提示词工程 | 客户数据 → DeepSeek → 分析报告 |