1.5 技术栈说明

概述

本页列出项目前后端完整技术选型与版本要求，包含语言、框架、核心依赖及其选型理由，评估兼容性或升级影响时对照本表。

后端技术栈

类别	技术选型	版本	说明
语言	PHP	>= 8.2	强类型严格模式
框架	ThinkPHP	6.1.x	核心 Web 框架
ORM	think-orm	2.0	数据库操作
认证	firebase/php-jwt	6.4+	JWT 令牌签发与验证
Excel	phpoffice/phpspreadsheet	5.10+	Excel 导入导出
数据库	MySQL	5.7+ / 8.0+	主数据库
缓存	Redis	6.0+	可选，缓存驱动
Web 服务器	Nginx	1.18+	推荐
Web 服务器	Apache	2.4+	兼容

前端技术栈

类别	技术选型	版本	说明
框架	Vue	3.5+（实际 ^3.5.1）	核心 UI 框架
语言	TypeScript	4.9+（实际 ^4.9.5）	类型安全
UI 库	NaiveUI	2.40+（实际 ^2.40.0）	组件库
构建工具	Vite	5.4+（实际 ^5.4.3）	开发服务器与构建
状态管理	Pinia	2.2+（实际 ^2.2.2）	全局状态管理
路由	Vue Router	4.4+（实际 ^4.4.3）	路由管理
HTTP	Axios	1.7+（实际 ^1.7.7）	HTTP 请求
富文本	TinyMce / Quill	5.10+	富文本编辑器
图表	ECharts	5.5+	数据可视化
CSS	TailwindCSS + Less	3.4+	原子化 CSS 与预处理
包管理	pnpm	-	高效包管理器

架构特点

┌─────────────────────────────────────────────────────────┐
│                    前端（Vue3 + NaiveUI）                 │
│              通过 API 调用后端服务，纯 JSON 交互          │
└──────────────────────────┬──────────────────────────────┘
                           │ HTTP (JSON)
                           ▼
┌─────────────────────────────────────────────────────────┐
│                    后端（ThinkPHP 6.1）                  │
│                                                         │
│  路由 → 中间件栈 → 控制器 → 逻辑层 → 模型 → 数据库      │
│                                                         │
│  中间件栈：                                              │
│  CORS → Auth(JWT+权限) → Tenant(租户) → Demo → Log     │
└──────────────────────────┬──────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                    数据层（MySQL + Redis）                │
│              MySQL 主存储，Redis 可选缓存                 │
└─────────────────────────────────────────────────────────┘