geminiWX/STARTUP.md

项目启动文档

本文档说明如何启动 GeminiWX 项目的服务端、管理后台和小程序。

1. 目录结构

• admin/server: Django 后端服务
• admin/client: Vue.js 管理后台前端
• wechat-mini-program: 微信小程序前端代码

2. 启动服务端 (Django)

服务端基于 Django 框架。

步骤

1. 打开终端。

2. 进入项目根目录。

3. 使用 admin/server/.venv 中的 Python 解释器启动服务：

   .\admin\server\.venv\Scripts\python.exe admin/server/manage.py runserver 0.0.0.0:8000
   

   或者，如果你已经激活了虚拟环境：

   cd admin/server
   python manage.py runserver 0.0.0.0:8000
   

4. 服务启动后，访问 http://localhost:8000/ 确认运行正常。

3. 启动管理后台 (Vue.js)

管理后台基于 Vue Element Admin 模板。

步骤

1. 打开新的终端窗口。

2. 进入前端目录：

   cd admin/client
   

3. 安装依赖（如果尚未安装）：

   npm install
   

4. 启动开发服务器：

   注意: 如果你的 Node.js 版本 >= 17，可能会遇到 OpenSSL 相关的错误。请在启动前设置环境变量。

   • Windows (PowerShell):

     $env:NODE_OPTIONS="--openssl-legacy-provider"
     npm run dev
     

   • CMD:

     set NODE_OPTIONS=--openssl-legacy-provider
     npm run dev
     

   • Linux / macOS:

     export NODE_OPTIONS=--openssl-legacy-provider
     npm run dev
     

5. 启动完成后，浏览器会自动打开 http://localhost:9528 (或其他配置的端口)。

4. 启动微信小程序

步骤

1. 下载并安装 微信开发者工具。
2. 打开微信开发者工具，选择“导入项目”。
3. 选择目录 wechat-mini-program。
4. 设置 AppID（如果没有，可以使用测试号）。
5. 在开发者工具中编译并预览。

注意事项

• 端口占用: 确保 8000 (后端) 和 9528 (前端) 端口未被占用。
• 数据库: 项目默认使用 db.sqlite3，无需额外配置数据库服务。
• Python 环境: 请使用项目自带的虚拟环境 admin/server/.venv 以确保依赖正确。