# 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 | 样式方案 | 实用优先，设计系统友好 |