# 恰西奇玩偶屋系统

**Repository Path**: YyModel/QXQDollHouse

## Basic Information

- **Project Name**: 恰西奇玩偶屋系统
- **Description**: 这是一个基于 Django + UniApp 的玩偶屋商品管理系统，支持商品的添加、编辑、删除、图片管理、分类管理、扫码录入、批量操作、移动端适配等功能。系统包含商品、分类、库存、报表、用户等模块，界面美观，交互友好，适合中小型零售或玩具店铺的商品与库存数字化管理。后续计划支持多规格、批量导入导出、订单、权限分级、数据统计等扩展。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-05-07
- **Last Updated**: 2025-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QXQ娃娃屋管理系统

## 项目简介
QXQ娃娃屋管理系统是一个基于 Django + UniApp 的商品管理系统，支持商品、分类、图片、库存、订单、用户等多模块管理，适配移动端和PC端，界面美观，交互友好，适合中小型零售或玩具店铺数字化管理。

---

## 技术栈
- **后端**：Python 3.x、Django 5.x、MySQL、PyMySQL、django-cors-headers
- **前端**：UniApp（移动端）、HubUI（PC端）、SCSS
- **数据库**：MySQL 5.7/8.0

---

## 目录结构
```
QXQDollHouse/
├── web/                    # 主应用目录
│   ├── apis/              # API接口目录
│   ├── static/            # 静态文件目录
│   ├── templates/         # 模板目录（含APP和PC端）
│   └── models.py          # 数据模型
├── QXQdollHouse/          # Django项目配置目录
├── media/                 # 媒体文件目录
├── manage.py              # Django管理脚本
├── requirements.txt       # 项目依赖
├── README.md              # 项目说明
└── ...                    # 其它
```

---

## 主要功能
- 商品管理（增删改查、图片、描述、扫码、批量操作）
- 分类管理（主分类、二级分类、切换、查看）
- 图片管理（多图上传、删除、预览、滑动切换）
- 用户与权限（上架员、用户列表、权限分级）
- 订单管理（订单增删改查、状态流转、支付方式）
- 库存管理（库存变动、预警、批量入库/出库）
- 统计与报表（销售、库存、趋势分析）
- 我的页面（店铺信息、设置、反馈等）
- 自定义TabBar、消息框、移动端适配

---

## 快速启动

### 1. 克隆项目
```bash
git clone <你的gitee仓库地址>
cd QXQDollHouse
```

### 2. 创建并激活虚拟环境
```bash
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/Mac
source .venv/bin/activate
```

### 3. 安装依赖
```bash
pip install -r requirements.txt
```

### 4. 配置数据库
- 确保本地已安装 MySQL，并创建好数据库（qxqdollhouse）。
- 修改 `QXQdollHouse/settings.py` 中的数据库配置（用户名、密码、端口等）。

### 5. 导入数据库数据
假设你已在项目根目录导出了 `qxqdollhouse.sql`，可用如下命令导入：

```bash
# 登录MySQL
mysql -u root -p
# 在MySQL命令行中执行
CREATE DATABASE IF NOT EXISTS qxqdollhouse DEFAULT CHARSET utf8mb4;
USE qxqdollhouse;
SOURCE /你的项目路径/qxqdollhouse.sql;
```
> 温馨提示：如遇编码问题，请确保数据库和表均为utf8mb4。

### 6. 数据库迁移（如需同步最新结构）
```bash
python manage.py makemigrations
python manage.py migrate
```

### 7默认用户名
```bash
张三
dzyDZY12@
```
### 8. 启动开发服务器
```bash
python manage.py runserver
```
访问 http://127.0.0.1:9001/ 即可。

---

## 温馨引导

- **首次运行建议**：先导入数据库数据，再执行 `migrate`，避免表结构冲突。
- **媒体文件**：商品图片等会保存在 `media/` 目录，确保该目录有写权限。
- **移动端开发**：`/web/templates/APP` 目录为 UniApp 源码，可用 HBuilderX 打开并运行到手机或小程序。
- **PC端开发**：`/web/templates/pc` 目录为PC端模板，直接通过Django渲染。
- **如需超级管理员**：可用 `python manage.py createsuperuser` 创建后台账号。
- **接口不正确**: APP端的全局API在web\templates\APP\QXQ管理版\static\js\config.js中，请把domain改成你的域名 + 端口(不需要斜杆/)
- **常见问题**：如遇依赖安装、数据库连接、静态文件等问题，请优先检查配置和依赖版本。

---

## 贡献与反馈

- 欢迎提交 issue、PR 或建议，帮助我们持续优化系统！
- 如有定制需求或技术交流，请联系项目维护者或添加绿泡泡:**duyanbz**,备注来意

---