Safe You BaaS

Phần mềm mã nguồn mở ở phía nội bộ cho Safe You
Tài liệu phát triển

Online demo · Báo cáo lỗi · Yêu cầu tính năng

Về Safe You BaaS 👋

Safe You BaaS là hệ thống backend mã nguồn mở hỗ trợ nền tảng Safe You, cung cấp hạ tầng mạnh mẽ với các công nghệ hiện đại như RabbitMQ, n8n, Supabase và Edge Functions. Dự án mang đến các tính năng chính bao gồm hệ thống cảnh báo khẩn cấp qua SMS, email và thông báo theo GPS, quản lý tình nguyện viên, chợ tình thương, cập nhật thông tin an toàn và đóng góp thông tin theo khu vực. Safe You BaaS tuân theo kiến trúc microservices và sử dụng Docker để dễ dàng triển khai và mở rộng. Dự án thân thiện với lập trình viên, có tài liệu chi tiết và quá trình cài đặt đơn giản.

Các plugins đội phát triển dựa trên supabase nằm trong thư mục: supabase/functions

Bạn có thể xem hướng dẫn cách cài đặt, cách sử dụng plugin tại đây: Hướng dẫn cài đăt

Tài khoản mặc định

• User:
  • Email: user@gmail.com
  • Password: 123465
• Admin:
  • Email: admin@gmail.com
  • Password: 123465

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

Yêu cầu hệ thống

• Node.js >= 14.x
• Docker
• Docker Compose
• n8n
• RabbitMQ
• Git
• Supabase CLI

Các bước cài đặt

1. Clone mã nguồn từ Github:

git clone https://github.com/UTE-SafeYou/safeyou-baas.git

2. Chuyển vào thư mục mã nguồn:

cd safeyou-baas

3. Khởi tạo n8n và RabbitMQ:

docker-compose up -d

4. Khởi động supabase:

supabase start

5. Khởi tạo local database:

supabase db reset

6. Thiết lập các biến môi trường:

cp supabase/.env.example supabase/.env

7. Khởi động Edge Function:

supabase functions serve --env-file supabase/.env

8. Thiết lập n8n workflow:

• Truy cập vào địa chỉ http://localhost:5678
• Chọn import from file

- Chọn file trong `safeyou-baas\automation\Send_Notification.json`

- Thêm các biến môi trường trong workflow

- Lưu workflow - Chạy workflow

(trở lên đầu)

Tài liệu kỹ thuật

Bạn có thể xem tài liệu kỹ thuật của Safe You tại đây.

(trở lên đầu)

Lộ trình

• Phát triển hệ thống cảnh báo
• Hệ thống tình nguyện viên
• Hệ thống chợ tình thương
• Hệ thống cập nhật thông tin
• Hệ thống đóng góp thông tin
• Hệ thống gửi cảnh báo đến người dùng
• Hệ thống phân công nhiệm vụ
• Tích hợp phân tích dữ liệu
• Tích hợp hệ thống nguồn mở với thiết bị IoT

Bạn có thể xem issues để biết thêm danh sách các tính năng được đề xuất (và các vấn đề đã biết).

(trở lên đầu)

Đóng góp

Những đóng góp quý báu của bạn làm cho cộng đồng mã nguồn mở trở nên tuyệt vời hơn. Mọi đóng góp bạn đều được đánh giá cao và Safe You rất biết ơn về điều đó.

Nếu bạn có đề xuất nào giúp dự án trở nên tốt hơn, hãy fork dự án và tạo một pull request. Bạn cũng có thể đơn giản mở một issue với tag "enhancement" hoặc ấn vào các đường dẫn sau:

1. Báo cáo lỗi: Báo cáo lỗi
2. Yêu cầu tính năng: Yêu cầu tính năng

Ngoài Github, Safe You cũng se tổng hợp các lỗi và hướng dẫn hỗ trợ tại đây

Giấy phép

Sau khi tham khảo, nhóm Safe You quyết định sử dụng giấy phép GNU - General Public License v3.0.

(trở lên đầu)

Liên lạc

Chúng tôi luôn sẵn sàng hỗ trợ bạn bất cứ khi nào Facebook

Ngoài ra bạn cũng có thể gửi email cho Safe You Team qua địa chỉ: safeyouteam@gmail.com

Các lập trình viên của khởi đầu dự án Safe You:

• Trần Công Toản - tctoan1024@gmail.com
• Lâm Hoài Kim Ngân - 22133036@student.hcmute.edu.vn
• Nguyễn Hữu Lộc - 22110179@student.hcmute.edu.vn

(trở lên đầu)