主题
技术专家文档
🏗️ 核心架构
生成的项目遵循模块化、分层架构设计，确保代码的可维护性与扩展性。
模块化设计
基于领域驱动设计 (DDD) 思想，业务逻辑高度解耦
多后端支持
NestJS, Spring Boot, FastAPI, Django 等主流框架深度集成
数据持久化
Prisma, Ktorm, SQLAlchemy 等 ORM 最佳实践，支持 PostgreSQL, MySQL, SQLite
DevOps 就绪
内置 Dockerfile 与 CI/CD 配置文件，一键部署
🛠️ 技术栈导航
后端框架
此处的 开发中 代表没有完全优化完成，但您依然可以使用
| 框架 | 语言 | 特点 | 状态 |
|---|---|---|---|
| NestJS NestJS | TypeScript | 企业级 Node.js 框架，模块化架构 | ✅ 已实现 |
| Express Express | TypeScript | 极简 Node.js 框架，灵活自由 | 🚧 开发中 |
| Spring Boot (Java) Spring Boot (Java) | Java | 企业级 Java 标准，生态成熟 | 🚧 开发中 |
| Spring Boot (Kotlin) Spring Boot (Kotlin) | Kotlin | 现代化 JVM 语言，简洁高效 | 🔮 计划中 |
| FastAPI FastAPI | Python | 高性能异步框架，自动文档 | 🚧 开发中 |
| Django Django | Python | "Batteries included" 全功能框架 | 🚧 开发中 |
| Mock Server Mock Server | JSON | 轻量 Mock API，快速原型 | ✅ 已实现 |
前端框架
| 框架 | 特点 | 状态 |
|---|---|---|
| Vue Vue 3 | 渐进式框架，易学易用，Composition API | ✅ 已实现 |
| React React | 组件化设计，生态丰富，Hooks | 🚧 开发中 |
数据库
| 数据库 | 特点 | 适用场景 |
|---|---|---|
| Postgresql PostgreSQL | 功能最强大的开源数据库 | 生产环境首选 |
| Mysql MySQL | 最流行的关系数据库 | 通用场景 |
| Sqlite SQLite | 轻量级嵌入式数据库 | 开发/小型项目 |
📦 ORM 框架
ORM (Object-Relational Mapping) 是连接应用程序与数据库的桥梁。不同后端框架搭配不同的 ORM：
Node.js 生态
| ORM | 适用框架 | 特点 |
|---|---|---|
| Prisma Prisma | NestJS, Express | 类型安全、自动迁移、现代化开发体验 |
| Drizzle | NestJS, Express | 轻量级、SQL-like 语法、极致性能 |
Java/Kotlin 生态
| ORM | 适用框架 | 特点 |
|---|---|---|
| Mybatis MyBatis Plus | Spring Boot | SQL 至上、灵活强大、中国最流行 |
| Jpa Spring Data JPA | Spring Boot | JPA 规范实现、开箱即用 |
| Ktorm | Spring Boot (Kotlin) | Kotlin 原生 ORM、DSL 风格 |
Python 生态
| ORM | 适用框架 | 特点 |
|---|---|---|
| Sqlalchemy SQLAlchemy | FastAPI | Python 最强 ORM、功能完备 |
| Django Django ORM | Django | 内置 ORM、快速开发 |
🔐 认证与授权
| 方案 | 适用框架 | 特点 |
|---|---|---|
| JWT 认证 | Node.js, Python | 无状态、分布式友好 |
| Sa-Token | Spring Boot | 轻量级 Java 鉴权框架 |
| Spring Security | Spring Boot | 企业级安全框架 |
🎨 UI 组件库
Vue 3 生态
| 组件库 | 风格 | 特点 |
|---|---|---|
| Naive UI Naive UI | 清新现代 | TypeScript 优先，主题强大 |
| PrimeVue PrimeVue | 专业商务 | 200+ 组件，功能最全 |
| shadcn-vue shadcn-vue | 极简优雅 | 复制即用，完全可控 |
| Ant Design Vue Ant Design Vue | 企业规范 | 阿里出品，设计统一 |
| Element Plus Element Plus | 稳重经典 | Element UI 升级版 |
| Vuetify Vuetify | Material | Google Material Design |
| Quasar Quasar | 跨平台 | 一套代码，多端运行 |
React 生态
| 组件库 | 风格 | 特点 |
|---|---|---|
| shadcn/ui shadcn/ui | 极简优雅 | Radix + Tailwind，可定制 |
| Ant Design Ant Design | 企业规范 | 阿里出品，生态丰富 |
| Mantine Mantine | 现代美观 | 功能丰富，开发体验优秀 |
| Chakra UI Chakra UI | 简洁现代 | 可访问性优先 |
| HeroUI HeroUI | 现代动效 | 原 NextUI，动画精美 |
| MUI (Material UI) MUI | Material | Google Material Design React 实现 |
🔗 技术兼容性速查
兼容性说明
下表展示了各技术栈之间的兼容关系。✅ 表示支持，- 表示不适用。
后端 × ORM × 数据库
| 后端 | Prisma | MyBatis+ | JPA | Ktorm | SQLAlchemy | Django ORM | PostgreSQL | MySQL | SQLite |
|---|---|---|---|---|---|---|---|---|---|
| NestJS | ✅ | - | - | - | - | - | ✅ | ✅ | ✅ |
| Express | ✅ | - | - | - | - | - | ✅ | ✅ | ✅ |
| Spring Boot (Java) | - | ✅ | ✅ | - | - | - | ✅ | ✅ | ✅ |
| Spring Boot (Kotlin) | - | ✅ | ✅ | ✅ | - | - | ✅ | ✅ | ✅ |
| FastAPI | - | - | - | - | ✅ | - | ✅ | ✅ | ✅ |
| Django | - | - | - | - | - | ✅ | ✅ | ✅ | ✅ |
后端 × 认证
| 后端 | JWT | Sa-Token | Spring Security |
|---|---|---|---|
| NestJS | ✅ | - | - |
| Express | ✅ | - | - |
| FastAPI | ✅ | - | - |
| Django | ✅ | - | - |
| Spring Boot | - | ✅ | ✅ |
前端 × 状态管理 × 路由
| 前端 | Pinia | Zustand | Jotai | Vue Router | React Router | TanStack Router |
|---|---|---|---|---|---|---|
| Vue 3 | ✅ | - | - | ✅ | - | - |
| React | - | ✅ | ✅ | - | ✅ | ✅ |
📋 快速查阅
部署与运维
- Docker 部署指南 - 容器化部署最佳实践
- 生产环境配置 - 性能优化与安全加固
- 开发环境配置 - 本地开发环境搭建
- 环境变量参考 - 所有可配置项说明
进阶模块
- 认证与授权 - 多种认证方案对比
- 文件上传 - 本地与云存储方案
- 状态管理 - Pinia / Zustand / Jotai
- 数据请求 - TanStack Query 实践
- 表单管理 - TanStack Form + Zod
架构文档
💡 推荐技术组合
🚀 快速入门
最容易上手，适合新手和快速原型
BackendNestJS
FrontendVue 3
UI LibraryNaive UI
DatabaseSQLite
🏢 企业标准
Java 生态工业标准，适合大型项目
BackendSpring Boot
FrontendVue 3
UI LibraryAnt Design Vue
DatabasePostgreSQL
⚡ 高效开发
现代化技术栈，开发体验極致
BackendNestJS + Prisma
FrontendVue 3
UI Libraryshadcn-vue
DatabasePostgreSQL
📚 阅读建议
从哪里开始？
- 初次接触：先阅读 系统架构概览
- 技术选型困难：查看 技术兼容性矩阵
- 已确定技术栈：直接进入对应的技术文档，如 NestJS 或 Spring Boot
- 需要部署：参考 Docker 部署指南