Skip to main content

Hướng Dẫn Cài Đặt

🔧 Yêu Cầu Hệ Thống​

🛠️ Phần Mềm Bắt Buộc​

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

ℹ️ Ghi Chú Quan Trọng​

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

📥 Hướng Dẫn Cài Đặt Chi Tiết​

🏭 Môi Trường Production​

# 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

💻 Môi Trường Development​

Bước 1: Cài đặt dự án​

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

Bước 2: Cài Đặt LCDP App (NocoBase)​

# 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

Bước 3: Cài đặt transaction service​

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

Bước 4: Cài đặt solidity service​

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

Bước 5: Cài đặt recognition service​

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

Bước 6: Cài đặt captcha service​

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

🔌 Phát Triển Plugin Mới​

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

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

🔗 Cấu Hình Ports​

🚦 Dịch Vụ🏭 Ports Production💻 Ports Development📝 Mô Tả
📦 LCDP NOCOBASE12000:1200013000Nền tảng ứng dụng chính
🤖 Recognition Service8001:80018001Dịch vụ nhận diện
💱 Transaction Service3027:30273027Trung tâm xử lý giao dịch
🔗 Solidity Service3029:30293029Tương tác hợp đồng blockchain
🛡️ Captcha Service1234:12341234Hệ thống xác minh giải mã
📡 Kafka9092:9092 9093:90939092 9093Nền tảng streaming phân tán
💾 Redis6444:63796444Kho dữ liệu trong bộ nhớ
🗃️ PostgreSQL5439:54325439Hệ quản trị cơ sở dữ liệu
⛓️ Ganache8545:85458545Blockchain Ethereum cục bộ
🌳 Zookeeper2181:21812181Quản lý tin nhắn Kafka

📦 Các Package Phát Triển Trong Nền Tảng​

💡Nhà phát triển​

  • Lê Minh Tuấn
      📧 Email: minhtuanledng@gmail.com
      📱 Hotline: 0889001505
  • Trần Nguyễn Duy Khánh
     📧 Email: duykhanhtran17062003@gmail.com
     📱 Hotline: 0905081330
  • Trịnh Minh Son
     📧 Email: trinhminhson2004@gmail.com
     📱 Hotline: 0357572879

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