Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abdulkarim1422/bloodsapp
Blood Donation Management Software
https://github.com/abdulkarim1422/bloodsapp
blood-management-system gin go golang gorm self-hosted
Last synced: 21 days ago
JSON representation
Blood Donation Management Software
- Host: GitHub
- URL: https://github.com/abdulkarim1422/bloodsapp
- Owner: abdulkarim1422
- Created: 2024-11-07T07:52:42.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-02T19:30:35.000Z (21 days ago)
- Last Synced: 2024-12-02T20:28:07.341Z (21 days ago)
- Topics: blood-management-system, gin, go, golang, gorm, self-hosted
- Language: Go
- Homepage:
- Size: 222 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blood Donation App
**`اللغة العربية في الأسفل`**
## Overview
The Blood Donation App is a web application designed to facilitate the process of blood donation. It allows users to register as donors, find patients in need of blood, and manage donations efficiently.
## Features
- **Donor Registration**: Users can register as blood donors by providing their personal details and blood type.
- **Patient Registration**: Users can register patients who need blood donations, specifying the required blood type and urgency.
- **Donation Management**: Admins can manage donations, matching donors with patients based on blood type compatibility.
- **WhatsApp Verification**: Verification codes are sent to users via WhatsApp to ensure authenticity.
- **Feedback System**: Send feedback to donors and patients via email and WhatsApp.
## Technologies Used
- **Frontend**: HTML, CSS, JavaScript
- **Backend**: Go (Golang), Gin framework
- **Database**: PostgreSQL
- **ORM**: GORM
- **Other**: Python for WhatsApp integration
## Installation
1. Clone the repository:
```sh
git clone https://github.com/abdulkarim1422/BloodsApp.git
```
2. Navigate to the project directory:
```sh
cd BloodsApp
```
3. Install dependencies:
```sh
go mod tidy
```
4. Configure the database connection in the `.env` file:
```env
DB_USER=username
DB_PASSWORD=password
DB_HOST=localhost
DB_PORT=5432
DB_NAME=db_name
```
5. Run the application:
```sh
go run main.go
```
## Usage
1. Open your web browser and navigate to `http://localhost:8080`.
2. Use the navigation menu to access different features of the application.
3. Register as a donor or patient, and manage donations through the admin dashboard.
## Contributing
Contributions are welcome! Please fork the repository and create a pull request with your changes.
## License
This project is licensed under the MIT License.
# تطبيق التبرع بالدم
## نظرة عامة
تطبيق التبرع بالدم هو تطبيق ويب مصمم لتسهيل عملية التبرع بالدم. يسمح للمستخدمين بالتسجيل كمتبرعين، والعثور على المرضى الذين يحتاجون إلى الدم، وإدارة التبرعات بكفاءة.
## الميزات
- **تسجيل المتبرعين**: يمكن للمستخدمين التسجيل كمتبرعين بالدم من خلال تقديم تفاصيلهم الشخصية وفصيلة الدم.
- **تسجيل المرضى**: يمكن للمستخدمين تسجيل المرضى الذين يحتاجون إلى تبرعات بالدم، مع تحديد فصيلة الدم المطلوبة ومدى الحاجة.
- **إدارة التبرعات**: يمكن للمسؤولين إدارة التبرعات، ومطابقة المتبرعين مع المرضى بناءً على توافق فصيلة الدم.
- **التحقق عبر الواتساب**: يتم إرسال رموز التحقق إلى المستخدمين عبر الواتساب لضمان الأصالة.
- **نظام التغذية الراجعة**: إرسال التغذية الراجعة إلى المتبرعين والمرضى عبر البريد الإلكتروني والواتساب.
## التقنيات المستخدمة
- **الواجهة الأمامية**: HTML, CSS, JavaScript
- **الواجهة الخلفية**: Go (Golang), إطار عمل Gin
- **قاعدة البيانات**: PostgreSQL
- **ORM**: GORM
- **أخرى**: Python للتكامل مع الواتساب
## التثبيت
1. استنساخ المستودع:
```sh
git clone https://github.com/abdulkarim1422/BloodsApp.git
```
2. الانتقال إلى دليل المشروع:
```sh
cd BloodsApp
```
3. تثبيت التبعيات:
```sh
go mod tidy
```
4. تكوين اتصال قاعدة البيانات في ملف `.env`:
```env
DB_USER=username
DB_PASSWORD=password
DB_HOST=localhost
DB_PORT=5432
DB_NAME=db_name
```
5. تشغيل التطبيق:
```sh
go run main.go
```
## الاستخدام
1. افتح متصفح الويب الخاص بك وانتقل إلى `http://localhost:8080`.
2. استخدم قائمة التنقل للوصول إلى الميزات المختلفة للتطبيق.
3. سجل كمتبرع أو مريض، وقم بإدارة التبرعات من خلال لوحة التحكم الخاصة بالمسؤول.
## المساهمة
المساهمات مرحب بها! يرجى استنساخ المستودع وإنشاء طلب سحب مع التغييرات الخاصة بك.
## الترخيص
هذا المشروع مرخص بموجب ترخيص MIT.