Hi Vọng Xanh 🌱

Nền Tảng Hỗ Trợ Sau Thiên Tai

"🤝 Kết nối yêu thương, kiến tạo tương lai bền vững 🌿"

📖 Tài Liệu • 🚀 Demo • 🤝 Đóng Góp • 📜 Changelog

Hi Vọng Xanh là một mã nguồn mở, được phát triển bởi đội DTU_DZ1 đến từ Đại học Duy Tân để tham gia cuộc thi Olympic Tin học Sinh viên - Mã nguồn mở năm 2024. Dự án được thiết kế trong lĩnh vực hỗ trợ sau thiên tai, với các mục tiêu:

• 🔗 Kết nối cộng đồng một cách hiệu quả
• 📊 Quản lý nguồn lực cứu trợ một cách chuyên nghiệp
• 💡 Mang lại hy vọng cho những vùng bị ảnh hưởng
• 📝 Minh bạch dữ liệu giao dịch trong ủng hộ

Dự án tập trung vào việc xây dựng một nền tảng toàn diện, kết hợp công nghệ hiện đại như Blockchain, AI và xử lý dữ liệu thời gian thực để tạo ra một hệ sinh thái hỗ trợ thiên tai minh bạch và hiệu quả.

• 🔍 Phân tích ảnh theo thời gian thực
• 🚁 Tìm kiếm người gặp nạn trong thiên tai
• 🤖 Nhận diện kịp thời con người và động vật

• 📊 Theo dõi các giao dịch cứu trợ
• 🕒 Báo cáo theo thời gian thực
• 🏗️ Quản lý nguồn lực xây dựng cứu trợ

• ⛓️ Mạng lưới blockchain để lưu trữ dữ liệu giao dịch
• 🔄 Sao kê, so sánh dữ liệu giữa database với blockchain

• 🐳 Docker Desktop - Tải tại đây
• 🧶 Yarn phiên bản 1.2.1 (Yêu cầu bởi Nocobase)
• 🌳 Git

Lưu ý về NocoBase và Yarn Workspace:

• Nocobase (Tài liệu chính thức) yêu cầu Yarn phiên bản 1.22.x
• Yarn 1.22.x không hỗ trợ workspace public
• Vì đây là dự án mã nguồn mở, chúng tôi đã để private = false trong lcdp-app/package.json
• Để phát triển tiếp dự án, bạn cần:
  • Mở file lcdp-app/package.json
  • Thay đổi trường private từ false thành true
  • Sau đó có thể tiếp tục phát triển bình thường

# Tải mã nguồn về
git clone https://github.com/olp-dtu-2024/DTU-GreenHope.git

# Di chuyển vào thư mục dự án
cd DTU-GreenHope

# Cài đặt các gói phụ thuộc
yarn install

# Khởi chạy docker cho môi trường production
yarn docker:release

🔐 Thông tin đăng nhập mặc định:

• 👤 Tài khoản: admin@nocobase.com
• 🔑 Mật khẩu: admin123

# Tải mã nguồn về
cd DTU-GreenHope
yarn install
yarn docker:build

# Cài đặt và cấu hình NocoBase
cd DTU-GreenHope/lcdp-app
# Mở file package.json và thay đổi trường private từ false thành true
yarn install
yarn nocobase install --lang=en-US
yarn lcdp:restore
yarn dev

Máy chủ phát triển sẽ chạy tại: http://localhost:13000

# Cài đặt dự án
cd DTU-GreenHope/transaction-service
yarn install
yarn dev

# Cài đặt dự án
cd DTU-GreenHope/solidity-service
yarn install
yarn dev

# Cài đặt dự án
cd DTU-GreenHope/recognition-service
pip install -r requirements.txt
python app.py

# Cài đặt dự án
cd DTU-GreenHope/captcha-service
pip install -r requirements.txt
python app.py

• Network name: Ganache Local
• Default RPC URL: http://localhost:8545
• Chain Id: 1337
• Currency symbol: ETH

🔐 Thông tin các địa chỉ ví trên Ganache:

# Tạo plugin mới
yarn pm create @<tên-namespace>/<tên-package>

# Ví dụ
yarn pm create @greenhope/theo-doi-thien-tai

• @dtu-olp-2024/carousel-nocobase
• @dtu-olp-2024/kafka-nocobase
• @dtu-olp-2024/progress-nocobase
• @dtu-olp-2024/rich-block-nocobase
• @dtu-olp-2024/vietqr-nocobase
• @dtu-olp-2024/landing-page
• @dtu-olp-2024/solidity-editor-nocobase
• @dtu-olp-2024/video-player-nocobase

1. Fork Repository

# Fork repository trên GitHub
# Clone về máy local
git clone https://github.com/<your-username>/DTU-GreenHope.git
cd DTU-GreenHope

2. Tạo Branch Mới

# Tạo và chuyển sang branch mới
git checkout -b feat/<new-feature>

# Ví dụ
git checkout -b feat/disaster-tracking

3. Commit Thay Đổi

# Thêm file đã thay đổi
git add .

# Commit với message rõ ràng
git commit -m "feat: add disaster tracking module"

4. Push Branch

# Push lên repository của bạn
git push -u origin feat/<new-feature>

5. Tạo Pull Request

• Truy cập repository gốc tại GitHub
• Chọn "New Pull Request"
• Chọn branch của bạn để merge
• Điền thông tin mô tả chi tiết

📝 Lưu ý: Vui lòng đọc kỹ git-flow.md để hiểu rõ về quy trình làm việc với Git trong dự án.

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

Dự án này tuân theo bộ quy tắc ứng xử cho cộng đồng. Xem file CODE_OF_CONDUCT.md để biết thêm chi tiết về các quy tắc và hành vi được chấp nhận.

• Báo cáo lỗi và đề xuất tính năng mới tại GitHub Issues

• Đối với các vấn đề bảo mật nhạy cảm, vui lòng liên hệ trực tiếp qua email: minhtuanledng@gmail.com

Dự án này được phân phối dưới GNU General Public License v3.0. Xem file LICENSE để biết thêm chi tiết.

© 2024 Hi Vọng Xanh - Vì một tương lai bền vững 🌱