Volunteer System Demo

This project is a volunteer management system that consists of a Django backend, a Vue 3 web frontend for administration, and a uni-app frontend for mobile/mini-program users.

Project Structure

• volunteer_system/: Contains the Django backend code.
• volunteer_system/frontend/: Contains the Vue 3 web frontend application (Vite + Element Plus).
• volunteer_system/frontend_uniapp/: Contains the uni-app cross-platform frontend application.
• new_venv/: The Python virtual environment for the backend.

Prerequisites

• Python 3.8+
• Node.js (Latest LTS version recommended)

Setup and Installation

1. Backend (Django)

The backend runs on Python using Django. A virtual environment new_venv is already set up in the root directory.

1. Activate the virtual environment:

   Windows (PowerShell):

   .\new_venv\Scripts\Activate.ps1

   Windows (CMD):

   .\new_venv\Scripts\activate.bat

2. Navigate to the backend directory:

   cd volunteer_system

3. Configure MySQL Database:

   Ensure your MySQL server is running and create a database named volunteer_system:

   CREATE DATABASE volunteer_system CHARACTER SET utf8mb4;

   Note: Update your MySQL username and password in volunteer_system/settings.py (default: root/password).

4. Apply database migrations:

   python manage.py migrate

5. Run the development server:

   python manage.py runserver

The backend API will be available at http://127.0.0.1:8000/.

2. Web Frontend (Vue 3)

The web frontend is built with Vue 3, Vite, and Element Plus.

1. Navigate to the frontend directory:

   cd volunteer_system/frontend

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

The web application will be accessible via the local URL provided by Vite (usually http://localhost:5173/).

3. Mobile/Mini-program Frontend (uni-app)

The mobile frontend uses uni-app to support multiple platforms (H5, WeChat Mini Program, etc.).

1. Navigate to the uni-app directory:

   cd volunteer_system/frontend_uniapp

2. Install dependencies:

   npm install

3. Run for H5 (Web):

   npm run dev:h5

4. Run for WeChat Mini Program:

   npm run dev:mp-weixin

Configuration

• Backend Database: Uses SQLite by default (db.sqlite3).
• Dependencies:
  • Backend dependencies are managed in the new_venv environment.
  • Frontend dependencies are managed via package.json in their respective directories.

License

This project is for demonstration purposes.