# fast_base

**Repository Path**: liangwater/fast_base

## Basic Information

- **Project Name**: fast_base
- **Description**: 快速开发模板
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UIVSBE - 全栈快速启动模板

> **UIVSBE** = **U**niversal **I**nterface & **V**ersatile **S**ervice **B**ackend **E**ngine
>
> 一套前后端分离的快速启动项目模板，包含后端 Django REST 框架和前端 UniApp 移动端。

---

## 项目结构

```
fast_base/
├── README.md              # 本文件（项目总览）
├── backend/               # 后端项目（Django + DRF）
│   ├── README.md          # 👈 后端开发规范（AI 必读）
│   ├── manage.py
│   ├── requirements.txt
│   ├── uivsbe_backend/    # Django 配置包
│   ├── Apps/              # 业务模块
│   ├── models/            # 数据模型
│   └── tools/             # 工具类
├── frontend/              # 前端项目
│   └── mobile/            # UniApp 移动端
│       └── README.md      # 👈 前端开发规范
└── uivsbe_env/            # Python 虚拟环境（不提交 Git）
```

---

## 开发须知

### 后端开发

**必须先阅读** → [`backend/README.md`](backend/README.md)

包含：技术栈、快速启动、API 规范、AI 开发强制约束、模块开发流程。

### 前端开发

**必须先阅读** → [`frontend/mobile/README.md`](frontend/mobile/README.md)

包含：前端技术栈、项目结构、组件规范、页面开发流程。

---

## AI 辅助开发规则

任何 AI 工具参与本项目开发时，**必须遵守以下规则**：

1. **先读规范**：修改后端代码前阅读 `backend/README.md`，修改前端代码前阅读 `frontend/mobile/README.md`
2. **遵循选型**：后端使用 Django + DRF，前端使用 UniApp，禁止引入其他框架
3. **统一格式**：API 返回格式、代码风格、命名规范必须与各自 README 一致
4. **不越界**：后端不碰前端代码，前端不碰后端代码，除非明确要求

---

## 快速开始

### 后端

```bash
cd backend
python -m venv uivsbe_env
uivsbe_env\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
python manage.py migrate --settings=uivsbe_backend.settings.dev
python manage.py runserver 8000 --settings=uivsbe_backend.settings.dev
```

详细说明见 [`backend/README.md`](backend/README.md)

### 前端

```bash
cd frontend/mobile
npm install
npm run dev
```

详细说明见 [`frontend/mobile/README.md`](frontend/mobile/README.md)

---

> 📝 最后更新: 2026-08-06