# bacnend_admin_client

**Repository Path**: solve_847/bacnend_admin_client

## Basic Information

- **Project Name**: bacnend_admin_client
- **Description**: 接口-管理后台-客户端的完整项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Full Stack - 全栈项目框架

基于 FastAPI + Vue3 + MySQL 8 的全栈应用，使用 Monorepo 单仓库管理。

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Python 3.11 / FastAPI / SQLAlchemy / Alembic |
| 数据库 | MySQL 8.0 (pymysql 驱动) |
| 管理后台 | Vue 3 + Vite + Element Plus |
| 用户端 | Vue 3 + Vite + Element Plus |
| 容器化 | Docker / Docker Compose |

## 项目结构

```
docuhub_ai_test/
├── backend/            # Python FastAPI 后端
│   ├── app/
│   │   ├── api/        # 路由层
│   │   │   └── v1/endpoints/
│   │   ├── core/       # 核心配置
│   │   ├── models/     # ORM 模型
│   │   ├── schemas/    # Pydantic 模式
│   │   ├── services/   # 业务逻辑层
│   │   ├── repositories/ # 数据库 CRUD 封装
│   │   ├── utils/      # 工具函数
│   │   ├── tests/      # 测试
│   │   └── main.py     # 应用入口
│   ├── alembic/        # 数据库迁移
│   ├── Dockerfile
│   └── requirements.txt
├── admin/              # Vue3 管理后台
│   ├── src/
│   ├── Dockerfile
│   └── package.json
├── client/             # Vue3 用户端
│   ├── src/
│   ├── Dockerfile
│   └── package.json
├── sql/                # 数据库初始化脚本
│   └── init.sql
├── tmp/                # 临时目录 (Git 忽略)
├── docker-compose.yml
├── .gitignore
└── README.md
```

## 本地开发

### 前置要求

- Docker & Docker Compose

### 快速启动

```bash
docker-compose up --build
```

首次启动时，MySQL 容器会自动执行 `sql/init.sql` 创建数据库表，后端启动时也会自动检查并创建缺失的表。

### 服务地址

| 服务 | 地址 |
|------|------|
| 后端 API | http://localhost:8000 |
| API 文档 | http://localhost:8000/docs |
| 管理后台 | http://localhost:5173 |
| 用户端 | http://localhost:5174 |
| MySQL | localhost:3306 |

### 后端单独开发

```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

## 环境变量

后端环境变量参考 `.env.example`，Docker 环境下通过 `docker-compose.yml` 注入。