# wdadmin-django

**Repository Path**: wd-admin/wdadmin-django

## Basic Information

- **Project Name**: wdadmin-django
- **Description**: 基于 Django 实现的后端
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-24
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WdAdmin-Django
WdAdmin后台管理系统——Django后端。

## 平台简介
WDAdmin 后台管理系统的后端是基于 Python 开发，前端基于 Vue 开发，借鉴了优秀的开源项目 [dvadmin3](https://django-vue-admin.com/)，
旨在打造开箱即用的后台管理系统，不同的分支会对应不同的功能，总有一款刚好适合你的需求。

### 通用功能
- 用户管理
- 字典管理

### 分支t1
t1 分支为最基础版本，用户分为管理员和普通用户（通过`is_superuser`字段区分），管理员拥有用户管理页面。

## 开始
建议使用虚拟环境，本项目使用 Pipenv 管理虚拟环境包，你也可以使用其它的管理工具。
1. 安装 pipenv 
    ```
    pip install pipenv
    ```
2. 创建虚拟环境：进入到项目目录下，创建虚拟环境并进入到虚拟环境
    ```
    pipenv shell
    ```
3. 安装项目依赖包
    ```
    pipenv install
    ```
4. 配置环境变量
    
    本项目分为开发（dev）、测试（test）和线上（online）三个环境，你需要配置环境变量 `WDADMIN_ENV`的值为相应的环境。 
    在不同的环境读取不同的配置，这样测试和上线就不需要手动改配置。参考 `wdadmin.config.__init__.py` 配置文件。

5. 生成数据库迁移文件
    ```
    python manage.py makemigrations
    ```
    请确保你的应用包含 `migrations/__init__.py` 文件，否则可能需要指定应用名称才会生成迁移文件。
6. 迁移数据库
    ```
    python manage.py migrate
    ```
7. 初始化系统
    ```
    python manage.py init
    ```
8. 运行
    ```
    python manage.py runserver 0.0.0.0:8000
    ```
   如果你使用 Pycharm 专业版，右上角有按钮可以直接运行 Django 项目。

浏览器访问 http://127.0.0.1:8000/docs 查看API文档。

## 国际化
参考文档：https://docs.djangoproject.com/zh-hans/5.2/topics/i18n/translation/#localization-how-to-create-language-files
1. 进入到应用目录下，创建一个 `locale` 文件夹
2. 创建语言文件，在当前目录下执行命令：
   ```shell
   django-admin makemessages -l en -e py
   ```
   这表示对 `py` 文件生成 `en` 语言文件（本项目为将中文转为英文）。