技术栈总览
核心原则
生成代码前必须检查此技术栈清单，确保使用的框架、库、工具版本与项目规范一致。
前端技术栈
| 类别 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | React | 19 | UI 框架 |
| 构建工具 | Vite | 7 | 开发构建 |
| UI 组件库 | shadcn/ui | latest | 可复用组件 |
| CSS 框架 | Tailwind CSS | 4 | 原子化样式 |
| 路由 | React Router | v7 | 客户端路由 |
| 状态管理 | Zustand | 5 | 全局状态 |
| 表单处理 | React Hook Form + Zod | latest | 表单验证 |
| 表格组件 | TanStack Table | v8 | 数据表格 |
| 语言 | TypeScript | 5.6 | 类型化 JavaScript |
| 代码检查 | Biome | latest | Linter + Formatter |
| 测试框架 | Vitest | latest | 单元测试 |
| 时间处理 | dayjs | latest | 日期时间库 |
后端技术栈
| 类别 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 语言 | Go | 1.25 | 编程语言 |
| Web 框架 | Echo | v4 | HTTP 路由和中间件 |
| ORM | GORM | v1.31 | 数据库 ORM |
| 包管理 | Go Modules | - | 依赖管理 |
数据库技术栈
| 类别 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 数据库 | MySQL | 8.0+ | 关系型数据库 |
| 存储引擎 | InnoDB | - | MySQL 存储引擎 |
| 迁移工具 | GORM AutoMigrate | - | 数据库迁移 |
开发工具
| 类别 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 前端格式化 | Biome | latest | 代码格式化和检查 |
| 后端格式化 | gofmt | - | Go 代码格式化 |
| 包管理（前端） | npm | - | 依赖管理 |
| 包管理（后端） | Go Modules | - | 依赖管理 |
| 版本控制 | Git | - | 代码版本管理 |
版本兼容性说明
前端
关键兼容性：
- React 19 必须配合 TypeScript 5.6+
- Vite 7 内置 TypeScript 和 React 支持
- shadcn/ui 必须配合 Tailwind CSS 4 使用
- React Router v7 兼容 React 19
- Zustand 5 支持 React 19 并发特性
后端
关键兼容性：
- Go 1.25 必须配合 Echo v4 和 GORM v1.31
- GORM v1.31 兼容 MySQL 8.0+
- Echo v4 与 Go 1.25 标准库完全兼容
数据库
关键兼容性：
- MySQL 必须使用 8.0 或更高版本
- 必须使用 InnoDB 存储引擎（禁止使用 MyISAM）
- GORM v1.31 与 MySQL 8.0+ 完全兼容
版本更新策略
原则：
- 禁止擅自升级主版本（major version）
- 应该及时应用安全补丁和小版本更新（patch version）
- 升级次版本（minor version）前必须经过测试验证