技术架构

项目中用到的技术栈和解决方案

后端技术栈

核心框架

• FastAPI: 现代高性能的 Python Web 框架，支持异步编程和自动 API 文档生成
• Uvicorn: 基于 uvloop 的 ASGI 服务器，提供高性能的异步服务支持
• SQLAlchemy: 强大的 Python SQL 工具包和对象关系映射（ORM）框架
• Pydantic: 数据验证和设置管理库，提供类型安全的数据处理

数据存储

• MySQL: 主数据库，存储业务核心数据
• Redis: 缓存数据库，用于会话存储、缓存管理和分布式锁

安全认证

• JWT (JSON Web Token): 无状态的用户认证机制
• Python-JOSE: JWT 令牌的生成和验证

其他组件

• Jinja2: 模板引擎，用于服务端页面渲染
• Pillow: 图像处理库，支持图片上传和处理
• Aiohttp: 异步 HTTP 客户端，用于外部服务调用

前端技术栈

管理后台 (zi-admin)

• Vue 3: 渐进式 JavaScript 框架，采用 Composition API
• Element Plus: 基于 Vue 3 的企业级 UI 组件库
• TypeScript: 提供类型安全的开发体验
• Vite: 现代化的前端构建工具
• Pinia: Vue 3 官方推荐的状态管理库
• Vue Router: 单页应用路由管理
• Axios: HTTP 请求库

移动端应用 (zi-unibase)

• uni-app: 跨平台应用开发框架，支持多端发布
• Vue 3: 使用 Vue 3 语法进行开发
• uniCloud: 云端一体化开发平台

文档系统 (zi-docs)

• VitePress: 基于 Vite 的静态站点生成器
• Teek Theme: 功能丰富的 VitePress 主题
• Markdown: 文档编写格式