diff --git a/README.md b/README.md index 684b078..6bf161b 100644 --- a/README.md +++ b/README.md @@ -1,73 +1,71 @@ -# Django-Vue3-Admin +# PIS - Procurement & Supplier Management System -[](https://gitee.com/huge-dream/django-vue3-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/huge-dream/django-vue3-admin) +## Project Overview -[preview](https://demo.dvadmin.com) | [Official website document](https://www.django-vue-admin.com) | [qq group](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [community](https://bbs.django-vue-admin.com) | [plugins market](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin) +A Django-Vue3 based procurement and supplier management system with RBAC permission control. -💡 **「About」** +## Project Architecture 🏗️ -It is a completely open-source rapid development platform, provided free for personal use and authorized for group use. -Django-Vue3-Admin is a comprehensive basic development platform based on the RBAC (Role-Based Access Control) model for permission control, with column-level granularity. It follows a frontend-backend separation architecture, with Django and Django Rest Framework used for the backend, and Vue3, Composition API, TypeScript, Vite, and Element Plus used for the frontend. +### Tech Stack +| Layer | Technology | +|-------|------------| +| **Backend** | Django 4.2.14 + Django REST Framework 3.15.2 | +| **Frontend** | Vue 3 + TypeScript + Vite 5.4 + Element Plus 2.8 + FastCRUD | +| **Database** | MySQL 8.0 | +| **Cache/Queue** | Redis + Celery | +| **Real-time** | Django Channels (WebSocket) | +| **Auth** | JWT via SimpleJWT | -## framework introduction +### Directory Structure -💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) Is a set of all open source rapid development platform, no reservation for individuals and enterprises free use. +``` +pis/ +├── backend/ +│ ├── application/ # Django project settings +│ │ ├── settings.py # Main settings (imports from conf/env.py) +│ │ ├── urls.py # Root URL routing +│ │ ├── asgi.py # ASGI config (WebSocket support) +│ │ ├── wsgi.py # WSGI config +│ │ └── celery.py # Celery configuration +│ ├── apps/ +│ │ ├── pisadmin/ # Custom procurement app +│ │ │ ├── basicinfo/ # Company, currency, supplier, unit, system no +│ │ │ └── miscprocurement/ # RFQ, price templates, cost sections +│ │ └── pissupplier/ # Supplier quotation module +│ ├── dvadmin/ # Core RBAC system +│ │ └── system/ # Users, roles, menus, departments, logs +│ └── conf/ +│ └── env.py # Environment configuration (DB, Redis credentials) +├── web/ # Vue 3 frontend +│ └── src/ +│ ├── views/pisadmin/ # Custom procurement pages +│ ├── views/pissupplier/# Supplier pages +│ └── views/system/ # Admin system pages +└── scripts/ # Service management scripts + ├── start-backend.sh # Start backend service + ├── start-frontend.sh # Start frontend service + ├── start-celery.sh # Start Celery worker/beat + ├── stop-all.sh # Stop all services + └── check-status.sh # Check service status +``` -* 🧑🤝🧑Front-end adoption Vue3+TS+pinia+fastcrud。 -* 👭The backend uses the Python language Django framework as well as the powerful[Django REST Framework](https://pypi.org/project/djangorestframework)。 -* 👫Permission authentication use[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt),Supports the multi-terminal authentication system. -* 👬Support loading dynamic permission menu, multi - way easy permission control. -* 👬Enhanced Column Permission Control, with granularity down to each column. -* 💏Special thanks: [vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/). -* 💡Special thanks:[jetbrains](https://www.jetbrains.com/) To provide a free IntelliJ IDEA license for this open source project. +### Module Description -## Online experience +| Module | Description | +|--------|-------------| +| `pisadmin/basicinfo` | Basic info management: companies, currencies, suppliers, units, system numbering rules | +| `pisadmin/miscprocurement` | Miscellaneous procurement: RFQ, price templates, cost section builder | +| `pissupplier` | Supplier quotation module | +| `dvadmin/system` | Core RBAC system: users, roles, menus, departments, operation logs | -👩👧👦👩👧👦 demo address:[https://demo.dvadmin.com](https://demo.dvadmin.com) +### Configuration -* demo account:superadmin +Backend settings are split: +- `application/settings.py` - Django defaults +- `conf/env.py` - Environment-specific config (database, Redis, secrets) -* demo password:admin123456 - -👩👦👦docs:[https://django-vue-admin.com](https://django-vue-admin.com) - -## communication - -* Communication community:[click here](https://bbs.django-vue-admin.com)👩👦👦 - -* plugins market:[click here](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦 - -## source code url: - -gitee(Main push):[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦 - -github:[https://github.com/huge-dream/django-vue3-admin](https://github.com/huge-dream/django-vue3-admin)👩👦👦 - -## core function - -1. 👨⚕️Menu Management: Configure system menus, operation permissions, button permission flags, backend interface permissions, etc. -2. 🧑⚕️Department Management: Configure system organizational structure (company, department, role). -3. 👩⚕️Role Management: Role menu permission assignment, data permission assignment, set role-based data scope permissions by department. -4. 🧑🎓Button Permission Control: Authorize role-specific button permissions and interface permissions, enabling authorization of data scope for each interface. -5. 🧑🎓Field Column Permission Control: Authorize page field display permissions, specifically for the display permissions of a certain column. -6. 👨🎓User Management: Users are system operators, and this function is mainly used for system user configuration. -7. 👬API Whitelist: Configure interfaces that do not require permission verification. -8. 🧑🔧Dictionary Management: Maintain frequently used and relatively fixed data in the system. -9. 🧑🔧Region Management: Manage provinces, cities, counties, and districts. -10. 📁File Management: Unified management of all files, images, etc., on the platform. -11. 🗓️Operation Logs: Record and query logs for normal system operations and exceptional system information. -12. 🔌[Plugin Market](https://bbs.django-vue-admin.com/plugMarket.html): Applications and plugins developed based on the Django-Vue-Admin framework. - -## plugins market 🔌 - -Updating... - -## Repository Branch Explanation 💈 -Main Branch: master (stable version) -Development Branch: develop - -## before start project you need: +## Prerequisites ~~~ Python >= 3.11.0 (Minimum version 3.9+) @@ -76,100 +74,119 @@ Mysql >= 8.0 (Optional, default database: SQLite3, supports 5.7+, recommended ve Redis (Optional, latest version) ~~~ -## frontend♝ +## Quick Start + +### Backend + +#### Method 1: Script Startup (Recommended) ```bash -# clone code -git clone https://gitee.com/huge-dream/django-vue3-admin.git +# Go to project root +cd D:\AVC-PROJECT\pis -# enter code dir +# Start backend service (development mode) +./scripts/start-backend.sh + +# Start frontend service +./scripts/start-frontend.sh + +# Start Celery async tasks (optional) +./scripts/start-celery.sh +``` + +**Script Description:** + +| Script | Description | +|--------|-------------| +| `start-backend.sh` | Start backend service (auto-creates PID and log files) | +| `start-frontend.sh` | Start frontend dev server | +| `start-celery.sh` | Start Celery Worker and Beat | +| `stop-all.sh` | Stop all services | +| `stop-celery.sh` | Stop Celery only | +| `check-status.sh` | Check all service status | +| `view-logs.sh` | View service logs | + +**View Logs:** +```bash +./scripts/view-logs.sh all # View all logs +./scripts/view-logs.sh backend # Backend logs only +./scripts/view-logs.sh celery # Celery logs only +``` + +**Stop Services:** +```bash +./scripts/stop-all.sh # Stop all services +./scripts/stop-celery.sh # Stop Celery only +``` + +#### Method 2: Manual Startup + +```bash +# 1. Go to backend directory +cd backend + +# 2. Copy and configure environment file +cp ./conf/env.example.py ./conf/env.py +# Edit env.py to configure database information + +# 3. Install dependencies +pip3 install -r requirements.txt + +# 4. Run migrations +python3 manage.py makemigrations +python3 manage.py migrate + +# 5. Initialize data +python3 manage.py init +python3 manage.py init_area + +# 6. Start backend +uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8 +``` + +### Frontend + +```bash +# Go to web directory cd web -# install dependence +# Install dependencies npm install yarn yarn install --registry=https://registry.npm.taobao.org -# Start service +# Start development server yarn run dev # Visit http://localhost:8080 in your browser -# Parameters such as boot port can be configured in the #.env.development file -# Build the production environment -# yarn run build +# Parameters such as boot port can be configured in the .env.development file + +# Build for production +yarn run build ``` -## backend💈 +### Access -~~~bash -1. enter code dir cd backend -2. copy ./conf/env.example.py to ./conf dir,rename as env.py -3. in env.py configure database information - mysql database recommended version: 8.0 - mysql database character set: utf8mb4 -4. install pip dependence - pip3 install -r requirements.txt -5. Execute the migration command: - python3 manage.py makemigrations - python3 manage.py migrate -6. Initialization data - python3 manage.py init -7. Initialize provincial, municipal and county data: - python3 manage.py init_area -8. start backend - python3 manage.py runserver 0.0.0.0:8000 -or uvicorn : - uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8 -~~~ +- Frontend URL: http://localhost:8080 +- Backend API: http://localhost:8080/api +- Default account: `superadmin` / `admin123456` -### visit backend swagger +### Docker -* visit url:[http://localhost:8080](http://localhost:8080) (The default address is this one. If you want to change it, follow the configuration file) -* account:`superadmin` password:`admin123456` - -### docker-compose - -~~~shell +```shell docker-compose up -d # Initialize backend data (first execution only) docker exec -ti dvadmin3-django bash -python manage.py makemigrations +python manage.py makemigrations python manage.py migrate python manage.py init_area python manage.py init exit -frontend url:http://127.0.0.1:8080 -backend url:http://127.0.0.1:8080/api -# Change 127.0.0.1 to your own public ip address on the server -account:`superadmin` password:`admin123456` - -# docker-compose stop +# Stop services docker-compose down -# docker-compose restart + +# Restart services docker-compose restart -# docker-compose on start build + +# Rebuild and start docker-compose up -d --build -~~~ - -## Demo screenshot✅ - - - - - - - - - - - - - - - - - - - - - - +``` diff --git a/README.zh.md b/README.zh.md index 7309785..a2f82f6 100644 --- a/README.zh.md +++ b/README.zh.md @@ -1,118 +1,72 @@ -# Django-Vue3-Admin +# PIS - 采购与供应商管理系统 -[](https://gitee.com/liqianglog/django-vue-admin/blob/master/LICENSE) [](https://python.org/) [](https://docs.djangoproject.com/zh-hans/3.2/) [](https://nodejs.org/zh-cn/) [](https://gitee.com/liqianglog/django-vue-admin) +## 项目简介 -[预 览](https://demo.dvadmin.com) | [官网文档](https://www.django-vue-admin.com) | [群聊](https://qm.qq.com/cgi-bin/qm/qr?k=fOdnHhC8DJlRHGYSnyhoB8P5rgogA6Vs&jump_from=webapi) | [社区](https://bbs.django-vue-admin.com) | [插件市场](https://bbs.django-vue-admin.com/plugMarket.html) | [Github](https://github.com/liqianglog/django-vue-admin) +基于 Django-Vue3 的采购与供应商管理系统,采用 RBAC 权限控制。 +## 项目架构 🏗️ +### 技术栈 -💡 **「关于」** +| 层级 | 技术 | +|------|------| +| **后端** | Django 4.2.14 + Django REST Framework 3.15.2 | +| **前端** | Vue 3 + TypeScript + Vite 5.4 + Element Plus 2.8 + FastCRUD | +| **数据库** | MySQL 8.0 | +| **缓存/队列** | Redis + Celery | +| **实时通信** | Django Channels (WebSocket) | +| **认证** | JWT via SimpleJWT | -我们是一群热爱代码的青年,在这个炙热的时代下,我们希望静下心来通过Code带来一点我们的色彩和颜色。 +### 目录结构 -因为热爱,所以拥抱未来! +``` +pis/ +├── backend/ +│ ├── application/ # Django 项目配置 +│ │ ├── settings.py # 主配置(从 conf/env.py 导入配置) +│ │ ├── urls.py # 根路由 +│ │ ├── asgi.py # ASGI 配置(支持 WebSocket) +│ │ ├── wsgi.py # WSGI 配置 +│ │ └── celery.py # Celery 配置 +│ ├── apps/ +│ │ ├── pisadmin/ # 采购管理应用 +│ │ │ ├── basicinfo/ # 基础信息:公司、币种、供应商、单位、编码规则 +│ │ │ └── miscprocurement/ # 杂项采购:询价、价格模板、成本节 +│ │ └── pissupplier/ # 供应商报价模块 +│ ├── dvadmin/ # 核心 RBAC 系统 +│ │ └── system/ # 用户、角色、菜单、部门、日志 +│ └── conf/ +│ └── env.py # 环境配置(数据库、Redis 凭证) +├── web/ # Vue 3 前端 +│ └── src/ +│ ├── views/pisadmin/ # 采购管理页面 +│ ├── views/pissupplier/# 供应商页面 +│ └── views/system/ # 系统管理页面 +└── scripts/ # 服务管理脚本 + ├── start-backend.sh # 启动后端服务 + ├── start-frontend.sh # 启动前端服务 + ├── start-celery.sh # 启动 Celery worker/beat + ├── stop-all.sh # 停止所有服务 + └── check-status.sh # 查看服务状态 +``` +### 模块说明 -## 平台简介 +| 模块 | 说明 | +|------|------| +| `pisadmin/basicinfo` | 基础信息管理:公司、币种、供应商、单位、系统编号规则 | +| `pisadmin/miscprocurement` | 杂项采购:询价(RFQ)、价格模板、成本节构建器 | +| `pissupplier` | 供应商报价模块 | +| `dvadmin/system` | 核心 RBAC 系统:用户、角色、菜单、部门、操作日志 | -💡 [django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin.git) 是一套全部开源的快速开发平台,毫无保留给个人免费使用、团体授权使用。 - django-vue3-admin 基于RBAC模型的权限控制的一整套基础开发平台,权限粒度达到列级别,前后端分离,后端采用django + django-rest-framework,前端采用基于 vue3 + CompositionAPI + typescript + vite + element plus - - - - -* 🧑🤝🧑前端采用 Vue3+TS+pinia+fastcrud(感谢[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/)) -* 👭后端采用 Python 语言 Django 框架以及强大的 [Django REST Framework](https://pypi.org/project/djangorestframework)。 -* 👫权限认证使用[Django REST Framework SimpleJWT](https://pypi.org/project/djangorestframework-simplejwt),支持多终端认证系统。 -* 👬支持加载动态权限菜单,多方式轻松权限控制。 -* 👬全新的列权限管控,粒度细化到每一列。 -* 💏特别鸣谢:[vue-next-admin](https://lyt-top.gitee.io/vue-next-admin-doc-preview/)。 -* 💡特别感谢[jetbrains](https://www.jetbrains.com/) 为本开源项目提供免费的 IntelliJ IDEA 授权。 - -#### 🏭 环境支持 - -| Edge | Firefox | Chrome | Safari | -| --------- | ------------ | ----------- | ----------- | -| Edge ≥ 79 | Firefox ≥ 78 | Chrome ≥ 64 | Safari ≥ 12 | - -> 由于 Vue3 不再支持 IE11,故而 ElementPlus 也不支持 IE11 及之前版本。 - - - -## 在线体验 - -👩👧👦演示地址:[https://demo.dvadmin.com](https://demo.dvadmin.com) - -- 账号:superadmin - -- 密码:admin123456 - -👩👦👦文档地址:[DVAdmin官网](https://www.django-vue-admin.com) - - - -## 交流 - -- 交流社区:[戳我](https://bbs.django-vue-admin.com)👩👦👦 -- 插件市场:[戳我](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦 -- django-vue-admin交流01群(已满):812482043 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=aJVwjDvH-Es4MPJQuoO32N0SucK22TE5&jump_from=webapi) -- django-vue-admin交流02群(已满):687252418 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=4jJN4IjWGfxJ8YJXbb_gTsuWjR34WLdc&jump_from=webapi) -- django-vue-admin交流03群(已满):442108213 [点击链接加入群聊](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=wsm5oSz3K8dElBYUDtLTcQSEPhINFkl8&authKey=M6sbER0z59ZakgBr5erFeZyFZU15CI52bErNZa%2FxSvvGIuVAbY0N5866v89hm%2FK4&noverify=0&group_code=442108213) -- django-vue-admin交流04群:442108213 [点击链接加入群聊](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=wsm5oSz3K8dElBYUDtLTcQSEPhINFkl8&authKey=M6sbER0z59ZakgBr5erFeZyFZU15CI52bErNZa%2FxSvvGIuVAbY0N5866v89hm%2FK4&noverify=0&group_code=442108213) - - - -## 给框架点赞 - -
-
-
-
-
-
-## 交流
-
-- 交流社区:[戳我](https://bbs.django-vue-admin.com)👩👦👦
-
-- 插件市场:[戳我](https://bbs.django-vue-admin.com/plugMarket.html)👩👦👦
-
-- django-vue-admin交流01群(已满):812482043 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=aJVwjDvH-Es4MPJQuoO32N0SucK22TE5&jump_from=webapi)
-- django-vue-admin交流02群(已满):687252418 [点击链接加入群聊](https://qm.qq.com/cgi-bin/qm/qr?k=4jJN4IjWGfxJ8YJXbb_gTsuWjR34WLdc&jump_from=webapi)
-- django-vue-admin交流03群:442108213 [点击链接加入群聊](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=wsm5oSz3K8dElBYUDtLTcQSEPhINFkl8&authKey=M6sbER0z59ZakgBr5erFeZyFZU15CI52bErNZa%2FxSvvGIuVAbY0N5866v89hm%2FK4&noverify=0&group_code=442108213)
-
-- 二维码
-
-
-
-## 源码地址
-
-gitee地址(主推):[https://gitee.com/huge-dream/django-vue3-admin](https://gitee.com/huge-dream/django-vue3-admin)👩👦👦
-
-github地址:暂无
-
-
-## 内置功能
-
-1. 👨⚕️菜单管理:配置系统菜单,操作权限,按钮权限标识、后端接口权限等。
-2. 🧑⚕️部门管理:配置系统组织机构(公司、部门、角色)。
-3. 👩⚕️角色管理:角色菜单权限分配、数据权限分配、设置角色按部门进行数据范围权限划分。
-4. 🧑🎓按钮权限权限:授权角色的按钮权限和接口权限,可做到每一个接口都能授权数据范围。
-5. 🧑🎓字段权限权限:授权页面的字段显示权限。
-5. 👨🎓用户管理:用户是系统操作者,该功能主要完成系统用户配置。
-6. 👬接口白名单:配置不需要进行权限校验的接口。
-7. 🧑🔧字典管理:对系统中经常使用的一些较为固定的数据进行维护。
-8. 🧑🔧地区管理:对省市县区域进行管理。
-9. 📁附件管理:对平台上所有文件、图片等进行统一管理。
-10. 🗓️操作日志:系统正常操作日志记录和查询;系统异常信息日志记录和查询。
-11. 🔌[插件市场 ](https://bbs.django-vue-admin.com/plugMarket.html):基于Django-Vue-Admin框架开发的应用和插件。
-
-## 插件市场 🔌
-
-- Celery异步任务:[dvadmin-celery](https://gitee.com/huge-dream/dvadmin-celery)
-- 升级中心后端:[dvadmin-upgrade-center](https://gitee.com/huge-dream/dvadmin-upgrade-center)
-- 升级中心前端:[dvadmin-upgrade-center-web](https://gitee.com/huge-dream/dvadmin-upgrade-center-web)
+后端配置分离:
+- `application/settings.py` - Django 默认配置
+- `conf/env.py` - 环境特定配置(数据库、Redis、密钥)
## 准备工作
+
~~~
Python >= 3.8.0 (推荐3.8+版本)
nodejs >= 14.0 (推荐最新)
@@ -104,109 +73,119 @@ Mysql >= 5.7.0 (可选,默认数据库sqlite3,推荐8.0版本)
Redis(可选,最新版)
~~~
-## 前端♝
+## 前端
```bash
-# 克隆项目
-git clone https://gitee.com/huge-dream/django-vue3-admin.git
-
-# 进入项目目录
+# 进入前端目录
cd web
# 安装依赖
-npm install --registry=https://registry.npm.taobao.org
+npm install yarn
+npm install --registry=https://registry.npmmirror.com
-# 启动服务
-npm run dev
+# 启动开发服务器
+yarn run dev
# 浏览器访问 http://localhost:8080
# .env.development 文件中可配置启动端口等参数
+
# 构建生产环境
-# npm run build
+yarn run build
```
+## 后端
+### 方式一:脚本启动(推荐)
-## 后端💈
+项目提供了完整的启动脚本,位于项目根目录 `scripts/` 目录:
-~~~bash
-1. 进入项目目录 cd backend
-2. 在项目根目录中,复制 ./conf/env.example.py 文件为一份新的到 ./conf 文件夹下,并重命名为 env.py
-3. 在 env.py 中配置数据库信息
- mysql数据库版本建议:8.0
- mysql数据库字符集:utf8mb4
-4. 安装依赖环境
- pip3 install -r requirements.txt
-5. 执行迁移命令:
- python3 manage.py makemigrations
- python3 manage.py migrate
-6. 初始化数据
- python3 manage.py init
-7. 初始化省市县数据:
- python3 manage.py init_area
-8. 启动项目
- python3 manage.py runserver 0.0.0.0:8000
-或使用 daphne :
- daphne -b 0.0.0.0 -p 8000 application.asgi:application
-~~~
+```bash
+# 进入项目根目录
+cd D:\AVC-PROJECT\pis
+
+# 启动后端服务(开发模式)
+./scripts/start-backend.sh
+
+# 启动前端服务
+./scripts/start-frontend.sh
+
+# 启动 Celery 异步任务(可选)
+./scripts/start-celery.sh
+```
+
+**脚本功能说明:**
+
+| 脚本 | 说明 |
+|------|------|
+| `start-backend.sh` | 启动后端服务(自动创建 PID 和日志文件)|
+| `start-frontend.sh` | 启动前端开发服务器 |
+| `start-celery.sh` | 启动 Celery Worker 和 Beat |
+| `stop-all.sh` | 停止所有服务 |
+| `stop-celery.sh` | 仅停止 Celery 服务 |
+| `check-status.sh` | 查看所有服务状态 |
+| `view-logs.sh` | 查看服务日志 |
+
+**查看日志:**
+```bash
+./scripts/view-logs.sh all # 查看所有日志
+./scripts/view-logs.sh backend # 仅看后端日志
+./scripts/view-logs.sh celery # 仅看 Celery 日志
+```
+
+**停止服务:**
+```bash
+./scripts/stop-all.sh # 停止所有服务
+./scripts/stop-celery.sh # 仅停止 Celery
+```
+
+### 方式二:手动启动
+
+```bash
+# 1. 进入后端目录
+cd backend
+
+# 2. 复制并配置环境文件
+cp ./conf/env.example.py ./conf/env.py
+# 编辑 env.py 配置数据库信息
+
+# 3. 安装依赖
+pip3 install -r requirements.txt
+
+# 4. 执行数据库迁移
+python3 manage.py makemigrations
+python3 manage.py migrate
+
+# 5. 初始化数据
+python3 manage.py init
+python3 manage.py init_area
+
+# 6. 启动后端
+uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
+```
### 访问项目
-- 访问地址:[http://localhost:8080](http://localhost:8080) (默认为此地址,如有修改请按照配置文件)
-- 账号:`superadmin` 密码:`admin123456`
+- 前端地址:http://localhost:8080
+- 后端接口:http://localhost:8080/api
+- 默认账号:`superadmin` / `admin123456`
+### Docker 部署
-
-
-
-### docker-compose 运行
-
-~~~shell
-# 先安装docker-compose (自行百度安装),执行此命令等待安装,如有使用celery插件请打开docker-compose.yml中celery 部分注释
+```shell
docker-compose up -d
-# 初始化后端数据(第一次执行即可)
+# 初始化后端数据(第一次执行即可)
docker exec -ti dvadmin-django bash
-python manage.py makemigrations
+python manage.py makemigrations
python manage.py migrate
python manage.py init_area
python manage.py init
exit
-前端地址:http://127.0.0.1:8080
-后端地址:http://127.0.0.1:8080/api
-# 在服务器上请把127.0.0.1 换成自己公网ip
-账号:superadmin 密码:admin123456
-
-# docker-compose 停止
+# 停止服务
docker-compose down
-# docker-compose 重启
+
+# 重启服务
docker-compose restart
-# docker-compose 启动时重新进行 build
+
+# 重新构建并启动
docker-compose up -d --build
-~~~
-
-
-
-## 演示图✅
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+```