DTURelifeLink

Giới thiệu về dự án

Banner

“💚 Ấn nút nhớ, thả hy vọng 🌿”

MIT License Open issues Open Pull Requests Commit activity GitHub contributors

Ứng dụng hỗ trợ cứu nạn khẩn cấp và quản lý nguồn lực Mục tiêu của dự án là phát triển một hệ thống dựa trên nền tảng LCDP để hỗ trợ cứu nạn cứu trợ khẩn cấp, quản lý nguồn lực cứu trợ và quản lý tái thiết sau thảm họa.

Dự án được thực hiện trong cuộc thi Phần Mềm Nguồn Mở-Olympic Tin học Sinh viên Việt Nam 2024 . Được open source theo giấy phép MIT License bởi đội tác giả DTU_DZ.

RELIEFLINK Dự án cứu nạn khẩn cấp nhằm xây dựng một hệ thống hiệu quả để cung cấp các dịch vụ cứu trợ khẩn cấp và quản lý tài nguyên trong các tình huống thảm họa. Hệ thống này sử dụng công nghệ bản đồ để theo dõi và phân phối tài nguyên như thực phẩm, nước, và thuốc men, giúp các đội cứu hộ phản ứng nhanh chóng và chính xác. Các tính năng của hệ thống bao gồm việc tự động phân phối tài nguyên theo nhu cầu và vị trí, cung cấp giao diện người dùng thân thiện dựa trên NỀN TẢNG LCDP để quản lý và điều phối hoạt động cứu hộ, đồng thời phân tích dữ liệu thời gian thực để đưa ra các quyết định kịp thời. Mục tiêu của dự án là tối ưu hóa quy trình cứu trợ, giảm thiểu thời gian phản ứng và đảm bảo rằng các nạn nhân nhận được sự hỗ trợ kịp thời nhất.

💫 Tại sao RELIEFLINK sẽ thay đổi cuộc sống của bạn

📂 Chức Năng Chính

Activity

🎯 Mục tiêu

🔍 Các tính năng chính

Features

🌪 Cứu trợ khẩn cấp

🔬 Các lĩnh vực nghiên cứu

Research

🏃 Xây dựng hệ thống ứng cứu hiệu quả

📌 Các đặc điểm nổi bật và lợi ích cho người dùng

RELIEFLINK không chỉ là một dự án hỗ trợ khẩn cấp mà còn là một lời kêu gọi hành động – hành động vì sự an toàn của cộng đồng, vì sự phát triển bền vững của đất nước, và vì tương lai của thế hệ mai sau.

🌏 Mục tiêu tương lai của dự án

📢 Đối tượng hướng đến

Target Users

💡Nhà phát triển

📧 Email: thanhtruong23111999@gmail.com

📱 Hotline: +84 376 659 652

📞 Liên hệ

” 🏫 DTU_DZ - DUY TAN UNIVERSITY ✨”

📝 License

Dự án này được cấp phép theo các điều khoản của giấy phép MIT License

🖥️ Truy cập hệ thống

Demo Online

Bạn có thể trải nghiệm ReliefLink tại: https://dz1.dzfullstack.com/

Tạo tài khoản

  1. Truy cập trang đăng ký: https://dz1.dzfullstack.com/user/login
  2. Điền các thông tin cần thiết:
    • Email
    • Mật khẩu
  3. Xác nhận email để kích hoạt tài khoản
  4. Đăng nhập và bắt đầu sử dụng hệ thống

Các portal trong hệ thống

Tài khoản demo

Bạn có thể dùng các tài khoản sau để trải nghiệm:

Portal Người Dùng:

Portal Nhân Lực:

Portal Admin:

Lưu ý: Đây là tài khoản demo chỉ có quyền hạn giới hạn. Để sử dụng đầy đủ tính năng, vui lòng đăng ký tài khoản mới.

🏗 Cấu trúc dự án

relieflink/
├── admin/           # Admin portal - Quản lý hệ thống
│   ├── pages/       # Các trang quản lý
│   └── widgets/     # Components tái sử dụng
├── workforce/       # Portal quản lý nhân lực
│   ├── pages/       # Trang cho đội cứu hộ
│   └── widgets/     # Components tái sử dụng  
├── user/           # Portal người dùng
│   ├── pages/      # Trang cho người dân
│   └── widgets/    # Components tái sử dụng
├── docs/           # Tài liệu
│   ├── setup.md    # Hướng dẫn cài đặt
│   ├── api.md      # Tài liệu API
│   └── contribute.md # Hướng dẫn đóng góp
└── assets/         # Hình ảnh, tài nguyên

📖 Hướng dẫn chung

### Xem hướng dẫn chung tại đây

📚 Hướng dẫn cài đặt

Yêu cầu hệ thống

Các bước triển khai

  1. Fork các repository của ReliefLink:
  2. Import vào Appsmith:
    • Truy cập Appsmith workspace
    • Click Create New > Import from Git repository
    • Cấu hình Git và Deploy keys cho từng ứng dụng
    • Kết nối MongoDB với URI có sẵn

Chi tiết hơn xem trong docs/setup.md

🧩 Plugins

DTU AppSmith Map

DTU AppSmith RealTime

Chi tiết cách cài đặt của AppSmith tại AppSmith

⚙️ Services

DTU ServerSocket

🐳 Docker Appsmith

Yêu cầu tiên quyết

Bạn sẽ cần phải khởi động lại máy tính sau khi hoàn tất quá trình cài đặt.


- Nếu git clone về không có docker-compose.yml thì bạn cần tạo 1 file docker-compose.yml và cấu hình sau: 
	version: "3"

services: appsmith: image: index.docker.io/appsmith/appsmith-ee container_name: appsmith ports: - “5555:80” - “444:443” volumes: - ./stacks:/appsmith-stacks restart: unless-stopped mysql: image: mysql:latest ports: - “33088:3306” container_name: mysql environment: - MYSQL_ROOT_PASSWORD=admin - MYSQL_DATABASE=appsmith volumes: - mysql-data:/var/lib/mysql restart: unless-stopped volumes: mysql-data:




- Trong thư mục appsmith, chạy lệnh sau để khởi động Appsmith trong Docker:

cd appsmith docker-compose up

Sau khi các container đã được khởi động, bạn có thể truy cập Appsmith qua trình duyệt.

- Mở trình duyệt và vào địa chỉ:

    - Truy cập Appsmith trên cổng http://localhost:5555 (HTTP) và http://localhost:444 (HTTPS).

    - Truy cập MySQL trên cổng http://localhost:33088.

Xem chi tiết tại [Docker Appsmith](https://docs.appsmith.com/getting-started/setup/installation-guides/docker)

## MongoDBCompass
### Yêu cầu 
- [MongoDB Compass](https://www.mongodb.com/try/download/compass)

### Cách cài đặt
- Tải MongoDB Compass từ trang chủ MongoDB
- Cài đặt MongoDB Compass
- Mở MongoDB Compass và chọn phần **New Connection**
- Nhập URI

mongodb+srv://admin:admin@cluster0.gw0vs.mongodb.net   ``` - Chọn **Connect** - Tìm đến mục Open MongoDB shell - Nhập vào  ```
use rescue_alert ``` Hoặc bạn có thể tự tạo seed data bằng cách nhập vào

Với những bước ở trên bạn có thể trải nghiệm ứng dụng của chúng tôi

📷 Video hướng dẫn cài đặt

📑 Thông tin chi tiết

🤝 Đóng góp

Chúng tôi rất hoan nghênh mọi đóng góp! Xem CONTRIBUTING.md để biết thêm chi tiết.

🔄 Quy trình phát triển

  1. Fork repo này
  2. Tạo branch mới (git checkout -b feature/AmazingFeature)
  3. Commit thay đổi (git commit -m 'Add some AmazingFeature')
  4. Push lên branch (git push origin feature/AmazingFeature)
  5. Tạo Pull Request

🐛 Báo lỗi

Nếu bạn phát hiện lỗi, vui lòng tạo issue mới với:

📜 Changelog

Xem CHANGELOG.md để biết lịch sử thay đổi.

⚖️ Code of Conduct

Xem CODE_OF_CONDUCT.md để biết các quy tắc và hành vi được chấp nhận.

Báo cáo lỗi & Góp ý

```

This site is open source. Improve this page.