# django_admin

**Repository Path**: halixiedun/django_admin

## Basic Information

- **Project Name**: django_admin
- **Description**: 前端vue，后端django的系统管理工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目说明

本项目为一个完整的管理系统，包含：
- 后端：Python Django，JWT认证，SQLite数据库，虚拟环境
- 前端：Vue 3 + Vite + Ant Design Vue

## 目录结构
- backend/  后端代码
- frontend/ 前端代码

## 启动步骤

### 后端
1. 在项目根目录创建并激活虚拟环境：
	- Windows:
	  - python -m venv venv
	  - venv\Scripts\activate
2. 安装依赖：
	- pip install -r backend/requirements.txt
3. 生成与应用数据库迁移：
	- python manage.py makemigrations core
	- python manage.py migrate
4. 创建管理员账号：
	- python manage.py createsuperuser
5. 启动 Django 服务：
	- python manage.py runserver
6. 访问地址：
	- 后端管理后台: http://127.0.0.1:8000/admin/
	- API 基地址: http://127.0.0.1:8000/api/

### 前端
1. 进入 frontend 目录
2. 安装依赖：
	- npm install
3. 启动前端服务：
	- npm run dev
4. 访问地址：
	- Vite 默认: http://localhost:5173/
	- 若 5173 被占用，Vite 会自动切换到 5174 等端口

### 快速启动（复制执行）

后端（项目根目录）：

```bash
python -m venv venv
venv\Scripts\activate
pip install -r backend/requirements.txt
python manage.py makemigrations core
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
```

前端（frontend 目录）：

```bash
npm install
npm run dev
```

### 一键启动脚本（Windows PowerShell）

在项目根目录执行：

```powershell
scripts\start.ps1
```

脚本会同时启动后端与前端。首次运行请确保已创建虚拟环境并安装依赖。

### 前后端联调说明
- 前端已配置 Vite 代理：/api 会转发到 http://127.0.0.1:8000
- 前端默认使用同源 /api 访问后端，保证 JWT Cookie 正常携带
- 若需要改后端地址，可在 frontend/.env 中设置:
  - VITE_API_BASE_URL=/api

### 登录说明
- 使用创建的超级管理员账号登录前端
- 登录后会访问 /api/me/ 拉取用户信息与菜单

### 常见问题排查
- 前端白屏或空白：确认 Vite dev 地址正确（5173/5174），控制台是否有加载失败的资源。
- 登录失败（前端提示 Login failed）：查看 Network 里 /api/auth/login/ 是否 200。
- 登录后 /api/me/ 401：通常是 Cookie 未携带。
	- 确认前端通过 /api 走 Vite 代理（frontend/.env 为 VITE_API_BASE_URL=/api）。
	- 重启前端 dev 服务。
- 后端 500：通常是迁移未执行。
	- 执行 python manage.py makemigrations core && python manage.py migrate
- 端口占用：Vite 会自动切换端口，请使用终端输出的 Local 地址。

详细操作见各目录下 README。