# 项目启动文档

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

## 1. 目录结构

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

## 2. 启动服务端 (Django)

服务端基于 Django 框架。

### 步骤

1.  打开终端。
2.  进入项目根目录。
3.  使用 `admin/server/.venv` 中的 Python 解释器启动服务：

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

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

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

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

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

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

### 步骤

1.  打开新的终端窗口。
2.  进入前端目录：

    ```powershell
    cd admin/client
    ```

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

    ```powershell
    npm install
    ```

4.  启动开发服务器：

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

    *   **Windows (PowerShell)**:
        ```powershell
        $env:NODE_OPTIONS="--openssl-legacy-provider"
        npm run dev
        ```

    *   **CMD**:
        ```cmd
        set NODE_OPTIONS=--openssl-legacy-provider
        npm run dev
        ```

    *   **Linux / macOS**:
        ```bash
        export NODE_OPTIONS=--openssl-legacy-provider
        npm run dev
        ```

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

## 4. 启动微信小程序

### 步骤

1.  下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)。
2.  打开微信开发者工具，选择“导入项目”。
3.  选择目录 `wechat-mini-program`。
4.  设置 AppID（如果没有，可以使用测试号）。
5.  在开发者工具中编译并预览。

## 注意事项

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