docs/project-overview.md · 王坤峰/VueFlask-MVP

# MVP快速原型开发框架 - 项目概述

## 项目简介

MVP快速原型开发框架是一个集成了前后端技术栈的全栈开发框架，专为快速构建最小可行性产品(MVP)而设计。本框架采用现代化的技术栈和最佳实践，旨在帮助开发者快速验证产品概念，缩短从想法到产品的周期。

## 核心目标

- **快速开发**：提供完整的开发环境和工具链，减少配置时间
- **易于扩展**：模块化设计，便于二次开发和功能扩展
- **开发体验**：集成热重载、类型检查、API文档等提升开发效率的功能
- **部署简便**：提供多种部署方案，从开发环境到生产环境的无缝过渡

## 技术架构

### 前端架构

- **核心框架**：Vue 3.5+ (Composition API)
- **构建工具**：Vite 6.2+
- **类型系统**：TypeScript 5.7+
- **UI组件**：PrimeVue 4.3+ + PrimeFlex 4.0+
- **状态管理**：Pinia 3.0+
- **HTTP客户端**：Axios 1.8+
- **路由管理**：Vue Router

### 后端架构

- **核心框架**：Flask 3.0+
- **数据库ORM**：SQLAlchemy 3.1+
- **API文档**：Flask-RESTX 1.2+
- **数据库迁移**：Flask-Migrate 4.0+
- **跨域支持**：Flask-CORS 4.0+
- **环境变量**：python-dotenv 1.0+
- **WSGI服务器**：uWSGI 2.0+

### 数据库

- 开发环境：SQLite (轻量级，无需额外配置)
- 生产环境：可配置为MySQL、PostgreSQL等关系型数据库

## 核心功能

### 前端功能

- **组件库**：集成PrimeVue组件库，提供丰富的UI组件
- **响应式布局**：使用PrimeFlex实现响应式设计
- **状态管理**：Pinia状态管理，支持模块化和TypeScript
- **路由管理**：Vue Router配置，支持路由守卫和懒加载
- **API集成**：封装Axios，统一处理请求和响应
- **环境配置**：开发和生产环境分离配置

### 后端功能

- **RESTful API**：使用Flask-RESTX构建RESTful API
- **API文档**：自动生成Swagger文档
- **数据模型**：SQLAlchemy ORM，支持复杂查询和关系
- **数据迁移**：Flask-Migrate管理数据库版本
- **认证授权**：JWT认证和基于角色的权限控制
- **跨域支持**：配置CORS，支持前后端分离开发

### 部署功能

- **Docker支持**：多阶段构建Dockerfile
- **Nginx配置**：前端静态文件和API代理配置
- **环境变量**：开发和生产环境分离配置
- **uWSGI配置**：生产环境WSGI服务器配置

## 项目结构

```
project/
├── frontend/                 # 前端工程(Vue3 + Vite)
├── backend/                  # 后端工程(Flask3)
└── deploy/                   # 部署配置
```

## 适用场景

- **创业项目**：快速验证产品概念和市场反馈
- **内部工具**：企业内部管理系统和工具开发
- **原型验证**：产品原型开发和功能验证
- **学习实践**：全栈开发学习和实践

## 扩展性

框架设计遵循模块化原则，可以根据需求进行以下扩展：

- **前端扩展**：添加新页面、组件和功能模块
- **后端扩展**：添加新API、服务和业务逻辑
- **数据库扩展**：添加新模型和关系
- **部署扩展**：支持不同的部署环境和方案

## 文档导航

- [快速上手指南](./getting-started.md)：环境配置和项目启动
- [开发指南](./development-guide.md)：二次开发和功能扩展
- [部署指南](./deployment-guide.md)：部署流程和环境配置

王坤峰/VueFlask-MVP

简介

发行版

贡献者

语言

近期动态

王坤峰/VueFlask-MVP .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

语言

近期动态

搜索帮助

王坤峰/VueFlask-MVP