3. Tech Stack

这是项目的最终技术选择。与用户合作确定所有选择。此表是单一事实来源 - 所有开发必须使用这些确切版本。

Technology Stack Table

类别	技术	版本	用途	理由
前端语言	TypeScript	5.0+	类型安全的React开发	提供完整的类型安全和开发体验
前端框架	React	19	用户界面构建	现代React特性，更好的性能
UI组件库	shadcn/ui	最新	管理后台UI组件	基于Tailwind的专业设计系统
状态管理	React Query (TanStack)	5	服务器状态管理	简化API数据管理和缓存
后端语言	TypeScript	5.0+	类型安全的Node.js开发	前后端类型一致性
后端框架	Hono	4	Web框架和API开发	轻量级、高性能、TypeScript友好
API风格	REST	-	API接口规范	简单、通用、工具生态丰富
数据库	MySQL	8.0.36	主数据存储	关系型数据库，成熟稳定
缓存	Redis	7	会话和缓存	高性能内存数据库
文件存储	MinIO	最新	对象存储	S3兼容，自托管方案
认证	JWT + bcrypt	最新	用户认证和授权	无状态认证，密码安全加密
前端测试	Vitest	最新	单元和组件测试	Vite生态，快速测试运行
后端测试	Vitest	最新	API和单元测试	统一测试工具链
E2E测试	Playwright	最新	端到端测试	跨浏览器测试支持
构建工具	Vite	7	前端构建和开发服务器	快速冷启动，优秀开发体验
打包工具	Vite	7	代码打包和优化	统一构建工具链
IaC工具	Docker Compose	最新	本地环境编排	容器化开发环境
CI/CD	GitHub Actions	-	自动化部署	与GitHub生态集成
监控	-	-	应用监控	后续阶段实现
日志	-	-	应用日志	后续阶段实现
CSS框架	Tailwind CSS	4	样式方案	实用优先，设计系统友好