Neusoft BloodBank 🩸

A comprehensive blood bank management system built as a WeChat Mini Program (微信小程序) for Chengdu Neusoft University (成都东软学院). This application covers the complete blood donation lifecycle — from donor registration to blood distribution and quality control — powered by WeChat Cloud (微信云开发).

Features

🔐 User Authentication

• Email/password login and registration
• WeChat login support
• Duplicate username checking on signup

🧑‍⚕️ Donor Management

• Donor registration with eligibility screening (age 18-60, weight ≥50kg, 3-month donation interval)
• Appointment scheduling (hospital, date, time)

🩸 Blood Collection & Processing

• Blood collection monitoring (donor ID, volume, date)
• Component separation (red cells, plasma, platelets)
• Blood unit labeling with blood group and expiry date

📦 Inventory Management

• Real-time inventory tracking
• Storage condition monitoring (temperature, humidity)
• Shelf life and expiry date tracking

🚚 Distribution Management

• Hospital information management
• Blood request dispatch
• Cross-matching compatibility checks

✅ Quality Control

• Disease testing (HIV, Hepatitis B/C, Syphilis)
• Compliance auditing
• Quality report generation

🗺️ Map-Based Services

• Interactive map showing nearby hospitals, medicine shops
• Emergency blood request alerts
• Live GPS location

👤 User Dashboard

• Donor profile (ID, blood type, donation count, rewards)
• Chat bot
• Volunteer signup

Tech Stack

• Platform: WeChat Mini Program
• Backend: WeChat Cloud Base (云开发)
  • Cloud Database (JSON document store)
  • Cloud Functions (Node.js)
  • Cloud Storage
• Language: JavaScript

Project Structure

NeusoftBloodBank/
├── miniprogram/            # Mini program frontend
│   ├── pages/              # All pages
│   │   ├── login/          # User login
│   │   ├── register/       # User registration
│   │   ├── home/           # Landing page
│   │   ├── services/       # Map-based services
│   │   ├── myown/          # User dashboard
│   │   └── workflows/      # 5 core workflow modules
│   │       ├── donor/      # Donor management
│   │       ├── collection/ # Blood collection
│   │       ├── inventory/  # Inventory management
│   │       ├── distribution/ # Blood distribution
│   │       └── quality/    # Quality control
│   ├── components/         # Reusable UI components
│   └── images/             # Assets
├── cloudfunctions/         # Cloud functions (login, signup, stats, etc.)
├── project.config.json     # WeChat project configuration
└── uploadCloudFunction.bat # Cloud function deployment script

Database Collections

The app uses 15+ cloud database collections including: users, donors, appointments, collection_monitoring, component_separation, blood_labeling, inventory_realtime, storage_conditions, shelf_life_tracking, hospital_management, blood_request_dispatch, cross_matching, quality_testing, quality_compliance, quality_reports.

Getting Started

Prerequisites

• WeChat DevTools
• A WeChat Mini Program AppID with Cloud Base enabled

Setup

1. Clone the repository
2. Open in WeChat DevTools
3. Set your Cloud environment ID in miniprogram/app.js
4. Deploy cloud functions via WeChat DevTools or run uploadCloudFunction.bat

Reference

• WeChat Cloud Development Docs